nicholaschuayunzhi / website-base

CS2103 Website

CS2103 Website

Live Website (redirected)

Setting up

1. Clone this repo.
2. Run git submodule update --init --recursive to pull the content of the submodule.
3. Install MarkBind

Updating content

1. Update content using MarkBind syntax (How to use MarkBind)
2. markbind serve to start the local server (to preview changes). This command also initiates the live-preview ability i.e. when any changes to the MarkBind code is saved, the site is auto-generated and the Web page (that was opened by the serve command) auto-refreshes to show the new content. This works well for small websites but not so well for this website. Recommended to shutdown the server (Ctrl+C) before doing further edits.
3. When you are happy with the edits, use the markbind deploy to deploy to the GitHub website at the origin repo.
   1. If the deployment failed due to a 'caching' issue, try deleting the the cache generated by the previous deploy command (on Windows, the cache can be found in /c/Users/{user-name}/AppData/Roaming/npm/node_modules/markbind-cli/node_modules/gh-pages/.cache)
4. If you need to update contents inside the book folder,
   1. Post an issue in the se-edu/se-book issue tracker to request for the change
   2. After the change has been done, pull the sub-module, and commit the changes to sub-module reference (when you pull a sub-module, Git automatically updates the submodule reference which is seen as a change in the enclosing repo).

      cd book
      git pull origin master
      cd ..
      git commit -am "sync with book"
      

   3. Deploy the website to make the updated book content visible to students

Bug reports, suggestions, change requests

• MarkBind bug reports and suggestions https://github.com/MarkBind/markbind/issues
• SE-Book bug reports and change requests se-edu/se-book issue tracker