sb - weblog management system

About the sb

Outline

Weblog management system - sb supports the following functions.

  • Genarating static html files.
  • Accepting comments for created articles.
  • Accepting trackbacks for created articles.
  • Supporting multi-usersweblog management.
  • Using Amazon Web Service.
  • Using templates which are compatible with JUGEM.
  • Importing weblog data from JUGEM and Movable Type.

JUGEM is rental weblog service which is provided by paperboy&co.

Movable Type is powerful weglog management system which is provided by Six Aprat Ltd.

Note about templates

Paperboy&co. holds copryrights of templates which are donloaded from JUGEM template center. It is NOT allowed to use these without permission.

The templates which are used in the "sb" are compatible with JUGEM. However it is NOT recommended to divert the JUGEM original templates.

Copyrights & use condition
  • Takuya Otani holds the copyright of the "sb". All rights reserved.
  • The "sb" can be used free of charge without permission only in cases in which using for non-business purpose.
  • The "sb" has NO limitation about number of places and users for non-business purpose.
  • The "sb" is NOT allowed to distribute without permission. Could you please inform me before distribution.
  • The "sb" is allowed to customize at your own risk without permission. It is not limited to open your customization. However, it is necessary to inform me before distribution if you want to distribute it.
  • Using the "sb" for business purpose, could you please inform me before.
  • The "sb" can be introduced without permission. However it is necessary to inform me before introduction if you want to introduce the "sb" on the magazine for business purpose.
  • On no event will Takuya Otani be liable to you for any damages arising out of the use or inability to use the "sb".
  • Specification of the "sb" is subject to change without notice.
Special Thanks

I would like to thank for helping to the following people.

  • Rumurin
  • Shun
  • Fuco
  • BARISTA
  • Juju
  • Yosy
  • All "sb" beta users

And thank and love my wife and my daughter.

Co-developers

The "sb" is developed with the follwing people:

  • Maruyo (Searching engine for AWS)
  • Rumurin (An attachmed utility)

Display screen to edit an article as new article when you push the botton on menu.

If you want to edit a posted article, you can select a article on article list screen. Editing a posted article, a list of received comments and trackbacks would be displayed on the bottom of screen.

This menu is usable for any user.

Display a list of posted articles. You can delete articles if you want.

You can use each title as link to edit. If you want to edit a posted article, you can click the title.

This menu is usable for any user, but some operations (e.g. deleting, editing) are limited according to user authority.

Display a list of uploaded images. You can also upload new image via this screen.

If Image::Magick is available for your environment, you can also create small image at the same time. The "sb" can detect automatically whether Image::Magick is available or not.

You can select a file to upload via "file" field on the screen. The available image formats for the "sb" are "jpeg", "gif" and "png".

You can name a file which is uploeaded to use on the "sb". When the "name" field is a blank, the "sb" would automatically name a file as same as a local file name.

The table shows uploaded images with detail information.

This menu is usable for any user, but deleting operation is limited according to user authority.

Add and edit your favorite items via Amazon Associate Programme (in Japan).

You can search products which are sold on Amazon.co.jp.

Refer to "Recommended Items" about the detail information.

This menu is usable for any user, but deleting operation is limited according to user authority.

Add and edit categories for articles.

You can set a destination for Trackback PING for each category. If you set PING URL in a certain category, the "sb" would send Trackback PING for the PING URL when you generate an article as the category.

You can also add new category in edit screen, but you cannot edit PING URL and description for the category on edit screen.

This menu is only usable for the administrator.

Add and edit links for your weblog.

The registered links are displayed by the peculiar tag {link_list}.

This menu is only usable for the administrator.

Edit your profile.

Refer to "Settings - Profile" about the detail information.

You can change your user name and password anytime if you want. If you would change your user name or password, you need to logout.

This menu is usable for any user.

View your webpage on a new window.

This menu is usable for any user.

Update the index files (the top page, RSS file and Atom Feed file) as the latest status.

According to archive type, all archive files are also updated.

This menu is only usable for the administrator.

Display a list of comments which are received for your webpage. You can also change the status of comments and delete comments.

This menu is usable for any user, but some operations are limited according to user authority.

Display a list of trackbacks which are received for your webpage. You can also change the status of trackbacks and delete trackbacks.

This menu is usable for any user, but some operations are limited according to user authority.

This menu is only usable for the administrator.

This menu is only usable for the administrator.

This menu is only usable for the administrator.

This menu is only usable for the administrator.

This menu is usable for any user, but "Update PING URL" is able to be edited by only the administrator.

This menu is only usable for the administrator.

This menu is only usable for the administrator.

View the latest status of your webpage. Display a list of the latest articles, a list of the recent comments and trackbacks.

This menu is usable for any user.

Logout from the management screen.

This menu is usable for any user.

Display a help document for the "sb" on a new window.

This menu is usable for any user.

Articles

Create Article

You can edit an article as new one from "Edit Article (New)" menu.

You can also upload an image and add new category from the edit screen.

The edit screen is almost same whether editing a new article or editing a posted article.

Editor Screen
object description
Title Describe the title of the article. You don't use HTML elements in this field.
Category Select a category from a list. If you want to edit as a new category, fill in "Add New" field. You can set one category for a article.
Body Describe the description of the article. You can use HTML elements for the body. Please be sure to put the end tag against each HTML element in the body. You can use the above buttons to help putting HTML elements in.
Sequel Describe the sequel of the article. "Sequel" is not displayed on the top page and each archive page, but is displayed on the indivudual page for the article. You can use HTML elements for the body. Please be sure to put the end tag against each HTML element in the body. You can use the above buttons to help putting HTML elements in.
Insert Image There is a list of the bottom of both "Body" and "Sequel" fields. You can use the list to help inserting a tag for images whiche are uploaded to your weblog. If you want to add new image to the list, you can use the side button of the list.
Status You can decide whether the article is published or drafted. The drafted article is closed for audiences of your weblog.
Format You can decide whether line breaks are replaced to <br /> tags or not.
Comment You can decide the status for comments. If you select "Need Auth", the comments which are commented for the article need authorization by you to display.
Trackback You can decide the status for trackbacks. If you select "Need Auth", the trackbacks which are received for the article need authorization by you to display.
Date Set the date for the article. You can use "Set Now" to set the current time.
Trackback (Destinations) List trackback urls if you want to send the trackback pings from the article. You can use "Auto Discovery" button to find trackback urls from the article. The trackback pings are added from category setting when the article is saved as publish.
Ecerpt Describe the summary of the article. There is no text in this field, the "sb" automatically excerpt text from the body. You don't use HTML elements in this field.
Send update PING If you check "Send update PING", the "sb" sends update pings which are set in editor settings to ping servers when the article is saved as publish.
Post Save the article.
Article List

Article List screen displays a list of postetd articles.

The title of each article links edit screen for the article.

If you want tou delete articles, you can check the checkbox where is the side of each article and submit via "Delect selected articles" button on the bottom of the list. If you delete articles, you need to rebuild to reflect.

You can change the order of the list by sort form where is the top of the list. Moreover you can use the filtering option for the list where is the bottom of the list.

Edit Posted Article

When you open the edit screen from the article list. Some infomation is added to the dit screen.

You can see the current status for the article from "View Current Page" on new window even though the article is drafted.

There are lists for comments and trackbacks which are recieved for the article at the bottom of edit screen. You can also delete the comments and trackback from the list.

If you have already sent trackback pings, these are listed at the bottom of the trackbacks field.

Comments/Trackbacks

About Comments/Trackbacks
Authorize Comments/Trackbacks
Config IP Banning

Recommended Items

Amazon Associate Programme
Search Items on Amazon.co.jp
Register as recommeded items
Edit your recommended items

Templates

Structure of templates
Static Generate and Dynamic Generate
Display Mode
Frames for HTML Templates
The Peculiar Blocks for the "sb"
blocks description
related to "recommended items"
amazonis used for displaying recommended items.
related to "lists"
archivesis used for displaying a list of monthly archives.
categoryis used for displaying a list of categories.
latest_entryis used for displaying a list of the latest articles.
linkis used for displaying a list of links.
recent_commentis used for displaying a list of recent comments.
recent_trackbackis used for displaying a list of recent trackbacks.
selected_entryis used for displaying a list of the current articles.
profileis used for displaying a list of users.
related to "title"
titleis used for displaying title.
related to "calendar"
calendaris used for displaying calendar.
related to "articles"
entryis used for displaying articles. This block is repeated at the number of articles on page view mode and archive view mode.
related to "comments"
commentis used for displaying comments. This block is repeated at the number of comments.
comment_areais used for displaying comments on individual view mode. This block consists comment form and comment block.
related to "page navigation"
pageis used for displaying page navigation on page view mode.
related to "profile"
profile_areais used for displaying profile on profile view mode.
related to "trackbacks"
trackbackis used for displaying trackbacks. This block is repeated at the number of trackbacks.
trackback_areais used for displaying trackbacks on individual view mode. This block consists trackback url and trackback block.
others
optionis displayed on individual view mode.
sequelis displayed on individual view mode. This block is placed in entry block.
The Peculiar Tags for the "sb"
tags description
related to "recommended items"
{amazon_item}displays your recommended items with image, name and your comment.
{amazon_ProductName}displays the name of recommended item.
{amazon_Catalog}displays the category of recommended item.
{amazon_Creator}displays the author (creater) of recommended item.
{amazon_ReleaseDate}displays the release date of recommended item.
{amazon_Manufacturer}displays the manufacturer of recommended item.
{amazon_ImageUrlSmall}displays the small image of recommended item.
{amazon_ImageUrlMedium}displays the medium image of recommended item.
{amazon_ImageUrlLarge}displays the large image of recommended item.
{amazon_Availability}displays the availability of recommended item.
{amazon_ListPrice}displays the list price of recommended item.
{amazon_OurPrice}displays the price of recommended item on Amazon.co.jp.
{amazon_comment}displays your comment for recommended item.
{amazon_url}displays the url whick is linked to the page on Amazon.co.jp.
related to "lists"
{archives_list}displays monthly archives as a list.
{category_list}displays all categories as a list.
{latest_entry_list}displays the latest article list.
{link_list}displays the links as a list.
{recent_comment_list}displays a recent comments list.
{recent_trackback_list}displays a recent trackbacks list.
{selected_entry_list}displays the current articles as a list.
{user_list}displays all users as a list.
related to "title"
{blog_description}displays the weblog description which is set in configuration.
{blog_name}displays the weblog name which is set in configuration.
related to "calandar"
{calendar}displays a calendar as a table.
{calendar2}displays a calendar with name of month and weekdays as a table.
{calendar_horizontal}displays a calendar as a horizontal list.
{calendar_vertical}displays a calendar as a vertical list.
related to "article"
{category_name}displays the category with link.
{entry_date}displays the date.
{entry_description}displays the body.
{entry_permalink}displays the address which is indicated permanently.
{entry_sequel}displays the sequel.
{entry_time}displays the time with the permanent link.
{entry_title}displays the title.
{permalink}displays the address which is indicated permanently.
{trackback_auto_discovery}is used to find trackback URL automatically.
{user_name}displays the author.
{comment_num}displays the number of comments.
{trackback_num}displays the number of trackbacks.
{comment_count}displays the number of comments without link.
{trackback_count}displays the number of trackbacks without link.
{user_id}displays the user id.
{category_id}displays the category id.
{entry_disp_time}displays the time without link.
{entry_excerpt}displays the summary.
related to "comments"
{comment_description}displays the description.
{comment_name}displays the author.
{comment_time}displays the time.
{cookie_email}displays the mail address which is stored as cookies.
{cookie_name}displays the name which is stored as cookies.
{cookie_url}displays the site address which is stored as cookies.
{entry_id}displays the article id and is used to indicate commented article.
{comment_icon}displays the selected icon.
{comment_iconform}displays the select form for icons.
related to "article navigation"
{next_entry}displays the link for the next article.
{next_permalink}displays the address for the next article.
{next_title}displays the title for the next article.
{prev_entry}displays the link for the previous article.
{prev_permalink}displays the address for the previous article.
{prev_title}displays the title for the previous article.
related to "page navigation"
{next_page_link}displays the link for the next page.
{next_page_url}displays the address for the next page.
{page_now}displays the current page number.
{page_num}displays the total page number.
{prev_page_link}displays the link for the previous page.
{prev_page_url}displays the address for the previous page.
related to "profile"
{profile_description}displays the profile description.
{profile_name}displays the real name of the user.
related to "HEAD"
{site_atom}display the address for Atom Feed.
{site_css}display the address for style sheet.
{site_encoding}display the character code.
{site_lang}display the language which is used for the webpage.
{site_rss}display the address for RSS.
{site_title}display the title.
related to "trackbacks"
{trackback_blog_name}displays the name of weblog which sent the trackback ping.
{trackback_excerpt}displays the excerpt of artcile which sent the trackback ping.
{trackback_time}display the arrival time of the trackback.
{trackback_title}displays the title of artcile which sent the trackback ping.
{trackback_url}display the destination address for trackbacks.
others
{site_cgi}displays the script address.
{site_top}displays top page address for the weblog.
{selected_archive}displays the selected archive type.
{collect_log}sets the marker for access log.
{show_counter}displays the total access number.
{script_version}displays the script version.

The time relation for the navigation depends on the order settings.

Template Settings

Settings

Type of Settings
Editor Settings
Weblog Settings
Profile

Import/Export Data

Readable and Writable Format
Import Data
Export Data

Install

Install Condition

The "sb" is developped in Perl 5.8 (5.008).

The "sb" is oparatable by Shift_JIS, EUC-JP, iso-20022-jp(JIS), UTF-8 in Japanese.

Libraries

The "sb" needs the following external libraries.

  • LWP::UserAgent
  • HTTP::Request
  • XML::Parser::Lite
  • Jcode

If Image::Magick is usable, the "sb" can generate small image at the same time when you upload image on your webpage.

Image::Magick is not necessary to use the "sb".

Contents of Archive
Contents Description
sb.cgi main script
admin.cgi management script
cnt.cgi script for collecting logs
init.cgi setting file for sb
index.html index html file as a top page
style.css css file for weblog
lib/ directory for libraries
ext/ directory for external libraries
lock/ directory for lock files (there are "lock" and "cnt" in this directory)
data/ directory to store data files
log/ directory to store weblog files
img/ directory to store uploaded images
util/ directory for utilities (it is not necessary to install sb)
doc/ directory for help documents
Examples of placement and permission
Files and Directories Permission
sb.cgi [755]*
admin.cgi [755]*
cnt.cgi [755]*
init.cgi [644]
index.html [666]*
style.css [666]*
lib/ [755] The files in this directory are [644]
ext/ [755] The files in this directory are [644]
lock/ [777]* The "lock" and "cnt" in this directory are [666]*
data/ [777]*
log/ [777]*
img/ [777]*
doc/ [755] The files in this directory are [644]
Note for setting permission

The symbol * shows that files and directories is necessary to set permission.

You can change the places of log, img, index.html and style.css. Could you place these files and directories in base directories which is set in weblog config. If you change the places, you still need to set permission.

You can change name for "log" directory and "img" directory.

The settings for permission is alternated according to the server. Could you contact the administrator of your server.

Path Setting for Perl

The first line of script, #!/usr/bin/perl, is necessary to customize according to the server.

It is only necessary for sb.cgi, cnt.cgi and admin.cgi.

Config in "init.cgi"

In init.cgi,

  • DataDir
  • DataSuffix
  • ScriptPath

are set.

DataDir is the palace of data directory where is pointed from sb.cgi and admin.cgi.

ScriptPath is the URL of sb.cgi and admin.cgi where is installed.

DataSuffix is the suffix of data files. You can change the suffix of data files for security reason.

You can also change the following settings which is not necessary.

  • LockDir
  • BaseDir
  • LogDir
  • ImgDir
  • HttpProxy
  • TempConv

LockDir is the place of lock directory.

BaseDir is the place of base directory. There are index.html and style.css in base directory.

LogDir is the place of log directory in base directory.

ImgDir is the place of img directory in base directory.

HttpProxy is set a proxy server address and port.

TempConv is setting whether the "sb" should convert character code in admin.cgi or not.

If you don't need to convert character code in admin.cgi, you can set TempConv 0.

Setting for Character Code for Japanese

Using the "sb", you don't need to set directly character code in Japanese. The "sb" automatically detects character code according to language library in lib/lang/ (e.g. ja.pl in Japanese).

Default setting of character code is EUC-JP. Setting character code of ja.pl as UTF-8, the "sb" should operate your webpage as UTF-8.

Because the same code is applied to store data, it is better not to change.

Initial Process

After editing init.cgi and setting permission, could you access admin.cgi by WWW agent.

The "sb" automatically generate data files in data directory at the first access.

If it is successful to generate data files, you can see a screen to create the first user. If it is not successful, could you check the permission.

If you want to re-install after the first run, you need delete all files whiche are created in data directory.

At the screen to create the first user, you should create the first user as the administrator of your weblog. You can change user name and password in "Edit Profile" if you want.

If you would cahnge user name or password, you should logout at once.p>

Note for upgrade

You have already installed the old the "sb". Please note below when you upgarade.

It is necessary to replace basically old files with the files as follows:

  • sb.cgi
  • admin.cgi
  • cnt.cgi
  • lib/
  • doc/

It is NOT necessary to replace basically old files with the files as follows:

  • init.cgi
  • data/
  • log/
  • img/
  • lock/
  • ext/

If you have alternated character code, you should also change character code for new one.

If you have changed the first line (#!/usr/bin/perl) of sb.cgi, cnt.cgi and admin.cgi, you should change.

Detail Contents

About the sb
Menus
Articles
Comments/Trackbacks
Recommended Items
Templates
Settings
Import/Export Data
Install

Copyright © SimpleBoxes 2004-, All rights reserved. [ver. 0.20]