[oi-dev] OpenIndiana Docs - updated

[Jim Klimov]

17 мая 2016 г. 8:41:05 CEST, Nikola M <minikola at gmail.com> пишет:
>On 05/17/16 01:25 AM, Michael Kruger wrote:
>>> Other general note. If we have to use some documentation tools to
>write
>>> OI documentation, they should be available in OI repository. Perhaps
>>> it's not true for IDEs, but basic tools should be there.
>>
>>
>> In the case of this website, there really aren't any tools. That's
>the 
>> beauty of it all. The site is completely self contained and inclusive
>
>> of all it's documents. Creating or editing documents only requires a 
>> plain text editor (VIM, Gedit, etc.). 
>
>This is not true as i know, since as I have seen, you require for using
>
>third site for editing asciidoc documents and it is using Google 
>javascripts, undermining privacy.
>
>When mentioning tools, it is meant to have desktop tools to edit files 
>offline and on OI's desktop.
>
>
>_______________________________________________
>oi-dev mailing list
>oi-dev at openindiana.org
>http://openindiana.org/mailman/listinfo/oi-dev

Nikola, did you use asciidoc? There is simple text-file markup similar to that used in ascii emails for decades, and command-line parsers to convert it into xml, html, pdf, whatever. There are Firefox and IDE plugins for realtime previews. The file is perfectly readable and writable in any vi, mcedit or notepad.

You are not required to use evil google or whatever networked to write it, all tools (except dblatex for pdf afaik) are available in oi/hipster today.

Jim
--
Typos courtesy of K-9 Mail on my Samsung Android