http://habrahabr.ru/rss/post/12903/ ru editor@habrahabr.ru habrahabr.ru Sat, 11 Feb 2012 07:51:51 GMT http://habrahabr.ru/ http://habrahabr.ru/i/logo.gif http://habrahabr.ru/blogs/pm/12903/#comment_214295 http://habrahabr.ru/blogs/pm/12903/#comment_214295 Tue, 07 Aug 2007 22:02:49 GMT powerman http://habrahabr.ru/blogs/pm/12903/#comment_213740 http://habrahabr.ru/blogs/pm/12903/#comment_213740 стандартнее ;)]]> Tue, 07 Aug 2007 07:28:31 GMT Dogen http://habrahabr.ru/blogs/pm/12903/#comment_213699 http://habrahabr.ru/blogs/pm/12903/#comment_213699 Tue, 07 Aug 2007 06:35:45 GMT winzard http://habrahabr.ru/blogs/pm/12903/#comment_213628 http://habrahabr.ru/blogs/pm/12903/#comment_213628 Tue, 07 Aug 2007 04:05:33 GMT aeriman http://habrahabr.ru/blogs/pm/12903/#comment_213550 http://habrahabr.ru/blogs/pm/12903/#comment_213550 reStructuredText. Как раз эти, и некоторые другие я и сравнивал, когда подбирал для себя систему.

В частности, markdown "заточен" под html, и позволяет делать штуки типа встраивания html-тегов в исходный .txt-файл. А это автоматически означает смешивание структуры документа и его представления, и невозможность его корректно перегнать в тот же docbook.]]> Mon, 06 Aug 2007 20:58:05 GMT powerman http://habrahabr.ru/blogs/pm/12903/#comment_213542 http://habrahabr.ru/blogs/pm/12903/#comment_213542 markdown]]> Mon, 06 Aug 2007 20:43:56 GMT arty http://habrahabr.ru/blogs/pm/12903/#comment_213513 http://habrahabr.ru/blogs/pm/12903/#comment_213513
А какие у Вас требования к системе документирования?]]> Mon, 06 Aug 2007 19:59:58 GMT powerman http://habrahabr.ru/blogs/pm/12903/#comment_213499 http://habrahabr.ru/blogs/pm/12903/#comment_213499 Mon, 06 Aug 2007 19:40:14 GMT makc_de http://habrahabr.ru/blogs/pm/12903/#comment_213420 http://habrahabr.ru/blogs/pm/12903/#comment_213420 Нужно, например, чтобы в блог/ЖЖ/комменты к хабру быстро писать красивый html-код.]]> Mon, 06 Aug 2007 17:12:12 GMT Wellick http://habrahabr.ru/blogs/pm/12903/#comment_213418 http://habrahabr.ru/blogs/pm/12903/#comment_213418
А вообще никто не мешает повесить в .vimrc hook на запись .txt-файлов в указанном каталоге, который рядом с этим .txt файлом будет в один вызов команды asciidoc класть .html-файл, и вторым вызовом какой-нить утилитки копировать его содержимое в буфер обмена (кстати, а зачем это нужно?).]]> Mon, 06 Aug 2007 17:06:55 GMT powerman http://habrahabr.ru/blogs/pm/12903/#comment_213416 http://habrahabr.ru/blogs/pm/12903/#comment_213416 Мне, конечно, не надо писать docbook'и, но набор текста в html'е удручает.
WISIWYG, зачастую, удручает не меньше.]]> Mon, 06 Aug 2007 17:04:10 GMT Wellick http://habrahabr.ru/blogs/pm/12903/#comment_213415 http://habrahabr.ru/blogs/pm/12903/#comment_213415 Mon, 06 Aug 2007 17:03:31 GMT powerman http://habrahabr.ru/blogs/pm/12903/#comment_213413 http://habrahabr.ru/blogs/pm/12903/#comment_213413 один раз написать простейший скрипт для выполнения обработок текста одной кнопкой, чем постоянно набирать документацию в формате а-ля docbook.]]> Mon, 06 Aug 2007 17:02:00 GMT powerman http://habrahabr.ru/blogs/pm/12903/#comment_213411 http://habrahabr.ru/blogs/pm/12903/#comment_213411 Mon, 06 Aug 2007 17:01:01 GMT Wellick http://habrahabr.ru/blogs/pm/12903/#comment_213410 http://habrahabr.ru/blogs/pm/12903/#comment_213410 link:otherpage[]
otherpage - это якорь в тексте?
В остальном понятно, спасибо!]]> Mon, 06 Aug 2007 16:59:35 GMT Wellick http://habrahabr.ru/blogs/pm/12903/#comment_213409 http://habrahabr.ru/blogs/pm/12903/#comment_213409 Mon, 06 Aug 2007 16:59:30 GMT powerman http://habrahabr.ru/blogs/pm/12903/#comment_213408 http://habrahabr.ru/blogs/pm/12903/#comment_213408 P.S. Я знаю the power of UNIX command line =) Но лениво, ей богу.]]> Mon, 06 Aug 2007 16:56:36 GMT Wellick http://habrahabr.ru/blogs/pm/12903/#comment_213406 http://habrahabr.ru/blogs/pm/12903/#comment_213406 Mon, 06 Aug 2007 16:53:29 GMT powerman http://habrahabr.ru/blogs/pm/12903/#comment_213404 http://habrahabr.ru/blogs/pm/12903/#comment_213404

К обычным url добавляются скобки а-ля http://ya.ru[] в которых можно написать текст ссылки а-ля http://ya.ru[Яндекс]

Ссылки на "соседние" страницы/файлы этой-же доки с помощью схемы "link" а-ля link:otherpage[] или link:subdir/index.html[Описание фичи subdir]

Картинки вставляются так image::images/icons/home.png[Alt text]
Навигация до генерации html не происходит никак. Разве что вы пользуетесь достаточно умным текстовым редактором (напр. Vim) и научите его распознавать конструкцию link: для открытия новых файлов. Плагины может и есть, но у меня в них пока потребности не возникало, и я их просто не искал. А вообще это должно очень просто реализовываться, на уровне нескольких строк в .vimrc и без всяких плагинов, я думаю.

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

]]> Mon, 06 Aug 2007 16:46:41 GMT powerman http://habrahabr.ru/blogs/pm/12903/#comment_213402 http://habrahabr.ru/blogs/pm/12903/#comment_213402 Mon, 06 Aug 2007 16:44:05 GMT Wellick http://habrahabr.ru/blogs/pm/12903/#comment_213399 http://habrahabr.ru/blogs/pm/12903/#comment_213399 Как создаются ссылки между разными документами?
Как происходит навигация внутри документа, когда он еще не преобразован в html? Есть ли какие-либо плагины к Vim'у (и к другим текстовым редакторам)?

А в первом приближении всё это очень сильно напоминает один из многочисленных вики-диалектов, типа Textile.]]> Mon, 06 Aug 2007 16:26:17 GMT Wellick http://habrahabr.ru/blogs/pm/12903/#comment_213387 http://habrahabr.ru/blogs/pm/12903/#comment_213387 Mon, 06 Aug 2007 16:04:05 GMT powerman