Simplified Python description, reverted long README.

README.rst

@@ -1,17 +1,129 @@
 ABlog for Sphinx
 ================
 
-A Sphinx extension that converts any documentation or personal website project 
+ABlog is a Sphinx extension that converts any documentation or personal
-into a full-fledged blog. See http://ablog.readthedocs.org for details.
+website project into a full-fledged blog with:
 
-.. image:: https://secure.travis-ci.org/abakan/ablog.png?branch=devel
+  * `Atom feeds`_
-   :target: http://travis-ci.org/#!/abakan/ablog
+  * `Archive pages`_
+  * `Blog sidebars`_
+  * `Disqus integration`_
+  * `Font-Awesome integration`_
+  * `Easy GitHub Pages deploys`_
 
-.. image:: https://pypip.in/v/ABlog/badge.png
+.. _Atom feeds: http://ablog.readthedocs.org/blog/atom.xml
-   :target: https://pypi.python.org/pypi/ABlog
+.. _Archive pages: http://ablog.readthedocs.org/blog/
+.. _Blog sidebars: http://ablog.readthedocs.org/manual/ablog-configuration-options/#sidebars
+.. _Disqus integration: http://ablog.readthedocs.org/manual/ablog-configuration-options/#disqus-integration
+.. _Font-Awesome integration: http://ablog.readthedocs.org/manual/ablog-configuration-options/#fa
+.. _Easy GitHub Pages deploys: http://ablog.readthedocs.org/manual/deploy-to-github-pages/
 
-.. image:: https://pypip.in/d/ABlog/badge.png
+.. _installation:
-   :target: https://crate.io/packages/ablog
 
-.. image:: https://readthedocs.org/projects/ablog/badge/?version=latest
+Installation
-   :target: http://ablog.readthedocs.org/
+------------
+
+You can install ABlog using pip_::
+
+    pip install -U ablog
+
+This will also install `Sphinx <http://sphinx-doc.org/>`_, Alabaster_,
+Werkzeug_, and Invoke_ respectively required for building your website,
+making it look good, generating feeds, and running deploy commands.
+
+.. _pip: https://pip.pypa.io
+.. _Werkzeug: http://werkzeug.pocoo.org/
+.. _Alabaster: https://github.com/bitprophet/alabaster
+.. _Invoke: http://www.pyinvoke.org/
+
+
+Getting Started
+---------------
+
+If you are starting a new project, see `ABlog Quick Start`_ guide.
+
+If you already have a project, enable blogging by making following changes in ``conf.py``:
+
+.. code-block:: python
+
+  # 1. Add 'ablog' to list of extensions
+  extensions = [
+      '...',
+      'ablog'
+  ]
+
+  # 2. Add ablog templates path
+  import ablog
+
+  # 2a. if `templates_path` is not defined
+  templates_path = [ablog.get_html_templates_path()]
+
+  # 2b. if `templates_path` is defined
+  templates_path.append(ablog.get_html_templates_path())
+
+.. _ABlog Quick Start: http://ablog.readthedocs.org/manual/ablog-quick-start
+
+
+How it works
+------------
+
+If you are new to Sphinx_ and reStructuredText markup language,
+you might find `reStructuredText Primer`_ useful. Once you have
+content (in ``.rst`` files), you can post *any page* using the
+``post`` directive as follows:
+
+.. code-block:: rst
+
+  .. post:: Apr 15, 2014
+     :tags: earth, love, peace
+     :category: python
+     :author: me
+     :location: SF
+     :language: en
+
+ABlog will index all files posted as above and list them in archives and feeds
+specified in ``:tag:``, ``:category:``, etc. options.
+
+You can also include a list of posts using ``postlist`` directive:
+
+.. code-block:: rst
+
+  .. postlist::
+     :list-style: circle
+     :category: Manual
+     :format: {title}
+     :sort:
+
+For ABlog documentation, this converts to the following where you
+can find more about configuring and using ABlog:
+
+.. postlist::
+   :category: Manual
+   :list-style: circle
+   :format: {title}
+   :sort:
+
+
+.. _reStructuredText Primer: http://sphinx-doc.org/rest.html
+
+
+.. only:: html
+
+   .. image:: https://secure.travis-ci.org/abakan/ablog.png?branch=devel
+      :target: http://travis-ci.org/#!/abakan/ablog
+
+   .. image:: https://pypip.in/v/ABlog/badge.png
+      :target: https://pypi.python.org/pypi/ABlog
+
+   .. image:: https://pypip.in/d/ABlog/badge.png
+      :target: https://crate.io/packages/ablog
+
+   .. image:: https://readthedocs.org/projects/ablog/badge/?version=latest
+      :target: http://ablog.readthedocs.org/
+
+
+.. toctree::
+   :hidden:
+   :glob:
+
+   */*

setup.py

@@ -3,12 +3,29 @@ from setuptools import setup
 
 __version__ = ''
 with open('ablog/__init__.py') as inp:
-  for line in inp:
+    for line in inp:
-      if (line.startswith('__version__')):
+        if (line.startswith('__version__')):
-          exec(line.strip())
+            exec(line.strip())
-          break
+            break
-with open('README.rst') as inp:
+long_description = '''
-    long_description = inp.read()
+ABlog for Sphinx
+================
+
+A Sphinx extension that converts any documentation or personal website project 
+into a full-fledged blog. See http://ablog.readthedocs.org for details.
+
+.. image:: https://secure.travis-ci.org/abakan/ablog.png?branch=devel
+   :target: http://travis-ci.org/#!/abakan/ablog
+
+.. image:: https://pypip.in/v/ABlog/badge.png
+   :target: https://pypi.python.org/pypi/ABlog
+
+.. image:: https://pypip.in/d/ABlog/badge.png
+   :target: https://crate.io/packages/ablog
+
+.. image:: https://readthedocs.org/projects/ablog/badge/?version=latest
+   :target: http://ablog.readthedocs.org/
+'''
 
 setup(
     name='ablog',
@@ -20,22 +37,23 @@ setup(
     url='http://ablog.readthedocs.org/',
     packages=['ablog'],
     package_dir={'ablog': 'ablog'},
-    package_data={'ablog': ['templates/*.html',
+    package_data={'ablog': [
-                            'locale/sphinx.pot',
+        'templates/*.html',
-                            'locale/*/LC_MESSAGES/sphinx.*o']},
+        'locale/sphinx.pot',
+        'locale/*/LC_MESSAGES/sphinx.*o']},
     license='MIT License',
     keywords=('Sphinx, extension, blogging, atom feeds'),
     classifiers=[
-                 'Development Status :: 3 - Alpha',
+        'Development Status :: 3 - Alpha',
-                 'Topic :: Software Development :: Documentation',
+        'Topic :: Software Development :: Documentation',
-                 'License :: OSI Approved :: MIT License',
+        'License :: OSI Approved :: MIT License',
-                 'Operating System :: MacOS',
+        'Operating System :: MacOS',
-                 'Operating System :: Microsoft :: Windows',
+        'Operating System :: Microsoft :: Windows',
-                 'Operating System :: POSIX',
+        'Operating System :: POSIX',
-                 'Programming Language :: Python',
+        'Programming Language :: Python',
-                 'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2',
-                 'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3',
-                ],
+        ],
     provides=['ablog ({0:s})'.format(__version__)],
     install_requires=['Werkzeug', 'Sphinx', 'alabaster', 'invoke'],
     message_extractors={