A template set consists of two HTML templates and one CSS template.
You can save multiple template sets. To preview a template, click a magnifying glass icon next to the template name.
A template set consists following parts:
HTML template for individual article is used only for displaying each article respectively. You do not need to this template. If this template is not set, "Pukeko" automatically uses Base HTML template instead.
You can choose different templates for your archive or profile. It can be done in "Settings" of "Templates" menu. You can also use different templates for each category. It can be done in "Categories" menu. Click "Details" in category list. What you select for "CSS template" in template settings will be reflected even though you choose different templates for some categories.
Pukeko can import template packages that are made according to certain format. Place directory for images used in a template properly to enable template import.
In static file generation, HTML files are created automatically by "Pukeko" when saving articles. HTML file which is statically generated can be viewed without cgi program.
In dynamic file generation, "Pukeko" displays weblog contents by cgi program. No HTML file will be generated when saving articles.
You can select one of the options for static file generation from "HTML file generation" pull-down menu.
"Pukeko" provides several view modes for your readers and automatically switches modes depending on the selected HTML file generation types.
You can select archive type from the three options as follows:
| View mode | Description |
|---|---|
| Page View Mode | displays articles in the order specified in "Configuration" without categorizing. If the number of your articles exceeds the number preset in "Configuration" menu, rest of the articles will be displayed in the following pages. The top page of your weblog will always be statically generated regardless of the HTML file generation type you selected while other pages will always be generated dynamically. |
| Archive View Mode | displays articles which are filtered by categories or date of the articles. In this mode, articles in categorized archive will always be generated dynamically regardless of the HTML file generation type you selected, and articles in monthly archive will always be generated dynamically except for the case where [Monthly] is selected. Dynamically generated archives that are dynamically generated can be displayed in series of pages. |
| Profile View Mode | displays user profile. Your profile will always be generated dynamically regardless of the HTML file generation type you selected. No articles will be displayed in this mode. |
| Individual Article View Mode | displays your articles respectively. In this mode, comments and trackbacks posted to the article are also shown. Dynamic generation will be used except for cases where "Individual" is selected for HTML file generation type. |
HTML templates basically consist of HTML elements.
Unique blocks and unique tags can be written as shown below to change design of your weblog.
ex) Unique blocks and unique tags
<!-- BEGIN block_name --> {tag_name} <!-- END block_name -->
Valid unique block names and unique tag names can replace "block_name" and "tag_name" respectively. You can use HTML tags in unique blocks.
ex) HTML tags are used in unique blocks
<div> <!-- BEGIN block_name --> <p>{tag_name}</p> <!-- END block_name --> </div>
Unique blocks are the closed areas between
and <!-- BEGIN block_name -->
. <!-- END block_name -->
is the name of the block. The number of blocks to be displayed will change depending on the selected mode. block_name
However, the areas between
and <!-- BEGIN XXXX -->
are regarded as unique blocks regardless of validity of the unique block name. <!-- END XXXX -->
Unique tags are dedicated tags described as
and "tag_name" is a name of the unique tag. What some tags show will vary depending on where the tags are placed. {tag_name}
Begin tag of the unique block
and end tag <!-- BEGIN block_name -->
should be used in separate lines. The uses of unique block shown below are wrong. <!-- END block_name -->
ex) Wrong use of unique block [1]
<div> <!-- BEGIN block_name --><p>{tag_name}</p><!-- END block_name --> </div>
ex) Wrong use of unique block [2]
<div><!-- BEGIN block_name --> <p>{tag_name}</p> <!-- END block_name --></div>
ex) Wrong use of unique block [3]
<div> <!-- BEGIN block_name --><p> {tag_name} </p><!-- END block_name --> </div>
| Unique block | Description |
|---|---|
| Affiliate program blocks | |
| amazon | displays amazon affiliate program related items. |
| List blocks | |
| archives | displays an archive list. |
| category | displays a category list. |
| latest_entry | displays a recent article list. |
| link | displays a link list. |
| recent_comment | displays a recent comment list. |
| recent_trackback | displays a recent trackback list. |
| selected_entry | displays a selected article list. |
| profile | displays a user list. |
| Title blocks | |
| title | displays a title. |
| Calendar blocks | |
| calendar | displays a calendar. |
| Article blocks | |
| entry | displays your article. This block repeats as many times as the number of relevant articles when you select page view mode or archive view mode. |
| Comment blocks | |
| comment | displays comment given to your article. This block repeats as many times as the number of given comments. |
| comment_area | displays only in individual article view mode. Comment form is included. |
| Page navigation blocks | |
| page | displays page navigation when you select page view mode. |
| Profile blocks | |
| profile_area | displays profile when you select profile view mode. |
| Trackback block | |
| trackback | displays trackbacks sent to your article. This block repeats as many times as the number of received trackbacks. |
| trackback_area | displays only in individual article view mode. Trackback urls are included. |
| Other blocks | |
| option | displays only in individual article view mode. |
| sequel | displays only in individual article view mode. Use this block in entry block. |
| Unique tag | Description |
|---|---|
| amazon block | |
| {amazon_item} | displays image, name and comment of the selected item. |
| {amazon_ProductName} | displays name of the selected item. |
| {amazon_Catalog} | displays genre of the selected item. |
| {amazon_Creator} | displays author of the selected item. |
| {amazon_ReleaseDate} | displays date of publishing of the selected item. |
| {amazon_Manufacturer} | displays publisher of the selected item. |
| {amazon_ImageUrlSmall} | displays image (small) of the selected item. |
| {amazon_ImageUrlMedium} | displays image (middle) of the selected item. |
| {amazon_ImageUrlLarge} | displays image (large) of the selected item. |
| {amazon_Availability} | displays note of the selected item. |
| {amazon_ListPrice} | displays list price of the selected item. |
| {amazon_OurPrice} | displays price of the selected item. |
| {amazon_comment} | displays comment on the selected item. |
| {amazon_url} | displays link to the selected item. |
| archives blocks | |
| {archives_list} | displays monthly archive. |
| category block | |
| {category_list} | displays category list. |
| {subcategory_list} | displays sub-category list. |
| latest_entry block | |
| {latest_entry_list} | displays a list of recent articles. |
| link block | |
| {link_list} | displays a list of links. |
| recent_comment block | |
| {recent_comment_list} | displays a list of recent comments. |
| recent_trackback block | |
| {recent_trackback_list} | displays a list of recent trackbacks. |
| selected_entry block | |
| {selected_entry_list} | displays a list of articles on the page currently shown. |
| profile block | |
| {user_list} | displays a list of registered users. |
| title block | |
| {blog_description} | displays subtitle of your weblog that is set in "Configuration" menu. |
| {blog_name} | displays title of your weblog that is set in "Configuration" menu. |
| {blog_name_only} | displays title of your weblog that is set in "Configuration" menu. (No link anchored) |
| Calendar block | |
| {calendar} | displays a calendar table. |
| {calendar2} | displays a calendar table with month and days of week shown above. |
| {calendar_horizontal} | displays a horizontal design calendar. |
| {calendar_vertical} | displays a vertical design calendar. |
| entry block | |
| {category_name} | displays names of categories. |
| {entry_date} | displays posted date of an article. |
| {entry_description} | displays body of an article. |
| {entry_permalink} | displays a link address of an article. |
| {entry_sequel} | displays sequel of an article. |
| {entry_time} | displays posted time of an article. |
| {entry_title} | displays title of an article. |
| {permalink} | displays a link address of an article. |
| {trackback_auto_discovery} | displays auto detection of trackbacks. |
| {user_name} | displays an author of an article. |
| {comment_num} | displays the number of comments posted to an article. |
| {trackback_num} | displays the number of trackbacks sent to an article. |
| {comment_count} | displays the number of comments posted to an article. (No link anchored) |
| {trackback_count} | displays the number of trackbacks sent to an article. (No link anchored) |
| {user_id} | displays an author ID of an article. |
| {category_id} | displays a category ID. |
| {entry_disp_time} | displays posted time of an article. (No link anchored) |
| {entry_excerpt} | displays summary of an article. |
| {entry_keyword} | displays keywords of an article. |
| {category_disp_name} | displays category name. (No link anchored) |
| {related_category} | displays a related category. |
| {related_category_disp} | displays a related category. (No link anchored) |
| sequel block | |
| {next_entry} | displays a link to the following article. |
| {next_permalink} | displays a permalink to the following article. |
| {next_title} | displays a title of the following article. |
| {prev_entry} | displays a link to the previous article. |
| {prev_permalink} | displays a permalink to the previous article. |
| {prev_title} | displays a title of the previous article. |
| page block | |
| {next_page_link} | displays a link to the following page. |
| {next_page_url} | displays an URL of the following page. |
| {page_now} | displays a page number of the page currently shown. |
| {page_num} | displays total number of pages. |
| {prev_page_link} | displays a link to the previous page. |
| {prev_page_url} | displays an URL of the previous page. |
| profile_area block | |
| {profile_description} | displays description of user profile. |
| {profile_name} | displays user full name. |
| comment_area block | |
| {comment_iconform} | displays a form to use a comment icons. |
| {entry_id} | displays an article ID. |
| comment block | |
| {comment_description} | displays posted comment. |
| {comment_name} | displays a name of commentator. |
| {comment_time} | displays posted time of a comment. |
| {comment_icon} | displays a selected comment icon. |
| trackback_area block | |
| {trackback_url} | displays an URL to send a trackback to. |
| trackback block | |
| {trackback_blog_name} | displays a name of trackback sender's weblog. |
| {trackback_excerpt} | displays article summary of trackback sender's weblog. |
| {trackback_time} | displays received time of a trackback. |
| {trackback_title} | displays a article title of trackback sender's weblog. |
| Other tags (Not for specific blocks) | |
| {site_atom} | displays an Atom Feed address of your weblog. |
| {site_css} | displays an address of style sheet. |
| {site_encoding} | displays character encoding of your weblog. |
| {site_lang} | displays language used in your weblog. |
| {site_rss} | displays an RSS address of your weblog. |
| {site_title} | displays a title of your weblog. |
| {site_cgi} | displays an address of a script for posting/searching comments. |
| {site_top} | displays a top page address of your weblog. |
| {selected_archive} | displays a selected archive type (category name if a category is selected). |
| {script_version} | displays a version number of Pukeko. |
| {script_name} | displays "Pukeko" as a script name. |
| {script_webpage} | displays an address of "Pukeko" official webpage. |
| {site_mobile} | displays an URL for access from cellphones. |
| {site_parts} | displays a directory address where image files for templates are saved. |
| {site_rsd} | displays an RSD address of your weblog. |
"Previous" and "Next" in navigation tags in page block and sequel block) follow the chronological order of your articles that are selected in "Configuration".
Cascade style sheet is written in CSS template.
You can use unique tags in CSS template.
| Unique tag | Description |
|---|---|
| {site_parts} | displays a directory address where image files for templates are saved. |
| {site_encoding} | displays character encoding of your weblog. |
| Unique tag | Description |
|---|---|
| {entry_link} | displays a link to an article. |
| {comment_link} | displays a link to comments. |
| {trackback_link} | displays a link to trackbacks. |
| Template | Description |
|---|---|
| Archive page | Select a template to be used in archive view mode. A base HTML template of the selected template will be used. |
| Profile page | Select a template to be used in profile view mode. A base HTML template of the selected template will be used. |
| Cellphone browser | Select a template to be used in cellphone browser. A base HTML template of the selected template will be used. |
| CSS template | Select whether to use a default CSS template or to use a CSS tempalte in the template package you select when you select other than the default template. |
You can customize time stamp formats.
Preset time stamp formats are as follows;
| Time stamp | Description | ex. |
|---|---|---|
| %Year% | displays year in 4 digits. | 2005 |
| %YearShort% | displays last 2 digits of year | 05 |
| %Mon% | displays month in 2 digits. "0" is added to the 1-digit month. | 03 |
| %MonShort% | displays month in abbreviated style. Example on the right is shown when you select English. | Mar. |
| %MonLong% | displays month in unabbreviated style. Example on the right is shown when you select English. | March |
| %MonNum% | displays month in either 1 or 2 digits. | 3 |
| %Day% | displays date in 2 digits. "0" is added to the 1-digit date. | 03 |
| %DayOrd% | displays date in ordinal numbers. | 3rd |
| %DayShort% | displays date in either 1 or 2 digits. | 3 |
| %Week% | displays day of the week in abbreviated style. Example on the right is shown when you select English. | Thu |
| %WeekLong% | displays day of the week in unabbreviated style. Example on the right is shown when you select English. | Thursday |
| %Hour% | displays time in 2 digits (0:00-24:00). "0" is added to the 1-digit hour. | 00 |
| %Hour24% | displays time in 2 digits (0:00-24:00). | 0 |
| %Hour11% | displays time in 2 digits (0:00-11:00). "0" is added to the 1-digit hour. | 00 |
| %Hour12% | displays time in 2 digits (1:00-12:00). "0" is added to the 1-digit hour. | 12 |
| %HourAP% | displays AM for time before noon and PM for time after noon. | AM |
| %Min% | displays minute in 2 digits. "0" is added to the 1-digit minute. | 00 |
| %Sec% | displays second in 2 digits. "0" is added to the 1-digit date. | 00 |
| %Zone% | displays time zone. | +0900 |
Stick limited holds the copyright of the template "Summer Breeze" and all the images used in the template. This template is packaged in the downloaded archive.
You are allowed to modify/customize the template "Summer Breeze" at your own risk, however, you are NOT allowed to distribute the modified/customized script without prior written consent by Stick limited.
We are happy if you leave copyright credits such as
and powered by Pukeko
on the template "Summer Breeze" undeleted.
Copyright © 2005 stick limited. All Rights Reserved.