Print a warning when building docs with a pre-release version of the theme

Author: jessetan

babel.cfg

@@ -8,3 +8,6 @@
 encoding = utf-8
 ignore_tags = script,style
 include_attrs = alt title summary placeholder
+
+# Extraction from Python files
+[python: **.py]

docs/changelog.rst

@@ -20,6 +20,7 @@ Other Changes
 * Added Spanish translation
 * Added i18n support using Babel
 * Moved build system from Grunt and friends to Webpack
+* Warn when using a pre-release version of the theme
 
 0.4.3
 ======

sphinx_rtd_theme/__init__.py

@@ -5,13 +5,20 @@
 """
 
 from os import path
+import pkg_resources
+from sphinx.util import logging
+from sphinx.locale import get_translation
 
 import sphinx
 
 
 __version__ = '0.4.3.dev0'
 __version_full__ = __version__
 
+logger = logging.getLogger('sphinx-rtd-theme')
+MESSAGE_CATALOG_NAME = 'sphinx'
+_ = get_translation(MESSAGE_CATALOG_NAME)
+
 
 def get_html_theme_path():
     """Return list of HTML theme paths."""
@@ -23,8 +30,15 @@ def get_html_theme_path():
 def setup(app):
     app.add_html_theme('sphinx_rtd_theme', path.abspath(path.dirname(__file__)))
 
+    # Warn if a prerelease version of the theme is used
+    parsed_version = pkg_resources.parse_version(__version__)
+    if parsed_version.is_prerelease:
+        logger.warning(_('You are using a pre-release version (%s) of sphinx-rtd-theme.'), __version__)
+        logger.warning(_('Use a stable release if you encounter problems.'))
+        logger.warning(_('See <https://sphinx-rtd-theme.readthedocs.io/en/stable/installing.html>.'))
+
     if sphinx.version_info >= (1, 8, 0):
         # Add Sphinx message catalog for newer versions of Sphinx
         # See http://www.sphinx-doc.org/en/master/extdev/appapi.html#sphinx.application.Sphinx.add_message_catalog
         rtd_locale_path = path.join(path.abspath(path.dirname(__file__)), 'locale')
-        app.add_message_catalog('sphinx', rtd_locale_path)
+        app.add_message_catalog(MESSAGE_CATALOG_NAME, rtd_locale_path)