more doc build changes

Author: dhellmann

ChangeLog

@@ -1,5 +1,9 @@
 2011-02-26  Doug Hellmann  <[email protected]>
 
+	* docs/sphinx/conf.py: Just hard-code the version.
+
+	* setup.py: Just hard-code the version.
+
 	* virtualenvwrapper/version.py: Put the version info inside the
 	package so it is available to the doc build and packaging
 	script. This also makes the readthedocs.org build work properly.

Makefile

@@ -4,12 +4,11 @@ help:
 	@echo "html           - HTML documentation"
 	@echo "docclean       - Remove documentation build files"
 	@echo "upload         - upload a new release to PyPI"
-	@echo "website        - build web version of docs"
-	@echo "installwebsite - deploy web version of docs"
 	@echo "develop        - install development version"
 	@echo "test           - run the test suite"
 	@echo "test-quick     - run the test suite for bash and one version of Python ($(PYTHON26))"
-
+	@echo "website        - generate web version of the docs"
+	@echo "installwebsite - copy web version of HTML docs up to server"
 
 .PHONY: sdist
 sdist: html
@@ -34,9 +33,9 @@ docclean:
 website: 
 	[ ~/Devel/doughellmann/doughellmann/templates/base.html -nt docs/sphinx/web/templates/base.html ] && (echo "Updating base.html" ; cp ~/Devel/doughellmann/doughellmann/templates/base.html docs/sphinx/web/templates/base.html) || exit 0
 	rm -rf docs/website
-	(cd docs && $(MAKE) html BUILDING_WEB=1 BUILDDIR="website/en" LANGUAGE="en")
-	(cd docs && $(MAKE) html BUILDING_WEB=1 BUILDDIR="website/es" LANGUAGE="es")
-	(cd docs && $(MAKE) html BUILDING_WEB=1 BUILDDIR="website/ja" LANGUAGE="ja")
+	(cd docs && $(MAKE) html BUILDDIR="website/en" LANGUAGE="en")
+	(cd docs && $(MAKE) html BUILDDIR="website/es" LANGUAGE="es")
+	(cd docs && $(MAKE) html BUILDDIR="website/ja" LANGUAGE="ja")
 
 installwebsite: website
 	(cd docs/website/en && rsync --rsh=ssh --archive --delete --verbose . www.doughellmann.com:/var/www/doughellmann/DocumentRoot/docs/virtualenvwrapper/)

docs/en/history.rst

@@ -2,8 +2,14 @@
 Release History
 ===============
 
-Dev
+2.6.3
 
+  - Hard-code the version information in the setup.py and conf.py
+    scripts so it works for http://readthedocs.org.
+
+2.6.2
+
+  - Attempted to make the doc build work with http://readthedocs.org.
   - Merged in `Japanese translation of the documentation
     <http://www.doughellmann.com/docs/virtualenvwrapper/ja/>`__ from
     Tetsuya Morimoto.

docs/sphinx/conf.py

@@ -29,10 +29,7 @@
 bitbucket_project_url = 'http://bitbucket.org/dhellmann/virtualenvwrapper/'
 
 # Add any paths that contain templates here, relative to this directory.
-if building_web:
-    templates_path = ['web/templates']
-else:
-    templates_path = ['pkg/templates']
+#templates_path = ['pkg/templates']
 
 # The suffix of source filenames.
 source_suffix = '.rst'
@@ -45,15 +42,14 @@
 
 # General information about the project.
 project = u'virtualenvwrapper'
-copyright = u'2009, Doug Hellmann'
+copyright = u'2009-2011, Doug Hellmann'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-import virtualenvwrapper.version
-version = virtualenvwrapper.version.VERSION
+version = '2.6.3'
 # The full version, including alpha/beta/rc tags.
 release = version
 
@@ -99,10 +95,7 @@
 
 # The theme to use for HTML and HTML Help pages.  Major themes that come with
 # Sphinx are currently 'default' and 'sphinxdoc'.
-if building_web:
-    html_theme = 'default'
-else:
-    html_theme = 'sphinxdoc'
+html_theme = 'nature'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the

docs/sphinx/web/templates/base.html

@@ -1,9 +1,9 @@
 #!/usr/bin/env python
 
-import virtualenvwrapper.version
-
 PROJECT = 'virtualenvwrapper'
-VERSION = virtualenvwrapper.version.VERSION
+
+# Change docs/sphinx/conf.py too!
+VERSION = '2.6.3'
 
 # Bootstrap installation of Distribute
 import distribute_setup