Created attachment 19613 [details] JavaScript код с онлайн-документации Proxmox Версия пакета: pve-docs-9.0.8-alt1 Документация для 9 мажорной версии криво собирается, о чём свидетельствуют ошибки и предупреждения в логах сборки: ... [00:00:04] asciidoc: WARNING: pve-network.adoc: line 162: missing section: [sect5] [00:00:04] asciidoc: WARNING: pve-network.adoc: line 223: missing section: [sect5] [00:00:05] asciidoc: WARNING: qm.adoc: line 158: missing section: [sect5] [00:00:05] asciidoc: WARNING: qm.adoc: line 197: missing section: [sect5] [00:00:05] asciidoc: WARNING: qm.adoc: line 220: missing section: [sect5] [00:00:06] asciidoc: WARNING: qm.adoc: line 1935: missing section: [sect5] [00:00:06] asciidoc: WARNING: qm.adoc: line 1941: missing section: [sect5] [00:00:06] asciidoc: WARNING: qm.adoc: line 1947: missing section: [sect5] [00:00:06] asciidoc: WARNING: qm.adoc: line 1960: missing section: [sect5] [00:00:08] asciidoc: WARNING: ha-manager.adoc: line 758: missing section: [sect5] [00:00:08] asciidoc: WARNING: ha-manager.adoc: line 826: missing section: [sect5] [00:00:08] asciidoc: WARNING: ha-manager.adoc: line 845: missing section: [sect5] [00:00:08] asciidoc: WARNING: ha-manager.adoc: line 863: missing section: [sect5] [00:00:08] asciidoc: WARNING: notifications.adoc: line 224: missing section: [sect5] [00:00:08] asciidoc: WARNING: notifications.adoc: line 239: missing section: [sect5] [00:00:08] asciidoc: WARNING: notifications.adoc: line 254: missing section: [sect5] ... [00:00:21] ./asciidoc-pve compile-chapter -o chapter-ha-manager.html ha-manager.adoc [00:00:21] asciidoc: WARNING: .asciidoc-pve-tmp1447183_ha-manager.adoc: line 4: include file not found: /etc/asciidoc/stylesheets/asciidoc.css [00:00:21] asciidoc: WARNING: .asciidoc-pve-tmp1447183_ha-manager.adoc: line 4: include file not found: /etc/asciidoc/stylesheets/toc2.css [00:00:21] asciidoc: WARNING: .asciidoc-pve-tmp1447183_ha-manager.adoc: line 4: include file not found: /etc/asciidoc/javascripts/asciidoc.js ... Той же проблеме подвержена 8 мажорная версия. А вот 7 мажорная версии у нас собирается нормально. Как следствие, на странице https://pve01:8006/pve-docs/pve-admin-guide.html пустой Table of Contents, кривое форматирование глав. Браузер жалуется на Uncaught ReferenceError: asciidoc is not defined (https://pve01:8006/pve-docs/pve-admin-guide.html:410) Шаги воспроизведения: 1) Перейти на https://<адрес сервера>:8006/pve-docs/pve-admin-guide.html Во вложении прикрепляю файл с JS кодом, которого не хватает для корректно отображения документации. Судя по всему, во время сборки он подставляется в /asciidoc/pve-html.conf: ifdef::linkcss[] <script type="text/javascript" src="{scriptsdir=.}/asciidoc.js"></script> <script type="text/javascript" src="{scriptsdir=.}/{theme}.js"></script> <script type="text/javascript"> #TODO: Escape not necessary in HTML5? # Escape as CDATA to pass validators. /*<![CDATA[*/ asciidoc.install({toc,toc2?{toclevels}}); /*]]>*/ </script> endif::linkcss[] ifndef::linkcss[] <script type="text/javascript"> # Escape as CDATA to pass validators. /*<![CDATA[*/ include1::{scriptsdir=/etc/asciidoc/javascripts}/asciidoc.js[] include1::{themedir}/{theme}.js[warnings=False] asciidoc.install({toc,toc2?{toclevels}}); /*]]>*/ </script> endif::linkcss[]
Такая проблема вызвана изменениями в asciidoc - https://github.com/asciidoc-py/asciidoc-py/commit/4d61d4bfa3ca00b01b543a13e695ed518b90ca6d Как вариант решения проблемы, можно либо пропатчить asciidoc/pve-html.conf, либо сделать в спеке теми же командами вот так: --- a/pve-docs.spec +++ b/pve-docs.spec @@ -24,6 +24,8 @@ grep 'proxmox.com' * -rl | while read f; do sed -i 's|proxmox.com|basealt.ru|' $f done sed -i 's|{python}|python3|' asciidoc/*.conf +sed -i 's!/etc/asciidoc/stylesheets!/usr/lib/python3/site-packages/asciidoc/resources/stylesheets!g' asciidoc/pve-html.conf +sed -i 's!/etc/asciidoc/javascripts!/usr/lib/python3/site-packages/asciidoc/resources/javascripts!g' asciidoc/pve-html.conf rm -f getting-help.adoc howto-improve-pve-docs.adoc pve-package-repos.adoc pve-faq.adoc pve-installation.adoc pve-system-requirements.adoc translation.adoc pve-installation-media.adoc cpu-models.conf.adoc firmware-updates.adoc %build Второй вариант тут - https://packages.altlinux.org/ru/tasks/395692/
pve-docs-9.0.8-alt2 -> sisyphus: Thu Sep 25 2025 Konstantin Kozoriz <kozorizki@altlinux> 9.0.8-alt2 - fix: correct resource paths, drop obsolete links (ALT #56110)