gcloud skin for docs

docs/datastore-quickstart.rst → docs/_components/datastore-quickstart.rst

@@ -1,18 +1,8 @@
 Cloud Datastore in 10 seconds
-=============================
-
-.. note::
- This will use a **shared** dataset,
- which means any data you save
- will be available to anyone.
- If you want to create your own dataset,
- follow the
- (pretty simple)
- instructions in the
- :doc:`datastore-getting-started`.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Install the library
--------------------
+^^^^^^^^^^^^^^^^^^^
 
 The source code for the library
 (and demo code)
@@ -22,7 +12,7 @@ You can install the library quickly with ``pip``::
  $ pip install gcloud
 
 Run the demo
-------------
+^^^^^^^^^^^^
 
 In order to run the demo, you need to have registred an actual ``gcloud``
 project and so you'll need to provide some environment variables to facilitate
@@ -50,7 +40,7 @@ You just read and wrote a bunch of data
 to the Cloud Datastore.
 
 Try it yourself
----------------
+^^^^^^^^^^^^^^^
 
 You can interact with a demo dataset
 in a Python interactive shell.
@@ -81,12 +71,4 @@ you can create entities and save them::
  >>> dataset = datastore.get_dataset(
  >>> demo.DATASET_ID, demo.CLIENT_EMAIL, demo.PRIVATE_KEY_PATH)
 
-OK, that's it!
---------------
-
-Next,
-take a look at the :doc:`datastore-getting-started`
-to see how to create your own project and dataset.
-
-And you can always check out
-the :doc:`datastore-api`.
+----

docs/_components/getting-started.rst

@@ -0,0 +1,32 @@
+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
+
+----

docs/storage-quickstart.rst → docs/_components/storage-quickstart.rst

@@ -1,8 +1,8 @@
 Cloud Storage in 10 seconds
-===========================
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Install the library
--------------------
+^^^^^^^^^^^^^^^^^^^
 
 The source code for the library
 (and demo code)
@@ -12,7 +12,7 @@ You can install the library quickly with ``pip``::
  $ pip install gcloud
 
 Run the demo
-------------
+^^^^^^^^^^^^
 
 In order to run the demo, you need to have registred an actual ``gcloud``
 project and so you'll need to provide some environment variables to facilitate
@@ -41,7 +41,7 @@ a demonstration of using ``gcloud.storage``
 to read and write data to Google Cloud Storage.
 
 Try it yourself
----------------
+^^^^^^^^^^^^^^^
 
 You can interact with a demo dataset
 in a Python interactive shell.
@@ -79,8 +79,4 @@ you can create buckets and keys::
  >>> connection = storage.get_connection(
  >>> demo.PROJECT_NAME, demo.CLIENT_EMAIL, demo.PRIVATE_KEY_PATH)
 
-OK, that's it!
---------------
-
-And you can always check out
-the :doc:`storage-api`.
+----