Commit | Line | Data |
---|---|---|
2670bdf4 AT |
1 | CMless - Because words should be weighed, not counted. |
2 | ====================================================== | |
3 | ||
4 | Description | |
5 | ----------- | |
6 | ||
7 | CMless is a file based CMS intended for easy integration with version controlled, | |
8 | format agnostic content. | |
9 | ||
10 | Status | |
11 | ------ | |
12 | ||
13 | CMless is not yet functional. The stages required to reach basic functionality are: | |
14 | ||
a58599ba | 15 | 1. ~~Figure out deployment scheme~~ |
acd291ea AT |
16 | 2. ~~Interpret URL and locate/serve appropriate page~~ |
17 | 3. ~~Feed pages through a document processor~~ | |
d955cfad | 18 | 4. ~~Feed pages through a template engine~~ |
73c5dba9 AT |
19 | 5. ~~Generate menu based on directory structure~~ |
20 | 6. Write documentation, including a sample site. | |
a58599ba AT |
21 | |
22 | Installation Example - Debian Linux | |
23 | ----------------------------------- | |
24 | ||
25 | Enable CGI scripts: | |
26 | ||
ac6fb0d4 | 27 | a2enmod cgi |
a58599ba AT |
28 | |
29 | Create and enable an Apache vhost. | |
30 | ||
ac6fb0d4 AT |
31 | vi /etc/apache2/sites-available/cmless.subgeniuskitty.com |
32 | ||
33 | <VirtualHost *:80> | |
34 | DocumentRoot "/mnt/data/apache_vhosts/cmless.subgeniuskitty.com" | |
35 | ServerName cmless.subgeniuskitty.com | |
36 | ServerAdmin webmaster@subgeniuskitty.com | |
37 | ErrorLog /var/log/apache2/error_log.cmless.subgeniuskitty.com | |
38 | CustomLog /var/log/apache2/access_log.cmless.subgeniuskitty.com combined | |
39 | AddHandler cgi-script .py | |
40 | <Directory "/mnt/data/apache_vhosts/cmless.subgeniuskitty.com"> | |
41 | Options -ExecCGI -Indexes | |
42 | AllowOverride None | |
43 | Order allow,deny | |
44 | Allow from all | |
45 | </Directory> | |
46 | <Directory "/mnt/data/apache_vhosts/cmless.subgeniuskitty.com/bin"> | |
47 | Options ExecCGI | |
48 | AllowOverride None | |
49 | Order allow,deny | |
50 | Allow from all | |
51 | </Directory> | |
52 | RewriteEngine On | |
53 | RewriteRule (.*) /mnt/data/apache_vhosts/cmless.subgeniuskitty.com/site/$1 | |
54 | RewriteCond %{REQUEST_FILENAME} !-f | |
55 | RewriteRule .* /mnt/data/apache_vhosts/cmless.subgeniuskitty.com/bin/cmless.py | |
56 | </VirtualHost> | |
57 | ||
58 | a2ensite cmless.subgeniuskitty.com | |
59 | service apache2 reload | |
a58599ba AT |
60 | |
61 | Clone the CMless git repository into the Apache vhost directory. | |
62 | ||
ac6fb0d4 AT |
63 | cd /mnt/data/apache_vhosts |
64 | git clone https://github.com/subgeniuskitty/cmless.git cmless.subgeniuskitty.com | |
65 | chown -R www-data:www-data ./cmless.subgeniuskitty.com | |
a58599ba | 66 | |
ac6fb0d4 AT |
67 | Clone your content into the `site/` folder. If you with to use a different |
68 | folder, edit the configuration options in `bin/config.py` accordingly. If this | |
69 | is your first CMless site, see the `site_sample/` folder for an example site | |
70 | using Markdown. | |
a58599ba | 71 | |
ac6fb0d4 AT |
72 | cd /mnt/data/apache_vhosts/cmless.subgeniuskitty.com |
73 | git clone your_site_content_repo site | |
74 | chown -R www-data:www-data ./site | |
5dc44f45 AT |
75 | |
76 | Install an appropriate document processor for your content and set the | |
ac6fb0d4 AT |
77 | `markup_processor` configuration option in `bin/config.py` accordingly. Your |
78 | markup engine should accept text via `stdin` and output HTML on `stdout`. | |
5dc44f45 | 79 | |
ac6fb0d4 | 80 | apt-get install discount |
5dc44f45 | 81 | |
ac6fb0d4 | 82 | Edit `bin/config.py` and set all configuration options according to the steps |
5dc44f45 | 83 | taken during installation. Each option is commented inside the file. |