dokuwiki-plugin-childrenpages/README.md
Antoine Le Gonidec 77a903816c
Update metadata to target the new git repository
Since tarballs are not provided by this new repository, only installation instructions using git are kept.
2024-04-24 20:06:28 +02:00

51 lines
1.4 KiB
Markdown

# DokuWiki plugin: Children pages
For each page, this plugin adds children pages in pre-set namespaces, reachable
through links in the page menu.
[![thumbnail]][screenshot]
[thumbnail]: https://git.vv221.fr/dokuwiki-childrenpages/plain/img/thumbnail.png
[screenshot]: https://git.vv221.fr/dokuwiki-childrenpages/plain/img/screenshot.png
## Installation
### Requirements
* `git`
### Current stable version (1.2.1)
Assuming the root directory of your DokuWiki installation is `/srv/dokuwiki`:
```
DOKUWIKI_PATH=/srv/dokuwiki
REPO_URL=https://git.vv221.fr/dokuwiki-childrenpages
git clone --branch 1.2.1 --depth 1 "$REPO_URL" "$DOKUWIKI_PATH/lib/plugins/childrenpages"
```
### Latest development version
Assuming the root directory of your DokuWiki installation is `/srv/dokuwiki`:
```
DOKUWIKI_PATH=/srv/dokuwiki
REPO_URL=https://git.vv221.fr/dokuwiki-childrenpages
git clone --branch master --depth 1 "$REPO_URL" "$DOKUWIKI_PATH/lib/plugins/childrenpages"
```
## Configuration
### Namespaces list
The links to children pages are generated from a list of reserved top level
namespaces. Normal pages should not be created in these namespaces.
This list can be modified in DokuWiki config manager, and defaults to:
```
animation, gameplay, dev, talk
```
## Informations for developers
Up-to-date informations for developers can be found [on the project wiki].
[on the project wiki]: https://forge.dotslashplay.it/vv221/dokuwiki-childrenpages/-/wikis/home