Как преобразовать разрывы строк в теги <br/> (wysiwyg) - PullRequest
0 голосов
/ 20 февраля 2009

Как я могу гарантировать, что неявные разрывы строк отражаются в выходном Javadoc, то есть разрывы строк преобразуются в теги <br/>? Я нахожу это довольно раздражающим, когда приходится не забывать добавлять теги <br/> в каждую строку моих комментариев. Без тегов <br/>, конечно, весь комментарий сгущается в нечитаемый блок.

Может быть, доклет, который просто заменит разрыв строки тегом <br/>? Я немного погуглил, но ничего не придумал. Я хотел убедиться, что ничего не пропустил, прежде чем отправиться писать свой собственный доклет.

1 Ответ

1 голос
/ 21 февраля 2009

Лучше вставить тег <p> туда, где вы хотите разрывы абзацев. Довольно уродливо ставить разрыв строки везде, где вы хотите разрыв строки - это плохо работает, когда кто-то использует окно, намного более широкое или намного уже, чем то, в котором вы разбиваете.

ПРИМЕЧАНИЕ. Если у вас есть предварительно отформатированный текст, который вы хотите включить в JavaDoc, то вы можете использовать тег <pre> вокруг этого содержимого, и ваш текст не будет переформатирован в один большой двоичный объект. На самом деле, если вы хотите явно решить, где будет проходить каждый разрыв строки, вы можете использовать тег <pre> вокруг всего JavaDoc, хотя это злоупотребление намерением этого тега.

...