[Ach] Conversion to Markdown

[Rainer Hoerbe]

asciidoc is similar to markdown, but powerful enough to do real publishing work. References do work. Github does render single file asciidoc documents on the fly, like markdown.

An example specification done with the asciidoc toolchain is this:
https://github.com/KantaraInitiative/SAMLprofiles/tree/master/docs/A%20WebSSO%20Implementation
The resulting document looks like this:
https://htmlpreview.github.io/?https://github.com/KantaraInitiative/SAMLprofiles/blob/master/rendered/WebSSOeGovProfile.html

There are several toolchains available, even a GUI-Editor with ASCIIDOCFX. 

- Rainer

> Am 13.03.2016 um 21:43 schrieb Sebastian <sebix at sebix.at>:
> 
> Hi,
> 
> I started to convert the project to markdown this weekend. I retained
> the current structure, so all .tex in use have been renamed to .md. I
> deleted the .tex wherever I did a basic conversion, even if parts of it
> are broken. All remaining .tex-files are currently not used.
> 
> Biggest issues currently:
> - configs from files are not supported now
> - not all references (internal and bibliography) do work
> - formatting is ugly, I only fixed the biggest issues yet.
> 
> I'm working on branch markdown in my fork. Any help is appreciated.
> https://github.com/sebix/Applied-Crypto-Hardening/tree/markdown
> 
> Here are the two compiled files:
> https://appliedcryptohardening.org/src/applied-crypto-hardening.html
> https://appliedcryptohardening.org/src/applied-crypto-hardening.pdf
> 
> Sebastian
> 
> -- 
> python programming - mail server - photo - video - https://sebix.at
> cryptographic key at https://sebix.at/DC9B463B.asc and on public keyservers
> 
> 
> _______________________________________________
> Ach mailing list
> Ach at lists.cert.at
> http://lists.cert.at/cgi-bin/mailman/listinfo/ach