[GNC-dev] Yet another documentation compiling oddity

David T. sunfish62 at yahoo.com
Fri Sep 14 10:55:33 EDT 2018


As I am toiling through the depths of the documentation generation process, I am struck by the fact that the base page of the Help is “help.html”, while the base page for the guide is “index.html”.

For consistency, I suggest naming the guide base page “guide.html”; moreover, I suggest having a simple “index.html” placed in the documentation root folder (for me, that will be gnucash-docs/build”):

  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8”>
  <title>GnuCash Documentation</title>
  <meta name="generator" content="DocBook XSL Stylesheets V1.75.2”>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF”>
    <h1 class="title"><strong class="application"><code>GnuCash</code></strong> Documentation</h1>
  <table width="100%" summary="Documentation List">
		  <td width="40%" align="left"><strong xmlns="" class="application"><a href="help/C/help.html"><code>GnuCash</code> Help Manual</a></strong></td>
		  <td>Context menu and system help for <code>GnuCash</code>.</td> 
		  <td width="40%" align="left"><strong xmlns="" class="application"><a href="guide/C/guide.html"><code>GnuCash</code> Tutorial and Concepts Guide</a></strong></td>
		  <td>Tutorial and Concept Guide for <code>GnuCash</code>, which provides in depth descriptions.</td>

More information about the gnucash-devel mailing list