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

[metaclass]

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

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

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

Comments

[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 для клиентов.

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