Latex fetish, мозговой BDSM

[metaclass]

Долго выбирал, в чем делать документацию, посмотрел всякие вики, докбуки и прочее. В итоге, по совету умудренных жизнью гуру, посмотрел LaTeX. Благо, под рукой наконец-то имеется линукс, где весь этот трэш ставится apt-get, а не поиском в гугле сайтов "LaTeX for windows, free троян в нагрузку, мокрые письки, скачать бесплатно".

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

Теперь осталось себя заставить не только код писать, но еще и писать в документации, зачем, как и почему я его пишу.

Comments

[vadim-i-z.livejournal.com]

Зачем искать?
http://www.miktex.org/

[metaclass.livejournal.com]

В прошлый раз у меня с ним чо-то ничего не вышло.
Или, скорее всего, меня отвлекли какой-нибудь "срочной нужно вчера" работой и я не докопался до конца.

[freiksenet.livejournal.com]

Со всей любовью к латеху - почему не texinfo? Он ИМХО более пригоден к документации кода.

[metaclass.livejournal.com]

Не знаю, почему. Но смотреть уже не буду - у меня мозг просто лопнет, если я еще что-нибудь новое за эту неделю узнаю :)

[permea-kra.livejournal.com]

Ребе, пишите на хаскеле. Там можно код с доками на техе мешать ....

[metaclass.livejournal.com]

У меня пока схема базы данных и описание "почему именно такая схема".
Хотя мысль описать схему на хаскеле и написать несколько преттипринтеров в sql, в документацию и в исходный код у меня была :)

[x-a-e-p.livejournal.com]

Он, видимо, про literate haskell

[migmit.vox.com (from livejournal.com)]

С доками на LaTeX.

[theiced.livejournal.com]

да да ;)
и для вас висйоленькая смирительная рубашка найдётся.

[theiced.livejournal.com]

а вообще - ша набегут авторы деревня-говноинфо и будут рассказывать что всё реальные деревенские поцоны доки пишут в ворде 2020.

[metaclass.livejournal.com]

Я бы писал в ворде. Но он даже в последних своих ипостасях с системами контроля версий не совместим, а внутренние средства отслеживания изменений в нем убогие.

[aamonster.livejournal.com]

Как - не совместим? Если в SVN аж есть скрипты для человеческого показа diff'ов. (впрочем, насколько прилично это работает - не знаю, не пробовал... но и для TeX тоже не знаю - по хорошему ведь diff нужно смотреть не только для исходника)

[metaclass.livejournal.com]

Не, с вордом я не уверен в кошерности. Я думаю, что лучше разобраться с латехом, чем копаться в микрософтовской шизе, которую они еще десять раз поменяют.

[vp.livejournal.com]

По крайне мере если ворд, то текстовый формат. Хотя толку от того, что тебе покажут дифф этих вещей. Там нифига не наглядно.

[permea-kra.livejournal.com]

Тогда уж в докбуке.

[permea-kra.livejournal.com]

А, не увидел коммент ниже.

[metaclass.livejournal.com]

Докбук как-то печален. Хотя я его стили даже подгонял под то что мне нужно, но все равно - как-то неудобно.

[aamonster.livejournal.com]

Угу, это уже понятно (у самого больше доверия вызывают простые текстовые форматы).

[kosiakk.livejournal.com]

А мы пишем в Ворде 2007, со всеми его рюшечками.
Сохраняем в XML-виде (типа .docx.xml), а перед коммитом простая прога сканит все файлы и делает им code reformat (в идеале - триггер на коммит).

в итоге всё неплохо ложится в svn; есть примитивный xsl-шаблон, который делает из такого файла plain-text для ещё более простых дифов.

и скрипт на vba, который преобразует все файлы в pdf для клиентов.

так что, получается весьма кошерно.

[inhate.livejournal.com]

DocBook || Doxygen рассматривался?

[metaclass.livejournal.com]

Докбук сильно неудобнее, я его уже использовал. И как-то нормальный результат в латехе у меня быстрее получился.

[alexott.livejournal.com]

я докбук активно использовал, но надо повозиться с выгонкой в печатные варианты, особенно если пользоваться только бесплатными альтернативами
Хотя для докбука есть замечательный редактор Serna, который сейчас стал бесплатным (один из вариантов), там почти визивиг...
а для себя я давно перешел на emacs muse, и выгоняю из него и печатные варианты, и html, и даже сайт у меня из него генерится

[alexott.livejournal.com]

если несколько платформ, то лучше скачать сразу texlive и поставить его и на виндовс и на линукс. а то потом начинаются проблемы - на винде texlive 2009, в дебиане - 2007, пакеты не совпадают и т.п.

[theiced.livejournal.com]

дык не юзайте бебиан и всё у вас будет.

[alexott.livejournal.com]

убунта использует те же самые пакеты... да и в остальных дистрибутивах не всегда полный набор пакетов CTAN

[ilya-portnov.livejournal.com]

Asciidoc или аналоги?