Splitting layout into an rtd theme so we can render tests in a "pure" format

Author: weaverryan

src/BuildContext.php

@@ -2,6 +2,8 @@
 
 namespace SymfonyDocsBuilder;
 
+use Doctrine\RST\Configuration;
+
 class BuildContext
 {
     private $symfonyVersion;
@@ -14,6 +16,7 @@ class BuildContext
     private $outputDir;
     private $parseSubPath;
     private $disableCache = false;
+    private $theme;
     private $cacheDirectory;
 
     public function __construct(
@@ -28,12 +31,13 @@ public function __construct(
         $this->symfonyDocUrl  = $symfonyDocUrl;
     }
 
-    public function initializeRuntimeConfig(string $sourceDir, string $outputDir, ?string $parseSubPath = null, bool $disableCache = false)
+    public function initializeRuntimeConfig(string $sourceDir, string $outputDir, ?string $parseSubPath = null, bool $disableCache = false, string $theme = Configuration::THEME_DEFAULT)
     {
         $this->sourceDir          = $sourceDir;
         $this->outputDir          = $outputDir;
         $this->parseSubPath       = $parseSubPath;
         $this->disableCache       = $disableCache;
+        $this->theme              = $theme;
         $this->runtimeInitialized = true;
     }
 
@@ -85,6 +89,13 @@ public function getDisableCache(): bool
         return $this->disableCache;
     }
 
+    public function getTheme(): string
+    {
+        $this->checkThatRuntimeConfigIsInitialized();
+
+        return $this->theme;
+    }
+
     public function getCacheDir(): string
     {
         return $this->cacheDirectory ?: $this->getOutputDir().'/.cache';

src/Command/BuildDocsCommand.php

@@ -4,6 +4,7 @@
 
 use Doctrine\Common\EventManager;
 use Doctrine\RST\Builder;
+use Doctrine\RST\Configuration;
 use Doctrine\RST\Event\PostBuildRenderEvent;
 use Doctrine\RST\Meta\Metas;
 use Symfony\Component\Console\Command\Command;
@@ -71,6 +72,12 @@ protected function configure()
                 InputOption::VALUE_REQUIRED,
                 'Path where any errors should be saved'
             )
+            ->addOption(
+                'no-theme',
+                null,
+                InputOption::VALUE_NONE,
+                'Use the default theme instead of the styled one'
+            )
         ;
     }
 
@@ -102,7 +109,8 @@ protected function initialize(InputInterface $input, OutputInterface $output)
             $sourceDir,
             $htmlOutputDir,
             $parseSubPath,
-            $input->getOption('disable-cache')
+            $input->getOption('disable-cache'),
+            $input->getOption('no-theme') ? Configuration::THEME_DEFAULT : 'rtd'
         );
     }
 

src/KernelFactory.php

@@ -20,6 +20,7 @@ public static function createKernel(BuildContext $buildContext, ?UrlChecker $url
     {
         $configuration = new RSTParserConfiguration();
         $configuration->setCustomTemplateDirs([__DIR__.'/Templates']);
+        $configuration->setTheme($buildContext->getTheme());
         $configuration->setCacheDir(sprintf('%s/var/cache', $buildContext->getCacheDir()));
         $configuration->abortOnError(false);
 

src/Listener/AssetsCopyListener.php

@@ -18,7 +18,7 @@ public function postBuildRender()
     {
         $fs = new Filesystem();
         $fs->mirror(
-            sprintf('%s/../Templates/default/assets', __DIR__),
+            sprintf('%s/../Templates/rtd/assets', __DIR__),
             sprintf('%s/assets', $this->targetDir)
         );
     }