- Setup class canvas
- Determine office hours for TFs
- Homework responsibilities
- Lab responsibilities
- Lab sections (my.harvard)
Repository created with iacs-cli
.
This repository is private for the CS205 teaching staff. Please push only to this remote and treat its contents confidential.
- Exam/presentation: TBD
- Grades: TBD
https://harvard-iacs.github.io/2023-CS205
TBD
TBD
TBD
TBD
The class website is generated with the
pelican python package. All class
content is located below the content
directory in this repository. Content
is modified by:
- Markdown files
- Jupyter notebooks (HW and PP)
The directory structure is a follows:
content
├── homeworks
├── labs
├── lectures
├── pages
└── project
The content of the home page is inside content/index.md
. The sub-directory
pages
contains the website sub-sections that you can click on in the top right
navigation panel on the site.
Changing or adding content is not automatically translated to HTML to serve our website. Here are the steps you need to take to accomplish this:
- You only need to do this once. If you have
iacs-cli
installed on your system from previous TF at IACS, uninstall it with:Then reinstall it with the following:python3 -m pip uninstall iacs-cli
You should now have thepython3 -m pip install iacs-cli pelican-jupyter
iacs
tool available on your command line. If not, make sure yourPATH
is set to point to the directory where Python installed theiacs-cli
package. - Modify content inside the
content
directory - Verify your changes by launching a local web server. In the root directory
of the
git
repository, run this command:The command will launch a python web server which you can browse at http://0.0.0.0:8000. Check that all is fine on the local webpage and perform more changes if necessary. After additional changes are made you have to rebuild the HTML sources. You can do this withmake preview
Note: You may see some WARNING when you build the HTML. This is ok due to some files that can not be found. If you see ERROR in red, then something is wrong.make docs
- Once everything is fine, commit your changes (everything below
content
) and quickly describe what you did in the subject (and maybe commit message if it was complicated). - Create a separate commit of the new HTML sources by running:
This creates a new commit with the changes inside the
make webcommit
docs
directory only. - Push your modifications:
git push