Исправить коды \u в html-файлах (javadoc из NetBeans)

237
11 ноября 2018, 23:40

Покопавшись в интернете нашёл причину кодов \u**** в html-файлах, получающихся при создании документации html из javadoc-комментариев, записанных в исходном коде файлов *.java: Unicode in javadoc and comments?.

ПС: Попробовал через ant (из комплекта с netbeans - настроил Path в доп. параметрах Windows, "ant -version" показывает 1.9.7 от 09.04.2016) - не помогло... Цель из build.xml:

<target name="javadoc-build" description="documentation" depends="">
    <property name="app.name"    value="..." />
    <property name="app.version" value="1.0" />
    <property name="app.author"  value="Renat Khusyainov" />
    <property name="app.year"    value="2018" />
    <property name="dir.src"     value="./src" />
    <property name="dir.doc"     value="./dist/javadoc" />
    <echo message="Create doc." />
    <mkdir dir="${dir.doc}" />
    <javadoc destdir="${dir.doc}" 
             encoding="utf-8"
             docencoding="utf-8"
             charset="utf-8"
             use="true"
             private="true"
             author="${app.author}" 
             version="${app.version}" 
             windowtitle="${app.name} API"
             doctitle="${app.name}" >
        <fileset dir="${dir.src}" defaultexcludes="yes">
        </fileset>
    </javadoc>
</target>

ППС: "Убрать кириллицу из кода", которая "превращается" в юникод-символы, не вариант - считываемые данные (с которыми работает "проект") содержит кириллицу (и, соответственно, кириллица в коде помогает идентифицировать определённые участки считываемых данных). Закодировать кириллицу в коде - тоже не представляю возможным - "пострадает читабельность" кода.

Вот этот код из java-файла:

/**
 * Название параметра, по которому идентифицируется параметр {@value}.
 */
public static final String TIME_NAME = "Время сбора данных";

"превращается" вот в этот код html:

<td class="colLast"><code><span class="memberNameLink"><a href="../тут_путь__неважно.html#TIME_NAME">TIME_NAME</a></span></code>
<div class="block">Название параметра, по которому идентифицируется параметр "\u0412\u0440\u0435\u043c\u044f \u0441\u0431\u043e\u0440\u0430 \u0434\u0430\u043d\u043d\u044b\u0445".</div>
</td>

Помогите, пожалуйста.

Answer 1

В командной строке javadoc есть параметры -charset, -encoding и -docencoding. См. The Java API Documentation Generator. Всегда можно сгенерить документацию из командной строки вне зависимости от IDE. Не знаю что там не так в NetBeans, возможно зависит от кодировки ваших Java файлов, но, если вы не используете для сборки проекта maven, то попробуйте найти где-нибудь в project.properties что-нибудь вроде javadoc.encoding и исправить этот параметр.

READ ALSO
Запрос permission на отправку Push Notification

Запрос permission на отправку Push Notification

Могу ли я запрашивать permission на отправку Push Notification по аналогии с локацией или доступом к памяти?

241
Как вынуть и изменить нужную строку?

Как вынуть и изменить нужную строку?

Есть цифровые данные, например: "Яблоки: 20", "Груши: 50"Числа эти меняются

173
Популярность JAVA после замены android&#39;a Fuchsia OS [закрыт]

Популярность JAVA после замены android'a Fuchsia OS [закрыт]

Как вы считаете, сбросит ли в популярности java после окончания поддержки android и полного перехода на Fuchsia OS ( к 2022-23 г)? Отразится ли это на зарплатах...

207