Skip to content

Add the main manual links as XML entities - #2

Open
lacatoire wants to merge 2 commits into
php:mainfrom
lacatoire:initial-setup
Open

Add the main manual links as XML entities#2
lacatoire wants to merge 2 commits into
php:mainfrom
lacatoire:initial-setup

Conversation

@lacatoire

@lacatoire lacatoire commented Aug 5, 2026

Copy link
Copy Markdown
Member

Rebased on main now that #1 is in, so this only carries what is still missing.

Cross-references whose target stays in the main manual, such as the PECL installation chapter or the libxml book, cannot use a linkend here: there is no such target in this manual. They go through entities resolving to php.net links, declared as XML entities under entities/.

The README gains a Creating this setup section for the build outside Docker.

#10 builds on these entities.

@lacatoire lacatoire changed the title Add initial manual structure, entities and build workflow Add the docbook-cs configuration, entity layer and lint workflow Aug 5, 2026
Cross-references whose target stays in the main manual cannot use a linkend
here, so they go through entities resolving to php.net links, declared as XML
entities under entities/.

The README gains a Creating this setup section for the build outside Docker.
@lacatoire lacatoire changed the title Add the docbook-cs configuration, entity layer and lint workflow Add the main manual links as XML entities Aug 5, 2026
@jordikroon

jordikroon commented Aug 5, 2026

Copy link
Copy Markdown
Member

This is related to the recent doc-en change. Please use that file format as well.
php/doc-en#5722

I think we would benefit from having a url.php.manual.en that points to https://www.php.net/manual/en/ so that we don't need to define that everywhere.

Cross-references whose target stays in the main manual cannot use a linkend
here, so they go through entities resolving to php.net links.

The file follows the format introduced in php/doc-en#5722, and the links are
composed from a url.php.manual.en entity rather than repeating the base URL.

The README gains a Creating this setup section for the build outside Docker.
@lacatoire

Copy link
Copy Markdown
Member Author

Done @jordikroon, the file now follows the #5722 format, and the links are composed from url.php.manual.en as suggested.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants