Fix Sphinx warnings in docs. Docs build on Windows

Windows can't run setup.py since it's not a win32 application. Fixing
this by importing setup instead of running it in docs/conf.py.

Fixing Sphinx warnings (nfsn link text needs to be changed too). Using
latest googleanalytics sphinx extension from bitbutcket since the PyPI
one is really old.

Sphinx warnings are errors again in docs. Can never be in scv.overflow
though thanks to tags with nfsn label duplicated.

Author: Robpol86

docs/conf.py

@@ -2,18 +2,17 @@
 
 import os
 import time
-from subprocess import check_output
 
-SETUP = os.path.join(os.path.dirname(__file__), '..', 'setup.py')
+from setup import NAME, VERSION
 
 
 # General configuration.
-author = check_output([SETUP, '--author']).strip().decode('ascii')
+author = '@Robpol86'
 copyright = '{}, {}'.format(time.strftime('%Y'), author)
 master_doc = 'index'
-project = check_output([SETUP, '--name']).strip().decode('ascii')
+project = NAME
 pygments_style = 'friendly'
-release = version = check_output([SETUP, '--version']).strip().decode('ascii')
+release = version = VERSION
 templates_path = ['_templates']
 extensions = list()
 

docs/nfsn.rst

@@ -4,8 +4,9 @@
 NearlyFreeSpeech.NET
 ====================
 
-This guide will go over how to host your built documentation on `NFSN <https://www.nearlyfreespeech.net/>`_. We'll be
-using GitHub and Travis CI to actually build the docs and push them to NFSN but any other providers can be substituted.
+This guide will go over how to host your built documentation on `NearlyFreeSpeech <https://www.nearlyfreespeech.net/>`_.
+We'll be using GitHub and Travis CI to actually build the docs and push them to NFSN but any other providers can be
+substituted.
 
 We'll be covering two methods of having NFSN host your documentation: using ``rsync`` to transfer HTML files to NFSN and
 using a remote git repository hosted on NFSN using ``git init --bare`` and having a git hook export HTML files to the

setup.py

@@ -73,42 +73,43 @@ def run(cls):
                 raise SystemExit('Missing/unordered pinned dependencies in tox.ini.')
 
 
-setup(
-    author='@Robpol86',
-    author_email='[email protected]',
-    classifiers=[
-        'Development Status :: 5 - Production/Stable',
-        'Environment :: Console',
-        'Framework :: Sphinx :: Extension',
-        'Intended Audience :: Developers',
-        'License :: OSI Approved :: MIT License',
-        'Operating System :: MacOS',
-        'Operating System :: POSIX :: Linux',
-        'Operating System :: POSIX',
-        'Programming Language :: Python :: 2.7',
-        'Programming Language :: Python :: 3.3',
-        'Programming Language :: Python :: 3.4',
-        'Programming Language :: Python :: 3.5',
-        'Programming Language :: Python :: Implementation :: PyPy',
-        'Topic :: Documentation :: Sphinx',
-        'Topic :: Software Development :: Documentation',
-    ],
-    cmdclass=dict(check_version=CheckVersion),
-    description='Sphinx extension that allows building versioned docs for self-hosting.',
-    entry_points={'console_scripts': ['sphinx-versioning = sphinxcontrib.versioning.__main__:cli']},
-    install_requires=INSTALL_REQUIRES,
-    keywords='sphinx versioning versions version branches tags',
-    license=LICENSE,
-    long_description=readme(),
-    name=NAME,
-    package_data={'': [
-        os.path.join('_static', 'banner.css'),
-        os.path.join('_templates', 'banner.html'),
-        os.path.join('_templates', 'layout.html'),
-        os.path.join('_templates', 'versions.html'),
-    ]},
-    packages=['sphinxcontrib', os.path.join('sphinxcontrib', 'versioning')],
-    url='https://github.com/Robpol86/' + NAME,
-    version=VERSION,
-    zip_safe=False,
-)
+if __name__ == '__main__':
+    setup(
+        author='@Robpol86',
+        author_email='[email protected]',
+        classifiers=[
+            'Development Status :: 5 - Production/Stable',
+            'Environment :: Console',
+            'Framework :: Sphinx :: Extension',
+            'Intended Audience :: Developers',
+            'License :: OSI Approved :: MIT License',
+            'Operating System :: MacOS',
+            'Operating System :: POSIX :: Linux',
+            'Operating System :: POSIX',
+            'Programming Language :: Python :: 2.7',
+            'Programming Language :: Python :: 3.3',
+            'Programming Language :: Python :: 3.4',
+            'Programming Language :: Python :: 3.5',
+            'Programming Language :: Python :: Implementation :: PyPy',
+            'Topic :: Documentation :: Sphinx',
+            'Topic :: Software Development :: Documentation',
+        ],
+        cmdclass=dict(check_version=CheckVersion),
+        description='Sphinx extension that allows building versioned docs for self-hosting.',
+        entry_points={'console_scripts': ['sphinx-versioning = sphinxcontrib.versioning.__main__:cli']},
+        install_requires=INSTALL_REQUIRES,
+        keywords='sphinx versioning versions version branches tags',
+        license=LICENSE,
+        long_description=readme(),
+        name=NAME,
+        package_data={'': [
+            os.path.join('_static', 'banner.css'),
+            os.path.join('_templates', 'banner.html'),
+            os.path.join('_templates', 'layout.html'),
+            os.path.join('_templates', 'versions.html'),
+        ]},
+        packages=['sphinxcontrib', os.path.join('sphinxcontrib', 'versioning')],
+        url='https://github.com/Robpol86/' + NAME,
+        version=VERSION,
+        zip_safe=False,
+    )

tox.ini

@@ -40,11 +40,11 @@ deps =
 [testenv:docs]
 changedir = {toxinidir}/docs
 commands =
-    sphinx-build -a -E . _build/html
+    sphinx-build -a -E -W . _build/html
 deps =
     {[general]install_requires}
     sphinx-rtd-theme==0.1.10a0
-    sphinxcontrib-googleanalytics==0.1
+    https://bitbucket.org/birkenfeld/sphinx-contrib/get/49d179fdc906.zip#egg=ga&subdirectory=googleanalytics
 
 [testenv:docsV]
 commands =