Конвертеры латекса в HTML, которые я видел в прошлом, были довольно ужасными. Редактировать необработанный html - неинтересно и, похоже, плохо переносится на печатную страницу. Как другие решают эту проблему? Ссылки на примеры (как pdf, так и html) были бы отличными.
Добавлено: Был задан еще один похожий вопрос:
Какой язык форматирования мне следует использовать для документации по проекту
Для документирования кода я также рекомендую Sphinx. ReStructured Text удобен тем, что он удобен для чтения и в некоторой степени размечен в виде открытого текста и может хорошо выполнять преобразование в HTML и PDF. Мне по-прежнему нравится LaTeX в некоторых вещах. Мы с женой используем LaTeX, чтобы написать рождественское письмо, которое мы рассылаем обычной почтой. Версия в формате pdf довольно навороченная, с двумя столбцами, верхним и нижним колонтитулами. Версия html проще. Конвертирую пластиком. Примеры здесь: http://fedibblety.com/annualReports
Я не думаю, что какой-либо двоичный формат является хорошим выбором (Word) для любого документа, который вы, возможно, захотите прочитать через 10 лет. Это одна из приятных особенностей LaTeX.
Да, конвертеры LaTeX-to-HTML раньше были отстойным (вы, наверное, пробовали LaTeX2HTML), но в последнее время они стали лучше. Tex4ht легко настраивается и создает хороший XHTML + CSS. . См. Также другие преобразователи.
Вы также можете использовать Docbook, если можете писать в нем. Существуют конвертеры из DocBook как в HTML, так и в LaTeX (или напрямую в PDF); примером последнего является dblatex.
См. Это сообщение: LaTeX против Docbook.
После многих лет мучений и нескольких фальстартов я собираюсь вернуться к этому и дать Сфинкса попробуйте. Он может генерировать HTML или LaTeX из реструктурированного текста.
Я надеюсь, что это будет гораздо более «легкий» вариант, чем полный DocBook, но со многими преимуществами.
Вы можете сделать шаг назад и использовать что-то вроде DocBook и выполнить рендеринг в PDF через LaTeX и HTML прямо из файлов DocBook. В качестве альтернативы Adobe Technical Communication Suite (Framemaker) позволит вам использовать единый источник документа в форматах PDF и HTML. Краткое изложение см. В этом сообщении по различным системам технической документации.
PlasTeX выглядит как хороший конвертер латекса в html, хотя я сам его не пробовал.
Мой друг Роб Фелти написал в блоге сообщение, восхваляющее его достоинства: http://blog.robfelty.com/2008/03/19/finally-a-better-latex-to-html-converter/
Это личный выбор, но латекс теоретически идеален, но на практике это заноза в заднице. Я использую редактор VS.NET HTML + редактирование необработанного HTML, когда мне это нужно.
Поэтому я считаю, что лучше всего использовать HTML-редактор WSIWYG. Вы всегда можете использовать простой инструмент для преобразования его в PDF, и вы всегда можете редактировать HTML, когда вам нужно что-то продвинутое. Кроме того, когда вам нужно, его проще подключить к Интернету.
Вот как я управляю своей документацией по программному обеспечению, и мне это нравится.
Прочтите о формате EPUB. Его формат электронной книги. http://en.wikipedia.org/wiki/EPUB
Поскольку в ответе, в котором упоминается Asciidoc, немного примеров, вот некоторые из вещей, которые вы ищете за:
Не уверен, что латекс действительно лучший инструмент для этого. Проблема, с которой вы сталкиваетесь с обычным конвертером латекса в html, указывает на проблему: html просто не так выразителен, как латекс.
Если вы настаиваете на преобразовании латекса в html, постарайтесь использовать ограниченное подмножество, которое можно преобразовать в разумных пределах.
Раньше я использовал TeXinfo, и он неплохо справляется. Вот пример: http://yootles.com/api. Я бы предпочел придерживаться LaTeX, а не использовать другой язык.
Если ничего не помогает, вы можете взять конвертер LaTeX в XML и написать простую таблицу стилей XSLT, чтобы преобразовать ее в HTML, или создать таблицу стилей CSS и напрямую прикрепить ее к файлу XML.
Мы использовали WebWorks ePublisher (www.webworks.com), который предлагает как несколько форматов с одним источником (мы используем Word), так и возможность вывода во многие форматы вывода (мы выводим в Adobe PDF и в онлайн-справку (.CHM) .
Мы столкнулись с этой проблемой в академическом проекте, в котором участвовало программное обеспечение Eclipse, и мы использовали plastex для преобразования Latex в HTML и Eclipse Help. Заставить его работать было довольно сложно, но конечный результат выглядит действительно неплохо. Здесь вы можете увидеть все три версии:
Кроме того, поскольку это открытый проект, доступен код (сценарии сборки). У нас есть система непрерывной сборки (Jenkins), которая перестраивает все, когда регистрируется новый Latex. Это особенно приятно, поскольку участникам не нужно устанавливать набор инструментов в свои системы. Они просто проверяют новый латекс и проверяют на сервере, правильно ли был создан HTML. Источники:
http://sourceforge.net/p/rodin-b-sharp/svn/HEAD/tree/trunk/Handbook/org.rodinp.handbook.feature/
С уважением, Майкл
У меня недостаточно моментов, чтобы прокомментировать, но чтобы подкрепить ответ пластекса, вот обновленная ссылка на пример пластекса:
http://robfelty.com/2008/03/19/finally-a-better-latex-to-html-converter
Латекс? Шутки в сторону? Я не знал, что кто-то за пределами академических кругов все еще использует его. Я бы выбрал HTML, который вы можете сохранить в формате PDF из веб-браузера. Если вам действительно нужны какие-то продвинутые типографские вещи, используйте Word - у него есть способ сохранить в HTML (вероятно, не так чисто, как хотелось бы), и вы можете сохранить в формате PDF с помощью бесплатного плагина (загружаемого отдельно) .
О, и я бы не стал использовать такие вещи, как InDesign - их слишком много. Кроме того, не беспокойтесь об оплате Acrobat Professional - существует множество бесплатных решений.
