From: Guenter M. <mi...@us...> - 2010-10-30 20:52:43
|
Dear Docutils developers, especially Dave and Engelbert, with a "math" directive and role in place in the SVN repo, it is time to consider support in the manual and odt writers: Manual writer ------------- How should mathematics be presented: a) convert to text (can we use Unicode?) b) literal LaTeX source c) not at all (throw an error: Math is not supported in manuals) GM: a) is better but b) is simpler to do. ODT writer ---------- * MathML can be imported by the Math module. The ODT writer could import parse_latex_math from docutils.latex2mathml and Convert from LaTeX to MathML like the HTML writer. Putting MathML into an ODT file seems tricky but not impossible: http://idippedut.dk/post/2008/01/25/Do-your-math-ODF-and-MathML.aspx http://idippedut.dk/post/2008/03/03/Now-I-get-it-ODF-and-MathML.aspx * OOoLaTeX__: "a set of macros designed to bring the power of LaTeX into OpenOffice." __ http://ooolatex.sourceforge.net/ I'd prefer to wait for your responses before making the math support "official" by documenting the math directive and role. Günter |
From: engelbert g. <eng...@gm...> - 2010-10-31 07:11:53
|
Dear Guenter, for the manpage-writer man pages are in roff. Roff is a text-formatting program, to support special features roff uses preprocessors that recognize certain input and produces roff output that produces the graphics. The folloowing preprocessors exist: eqn - equations pic - pictures tbl - tables On MacOSX are 3 manpages (javadoc, jdb, jstat) that use tables and nne that uses equations. So for man-pages the equation support is unimportant. If one wants to do it, beaware not all eqn preprocessors are equal. * 1978 Typesetting Mathematics : http://www.kohala.com/start/troff/v7man/eqn/eqn2e.ps * for man pages in consoles neqn is the target. If we consider that the manpage writer was done to easy production of man pages, we might leave equations out of it. Cheers engelbert On Sat, Oct 30, 2010 at 10:52 PM, Guenter Milde <mi...@us...> wrote: > Dear Docutils developers, especially Dave and Engelbert, > > with a "math" directive and role in place in the SVN repo, it is time > to consider support in the manual and odt writers: > > Manual writer > ------------- > > How should mathematics be presented: > > a) convert to text (can we use Unicode?) > > b) literal LaTeX source > > c) not at all (throw an error: Math is not supported in manuals) > > GM: a) is better but b) is simpler to do. > > > ODT writer > ---------- > > * MathML can be imported by the Math module. > > The ODT writer could import parse_latex_math > from docutils.latex2mathml and Convert from LaTeX to MathML like the > HTML writer. > > Putting MathML into an ODT file seems tricky but not impossible: > http://idippedut.dk/post/2008/01/25/Do-your-math-ODF-and-MathML.aspx > http://idippedut.dk/post/2008/03/03/Now-I-get-it-ODF-and-MathML.aspx > > > * OOoLaTeX__: "a set of macros designed to bring the power of LaTeX > into OpenOffice." > > __ http://ooolatex.sourceforge.net/ > > > I'd prefer to wait for your responses before making the math support > "official" by documenting the math directive and role. > > Günter > > > ------------------------------------------------------------------------------ > Nokia and AT&T present the 2010 Calling All Innovators-North America contest > Create new apps & games for the Nokia N8 for consumers in U.S. and Canada > $10 million total in prizes - $4M cash, 500 devices, nearly $6M in marketing > Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi Store > http://p.sf.net/sfu/nokia-dev2dev > _______________________________________________ > Docutils-develop mailing list > Doc...@li... > https://lists.sourceforge.net/lists/listinfo/docutils-develop > > Please use "Reply All" to reply to the list. > |
From: Guenter M. <mi...@us...> - 2010-11-01 20:20:31
|
On 2010-10-31, engelbert gruber wrote: > Dear Guenter, > for the manpage-writer ... > The folloowing preprocessors exist: > eqn - equations ... > So for man-pages the equation support is unimportant. > If one wants to do it, beaware not all eqn preprocessors are equal. > * for man pages in consoles neqn is the target. On my Debian/Linux system, the eqn manpage says: GNU eqn does not provide the functionality of neqn: it does not support low-resolution, typewriter-like devices (although it may work ade‐ quately for very simple input). IMO, "the right way" would be a "latex-math -> troff" or a "latex-math -> text" converter that bypasses the eqn preprocessor. > If we consider that the manpage writer was done to easy production of > man pages, we might leave > equations out of it. Agreed. Could we model visit_math() and visit_math_block() on visit_image() then? (Printing the nodes content (the latex source) instead of the URL or alt-text.) Günter |
From: engelbert g. <eng...@gm...> - 2010-11-01 21:23:17
|
On Mon, Nov 1, 2010 at 9:20 PM, Guenter Milde <mi...@us...> wrote: > On 2010-10-31, engelbert gruber wrote: > >> The folloowing preprocessors exist: > >> eqn - equations > ... > >> So for man-pages the equation support is unimportant. > >> If one wants to do it, beaware not all eqn preprocessors are equal. > >> * for man pages in consoles neqn is the target. > > On my Debian/Linux system, the eqn manpage says: > > GNU eqn does not provide the functionality of neqn: it does not > support low-resolution, typewriter-like devices (although it may > work ade‐ quately for very simple input). > > IMO, "the right way" would be a "latex-math -> troff" or a "latex-math -> > text" converter that bypasses the eqn preprocessor. I understand your logic, but dont agree. * latex-math -> troff: is only harder to do than latex-math -> eqn. eqn: will translate to roff for free. The output will be consistent on the system, but will be printable. * latex-math -> text: might be usable, but i donot know how hard, and what is text anyway (unicode console ?) OTOH: eqn input looks like :: x=2 pi int sin ( omega t)dt int means integral. the rest is pretty readable, so latex-math -> eqn might be considered latex-math -> text somehow. BUT i read in some places i fail to find again, that newer eqn is closer to latex. All in all i would show the latex output, and if someone is in need for eqn he should stand up and say so. I prefer a customer giving targets, my imaginations limits are too wide. cheers |
From: Guenter M. <mi...@us...> - 2010-11-02 11:06:18
|
On 2010-11-01, engelbert gruber wrote: > On Mon, Nov 1, 2010 at 9:20 PM, Guenter Milde <mi...@us...> wrote: >> On 2010-10-31, engelbert gruber wrote: >>> So for man-pages the equation support is unimportant. This is the main point and this we agree on. So the discussion below should not stand in the way. > * latex-math -> troff: is only harder to do than latex-math -> eqn. > eqn: will translate to roff for free. > The output will be consistent on the system, but will be printable. What would be the command sequence I had to use to translate man-page-writer output with eqn-equations to a man page I can view with `man`? > * latex-math -> text: might be usable, but i donot know how hard, and > what is text anyway (unicode console ?) For output formats without math support, I consider a conversion to either * Plain text with Unicode (𝑥 = 2π∫ sin(𝜔𝑡)d𝑡 * a Docutils doctree node with font-attributes similar to what you would get from rst *x* = 2π ∫ sin(*ωt*)d *t* with `graceful degradation` for features that cannot be supported this way. > All in all i would show the latex output, and if someone is in need for eqn > he should stand up and say so. I prefer a customer giving targets ... So do I. Will you implement this or shall I try it... Günter |
From: Guenter M. <mi...@us...> - 2010-11-06 10:43:31
|
On 2010-11-02, Guenter Milde wrote: > On 2010-11-01, engelbert gruber wrote: >> All in all i would show the latex output > ... Done. As a stop-gap measure, the odtwriter shows the latex source, too. Günter |