Old Topics

NOTE: Topics on this page are left over from the old documentation; documentation for sites that were constructed prior to a major refactoring in W19.

As time permits, these pages will be updated and migrated to the new list of topics.

• Basic Setup: —Basic Setup for a new course
• Basic Setup: Other—For a new course at UCSB: Things other than this github pages website stuff...
• Basic Setup: pre-W19—Basic Setup for a new course
• Basic Setup: W19 and later—Basic Setup for a new course
• code blocks—Getting nice preformatted code on your site, perhaps with syntax highlighting and line numbers
• _config.yml—The most important part of configuring a Jekyll site
• _config.yml: pre-w19 format—For courses prior to w19
• Course Calendar—How to use the course calendar system
• exam authoring: private repo—How to author an exam in a private repo, then migrate seamlessly into a public course website
• foo wiki migration—The process of migrating materials from foo.cs.ucsb.edu to github
• Gemfile—Where the Ruby version and gem dependencies are specified
• Getting Started—Working with course materials in the github-pages/jekyll format used by UCSB CS
• git/github: overview—An introduction. git vs. github.com vs. github.ucsb.edu, repos, etc.
• git: basic workflow—The basics: git add..., git commit..., git push ...
• git: cloning your first repo—A guide for those new to git
• git: make copy without forking—Making a copy of one repo from another without forking
• github.com: creating private repos under an organization—for closed source class assignments
• Github: course linker—A homegrown tool to enable self-signup for github course orgs
• Github: course organizations—Setting up an organization for use in a course
• github-pages: overview—A hosting solution for Jekyll formatted websites
• github: using ssh keys—generating public/private key pair, uploading public key to github
• gitignore for Jekyll—Which files should be in your .gitignore for a Jekyll repo
• Gradescope Conversion—Converting submit.cs labs to Gradescope
• Gradescope Scanning—Tips for working with Gradescope scanned assignments
• index.md—Creating the home page for the site
• JavaScript: —An overview of how JavaScript works with the course websites
• Jekyll: —The software that powers Github Pages and our course websites
• Jekyll: Running on localhost for MacOS—How to run Jekyll on localhost on a Mac (install rvm, etc.)
• Jekyll: on localhost, Windows 10—How to run Jekyll on localhost on Windows 10
• Jekyll: Setup—Dealing with Jekyll versions, Ruby Versions, etc.
• JQueryMobile—Oddities of working with JQueryMobile
• LaTeX in .md files—How to add LaTeX support to a Jekyll based github pages site
• Layouts and Includes—The contents of the `_layouts` and `_includes` directories
• Nav Bars—Information about the navigation bars at top and bottom of pages
• Nokogiri Compilation Problems—Problems when running ./setup.sh on Mac OS with Nokogiri
• Remote Jekyll Theme: Converting pre-W19 sites—How to do the conversion
• repo organization—the basic files that you need in the repo to set up a course website
• Report an Issue—Where to report issues with the course-repo-jekyll-theme
• Running Locally: —Running jekyll/github-pages on your own machine (Windows, Mac, Linux) to see errors, test, and stage a website
• Running Locally: Gemfile—Specifying the version of Ruby and Github Pages used to create the site locally and on Travis CI
• Running Locally: jekyll.sh—When running locally, what should the jekyll.sh file contain?
• Running Locally: rvm—Installing the Ruby Version Manager (rvm) so you can run Jeykll locally
• Running Locally: setup.sh—When running locally, what should the setup.sh file contain?
• RVM installation—How to install RVM, and why you might want to
• Security—About that Github message: 'We found potential security vulnerabilities in your project' and how to fix it
• setup.sh—The setup file
• setup.sh tips—Troubleshooting problems that can occur while running setup.sh
• syntax—The various flavors (Markdown, HTML, Liquid, etc.) and where they are used
• Travis CI—Automatically checking and reporting your errors
• troubleshooting—What to do when it doesn't seem to be working