docs: work around GitHub pages weirdness

Fixes: #10546

diff --git a/docs/index.md b/docs/index.md
index 5857c4021736fd1aff576c3155894352802187c8..f27aeaad2bd03d0fa2d197e95da0b560afe0fc01 100644 (file)
--- a/docs/index.md
+++ b/docs/index.md
@@ -5,10 +5,10 @@
 * [The Boot Loader Interface](https://systemd.io/BOOT_LOADER_INTERFACE)
 * [The Boot Loader Specification](https://systemd.io/BOOT_LOADER_SPECIFICATION)
 * [Control Group APIs and Delegation](https://systemd.io/CGROUP_DELEGATION)
-* [The systemd Community Conduct Guidelines](https://systemd.io/CODE_OF_CONDUCT)
+* [The systemd Community Conduct Guidelines](https://github.com/systemd/systemd/blob/master/docs/CODE_OF_CONDUCT.md)
 * [Code Quality Tools](https://systemd.io/CODE_QUALITY)
 * [Coding Style](https://systemd.io/CODING_STYLE)
-* [Contributing](https://systemd.io/CONTRIBUTING)
+* [Contributing](https://github.com/systemd/systemd/blob/master/docs/CONTRIBUTING.md)
 * [Porting systemd To New Distributions](https://systemd.io/DISTRO_PORTING)
 * [Known Environment Variables](https://systemd.io/ENVIRONMENT)
 * [Hacking on systemd](https://systemd.io/HACKING)

diff --git a/tools/make-index-md.sh b/tools/make-index-md.sh
index ab52bb2c55d42282c506ea213957154d251c84a2..78506cbf396040c7b5a5a8e44ee66e8404bb9392 100755 (executable)
--- a/tools/make-index-md.sh
+++ b/tools/make-index-md.sh
@@ -9,7 +9,23 @@ cd "$@"/docs/
         for f in *.md ; do
                 if [ "x$f" != "xindex.md" ] ; then
                         t=`grep "^# " "$f" | head -n 1 | sed -e 's/^#\s*//'`
-                        u="https://systemd.io/"`echo "$f" | sed -e 's/.md$//'`
+
+                        if [ "x$f" = "xCODE_OF_CONDUCT.md" -o "x$f" = "xCONTRIBUTING.md" ] ; then
+                                # For some reason GitHub refuses to generate
+                                # HTML versions of these two documents,
+                                # probably because they are in some way special
+                                # in GitHub behaviour (as they are shown as
+                                # links in the issue submission form). Let's
+                                # work around this limitation by linking to
+                                # their repository browser version
+                                # instead. This might not even be such a bad
+                                # thing, given that the issue submission form
+                                # and our index file thus link to the same
+                                # version.
+                                u="https://github.com/systemd/systemd/blob/master/docs/$f"
+                        else
+                                u="https://systemd.io/"`echo "$f" | sed -e 's/.md$//'`
+                        fi
                         echo "* [$t]($u)"
                 fi
         done