Why doc-it is not online?

[DavidePastore]

I saw @jordikroon said in another issue:

The documentation is rebuilt every 2 hours. However as for the Italian translation, it's currently broken because it's not fully up-to-date combined with a migration to a new server. Once the translation passes the build, it should re-appear.

But it's not clear to me why doc-it is not online. Could you please tell me? Thanks!

[jordikroon]

Hi @DavidePastore

Thank you for once and again reporting this.

doc-it is offline because the Italian translation currently fails XML validation during the server build, so no output gets published. This is what the build stops on right now (from a CI run in #328):

Run php doc-base/configure.php --disable-libxml-check --enable-xml-details --redirect-stderr-to-stdout --with-jing=no --with-lang=it
configure.php on PHP 8.3.6, libxml 2.9.14

Checking for source directory... /home/runner/work/doc-base/doc-base/doc-base
Checking for output filename... /home/runner/work/doc-base/doc-base/doc-base/.manual.xml
Checking whether to include CHM... no
Checking for PHP executable... /usr/bin/php8.3
Checking for language to build... it
Checking whether the language is supported... yes
Checking for partial build... no
Checking whether to enable detailed XML error messages... yes

doc-base: ab6b7401a113899a73e22741c2e002f2221aae8f
en:       462dddda87baa86fd760dcb1e3a0d2096e00a59b
it:       ec2787e087db5278a64f80914a0fbad3ab23f1d5

Running file-entities.php... done: 12414 entities.
Running text-entities.php... (skiped it/entities) done: 139 entities, 135 untranslated, 1 errors.
(Run 'php /home/runner/work/doc-base/doc-base/doc-base/scripts/text-entities.php en it --debug' for details.)
Checking for if we should generate a simplified file... no
Creating monolithic temp/manual.xml...  done.
Expanding XIncludes... done: 1846 tags replaced.

Failed XIncludes, manual parts will be missing. Unresolved xpointers:
- bcmath-number.round..parameters.mode
Dumped file: temp/manual.err. Inspect residual xi:include tags in this file.

Validating temp/manual.xml (libxml)... failed.

[error manual.xml 1319020:0] IDREF attribute linkend references an unknown ID "ini.fatal-error-backtraces"
[error manual.xml 31189:0] IDREF attribute linkend references an unknown ID "language.types.void.casting"
[error manual.xml 31299:0] IDREF attribute linkend references an unknown ID "language.types.void.casting"

Eyh man. No worries. Happ shittens. Try again after fixing the errors above.

We have recently lowered validation, but this change was only done when using Jing. The production server doesn't have this, therefore it failed silently with a succeeding CI pipeline. We are planning to lower validation for libxml as well.

So doc-it should reappear once either the follow-up fix lands or the by updating the files above. The latter would bring it back online right away, independent of our fix. Sorry for silent break, and we will do our best to get a fix soon.