В чём писать документацию?

LaTeX

PS: правда я сам так и не осилил

А формат какой?

+100500 за латех.

А осилить его очень легко: за пару недель он на начальном уровне осиливается при помощи Львовского. Еще где-то за полгода осиливается уже по-человечески при помощи Кнута.

По-умолчанию — dvi, но если будешь компилировать pdflatex'ом, получишь pdf.

Можешь для ознакомления у меня в ЖЖшке, например, посмотреть.

за пару недель он на начальном уровне осиливается

НАХЕР!!! :D

Хтмл?

Спасибо за наводку. Книжку скачал.
Поставлю плагин для vim'а и буду параллельно изучать и то, и другое :)

Ну ты и кадр!

Сначала спрашиваешь, в чем нормальные люди документацию пишут, а потом еще и материшься!

Не хочешь — сиди в своем идиотском LO. Трать время на войну с ним.

А есть какой-нибудь хороший текстовый редактор с экспортом в html? Чтоб всё визуально было. LibreOffice Writer и в html жопно экспортирует - строки прыгают.

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

любой редактор (например, vim) + браузер.
наверстал, сохранил, в браузере нажал f5

Нафига вообще PDF? Делай html или odt.

Ну, если ты не собираешься в дальнейшем заниматься документацией, можешь LyX потыкать — это кривой WYSIWYM-редактор для латеха. Уровень вхождения практически нулевой, зато результат — почти как при подготовке исходников вручную.

А зачем? Тебе и пары тегов из html2 хватит, имхо, проще руками.

Вообще, есть какой-то няшный генератор доков который генерит хтмл, доки Qt вроде им сделаны, попробуй погуглить.

Нет, «наверстал» - вот это мне не нужно. Я с html не знаком.

за пару недель он на начальном уровне осиливается при помощи Львовского. Еще где-то за полгода осиливается уже по-человечески при помощи Кнута.

Ага. А работать кто будет эти полгода? А кушать / за квартиру платить? А самое главное КТО потом читать будет эту документацию, если стандарт де факто это .doс или .pdf если надо распечатать.

Это не умею, то учить не буду...а хочешь, чтобы было красиво и все как у людей...
так не бывает :)

LaTeX

Заготовку можно набить в org-mode, кстати

Ага. А работать кто будет эти полгода? А кушать / за квартиру платить? А самое главное КТО потом читать будет эту документацию, если стандарт де факто это .doс или .pdf если надо распечатать.

Так можно в .pdf сохранить, кто мешает-то?

Ну тогда визивиг. Он-лайн редакторов особенно полно, мне например нравится Редактор от Имперави. Гугл подсказывает что и десктопные есть.

Это можно попробовать. Правда, тут по зависимостям 90 пакетов весом в 300 метров вытягивается, но я подожду :)

Японский городовой!

Если ты ничего не знаешь и не умеешь, о какой документации может идти речь?

Естественно: там texlive в зависимостях. А к нему еще неплохо мегабайт 200 пакетов установить. Но для начального уровня это не нужно.

Ага. А работать кто будет эти полгода?

для документации более чем хватит начального уровня, который осиливается за пару недель _в_процессе_ написания этой документации. Проверено

А самое главное КТО потом читать будет эту документацию, если стандарт де

факто это .doс или .pdf

все. Берётся latex и экспортируется одной командой (или шорткатом) в pdf. Какие проблемы?

А работать кто будет эти полгода?

Ничего, что это делается обычно в туалете/на диване дома?

стандарт де факто это .doс

Это в ублюдочных организациях .doc — стандарт. У нормальных людей документация в pdf.

Не знать html != не знать ничего.

emacs + org-mode. Умеет экспортировать в latex, html, pdf и ещё кучу форматов.

Ага. А работать кто будет эти полгода?

Если не требуется никаких изысков, то на освоение latex хватит и дня. А дальше по мере возникновения вопросов посматривать в книгу.

осиливается за пару недель в процессе написания

Вот именно! Читаем по вечерам книжечку + держим документацию открытой. Чуть что непонятно — подглядываем. У меня теща вообще хреновато латех знает, но уже лет 10 (а то и больше) в нем набивает статьи для шефа.

Если их возможностей хватит, то, имхо, можно обойтись rest / markdown / whatever.

Читаем по вечерам книжечку + держим документацию открытой.

тю, я даже почти не читал специально(может только если самое начало). Набиваю документ, какие-то проблемы возникли в процессе - в поиск.

Решил как все белые люди писать в LibreOffice…

Гамадрилы масть поменяли, белой шерстью покрылись? В LO (OOo, MSO) такие вещи не делают, не приспособлены они для этого совершенно. Не хочешь осваивать LaTeX, изучай DocBook, он попроще будет, опять-же: контроль версий, преобразование в manpages (это первостепенная задача как я понимаю?), pdf, html, epub, webhelp.

emacs + org-mode

Час от часу смешнее.

Да блин, что там знать? Тебе часа хватит чтоб понять всё если не клинический идиот.

А для доков хватит <h3>, <p>, <pre>, какого-нибудь <i> и всё. Посолить CSS по вкусу.

Час от часу смешнее.

а над чем смеёмся? Мне тоже интересно

Мм, чоловик жалуется на плохое качество шрифтов в экспортированном пдф Чем ему в этом поможет резинка ?

Час от часу смешнее.

А откуда такое нежелание (или боязнь) изучать что-то новое? Какие-то проблемы с когнитивными способностями?
Ты же сам пишешь, что нужно написать документацию и нужно это сделать красиво. Так скачай книгу, почитай, попробуй. Вот и все.

Если же тебе чисто для твоих нужд, то открыл любой редактор и сплошным текстом пишешь.

Над тем, как человеку, возжелавшему перевести и оформить каких-то жалких 50 страниц документации, предлагают для этого убить пару недель на ЛаТеХ или окровавить свои глаза на освоении Имакса.

убить пару недель на ЛаТеХ

пара недель - это на относительно крупную работу, с кучей формул, графиков, и при этом далеко не полный день.

окровавить свои глаза на освоении Имакса.

а что такого кровавого для глаз в емаксе? Gtk (в меню и диалогах) - и в африке gtk, шрифты сглаженные умеет, что ещё от редактора нужно?

Там не в плохих шрифтах дело, а в том, что все эти LO не предназначены для печатной подготовки. Они — простое подспорье, помогающее сделать быстро какую-нибудь фигню класса служебки/заявления/тупого текста.

Внесу свои пять копеек.

Подход «не умею верстать ни в чём, но хочу красивую документацию, ЛОо не устраивает» - заранее ущербен. Хотя можно попробовать какой-нибудь abiword, но я не уверен за PDF в нём.

Тем не менее, тут правильно сказали: что для HTML, что для LaTeX - сначала пишешь текст, а уже потом начинаешь выделять абзацы, заголовки и прочее. Махом всё изучается в процессе написания документации. Вообще я в любом редакторе сначала набираю текст, а уже потом делаю форматирование (так, наверное, делают многие, кому приходится писать документацию), поэтому я не понимаю, что такого страшного в вёрстке (особенно с учётом того, что осваивают её без проблем даже школьники).

Автор толст. Язабан.

А, ну да. По теме.

man/nroff

Вообще я в любом редакторе сначала набираю текст, а уже потом делаю форматирование (так, наверное, делают многие, кому приходится писать документацию)

Нет, в латехе все делаешь сразу. Это несложно.

Видимо у него своё понятие начального уровня. Начальный уровень в лёгкую за вечер можно осилить, а потом по мере надобности гуглить или сразу на http://tex.stackexchange.com/. А потом по мере времени можно повышать уровень.

Жёстковато будет. Одно временно осиливать две вещи, которые далеко не каждый по отдельности в состояние осилить.

LyX не подходит. Он либо не умеет внедрять нужный щрифт, либо не осиливает экспорт в dvi/pdf

у меня гуглдокс отлично в pdf экспортит.

Ещё посоветовал бы вот такую вещь распечатать. http://stdout.org/~winston/latex/

Может быть. Я предпочитаю разделять эти процессы. Мне удобнее не отвлекаться на вёрстку в процессе написания - так легче мысль течёт. Впрочем, это вопрос арбуза и свиного хрящика.