PHPackages                             t3docs/fluid-documentation-generator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. t3docs/fluid-documentation-generator

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

t3docs/fluid-documentation-generator
====================================

Generates automatic documentation in RST format based on Fluid ViewHelper source files

4.4.3(3mo ago)115.7k↑128.9%24LGPL-3.0-or-laterPHPPHP ^8.2CI passing

Since Jul 24Pushed 1mo ago9 watchersCompare

[ Source](https://github.com/TYPO3-Documentation/fluid-documentation-generator)[ Packagist](https://packagist.org/packages/t3docs/fluid-documentation-generator)[ RSS](/packages/t3docs-fluid-documentation-generator/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (10)Dependencies (18)Versions (14)Used By (4)

Fluid Documentation Generator
=============================

[](#fluid-documentation-generator)

This package generates an automatic Fluid ViewHelper reference documentation in [RST format](https://en.wikipedia.org/wiki/ReStructuredText). 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](https://github.com/TYPO3-Documentation/render-guides), which contains a special RST directive to interpret the generated JSON file.

Installation
------------

[](#installation)

This package needs to be installed **inside** a composer project that contains all ViewHelpers that should be documented.

```
composer req --dev t3docs/fluid-documentation-generator
```

Configuration and Usage
-----------------------

[](#configuration-and-usage)

The documentation assets will be generated by using the following CLI command:

```
vendor/bin/fluidDocumentation generate viewhelpers1_config.json viewhelpers2_config.json ...
```

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](./src/Config.schema.json). A minimal configuration file could look like this:

```
{
    "name": "MyPackage",
    "namespaceAlias": "my",
    "targetNamespace": "http://typo3.org/ns/Vendor/MyPackage/ViewHelpers"
}
```

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

Examples
--------

[](#examples)

Generate ViewHelper reference for `dev-main` of [TYPO3 Core](https://github.com/typo3/typo3) with [config files](./config/typo3/):

```
git clone git@github.com:TYPO3/typo3.git
composer install
composer require --dev t3docs/fluid-documentation-generator
composer exec fluidDocumentation generate vendor/t3docs/fluid-documentation-generator/config/typo3/*
```

Generate ViewHelper reference for `dev-main` of [Fluid Standalone](https://github.com/TYPO3/Fluid) with [config files](./config/fluidStandalone/):

```
git clone git@github.com:TYPO3/Fluid.git
composer install
composer require --dev t3docs/fluid-documentation-generator
composer exec fluidDocumentation generate vendor/t3docs/fluid-documentation-generator/config/fluidStandalone/viewhelpers_fluid.json
```

###  Health Score

59

—

FairBetter than 98% of packages

Maintenance86

Actively maintained with recent releases

Popularity29

Limited adoption so far

Community30

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 52.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~234 days

Recently: every ~144 days

Total

13

Last Release

92d ago

Major Versions

1.0.0 → 3.0.02024-05-09

3.0.x-dev → 4.0.02024-07-03

PHP version history (2 changes)1.0.0PHP ^7.1

3.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/ca4eee1e54bccd482945cd03a170a3dfa0c4672c32d0a565dc1228a905a06c27?d=identicon)[s2b](/maintainers/s2b)

![](https://www.gravatar.com/avatar/81befeeadfe6fa202167d64ce1e66410b8cab345edbb652376946e16ccb6a9af?d=identicon)[linawolf](/maintainers/linawolf)

---

Top Contributors

[![s2b](https://avatars.githubusercontent.com/u/458524?v=4)](https://github.com/s2b "s2b (66 commits)")[![linawolf](https://avatars.githubusercontent.com/u/48202465?v=4)](https://github.com/linawolf "linawolf (29 commits)")[![alexander-nitsche](https://avatars.githubusercontent.com/u/20297232?v=4)](https://github.com/alexander-nitsche "alexander-nitsche (10 commits)")[![lolli42](https://avatars.githubusercontent.com/u/2178068?v=4)](https://github.com/lolli42 "lolli42 (4 commits)")[![DanielSiepmann](https://avatars.githubusercontent.com/u/354250?v=4)](https://github.com/DanielSiepmann "DanielSiepmann (4 commits)")[![NamelessCoder](https://avatars.githubusercontent.com/u/2228052?v=4)](https://github.com/NamelessCoder "NamelessCoder (3 commits)")[![maddy2101](https://avatars.githubusercontent.com/u/1925287?v=4)](https://github.com/maddy2101 "maddy2101 (3 commits)")[![tomwarwick](https://avatars.githubusercontent.com/u/17770210?v=4)](https://github.com/tomwarwick "tomwarwick (3 commits)")[![Kanti](https://avatars.githubusercontent.com/u/471387?v=4)](https://github.com/Kanti "Kanti (1 commits)")[![andreaskienast](https://avatars.githubusercontent.com/u/1787983?v=4)](https://github.com/andreaskienast "andreaskienast (1 commits)")[![garvinhicking](https://avatars.githubusercontent.com/u/273326?v=4)](https://github.com/garvinhicking "garvinhicking (1 commits)")[![susannemoog](https://avatars.githubusercontent.com/u/321804?v=4)](https://github.com/susannemoog "susannemoog (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/t3docs-fluid-documentation-generator/health.svg)

```
[![Health](https://phpackages.com/badges/t3docs-fluid-documentation-generator/health.svg)](https://phpackages.com/packages/t3docs-fluid-documentation-generator)
```

###  Alternatives

[composer/composer

Composer helps you declare, manage and install dependencies of PHP projects. It ensures you have the right stack everywhere.

29.5k196.2M3.1k](/packages/composer-composer)[ergebnis/composer-normalize

Provides a composer plugin for normalizing composer.json.

1.1k41.5M2.9k](/packages/ergebnis-composer-normalize)[paycore/openfintech-data

Openfintech data

22110.1k](/packages/paycore-openfintech-data)[oat-sa/tao-core

TAO core extension

66143.7k124](/packages/oat-sa-tao-core)[pantheon-systems/terminus

A command line interface for Pantheon

3391.5M18](/packages/pantheon-systems-terminus)[getdkan/dkan

DKAN Open Data Catalog

387138.7k2](/packages/getdkan-dkan)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
