= about PyLucid

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

Some PyLucid Features are:

* Open Source (GPL v3 or later)
* [[http://www.pylucid.org/permalink/69/customise-PyLucid/|fully customizable output]]
** templates/styles/JS code online editable with CodeMirror highlighting
** compress styles/JS code via [[https://github.com/jezdez/django_compressor|Django-Compressor]]
** [[http://www.pylucid.org/permalink/279/how-to-change-a-plugin-template|easy overwrite templates]]
* [[/permalink/343/howto-add-new-sites|Multi site support]] (Allows a single installation to serve multiple websites.)
* internationalization and localization support (Multilingual content)
* Revision controlled content with [[http://github.com/etianen/django-reversion|django-reversion]] and include [[https://github.com/jedie/django-reversion-compare|django-reversion-compare]] for comparing two versions.
* markup support: Creole, textile, markdown, ReStructuredText
* expandable with plugins
* [[/permalink/90/about-the-built-in-plugins|many built-in plugins]]:
** [[http://www.pylucid.org/permalink/42/secure-login-without-https|secure JS-SHA Login]] with [[http://www.pylucid.org/permalink/320/the-auth-plugin-js-sha1-login#honypot|a honypot]]
** content:
*** [[http://www.pylucid.org/permalink/141/blog|weblog]] (Complete blogging solution)
*** [[http://www.pylucid.org/permalink/351/the-comments-plugin-also-usefull-as-guestbook|comments / guestbook]] (comments for pages, blog articles, lexicon entries)
*** [[http://www.pylucid.org/permalink/295/the-streetmap-plugin|StreetMap]] (insert OpenStreetmap / GoogleMaps)
*** [[http://www.pylucid.org/permalink/301/the-lexicon-plugin|lexicon]] (explane words in content)
*** [[/permalink/375/poll|poll]]
*** [[http://www.pylucid.org/permalink/123/includes-rss-newsfeeds|RSS]] (include external feeds into a page)
*** [[http://www.pylucid.org/permalink/309/highlight-source-code|source code]] (highlight source code into content)
*** [[/permalink/381/about-the-include-plugin|include]] local/remote file content into page
*** [[http://www.pylucid.org/permalink/340/pylucid-screenshots|simple picture gallery]]
** navigation:
*** basics: main menu (split able), sub menu and sitemap
*** [[http://www.pylucid.org/permalink/43/about-pylucid-integrated-search-engine|search engine]] (search in page content, blog articles, lexicon entries)
*** [[http://www.pylucid.org/permalink/311/the-update-journal-plugin|update journal]] (List of all page updates)
*** [[http://www.pylucid.org/permalink/131/the-tag-navigation-plugin|page tag based navigation]]
*** [[http://www.pylucid.org/permalink/294/the-breadcrumb-plugin|breadcrumb]]
*** [[http://www.pylucid.org/permalink/303/table-of-contens-plugin|Table of contens]] (TOC from page headlines)
*** [[http://www.pylucid.org/permalink/360/include-external-widgets-with-generic-plugin|Generic widgets]]
** content helpers:
*** [[[http://www.pylucid.org/permalink/128/the-filemanager-plugin|A Filemanager]]
*** [[http://www.pylucid.org/permalink/357/bulk_editor|bulk editor]]
*** [[http://www.pylucid.org/permalink/129/the-find-and-replace-plugin|find and replace]] (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: [[http://www.pylucid.org/permalink/136/change-between-fastcgi-mod_wsgi-and-cgi|fastCGI, mod_WSGI and CGI (only for debugging) and others]]
* and many more features... :)

= install

(Please read [[http://www.pylucid.org/permalink/70/how-to-install-pylucid|the complete installation instructions]].)

To create a [[http://www.pylucid.org/permalink/135/install-pylucid-in-a-virtual-environment|PyLucid virtual environment]], use our bootstrap script:
{{{
/home/FooBar$ wget https://raw.github.com/jedie/PyLucid/master/bootstrap/pylucid-boot.py
/home/FooBar$ python pylucid-boot.py PyLucid_env
}}}

[[http://www.pylucid.org/permalink/355/1a2-create-a-new-page-instance|create a new page instance]]:
{{{
/home/FooBar$ cd PyLucid_env
/home/FooBar/PyLucid_env$ ./create_page_instance.sh /var/www/YourSite
}}}

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** | [[/permalink/332/a-complete-local_settingspy-example|your own settings]]
| ///var/www/YourSite///**manage.py**         | Access to django cli management
| ///var/www/YourSite///**.htaccess**         | [[http://www.pylucid.org/permalink/136/change-between-fastcgi-mod_wsgi-and-cgi|prepared to use fast_CGI, mod_WSGI, CGI via mod_rewrite]]



[[http://www.pylucid.org/permalink/356/2-create-database-tables-and-insert-initial-data|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 [[http://www.pylucid.org/permalink/353/3-setup-pylucid-after-installation|setup PyLucid after installation]].


= donation

* [[https://flattr.com/thing/54709/PyLucid-CMS|Flattr this!]]
* Send [[http://www.bitcoin.org/|Bitcoins]] to [[https://blockexplorer.com/address/1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F|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 | [[http://www.pylucid.org/blog/tags/development/|visible / backward-incompatible changes]]
| Forum               | [[http://forum.pylucid.org/]]
| IRC                 | [[http://www.pylucid.org/permalink/304/irc-channel|#pylucid on freenode.net]]
| Github              | [[http://github.com/jedie/PyLucid]]
| Sourceforge         | [[http://sourceforge.net/projects/pylucid/]]
| Google code         | [[http://code.google.com/p/pylucid/]]

