Download the PHP package yivoff/commonmark-bundle without Composer
On this page you can find all versions of the php package yivoff/commonmark-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download yivoff/commonmark-bundle
More information about yivoff/commonmark-bundle
Files in yivoff/commonmark-bundle
Package commonmark-bundle
Short Description Symfony bundle integrating League CommonMark for Symfony 6.2+ applications
License MIT
Informations about the package commonmark-bundle
CommonMarkBundle
A Symfony 5+ bundle to integrate league/commonmark v2, allowing you to set multiple Commonmark converters.
- Requirements
- Installation
- Configuration
- Converter type
- Converter options
- Converter extensions
- Using the converters
- As services
- Usage in templates
Requirements
This bundle requires PHP 8+ and Symfony 5+.
Installation
If for some reason you are running without Symfony Flex, enable the bundle as
usual adding Yivoff\CommonmarkBundle\YivoffCommonmarkBundle
to the bundle's array.
Configuration
You'll need to enable at least one converter to use the bundle.
Create a YAML configuration file at path config/packages/aymdev_commonmark.yaml
.
Here is an example configuration declaring 2 converters:
Setting up at least one converter is mandatory, but all settings are optional. By default,
a converter without setting a type
will be created as a CommonMark converter.
Converter type
The type
key can be used to choose between a CommonMark, a GitHub Flavoured or a Custom converter.
By default, if not type
is chosen, CommonMark will be chosen.
Converter options
You can use the options
key holds the configuration passed to the converter, as an array.
Check the CommonMark documentation to learn more about the available options.
Converter extensions
The CommonMark and Github Flavoured have a predefined set of extensions installed, which cannot be changed.
But custom
starts with no extensions, and you pick and choose
which extensions you want to enable using the
extensions
key.
This key
has no effect on github
or commonmark
type converters.
Using the converters
As services
Each of the defined converters is available as a service within the container.
The id is generated with the following format: yivoff_commonmark.converters.converter_name
.
For the converters in the configuration example three services would be generated:
yivoff_commonmark.converters.commonmark
yivoff_commonmark.converters.github
yivoff_commonmark.converters.my_custom
Additionally, the bundle registers an alias for each service, so one can use the service directly for autowiring.
Again, for the above example the registered aliases would be:
League\CommonMark\ConverterInterface $commonmark
League\CommonMark\ConverterInterface $github
League\CommonMark\ConverterInterface $myCustom
Usage in templates
The bundle defines a Twig filter: commonmark
.
If you have defined multiple converters, you need to pass the name of the converter you want to use:
But If you have only one converter defined, the parameter can be omitted.
All versions of commonmark-bundle with dependencies
league/commonmark Version ^2.2.0
symfony/config Version ^6.3 || ^7.0
symfony/dependency-injection Version ^6.3 || ^7.0
symfony/framework-bundle Version ^6.3 || ^7.0
symfony/http-kernel Version ^6.3 || ^7.0