>> Point 4: I'm also switching documentation to markdown. You may have
>> noticed, that in the svn you find markdown versions of the man pages
>> already.
> Sorry, i talk about the guides and tutorials. these are currently written
> with Open/Libre-Office. It is easy to convert to epub with "Writer2ePub".
>
> Olaf
Once the guides and tutorials are all converted to markdown, it is easy 
to put them on the homepage for reading online but also convert them to 
wherever you want. Pandoc (http://johnmacfarlane.net/pandoc/) sounds 
like a suitable tool.

I've long looked for a format, which is easy to write. I don't like to 
have documentation in odt or something else. I really prefer to have 
just text files. They are easier to process automatically. Odt documents 
are difficult to put on a homepage for example. Text files are also easy 
to process even with tools like sed or awk. I can just generate the 
version number from configure.in into the documentation easily if I 
want. Automatic processing of odt is much more difficult.


Tommi

------------------------------------------------------------------------------
Master Visual Studio, SharePoint, SQL, ASP.NET, C# 2012, HTML5, CSS,
MVC, Windows 8 Apps, JavaScript and much more. Keep your skills current
with LearnDevNow - 3,200 step-by-step video tutorials by Microsoft
MVPs and experts. ON SALE this month only -- learn more at:
http://p.sf.net/sfu/learnnow-d2d
_______________________________________________
Tntnet-general mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/tntnet-general

Reply via email to