Bug 56110 - Кривая сборка документации
Summary: Кривая сборка документации
Status: CLOSED FIXED
Alias: None
Product: Sisyphus
Classification: Development
Component: pve-docs (show other bugs)
Version: unstable
Hardware: x86_64 Linux
: P5 normal
Assignee: kozorizki@altlinux.org
QA Contact: qa-sisyphus
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2025-09-23 13:58 MSK by Vladislav Glinkin
Modified: 2025-09-29 20:29 MSK (History)
2 users (show)

See Also:


Attachments
JavaScript код с онлайн-документации Proxmox (5.77 KB, application/x-javascript)
2025-09-23 13:58 MSK, Vladislav Glinkin
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Vladislav Glinkin 2025-09-23 13:58:10 MSK
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[]
Comment 1 Vladislav Glinkin 2025-09-24 12:06:57 MSK
Такая проблема вызвана изменениями в 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/
Comment 2 Repository Robot 2025-09-29 20:29:17 MSK
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)