Замена уценки для Javadoc, также для IDE ⇐ JAVA

Программисты JAVA общаются здесь
Anonymous
Замена уценки для Javadoc, также для IDE

Сообщение Anonymous »

Я уже нашел возможное решение, описанное по адресу https://dzone.com/articles/using-markdo ... ax-javadoc и основанное на https://github.com/Abnaxos/pegdown-doclet.
Это обеспечивает поддержку уценки в качестве замены написания уродливых HTML-тегов в Javadoc.

На странице GitHub также есть решение «подсказка, совместимая с уценкой». в качестве плагина для использования всплывающей подсказки CTRL+Q в IntelliJ, что на 50 % хорошо.

Просто приведу пример того, как сейчас выглядит Javadoc:

Код: Выделить всё

/**
* This enum gives you insight for various person characteristics.
* 
* This could be the following:
* [list]
* [*]introvert
* [*]extrovert
* [/list]
*/
public enum PersonTypes {
...
}
Итак, это нормально, если вы наводите подсказку или наводите указатель мыши на класс в IDE.
Тем не менее, это трудно читать, если вы находитесь непосредственно в соответствующий класс, вызванный HTML-тегами и другими макросами. И это всего лишь очень простой пример без каких-либо макросов, специфичных для Javadoc.

Итак, как описано на веб-сайте выше, я хотел бы заменить материал Javadoc на Markdown. синтаксис непосредственно в исходном коде. Применительно к примеру это будет выглядеть так:

Код: Выделить всё

/**
* This enum gives you insight for various person characteristics.
*
* This could be the following:
*
* - introvert
* - extrovert
*
*/
public enum PersonTypes {
...
}
При наведении курсора на перечисление PersonTypes в Eclipse синтаксис Markdown теряется, поскольку Eclipse по умолчанию интерпретирует его как Javadoc, а не как Markdown.

К сожалению, в настоящее время я не нашел решения для включения анализа всплывающей подсказки Markdown для Eclipse.
Есть ли у кого-нибудь еще решение или другие идеи?


Подробнее здесь: https://stackoverflow.com/questions/395 ... o-for-ides

Вернуться в «JAVA»