[Qgis-community-team] conventions about sections

[Otto Dassau]

Am Wed, 16 May 2012 11:49:12 +0200
schrieb Larissa Junek <junek at gbd-consult.de>:

> Am Tue, 8 May 2012 12:46:16 +0200
> schrieb Larissa Junek <junek at gbd-consult.de>:
> 
> > Hi Jean-Roc and Alex Bruy,
> > 
> > working on the new rst-Documents I analysed the way we structure
> > sections. At the moment we use --- for chapters, === for subchapters,
> > *** for susubchapters  and ~~~ for sections. I'm o.k. with that but
> > how does this convention fit together with the conventions in the 
> > http://sphinx.pocoo.org/rest.html#external-links ? 
> > Here the --- is one lever lower than the === ... Somebody who can help
> > me understandig ? If you have further definitions can you add them in
> > the README.rst ?
> > 
> > Kind regards,
> > Larissa 
> > 
> > _______________________________________________
> > Qgis-community-team mailing list
> > Qgis-community-team at lists.osgeo.org
> > http://lists.osgeo.org/mailman/listinfo/qgis-community-team
> 
> Hi all,
> 
> the automatic translation didn't bring up a good solution for
> sections, it seems to be a little mixed up. I would suggest to proceed
> the following way:
> 
> *******
> Chapter   Section   Subsection   **Minisection**
> *******   =======   ----------
> 
> --> Example:
> 
> ***********************
> Using QGIS Core Plugins     
> *********************** 
> 
> OpenStreetMap Plugin
> ==================== 
> 
> Basic User Interface
> --------------------  
> 
> **OSM Features widged**
> 
> Would that be ok?
> 
> Kind regards,
> Larissa

Hi Larissa,

I like that idea - 3 TOC levels are enough. And since \minisec{} in latex
also didn't appear in the TOC the **solution** would mean the same in rst.

Regards
Otto