club-1 / flarum-ext-sphinx-glossary
Add links to the definition of terms defined in a Sphinx documentation inventory.
Fund package maintenance!
n-peugnet
Installs: 16
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 2
Type:flarum-extension
Requires
- php: >=7.4
- ext-curl: *
- club-1/sphinx-inventory-parser: ^1.0
- flarum/core: ^1.2.0
Requires (Dev)
- flarum/phpstan: ^1.8
- flarum/testing: ^1.0.0
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-mockery: ^1.1
- phpstan/phpstan-phpunit: ^1.2
Suggests
- club-1/flarum-ext-chore-commands: Allows to reparse all the comment posts with the new formatter's configuration
README
A Flarum extension. Add links to the definition of terms defined in a Sphinx documentation inventory.
This is a quite niche extension and it is still a little bit rough around the edges but it works nicely. It could be useful if your community is gathered around a software project that defines a bunch of terms in a Sphinx documentation.
For now it does not have any GUI admin panel settings. It can only be configured through the Flarum console.
This extension is based on the intersphinx feature of Sphinx and is configured in a similar fashion. Mappings that resemble the intersphinx_mapping
configuration value can be added to the database using the sphinx:add
command. Then the sphinx:update
command fetches and parses the corresponding inventories to populate the glossary. This command is scheduled to run daily. It uses HTTP caching and PHP streams to stay low on resources.
By default only the std:term
roles are used as glossary entries. This can be changed on a per mapping basis, using the --role=ROLE
option. For example:
php flarum sphinx:add club1 https://club1.fr/docs/fr/ --role=term --role=logiciel --role=commande
Installation
Install with composer:
composer require club-1/flarum-ext-sphinx-glossary:"*"
Usage
After enabling the extension from the admin panel, the following Flarum commands are available:
sphinx:add Add a Sphinx documentation inventory to the mapping list
sphinx:list List the Sphinx inventory mappings
sphinx:objects Display info about the loaded Sphinx objects
sphinx:remove Remove a Sphinx documentation inventory from the mapping list and all its objects
sphinx:update Update Sphinx glossary entries by downloading the latest inventories
Recommendation
This extension alone does not apply the formatting changes to previously posted comments. I you want to reparse all the comments posts of the database it is recommended to install and enable the club-1/flarum-ext-chore-commands
extension and use its chore:reparse
command.
Updating
composer update club-1/flarum-ext-sphinx-glossary:"*"
php flarum migrate
php flarum cache:clear
Development
The following tools are needed for development:
Acknowledgement
This extension is based on the following libraries: