Озаботился тут подготовкой документации. Пишу для себя - чтобы не забыть, но хочу чтобы красиво и эстетично было.
Смотрел Latex - для меня слишком хардкорно и PDF он генерирует слишком скучно, по академически. Кучу научных статей видел в PDF, деланных такой штукой.
Писал на Sphinx - но мне бы хотелось еще чтобы была возможность генерировать PDF (опционально). Стал рыть на эту тему, PDF там делается через Latex, и как-то сложно все. И потом, rst формат как-то не особо по душе.
Делал записки на коленке в markdown. Вот он кулл.
http://www.mkdocs.org/ - сайт генератор, в котором все пишется на markdown.
Короче. Изначально, я хочу чтобы все было в html - красиво, но чтобы была опция загенерироваться в PDF одним файлом - книжкой.
Поделитесь опытом, в чем вы пишите. Может, Sphinx крут, просто я его неправильно раскуриваю?
P.S. Да, с wiki я тоже развлекался.
