Re: [gentoo-user] SOT (Slightlt OffTopic): Scriptable Documentation system (HTML/PDF) ?
Alex Thorne [17-02-07 20:36]: > > What can be choosen as "glue" between the > > "outside world" and TeX? > > > > If you're looking for something to convert between different markups, e.g. > LaTeX and HTML, perhaps Pandoc would be appropriate > > http://pandoc.org/ > > Alex > > > Hi @all, WHOW! Thanks a LOT for that detailed and many input! That helps on this side A LOT...didn't expected that there that much ways to do it :) NICE! To answer the question: No, the target group reading the docs are inhouse customers reading the software documentation on somehow user-level. Neither science heavy stuff nor math-loaded landscapes of formula (I *LIKE* TeX, though)! TeX is for typesetting what UNIX/Linux is for OSses;) If you you use something different -- you will get something different... (OK, really not meant seriously...I am just in the mood for building some phrases...;) ;) ;) Wanted input is ASCII (called UTF-something nowadays) - target formats are HTML and PDF and maybe xlsx (and docx).
Re: [gentoo-user] SOT (Slightlt OffTopic): Scriptable Documentation system (HTML/PDF) ?
On 02/07/2017 01:59 PM, meino.cra...@gmx.de wrote: > Hi, > > to create documentation about changes in the > contents of releases, of the installation > instruction and in system requirements I need > a system, which is scriptable and therefore > automatable. > > Current state is to make or changes manually > in the different docs. > It sounds like you want text, HTML, or some other output format -- except with "include" directives and some preprocessing. Depending on your needs, dev-python/sphinx might work out-of-the-box. I've used it to create docs for Python projects, and you can see an example of the HTML/LaTeX output, constructed from the same source: HTML : http://michael.orlitzky.com/code/dunshire/doc/ LaTeX : http://michael.orlitzky.com/code/dunshire/doc/dunshire.pdf If Sphinx isn't right for you, try a static website generator: https://www.staticgen.com/ What you wind up with is sort of like a Makefile for your document. And since HTML is only one potential output format, you can use it for things other than websites.
Re: [gentoo-user] SOT (Slightlt OffTopic): Scriptable Documentation system (HTML/PDF) ?
On Tuesday 07 Feb 2017 19:24:11 Alex Thorne wrote:
> > What can be choosen as "glue" between the
> > "outside world" and TeX?
>
> If you're looking for something to convert between different markups, e.g.
> LaTeX and HTML, perhaps Pandoc would be appropriate
>
> http://pandoc.org/
>
> Alex
I seem to recall GNU have a 'system' which generates various manual formats
from a single input. I expect this would be script{ed,able} but I don't know
much more about it.
--
Regards,
Mick
signature.asc
Description: This is a digitally signed message part.
Re: [gentoo-user] SOT (Slightlt OffTopic): Scriptable Documentation system (HTML/PDF) ?
> What can be choosen as "glue" between the > "outside world" and TeX? > If you're looking for something to convert between different markups, e.g. LaTeX and HTML, perhaps Pandoc would be appropriate http://pandoc.org/ Alex >
[gentoo-user] SOT (Slightlt OffTopic): Scriptable Documentation system (HTML/PDF) ?
Hi, to create documentation about changes in the contents of releases, of the installation instruction and in system requirements I need a system, which is scriptable and therefore automatable. Current state is to make or changes manually in the different docs. Is TeX the right choice for the document generating backend? What can be choosen as "glue" between the "outside world" and TeX? Thank you very much for any regarding this problem! :) Cheers Meino
