Hello,<div><br></div><div>I'd like to get feedback for little enhancements for the OSGeo Live Documentation.</div><div><br></div><div>Right now Makefile for the online docs replaces "OSGeo-Live" with OSGeo-Live <versionnumber> in all resulting html files as a post process after sphinx generated html files. After a grep of all *.rst files in the English sub folder with the regular expression "OSGeo.Live" the resulting list has two different versions of this String : OSGeo-Live and OSGeo Live.</div>
<div><br></div><div>Therefor not everywhere is the version number concatenated, which leads me directly to the proposal:</div><div><br></div><div>First I'd like to update the Makefile in a way, that the predefined variables release and version should be used to build html's [1]. </div>
<div>Second I'd like to discuss, whether it is required to have the version number everywhere. IMHO we should use the <b>html_title</b> option (Default is "<project> v<release> documentation" and change it to "<project> <version> documentation".</div>
<div><br></div><div>Third I'd like to ask you, what is :Version: in most of the rst-files for? Some have osgeo-live4.0, some osgeo-live4.5 and some files don't have this metadata at all. Maybe we could synch all files and update to :Version: |version|</div>
<div><br></div><div>Correct me, if I'm wrong: Is it right that the online docs are build with the Makefile in this way:</div><blockquote class="webkit-indent-blockquote" style="margin: 0 0 0 40px; border: none; padding: 0px;">
<div><font class="Apple-style-span" face="'courier new', monospace">make html </font></div></blockquote><div>in the root doc folder? Is the conf.py still required or just an old artifact not used anymore?</div><div>
<br></div><div>And what do you think about a version number in the header (right behind the banner) or footer. Nobody has to care about |version| right behind OSGeo-Live/OSGeo Live in the rst files anymore, translators should not care about these details ...</div>
<div><br></div><div>To get a clue what I'm writing about I attached a patch for you of the Makefile to review. I'm looking for your feedback!</div><div><br></div><div>Thanks,</div><div>Frank</div><div><br></div><div>
<br></div><div>[1] : <a href="http://sphinx.pocoo.org/config.html#project-information">http://sphinx.pocoo.org/config.html#project-information</a></div>