Please no XML as the source, it adds way too much emphasis on the structure instead of the content.
Asciidoc is pretty good. It can be configured quite close to markdown <http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#markdown-compatibility-asciidoctor-only> and supports all the nice things that you need for bigger documents like TOC, includes, simple macros and list definitions, ... On Tue, 24 Nov 2015 at 15:02 Emmanuel Surleau <[email protected]> wrote: > To generate docsets for zeal: https://kapeli.com/docsets > > On Tue, Nov 24, 2015 at 3:25 PM, Matthias Beyer <[email protected]> > wrote: > >> On 24-11-2015 15:00:33, Profpatsch wrote: >> > On 15-11-23 08:03pm, Jan Malakhovski wrote: >> > >> > I thought about this in the past, as a first step it would be a killer >> > feature to be able to use the documentation on the system with >> > https://zealdocs.org/ (as compared to using the outdated versions >> provided >> > by default). >> > >> >> While I consider zeal a really great idea, I would like to note that >> plain-text access is essential. I don't know whether this is possible >> if we ship documentation through zeal and even if it is possible: Is >> it still readable? I don't know anything about the formats zeal uses. >> >> The proposal I filed for compiling markdown sources from the nixpkgs >> repository into pdf or html could be used for shipping documentation >> with zeal, if zeal is able to include the html I generate with pandoc, >> right? >> >> -- >> Mit freundlichen Grüßen, >> Kind regards, >> Matthias Beyer >> >> Proudly sent with mutt. >> Happily signed with gnupg. >> >> _______________________________________________ >> nix-dev mailing list >> [email protected] >> http://lists.science.uu.nl/mailman/listinfo/nix-dev >> >> > _______________________________________________ > nix-dev mailing list > [email protected] > http://lists.science.uu.nl/mailman/listinfo/nix-dev >
_______________________________________________ nix-dev mailing list [email protected] http://lists.science.uu.nl/mailman/listinfo/nix-dev
