freebsd-ports/www/tokyopromenade/files/pkg-message.in
Greg Larkin d3919ba1b9 Tokyo Promenade is a browser-based content management system with the
following features:

  * simple and logical user interface : aims at conciseness like LaTeX

  * high accessibility : XHTML 1.0 compliant and considering WCAG 1.0

  * hybrid data structure : available as BBS, blog, and Wiki

  * sufficient functionality : supports user management and file management

  * high performance : uses an embedded database, Tokyo Cabinet

  * lightweight : implemented by C99 and without any dependency
                  on other libraries

WWW:	http://1978th.net/tokyopromenade/

PR:		ports/143211
Submitted by:	Qing Feng <qingfeng at me.com>
Feature safe:	yes
2010-02-24 20:58:04 +00:00

59 lines
1.8 KiB
Text

POST-INSTALL CONFIGURATION FOR Tokyo Promenade
==============================================
1) Install an arbitrary web server which supports the CGI mechanism.
Then, create a directory where CGI scripts can be executed. We call
it the base directory, which contains some files of Tokyo Promenade.
mkdir -p /path/to/the/base/directory
cd /path/to/the/base/directory
2) Copy the CGI script and some configuration files into the base
directory.
cp %%PREFIX%%/libexec/promenade.fcgi .
cp %%DATADIR%%/promenade.* .
cp %%DATADIR%%/passwd.txt .
3) Create the database file where articles are stored.
prommgr create promenade.tct
4) Import the help articles into the database.
prommgr import promenade.tct %%DATADIR%%/misc/help-*.tpw
5) Create a directory where uploaded files are stored.
mkdir upload
6) The CGI script should have permissions to read/write the database
file, the upload directory and the password file. To achieve the
purpose, one of the following is suggested.
Change the owner:
sudo chown -R www:nobody /path/to/the/base/directory
Forget the security:
chmod -R 777 /path/to/the/base/directory
Run the web server by the same user of the owner of the base
directory.
Change the user ID of the CGI script by using a feature of the
web server like suExec.
7) Run the FastCGI script.
%%LOCALBASE%%/bin/spawn-fcgi -a 127.0.0.1 -p 8889 \
-d /path/to/the/base/directory \
-f /path/to/the/base/directory/promenade.fcgi
8) Configure your web browser with FastCGI-specific directives. For
Apache, this might look like:
FastCgiExternalServer /path/to/the/base/directory/promenade.fcgi \
-host 127.0.0.1:8889
When all steps above are finished, access the CGI script with a Web
browser.