systemd/docs/index.md

---
title: systemd Documentation
---

# systemd Documentation

{% for p in site.pages %}
  {% if p.url != page.url and p.title %}
* [{{ p.title }}]({{ p.url | relative_url }})
  {% endif %}
{% endfor %}
docs: add a "front matter" snippet to our markdown pages It turns out Jekyll (the engine behind GitHub Pages) requires that pages include a "Front Matter" snippet of YAML at the top for proper rendering. Omitting it will still render the pages, but including it opens up new possibilities, such as using a {% for %} loop to generate index.md instead of requiring a separate script. I'm hoping this will also fix the issue with some of the pages (notably CODE_OF_CONDUCT.html) not being available under systemd.io Tested locally by rendering the website with Jekyll. Before this change, the .md files were kept unchanged (so not sure how that even works?!), after this commit, proper .html files were generated from it. 2019-01-03 01:16:34 +03:00			`---`
			`title: systemd Documentation`
			`---`

docs: add a simple, auto-generated index.md This is useful for the github pages feature 2018-10-02 10:53:05 +03:00			`# systemd Documentation`

docs: generate index.md in Jekyll This uses a {% for %} loop in Jekyll to render the page, from the "title" information in the Front Matter of the actual page files. This also makes `make-index-md` build rule unnecessary, since generation is done by the template engine itself. Tested this by running Jekyll locally. 2019-01-03 01:20:39 +03:00			`{% for p in site.pages %}`
			`{% if p.url != page.url and p.title %}`
			`* [{{ p.title }}]({{ p.url \| relative_url }})`
			`{% endif %}`
			`{% endfor %}`