[GRASS-dev] [GRASS GIS] #151: make documentation be full text searchable: use sphinx

GRASS GIS trac at osgeo.org
Mon Aug 13 15:06:57 PDT 2012


#151: make documentation be full text searchable: use sphinx
-------------------------+--------------------------------------------------
 Reporter:  timmie       |       Owner:  epatton    
     Type:  enhancement  |      Status:  assigned   
 Priority:  major        |   Milestone:  7.0.0      
Component:  Website      |     Version:  unspecified
 Keywords:               |    Platform:  Unspecified
      Cpu:  Unspecified  |  
-------------------------+--------------------------------------------------

Comment(by lucadelu):

 Replying to [comment:18 hamish]:
 > Replying to [comment:17 lucadelu]:
 > > Once solved, the resulting HTML pages could replace the current manual
 > > pages (since also search is provided).
 >
 > erhm, once solved and building in parallel ''discussion'' on if that
 should happen could begin. Personally I am not in favour of throwing away
 all the strongly marked up work we have done in the description.html files
 in favour of the rather erratic and obscure markup of reSt for those
 pages. Perhaps 'finicky' is a better word. I'm happy to see the help pages
 get pretty, and yes reSt+sphinx-alikes is very pretty, but would like it
 to be in parallel, and reSt translated from our existing HTML docs
 automatically (ie the description.html parts), in the same way (or better)
 than the man pages are now.
 >

 yes no problem for me to keep both versions

 >
 > thanks,
 > Hamish

 best
 Luca

-- 
Ticket URL: <http://trac.osgeo.org/grass/ticket/151#comment:21>
GRASS GIS <http://grass.osgeo.org>



More information about the grass-dev mailing list