2009-05-17

Markdown

Я, собственно, к чему про CamelCase-то излагал... Я решительно подсел на вики-движки последнее время, в основном по работе. Архиудобный способ документооборота, но есть у всей затеи одна ахиллесова пята: каждый разработчик считает своим долгом придумать свой синтаксис. В итоге имеем такой зоопарк, что мама не горюй.

К счастью, не я первый озаботился. Markdown -- язык разметки, проще которого я лично ничего не видел (да, это круче чем reStructuredText). Для начала, несколько вариантов исходного текста для TWiki/Foswiki, MediaWiki, PmWiki, MoinMoin/Trac:

---++ Foswiki

* =Perl=, [[http://www.gnu.org/copyleft/gpl.html][GPL]]
* AutoLinking of !CamelCase -- _should_ *burn in hell*

<verbatim>
Why do they hate developers?
Publishing code sample is pain in the ass.
</verbatim>


Справедливости ради надо отметить, что автоматические ссылки для ГорбатогоРегистра в TWiki/Foswiki можно отключить хоть для отдельной страницы, хоть для раздела (веба), хоть для всея Вики.

* Set NOAUTOLINK = on


спасет отца русской демократии. Но вернемся к баранам:

== MediaWiki ==

* <tt>PHP</tt>, [http://www.gnu.org/copyleft/gpl.html GPL]?
* No [[AutoLinking]] of CamelCase -- ''should'' be '''default behaviour'''

Formatting code block is very easy.
Note the space at the beginning of the line.


!! PmWiki

* @@PHP@@, [[http://www.gnu.org/copyleft/gpl.html | GPL]]
* No [[AutoLinking]] of CamelCase -- ''should'' be '''default behaviour'''

Formatting code block is very easy.
Note the space at the beginning of the line.


== MoinMoin ==

* `Python`, [[http://www.gnu.org/copyleft/gpl.html | GPL]]
* AutoLinking of !CamelCase -- ''should'' '''burn in hell'''

{{{
Formatting code block is easy and logical.
They also have syntax highlighting.
}}}


Ну не трэш? Особенно теги в вики-разметке. А можно сделать так:

## Markdown

* `Perl`, [BSD license](http://daringfireball.net/projects/markdown/license.text)
* No [AutoLinking][ref] of CamelCase -- _should_ be **default behaviour**

[ref]: http://my.page.org/AutoLink "Reference links can also be used"

Formatting code block is very easy.
Note the TAB at the beginning of the line.


Единственный случай, когда исходный текст читается не хуже отформатированного. В моем идеальном мире все разработчики вики-движков сей же час кинутся адоптировать этот синтаксис, минимум как опцию. Благо библиотек масса.

Далее, родной Blogspot мог бы поддержать. Окромя HTML и WYSIWYG, будь он неладен, хотелось бы Markdown.

Ну и при совсем хорошем раскладе, нужен нормальный десктопный софт. Чтобы снести нахер на свалку истории текстовые редакторы из офисных пакетов. Тогда наконец сбудется наивная мечта навсегда отделить данные от разметки. А секретарш обучим, не вопрос.

No comments: