Download the PHP package ublaboo/anabelle without Composer
On this page you can find all versions of the php package ublaboo/anabelle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ublaboo/anabelle
More information about ublaboo/anabelle
Files in ublaboo/anabelle
Package anabelle
Short Description JSON-RPC Api documentation generator
License MIT
Homepage https://contributte.org/anabelle
Informations about the package anabelle
Website 🚀 contributte.org | Contact 👨🏻💻 f3l1x.io | Twitter 🐦 @contributte
Disclaimer
| :warning: | This project is no longer being maintained. |
|---|
| Composer | contributte/anabelle |
|---|---|
| Version | |
| PHP | |
| License |
About
Anabelle is a JSON-RPC API documentation generator. It supports both JSON-RPC and REST architectures and provides an extended Markdown syntax for creating rich, interactive API documentation.
Usage
To install the latest version of contributte/anabelle use Composer.
How to use anabelle
CLI options
Automatically overwrite output directory
Add http auth to generated files
Beware! Anabelle generates by default .html files. If you are using http auth, it generates .php files due to the need of validating http auth headers.
Extended Markdown syntax
#include <file.md>
$variable = <value>
Inline variable usage
$$blockVariable ... $$
Block variable usage
@ <sectionName>:<sectionFile.md>
High-level section definition. This macro available only in index.md file.
@@ <sectionName>:<sectionFile.md>
Method section definition. This macro available only in index.md file.
[File link](foo/bar/data.json)
File link will create a link to file (foo/bar/data.json). The file will be copied to documentation output directory for safety reasons.
Generator workflow
- Most important (and only required) file is
index.md. In this file, you can use only (different Markdown markup is ignored inindex.md):# <h1>## <h2>#include <file.md>$variable = <value>$$blockVariable ... $$@ <sectionName>:<sectionFile.md>@@ <sectionName>:<sectionFile.md>)
#includemacros are replaced<h1>is used as documentation page title (only the first found one is used)<h2>can be used wherever you want in the sidebar@and@@sections are rendered in the sidebar nav- Content of
@and@@sections is rendered into separate files and loaded into the main section detail after clicking particular section link in the nav
Examples
- http://github.com/contributte/playground/tree/master/contributte-anabelle (example project)
- https://examples.contributte.org/packages/anabelle/ (generated documentation)
- https://github.com/contributte/playground (playground)
- https://contributte.org/examples.html (more examples)
Versions
| State | Version | Branch | Nette | PHP |
|---|---|---|---|---|
| dev | ^6.0.0 |
master |
3.0+ |
>=8.1 |
| stable | ^5.0.0 |
master |
3.0+ |
>=8.1 |
Development
This package was maintained by these authors.
Consider to support contributte development team. Also thank you for using this package.
All versions of anabelle with dependencies
erusev/parsedown Version ^1.7
symfony/console Version ^5.0|^6.0
matthiasmullie/minify Version ^1.3
nette/utils Version ^3.2.10|^4.0.3