There are four settings in "Pukeko"
"Basic Settings" are arguments that are changeable only when you edit script files directly. These settings include script names, size restriction for uploading files, etc. You do not need to change these settings basically.
"Global configuration" are set in init.cgi. You can set web server address for CGI, extensions for data, and data directory.
"Configuration" is a series of settings that can be set in "Configuration" menu. You can set title of your weblog, number of articles to be shown per page, etc. The settings of base directory, log directory, image directory in "Global configuration" are updated in "Configuration" menu.
Each user can set "Editor Settings". (Except "Update PING URL". This is set by the administrator of your weblog.)
Editor settings menu consists of "Basic settings", "Tag entry helper", "Mail settings", and "Quick posting".
| Setting | Description |
|---|---|
| Basic settings | |
| Format | sets an article format when you write an new article. |
| Date of article | selects whether to update "Date" when you edit your articles. If you select "Update when edited", the date of your articles will be updated when you open a screen to edit the article, not when you save the edited article. |
| Comment | sets default of Comment Status. |
| Trackback | sets default of Trackback Status. |
| Ping sender | selects whether to enable or disable "Trackback" form. If you select "Do not use this function", a text area to add trackback urls will not be shown in your editor screen and trackback setting for individual article is unavailable. Trackback ping set for the category of the article will be sent out regardless of this setting. |
| Sequel of article | selects whether to use "Write more about it" form. If you select "Do not use this function", a text area to write more about your article will not be shown in your editor screen. |
| Advanced settings | Selects whether to use "excerpt", "keyword", "author", "file name", and "time zone". If you select "Do not use this function", the relevant fields will not be shown in your editor screen. |
| Update Ping | selects whether to send "Update PING" by default when saving your articles. |
| Image file selection | selects which image file is to be used/prioritized when inserting in "Body" and "Sequel". |
| No. of files in Ezy file inserter | sets the number of uploaded files is to be shown in the Ezy file inserter for "Body" and "Sequel". |
| Management screen color | selects background color of the management screen. Gray is selected by default. |
| Send update Ping to | Adds urls to send trackback Ping to. Only the administrator of your weblog can set this setting. |
| Mail settings | |
| Mail address | Your email address can be edited in "Profile" menu too. To be notified of incoming comments/trackbacks by email, add your email address in "Mail server" setting of "Configuration" menu. |
| Mail notification | You will receive emails whenever your weblog receive any comments/trackbacks if you preset "Mail server" setting of "Configuration" menu. |
| Quick Posting [sb it!] | |
| Quick posting | You can use a bookmarklet for quick posting. Click "Quick posting" tab on "Editor settings" menu and bookmark the "Quick posting" link. |
customizes tool buttons for inserting element tags in "Body" and "Sequel" of your articles.
You can use tag entry helper when editing your profile or short message.
To activate/inactivate a button, check the a box in the list and click "Save".
For buttons other than link anchoring, entity reference encoding/decoding, you can specify elements and attributes respectively.
To set
to a button for instance, <p class="note"></p>
enter
in its element, and p
in its attribute. Do not forget entering "=" and '"' in attribute. class="note"
To use a button that works as
, <h3 class="subtitle" style="border-bottom:1px solid blue;"></h3>
enter
in its element and h3
in its attribute. class="subtitle" style="border-bottom:1px solid blue;"
Note that whole attribute part shall be entered.
To set an empty element like
for a button, enter <hr />
in its element and hr
in its attribute. /
You can change icons for buttons by selecting from "Change button" pull-down menu.
"Configuration" menu consists of "Display settings", "Basic settings", "Plug-in", and "Mail server".
Refer to Optional functions for details of plug-ins.
| Setting | Description |
|---|---|
| Header of my weblog | |
| Title | sets title of your weblog. You can not use HTML tags for the title. |
| Subtitle | sets subtitle of your weblog. You can not use HTML tags for the description. |
| My weblog shows | |
| Page view mode | sets number of articles to display on top page and while in page view mode. |
| Archive view mode | chooses whether to display the selected number of articles per page or to display all articles in archive in one page. If you selects "Monthly" file saving type, all the articles will be displayed when in monthly archive mode. |
| Search result | chooses whether to display the selected number of search results per page or to display all search results in one page. |
| Recent articles | sets the number of recent articles to display in your weblog list. |
| Recent comments | sets the number of comments to display in your weblog list. |
| Recent trackbacks | sets the number of trackbacks to display in your weblog list. |
| Affiliate items | sets number of affiliate item blocks to display on your weblog. |
| My weblog sorts and shows | |
| Article entries | sets order of all articles. |
| Articles in archive | sets order of articles in archive view mode. |
| Comments | sets order of comments to your weblog. |
| Trackbacks | sets order of trackbacks to your weblog. |
| Basic settings | |
| HTML file generation | selects archive saving type from Individual, Monthly and None. |
| Server address | enter the address of the top page of your weblog. |
| Base Directory | sets the directory where the top page file (index.html) is saved. |
| Log Directory | sets log directory in the base directory. |
| Image Directory | sets image directory in the base directory. |
| Thumbnail | sets pixel size for thumbnails which can be generated when Image::Magick is active. You can also give default setting for creating thumbnail that will be reflected on the "File uploading" screen. |
| File naming | selects whether to rename your files when uploading. Files are automatically renamed by default in order to avoid overwriting of the files. |
| Time Zone | selects your time zone. Time zone for Japan is "+0900". Time zone for New Zealand is "+1200", and "+1300" during day-light saving period. |
| Mail server | |
| Mail notification | selects whether to notify you by email when your weblog receives any comments/trackbacks. You can use "sendmail" or "Net::SMTP module" for this function. To use "sendmail", enter the sendmail path (ex: /usr/sbin/sendmail). To use SMTP server, enter the SMTP server address (ex: mail.example.com). "Net::SMTP module" is contained in the separately provided archive, sb_ext. |
Initial settings can be done in init.cgi.
Write "setting name", "one space (or tab)", "setting" in init.cgi. ex)
. DataDir ./data/
Spacing between setting name and setting should be one entry of space or tab. Your initial settings will not be properly done if you enter more than two spaces or tabs.
| Setting | Description |
|---|---|
| DataDir | sets where the data directory is when being seen from blog.cgi, admin.cgi, and cnt.cgi. Either absolute path or relative path is fine. |
| DataSuffix | sets extensions for data files to be saved. ".cgi" is set by default. You can change it for your security. |
| ScriptPath | sets addresses where blog.cgi, admin.cgi, and cnt.cgi are. |
| LockDir | sets where the lock directory is when being seen from blog.cgi, admin.cgi, and cnt.cgi. |
| BaseDir | sets where the base directory is when being seen from blog.cgi, admin.cgi, and cnt.cgi. Base directory is the directory where you save index.html and style.css. |
| LogDir | names a log directory in BaseDir. |
| ImgDir | names an image file directory in BaseDir. |
| HttpProxy | sets proxy server to be used when accessing from admin.cgi to other server such as sending trackback pings. |
| HelpSrv |
sets URI where the HELP documents are.
Delete "en.html" from the URI.
ex) |
| TempSrv |
sets URI where template files for management screen are.
Mainly used for selecting a image file that is used in the management screen.
Delete "_parts" and the succeeding part from the URI.
ex) |
| TempDir | sets the directory where template files for the management screen are saved. Specify where "lang/" directory is in the "lib/" directory when being seen from blog.cgi, admin.cgi, and cnt.cgi. |
| WeblogId |
This ID is used when you install multiple Pukeko weblogs.
You do not need to use this ID if your Cookie information do not conflict when you have more than one Pukeko weblogs installed.
Write |
| PluginDir | sets the directory where plugin files are. Refer to readme.txt in "plugin/" directory for details of the installed plugins. |
| AdminCookieDay |
Your user name and password to log in your management screen will be saved as your browser's Cookie.
This information is usually kept for one day, however, you can change the period.
Write |
| RefCheck |
sets whether to check referrer in your management screen.
Pukeko checks referrers for some operation to strengthen security.
You may not be able to use this weblog if your security software changes referrer information.
In that case, write |
| MainScript |
reflects changes when blog.cgi is renamed.
ex) Write |
| TopIndex |
reflects changes when the index file for top page, index.html, is renamed.
ex) Write |
| SpamCheckLevel |
selects default spam check level 0 to 4 for incoming comments.
Write |
| SpamCheckId |
adds IDs to be refused when "2" is selected for "SpamCheckLevel".
ex) Write |
| StyleDir | sets the directory where the template image parts in BaseDir. |
| XmlrpcForcedPublish |
sets whether to post and save your article compulsorily regardless of boolean value of "publish" when using XML-RPC API to edit your article.
Write |
| StaticFileSuffix | sets extensions for html files to be saved in log directory. |
| OldStyleRebuilding |
Write |
| TrackbackReceiver | sets a script name when changing the script to receive trackback pings. "blog.cgi" receives them by default. |
Note that log directory and image directory are always used in combination with base directory. For instance, if you sets
for base directory and ./
for log directory, the log directory will be seen from blog.cgi and admin.cgi as log/
. The same to your image directory. Pukeko regards that its log directory and image directory are placed in base directory. ./log/