OK, just fixed the version read from VERSION.txt in conf.py and updated html_tilte property - in the title was still v4.5 instead of the current version.<div><br></div><div>I tried it on mac os but the arguments for sphinx-build command where not used like I thought it would. Therefore the python conf.py update to read from version file instead of parameters for sphinx-build command in Makefile</div>
<div><br></div><div>In addition I searched all 'OSGeo Live' occurrences and replaced it with OSGeo-Live.</div><div><br></div><div>Last but not least I updated the copyright to 2011.</div><div><br></div><div>Cheers, Frank<br>
<br></div><div><div class="gmail_quote">2011/7/1 Cameron Shorter <span dir="ltr"><<a href="mailto:cameron.shorter@gmail.com">cameron.shorter@gmail.com</a>></span><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<u></u>
<div text="#000000" bgcolor="#ffffff">
<br>
Thanks Frank for digging into this.<br>
My comments inline.<div class="im"><br>
<br>
On 1/07/2011 5:42 PM, Frank Gasdorf wrote:
<blockquote type="cite">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]. <br>
</div>
</blockquote>
<br></div>
Good idea. Feel free to implement this.<div class="im"><br>
<blockquote type="cite">
<div>Second I'd like to discuss, whether it is required to have
the version number everywhere.</div>
</blockquote>
<br></div>
Again, good idea to only use the version in the title. Feel free to
implement.<div class="im"><br>
<br>
<blockquote type="cite">
<div> IMHO we should use the <b>html_title</b> option (Default is
"<project> v<release> documentation" and change it
to "<project> <version> documentation".</div>
</blockquote>
<br></div>
I'm not sure how this works, but if you have worked it out, I trust
your judgement. <br><div class="im">
<br>
<blockquote type="cite">
<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>
</blockquote>
<br></div>
They were originally to note what was the version of osgeo-live when
the docs were created. However, as you have picked up, the field has
not been getting updated.<br>
I suspect it would be better to remove this field all together from
all docs. If no one else objects within 48 hours. Feel free to
remove this field in all docs.<div class="im"><br>
<br>
<blockquote type="cite">
<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 style="margin:0pt 0pt 0pt 40px;border:medium none;padding:0px">
<div><font face="'courier new',
monospace">make html <br>
</font></div>
</blockquote>
</blockquote>
<br></div>
docs are made by calling:<br>
bin/install_main_docs.sh<br>
which calls "make html"<div class="im"><br>
<br>
<blockquote type="cite">
<div>in the root doc folder? Is the conf.py still required or just
an old artifact not used anymore?</div>
</blockquote>
<br></div>
I'm not sure. If you remove it, and the build still works, then it
probably isn't being used and can be removed.<div class="im"><br>
<br>
<blockquote type="cite">
<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>
</blockquote>
<br></div>
Feel free to commit your proposed fixes to svn. If there are issues,
then we have enough time correct them.<br>
I'll check the docs and comment after you have committed the
changes.<br>
<br>
<blockquote type="cite"><div class="im">
<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" target="_blank">http://sphinx.pocoo.org/config.html#project-information</a></div>
</div><pre><fieldset></fieldset>
_______________________________________________
Live-demo mailing list
<a href="mailto:Live-demo@lists.osgeo.org" target="_blank">Live-demo@lists.osgeo.org</a>
<a href="http://lists.osgeo.org/mailman/listinfo/live-demo" target="_blank">http://lists.osgeo.org/mailman/listinfo/live-demo</a>
<a href="http://wiki.osgeo.org/wiki/Live_GIS_Disc" target="_blank">http://wiki.osgeo.org/wiki/Live_GIS_Disc</a></pre>
</blockquote>
<br>
<br>
<pre cols="72">--
Cameron Shorter
Geospatial Solutions Manager
Tel: +61 (0)2 8570 5050
Mob: +61 (0)419 142 254
Think Globally, Fix Locally
Geospatial Solutions enhanced with Open Standards and Open Source
<a href="http://www.lisasoft.com" target="_blank">http://www.lisasoft.com</a>
</pre>
</div>
</blockquote></div><br></div>