diff options
author | Lennart Poettering <lennart@poettering.net> | 2019-12-11 10:49:59 +0100 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2019-12-11 10:53:14 +0100 |
commit | 5d3f5e4081964694dd08b9083c923a47eeff79e9 (patch) | |
tree | 93223195d43d488a85f167654837c8baa6496ac6 | |
parent | 4cdca0af114904a51f7ae2091b0c10a37c5e1046 (diff) | |
download | systemd-5d3f5e4081964694dd08b9083c923a47eeff79e9.tar.gz |
docs: beef up entrypoint documentation page
Let's use the rough categorization of the markdown pages to add basic
sections, via Jeykll templating. Also, add in a couple of additional
links via a JSON array that lists them.
So much web development, so much wow!
-rw-r--r-- | docs/_data/extra_pages.json | 10 | ||||
-rw-r--r-- | docs/index.md | 12 |
2 files changed, 19 insertions, 3 deletions
diff --git a/docs/_data/extra_pages.json b/docs/_data/extra_pages.json new file mode 100644 index 0000000000..5ede56c6fc --- /dev/null +++ b/docs/_data/extra_pages.json @@ -0,0 +1,10 @@ +[ + { "category": "Project", "title": "Brand", "url": "https://brand.systemd.io/" }, + { "category": "Project", "title": "Releases", "url": "https://github.com/systemd/systemd/releases" }, + { "category": "Project", "title": "GitHub Project Page", "url": "https://github.com/systemd/systemd" }, + { "category": "Project", "title": "Issues", "url": "https://github.com/systemd/systemd/issues" }, + { "category": "Project", "title": "Pull Requests", "url": "https://github.com/systemd/systemd/pulls" }, + { "category": "Project", "title": "Mailing List", "url": "https://lists.freedesktop.org/mailman/listinfo/systemd-devel" }, + { "category": "Manual Pages", "title": "Index", "url": "https://www.freedesktop.org/software/systemd/man/" }, + { "category": "Manual Pages", "title": "Directives", "url": "https://www.freedesktop.org/software/systemd/man/systemd.directives.html" } +] diff --git a/docs/index.md b/docs/index.md index ffb30b9634..2969162a2a 100644 --- a/docs/index.md +++ b/docs/index.md @@ -4,8 +4,14 @@ title: systemd Documentation # systemd Documentation -{% for p in site.pages %} - {% if p.url != page.url and p.title %} -* [{{ p.title }}]({{ p.url | relative_url }}) +{% assign by_category = site.pages | group_by:"category" %} +{% assign extra_pages = site.data.extra_pages | group_by:"category" %} +{% assign merged = by_category | concat: extra_pages | sort:"name" %} + +{% for pair in merged %} + {% if pair.name != "" %} +## {{ pair.name }} +{% assign sorted = pair.items | sort:"title" %}{% for page in sorted %} +* [{{ page.title }}]({{ page.url | relative_url }}){% endfor %} {% endif %} {% endfor %} |