CppCMS - C++ Web Framework.

Main  /  Edit  /  History  /   /  Users Area

CppBlog - CppCMS Powered Blog Engine

CppBlog is a high performance blog engine based on CppCMS technology

Requirements

Before you install CppBlog you need to install

• CppCMS Framework - version 0.999.0 and above
• CppDB Library
• Discount Markdown Library
• ImageMagick or GraphicsMagick 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://svn.code.sf.net/p/cppcms/code/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/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 for exact options.

3. Configure your web server according this manual.

   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

About

CppCMS is a web development framework for performance demanding applications.

Support This Project

---

Navigation

• Index
• Changes

Main Page

• English
• Русский
• עברית

---

Valid CSS | Valid XHTML 1.0