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!

diff --git a/docs/_data/extra_pages.json b/docs/_data/extra_pages.json
new file mode 100644 (file)
index 0000000..5ede56c
--- /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 ffb30b9634c0f227741059df8f4dd23b1dd690d9..2969162a2a3ecbaac47f89452d3404b9212cc2d2 100644 (file)
--- 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 %}