On 09/14/2016 09:38 AM, Manu via Digitalmars-d wrote:
On 14 September 2016 at 21:36, Andrei Alexandrescu via Digitalmars-d
<digitalmars-d@puremagic.com> wrote:
On 9/14/16 1:50 AM, Manu via Digitalmars-d wrote:
Can we produce formulas, or latex in ddoc? Are there any examples in
phobos I can refer to?
https://github.com/dlang/dlang.org/blob/master/latex.ddoc
That's the macros file for generating the language spec in LaTeX format.
Ah, wow, yeah I actually saw this when I googled for it before posting here.
I'm just gonna come out and say that I really don't feel like taking
the few hours it might take me to try and understand what's going on
here. I really have better things to do...
Considering I don't really know latex either, I just have to wing
that, this is like 721 lines of tedious double-indirection, with no
examples in sight ;) (yet I'm being hassled about lack of examples!)
Generally speaking it's difficult to produce good latex documents
without knowing latex, so it may be the case a latex crash course is
needed or the task is ill-defined.
That said, the stuff I published at
http://erdani.com/d/DIP1000-grammar.html and
http://erdani.com/d/DIP1000-typing-baseline.html use MathJAX, you may
want to take a look. Truth be told that's generated code (using a much
smaller ddoc source).
I'm kinda feeling ddoc is fairy serious problem. Doxygen is like... a
lot better :/
I'm struggling to produce docs I'm happy with. Formatting is hard,
macros for everything really sucks!
Why?
Andrei