@@ -29,7 +29,7 @@ See the above links for details.
...
@@ -29,7 +29,7 @@ See the above links for details.
This is a [*static website*](http://en.wikipedia.org/wiki/Static_web_page) automatically generated with [Jekyll](http://jekyllrb.com/) by [GitHub Pages](http://pages.github.com/).
This is a [*static website*](http://en.wikipedia.org/wiki/Static_web_page) automatically generated with [Jekyll](http://jekyllrb.com/) by [GitHub Pages](http://pages.github.com/).
### Editing pages online with GitHub
### Editing pages online with GitHub / GitLab
You can edit any page by following the `Edit this page` link in the Quick links nav bar.
You can edit any page by following the `Edit this page` link in the Quick links nav bar.
Alternatively, you can directly navigate to the corresponding `.md` (Markdown) file in GitHub.
Alternatively, you can directly navigate to the corresponding `.md` (Markdown) file in GitHub.
...
@@ -50,6 +50,30 @@ Other reasons why GitHub's preview may not correspond to the final results are:
...
@@ -50,6 +50,30 @@ Other reasons why GitHub's preview may not correspond to the final results are:
- Use of [Liquid templates](https://github.com/Shopify/liquid/wiki/Liquid-for-Designers) in the source.
- Use of [Liquid templates](https://github.com/Shopify/liquid/wiki/Liquid-for-Designers) in the source.
- Use of special purpose markup, HTML, and scripts, such as mathematical excerpts written in [MathJax](http://mathjax.org/).
- Use of special purpose markup, HTML, and scripts, such as mathematical excerpts written in [MathJax](http://mathjax.org/).
### Editing the menu
The menu of the page is defined in the ``_config.yml`` file.
It contains three kinds of items:
1.**Folder menu**. An expandable sub-menu that contains all pages in a specific folder.
2.**Internal links**. A single link to a specific page.
3.**External links**. A link to an external page that automatically opens in a new tab.
The items can be defined by inserting them into the appropriate place in the list of menu items.
They look like
```yaml
# A folder menu for the /people/ folder
-title:'People'
folder:'people'
# A single link to the /news/ page.
-title:'News'
url:'/news/'
# An external link to the bibliography page
-title:'Bibliography'
external:true
url:'https://kwarc.github.io/bibs/'
```
### Working locally
### Working locally
If you want to do more than the occasional editing, you'll soon realise GitHub's editor and preview are too limited.
If you want to do more than the occasional editing, you'll soon realise GitHub's editor and preview are too limited.