|
Wikipp is a high performance wiki engine based on CppCMS technology |
|
## Requirements |
|
Before you install WikiPP you need to install |
|
- [CppCMS Framework](wikipp/en/page/cppcms_1x_build) - version 0.999.0 and above |
- [CppCMS Framework](/wikipp/en/page/cppcms_1x_build) - version 0.999.0 and above |
- [CppDB Library](/sql/cppdb) |
- [Discount Markdown Library](http://www.pell.portland.or.us/~orc/Code/discount/) |
- [Syntax Highligher](http://code.google.com/p/syntaxhighlighter/) --- recommended but not mandatory. |
|
## Installation of WikiPP |
|
Download wikipp-X.Y.Z.tar.bz2 and extract it: |
|
tar -xjvf wikipp-X.Y.Z.tar.gz |
cd wikipp-X.Y.Z |
|
If you are using trunk version: |
|
svn co https://cppcms.svn.sourceforge.net/svnroot/cppcms/wikipp/trunk wikipp |
cd wikipp |
|
and then create a build directory |
|
mkdir build |
|
Configure the wiki build system |
|
cmake .. |
|
Or of you want to install to ordinary `/usr` path instead |
of `/usr/local` |
|
|
cmake -DCMAKE_INSTALL_PREFIX=/usr .. |
|
Then run |
|
make |
|
And as super user |
|
make install |
|
## Configuration of Wiki |
|
I assume that you had installed wikipp to /usr/local directory (default for configure script). Otherwise, you should update absolute paths given in this documentation |
|
### Database |
|
You can find DB configuration scripts under /usr/local/share/wikipp/sql directory, use them to create a database |
|
- If you use MySQL: |
|
First of all, create database, let's call it "wikipp". |
|
create database wikipp; |
|
Then create all required tables running: |
|
mysql -u username --password=secret wikipp <mysql.sql |
|
- If you use Sqlite3 |
|
Create database, and make it accessible to process that would run wikipp: |
|
sqlite3 /var/wikipp/wikipp.db <sqlite3.sql |
|
Make sure that /var/wikipp/wikipp.db is writable by the web server. |
|
|
- If you use PostgreSQL |
|
createdb wikipp |
psql wikipp <postgresql.sql |
|
### WikiPP configuration |
|
Take a sample configuration file placed under /usr/local/shared/wikipp/sample_config.js create a copy and edit it. |
|
1. First create your new, unique private key for session management. Run |
|
cppcms_make_key --hmac sha1 --cbc aes |
|
Or if your cppcms library was build without libgcrypt and openssl: |
|
cppcms_make_key --hmac sha1 |
|
Update the private keys in the configuration file. |
|
**REMEMBER THESE ARE YOUR PRIVATE KEYS, KEEP THEM IN SECRET** |
|
2. Configure connection string under `wikipp.connection_string`. Don't forget to define `@pool_size` connection string property to enable connection pooling. |
|
Refer to [CppDB manual](http://cppcms.com/sql/cppdb) for exact options. |
|
3. Configure your web server according [this manual](/wikipp/en/page/cppcms_1x_tut_web_server_config). |
|
Note, the wikipp media files installed into `/usr/local/share/wikipp/media`. Make sure that you have configured |
valid alias to this location and the `wikipp.media` |
has correct value assigned according to the location |
of the files relatively the the web servers |
document root. |
|
4. Make sure that `localization.messages.messages` and `views.paths` points to correct path: |
|
Locale dictionaries: |
|
"localization" : { |
"messages" : { |
"messages" : [ "/usr/local/share/locale"] |
|
Views path: |
|
"views" : { |
"paths" : [ "/usr/local/lib/wikipp" ], |
|
|
