Update

Author: dmnks

.github/workflows/jekyll-gh-pages.yml

@@ -37,7 +37,7 @@ jobs:
           podman run -v $PWD:/srv:z --workdir /srv/_build --rm rpm sh -c \
             "cmake .. && make man-html"
 
-          mv _build/docs/man/{*.html,index.md} docs/man/
+          mv _build/docs/_man docs/
 
       - name: Setup Pages
         id: pages

docs/_config.yml

@@ -9,3 +9,7 @@ plugins:
 #  - jekyll-readme-index
   - jekyll-titles-from-headings
   - jekyll-relative-links
+
+collections:
+  man:
+    output: true

docs/man/CMakeLists.txt

@@ -19,20 +19,20 @@ foreach(man ${manuals})
 endforeach()
 add_custom_target(man ALL DEPENDS ${manuals})
 
-set(manuals-html ${manuals})
-list(TRANSFORM manuals-html APPEND .html)
-configure_file(index.sh index.sh @ONLY)
+configure_file(index.md index.md @ONLY)
 configure_file(post.sh post.sh @ONLY)
 foreach(man ${manuals})
-	add_custom_command(OUTPUT ${man}.html
+	set(outfile ${CMAKE_BINARY_DIR}/docs/_man/${man}.html)
+	add_custom_command(OUTPUT ${outfile}
+		COMMAND mkdir -p ${CMAKE_BINARY_DIR}/docs/_man
 		COMMAND scd2html -f
 			< ${CMAKE_CURRENT_SOURCE_DIR}/${man}.scd
-			> ${man}.html
-		COMMAND ./post.sh ${man}.html
+			> ${outfile}
+		COMMAND ./post.sh ${outfile}
 		DEPENDS ${man}.scd)
+	list(APPEND manuals-html ${outfile})
 endforeach()
-add_custom_command(OUTPUT index.md COMMAND ./index.sh)
-add_custom_target(man-html ALL DEPENDS ${manuals-html} index.md)
+add_custom_target(man-html ALL DEPENDS ${manuals-html})
 
 # Install manuals for the enabled features
 set(manuals ${core})

docs/man/index.md

@@ -0,0 +1,21 @@
+---
+layout: default
+title: rpm.org - RPM Manual Pages
+---
+
+{% assign utils = site.man      | where: 'topic', 'util' %}
+{% assign plugins = site.man    | where: 'topic', 'plugin' %}
+
+# RPM Manual Pages
+
+## Tools
+
+{% for page in utils -%}
+- [{{ page.name }}](rpm{{ page.url }})
+{% endfor %}
+
+## Plugins
+
+{% for page in plugins -%}
+- [{{ page.name }}](rpm{{ page.url }})
+{% endfor %}

docs/man/index.sh

@@ -1,11 +1,21 @@
 #!/bin/bash
 
 FILE=$1
-NAME=$(echo "$FILE" | sed 's/^\(.\+\)\.\(.\+\)\.html$/\1(\2)/')
+NAME=$(basename "$FILE" | sed 's/^\(.\+\)\.\(.\+\)\.html$/\1(\2)/')
+
+topic() {
+    case $1 in
+        rpm-plugin*)    echo plugin ;;
+        *)              echo util ;;
+    esac
+}
+
 FRONT_MATTER="\
 ---
 layout: default
 title: rpm.org - $NAME
+name: $NAME
+topic: $(topic $NAME)
 ---
 
 <style type="text/css">