Upgrade all CI to Sphinx 1.8.5

.doctor-rst.yaml

@@ -50,6 +50,7 @@ whitelist:
         - '/FOSUserBundle(.*)\.yml/'
         - '/``.yml``/'
         - '/(.*)\.orm\.yml/' # currently DoctrineBundle only supports .yml
+        - '/rst-class/'
     lines:
         - 'in config files, so the old ``app/config/config_dev.yml`` goes to'
         - '#. The most important config file is ``app/config/services.yml``, which now is'
@@ -72,3 +73,4 @@ whitelist:
         - '$var .= "Because of this `\xE9` octet (\\xE9),\n";'
         - "`Deploying Symfony 4 Apps on Heroku`_."
         - ".. _`Deploying Symfony 4 Apps on Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4"
+        - '.. code-block:: twig'

.github/workflows/ci.yaml

@@ -30,7 +30,7 @@ jobs:
                 run: sudo apt-get install python-dev build-essential
 
             -   name: "Cache pip"
-                uses: actions/cache@v1
+                uses: actions/cache@v2
                 with:
                     path: ~/.cache/pip
                     key: ${{ runner.os }}-pip-${{ hashFiles('_build/.requirements.txt') }}
@@ -41,7 +41,7 @@ jobs:
                 run: pip install -r _build/.requirements.txt
 
             -   name: "Build documentation"
-                run: make -C _build SPHINXOPTS=-nqW html
+                run: make -C _build SPHINXOPTS="-nqW -j auto" html
 
     doctor-rst:
         name: DOCtor-RST

_build/.requirements.txt

@@ -1,13 +1,6 @@
-alabaster==0.7.10
-Babel==2.4.0
 docutils==0.13.1
-imagesize==0.7.1
-Jinja2==2.10.1
-MarkupSafe==1.0
 Pygments==2.2.0
-pytz==2017.2
-requests==2.20.0
-six==1.10.0
-snowballstemmer==1.2.1
-sphinx==1.3.6
-git+https://github.com/fabpot/[email protected]#egg_name=sphinx-php
+sphinx==1.8.5
+git+https://github.com/fabpot/[email protected]#egg_name=sphinx-php
+jsx-lexer===0.0.8
+sphinx_rtd_theme==0.5.0

_build/_themes/_exts/symfonycom/sphinx/__init__.py → _build/_exts/symfonycom/sphinx/__init__.py

@@ -1,81 +1,7 @@
-from sphinx.highlighting import lexers, PygmentsBridge
 from pygments.style import Style
-from pygments.formatters import HtmlFormatter
 from pygments.token import Keyword, Name, Comment, String, Error, \
      Number, Operator, Generic, Whitespace, Punctuation, Other, Literal
 
-from sphinx.writers.html import HTMLTranslator
-from docutils import nodes
-from sphinx.locale import admonitionlabels, lazy_gettext
-
-customadmonitionlabels = admonitionlabels
-l_ = lazy_gettext
-customadmonitionlabels['best-practice'] = l_('Best Practice')
-
-def _getType(path):
-    return path[:path.find('/')]
-
-def _isIndex(path):
-    return 'index' in path
-
-class SensioHTMLTranslator(HTMLTranslator):
-    def __init__(self, builder, *args, **kwds):
-        HTMLTranslator.__init__(self, builder, *args, **kwds)
-        builder.templates.environment.filters['get_type'] = _getType
-        builder.templates.environment.tests['index'] = _isIndex
-        self.highlightlinenothreshold = 0
-
-    def visit_literal(self, node):
-        self.body.append(self.starttag(node, 'code', '', CLASS='docutils literal notranslate'))
-
-    def depart_literal(self, node):
-        self.body.append('</code>')
-
-    def visit_admonition(self, node, name=''):
-        self.body.append(self.starttag(node, 'div', CLASS=('admonition-wrapper')))
-        self.body.append('<div class="admonition ' + name + '">')
-        if name and name != 'seealso':
-            node.insert(0, nodes.title(name, customadmonitionlabels[name]))
-        self.set_first_last(node)
-
-    def depart_admonition(self, node=None):
-        self.body.append('</div></div>\n')
-
-    def visit_sidebar(self, node):
-        self.body.append(self.starttag(node, 'div', CLASS=('admonition-wrapper')))
-        self.body.append('<div class="admonition admonition-sidebar">')
-        self.set_first_last(node)
-        self.in_sidebar = 1
-
-    def depart_sidebar(self, node):
-        self.body.append('</div></div>\n')
-        self.in_sidebar = None
-
-    # overriden to add a new highlight div around each block
-    def visit_literal_block(self, node):
-        if node.rawsource != node.astext():
-            # most probably a parsed-literal block -- don't highlight
-            return BaseTranslator.visit_literal_block(self, node)
-        lang = self.highlightlang
-        linenos = node.rawsource.count('\n') >= \
-                  self.highlightlinenothreshold - 1
-        highlight_args = node.get('highlight_args', {})
-        if node.has_key('language'):
-            # code-block directives
-            lang = node['language']
-            highlight_args['force'] = True
-        if node.has_key('linenos'):
-            linenos = node['linenos']
-        def warner(msg):
-            self.builder.warn(msg, (self.builder.current_docname, node.line))
-        highlighted = self.highlighter.highlight_block(
-            node.rawsource, lang, warn=warner, linenos=linenos,
-            **highlight_args)
-        starttag = self.starttag(node, 'div', suffix='',
-                                 CLASS='highlight-%s' % lang)
-        self.body.append('<div class="literal-block">' + starttag + highlighted + '</div></div>\n')
-        raise nodes.SkipNode
-
 class SensioStyle(Style):
     background_color = "#000000"
     default_style = ""
@@ -158,8 +84,3 @@ class SensioStyle(Style):
         Generic.Subheading: "bold #800080", # class: 'gu'
         Generic.Traceback: "bold #a40000", # class: 'gt'
     }
-
-def setup(app):
-    app.set_translator('html', SensioHTMLTranslator)
-
-    return {'parallel_read_safe': True}

_build/_static/rtd_custom.css

@@ -0,0 +1,23 @@
+body {
+	font-family:Lucida Grande,Lucida Sans Unicode,Lucida Sans,Geneva,Verdana,sans-serif !important;
+}
+
+h1, h2, h3, h4, h5, h6 {
+	font-family:Georgia,Times New Roman,Times,serif !important;
+	line-height:1.2 !important;
+	margin-top:0 !important;
+	margin-bottom:.5em !important;
+}
+p, .rst-content li{
+	font-size:14px !important;
+	line-height:1.45 !important;
+}
+.wy-menu-vertical a {
+	font-size:14px !important;
+	padding-right:0 !important;
+}
+
+.highlight {
+	background:#1e2125 !important;
+    color:#fafafa !important;
+}