Switch to alabaster sphinx theme in the docs

Feedback is welcome! :grinning: 
## Before with @kennethreitz's sphinx theme

![before_kr_sphinx_theme](https://cloud.githubusercontent.com/assets/954858/11584924/f6321290-9a1c-11e5-890c-11a20cf3ff8d.png)
## After with alabaster sphinx theme

![alabaster_theme_for_requests](https://cloud.githubusercontent.com/assets/954858/11672701/a4a17548-9dc7-11e5-8038-d2ca698b8aa9.png)


\o/ You are a :star: @onceuponatimeforever!

For posterity, this resolves #2779. Based on the quick screenshot provided above it looks like the only thing that gets lost here is that the Gumroad button isn't rendering out correctly.

@kennethreitz, you'll need to review this because the look of the site is an important part of your personal branding, but FWIW I'm :+1: and totally delighted about it.


Ok, so @onceuponatimeforever, Kenneth's concern about ad-tracking codes is well-founded, they _are_ missing. You can check this by opening up the index.html on the current website and on the newly rendered one, then using the browser debugging tools to inspect the top-level `<body>` tag. Both documents contain the `<div class="related">`, `<div class="document">`, and `<div class="footer">` content tags, which is great, but then the Alabaster version is missing a few things:
- Gumroad JS file: 
  
  ``` html
  <script type="text/javascript" src="https://gumroad.com/js/gumroad.js"></script>
  ```
- Flattr JS:
  
  ``` html
  <script type="text/javascript">
  /* <![CDATA[ */
      (function() {
          var s = document.createElement('script'), t = document.getElementsByTagName('script')[0];
          s.type = 'text/javascript';
          s.async = true;
          s.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';
          t.parentNode.insertBefore(s, t);
      })();
  /* ]]> */
  </script>
  ```
- CloudFront JS:
  
  ``` html
  <script type="text/javascript">
  setTimeout(function(){var a=document.createElement("script");
  var b=document.getElementsByTagName("script")[0];
  a.src=document.location.protocol+"//dnn506yrbagrg.cloudfront.net/pages/scripts/0013/7219.js?"+Math.floor(new Date().getTime()/3600000);
  a.async=true;a.type="text/javascript";b.parentNode.insertBefore(a,b)}, 1);
  </script>
  ```
- HelloBar:
  
  ``` html
  <script type="text/javascript">
      new HelloBar(36402,48802);
  </script>
  ```
- Google Analytics:
  
  ``` html
  <script type="text/javascript">
  
    var _gaq = _gaq || [];
    _gaq.push(['_setAccount', 'UA-8742933-11']);
    _gaq.push(['_setDomainName', 'none']);
    _gaq.push(['_setAllowLinker', true]);
    _gaq.push(['_trackPageview']);
  
    (function() {
      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
    })();
  
  </script>
  ```
- Gauges
  
  ``` html
  <script type="text/javascript">
    (function() {
      var t   = document.createElement('script');
      t.type  = 'text/javascript';
      t.async = true;
      t.id    = 'gauges-tracker';
      t.setAttribute('data-site-id',
                     '4ddc27f6613f5d186d000007');
      t.src = '//secure.gaug.es/track.js';
      var s = document.getElementsByTagName('script')[0];
      s.parentNode.insertBefore(t, s);
    })();
  </script>
  ```
- Perfect Audience
  
  ``` html
  <script type="text/javascript">
  (function() {
    window._pa = window._pa || {};
    _pa.productId = "requests-docs";
    var pa = document.createElement('script'); pa.type = 'text/javascript'; pa.async = true;
    pa.src = ('https:' == document.location.protocol ? 'https:' : 'http:') + "//tag.perfectaudience.com/serve/5226171f87bc6890da0000a0.js";
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(pa, s);
  })();
  </script>
  ```

These all need to get re-inserted back in. They previously all lived in the footer, and it should be possible to put them back into the Alabaster footer in some way.


@Lukasa: Thanks for spotting this problem! I've added back the pre-existing ad trackers in `/_templates/layout.html` (Click on "Files Changed" link at the top). [Reference](https://stackoverflow.com/questions/5585250/how-can-i-add-a-custom-footer-to-sphinx-documentation-restructuredtext)


Thanks @onceuponatimeforever! This looks good to me.

I'm going to sit on it to confirm that @kennethreitz is happy with it. (I'm confident he will be.)


I'm also very much :+1: on this (although I meant to say this sooner).


This looks fantastic! The only thing that needs changing is removing the "Powered by Sphinx and Alabaster" text at the bottom. 

You can do this with `show_powered_by=False`


We should also setup the GitHub banner! 

`github_banner=True`

(requires that you set `github_user` and `github_repo`)


I'll likely make a few more tweaks once this is up :) we may need some `!important` css to fix the sizing of the turtle/logo so everything is centered underneath it again. I also prefer the white-colored warnings of the existing theme, but these are all things that can be fixed once we merge, I think :)


My 2₵, the red warning boxes are better since they're intended to standout to users.


I knew you were going to say that ;)

I'd just like to find a way to make them a little less jarring.


> I knew you were going to say that ;)

=P 

> I'd just like to find a way to make them a little less jarring.

Sure, that I can agree with.


@kennethreitz so do you want to fix these concerns up first or merge and then fix these up?


The `show_powered_by` is already added in the sphinx code. And so is the github banner. ~~I'll set the `'github_user': 'kennethreitz','github_repo': 'requests',` to display the github banner shortly.~~ 

Update: OK, screenshot updated!


@kennethreitz thoughts?


I would prefer to have the positioning/sizing of the turtle/logo fixed before we deploy this, if it's possible ;)


but other than that, :thumbsup: :thumbsup: :thumbsup:


I don't see the turtle logo being different than before, no css changes have been added on it in the new theme.


@onceuponatimeforever I think what @kennethreitz wants is for the column beneath it to be aligned with the `R` in `Requests` under the turtle logo. (At least that's roughly what it looks like where it was from the before picture)


I think a `margin-left: -20px;` or so would do it, on the logo. 


:sparkles: :cake: :sparkles: