A mini D book: Markdown or LaTeX?

[Russel Winder via Digitalmars-d]

On Tue, 2017-01-24 at 19:34 +0000, qznc via Digitalmars-d wrote:
> On Tuesday, 24 January 2017 at 14:27:15 UTC, aberba wrote:
> > Which one works well? I'm more concerned about syntax 
> > highlighting and line numbering (in some cases). Support for 
> > custom fonts.
> 
> I used Sphinx here: https://qznc.github.io/d-tut/
> 
> The syntax "ReStructured Text" is more ugly than Markdown, but 
> has more features (e.g. different kinds of blocks). Sphinx can 
> generate HTML, LaTeX, EPub, and more.
> 
> http://www.sphinx-doc.org/

ReStructuredText and Sphinx is used in many places, but much of it is
ugly, particularly compared to Asciidoctor (which has it's own warts)
and XeLaTeX (which also has some).

In the end it all gets tribal, and is down to personal taste.

I am sad for the demise of FrameMaker on Solaris.

-- 
Russel.
=============================================================================
Dr Russel Winder      t: +44 20 7585 2200   voip: sip:russel.winder at ekiga.net
41 Buckmaster Road    m: +44 7770 465 077   xmpp: russel at winder.org.uk
London SW11 1EN, UK   w: www.russel.org.uk  skype: russel_winder
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: This is a digitally signed message part
URL: <http://lists.puremagic.com/pipermail/digitalmars-d/attachments/20170125/10e5fb82/attachment.sig>