Set up Intersphinx so www can ref docs

1 files changed, 20 insertions, 5 deletions

diff --git a/sites/www/conf.py b/sites/www/conf.py
index c144b5b4..b2f96186 100644
--- a/sites/www/conf.py
+++ b/sites/www/conf.py
@@ -1,15 +1,30 @@
 # Obtain shared config values
-import os, sys
-sys.path.append(os.path.abspath('..'))
+import sys
+import os
+from os.path import abspath, join, dirname
+
+sys.path.append(abspath(join(dirname(__file__), '..')))
 from shared_conf import *
 
-# Add local blog extension
-sys.path.append(os.path.abspath('.'))
+# Local blog extension
+sys.path.append(abspath('.'))
 extensions = ['blog']
 rss_link = 'http://paramiko.org'
 rss_description = 'Paramiko project news'
 
-# Add Releases changelog extension
+# Releases changelog extension
 extensions.append('releases')
 releases_release_uri = "https://github.com/paramiko/paramiko/tree/%s"
 releases_issue_uri = "https://github.com/paramiko/paramiko/issues/%s"
+
+# Intersphinx for referencing API/usage docs
+extensions.append('sphinx.ext.intersphinx')
+# Default is 'local' building, but reference the public docs site when building
+# under RTD.
+target = join(dirname(__file__), '..', 'docs', '_build')
+if os.environ.get('READTHEDOCS') == 'True':
+    # TODO: switch to docs.paramiko.org post go-live
+    target = 'http://paramiko-docs.readthedocs.org/en/latest/'
+intersphinx_mapping = {
+    'docs': (target, None),
+}