Download Pukeko archive from pukeko.net.
You will find several archives there.
Archives you will download are compressed in "zip".
You need software to decompress them. Refer to Software for software recommendation.
Pukeko archive is encrypted. You need to enter the passcode that will be sent to you upon receipt of your payment.
Pukeko is a weblog management system using CGI written in Perl.
CGI (Common Gateway Interface) is one of the interfaces to show the programmed contents on web browser. Pukeko uses CGI to show the requested contents.
Pukeko is not a system such as the one rental weblog service provides.
Pukeko is a program that displays the requested contents on web browsers.
You need to upload whole script set to web server to use Pukeko.
You can upload them using FTP (File Transfer Protocol). Refer to Software for recommended software.
Some settings are required to the uploaded files.
In most cases, Pukeko will not start working only by uploading files to web server.
You need to set permission to uploaded files and directories.
Permissions to "read", "write", and "execute" the uploaded files need to be set on most of web servers.
Ask your web server administrator about appropriate permission settings as they are often quite different depending on web servers.
Outline of installation is as follows;
Procedures in bold fonts are must-do's. Other essential settings will be done by using the installer.
Operation has been confirmed in both Perl 5.8 (5.008) and Perl 5.6(5.006).
You may not be able to use some of the functions depending on your environment where the necessary libraries are not available.
"Pukeko" needs the following external libraries.
If Image::Magick is ready to use in your environment, "Pukeko" can generate Thumbnails (small images) at the same time when you upload image files.
If Net::SMTP is ready to use in your environment, you can use mail notification without "sendmail".
Image::Magick and Net::SMTP are not necessary to use "Pukeko".
Above-mentioned external libraries are provided in "pukeko_ext" that you can download from pukeko.net.
An "installer" can check if you have above-mentioned libraries.
| File/Directory | Note |
|---|---|
| blog.cgi | Main script |
| admin.cgi | Administration script |
| cnt.cgi | Script for collecting access logs |
| install.cgi | Installer script for initial setup |
| init.cgi | Setting file |
| index.html | HTML file for your top page |
| style.css | CSS file for your weblog |
| lib/ | Directory for libraries |
| ext/ | Directory for external libraries (if required) |
| lock/ | Directory for lock files |
| data/ | Directory for data files |
| log/ | Directory for html files that are generated in your weblog |
| img/ | Directory for uploaded image files |
| doc/ | Directory for help documents |
| plugin/ | Directory for plugins |
| template/ | Directory for imported template image parts |
A dummy file called "dummy.txt" is saved in some directories such as log, img, and data. Delete this file after decompressing archive as it is not needed.
The installer will check if permissions of directories are properly set.
It is recommended to delete the installer from your web server after initial setup.
Example of file permission setting is shown below. Permission setting on your web server may be different. Ask your web server administrator about details of CGI permission.
| Files and Directories | Permission/Note |
|---|---|
| blog.cgi | [755]* |
| admin.cgi | [755]* |
| cnt.cgi | [755]* |
| install.cgi | [755]* |
| init.cgi | [644] |
| index.html | [666]* |
| style.css | [666]* |
| lib/ | [755] for this directory, [644] for the files in this directory |
| ext/ | [755] for this directory, [644] for the files in this directory |
| lock/ | [777]* |
| data/ | [777]* |
| log/ | [777]* |
| img/ | [777]* |
| doc/ | [755] for this directory, [644] for the files in this directory |
| plugin/ | [755] for this directory, [644] for the files in this directory |
| template/ | [777]* |
Example where Pukeko is placed on /public_html/pukeko/ is as follows.
- /public_html/
- pukeko/
- index.html [666]*
- style.css [666]*
- admin.cgi [755]*
- blog.cgi [755]*
- cnt.cgi [755]*
- install.cgi [755]*
- init.cgi [644]
- data/ [777]*
- log/ [777]*
- img/ [777]*
- lock/ [777]*
- doc/ [755]
- src/ [755]
- en.html [644]
- lib/ [755]
- resource/ [755]
- pukeko/ [755]
- XML/ [755]
- library files... [644]
- ext/ [755]
- plugin/ [755]
- template/ [777]*
The symbol * means that you need to set permission to those files and directories.
You can change the places of log, img, index.html and style.css. Place these files and directories in base directories which you set in "Configuration" menu. If you change the places of these files, you still need to set permission.
You can change names of "log" directory and "img" directory in "Configuration" menu.
Set the first line of the following scripts,
, according to your web server instructions. #!/usr/bin/perl
blog.cgi, cnt.cgi, install.cgi, and admin.cgi
You do not need to change settings of the scripts in lib/ directory.
Replace the files in the following directories with the new ones.
You need to replace the relevant files in plugin/ upon upgrading or changes of plugins.
Be careful not to delete other plugin files in plugin/.
FTP software (client) is generally used to upload Pukeko to your web server.
Text editor is used to edit init.cgi, etc. It is rather not recommended to use Windows "Notepad".
File decompression software is used for decompressing the archive files that you can download from pukeko.net.
For Mac OS X users, above-mentioned software is not required as you can use "Terminal.app" instead.
The downloaded archive can be also decompressed by
if you can use "unzip" in command line. (unzip pukeko1xx.zip
part is archive version dependent.)pukeko1xxx
These are a lot more software with these functions. It is a good idea to have a look in the internet and find something you like.