[GRASS5] New CSS based doc style for GRASS usage examples

Markus Neteler neteler at itc.it
Fri Nov 4 11:21:41 EST 2005


Hi all,

- documentation cosmetics -

I have extended:
 lib/gis/parser.c
 include/Make/Html.make (separated from Rules.html)
 tools/build_html_index.sh

to generate an additional HTML header line to include a simple
CSS style file. Basically the examples can be coded now
like this in the 'description.html' files:

<div class="code"><pre>
v.to.db -p roads option=length type=line units=k
</pre></div>

Such an example appears indented with type write font in a grey box
which makes it easier to distinguish in the text flow.
And: Section titles are green colored now (such as the GRASS Web site).

Example:
 vector/v.to.db/description.html

TODO 1:
Now all the tons of examples should be homogenized and changed to
above style.

TODO 2: Fix tools/g.html2man/g.html2man to accept multiple lines
in above environment (two or more lines of example in a single

<div class="code"><pre>
...
...
</pre></div>

At time the line break is eaten and not preserved (hi Daniel, maybe
you could help?). Maybe these examples could be indented a bit in the
MAN pages?

By tomorrow morning Italian time the updated man pages will be online.

Markus




More information about the grass-dev mailing list