DevKit updates (#291)

Author: SonataCI

.gitattributes

@@ -6,5 +6,6 @@
 *.md export-ignore
 tests export-ignore
 docs export-ignore
+.readthedocs.yaml export-ignore
 Makefile export-ignore
 phpunit.xml.dist export-ignore

.readthedocs.yaml

@@ -0,0 +1,10 @@
+version: 2
+
+sphinx:
+    builder: dirhtml
+    configuration: docs/conf.py
+
+python:
+    version: '3.7'
+    install:
+        - requirements: docs/requirements.txt

Makefile

@@ -85,5 +85,5 @@ endif
 .PHONY: test
 
 docs:
-	cd docs && sphinx-build -W -b html -d _build/doctrees . _build/html
+	cd docs && sphinx-build -W -b dirhtml -d _build/doctrees . _build/html
 .PHONY: docs

README.md

@@ -16,14 +16,14 @@ Advanced article management
 [![Monthly Downloads](https://poser.pugx.org/sonata-project/article-bundle/d/monthly)](https://packagist.org/packages/sonata-project/article-bundle)
 [![Daily Downloads](https://poser.pugx.org/sonata-project/article-bundle/d/daily)](https://packagist.org/packages/sonata-project/article-bundle)
 
-Branch | Github Actions | Code Coverage |
------- | -------------- | ------------- |
-1.x    | [![Test][test_stable_badge]][test_stable_link]     | [![Coverage Status][coverage_stable_badge]][coverage_stable_link]     |
-master | [![Test][test_unstable_badge]][test_unstable_link] | [![Coverage Status][coverage_unstable_badge]][coverage_unstable_link] |
+Branch | Github Actions | Code Coverage | Documentation |
+------ | -------------- | ------------- | ------------- |
+1.x    | [![Test][test_stable_badge]][test_stable_link]     | [![Coverage Status][coverage_stable_badge]][coverage_stable_link]     | [![Documentation Status][documentation_stable_badge]][documentation_stable_link]     |
+master | [![Test][test_unstable_badge]][test_unstable_link] | [![Coverage Status][coverage_unstable_badge]][coverage_unstable_link] | [![Documentation Status][documentation_unstable_badge]][documentation_unstable_link] |
 
 ## Documentation
 
-Check out the documentation on the [official website](https://sonata-project.org/bundles/article).
+Check out the documentation on the [official website](https://docs.sonata-project.org/projects/SonataArticleBundle).
 
 ## Support
 
@@ -45,3 +45,8 @@ This package is available under the [MIT license](LICENSE).
 [coverage_stable_link]: https://codecov.io/gh/sonata-project/SonataArticleBundle/branch/1.x
 [coverage_unstable_badge]: https://codecov.io/gh/sonata-project/SonataArticleBundle/branch/master/graph/badge.svg
 [coverage_unstable_link]: https://codecov.io/gh/sonata-project/SonataArticleBundle/branch/master
+
+[documentation_stable_badge]: https://readthedocs.org/projects/sonataarticlebundle/badge/?version=1.x
+[documentation_stable_link]: https://docs.sonata-project.org/projects/SonataArticleBundle/en/1.x/?badge=1.x
+[documentation_unstable_badge]: https://readthedocs.org/projects/sonataarticlebundle/badge/?version=master
+[documentation_unstable_link]: https://docs.readthedocs.org/projects/SonataArticleBundle/en/master/?badge=master

docs/Makefile

@@ -29,11 +29,13 @@
 # -- General configuration -----------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-#needs_sphinx = '1.0'
+needs_sphinx = '1.8.5'
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sensio.sphinx.configurationblock', 'sensio.sphinx.phpcode']
+extensions = [
+    'sensio.sphinx.codeblock', 'sensio.sphinx.configurationblock', 'sensio.sphinx.phpcode'
+]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -49,7 +51,7 @@
 
 # General information about the project.
 project = u'SonataArticleBundle'
-copyright = u'2010-2020, Thomas Rabaix'
+copyright = u'2010-2021, Thomas Rabaix'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -102,7 +104,9 @@
 # enable highlighting for PHP code not between ``<?php ... ?>`` by default
 lexers['php'] = PhpLexer(startinline=True)
 lexers['php-annotations'] = PhpLexer(startinline=True)
+lexers['php-attributes'] = PhpLexer(startinline=True)
 lexers['php-standalone'] = PhpLexer(startinline=True)
+lexers['php-symfony'] = PhpLexer(startinline=True)
 
 # -- Options for HTML output ---------------------------------------------------
 import sphinx_rtd_theme

docs/conf.py

@@ -2,6 +2,7 @@
 #
 # It's auto-generated by sonata-project/dev-kit package.
 
-Sphinx==1.8.5
-git+https://github.com/fabpot/sphinx-php.git
-sphinx_rtd_theme
+Pygments==2.2.0
+sphinx==1.8.5
+git+https://github.com/fabpot/sphinx-php.git@v2.0.2#egg_name=sphinx-php
+sphinx_rtd_theme==0.5.2