From b1e38ca0a82150ee5942bdcd8561524b83944a49 Mon Sep 17 00:00:00 2001 From: Luca Toniolo <10792599+grandixximo@users.noreply.github.com> Date: Wed, 5 Aug 2026 10:41:03 +0800 Subject: [PATCH] docs: add explicit anchors for sections referenced by auto ids These five sections are linked to via their auto-generated ids (_normal_download, _alternate_install_methods, _latency_tuning, _ini_settings, _commands). Translations change the section titles, which changes the generated id and breaks every such link in the translated HTML (flagged by the CI checklink run for de, es, ru, uk and nb). Pinning the id with an explicit anchor makes the targets translation-proof. English output is unchanged since the explicit id matches the auto-generated one. --- docs/src/getting-started/getting-linuxcnc.adoc | 2 ++ docs/src/gui/qtvcp.adoc | 1 + docs/src/install/latency-test.adoc | 1 + docs/src/man/man1/halcmd.1.adoc | 1 + 4 files changed, 5 insertions(+) diff --git a/docs/src/getting-started/getting-linuxcnc.adoc b/docs/src/getting-started/getting-linuxcnc.adoc index 365fd84d728..7157715b2a6 100644 --- a/docs/src/getting-started/getting-linuxcnc.adoc +++ b/docs/src/getting-started/getting-linuxcnc.adoc @@ -35,6 +35,7 @@ The outline of the process looks like this: This section describes some methods for downloading the Live/Install image. +[[_normal_download]] === Normal Download Software for LinuxCNC to download is presented on the project's @@ -242,6 +243,7 @@ In rare cases you might have to reset the BIOS to default settings if during the Live CD install it cannot recognize the hard drive during the boot up. +[[_alternate_install_methods]] == Alternate Install Methods The easiest, preferred way to install LinuxCNC is to use the Live/Install Image as described above. diff --git a/docs/src/gui/qtvcp.adoc b/docs/src/gui/qtvcp.adoc index 62c3f3c1031..b1ce272a0f2 100644 --- a/docs/src/gui/qtvcp.adoc +++ b/docs/src/gui/qtvcp.adoc @@ -77,6 +77,7 @@ You are free to mix them in any way on your panel. A very important widget for CNC control is the *`ScreenOptions` widget*: It does not add anything visually to the screen but, allows important details to be selected rather then be coded in the handler file. +[[_ini_settings]] === INI Settings If you are using QtVCP to make a CNC motion control screen (rather then a HAL based panel), in the INI file, in the `[DISPLAY]` section, add a line with the following pattern: diff --git a/docs/src/install/latency-test.adoc b/docs/src/install/latency-test.adoc index b0fb40ad6c3..1097b21cf4a 100644 --- a/docs/src/install/latency-test.adoc +++ b/docs/src/install/latency-test.adoc @@ -227,6 +227,7 @@ isolcpus:: for latency>>. +[[_latency_tuning]] == Latency tuning LinuxCNC can run on many different hardware platforms and with many diff --git a/docs/src/man/man1/halcmd.1.adoc b/docs/src/man/man1/halcmd.1.adoc index 0787ec7cb1a..15380130302 100644 --- a/docs/src/man/man1/halcmd.1.adoc +++ b/docs/src/man/man1/halcmd.1.adoc @@ -58,6 +58,7 @@ and press tab to complete the names of items such as pins and signals. display a help screen and exit, displays extended help on _command_ if specified +[[_commands]] == COMMANDS Commands tell *halcmd* what to do. Normally *halcmd* reads a single