metaclass: (Default)
metaclass ([personal profile] metaclass) wrote2009-12-18 10:32 pm

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

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

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

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

[identity profile] kosiakk.livejournal.com 2009-12-20 04:31 pm (UTC)(link)
А мы пишем в Ворде 2007, со всеми его рюшечками.
Сохраняем в XML-виде (типа .docx.xml), а перед коммитом простая прога сканит все файлы и делает им code reformat (в идеале - триггер на коммит).

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

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

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