Start fleshing out two-site setup

beckjake · Jan 22, 2014 · ccb7a6c · ccb7a6c
1 parent 7d56ecb
commit ccb7a6c
Show file tree

Hide file tree

Showing 16 changed files with 26 additions and 10 deletions.
diff --git a/.gitignore b/.gitignore
@@ -5,4 +5,5 @@ dist/
 paramiko.egg-info/
 test.log
 docs/
+!sites/docs
 _build
diff --git a/site/_static/logo.png → sites/_shared_static/logo.png b/site/_static/logo.png → sites/_shared_static/logo.png
diff --git a/sites/docs/conf.py b/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 *
diff --git a/sites/docs/index.rst b/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>`_.
diff --git a/site/_templates/rss.xml → sites/main/_templates/rss.xml b/site/_templates/rss.xml → sites/main/_templates/rss.xml
diff --git a/site/blog.py → sites/main/blog.py b/site/blog.py → sites/main/blog.py
diff --git a/site/blog.rst → sites/main/blog.rst b/site/blog.rst → sites/main/blog.rst
diff --git a/site/blog/first-post.rst → sites/main/blog/first-post.rst b/site/blog/first-post.rst → sites/main/blog/first-post.rst
diff --git a/site/blog/second-post.rst → sites/main/blog/second-post.rst b/site/blog/second-post.rst → sites/main/blog/second-post.rst
diff --git a/sites/main/conf.py b/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 *
diff --git a/site/contact.rst → sites/main/contact.rst b/site/contact.rst → sites/main/contact.rst
diff --git a/site/contributing.rst → sites/main/contributing.rst b/site/contributing.rst → sites/main/contributing.rst
diff --git a/site/index.rst → sites/main/index.rst b/site/index.rst → sites/main/index.rst
diff --git a/site/installing.rst → sites/main/installing.rst b/site/installing.rst → sites/main/installing.rst
diff --git a/site/conf.py → sites/shared_conf.py b/site/conf.py → sites/shared_conf.py
@@ -13,7 +13,8 @@
 
 # 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',

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