[Nix-dev] Fwd: Wiki is dead

[zimbatm]

Basically wrote the doc in markdown and then:
```
$ nix-env -iA nixos.pandoc
$ pandoc -f markdown -t docbook release.md > release.xml
```
The output file wasn't exactly right, I had to replace `<sect1
id="something">` to `<section>` tags and wrap it in a <chapter> tag. That
was quickly done and less work that writing in docbook directly.

If you don't like markdown it's fine, pandoc is able to translate between a
lot of different formats.

Input formats:  commonmark, docbook, docx, epub, haddock, html, json*,
latex,
                markdown, markdown_github, markdown_mmd, markdown_phpextra,
                markdown_strict, mediawiki, native, odt, opml, org, rst,
t2t,
                textile, twiki
                [ *only Pandoc's JSON version of native AST]
Output formats: asciidoc, beamer, commonmark, context, docbook, docx,
dokuwiki,
                dzslides, epub, epub3, fb2, haddock, html, html5, icml,
json*,
                latex, man, markdown, markdown_github, markdown_mmd,
                markdown_phpextra, markdown_strict, mediawiki, native, odt,
                opendocument, opml, org, pdf**, plain, revealjs, rst, rtf,
s5,
                slideous, slidy, texinfo, textile
                [**for pdf output, use latex or beamer and -o FILENAME.pdf]



On Thu, 25 Feb 2016 at 12:10 Profpatsch <mail at profpatsch.de> wrote:

> > On Tue, 23 Feb 2016 at 21:29 Vladimír Čunát <vcunat at gmail.com> wrote:
> > > My personal opinion is that this is mostly an excuse. It's a XML subset
> > > and everyone should know at least a bit of (X)HTML or similar stuff.
> > > Note that for almost all docs we use ~10 types of tags and the format
> is
> > > by itself human-understandable. (Typically it's enough to copy
> fragments
> > > from a few paragraphs around and edit to have the new content. We might
> > > also compose a list of tags with examples on what we typically use them
> > > for.)
>
> I can confirm that. For small edits, it is enough to copy from the
> surroundings.
>
> On 16-02-23 10:22pm, zimbatm wrote:
> > I started writing some docbook. Maybe I will get used to it but writing
> > `<datasetlist><listitem>foobar</listitem></datasetlist>` is way more
> > painful that `* foobar` in markdown. Especially in writing I think it's
> > important to be able to move text around without too much overhead so
> that
> > text can be reworked until it feels right.
> >
> > Thanks god there is pandoc so I can keep submitting docbook while writing
> > my cozy markdown :)
>
> Maybe we can describe a way to write the docbook documentation in
> <favourite markup> on the local machine and then convert it to docbook
> for check-in.
>
> What is your setup for that?
>
> --
> Proudly written in Mutt with Vim on NixOS.
> Q: Why is this email five sentences or less?
> A: http://five.sentenc.es
> May take up to five days to read your message. If it’s urgent, call me.
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.science.uu.nl/pipermail/nix-dev/attachments/20160225/841ce20b/attachment.html