CS230 Website

This repository contains the code for the CS230 website for Fall, 2019. It is based on the Doks Jekyll theme.

Quick start

Setup

• Clone a local copy of this repository.
• If you haven't already installed Jekyll, then run gem install bundler jekyll or sudo gem install bundler jekyll.
• Run bundle install

Update the content

Open the Markdown file (.md) for the page you want to edit. Generally, don't edit the first few rows of text between -- and --. Notice that if you edit this page then reload the website, your changes will have been added. Don't forget to commit your changes to the Github page.

Build and serve the website locally

• Run ./run.sh.
• A local version of the website should be accessible at http://127.0.0.1:4000.

Publish the website

• You can run ./deploy.sh now for deployment if you have set up the SSH config for rice.stanford.edu Sample lines to add to .ssh/config

Host rice
HostName rice.stanford.edu
    ControlMaster auto
    ControlPath ~/.ssh/%l%r@%h:%p
User <username>

You will need to login once in another teminal with ssh rice, then execute ./deploy.sh

Generate a publishable version

From terminal run JEKYLL_ENV=production jekyll build in the top folder for a local version of the website. A publishable HTML version of the website will be available in the _site folder.

Transfer content to server

Transfer the content of the _site folder to Stanford's AFS server with either the web interface or SFTP tools. CS230's website folder is located at /afs/ir/class/cs230/WWW. For more information on transferring files to AFS read here.

Helpful hints

For shortcuts to Markdown formatting check out this cheat sheet. Below are specific formatting tricks for this repository.

• Hyperlinks: For external links use [link](https://...) and for local links use [link](/path/to/file). If you are linking to a file hosted on the server (i.e. an old midterm solution) then use an external link.
• Images: The raw images should go in the following folder doks-theme/assets/images/[article type]/[number]. Instead of using ![Alt text](image.png) use the following {% include image.html description="add description" link="external url image source" image="[article type]/[number]/[image.png]" caption="true"%}.
• Latex: This repository uses MathJax to render Latex. Simply write normal Latex code in the Markdown files and surround it in dollar signs. For $$inline math$$ simply put it directly in a sentence, while for $$centered math$$ put it on its own line.
• Comments: You can comment out Markdown with HTML comment symbols. That is surround the text you would like not to display with <!-- and -->.

What need to be done

Logistics:

• Update Staff information
• Update TA information
• Update Piazza link
• Update QueueStatus
• Update Calendar url
• Update Zoom link
• Update 2020 fall project link
• Update Course Syllabus

What can be improved

Below is a list of suggested changes for the website and content: General:

• Refactoring the website using global configuration for variables
• Should modify image.html include to take width as an argument.
• Standardize previous project list and make a standardized method for adding new ones.
• Add a toggle answer include for the FAQ, Sections, and Lectures.
• Clean up file structure on server.
• Create playground (embedded IDE + docker) in the blog/sections to let students run and edit code on the fly.

Section:

• Section 3 should use the notation introduced in class.
• Section 6 add Pytorch code as well as Tensorflow.
• Section 9 extend to regression metrics and AUC.
• Section 10 is very minimal and needs more content.

Lecture:

• Images need to be added to all lectures.
• Lectures 8, 9, 10 are unfinished.
• Keep a consistent style to all lectures.
• Should merge lecture notes 4a and 4b into just 4.