Metadata-Version: 2.0
Name: PyLucid
Version: 3.0.0.dev9
Summary: PyLucid CMS
Home-page: http://www.pylucid.org
Author: Jens Diemer
Author-email: pylucid@jensdiemer.de
License: UNKNOWN
Download-URL: http://www.pylucid.org/en/download/
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Topic :: Database :: Front-Ends
Classifier: Topic :: Documentation
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Classifier: Operating System :: OS Independent

=============
about PyLucid
=============

PyLucid is an Open Source web content management system written in Python using Django-CMS.

It's more a alternative for `djangocms-installer <https://github.com/nephila/djangocms-installer>`_

The goal is to simplify the Django-CMS setup.

**The current 'develop' branch is a rewrite and currently not useable!**

You should not use PyLucid in production, until v3.x is used on `pylucid.org <http://www.pylucid.org>`_ ;)

Try, fork and contribute! ;)

+--------------------------------------+---------------------------------------------------+
| |Coverage Status on coveralls.io|    | `coveralls.io/r/jedie/PyLucid`_                   |
+--------------------------------------+---------------------------------------------------+
| |Build Status on travis-ci.org|      | `travis-ci.org/jedie/PyLucid`_                    |
+--------------------------------------+---------------------------------------------------+
| |Requirements Status on requires.io| | `requires.io/github/jedie/PyLucid/requirements/`_ |
+--------------------------------------+---------------------------------------------------+

.. |Coverage Status on coveralls.io| image:: https://s3.amazonaws.com/assets.coveralls.io/badges/coveralls_64.svg?branch=master
.. _coveralls.io/r/jedie/PyLucid: https://coveralls.io/r/jedie/PyLucid
.. |Build Status on travis-ci.org| image:: https://travis-ci.org/jedie/PyLucid.svg?branch=master
.. _travis-ci.org/jedie/PyLucid: https://travis-ci.org/jedie/PyLucid/
.. |Requirements Status on requires.io| image:: https://requires.io/github/jedie/PyLucid/requirements.svg?branch=master
.. _requires.io/github/jedie/PyLucid/requirements/: https://requires.io/github/jedie/PyLucid/requirements/

-------
install
-------

bootstrap PyLucid virtualenv
============================

::

    # download bootstrap file:
    /home/FooBar$ wget https://github.com/jedie/PyLucid/raw/develop/pylucid/pylucid_boot.py

    # Create virtualenv with all needed packages:
    /home/FooBar$ python3 pylucid_boot.py boot_normal ~/PyLucid-env

Note: pylucid_boot.py is a interactive shell with command completion.
You can just start it and do this:

::

    /home/FooBar$ python3 pylucid_boot.py
    We are not in a virtualenv, ok.

    pylucid_boot.py shell v0.0.1

    pylucid_boot.py> boot_normal ~/PyLucid-env

Type help or ? to list commands:

::

    pylucid_boot.py> ?

    Hint: All commands can be called directly from commandline.
    e.g.: $ ./pylucid_boot.py pip_freeze

    Use <tab> to command completion.

    Documented commands (type help <topic>):
    ========================================
    boot_ci  boot_developer  boot_normal  help  quit

use a created PyLucid virtualenv
================================

::

    # Go into created virtualenv:
    /home/FooBar$ cd ~/PyLucid-env

    # activate the env:
    ~/PyLucid-env $ source bin/activate

    # Use the commandline admin
    (PyLucid-env) ~/PyLucid-env $ pylucid_admin

The **pylucid_admin** is a interactive shell with command completion, e.g.:

::

    (PyLucid_env) ~/PyLucid_env $ pylucid_admin
    Activated virtualenv detected: '/home/foobar/PyLucid-env' (/home/foobar/PyLucid-env/bin/python3)

    pylucid_admin.py shell v0.0.1
    Type help or ? to list commands.

    pylucid_admin.py> ?

    Hint: All commands can be called directly from commandline.
    e.g.: $ ./pylucid_admin.py pip_freeze

    Use <tab> to command completion.

    Documented commands (type help <topic>):
    ========================================
    help                pip_freeze  quit        upgrade_requirements
    insert_requirement  pytest      update_env

tbd.

-----------------------------------
External applications configuration
-----------------------------------

Dependency applications may need configuration to work properly.

Please, refer to each application documentation on details.

* djangocms-blog: `https://djangocms-blog.readthedocs.io/en/latest/installation.html#minimal-configuration <https://djangocms-blog.readthedocs.io/en/latest/installation.html#minimal-configuration>`_

* django-filer: `https://django-filer.readthedocs.io <https://django-filer.readthedocs.io>`_

* django-meta: `https://github.com/nephila/django-meta#installation <https://github.com/nephila/django-meta#installation>`_

* django-meta-mixin: `https://github.com/nephila/django-meta-mixin#installation <https://github.com/nephila/django-meta-mixin#installation>`_

* django-parler: `https://django-parler.readthedocs.io/en/latest/quickstart.html#configuration <https://django-parler.readthedocs.io/en/latest/quickstart.html#configuration>`_

* django-taggit-autosuggest: `https://bitbucket.org/fabian/django-taggit-autosuggest <https://bitbucket.org/fabian/django-taggit-autosuggest>`_

* aldryn-search: `https://github.com/aldryn/aldryn-search#usage <https://github.com/aldryn/aldryn-search#usage>`_

* haystack: `http://django-haystack.readthedocs.io/en/stable/ <http://django-haystack.readthedocs.io/en/stable/>`_

-----------------
Compatible Matrix
-----------------

+---------+------------+-----------+----------+
| PyLucid | Django-CMS | Django    | Python   |
+---------+------------+-----------+----------+
| V3      | V3.4       | V1.11 LTS | 3.5, 3.6 |
+---------+------------+-----------+----------+
| v2.1    | v3.3       | v1.8 LTS  | 3.4, 3.5 |
+---------+------------+-----------+----------+
| v2.0    | v3.2       | v1.8 LTS  | 3.4, 3.5 |
+---------+------------+-----------+----------+
| <=v1.6  | -          | v1.6      | 2.6, 2.7 |
+---------+------------+-----------+----------+

---------------
Release History
---------------

* v3 **dev** not released, yet

    * rewrite and use Django-CMS v3.4.x LTS, Django v1.11 LTS

* `12.Sep.2016 - v2.1.2 <https://github.com/jedie/PyLucid/compare/v2.1.1...v2.1.2>`_:

    * Changed to official `https://pypi.org/project/djangocms-htmlsitemap/ <https://pypi.org/project/djangocms-htmlsitemap/>`_ PyPi Package.

* `04.Sep.2016 - v2.1.1 <https://github.com/jedie/PyLucid/compare/v2.1.0.beta.0...v2.1.1>`_:

    * Update: pillow, django-debug-toolbar, django-compressor, sqlparse

* `v2.1.0.beta.0 <https://github.com/jedie/PyLucid/compare/old/v2.0.x...v2.1.0.beta.0>`_:

    * switch from django-cms v3.2 to v3.3

    * move from `cmsplugin-htmlsitemap <https://github.com/raphaa/cmsplugin-htmlsitemap>`_ to `djangocms-htmlsitemap <https://github.com/kapt-labs/djangocms-htmlsitemap/>`_ 

        * WARNING: A migration will not be done! You have to migrate by hand and delete the database table *cmsplugin_htmlsitemap_htmlsitemap* ;)

* `28.Dec.2015 - v2.0.x beta <https://github.com/jedie/PyLucid/compare/old/v1.6.x...old/v2.0.x>`_:

    * rewrite to use Django-CMS

* `12.Feb.2015 - v1.6.x <https://github.com/jedie/PyLucid/compare/old/v1.5.x...old/v1.6.x>`_:

    * v1.6.x is the last PyLucid release that doesn't based on Django-CMS

    * switch from django 1.4 to 1.6

* `18.Jun.2012 - v1.0.x <https://github.com/jedie/PyLucid/compare/old/v0.x...old/v1.0.x>`_:

    * switch from django 1.3 to 1.4

* `22.Sep.2007 - v0.8.0.beta <https://github.com/jedie/PyLucid/tree/626cc139f8cc162ce2338d62718064533dcf2cc2>`_:

    * PyLucid.org used the first v0.8 Beta Version who used django

* `21.Apr.2005 - v0.0.1 <https://github.com/jedie/PyLucid/tree/9680c2611912ef06c33b1a4a92ea62654a7b8fb1>`_:

    * first Version, only CGI script ListOfNewSides for lucidCMS (PHP based)

(Not all old releases are listed.)

For older PyLucid history, look at:

* `http://www.pylucid.org/permalink/30/development-history#genesis <http://www.pylucid.org/permalink/30/development-history#genesis>`_

========
donation
========

* `paypal.me/JensDiemer <https://www.paypal.me/JensDiemer>`_

* `Flattr This! <https://flattr.com/submit/auto?uid=jedie&url=https%3A%2F%2Fgithub.com%2Fjedie%2FPyLucid%2F>`_

* Send `Bitcoins <http://www.bitcoin.org/>`_ to `1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F <https://blockexplorer.com/address/1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F>`_

=====
links
=====

+----------------------+------------------------------+
| Homepage             | `http://www.pylucid.org`_    |
+----------------------+------------------------------+
| Sourcecode @ GitHub  | `github.com/jedie/PyLucid`_  |
+----------------------+------------------------------+
| Python Package Index | `pypi.org/project/PyLucid/`_ |
+----------------------+------------------------------+
| IRC                  | `#pylucid on freenode.net`_  |
+----------------------+------------------------------+

.. _http://www.pylucid.org: http://www.pylucid.org
.. _github.com/jedie/PyLucid: https://github.com/jedie/PyLucid
.. _pypi.org/project/PyLucid/: https://pypi.org/project/PyLucid/
.. _#pylucid on freenode.net: http://www.pylucid.org/permalink/304/irc-channel

