Compress text with gzip.

Makefile

@@ -29,6 +29,7 @@ clean:
 
 html:
 	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	cp -f htaccess $(BUILDDIR)/html/.htaccess
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
 

conf.py

@@ -22,6 +22,7 @@
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named "sphinx.ext.*") or your custom ones.
 extensions = [
+    "ext.compress",
     "ext.feed",
     "ext.issuetracker",
     "ext.meta",
@@ -102,10 +103,7 @@
 #html_logo = None
 html_favicon = "favicon.ico"
 
-html_static_path = [
-    "_static",
-    "_static/.htaccess",
-]
+html_static_path = ["_static"]
 
 #html_last_updated_fmt = "%b %d, %Y"
 #html_show_sphinx = True

ext/compress.py

@@ -0,0 +1,25 @@
+import gzip
+import os.path
+
+EXTENSIONS = [".html", ".css", ".js"]
+
+def setup(app):
+    app.connect('build-finished', gzip_static_files)
+
+def visit_file(arg, d, paths):
+    for path in paths:
+        path = os.path.join(d, path)
+        if not os.path.isfile(path):
+            continue
+        if os.path.splitext(path)[-1] not in EXTENSIONS:
+            continue
+        gz_path = path + ".gz"
+        if os.path.isfile(gz_path):
+            if os.stat(path).st_mtime <= os.stat(gz_path).st_mtime:
+                continue
+        with open(path, "r") as f_in:
+            with gzip.open(gz_path, "w") as f_out:
+                f_out.write(f_in.read())
+
+def gzip_static_files(app, builder):
+    os.path.walk(app.builder.outdir, visit_file, None)

htaccess

@@ -0,0 +1,11 @@
+Header add Vary Accept-Encoding
+
+ExpiresActive on
+ExpiresDefault A604800
+ExpiresByType text/html A60
+
+RewriteEngine on
+RewriteCond %{HTTP:accept-encoding} gzip
+RewriteCond %{REQUEST_FILENAME} !\.gz$
+RewriteCond %{REQUEST_FILENAME}.gz -f
+RewriteRule (.*) $1.gz [L]