Download the PHP package t3docs/fluid-documentation-generator without Composer
On this page you can find all versions of the php package t3docs/fluid-documentation-generator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download t3docs/fluid-documentation-generator
More information about t3docs/fluid-documentation-generator
Files in t3docs/fluid-documentation-generator
Package fluid-documentation-generator
Short Description Generates automatic documentation in RST format based on Fluid ViewHelper source files
License LGPL-3.0-or-later
Informations about the package fluid-documentation-generator
Fluid Documentation Generator
This package generates an automatic [Fluid]() ViewHelper reference documentation in RST format. The included CLI command is configured with json files. Based on this configuration, the following assets are generated:
- a directory structure with RST files to navigate between namespaces, groups of ViewHelper as well as the ViewHelpers themselves
- a json file which contains all relevant information about the Fluid namespace and its ViewHelpers
The result can be rendered with render-guides, which contains a special RST directive to interpret the generated JSON file.
Installation
This package needs to be installed inside a composer project that contains all ViewHelpers that should be documented.
Configuration and Usage
The documentation assets will be generated by using the following CLI command:
You can specify 1-n config files, separated by a space character. If you specify multiple files, their order is important because it will determine the order on the documentation's index page. You can use wildcards as well, see examples below.
Each configuration file must respect the provided JSON schema. A minimal configuration file could look like this:
The resulting JSON file will contain all ViewHelpers in the PHP namespace Vendor\MyPackage\ViewHelpers
.
The result will be placed in a folder called fluidDocumentationOutput
. The output folder can be changed
by providing the environment variable FLUID_DOCUMENTATION_OUTPUT_DIR
. In the example, the folder
structure will look like this:
- fluidDocumentationOutput/
- MyPackage/
- Index.rst
- MyViewHelper.rst
- ...
- Index.rst
- MyPackage.json
- MyPackage/
Examples
Generate ViewHelper reference for dev-main
of TYPO3 Core with config files:
Generate ViewHelper reference for dev-main
of Fluid Standalone with config files:
All versions of fluid-documentation-generator with dependencies
ext-json Version *
justinrainbow/json-schema Version ^5.2
typo3fluid/fluid Version ^2.12 || ^4.0 || dev-main