требование для выхода из символов &
и <
обеспечивается в разделе Символьные Данные и Разметка а не в разделе Attribute-Value Normalization, как предыдущий ответ указывает .
Для заключения в кавычки Спецификации . XML:
"Символ амперсанда (&) и открывающая угловая скобка (<) не ДОЛЖЕН казаться в их литеральной форме, кроме тех случаев, когда используемым в качестве разделителей разметки, или в рамках комментария, инструкции по обработке или раздела CDATA. Если они необходимы в другом месте, их НУЖНО оставить с помощью или ссылок цифрового символа или строк &
и <
соответственно"
maven-pdf-plugin генерирует PDF-файл документации по проекту.
Два примечания из документации, которые следует учитывать:
Примечание 1: По умолчанию плагин PDF создает документ PDF, который объединяет все документы вашего сайта. Если вы хотите сгенерировать каждый документ сайта индивидуально, вам нужно добавить
-Daggregate = false
в командную строку.Примечание 2: По умолчанию плагин PDF использует реализацию FOP. Плагин также поддерживает реализацию iText, вам просто нужно добавить
-Dimplementation = itext
в командную строку.
Фактически вы можете указать совокупное свойство в вашем POM (см. Пример ниже).
Эта конфигурация будет генерировать PDF-файл для каждой сборки, в которой активен профиль docs
(вы можете сделать это для каждой сборки,