!!![FEATURE] enable basic latex rendering

packages/guides/resources/config/command_bus.php

@@ -19,7 +19,6 @@
 use phpDocumentor\Guides\Handlers\RenderDocumentCommand;
 use phpDocumentor\Guides\Handlers\RenderDocumentHandler;
 use phpDocumentor\Guides\Handlers\RenderHandler;
-use phpDocumentor\Guides\NodeRenderers\DelegatingNodeRenderer;
 use Psr\EventDispatcher\EventDispatcherInterface;
 use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
@@ -46,7 +45,7 @@
 
         ->set(RenderDocumentHandler::class)
         ->tag('phpdoc.guides.command', ['command' => RenderDocumentCommand::class])
-        ->arg('$renderer', service(DelegatingNodeRenderer::class))
+        ->arg('$renderer', service('phpdoc.guides.output_node_renderer'))
         ->arg('$eventDispatcher', service(EventDispatcherInterface::class))
 
         ->set(CommandBus::class)

packages/guides/resources/config/guides.php

@@ -12,17 +12,13 @@
 use phpDocumentor\Guides\Interlink\InventoryLoader;
 use phpDocumentor\Guides\Interlink\InventoryRepository;
 use phpDocumentor\Guides\Interlink\JsonLoader;
-use phpDocumentor\Guides\NodeRenderers\DefaultNodeRenderer;
-use phpDocumentor\Guides\NodeRenderers\DelegatingNodeRenderer;
 use phpDocumentor\Guides\NodeRenderers\Html\BreadCrumbNodeRenderer;
 use phpDocumentor\Guides\NodeRenderers\Html\DocumentNodeRenderer;
 use phpDocumentor\Guides\NodeRenderers\Html\MenuEntryRenderer;
 use phpDocumentor\Guides\NodeRenderers\Html\MenuNodeRenderer;
 use phpDocumentor\Guides\NodeRenderers\Html\TableNodeRenderer;
-use phpDocumentor\Guides\NodeRenderers\InMemoryNodeRendererFactory;
-use phpDocumentor\Guides\NodeRenderers\NodeRendererFactory;
 use phpDocumentor\Guides\NodeRenderers\NodeRendererFactoryAware;
-use phpDocumentor\Guides\NodeRenderers\PreRenderers\PreNodeRendererFactory;
+use phpDocumentor\Guides\NodeRenderers\OutputAwareDelegatingNodeRenderer;
 use phpDocumentor\Guides\Parser;
 use phpDocumentor\Guides\ReferenceResolvers\AnchorReducer;
 use phpDocumentor\Guides\ReferenceResolvers\AnchorReferenceResolver;
@@ -145,18 +141,30 @@
         ->arg('$resolvers', tagged_iterator('phpdoc.guides.reference_resolver', defaultPriorityMethod: 'getPriority'))
 
         ->set(HtmlRenderer::class)
-        ->tag('phpdoc.renderer.typerenderer')
+        ->tag(
+            'phpdoc.renderer.typerenderer',
+            [
+                'noderender_tag' => 'phpdoc.guides.noderenderer.html',
+                'format' => 'html',
+            ],
+        )
         ->args(
             ['$commandBus' => service(CommandBus::class)],
         )
         ->set(LatexRenderer::class)
-        ->tag('phpdoc.renderer.typerenderer')
-        ->args(
-            ['$commandBus' => service(CommandBus::class)],
+        ->tag(
+            'phpdoc.renderer.typerenderer',
+            [
+                'noderender_tag' => 'phpdoc.guides.noderenderer.tex',
+                'format' => 'tex',
+            ],
         )
 
         ->set(InterlinkObjectsRenderer::class)
-        ->tag('phpdoc.renderer.typerenderer')
+        ->tag(
+            'phpdoc.renderer.typerenderer',
+            ['format' => 'interlink'],
+        )
 
         ->set(DocumentNodeRenderer::class)
         ->tag('phpdoc.guides.noderenderer.html')
@@ -169,33 +177,21 @@
         ->set(BreadCrumbNodeRenderer::class)
         ->tag('phpdoc.guides.noderenderer.html')
 
-        ->set(DefaultNodeRenderer::class)
-
-        ->set(InMemoryNodeRendererFactory::class)
-        ->args([
-            '$nodeRenderers' => tagged_iterator('phpdoc.guides.noderenderer.html'),
-            '$defaultNodeRenderer' => new Reference(DefaultNodeRenderer::class),
-        ])
-        ->alias(NodeRendererFactory::class, InMemoryNodeRendererFactory::class)
-
-        ->set(PreNodeRendererFactory::class)
-        ->decorate(NodeRendererFactory::class)
-        ->arg('$innerFactory', service('.inner'))
-        ->arg('$preRenderers', tagged_iterator('phpdoc.guides.prerenderer'))
-
         ->set(ReferenceResolverPreRender::class)
         ->tag('phpdoc.guides.prerenderer')
 
         ->set(InMemoryRendererFactory::class)
-        ->arg('$renderSets', tagged_iterator('phpdoc.renderer.typerenderer'))
+        ->arg('$renderSets', tagged_iterator('phpdoc.renderer.typerenderer', 'format'))
         ->alias(TypeRendererFactory::class, InMemoryRendererFactory::class)
 
         ->set(SluggerAnchorReducer::class)
         ->alias(AnchorReducer::class, SluggerAnchorReducer::class)
 
+        ->set('phpdoc.guides.output_node_renderer', OutputAwareDelegatingNodeRenderer::class)
+        ->arg('$nodeRenderers', tagged_iterator('phpdoc.guides.output_node_renderer', 'format'))
 
         ->set(AssetsExtension::class)
-        ->arg('$nodeRenderer', service(DelegatingNodeRenderer::class))
+        ->arg('$nodeRenderer', service('phpdoc.guides.output_node_renderer'))
         ->tag('twig.extension')
         ->autowire()
 

packages/guides/resources/template/tex/structure/document.tex.twig

@@ -0,0 +1,3 @@
+{%- for child in node.children ~%}
+    {{ renderNode(child) }}
+{%~ endfor -%}

packages/guides/resources/template/tex/guides/structure/document.tex.twig → packages/guides/resources/template/tex/structure/project.tex.twig

@@ -1,4 +1,3 @@
-{% if isMain(node) %}
 \documentclass[11pt]{report}
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
@@ -10,13 +9,9 @@
 \usepackage{graphicx}
 \usepackage{hyperref}
 \usepackage{listings}
-{% for node in document.headerNodes %}
-{{ renderNode(node) }}
-{% endfor %}
 \begin{document}
-{% endif %}
 \label{{ '{' }}{{ document.environment.url}}{{ '}' }}
-{{ body|raw }}
-{% if isMain %}
+{%- for document in documents -%}
+{{ renderNode(document) }}
+{%- endfor -%}
 \end{document}
-{% endif %}

packages/guides/src/DependencyInjection/Compiler/NodeRendererPass.php → packages/guides/src/DependencyInjection/Compiler/HtmlNodeRendererPass.php

@@ -4,7 +4,6 @@
 
 namespace phpDocumentor\Guides\DependencyInjection\Compiler;
 
-use phpDocumentor\Guides\NodeRenderers\NodeRendererFactory;
 use phpDocumentor\Guides\NodeRenderers\TemplateNodeRenderer;
 use phpDocumentor\Guides\Nodes\AnchorNode;
 use phpDocumentor\Guides\Nodes\AnnotationListNode;
@@ -62,7 +61,7 @@
 use Symfony\Component\DependencyInjection\Definition;
 use Symfony\Component\DependencyInjection\Reference;
 
-final class NodeRendererPass implements CompilerPassInterface
+final class HtmlNodeRendererPass implements CompilerPassInterface
 {
     private const HTML = [
         AnchorNode::class => 'inline/anchor.html.twig',
@@ -122,15 +121,6 @@ final class NodeRendererPass implements CompilerPassInterface
 
     public function process(ContainerBuilder $container): void
     {
-        foreach ($container->findTaggedServiceIds('phpdoc.guides.noderendererfactoryaware') as $id => $tags) {
-            $definition = $container->getDefinition($id);
-            $definition->addMethodCall(
-                'setNodeRendererFactory',
-                [new Reference(NodeRendererFactory::class)],
-            );
-            $definition->clearTag('phpdoc.guides.noderendererfactoryaware');
-        }
-
         $htmlRendererDefinitions = [];
         foreach (self::HTML as $node => $template) {
             $definition = new Definition(

packages/guides/src/DependencyInjection/Compiler/RendererPass.php

@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+namespace phpDocumentor\Guides\DependencyInjection\Compiler;
+
+use phpDocumentor\Guides\NodeRenderers\DefaultNodeRenderer;
+use phpDocumentor\Guides\NodeRenderers\DelegatingNodeRenderer;
+use phpDocumentor\Guides\NodeRenderers\InMemoryNodeRendererFactory;
+use phpDocumentor\Guides\NodeRenderers\PreRenderers\PreNodeRendererFactory;
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\DependencyInjection\Definition;
+use Symfony\Component\DependencyInjection\Reference;
+
+use function sprintf;
+use function Symfony\Component\DependencyInjection\Loader\Configurator\tagged_iterator;
+
+final class RendererPass implements CompilerPassInterface
+{
+    public function process(ContainerBuilder $container): void
+    {
+        //Node Renderer factory
+
+        //Inject node renderer factory into node renderer factory aware services
+
+
+        $definitions = [];
+
+        foreach ($container->findTaggedServiceIds('phpdoc.guides.noderendererfactoryaware') as $id => $tags) {
+            $definition = $container->getDefinition($id);
+            $definition->addMethodCall(
+                'setNodeRendererFactory',
+                [new Reference('phpdoc.guides.noderenderer.factory.html')],
+            );
+            $definition->clearTag('phpdoc.guides.noderendererfactoryaware');
+        }
+
+        foreach ($container->findTaggedServiceIds('phpdoc.renderer.typerenderer') as $id => $tags) {
+            foreach ($tags as $tag) {
+                if (isset($tag['noderender_tag']) === false) {
+                    continue;
+                }
+
+                $definitions[sprintf('phpdoc.guides.noderenderer.factory.%s', $tag['format'])] = $this->createNodeRendererFactory($tag);
+                $definitions[sprintf('phpdoc.guides.noderenderer.prefactory.%s', $tag['format'])] = $this->createPreNodeRendererFactory($tag);
+                $definitions[sprintf('phpdoc.guides.noderenderer.delegating.%s', $tag['format'])] = $this->createDelegatingNodeRender($tag);
+                $definitions[sprintf('phpdoc.guides.noderenderer.default.%s', $tag['format'])] = (new Definition(DefaultNodeRenderer::class))->setAutowired(true)
+                    ->addTag('phpdoc.guides.noderenderer.html');
+            }
+        }
+
+        $container->addDefinitions($definitions);
+    }
+
+    /** @param array{format: string} $tag */
+    private function createDelegatingNodeRender(array $tag): Definition
+    {
+        return (new Definition(DelegatingNodeRenderer::class))
+            ->addTag('phpdoc.guides.output_node_renderer', ['format' => $tag['format']])
+            ->addMethodCall('setNodeRendererFactory', [new Reference(sprintf('phpdoc.guides.noderenderer.factory.%s', $tag['format']))]);
+    }
+
+    /** @param array{format: string, noderender_tag: string} $tag */
+    private function createNodeRendererFactory(array $tag): Definition
+    {
+        return new Definition(
+            InMemoryNodeRendererFactory::class,
+            [
+                '$nodeRenderers' => tagged_iterator($tag['noderender_tag']),
+                '$defaultNodeRenderer' => new Reference(sprintf('phpdoc.guides.noderenderer.default.%s', $tag['format'])),
+            ],
+        );
+    }
+
+    /** @param array{format: string, noderender_tag: string} $tag */
+    private function createPreNodeRendererFactory(array $tag): Definition
+    {
+        return (new Definition(
+            PreNodeRendererFactory::class,
+            [
+                '$innerFactory' => new Reference('.inner'),
+                '$preRenderers' => tagged_iterator('phpdoc.guides.prerenderer'),
+            ],
+        ))
+            ->setDecoratedService(sprintf('phpdoc.guides.noderenderer.factory.%s', $tag['format']));
+    }
+}

packages/guides/src/DependencyInjection/Compiler/TexNodeRendererPass.php

@@ -0,0 +1,141 @@
+<?php
+
+declare(strict_types=1);
+
+namespace phpDocumentor\Guides\DependencyInjection\Compiler;
+
+use phpDocumentor\Guides\NodeRenderers\TemplateNodeRenderer;
+use phpDocumentor\Guides\Nodes\AnchorNode;
+use phpDocumentor\Guides\Nodes\AnnotationListNode;
+use phpDocumentor\Guides\Nodes\CitationNode;
+use phpDocumentor\Guides\Nodes\CodeNode;
+use phpDocumentor\Guides\Nodes\DefinitionListNode;
+use phpDocumentor\Guides\Nodes\DefinitionLists\DefinitionNode;
+use phpDocumentor\Guides\Nodes\DocumentNode;
+use phpDocumentor\Guides\Nodes\FieldListNode;
+use phpDocumentor\Guides\Nodes\FigureNode;
+use phpDocumentor\Guides\Nodes\FootnoteNode;
+use phpDocumentor\Guides\Nodes\ImageNode;
+use phpDocumentor\Guides\Nodes\Inline\AbbreviationInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\CitationInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\DocReferenceNode;
+use phpDocumentor\Guides\Nodes\Inline\EmphasisInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\FootnoteInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\GenericTextRoleInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\HyperLinkNode;
+use phpDocumentor\Guides\Nodes\Inline\ImageInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\LiteralInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\NewlineInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\PlainTextInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\ReferenceNode;
+use phpDocumentor\Guides\Nodes\Inline\StrongInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\VariableInlineNode;
+use phpDocumentor\Guides\Nodes\Inline\WhitespaceInlineNode;
+use phpDocumentor\Guides\Nodes\InlineCompoundNode;
+use phpDocumentor\Guides\Nodes\ListItemNode;
+use phpDocumentor\Guides\Nodes\ListNode;
+use phpDocumentor\Guides\Nodes\LiteralBlockNode;
+use phpDocumentor\Guides\Nodes\Metadata\AddressNode;
+use phpDocumentor\Guides\Nodes\Metadata\AuthorNode;
+use phpDocumentor\Guides\Nodes\Metadata\AuthorsNode;
+use phpDocumentor\Guides\Nodes\Metadata\ContactNode;
+use phpDocumentor\Guides\Nodes\Metadata\CopyrightNode;
+use phpDocumentor\Guides\Nodes\Metadata\DateNode;
+use phpDocumentor\Guides\Nodes\Metadata\MetaNode;
+use phpDocumentor\Guides\Nodes\Metadata\NoCommentsNode;
+use phpDocumentor\Guides\Nodes\Metadata\NoSearchNode;
+use phpDocumentor\Guides\Nodes\Metadata\OrganizationNode;
+use phpDocumentor\Guides\Nodes\Metadata\OrphanNode;
+use phpDocumentor\Guides\Nodes\Metadata\RevisionNode;
+use phpDocumentor\Guides\Nodes\Metadata\TocDepthNode;
+use phpDocumentor\Guides\Nodes\Metadata\TopicNode;
+use phpDocumentor\Guides\Nodes\Metadata\VersionNode;
+use phpDocumentor\Guides\Nodes\ParagraphNode;
+use phpDocumentor\Guides\Nodes\QuoteNode;
+use phpDocumentor\Guides\Nodes\SectionNode;
+use phpDocumentor\Guides\Nodes\SeparatorNode;
+use phpDocumentor\Guides\Nodes\TitleNode;
+use phpDocumentor\Guides\TemplateRenderer;
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\DependencyInjection\Definition;
+use Symfony\Component\DependencyInjection\Reference;
+
+final class TexNodeRendererPass implements CompilerPassInterface
+{
+    private const TEX = [
+        AnchorNode::class => 'inline/anchor.tex.twig',
+        FigureNode::class => 'body/figure.tex.twig',
+        MetaNode::class => 'structure/header/meta.tex.twig',
+        ParagraphNode::class => 'body/paragraph.tex.twig',
+        QuoteNode::class => 'body/quote.tex.twig',
+        SeparatorNode::class => 'body/separator.tex.twig',
+        TitleNode::class => 'structure/header-title.tex.twig',
+        SectionNode::class => 'structure/section.tex.twig',
+        DocumentNode::class => 'structure/document.tex.twig',
+        ImageNode::class => 'body/image.tex.twig',
+        CodeNode::class => 'body/code.tex.twig',
+        DefinitionListNode::class => 'body/definition-list.tex.twig',
+        DefinitionNode::class => 'body/definition.tex.twig',
+        FieldListNode::class => 'body/field-list.tex.twig',
+        ListNode::class => 'body/list/list.tex.twig',
+        ListItemNode::class => 'body/list/list-item.tex.twig',
+        LiteralBlockNode::class => 'body/literal-block.tex.twig',
+        CitationNode::class => 'body/citation.tex.twig',
+        FootnoteNode::class => 'body/footnote.tex.twig',
+        AnnotationListNode::class => 'body/annotation-list.tex.twig',
+        // Inline
+        ImageInlineNode::class => 'inline/image.tex.twig',
+        InlineCompoundNode::class => 'inline/inline-node.tex.twig',
+        AbbreviationInlineNode::class => 'inline/textroles/abbreviation.tex.twig',
+        CitationInlineNode::class => 'inline/citation.tex.twig',
+        DocReferenceNode::class => 'inline/doc.tex.twig',
+        EmphasisInlineNode::class => 'inline/emphasis.tex.twig',
+        FootnoteInlineNode::class => 'inline/footnote.tex.twig',
+        HyperLinkNode::class => 'inline/link.tex.twig',
+        LiteralInlineNode::class => 'inline/literal.tex.twig',
+        NewlineInlineNode::class => 'inline/newline.tex.twig',
+        WhitespaceInlineNode::class => 'inline/nbsp.tex.twig',
+        PlainTextInlineNode::class => 'inline/plain-text.tex.twig',
+        ReferenceNode::class => 'inline/ref.tex.twig',
+        StrongInlineNode::class => 'inline/strong.tex.twig',
+        VariableInlineNode::class => 'inline/variable.tex.twig',
+        GenericTextRoleInlineNode::class => 'inline/textroles/generic.tex.twig',
+        // Output as Metatags
+        AuthorNode::class => 'structure/header/author.tex.twig',
+        CopyrightNode::class => 'structure/header/copyright.tex.twig',
+        DateNode::class => 'structure/header/date.tex.twig',
+        NoSearchNode::class => 'structure/header/no-search.tex.twig',
+        TopicNode::class => 'structure/header/topic.tex.twig',
+        // No output in page header in tex - might be output in i.e. LaTex
+        AddressNode::class => 'structure/header/blank.tex.twig',
+        AuthorsNode::class => 'structure/header/blank.tex.twig',
+        ContactNode::class => 'structure/header/blank.tex.twig',
+        NoCommentsNode::class => 'structure/header/blank.tex.twig',
+        OrganizationNode::class => 'structure/header/blank.tex.twig',
+        OrphanNode::class => 'structure/header/blank.tex.twig',
+        RevisionNode::class => 'structure/header/blank.tex.twig',
+        TocDepthNode::class => 'structure/header/blank.tex.twig',
+        VersionNode::class => 'structure/header/blank.tex.twig',
+    ];
+
+    public function process(ContainerBuilder $container): void
+    {
+        $texRendererDefinitions = [];
+        foreach (self::TEX as $node => $template) {
+            $definition = new Definition(
+                TemplateNodeRenderer::class,
+                [
+                    '$renderer' => new Reference(TemplateRenderer::class),
+                    '$template' => $template,
+                    '$nodeClass' => $node,
+                ],
+            );
+            $definition->addTag('phpdoc.guides.noderenderer.tex');
+
+            $texRendererDefinitions['phpdoc.guides.noderenderer.tex.' . $node] = $definition;
+        }
+
+         $container->addDefinitions($texRendererDefinitions);
+    }
+}