Start fleshing out two-site setup

.gitignore

@@ -5,4 +5,5 @@ dist/
 paramiko.egg-info/
 test.log
 docs/
+!sites/docs
 _build

sites/docs/conf.py

@@ -0,0 +1,4 @@
+# Obtain shared config values
+import os, sys
+sys.path.append(os.path.abspath('..'))
+from shared_conf import *

sites/docs/index.rst

@@ -0,0 +1,6 @@
+Welcome to Paramiko's documentation!
+====================================
+
+This site covers Paramiko's usage & API documentation. For basic info on what
+Paramiko is, including its public changelog & how the project is maintained,
+please see `the main website <http://paramiko.org>`_.

sites/main/conf.py

@@ -0,0 +1,4 @@
+# Obtain shared config values
+import os, sys
+sys.path.append(os.path.abspath('..'))
+from shared_conf import *

sites/shared_conf.py

@@ -13,7 +13,8 @@ rss_description = 'Paramiko project news'
 
 # Alabaster theme
 html_theme_path = [alabaster.get_path()]
-html_static_path = ['_static']
+# Paths relative to invoking conf.py - not this shared file
+html_static_path = ['../_shared_static']
 html_theme = 'alabaster'
 html_theme_options = {
     'logo': 'logo.png',

tasks.py

@@ -6,15 +6,15 @@ from invocations import docs, testing
 api = Collection.from_module(docs)
 # TODO: maybe allow rolling configuration into it too heh
 api.configure({
-    'sphinx.source': 'api',
+    'sphinx.source': 'sites/docs',
-    'sphinx.target': 'api/_build',
+    'sphinx.target': 'sites/docs/_build',
 })
-api.name = 'api'
+api.name = 'docs'
-site = Collection.from_module(docs)
+main = Collection.from_module(docs)
-site.name = 'site'
+main.name = 'main'
-site.configure({
+main.configure({
-    'sphinx.source': 'site',
+    'sphinx.source': 'sites/main',
-    'sphinx.target': 'site/_build',
+    'sphinx.target': 'sites/main/_build',
 })
 
-ns = Collection(testing.test, api=api, site=site)
+ns = Collection(testing.test, docs=api, main=main)