Textcube: Brand Yourself - Personalized web publishing platform

DESCRIPTION

Textcube is an opensource tool to archive and share the experiences, ideas, opinions and thoughts.

Supports import/export individual data via XML compatible with other solutions in 'Tattertools Project'

• Strong support of non-latin compatibility including Korean/Japanese/Chinese
• Supports various installation environments (webservers,databases and languages)
• Provides and extensible plugin and skin architecture
• Expandable from individual blog to blog service platform.
• Supports easy backup and restore via TTXML format, which is supported by various platforms of 'Project Tattertools.'

HISTORY

Textcube is based on online publishing platform 'Tattertools,' started by JH in 2004, developed by TNC in 2005 and GPLized in 2006. Tatter Network Foundation (TNF) developed Tattertools with TNC from Apr. 2006. Needlworks/TNF was dedicated to Tattertools' development from Nov. 2006, and started developing 'Project S2' as its successor. 'Textcube' was named by YJ Park, and made its debut in Aug. 2007.

REQUIREMENTS (CURRENT VERSION)

Textcube supports various environments. However, you need at least one webserver supporting PHP environments, one database engine

• Web servers (Need at least one environment)
• Apache > 2.1
• fancyURL support with mod_rewrite module (recommended)
• Nginx > 1.1
• Lighttpd > 1.4
• PHP built-in Web Server > 5.5.7
• IIS > 5.0
• with ISAPI Rewrite Filter
• Language
• PHP > 5.5
• with iconv (for TTXML character converting from old servers) / gd module (for image resampling)
• Database Management System (Need at least one environment)
• MySQL > 5.0 / MariaDB > 5.1 with UTF-8 character set and collation setting
• With PHP MySQLi extension (MySQLnd support is in development stage.)
• Cubrid > R2008
• PostgreSQL > 8.3
• Sqlite > 3.0

For massive service / Heavy load environments

• APC (Alternative PHP Cache) pecl package with PHP PEAR
• XCache
• memcached module

are strongly recommended.

REQUIREMENTS (OLD VERSIONS)

• Web servers (Need at least one environment)
• Apache > 1.3
• fancyURL support with mod_rewrite module
• Language
• (Till Textcube 1.7) PHP 4.35.1, (Till Textcube 1.10) PHP 5.05.3
• with iconv / gd module
• Database Management System (Need at least one environment)
• (Till Textcube 1.7) MySQL > 4.1 / MariaDB > 5 (lower version with UTF-8 emulation routine in Textcube)

INSTALLATION

Before you start, you need to

• know the port / username / password of your database
• have the permission to modify webserver configuration.

Bower

You can download latest stable version via bower by

bower install textcube

Manual download

Uncompress the downloaded file, locate them to the web-accessible location. Assume that the textcube location is /var/www/textcube.

We recommend using stable version.

Server configuration

This is apache setting ( < 2.4).

<VirtualHost *:80>
    ServerName www.example.org
    ServerAlias www.example.org
    ServerAdmin [email protected]
    DocumentRoot /var/www/textcube/
    <Directory /var/www/textcube>
        AllowOverride FileInfo
        Require all granted (+needed for apache > 2.4)
        Order allow,deny
        allow from all
    </Directory>
</VirtualHost>

This is nginx setting.

server {
   listen  80;
   server_name example.org *.example.org;
   root    /var/www/textcube;

   location /  {
       root    /var/www/textcube;
       set $rewrite_base '';
       if (!-f $request_filename) {
           rewrite ^(thumbnail)/([0-9]+/.+)$ cache/$1/$2;
       }
       if ($request_filename ~* ^(cache)+/+(.+[^/])\.(cache|xml|txt|log)$) {
           return 403;
       }
       if (-d $request_filename) {
           rewrite ^(.+[^/])$ $1/;
       }
       rewrite  ^(.*)$ $rewrite_base/rewrite.php last;
   }

   location ~ \.php$ {
       fastcgi_pass   127.0.0.1:9000;
       fastcgi_index  index.php;
       fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
       fastcgi_param  QUERY_STRING     $query_string;
       fastcgi_param  REQUEST_METHOD   $request_method;
       fastcgi_param  CONTENT_TYPE     $content_type;
       fastcgi_param  CONTENT_LENGTH   $content_length;
       include fastcgi_params;
   }
   location ~ /\.ht {
       deny all;
   }
}

If the accessible URL is http://www.example.org, run the installation program by accessing http://www.example.org/setup.php. Follow the setup procedure.

• Installation (Korean)

RUNNING

DOCUMENTATION

USERS

• Shortcuts

SPECIFICATIONS AND STRUCTURES

• Requirements

• Upgrade instruction from 1.7 to 1.8 or higher version

• Configurable options

• Skin

• Skin replacer list

• Predefined styles

• Skin information file specification

• Tattertools/Textcube online manual wiki

• Plugins

• Plugin Creation

• Plugin Specification

• Plugin Event Listeners

• TTXML format specification

• WPI package creation

DEVELOPMENT

• Ticketing process

• Coding guideline

• Commiter/Reporter List

• Developing references

• Textcube 1.10/2.0 changes for Plugin Developers

• Textcube 1.8 changes for Plugin Developers

• Textcube 1.8 changes for Skin Designers

• Textcube 1.8 changes for Server administrators and service hosts / maintainers

• Textcube 1.8 changes for coding geeks

EXTERNAL LINKS

• Textcube notice blog
• Needlworks
• Needlworks Blog
• Tatter Network Foundation forum