Metadata-Version: 2.0
Name: PyLucid
Version: 1.6.1
Summary: PyLucid is an open-source web content management system (CMS) using django.
Home-page: http://www.pylucid.org
Author: Jens Diemer
Author-email: UNKNOWN
License: UNKNOWN
Download-URL: http://www.pylucid.org/en/download/
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Programming Language :: Python
Classifier: Programming Language :: JavaScript
Classifier: Framework :: Django
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
Requires-Dist: feedparser (>=5.1.3,<5.2)
Requires-Dist: Pygments (>=1.6,<1.7)
Requires-Dist: flup (<1.1)
Requires-Dist: django-reversion (<1.9)
Requires-Dist: django-dbtemplates (>=1.3,<1.4)
Requires-Dist: django-compressor (>=1.3,<1.4)
Requires-Dist: django-tagging (==0.3.4)
Requires-Dist: South (<1.1)
Requires-Dist: Django (>=1.6,<1.7)
Requires-Dist: python-creole (>=1.1.1)
Requires-Dist: django-dbpreferences (>=0.5.0,<0.6)
Requires-Dist: django-tools (<0.30)
Requires-Dist: django-processinfo (>=0.7)
Requires-Dist: django-reversion-compare (>=0.4.0)

**Note:**
This is the `Old v1.x branch <https://github.com/jedie/PyLucid/tree/old_v1>`_.
Current development is on `django-cms branch <https://github.com/jedie/PyLucid/tree/django-cms>`_!

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

PyLucid is an Open Source web content management system written in Python using `Django, jQuery and many more external software... <http://www.pylucid.org/permalink/41/dependencies-and-copyrights>`_

Some PyLucid Features are:

* Open Source (GPL v3 or later)

* `fully customizable output <http://www.pylucid.org/permalink/69/customise-PyLucid/>`_ 

    * templates/styles/JS code online editable with CodeMirror highlighting

    * compress styles/JS code via `Django-Compressor <https://github.com/jezdez/django_compressor>`_

    * `easy overwrite templates <http://www.pylucid.org/permalink/279/how-to-change-a-plugin-template>`_

* `Multi site support <http://www.pylucid.org/permalink/343/howto-add-new-sites>`_ (Allows a single installation to serve multiple websites.)

* internationalization and localization support (Multilingual content)

* Revision controlled content with `django-reversion <http://github.com/etianen/django-reversion>`_ and include `django-reversion-compare <https://github.com/jedie/django-reversion-compare>`_ for comparing two versions.

* markup support: Creole, textile, markdown, ReStructuredText

* `markup converter <http://www.pylucid.org/permalink/419/how-to-convert-the-pagecontent-markup>`_

* expandable with plugins

* `many built-in plugins <http://www.pylucid.org/permalink/90/about-the-built-in-plugins>`_:

    * `secure JS-SHA Login <http://www.pylucid.org/permalink/42/secure-login-without-https>`_ with `a honypot <http://www.pylucid.org/permalink/320/the-auth-plugin-js-sha1-login#honypot>`_

    * content:

        * `weblog <http://www.pylucid.org/permalink/141/blog>`_ (Complete blogging solution)

        * `comments / guestbook <http://www.pylucid.org/permalink/351/the-comments-plugin-also-usefull-as-guestbook>`_ (comments for pages, blog articles, lexicon entries)

        * `StreetMap <http://www.pylucid.org/permalink/295/the-streetmap-plugin>`_ (insert OpenStreetmap / GoogleMaps)

        * `lexicon <http://www.pylucid.org/permalink/301/the-lexicon-plugin>`_ (explane words in content)

        * `poll <http://www.pylucid.org/permalink/375/poll>`_

        * `RSS <http://www.pylucid.org/permalink/123/includes-rss-newsfeeds>`_ (include external feeds into a page)

        * `source code <http://www.pylucid.org/permalink/309/highlight-source-code>`_ (highlight source code into content)

        * `include <http://www.pylucid.org/permalink/381/about-the-include-plugin>`_ local/remote file content into page

        * `simple picture gallery <http://www.pylucid.org/permalink/340/pylucid-screenshots>`_

    * navigation:

        * basics: main menu (split able), sub menu and sitemap

        * `search engine <http://www.pylucid.org/permalink/43/about-pylucid-integrated-search-engine>`_ (search in page content, blog articles, lexicon entries)

        * `update journal <http://www.pylucid.org/permalink/311/the-update-journal-plugin>`_ (List of all page updates)

        * `page tag based navigation <http://www.pylucid.org/permalink/131/the-tag-navigation-plugin>`_

        * `breadcrumb <http://www.pylucid.org/permalink/294/the-breadcrumb-plugin>`_

        * `Table of contens <http://www.pylucid.org/permalink/303/table-of-contens-plugin>`_ (TOC from page headlines)

        * `Generic widgets <http://www.pylucid.org/permalink/360/include-external-widgets-with-generic-plugin>`_

    * content helpers:

        * `A Filemanager <http://www.pylucid.org/permalink/128/the-filemanager-plugin>`_

        * `bulk editor <http://www.pylucid.org/permalink/357/bulk_editor>`_

        * `find and replace <http://www.pylucid.org/permalink/129/the-find-and-replace-plugin>`_ (replace strings different contents)

        * translation dialogue, used google translation service (optional)

* hierarchy tree page organization

* support many database engines (PostgreSQL, MySQL, Oracle and SQLite)

* WSGI conform: `fastCGI, mod_WSGI and CGI (only for debugging) and others <http://www.pylucid.org/permalink/136/change-between-fastcgi-mod_wsgi-and-cgi>`_

* and many more features... :)

=======
install
=======

(Please read `the complete installation instructions <http://www.pylucid.org/permalink/70/how-to-install-pylucid>`_.)

To create a `PyLucid virtual environment <http://www.pylucid.org/permalink/135/install-pylucid-in-a-virtual-environment>`_, use our bootstrap script:

::

    /home/FooBar$ wget https://raw.github.com/jedie/PyLucid/old_v1/bootstrap/pylucid-boot.py -O pylucid1-boot.py
    /home/FooBar$ python2 pylucid1-boot.py PyLucid1_py2_env

`create a new page instance <http://www.pylucid.org/permalink/355/1a2-create-a-new-page-instance>`_:

::

    /home/FooBar$ cd PyLucid1_py2_env
    /home/FooBar/PyLucid1_py2_env$ ./create_page_instance.sh /var/www/YourSite

Setup a page instance:

::

    ~$ cd /var/www/YourSite

    # create all database tables (without creating a superuser at this time):
    /var/www/YourSite$ ./manage.py syncdb --all --noinput

    # Do faked south migrations
    /var/www/YourSite$ ./manage.py migrate --fake

    # Create a superuser:
    /var/www/YourSite$ ./manage.py createsuperuser

    # Load PyLucid base data into database:
    /var/www/YourSite$ ./manage.py loaddata pylucid.json

    # create initial revisions
    /var/www/YourSite$ ./manage.py createinitialrevisions

    # collect all static files as links
    /var/www/YourSite$ ./manage.py collectstatic

    # start local development server
    /var/www/YourSite$ ./manage.py runserver

After run our script you have these files/directory:

+-------------------------------------------+------------------------------------------------------------+
| */var/www/YourSite*/**media**/            | Static media files                                         |
+-------------------------------------------+------------------------------------------------------------+
| */var/www/YourSite*/**index.fcgi**        | fastCGI dispatcher file                                    |
+-------------------------------------------+------------------------------------------------------------+
| */var/www/YourSite*/**index.wsgi**        | mod_WSGI dispatcher file                                   |
+-------------------------------------------+------------------------------------------------------------+
| */var/www/YourSite*/**index.cgi**         | CGI handler, should only used for debugging                |
+-------------------------------------------+------------------------------------------------------------+
| */var/www/YourSite*/**local_settings.py** | `your own settings`_                                       |
+-------------------------------------------+------------------------------------------------------------+
| */var/www/YourSite*/**manage.py**         | Access to django cli management                            |
+-------------------------------------------+------------------------------------------------------------+
| */var/www/YourSite*/**.htaccess**         | `prepared to use fast_CGI, mod_WSGI, CGI via mod_rewrite`_ |
+-------------------------------------------+------------------------------------------------------------+

.. _your own settings: http://www.pylucid.org/permalink/332/a-complete-local_settingspy-example
.. _prepared to use fast_CGI, mod_WSGI, CGI via mod_rewrite: http://www.pylucid.org/permalink/136/change-between-fastcgi-mod_wsgi-and-cgi

`create database tables and insert initial data <http://www.pylucid.org/permalink/356/2-create-database-tables-and-insert-initial-data>`_:

::

    /home/FooBar/PyLucid_env$ cd /var/www/YourSite
    /var/www/YourSite$ ./manage.py syncdb
    /var/www/YourSite$ ./manage.py migrate
    /var/www/YourSite$ ./manage.py loaddata pylucid.json

Now you can start the local developer server with:

::

    /var/www/YourSite$ ./manage.py runserver

Or use these files for apache with fastCGI:

* /var/www/YourSite/**index.fcgi**

* /var/www/YourSite/**.htaccess**

To complete the installation follow the steps in `setup PyLucid after installation <http://www.pylucid.org/permalink/353/3-setup-pylucid-after-installation>`_.

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

* `Flattr this! <https://flattr.com/thing/54709/PyLucid-CMS>`_

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

* `Paypal over SourceForge.net <http://sourceforge.net/donate/index.php?group_id=146328>`_

* `Paypal over Pledgie <https://pledgie.com/campaigns/10140>`_

=====
links
=====

+---------------------+--------------------------------------------+
| Homepage            | `http://www.pylucid.org`_                  |
+---------------------+--------------------------------------------+
| Development history | `visible / backward-incompatible changes`_ |
+---------------------+--------------------------------------------+
| Forum               | `http://forum.pylucid.org/`_               |
+---------------------+--------------------------------------------+
| IRC                 | `#pylucid on freenode.net`_                |
+---------------------+--------------------------------------------+
| Github              | `http://github.com/jedie/PyLucid`_         |
+---------------------+--------------------------------------------+

.. _http://www.pylucid.org: http://www.pylucid.org
.. _visible / backward-incompatible changes: http://www.pylucid.org/blog/tags/development/
.. _http://forum.pylucid.org/: http://forum.pylucid.org/
.. _#pylucid on freenode.net: http://www.pylucid.org/permalink/304/irc-channel
.. _http://github.com/jedie/PyLucid: http://github.com/jedie/PyLucid

