Woclema - Weblog, Originally Command Line Editable/Manageable
PrevNext

5. Configuration

Woclema reads its configuration from Woclema/Config.pl. The file is Perl-script, so extra care must be taken when editing the file. Also notice that if write_entry.pl and other helper scripts are not in the same directoyr with weblog.pl, each copy of Woclema/Config.pl is expected to be identical. On UNIX systems this can easily be done with symbolic links.

While the configuration file is in Perl, you do not need to be a programmer to be able to edit it. If you mimic the format of the file, you will notice the default configuration is very simple: each configuration option is on separate line, defined like $option = value. Numerical values are written as-is, literal values in double quotes.

Default configuration file should be used as up-to-date reference of available options. This documentation may lag behind. I repeat, see the configuration file for fresh instructions.

rewrite

Defines if HTTP-server has been set up to accept rewritten URIs. Set this value 0 to disable, 1 to use URIs like entry-N, and 2 to use URIs like entry/1.

db_host

Database host address. Address must be resolvable from CGI-script. Must be set.

db_port

Database post. Will use default port if left undefined.

db_db

Database name. Must be set.

db_user

Database user.

db_pass

Database password.

base_url

Base URI for the weblog. If defined, base URI will be used with all generated URIs. In practice this option must be set if rewrite is set to 2.

latest_count

Number of weblog entries to show on default page.

old_months

Number of months to show under monthly calendar.

verbose_single_latest

If default page contains exactly one entry, the entry will be shown fully with comments visible. Set to 1 to enable, 0 to disable.

verbose_limit_day

If selected day has fewer or equal number of entries than verbose_limit_day, entries will be shown will full text, but without comments. If day has more entries, only their titles are shown.

verbose_single_day

If selected day has exactly one entry, the entry will be shown fully with comments visible. Set to 1 to enable, 0 to disable.

verbose_limit_month

Same as verbose_limit_day but for selected month.

verbose_single_month

Same as verbose_single_day but for selected month.

verbose_limit_category

Same as verbose_limit_day but for selected entry category.

verbose_single_category

Same as verbose_single_day but for selected entry category.

feed_title

Item feed title, if atom.pl is used.

feed_author_name

Feed author name.

feed_author_email

Feed author e-mail address.

feed_entries

Number of weblog entries to show in item feed.

feed_content_length

Number of words of entry content to include in the feed entry. Set to 0 to disable printing contnent, -1 to include complete entry. Note that in certain cases number of words may not be exact.

PrevHomeNext
Installation Usage