Lix build is broken with mdbook 0.5.* #1051

Closed
opened 2025-11-26 12:45:28 +00:00 by nikstur · 2 comments

Describe the bug

After updating mdbook to 0.5.1 the Lix build fails with:

lix>  INFO Book building has started
lix> python3: can't open file '/build/source/doc/manual/doc/manual/substitute.py': [Errno 2] No such file or directory
lix> jq: Could not open doc/manual/anchors.jq: No such file or directory
lix>  WARN Error writing the RenderContext to the backend, Broken pipe (os error 32)
lix> ERROR The "anchors" preprocessor exited unsuccessfully with exit status: 2 status

because substitute.py relies on an interface of mdbook that has been changed.

Most notably, sections is now called items.

See the changelog for more details: https://github.com/rust-lang/mdBook/blob/master/CHANGELOG.md#changed-3

See the Nix issue: https://github.com/NixOS/nix/issues/14628

## Describe the bug After updating mdbook to 0.5.1 the Lix build fails with: ``` lix> INFO Book building has started lix> python3: can't open file '/build/source/doc/manual/doc/manual/substitute.py': [Errno 2] No such file or directory lix> jq: Could not open doc/manual/anchors.jq: No such file or directory lix> WARN Error writing the RenderContext to the backend, Broken pipe (os error 32) lix> ERROR The "anchors" preprocessor exited unsuccessfully with exit status: 2 status ``` because `substitute.py` relies on an interface of mdbook that has been changed. Most notably, `sections` is now called `items`. See the changelog for more details: https://github.com/rust-lang/mdBook/blob/master/CHANGELOG.md#changed-3 See the Nix issue: https://github.com/NixOS/nix/issues/14628
helle self-assigned this 2025-11-26 13:05:09 +00:00
Member

I will see if I can quickly fix this, I have poked around this area extensively, though without any permanent fixes

I will see if I can quickly fix this, I have poked around this area extensively, though without any permanent fixes
Member

This issue was mentioned on Gerrit on the following CLs:

  • commit message in cl/4653 ("docs build system: Fixed manual to be compatible with mdbook 0.5.x")
<!-- GERRIT_LINKBOT: {"cls": [{"backlink": "https://gerrit.lix.systems/c/lix/+/4653", "number": 4653, "kind": "commit message"}], "cl_meta": {"4653": {"change_title": "docs build system: Fixed manual to be compatible with mdbook 0.5.x"}}} --> This issue was mentioned on Gerrit on the following CLs: * commit message in [cl/4653](https://gerrit.lix.systems/c/lix/+/4653) ("docs build system: Fixed manual to be compatible with mdbook 0.5.x")
Sign in to join this conversation.
No milestone
No project
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
lix-project/lix#1051
No description provided.