Skip to content

Add the main manual links as XML entities #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 2 commits into
base: main
Choose a base branch
from
+50 −0
Open

Add the main manual links as XML entities #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c54fab8
Add the main manual links as XML entities, document the local build
Aug 5, 2026
62747ac
Add the main manual links as XML entities, document the local build
Aug 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,22 @@ were not carried over from the main manual.
For general guidance on the documentation format, refer to the
[contribution guidelines](https://doc.php.net/guide/contributing.md).

## Creating this setup

This manual builds on its own, independently of the main manual. The checkout has
to be named `extensions`, as that is the directory `configure.php` is pointed at:

```bash
git clone https://github.com/php/doc-extensions extensions
git clone https://github.com/php/doc-base
php doc-base/configure.php --disable-libxml-check --with-base-lang=extensions
```

For general information related to creating this setup, see the
[contribution guidelines](https://github.com/php/doc-base/blob/master/docs/contributing.md)
or [this page](https://doc.php.net/tutorial/local-setup.php) on the documentation
website.

## Building With make and Docker

- Install Docker (https://docs.docker.com/get-docker/)
Expand Down
34 changes: 34 additions & 0 deletions entities/entities.url.ent
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
<?xml version="1.0" encoding="utf-8"?>
<?do-not-translate?>
<!--

URLs, other addresses and external references.

Cross-references whose target lives in the main manual go through the link
entities below, as a linkend has no target in this manual.

-->
<entities xmlns = "http://docbook.org/ns/docbook"
xmlns:xlink = "http://www.w3.org/1999/xlink"
translate = "yes">

<entity name="url.php.manual.en">https://www.php.net/manual/en/</entity>

<entity name="link.book.libxml"><link
xlink:href="&url.php.manual.en;book.libxml.php">libxml</link></entity>

<entity name="link.install.pecl"><link
xlink:href="&url.php.manual.en;install.pecl.php">Installation of PECL
extensions</link></entity>

<entity name="link.install.windows.building"><link
xlink:href="&url.php.manual.en;install.windows.building.php">building
on Windows</link></entity>

<entity name="link.ref.mcrypt"><link
xlink:href="&url.php.manual.en;ref.mcrypt.php">mcrypt</link></entity>

<entity name="link.ref.mhash"><link
xlink:href="&url.php.manual.en;ref.mhash.php">mhash</link></entity>

</entities>