Merge pull request #200 from shabda/master

Linked various documentation files and fixed some settings for readthedocs

.gitignore

@@ -27,6 +27,7 @@ tmp*
 *egg-info*
 .coverage
 *.tmpl
+_build/
 
 example/idp3/htdocs/login.mako
 

README

@@ -1,45 +0,0 @@
-README for PySAML2
-==================
-
-Dependencies
-------------
-PySAML2 should be compatible with any python >= 2.6 not 3.X yet.
-
-Install
--------
-You will need xmlsec1 to be able to sign/verify, encrypt/decrypt.
-You can find xmlsec1 here:
-
-    http://www.aleksey.com/xmlsec/
-
-Apart from that a normal
-    
-    python setup.py install
-
-will install the package.
-
-Documentation
--------------
-Look in the doc/ subdirectory.
-
-Comments, support, bug reports
-------------------------------
-
-Project page on : 
-
-https://github.com/rohe/pysaml2
-
-Use the Pysaml2@uma.es mailing list. Bug reports can either be emailed
-to this mailing list of added to the github repository
-https://github.com/rohe/pysaml2.
-
-You can subscribe to this mailing list at
-http://delfos.sci.uma.es/mailman/listinfo/pysaml2
-
-Archives are available at 
-http://delfos.sci.uma.es/mailman/private/pysaml2/
-
-Contributors
-------------
-* Roland Hedberg: main author / maintainer
-* Lorenzo Gil Sanchez: Django integration

doc/conf.py

@@ -91,7 +91,12 @@ pygments_style = 'sphinx'
 
 # The theme to use for HTML and HTML Help pages.  Major themes that come with
 # Sphinx are currently 'default' and 'sphinxdoc'.
-html_theme = 'default'
+html_theme = 'alabaster'
+on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
+
+if on_rtd:  # only import and set the theme if we're building docs locally
+    html_theme = 'sphinx_rtd_theme'
+
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the

doc/contents.rst

@@ -1,16 +0,0 @@
-Contents
-========
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-
-.. toctree::
-   :maxdepth: 4
-
-   code/s2repoze
-   code/saml2
-   code/xmldsig
-   code/xmlenc
-
-

doc/index.rst

@@ -1,11 +1,24 @@
-.. _howto:
+:Release: |release|
+:Date: |today|
+
+About SAML 2.0
+==============
+
+SAML 2.0 or Security Assertion Markup Language 2.0 is a version of the SAML standard for exchanging authentication and authorization data between security domains.
+
+About PySAML2
+=============
+
+PySAML2 is a pure python implementation of SAML2. It contains all
+necessary pieces for building a SAML2 service provider or an identity provider.
+The distribution contains examples of both.
+Originally written to work in a WSGI environment there are extensions that
+allow you to use it with other frameworks.
+
 
 How to use PySAML2
 ===================
 
-:Release: |release|
-:Date: |today|
-
 Before you can use Pysaml2, you'll need to get it installed.
 If you have not done it yet, read the :ref:`install`
 
@@ -32,9 +45,20 @@ So you will find descriptions of both cases here.
 The configuration is the same disregarding whether you are using PySAML2 in a
 WSGI or non-WSGI environment.
 
+Table of contents
+==================
+
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
 
-   config
+   install
+   examples/index
+   howto/index
+   sp_test/internal
 
 
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
+

doc/metadata.rst

@@ -1,18 +0,0 @@
-.. _metadata:
-
-***************************************************
-Base classes representing Saml2.0 MetaData elements
-***************************************************
-
-:Author: Roland Hedberg
-:Version: |version|
-
-.. module:: MetaData
-   :synopsis: Base classes representing Saml2.0 metadata elements.
-   
-Module
-==========
-
-.. automodule:: saml2.metadata
-   :members: 
-