supercollider.github.io [this site]
The pages hosted at https://supercollider.github.io are built using github’s Jekyll system. Page and posts are simple markdown documents and github generates these to static pages whenever changes are pushed.
The content, being simple markdown, is portable and can be moved to whatever trendy system comes along next.
This repo is at https://github.com/supercollider/supercollider.github.io
Fixing a typo or something small
You can edit and create files directly there on github. Look for an edit link at the bottom of each page.
Visit the repo on github and edit the page using the github interface. This will submit a pull request to the supercollider organization. When we accept the pull request (click the button) it gets merged in and the pages will regenerate on github. No need to mess with jekyll or cloning the repo.
see also Syntax and styling
Working with Jekyll and a checked out repo
Jekyll can render to html
_sites but this content is not checked into git and github does not need it to be rendered. They will render using their own Jekyll anytime you push to the repo.
Check out this repository, install gem and jekyll (plenty of help online) and start up the server to view changes in preview mode:
jekyll serve --watch
Alternatively, for older jekyll version (< 1.0):
jekyll --server --auto
Adding news posts and pages
A post is a page that has a publish date and appears in the dated archives. It also appears in the RSS/Atom feed and in the latest news on the front page.
A page is a wiki page, simple document.
A page or post must have this YAML front matter at the top:
--- layout: page title: "Building from source" published: true category: development sort_order: 3 ---
Pages go in
category-name/page-name.md and should always have the category set in the header variables to be the same as the folder it is in. Otherwise it doesn’t show up in the page index.
Posts (announcements and news with dates) go in
_posts and must include a date in the file name:
Easiest is to use the rake tasks to generate a stub for a new page. This sets the date format for posts correctly.
Use the rake tasks from the command line:
# list tasks rake -T # create a new post rake post title="a new title" # create a page rake page name="category/post-name.md"
For pages you can also just create markdown files inside folders.
will result in
Be sure to set some YAML front matter (the variables) at the top of your page if its a markdown file. See https://github.com/mojombo/jekyll/wiki/YAML-Front-Matter
Linking to other pages. github only ? category / post-name
Jekyll seems to kill iframes reducing them to a single
<iframe /> so put a word in the tag:
<iframe ...>invisible words</iframe> to fool it.
Internal links are relative to the current document and should use the .html form, eg.:
See [Syntax styling and markdown](syntax-and-styling.html)
Simply push to this repo and github will regenerate the site.