Извините за возможный вопрос типа FAQ, но я просто не могу найти ответ.
Насколько я помню, Eclipse, пустая строка в комментарии Javadoc отображается (во всплывающих окнах Javadoc в исходном коде) как разрыв строки (с дополнительным вертикальным интервалом).
Однако в Netbeans это не так.
Могу ли я настроить Javadoc на интерпретацию пустой строки как разрыва строки?
Дополнительный вопрос: могу ли я переопределить поведение Netbeans по умолчанию (связанное с этим) для всплывающих окон Javadoc в исходном коде?
Я говорю о следующем:
Источник
/**
* Paragraph One
*
* Paragraph Two
*/
void someMethod() { }
Интерпретация затмения
Paragraph One
Paragraph Two
Интерпретация Netbeans
Paragraph One Paragraph Two
Ответы:
Это не имеет ничего общего с Netbeans. Я подозреваю, что в одном случае вы смотрите на исходный код, а в другом - на вывод Javadoc. Новые строки не имеют значения в HTML: поэтому вывод не будет их отображать. Если вам нужна новая строка, используйте a
<p>
или<br>
.источник
Я не уверен, помогает ли это в случае OP, однако я выложил
<pre></pre>
свой документ, чтобы netbean не испортил мое форматирование. Так это будет выглядеть/** * <pre> * Paragraph One * * Paragraph Two * </pre> */
Это ближе всего к отображению новых строк в текстовом формате. Я использую NetBeans 7.1.2. Таким образом, использование
code format
option не приведет к переформатированию документа. Отображение документа в подсказках все еще отформатировано.Обновление: в Netbeans 8.x есть опция форматирования кода для отключения форматирования комментариев.
источник
Уже есть опция
NetBeans
- проверенная в версии 8.2 - которая позволяет вам сохранять новые строки в ваших комментариях и / или добавлять<p>
теги к вашим,Javadoc
если необходимоTools
меню выберитеOptions
Editor
вкладку, затем наFormatting
вкладкуLanguage
меню выберитеJava
, а вCategory
меню выберитеComments
Preserve New Lines
флажок вGeneral
разделе, если вы хотите сохранить новые строки в комментариях. Это сохранит новые строки без добавления<p>
тегаGenerate "<p>" on Blank Lines
флажок вJavadoc
разделе, если вы также хотите добавить<p>
тег .источник
<p>
есть вручную, иногда<p>``<p>
с первого раза можно добавить вдвое . После этого все работает как положено.Я согласен с вами, HTML не входит в исходный код. К сожалению, я не нашел особой помощи в этом поиске в Google. На самом деле это довольно просто реализовать.
Вот настраиваемый доклет, который вы можете скомпилировать и использовать:
import com.sun.javadoc.*; import com.sun.tools.doclets.standard.*; /** * Formats text-only comments with HTML. */ @SuppressWarnings("restriction") public final class TextDoclet { private static final Pattern NEWLINE_REGEX = Pattern.compile("\\n"); private static final String BR = "<br/>\n"; public static boolean start(RootDoc rootDoc) { for ( ClassDoc classdoc : rootDoc.classes()) classdoc.setRawCommentText(formatText(classdoc.getRawCommentText())); return Standard.start(rootDoc); } private static String formatText(String text) { return NEWLINE_REGEX.matcher(text).replaceAll(BR); } }
Пример того, как вызвать его с помощью javadoc:
javadoc -docletpath ~/project/text-doclet/target/text-doclet-1.0.0-SNAPSHOT.jar -doclet com.myorg.textdoclet.TextDoclet -sourcepath ~/project/myapp/src/main/java -subpackages com.myorg.myapp
источник
JavaDoc отображает способ определения стилей CSS. Для этого вы можете отредактировать стили CSS, связанные с тегами абзацев:
источник
Это псевдорешение
(которое, к сожалению, влияет только на сгенерированный javadoc, но не влияет на отображение javadoc в исходном коде Netbeans).
Укажите таблицу стилей, содержащую следующее:
источник
Я понятия не имею , что делает здесь затмение, но если вы хотите это поведение в целом (не только IDE), возможно , придется создать новый Doclet (который может быть основан на по умолчанию HTML доклета) вместо этого, там вставляя
<p>
в каждая пустая строка или что-то в этом роде.источник