[GRASS-dev] [GRASS GIS] #2207: provide downloadable tar balls of html man pages

[GRASS GIS]

#2207: provide downloadable tar balls of html man pages
--------------------------+-------------------------------------------------
  Reporter:  mlennert     |       Owner:  grass-dev@…              
      Type:  enhancement  |      Status:  closed                   
  Priority:  normal       |   Milestone:  6.4.4                    
 Component:  Website      |     Version:  unspecified              
Resolution:  fixed        |    Keywords:  html man pages download  
  Platform:  Unspecified  |         Cpu:  Unspecified              
--------------------------+-------------------------------------------------

Comment(by hamish):

 see also idea to make a searchable man page android app (can build on
 other existing FOSS unix man page and perl doc apps), and/or using Calibre
 to convert HTML -> free cross-platform eBook.  Calibre needs a little bit
 of guidance to get the chapters right, but for searchable reference manual
 it is more important that the index works than the modules browse in
 order. I tried a quick test-case with the Valgrind docs, without structure
 guidance the chapter and section hierarchy was a big out of order mess,
 but it turned out not to be a big deal since the all the internal links
 worked and I wasn't reading it beginning to end like a story book.

 http://grasswiki.osgeo.org/wiki/Android#Device_used_as_a_reference_guide

 I'm not sure how others work, but for me this is most useful when working
 remotely or on a laptop; at my desk usually it's easier to have the docs
 open side by side in a big monitor or on a second screen/workspace.

 The programmer's manual would be good to eBook-ize or make into an android
 app too. Note HTML is Calibre's preferred input markup language, and
 luckily most of the hard work of standardizing the section h2,h3s and css
 styles is already done.


 ideas,
 Hamish

-- 
Ticket URL: <https://trac.osgeo.org/grass/ticket/2207#comment:5>
GRASS GIS <http://grass.osgeo.org>