From 7da628262ff6531f8fe05a68b09381a60a8e31cc Mon Sep 17 00:00:00 2001
From: Tres Seaver <tseaver@palladion.com>
Date: Thu, 15 Jan 2015 12:32:46 -0500
Subject: [PATCH] Pin 'Getting stared with gcloud' section on every page.

Make it togglable, like the node docs.

Fixes #553.
---
 docs/_components/getting-started.rst | 32 ------------
 docs/_templates/layout.html          | 77 ++++++++++++++++++++++++++++
 docs/index.rst                       |  6 ---
 3 files changed, 77 insertions(+), 38 deletions(-)
 delete mode 100644 docs/_components/getting-started.rst

diff --git a/docs/_components/getting-started.rst b/docs/_components/getting-started.rst
deleted file mode 100644
index 477504bce66d..000000000000
--- a/docs/_components/getting-started.rst
+++ /dev/null
@@ -1,32 +0,0 @@
-The ``gcloud`` library is ``pip`` install-able:
-
-.. code-block:: console
-
- 	$ pip install gcloud
-
-If you have trouble installing
-``pycrypto`` or ``pyopenssl``
-(and you're on Ubuntu),
-you can try install the precompiled packages:
-
-.. code-block:: console
-
-	$ sudo apt-get install python-crypto python-openssl
-
-If you want to install everything with ``pip``,
-try installing the ``dev`` packages beforehand:
-
-.. code-block:: console
-
-	$ sudo apt-get install python-dev libssl-dev
-
-If you want to install `gcloud-python` from source,
-you can clone the repository from GitHub:
-
-.. code-block:: console
-
-	$ git clone git://github.com/GoogleCloudPlatform/gcloud-python.git
-	$ cd gcloud-python
-	$ python setup.py install
-
-----
\ No newline at end of file
diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html
index 26b870d4ba22..0c0fae3218b1 100644
--- a/docs/_templates/layout.html
+++ b/docs/_templates/layout.html
@@ -106,6 +106,71 @@ <h1 class="page-title">Python</h1>
       </header>
                 
       <section class="content">
+        <div class="section" id="getting-started">
+          <h1>
+            <span id="getting-started-show">▹</span>
+            <span id="getting-started-hide" style="display: none">▿</span>
+              Getting started with 
+             <tt class="docutils literal"><span class="pre">gcloud</span></tt>
+          </h1>
+          <div id="getting-started-body" style="display: none">
+          <p>The
+             <tt class="docutils literal"><span class="pre">gcloud</span></tt>
+             library is
+             <tt class="docutils literal"><span class="pre">pip</span></tt>
+             install-able:
+          </p>
+
+          <div class="highlight-console">
+            <div class="highlight">
+              <pre>
+<span class="gp">$</span> pip install gcloud</pre>
+            </div>
+          </div>
+
+          <p>If you have trouble installing
+            <tt class="docutils literal"><span class="pre">pycrypto</span></tt>
+            or
+            <tt class="docutils literal"><span class="pre">pyopenssl</span></tt>
+            (and you&#8217;re on Ubuntu), you can try install the precompiled
+            packages:
+          </p>
+
+          <div class="highlight-console">
+            <div class="highlight">
+              <pre>
+<span class="gp">$</span> sudo apt-get install python-crypto python-openssl</pre>
+            </div>
+          </div>
+
+          <p>If you want to install everything with
+             <tt class="docutils literal"><span class="pre">pip</span></tt>,
+             try installing the
+             <tt class="docutils literal"><span class="pre">dev</span></tt>
+             packages beforehand:
+          </p>
+
+          <div class="highlight-console">
+           <div class="highlight">
+             <pre>
+<span class="gp">$</span> sudo apt-get install python-dev libssl-dev</pre>
+           </div>
+          </div>
+
+        <p>If you want to install <cite>gcloud-python</cite> from source,
+           you can clone the repository from GitHub:
+        </p>
+
+        <div class="highlight-console">
+          <div class="highlight">
+            <pre>
+<span class="gp">$</span> git clone git://github.com/GoogleCloudPlatform/gcloud-python.git
+<span class="gp">$</span> <span class="nb">cd </span>gcloud-python
+<span class="gp">$</span> python setup.py install</pre>
+          </div>
+        </div>
+        </div>
+
         {% block body %} {% endblock %}
       </section><!-- end of .content -->
       <nav class="side-nav">
@@ -143,6 +208,18 @@ <h1 class="page-title">Python</h1>
     <script src="{{ pathto('_static/js/vendor/jquery-1.10.2.min.js', 1) }}"></script>
     <script src="{{ pathto('_static/js/plugins.js', 1) }}"></script>
     <script src="{{ pathto('_static/js/main.js', 1) }}"></script>
+    <script>
+      $("#getting-started-hide").click(function() {
+        $("#getting-started-hide").hide();
+        $("#getting-started-show").show();
+        $("#getting-started-body").hide();
+      });
+      $("#getting-started-show").click(function() {
+        $("#getting-started-hide").show();
+        $("#getting-started-show").hide();
+        $("#getting-started-body").show();
+      });
+    </script>
   {% endblock %}
 
   {# Silence the footer #}
diff --git a/docs/index.rst b/docs/index.rst
index 56d1d7e4e3b3..ee2af6d15829 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -13,12 +13,6 @@
   storage-keys
   storage-acl
 
-
-Getting started
----------------
-
-.. include:: _components/getting-started.rst
-
 Cloud Datastore
 ~~~~~~~~~~~~~~~