rev |
line source |
pankso@0
|
1 TinyCM - A micro CGI/SHell Content Manager!
|
pankso@0
|
2 ================================================================================
|
pankso@0
|
3
|
pankso@0
|
4
|
pankso@0
|
5 * CGI/Shell powered, small Wiki syntaxe and HTML JS editor helper
|
pankso@0
|
6 * Tiny, fast, elegent and easy to install and customize
|
pankso@0
|
7 * No database, flat file storage with diff and log
|
pankso@0
|
8 * Plugins support for any kind of functions such as a blog
|
pankso@0
|
9 * Help file with formating rules, macro and HTML example code
|
pankso@0
|
10 * Gettexte support and languages support for documents
|
pankso@0
|
11
|
pankso@0
|
12
|
pankso@0
|
13 Installation
|
pankso@0
|
14 ------------
|
pankso@0
|
15 You must first get TinyCM source code via a tarball on SliTaz mirrors or Hg
|
pankso@0
|
16 repository. You can extract or clone the CM under a web server directory,
|
pankso@0
|
17 for security reason the config file have a .cgi extension and users data are
|
pankso@0
|
18 stored outsite the web server in the directory /var/lib/slitaz. The user
|
pankso@0
|
19 files paths can be changed via the configuration file.
|
pankso@0
|
20
|
pankso@0
|
21 When you have your copy of TinyCM you can then install web interface under a
|
pankso@0
|
22 CGI/SHell enabled web server such as Busybox HTTPd, LightTPD or Apache. Gettext
|
pankso@0
|
23 must be installed for localisation support. So, let download Content Manager:
|
pankso@0
|
24
|
pankso@0
|
25 $ wget http://mirror.slitaz.org/sources/tinycm/tinycm-VERSION.tar.gz
|
pankso@0
|
26 $ tar xzf tinycm-VERSION.tar.gz
|
pankso@0
|
27
|
pankso@0
|
28 Or clone the Mercurial repo:
|
pankso@0
|
29
|
pankso@0
|
30 $ hg clone http://hg.slitaz.org/tinycm
|
pankso@0
|
31
|
pankso@0
|
32
|
pankso@0
|
33 Change directory to the CM, check and edit the configuration file config.cgi
|
pankso@0
|
34 and use make to install:
|
pankso@0
|
35
|
pankso@0
|
36 $ cd tinycm*
|
pankso@0
|
37 $ editor config.cgi
|
pankso@0
|
38 $ make install
|
pankso@0
|
39
|
pankso@0
|
40
|
pankso@0
|
41 Standalone Server
|
pankso@0
|
42 -----------------
|
pankso@0
|
43 On SliTaz you can install a copy of TinyCM somewhere under you $HOME directory
|
pankso@0
|
44 and start the stand alone web server powered by Busybox HTTPd applet. This also
|
pankso@0
|
45 help to debug TazCM since error messages are displayed in the terminal. To
|
pankso@0
|
46 start the server, cd to TinyCM dir and execute:
|
pankso@0
|
47
|
pankso@0
|
48 $ ./tinycm serv
|
pankso@0
|
49
|
pankso@0
|
50
|
pankso@0
|
51 Mercurial integration
|
pankso@0
|
52 ---------------------
|
pankso@0
|
53 TinyCM can smothily be integrated with Mercurial, each new document and edit
|
pankso@0
|
54 will be committed. You must first edit you config.cgi configuration to
|
pankso@0
|
55 enable Hg with HG="yes" then login to your TinyCM follow the link to init the
|
pankso@0
|
56 repo or do it manually: cd content && hg init && hg add && hg commit -m "Message"
|
pankso@0
|
57
|
pankso@0
|
58 Then all content will be under Hg and people can commit as usual, to make sure
|
pankso@0
|
59 we use the last files on the web interface we use a Hook to update the repo on
|
pankso@0
|
60 each commit. To have the mercurial web interface for the repo you can setup
|
pankso@0
|
61 a vhost, TinyCM provide a small web interface to display Hg log but it can
|
pankso@0
|
62 be extented via a plugin. Hook for $content/.hg/hgrc:
|
pankso@0
|
63
|
pankso@0
|
64 [hooks]
|
pankso@0
|
65 incoming = hg update
|
pankso@0
|
66
|
pankso@0
|
67
|
pankso@0
|
68 ================================================================================
|