This webpage uses Jekyll, a static website generator.
This webpage uses just-the-docs as a Jekyll theme.
Reading the documentation for both of these is recommended.
GitHub pages allows for the use of remote themes, meaning none of the theme-specific html and css are hosted here.
Pages are inside the pages folder. Each is a markdown file, allowing for the use of markdown syntax for creating the pages. These files get converted to html behind the scenes, so embedding html in the .md files works.
Images are stored in the images folder.
Documents, such as .pdf files, are stored in the docs folder.
Site-wide configuration is done in _config.yml. This is where we configure jekyll and the theme specific options.
Changes are not made to this branch (gh-pages) directly. Instead, fork from the main repository, make your changes to doc/gh-pages, and create a pull request. Once merged, those changes will then be reflected in the gh-pages branch.
To edit a page, open the corresponding .md file and make changes. Refer to the markdown cheatsheet for how to format your page.
To add a page, create a new .md file for that page in the pages folder with a unique, relevant name. Make sure to include a header with the jekyll configuration for the page. The most important configurations are shown bellow:
---
title: <webpage title - will be what displays in the navigation column>
nav_order: <position in the navigation column>
parent: <what page is its parent in the navigation column>
has_children: <true/false - set to true if another page has this page as its parent>
nav_exclude: <true/false - whether to exclude this page from the navigation column>
---
These headers are what determine the navigation column on the left side of the page. Make sure to configure your page's navigation by ensuring your new page has the appropriate parent or child/children. A simple one, like for the landing page, might look like this :
---
title: Home
nav_order: 1
---
whereas a more complicated one, with parents and children, might look like this:
---
title: Contribute
parent: Community
nav_order: 1
has_children: true
---
For more in depth explanation of the navigation, view the navigation documentation for the theme.
To add an image, add the image to the images folder, and link to it using markdown syntax:  in your page's .md file. When linking these, keep in mind that the file names, and file extensions, are case sensitive. The link above would not work on an image named Image.png or image.PNG
To add a document, such as a pdf, and embed it in the page, add the document to the docs file, and use the following snippet of html in your page's .md file,
<embed src="https://mne-tools.github.io/mne-cpp/docs/file-name.pdf" width="800px" height="500px" type="application/pdf" />
replacing file-name.pdf with the name of your document.