[Emc-commit] [LinuxCNC/linuxcnc] c774b7: docs(build): render English from build/adoc/en, ke...

[BsAtHome <no...@gi...>]

  Branch: refs/heads/master
  Home:   https://github.com/LinuxCNC/linuxcnc
  Commit: c774b793f96eeed9353e5a5c2de8624acc0869b7
      https://github.com/LinuxCNC/linuxcnc/commit/c774b793f96eeed9353e5a5c2de8624acc0869b7
  Author: Luca Toniolo <107...@us...>
  Date:   2026-06-07 (Sun, 07 Jun 2026)

  Changed paths:
    M docs/.gitignore
    M docs/po4a.cfg
    M docs/src/Submakefile
    M docs/src/gen_complist.py

  Log Message:
  -----------
  docs(build): render English from build/adoc/en, keep docs/src clean

Per review (BsAtHome): generated files should not live in the source tree.
The English docs now render from build/adoc/en, the same model the
translations already use, instead of from docs/src.

- Stage the English .adoc + images + code fixtures (e.g. panelui_handler.py)
  into build/adoc/en via a find|tar copy (no rsync dependency).
- Generate components_gen.adoc straight into build/adoc/en/hal and point its
  po4a master there (po4a.cfg only; msgids unchanged, so no pot/po churn).
- Repoint the English HTML and PDF rules, the html-copy step, and the
  dependency extractor at build/adoc/en.

docs/src no longer accumulates components_gen.adoc or per-topic .html;
docs/.gitignore drops those entries.  The .dot-rendered SVGs are still
generated in src/code and staged across (a follow-on moves their generation
into build too).

Validated with a full English htmldocs build (585 pages, no include errors).
PDF and translated builds still to be verified.


  Commit: fc2ab34ec04f3a1995bd9be9528d983898967926
      https://github.com/LinuxCNC/linuxcnc/commit/fc2ab34ec04f3a1995bd9be9528d983898967926
  Author: Luca Toniolo <107...@us...>
  Date:   2026-06-07 (Sun, 07 Jun 2026)

  Changed paths:
    M docs/.gitignore
    M docs/src/Submakefile

  Log Message:
  -----------
  docs(build): render .dot SVGs into build/, drop them from src

The .dot diagrams under docs/src/code/ rendered their SVGs beside the
sources; route them into build/adoc/en/<topic> instead, so docs/src holds
no generated artifacts. The translated image-copy steps source images from
src, so fall back to the English build tree for the generated SVGs. Drops
the six src/code/*.svg entries from docs/.gitignore.


  Commit: 58c57257300b22f7657a4ee796c7c4b4562f3706
      https://github.com/LinuxCNC/linuxcnc/commit/58c57257300b22f7657a4ee796c7c4b4562f3706
  Author: BsAtHome <be...@va...>
  Date:   2026-06-07 (Sun, 07 Jun 2026)

  Changed paths:
    M docs/.gitignore
    M docs/po4a.cfg
    M docs/src/Submakefile
    M docs/src/gen_complist.py

  Log Message:
  -----------
  Merge pull request #4110 from grandixximo/docs/render-en-from-build

docs(build): render English and .dot SVGs into build/, keep docs/src clean


Compare: https://github.com/LinuxCNC/linuxcnc/compare/ae8b38d75be5...58c57257300b

To unsubscribe from these emails, change your notification settings at https://github.com/LinuxCNC/linuxcnc/settings/notifications