update parser version which basically fixes all problems

Author: nikophil

.gitignore

@@ -1,3 +1,4 @@
 /_build/doctrees
 /_build/html
+/_build/json
 *.pyc

_build/composer.lock

@@ -23,11 +23,3 @@ Notes
 - we're assuming there is only one toctree per page...
 - `rst` does not exist in highlight php
 - `varnish` = C ? (highlight php)
-
-Bugs in RST Parser
-==================
-
-- problem using glob: listed files are added twice (https://github.com/doctrine/rst-parser/issues/18)
-- problem with absolute path in toc trees (https://github.com/doctrine/rst-parser/pull/23)
-- problem with `:ref:`, `:doc:` and `*.rst.inc` which are loaded in parseQueue (problem evoked in https://github.com/doctrine/rst-parser/pull/23)
-- problem with `.. include::` which are SOMETIMES failing to load (dirty fix in `UrlGenerator::relativeUrl`) 

_build/notes.md

@@ -6,17 +6,18 @@
 use Symfony\Component\Filesystem\Filesystem;
 use Symfony\Component\Finder\Finder;
 use SymfonyDocs\HtmlKernel;
+use SymfonyDocs\JsonGenerator;
 
 $kernel  = new HtmlKernel();
 $builder = new Builder($kernel);
 
 $fs = new Filesystem();
-$fs->remove(__DIR__.'/html');
+$fs->remove($htmlOutputDir = __DIR__.'/html');
+$fs->remove($jsonOutputDir = __DIR__.'/json');
 
 $builder->build(
     __DIR__.'/..',
-    __DIR__.'/html',
-    true
+    $htmlOutputDir
 );
 
 $finder = new Finder();
@@ -32,4 +33,7 @@
     }
 }
 
+$jsonGenerator = new JsonGenerator($builder->getDocuments()->getAll());
+$jsonGenerator->generateJson($htmlOutputDir, $jsonOutputDir);
+
 

_build/parse.php

@@ -71,7 +71,7 @@ private function getParserFilename(string $filePath, string $inputDir): string
     private function getEnvironment(string $parserFilename): Environment
     {
         if (!isset($this->environments[$parserFilename])) {
-            throw new \LogicException(sprintf('Cannot guess file name in parser "%s"', $parserFilename));
+            throw new \LogicException(sprintf('Cannot find environment for file "%s"', $parserFilename));
         }
 
         return $this->environments[$parserFilename];
@@ -117,9 +117,11 @@ private function guessNext(string $parserFilename): ?array
             return null;
         }
 
+        $nextFileName = $toc[$indexCurrentFile + 1];
+
         return [
-            'title' => $this->getMeta($toc[$indexCurrentFile + 1])->getTitle(),
-            'link'  => $this->getMeta($toc[$indexCurrentFile + 1])->getUrl(),
+            'title' => $this->getMeta($nextFileName)->getTitle(),
+            'link'  => $this->getMeta($nextFileName)->getUrl(),
         ];
     }
 
@@ -131,9 +133,11 @@ private function guessPrev(string $parserFilename): ?array
             return null;
         }
 
+        $prevFileName = $toc[$indexCurrentFile - 1];
+
         return [
-            'title' => $this->getMeta($toc[$indexCurrentFile - 1])->getTitle(),
-            'link'  => $this->getMeta($toc[$indexCurrentFile - 1])->getUrl(),
+            'title' => $this->getMeta($prevFileName)->getTitle(),
+            'link'  => $this->getMeta($prevFileName)->getUrl(),
         ];
     }
 
@@ -143,19 +147,19 @@ private function getNextPrevInformation(string $parserFilename): ?array
         $parentFile = $meta->getParent();
 
         if (!$parentFile) {
-            return [null, null];
+            return [null, null, null];
         }
 
         $metaParent = $this->getMeta($parentFile);
 
         if (!$metaParent->getTocs() || \count($metaParent->getTocs()) !== 1) {
-            return [null, null];
+            return [null, null, null];
         }
 
         $toc = current($metaParent->getTocs());
 
         if (\count($toc) < 2 || !isset(array_flip($toc)[$parserFilename])) {
-            return [null, null];
+            return [null, null, null];
         }
 
         $indexCurrentFile = array_flip($toc)[$parserFilename];