SliTaz Repositories

     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/README	Tue Apr 10 21:38:26 2012 +0200
     1.3 @@ -0,0 +1,68 @@
     1.4 +TinyCM - A micro CGI/SHell Content Manager!
     1.5 +================================================================================
     1.6 +
     1.7 +
     1.8 +	* CGI/Shell powered, small Wiki syntaxe and HTML JS editor helper
     1.9 +	* Tiny, fast, elegent and easy to install and customize
    1.10 +	* No database, flat file storage with diff and log
    1.11 +	* Plugins support for any kind of functions such as a blog
    1.12 +	* Help file with formating rules, macro and HTML example code
    1.13 +	* Gettexte support and languages support for documents
    1.14 +
    1.15 +
    1.16 +Installation
    1.17 +------------
    1.18 +You must first get TinyCM source code via a tarball on SliTaz mirrors or Hg 
    1.19 +repository. You can extract or clone the CM under a web server directory,
    1.20 +for security reason the config file have a .cgi extension and users data are
    1.21 +stored outsite the web server in the directory /var/lib/slitaz. The user
    1.22 +files paths can be changed via the configuration file.
    1.23 +
    1.24 +When you have your copy of TinyCM you can then install web interface under a
    1.25 +CGI/SHell enabled web server such as Busybox HTTPd, LightTPD or Apache. Gettext
    1.26 +must be installed for localisation support. So, let download Content Manager:
    1.27 +
    1.28 +	$ wget http://mirror.slitaz.org/sources/tinycm/tinycm-VERSION.tar.gz
    1.29 +	$ tar xzf tinycm-VERSION.tar.gz
    1.30 +	
    1.31 +Or clone the Mercurial repo:
    1.32 +	
    1.33 +	$ hg clone http://hg.slitaz.org/tinycm
    1.34 +
    1.35 +
    1.36 +Change directory to the CM, check and edit the configuration file config.cgi
    1.37 +and use make to install:
    1.38 +
    1.39 +	$ cd tinycm*
    1.40 +	$ editor config.cgi
    1.41 +	$ make install
    1.42 +
    1.43 +
    1.44 +Standalone Server
    1.45 +-----------------
    1.46 +On SliTaz you can install a copy of TinyCM somewhere under you $HOME directory
    1.47 +and start the stand alone web server powered by Busybox HTTPd applet. This also
    1.48 +help to debug TazCM since error messages are displayed in the terminal. To
    1.49 +start the server, cd to TinyCM dir and execute:
    1.50 +
    1.51 +$ ./tinycm serv
    1.52 +
    1.53 +
    1.54 +Mercurial integration
    1.55 +---------------------
    1.56 +TinyCM can smothily be integrated with Mercurial, each new document and edit
    1.57 +will be committed. You must first edit you config.cgi configuration to 
    1.58 +enable Hg with HG="yes" then login to your TinyCM follow the link to init the
    1.59 +repo or do it manually: cd content && hg init && hg add && hg commit -m "Message"
    1.60 +
    1.61 +Then all content will be under Hg and people can commit as usual, to make sure
    1.62 +we use the last files on the web interface we use a Hook to update the repo on
    1.63 +each commit. To have the mercurial web interface for the repo you can setup
    1.64 +a vhost, TinyCM provide a small web interface to display Hg log but it can
    1.65 +be extented via a plugin. Hook for $content/.hg/hgrc:
    1.66 +
    1.67 +[hooks]
    1.68 +incoming = hg update
    1.69 +
    1.70 +
    1.71 +================================================================================