fix references in rst + add some postBuild validation

Author: nikophil

_build/composer.lock

@@ -29,6 +29,5 @@ 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 `_build` directory indexed (test case to create)
 - 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

@@ -3,13 +3,33 @@
 require __DIR__.'/vendor/autoload.php';
 
 use Doctrine\RST\Builder;
+use Symfony\Component\Filesystem\Filesystem;
+use Symfony\Component\Finder\Finder;
 use SymfonyDocs\HtmlKernel;
 
-$kernel = new HtmlKernel();
+$kernel  = new HtmlKernel();
 $builder = new Builder($kernel);
 
+$fs = new Filesystem();
+$fs->remove(__DIR__.'/html');
+
 $builder->build(
     __DIR__.'/..',
     __DIR__.'/html',
-    false
+    true
 );
+
+$finder = new Finder();
+$finder->in(__DIR__.'/..')
+    ->exclude(['_build', '.github', '.platform', '_images'])
+    ->notName('*.rst.inc')
+    ->name('*.rst');
+
+foreach ($finder as $file) {
+    $htmlFile = str_replace(['/home/niko/works/symfony-docs', '.rst'], ['/home/niko/works/symfony-docs/_build/html', '.html'], $file->getRealPath());
+    if (!file_exists($htmlFile)) {
+        dump("missing file: ".$htmlFile);
+    }
+}
+
+

_build/parse.php

@@ -28,6 +28,12 @@ class CodeNode extends Base
         'varnish4'        => 'c',
         'varnish3'        => 'c',
         'json'            => 'json',
+        'apache'          => 'apache',
+        'nginx'           => 'nginx',
+        'javascript'      => 'javascript',
+        'sql'             => 'sql',
+        'css'             => 'css',
+        'diff'            => 'diff',
     ];
 
     private const CODE_BLOCK_TEMPLATE = <<< TEMPLATE

_build/src/Nodes/CodeNode.php

@@ -17,7 +17,7 @@ within that class.
 .. versionadded:: 2.8
     The PropertyInfo component was introduced in Symfony 2.8.
 
-.. _`components-property-information-installation`:
+.. _components-property-information-installation:
 
 Installation
 ------------
@@ -33,7 +33,7 @@ Alternatively, you can clone the `<https://github.com/symfony/property-info>`_ r
 Additional dependencies may be required for some of the
 :ref:`extractors provided with this component <components-property-info-extractors>`.
 
-.. _`components-property-information-usage`:
+.. _components-property-information-usage:
 
 Usage
 -----
@@ -117,7 +117,7 @@ both provide list and type information it is probably better that:
         )
     );
 
-.. _`components-property-information-extractable-information`:
+.. _components-property-information-extractable-information:
 
 Extractable Information
 -----------------------
@@ -253,7 +253,7 @@ works.
     available on the main :class:`Symfony\\Component\\PropertyInfo\\PropertyInfoExtractor`
     class.
 
-.. _`components-property-info-type`:
+.. _components-property-info-type:
 
 Type Objects
 ------------
@@ -277,7 +277,7 @@ class.
 
 Each object will provide 6 attributes, available in the 6 methods:
 
-.. _`components-property-info-type-builtin`:
+.. _components-property-info-type-builtin:
 
 Type::getBuiltInType()
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -326,7 +326,7 @@ available), via the :method:`Type::getCollectionKeyType() <Symfony\\Component\\P
 and :method:`Type::getCollectionValueType() <Symfony\\Component\\PropertyInfo\\Type::getCollectionValueType>`
 methods.
 
-.. _`components-property-info-extractors`:
+.. _components-property-info-extractors:
 
 Extractors
 ----------
@@ -339,7 +339,7 @@ The :class:`Symfony\\Component\\PropertyInfo\\PropertyInfoExtractor` will
 iterate over the relevant extractor classes in the order they were set, call
 the appropriate method and return the first result that is not ``null``.
 
-.. _`components-property-information-extractors-available`:
+.. _components-property-information-extractors-available:
 
 While you can create your own extractors, the following are already available
 to cover most use-cases:
@@ -461,7 +461,7 @@ with the ``property_info`` service in the Symfony Framework.
     // Type information.
     $doctrineExtractor->getTypes($class, $property);
 
-.. _`components-property-information-extractors-creation`:
+.. _components-property-information-extractors-creation:
 
 Creating Your Own Extractors
 ----------------------------

components/property_info.rst

@@ -63,7 +63,7 @@ as `Varnish`_, `Squid in reverse proxy mode`_, and the Symfony reverse proxy.
 .. index::
    single: Cache; Symfony reverse proxy
 
-.. _`symfony-gateway-cache`:
+.. _symfony-gateway-cache:
 .. _symfony2-reverse-proxy:
 
 Symfony Reverse Proxy

http_cache.rst

@@ -287,7 +287,7 @@ directory outside of a bundle.
     single: Configuration; Doctrine DBAL
     single: Doctrine; DBAL configuration
 
-.. _`reference-dbal-configuration`:
+.. _reference-dbal-configuration:
 
 Custom Mapping Entities in a Bundle
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

reference/configuration/doctrine.rst

@@ -16,7 +16,7 @@ There are two steps to upgrading a minor version:
 #. :ref:`Update the Symfony library via Composer <upgrade-minor-symfony-composer>`;
 #. :ref:`Update your code to work with the new version <upgrade-minor-symfony-code>`.
 
-.. _`upgrade-minor-symfony-composer`:
+.. _upgrade-minor-symfony-composer:
 
 1) Update the Symfony Library via Composer
 ------------------------------------------
@@ -45,7 +45,7 @@ Next, use Composer to download new versions of the libraries:
 
 .. include:: /setup/_update_all_packages.rst.inc
 
-.. _`upgrade-minor-symfony-code`:
+.. _upgrade-minor-symfony-code:
 
 2) Updating your Code to Work with the new Version
 --------------------------------------------------