/ 
Posy-0.90
/ posy_one

NAME

posy_one - Script which uses the Posy engine to generate one file from an input file.

VERSION

This describes version 0.90 of posy_one.

SYNOPSIS

posy_one --help | --manpage | --version

posy_one { --actions action } ( --base_dir dirname | --config_dir dirname --flavour_dir dirname --state_dir dirname ) [ --data_dir dirname { --DayWeek2Name num=name } [ --debug_level num ] { --entry_actions action } { --file_extensions extension=type } --flavour flavour [ --libdir dirname ] { --MonthNum2Name num=name } { --plugins plugin } --url url infile outfile

DESCRIPTION

This is a script which uses the Posy engine to generate one output file from one input file -- where the input file doesn't have to be under your usual data directory.

Instead, you can give another data directory; and if you give none, it defaults to the current directory.

This can be used to generate template files for other CGI scripts, where you want them to keep the same look-and-feel as the other pages in your site.

OPTIONS

--actions action

The list of actions which Posy will perform. Only use this if you're using a plugin which requires inserting a new action. Note that if you do, you must specify every action to be performed; once the default actions are not being used, they must be replaced completely.

--actions init_params --actions parse_path --actions process_path_error --actions set_config --actions index_entries --actions select_entries --actions filter_by_date --actions sort_entries --actions content_type --actions head_template --actions dynamic_css_set --actions theme_css_set --actions flavour_menu_set --actions head_render --actions do_entry_actions --actions foot_template --actions foot_render --actions render_page

--base_dir dirname

The base directory to use to set the flavour and config data directories if they are not explicitly set. This does not set the default for the data_dir.

--config_dir dirname

The directory where the config files are. Either set this or you can set --base_dir if your config files are in base_dir/config.

--data_dir dirname

The directory you wish to use as your input data directory. This is not supposed to be the same as your normal data directory, but I suppose it could be. If not given, it defaults to the current directory.

--DayWeek2Name num=name

This is a hash which sets how a day-of-the-week number will be converted into a name. Set this if you want, for example, all weekdays to be truncated. Most of the time one can leave it at the default.

--DayWeek2Name 0=Sunday --DayWeek2Name 1=Monday
--DayWeek2Name 2=Tuesday --DayWeek2Name 3=Wednesday
--DayWeek2Name 4=Thursday --DayWeek2Name 5=Friday
--DayWeek2Name 6=Saturday
--debug_level number

Turn on debugging. The larger the number, the more verbose the output. (don't do this unless you're a developer)

--entry_actions action

The list of actions which Posy will perform on each entry. Only use this if you're using a plugin which requires inserting a new action. Note that if you do, you must specify every action to be performed; once the default actions are not being used, they must be replaced completely.

--entry_actions header --entry_actions entry_template --entry_actions read_entry --entry_actions parse_entry --entry_actions short_body --entry_actions render_entry --entry_actions append_entry

--file_extensions ext=type

If you wish to change the default file extensions, then use this argument. Generally one would only do this if one had added a plugin to deal with a new kind of file. Or if one wanted to give a different extension to a standard type of file. Note that if you use this option, you must specify every file extension setting you want to use; the defaults are overridden.

--file_extensions txt=text --file_extensions html=html --file_extensions blx=blosxom
--flavour flavour

What flavour do you want the output to be?

--flavour_dir dirname

The directory where the flavour files are. Either set this or you can set --base_dir if your flavour files are in base_dir/flavours.

--flavour_dir /files/www/posy/data/flavours

--help

Print help message and exit.

--libdir dirname

If you installed the Posy modules in your home directory (or some other non-global place), then you need to tell this script where to look for them. Set --libdir to that directory.

For example, if you installed the Posy modules in /home/fred/perl (and thus the Posy.pm module file is in /home/fred/perl/lib) then

--libdir '/home/fred/perl/lib'

This assumes that any Posy plugins are also under the same directory.

--manpage

Print the full help documentation (manual page) and exit.

--MonthNum2Name

This is a hash which sets how a month-number will be converted into a name. Use this if you want, for example, all month-names to be truncated.

--MonthNum2Name 1=January --MonthNum2Name 2=February --MonthNum2Name 3=March --MonthNum2Name 4=April --MonthNum2Name 5=May --MonthNum2Name 6=June --MonthNum2Name 7=July --MonthNum2Name 8=August --MonthNum2Name 9=September --MonthNum2Name 10=October --MonthNum2Name 11=November --MonthNum2Name 12=December

--plugins plugin

If you wish to use any plugins, you must put them in the plugins list, as well as installing the actual plugin modules.

For example, if you are using the Posy::Plugin::TextTemplate module, then the TextTemplate module should be installed in the same way that you installed the core Posy modules.

Then you add the name of the plugin to this plugins list.

--plugins Posy::Plugin::TextTemplate --plugins Posy::Plugin::TextToHTML

Remember that the order of plugins in the list is important if two plugins override the same function.

Note that this will always use the Posy::Core plugin.

--state_dir dirname

The directory where "state" information is put.

--url url

What is my preferred base URL for this site/blog? (needs to be set for static generation, even if you didn't need to set it for dynamic generation).

--verbose

Print informational messages.

--version

Print version information and exit.

REQUIRES

Getopt::Long
Pod::Usage
Getopt::ArgvFile
Posy
Cwd

SEE ALSO

perl(1) Getopt::Long Getopt::ArgvFile Pod::Usage

BUGS

Please report any bugs or feature requests to the author.

AUTHOR

Kathryn Andersen (RUBYKAT)
perlkat AT katspace dot com
http://www.katspace.com

COPYRIGHT AND LICENCE

Copyright (c) 2004 by Kathryn Andersen

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.