This website aims to document student initiatives and resources for the ISTD student board. Adding new pages is easy, just follow this guide!
If you found a mistake in the site, please raise an issue on Github.
If you wish to add new pages, or change the look of the site, please raise PR with the following guide.
With the help of Jekyll, adding new pages is as simple as creating a new Markdown file.
What to do:
- Fork this repository.
- Create a new markdown file with the appropriate file name and path.
- If you create a file
mypage.md
in the root directory of this project, your page will be accessible atistd.opensutd.org/mypage.html
- If you create a file named
mystuff/index.md
, your page will be accessible atistd.opensutd.org/mystuff
- If you create a file named
mystuff/somestuff.md
, your page will be accessible atistd.opensutd.org/mystuff/somestuff.html
.
- If you create a file
- Open a Pull Request to merge your changes into this main repository. We will review your changes and merge if it is appropiate.
Note that this allows you to only add content-only pages, with little to no control over the rest of the page (header, footer) but this should suffice for most use cases.
It is highly recommended to develop locally on your computer to preview the changes before you submit your PR to us. To do so:
- Follow the Ruby + RubyGems + Jekyll install guide here
- Install Bundler and add to PATH
- Clone your fork of the repository to your computer
bundler install
in the root of the project.
We made 3 ways to include CSS using front matter on your markdown file:
- "Global" CSS: Use the
css:
front matter in your markdown file to include a list of files from theassets/css
directory, without the file extensions. This directory is usually reserved for site-wide stylesheets. - "Local" CSS: Use the
local_css:
front matter to include a list of files from the same directory as your page. Usually used if you need "one-off" stylesheets. - Remote CSS: Use the
remote_css
to load remote stylesheets served over a CDN, such as Font Awesome.
You can create normal CSS files, or use SCSS. Jekyll automatically compiles .scss
files that begin with a front matter declaration.
If you need a totally custom page, just upload the full .HTML file. It will not inherit any styles or templates.