[GRASS-dev] Topic oriented GRASS manual pages

[Hamish]

Markus Neteler wrote:
> using the second keyword of each module, I have auto-generated
> a topic oriented GRASS manual. I wrote a small shell script
> for this.
> 
> Draft version available at:
> http://gis.cri.fmach.it/download/grass_html/topics.html
> 
> Try for example:
> - classification
> - hydrology
> - statistics
> 
> The second keyword list should be carefully revisited (while
> not breaking too many translations) to better group the commands.
> However, even in the current state it will be useful.
> 
> Markus
> 
> PS: Likely it would be better to rewrite my shell script to
> Python. It could then be run on the GRASS web site weekly.


Hi,

it will be good to finally make better use of the keywords!

instead of relying on keyword order, might I suggest to create a
growing table, where every new keyword creates a new bin.
bins with counts >=2 create a page like the ones you've made,
singleton keywords get ignored.
Probably python would be best for that..

instead of lots of pages with 2-3 modules listed on them, perhaps
make into 1-cell tables instead, and put all on the same page, with
a 3-4 column TOC at the top by keyword.
except maybe if >=25 hits in the group, in which case create a separate
page and link to it from the main list.

...

I though it would be neat to make one of those word jumbles with size
proportional to frequency of keyword occurrence, perhaps with live links
from the words within it to the <a name> or <a href> of the keyword's
1-cell table described above. There's a good java app called Wordle for
it, and a number of word cloud packages for R.

here are some quick samples:

# extract keywords:
grep -A1 '^\.SH KEYWORDS$' "$GISBASE/man/man1"/* | \
    grep -v '\.SH KEYWORDS$\|\.SH SYNOPSIS\|^--$' | \
    cut -f2- -d- | tr ',' '\n' | \
    sed -e 's/^ //' -e 's/ /~/' \
   > keywords_lists~.txt


cut & paste into  http://www.wordle.net/create

click on "random" .. I used the "moss" color scheme.


see attached and some PDF proofs:
 http://bambi.otago.ac.nz/hamish/grass/GRASS_Keywordle.zip   (~1mb)


Hamish
-------------- next part --------------
A non-text attachment was scrubbed...
Name: GRASS_Keywordle.png
Type: image/png
Size: 54968 bytes
Desc: not available
Url : http://lists.osgeo.org/pipermail/grass-dev/attachments/20120222/8fbd5a05/GRASS_Keywordle-0001.png