Try one more time

Add a title to command-reference.rst. This lets us handle the links and references much more smoothly. To avoid the ugly double title, we use CSS to hide the title in the docbook-generated html.
flatpak · Apr 14, 2017 · 770a5cc · 770a5cc
1 parent bb1cdd8
commit 770a5cc
Show file tree

Hide file tree

Showing 4 changed files with 10 additions and 2 deletions.
diff --git a/docs/_static/theme_overrides.css b/docs/_static/theme_overrides.css
@@ -34,3 +34,8 @@ a.icon-home, a.icon-home:hover {
 a, a:visited { color: #4a90d9; }
   .wy-menu a { color: #919191; }
   .wy-side-nav-search a { color: #fff; }
+
+/* Hide the original title in the docbook-generated man pages (flatpak-docs.html) */
+.titlepage .title {
+  display: none;
+}
diff --git a/docs/command-reference.rst b/docs/command-reference.rst
@@ -1,2 +1,5 @@
+Command Reference
+=================
+
 .. raw:: html
    :file: flatpak-docs.html
diff --git a/docs/index.rst b/docs/index.rst
@@ -21,4 +21,4 @@ Contents
    flatpak-builder
    working-with-the-sandbox
    distributing-applications
-   Command reference <http://flatpak.readthedocs.io/en/latest/command-reference.html>
+   command-reference
diff --git a/docs/introduction.rst b/docs/introduction.rst
@@ -59,7 +59,7 @@ The flatpak command
 
 Most flatpak commands are performed system-wide by default. To perform a command for the current user only, use the ``--user`` option. This allows runtimes and application bundles to be installed per-user, for instance.
 
-For more information on flatpak commands, see the :doc:`command reference <command-reference>`
+For more information on flatpak commands, see the :doc:`command-reference`
 
 Identifiers
 -----------