CppBlog is a high performance blog engine based on CppCMS technology
|
|
## Requirements
|
|
Before you install CppBlog you need to install
|
|
- [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/)
|
- [ImageMagick](http://www.imagemagick.org/) or [GraphicsMagick](http://www.graphicsmagick.org) library
|
|
Optionally if you want to embed LaTeX formulas you may
|
need latex and dvigif programs in runtime.
|
|
## Installation of CppBlog
|
|
Download cppblog-X.Y.Z.tar.bz2 and extract it:
|
|
tar -xjvf cppblog-X.Y.Z.tar.gz
|
cd cppblog-X.Y.Z
|
|
If you are using trunk version:
|
|
svn co https://cppcms.svn.sourceforge.net/svnroot/cppcms/blog/trunk cppblog
|
cd cppblog
|
|
and then create a build directory
|
|
mkdir build
|
|
Configure the cppblog 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 the blog
|
|
I assume that you had installed the blog 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/cppblog/sql directory, use them to create a database
|
|
- If you use MySQL:
|
|
First of all, create database, let's call it "blog".
|
|
create database blog;
|
create user 'username'@'localhost' identified by 'password';
|
grant all privileges on blog.* to 'username'@'localhost';
|
|
Then create all required tables running:
|
|
mysql -u username --password=secret blog <mysql.sql
|
|
- If you use Sqlite3
|
|
Create a database:
|
|
sqlite3 /var/blog/blog.db <sqlite3.sql
|
|
Make sure that /var/blog/ and /var/blog/blog.db is writable by the web server.
|
|
- If you use PostgreSQL
|
|
createdb blog
|
psql blog <postgresql.sql
|
|
### CppBlog configuration
|
|
Take a sample configuration file placed under /usr/local/shared/cppblog/sample_config.js create a copy and edit it.
|
Take a sample configuration file placed under /usr/local/share/cppblog/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
|
|
Update the private keys in the configuration file.
|
|
**REMEMBER THESE ARE YOUR PRIVATE KEYS, KEEP THEM IN SECRET**
|
|
2. Configure connection string under `blog.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 cppblog media files installed into `/usr/local/share/cppblog/media`. Make sure that you have configured
|
valid alias to this location and the `blog.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/cppblog" ],
|
|
5. Make sure you set the correct value for `blog.host` configuration option. It is important for correct RSS generation.
|
|
### Customization
|
|
You can select one of the two views "orangesky" or "contended". You can select it by setting `views.default_skin` option.
|
|
The blog language can be selected by setting required value for `localization.locales` option.
|
|
### First Run
|
|
Once you had setup the blog of first access you will be asked to create a user and setup a password, once you configured them, login
|
|
