Puput
=====

.. image:: https://img.shields.io/pypi/v/puput.svg
    :target: https://pypi.python.org/pypi/puput/

.. image:: https://readthedocs.org/projects/puput/badge/?version=latest
    :target: https://readthedocs.org/projects/puput/?badge=latest

.. image:: https://img.shields.io/pypi/pyversions/puput.svg
    :target: https://pypi.org/project/puput/

.. image:: https://img.shields.io/pypi/djversions/puput.svg
    :target: https://pypi.org/project/puput/
   
Puput is a powerful and simple Django app to manage a blog. It uses the awesome `Wagtail CMS <https://github.com/torchbox/wagtail>`_ as content management system.

Puput is the catalan name for `Hoopoe <https://en.wikipedia.org/wiki/Hoopoe>`_ which is indeed a beautiful bird.

.. image:: http://i.imgur.com/3ByGQb6.png

Visit the `documentation <http://puput.readthedocs.org>`_ for an in-depth look at Puput.

Features
~~~~~~~~

* Built with Wagtail CMS and Django
* Inspired in Wordpress and Zinnia
* Simple & responsive HTML template by default
* SEO friendly urls
* Support for Disqus comments
* Entries by author, tags, categories, archives and search term
* Last & popular entries
* Configurable sidebar widgets
* RSS feeds
* Related entries
* Extensible entry model
* Configurable default template color
* Social share of blog entries (Facebook, Twitter and LinkedIn)
* Markdown fields (https://github.com/torchbox/wagtail-markdown)


.. image:: http://i.imgur.com/d13sGI3.png

Examples of blog sites made with Puput
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* `Open Study Room <https://openstudyroom.org/blog/>`_
* `APSL <https://www.apsl.net/blog/>`_
* `Nautic Advisor <https://www.nauticadvisor.com/blog/>`_
* `Trespams <http://trespams.com/blog/>`_
* `Body Therapy <http://bodytherapy.ru/blog/>`_
* `Astro <http://www.mallorcasoft.es/blog/>`_
* `IP/DE <https://ipde.com/>`_

Setup
~~~~~

The setup process is explained `here <http://puput.readthedocs.io/en/latest/setup.html>`_.

Related repositories
~~~~~~~~~~~~~~~~~~~~
* `wordpress-to-puput <https://github.com/APSL/wordpress-to-puput/>`_: Import your Wordpress blog data into Puput.
* `blogger-to-puput <https://github.com/APSL/blogger-to-puput/>`_: Import your Blogger blog data into Puput.
* `zinnia-to-puput <https://github.com/APSL/zinnia-to-puput/>`_:  Import your Zinnia blog data into Puput.   
* `docker-puput <https://github.com/APSL/docker-puput/>`_:  Docker image for Puput blog.
* `puput-demo <https://github.com/APSL/puput-demo/>`_: An example of blog Django app using Puput.
* `divio-wagtail-puput <https://github.com/divio/divio-wagtail-puput/>`_: A Divio Cloud addon to install the Wagtail Puput weblog.