Как генерировать javadoc с муравьем для существующего проекта?

MediaWiki может сделать то, что Вы ищете. Это использует Texvc ( http://en.wikipedia.org/wiki/Texvc ), который "проверяет ЛАТЕКСНЫЕ математические выражения (AMS) и преобразовывает их в HTML, MathML или графику PNG". Походит на то, что Вы ищете.

статья Википедии Выезда о том, как они обрабатывают математические уравнения здесь: http://en.wikipedia.org/wiki/Help:Formula . У них также есть обширная ссылка на ЛАТЕКСЕ и профессионалах/недостатках различных типов рендеринга (PNG/MathML/HTML).

MediaWiki использует подмножество разметки TeX, включая некоторые расширения от ЛАТЕКСА и ЛАТЕКСА AMS, для математических формул. Это генерирует или изображения PNG или простую разметку HTML, в зависимости от пользовательских настроек и сложности выражения. В будущем, поскольку больше браузеров более умно, это будет в состоянии генерировать улучшенный HTML или даже MathML во многих случаях. (См. blahtex для получения информации о текущей работе над добавлением поддержки MathML.)

более точно, MediaWiki пропускает разметку через Texvc, который в свою очередь передает команды TeX для фактического рендеринга. Таким образом только ограниченная часть полного языка TeX поддерживается; посмотрите ниже для деталей....

Профессионалы HTML

  • Встроенные формулы HTML всегда выравниваются правильно с остальной частью текста HTML.
  • образование формулы, размер шрифта и остальная часть соответствия поверхности содержимых HTML и появления уважают настройки браузера и CSS.
  • Страницы с помощью HTML загрузятся быстрее.

Профессионалы TeX

  • TeX семантически превосходит HTML. В TeX "x" означает "математическую переменную x", тогда как в HTML "x" мог означать что-либо. Информация была безвозвратно потеряна. Это обладает несколькими преимуществами:
    1. TeX может быть преобразован в HTML, но не наоборот. Это означает, что на стороне сервера мы можем всегда преобразовывать формулу, на основе ее сложности и местоположения в рамках текста, пользовательских настроек, типа браузера, и т.д. Поэтому, если это возможно, все преимущества HTML могут быть сохранены, вместе с преимуществами Техаса. Это верно, что текущая ситуация не идеальна, но это не серьезное основание отбросить информацию/содержание. Это - больше причина помочь улучшить ситуацию.
    2. TeX может быть преобразован в MathML для браузеров, которые поддерживают его, таким образом сохраняя его семантику и позволяя ему быть представленными как вектор.
  • TeX был специально предназначен для наборных формул, таким образом ввел, является легче и более естественным, и вывод более эстетически приятен.
  • При записи в TeX, редакторы не должны волноваться о поддержке браузера, так как это представляется в изображении сервером. Формулы HTML, с другой стороны, могут закончить тем, что были представлены непоследовательные из намерений редактора (или нисколько) некоторыми браузерами или более старыми версиями браузера.

6
задан Paŭlo Ebermann 12 August 2011 в 11:10
поделиться

1 ответ

You have a doc target defined that generates javadoc in ${doc.dir} which is set to doc.

  <!-- Generate javadocs for current project into ${doc.dir} -->
  <target name="doc" depends="init" description="generate documentation">
    <javadoc sourcepath="${source.dir}" destdir="${doc.dir}"/>
  </target>

So, to generate the javadoc just run:

$ ant doc

And you'll find it in the doc sub directory.

15
ответ дан 8 December 2019 в 14:44
поделиться
Другие вопросы по тегам:

Похожие вопросы: