gl-website-deployer/vendor/doctrine/rst-parser/docs/en/customizing-rendering.rst
2024-11-19 08:02:04 +01:00

1.0 KiB

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> </head>

Customizing Rendering

You can customize individual templates used during the rendering process by configuring the customTemplateDirs option using setCustomTemplateDirs() or addCustomTemplateDir() methods:

use Doctrine\RST\Formats\Format;

$configuration->setFileExtension(Format::HTML); // default is html
$configuration->setCustomTemplateDirs([
    '/path/to/custom/templates'
]);

The files that you can override can be found here.

For example, the file default/html/anchor.html.twig could be overwritten by creating the same file at /path/to/custom/templates/default/html/anchor.html.twig. All of the other templates will still use the core templates.

If you wanted to customize the LaTeX output you can do so like this:

$configuration->setFileExtension(Format::LATEX);

Now you can customize the LaTeX output by overriding files in /path/to/custom/templates/default/tex.

</html>