[Ach] Conversion to Markdown

[Tobias Pape]

I also played around with ReST a year ago.
Results are quite good, and we would have bibliogrpahy and the
possibility for custom stuff like the config files.

Anyway, any three of these ways will take a long time to work out.

Best
	-Tobias

On 13.03.2016, at 21:57, Rainer Hoerbe <rainer at hoerbe.at> wrote:

> 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
> 
> _______________________________________________
> Ach mailing list
> Ach at lists.cert.at
> http://lists.cert.at/cgi-bin/mailman/listinfo/ach