Як я можу уникнути @
символу в javadoc? Я намагаюся використовувати його всередині {@code}
тегу, який знаходиться всередині <pre>
тегів.
Я вже пробував html @
послідовність виходу , але це не спрацювало.
Як я можу уникнути @
символу в javadoc? Я намагаюся використовувати його всередині {@code}
тегу, який знаходиться всередині <pre>
тегів.
Я вже пробував html @
послідовність виходу , але це не спрацювало.
Відповіді:
Використовуйте {@literal}
тег javadoc:
/**
* This is an "at" symbol: {@literal @}
*/
Явадок для цього буде читати:
This is an "at" symbol: @
Звичайно, це буде працювати для будь-яких персонажів, і це "офіційно підтримуваний" спосіб відображення будь-яких "спеціальних" символів.
Це також найяскравіше - вам не потрібно знати шістнадцятковий код символу, і ви можете прочитати те, що ви ввели!
}
символу?
}
не має особливого значення в html.
literal
теги.
{
та просто використання @literal @
робіт усередині {@code}
тегу.
Просто напишіть це як сутність HTML:
@
З документа " javadoc - генератор документації Java API "
Якщо ви хочете почати рядок із символом @ і не інтерпретувати його, використовуйте сутність HTML @.
Це означає, що ви можете використовувати сутності HTML для будь-якого символу, який вам знадобиться втекти, і дійсно ви можете:
Текст повинен бути написаний у HTML із сутностями HTML та тегами HTML. Ви можете використовувати будь-яку версію HTML, яку підтримує ваш браузер. Стандартний doclet генерує код, що відповідає HTML 3.2, в іншому місці (поза коментарями до документації) з включенням каскадних таблиць стилів та кадрів. HTML 4.0 є кращим для згенерованих файлів через набори кадрів.
Наприклад, сутності для символу менше (<) і більше символу (>) повинні бути записані як
<
і>
. Аналогічно, ampersand (&) слід записати як&
.
моє рішення таке
/**
* Mapper Test Helper.
*
* add the following annotations above the class
* <pre>{@code
* // junit5
* @literal @ExtendWith(SpringExtension.class)
* // junit4
* @literal @RunWith(SpringRunner.class)
* }</pre>
*/
У вас є загальна ідея, спробуйте використовувати восьмеричне подання: @
@
має