<commit_before>Alchemy CMS
===========

About
-----

Alchemy is a fully featured Content Management System (CMS) with an gorgeous Userinterface.

Nearly every content management system stores the content of a page in a body column in the pages table. This is easy to develop and the user manages the content inside one of the fancy new Javascript based wysiwyg processors. Formatting, image placement, styling and positioning of the content is in the hand of the end-user.

__We think this is completly wrong!__

The content manager mustn‘t be able to change anything but the content and some basic text formatting. The content manager shouldn‘t care about headline formatting, image positioning or resizing. The developer should take care of this!

__Alchemy is different!__

We split the page into logical parts like headlines, paragraphs, images, etc. The only thing we store in  the database is text: ids of images and richtext content. Nothing else. No markup (besides basic text formatting inside the richtext elements), no styling, no layout. Pure content!

This gives the webdeveloper the power and flexibility to implement any kind of layout with the insurance that the content manager is not able to break up the layout.

Features
--------

- Highly flexible Templating:
  - Content is stored in small parts not as a complete, monolithic page.
  - The designer chooses the template structure, not the CMS!
  - Every Design is possible, no templating, or theming restrictions.
  - Even Flash® Content Management is possible
- Gorgious End-User centric interface:
  - No geeky markup editors and other meta programming crap.
- Multilingual:
  - Create as many (complete independent) language trees as you want.
  - URL based language switching
- SEO
  - Every Part of SEO is manageable by the user
  - Human readable urls (multilingual)
  - automatic XML Sitemap generation
- Access Control:
  - Rolebased Authentification (RBAS)
  - Protect pages for restricted access
- Fulltext Search
- Contactforms
- Attachments and downloads
- Powerfull image rendering
  - Resizing
  - Image Cropping via an graphical Userinterface!
  - Borders, Text, Rotation
  - and much more via Imagemagick processing (polaroid effect, etc.)
  - and all this gets cached!
- Extendable:
  - Flexible Plugin DSL allows you to add custom plugins into Alchemy
- Integrates in exsiting Rails Apps
- Caching
- Completely free:
  - GPLv3 License
  - No Enterprise Licences, or Community Editions
- Hostable on any Server that supports RubyOnRails and ImageMagick ([Software Requirements](https://github.com/magiclabs/alchemy/wiki/Software-Requirements))

Rails Version
-------------

We strongly recommend Rails 2.3.10 and Ruby 1.8.7.

We are working hard on a Rails 3 compatible Gem of Alchemy. Feel free to contribute :) Just fork the rails3 branch.

Install via Rails template (recommended)
----------------------------------------

We have a fancy Rails template that does all the installation stuff for you. You can find it here:

<http://github.com/magiclabs/alchemy-rails-templates/>

Download the template and put it in a folder of your choice of your local disc.

Then enter:

        rails _2.3.10_ -d mysql -m path/to/template/install_alchemy.rb YOUR_APP_NAME

After creation of the new project, follow the instructions displayed in the console.
Then just switch to your browser and open http://localhost:3000/admin for creating your first admin user.

Installing into an existing Rails project
-----------------------------------------

[See Wiki Page](https://github.com/magiclabs/alchemy/wiki/Howto:-install-into-an-existing-rails-app)

Tipp
----

If you use the ferret full text search (enabled by default), then please add a job to your crontab that reindexes the ferret index.

Example:

        cd /path/to/your/alchemy && RAILS_ENV=production rake ferret:rebuild_index > /dev/null

Resources
---------

* Homepage: <http://alchemy-app.com>
* Live-Demo: <http://demo.alchemy-app.com>
* Wiki: <http://wiki.alchemy-app.com>
* API Documentation: <http://api.alchemy-app.com>
* Issue-Tracker: <http://issues.alchemy-app.com>
* Sourcecode: <http://source.alchemy-app.com>
* User Group: <http://groups.google.com/group/alchemy-cms>
<commit_msg>Mentioned alchemy installer in README<commit_after>Alchemy CMS
===========

About
-----

Alchemy is a fully featured Content Management System (CMS) with an gorgeous Userinterface.

Nearly every content management system stores the content of a page in a body column in the pages table. This is easy to develop and the user manages the content inside one of the fancy new Javascript based wysiwyg processors. Formatting, image placement, styling and positioning of the content is in the hand of the end-user.

__We think this is completly wrong!__

The content manager mustn‘t be able to change anything but the content and some basic text formatting. The content manager shouldn‘t care about headline formatting, image positioning or resizing. The developer should take care of this!

__Alchemy is different!__

We split the page into logical parts like headlines, paragraphs, images, etc. The only thing we store in  the database is text: ids of images and richtext content. Nothing else. No markup (besides basic text formatting inside the richtext elements), no styling, no layout. Pure content!

This gives the webdeveloper the power and flexibility to implement any kind of layout with the insurance that the content manager is not able to break up the layout.

Features
--------

- Highly flexible Templating:
  - Content is stored in small parts not as a complete, monolithic page.
  - The designer chooses the template structure, not the CMS!
  - Every Design is possible, no templating, or theming restrictions.
  - Even Flash® Content Management is possible
- Gorgious End-User centric interface:
  - No geeky markup editors and other meta programming crap.
- Multilingual:
  - Create as many (complete independent) language trees as you want.
  - URL based language switching
- SEO
  - Every Part of SEO is manageable by the user
  - Human readable urls (multilingual)
  - automatic XML Sitemap generation
- Access Control:
  - Rolebased Authentification (RBAS)
  - Protect pages for restricted access
- Fulltext Search
- Contactforms
- Attachments and downloads
- Powerfull image rendering
  - Resizing
  - Image Cropping via an graphical Userinterface!
  - Borders, Text, Rotation
  - and much more via Imagemagick processing (polaroid effect, etc.)
  - and all this gets cached!
- Extendable:
  - Flexible Plugin DSL allows you to add custom plugins into Alchemy
- Integrates in exsiting Rails Apps
- Caching
- Completely free:
  - GPLv3 License
  - No Enterprise Licences, or Community Editions
- Hostable on any Server that supports RubyOnRails and ImageMagick ([Software Requirements](https://github.com/magiclabs/alchemy/wiki/Software-Requirements))

Rails Version
-------------

We strongly recommend Rails 2.3.10 and Ruby 1.8.7.

We are working hard on a Rails 3 compatible Gem of Alchemy. Feel free to contribute :) Just fork the rails3 branch.

Install via Installer (recommended)
----------------------------------------

We have a fancy installer script that does all the installation stuff for you. You can find it here:

<https://github.com/magiclabs/alchemy-installer/>

Download the installer and put it in an executable folder (/usr/local/bin).

Then open a terminal goto your projects folder and enter:

    alchemy new YOUR_APP_NAME

After creation of the new project, follow the instructions displayed in the console.
Then just switch to your browser and open http://localhost:3000/admin for creating your first admin user.

Installing into an existing Rails project
-----------------------------------------

[See Wiki Page](https://github.com/magiclabs/alchemy/wiki/Howto:-install-into-an-existing-rails-app)

Tipp
----

1. This task creates all necessary folders and files needed for creating your own pagelayouts and elements for your website

    rake alchemy:app_structure:create:all

2. If you use the ferret full text search (enabled by default), then please add a job to your crontab that reindexes the ferret index.

    cd /path/to/your/alchemy && RAILS_ENV=production rake ferret:rebuild_index > /dev/null

3. You can easily create your element-files (for view and editor) depending on the elements.yml with this generator

    script/generate elements

Resources
---------

* Homepage: <http://alchemy-app.com>
* Live-Demo: <http://demo.alchemy-app.com>
* Wiki: <http://wiki.alchemy-app.com>
* API Documentation: <http://api.alchemy-app.com>
* Issue-Tracker: <http://issues.alchemy-app.com>
* Sourcecode: <http://source.alchemy-app.com>
* User Group: <http://groups.google.com/group/alchemy-cms>

{'fraction_non_alphanumeric': 0.09091944855873305, 'fraction_numerical': 0.003987695112225134, 'mean_word_length': 3.5910041841004183, 'pattern_counts': {'":': 0, '<': 19, '<?xml version=': 0, '>': 21, 'https://': 5, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2288581', 'n_tokens_mistral': 2459, 'n_tokens_neox': 2283, 'n_words': 1098}