#2194: type out formulas in TeX format
----------------------------------------------+-----------------------------
 Reporter:  hamish                            |       Owner:  grass-dev@…       
       
     Type:  task                              |      Status:  new               
       
 Priority:  trivial                           |   Milestone:  7.0.0             
       
Component:  Docs                              |     Version:  svn-trunk         
       
 Keywords:  TeX, formulae, formulas, formulæ  |    Platform:  All               
       
      Cpu:  All                               |  
----------------------------------------------+-----------------------------
Changes (by wenzeslaus):

  * keywords:  TeX, formulae => TeX, formulae, formulas, formulæ


Comment:

 Yes, formulas seems to be very important for scientific GIS.

 What I'm used to see in GRASS manual are not images but just `<div
 class="code"><pre>` blocks with programming-like syntax (preformatted
 plain text). I though that this is the preferred way. But sometimes it
 syntax is very different, especially for fractions.

 The ways how to support nice formulas are something like:

  * existing documentation tool such as [http://sphinx-doc.org/ Sphinx],
 [http://doxygen.org/ Doxygen], or perhaps even low level tools such as
 [http://docutils.sourceforge.net/ Docutils] or
 [http://docutils.sourceforge.net/ pandoc] would be sufficient (i.e. not
 use our custom system and use some tool which already solved this problem)
  * some HTML way such as [http://en.wikipedia.org/wiki/MathML MathML] or
 [http://www.mathjax.org/ MathJax]
  * create some custom tool which would integrate to the current manual
 system (this would bring compile-time dependency, probably LaTeX)
  * go the same way as for images of results (maps) where HTML contains
 steps how to create the image but also the image is in SVN repository (you
 need the tools only if you are updating the formula)
  * use the preformatted plain text option (it wouldn't be nice but unified
 and perhaps easier to use in `r.mapcalc` expression or in code)

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

_______________________________________________
grass-dev mailing list
[email protected]
http://lists.osgeo.org/mailman/listinfo/grass-dev

Reply via email to