diff --git a/mowyw.1.txt b/mowyw.1.txt deleted file mode 100644 index 1527b28..0000000 --- a/mowyw.1.txt +++ /dev/null @@ -1,456 +0,0 @@ -=head1 NAME - -mowyw - Macro processor and Offline Content Management System - -=head1 SYNOPSIS - - $ mowyw - $ mowyw --make --source-prefix sp --destination-prefix dp --menu-prefix mp - --includes-prefix=ip --postifx=.html --quiet - -=head1 DESCRIPTION - -mowyw is a text processor for building static websites. It supports includes, -menus, external datasources (like XML files or databases) and syntax -hilighting. - -To use mowyw you need three directories called B, B and -B. C holds the source files that are to be interpreted by -mowyw. When you run mowyw, it will walk (recursively) through the source dir, -and for each file it either copies it verbatimely to C, or, if the file -looks like HTML (ends on .html, .shtml, .htm etc.) it is processed by mowyw, -and the output is written into the online dir. - -In C are include files (how surprising), header, footer, global -include files, and optionally data source files. - -You should always execute mowyw from the parent directory of these three -directories. - -The name of these three directories can be overridden with command line -options. - -=head1 COMMAND LINE OPTIONS - -=over - -=item --make - -Only process files with a newer timestamp than the corresponding C -file. Note that this does not account for dependencies on include files and menu -files. - -=item --quiet - -Don't produce diagnostics or progress output - -=item --postfix - -Append the given postfix to the filename of all included file names (and -menu files). Defaults to the empty string. - -=item --includes-prefix - -Change the search path for include files. Defaults to C. - -=item --menu-prefix - -Change the search for menu files. Defaults to C. - -=item --destination-prefix - -Change the path for the output files. Defaults to C. - -=item --source-prefix - -Change the search path for source files. Defaults to C. Must be a -directory. - -=item --encoding - -Interpret all input files to have that encoding. Defaults to UTF-8. -(Conjecture: should default to the current locale... what to do?). - -=back - -All options except C<--make> can be specified in a config file, with more -customization options. - -=head1 PROCESSING ORDER - -mowyw processes files in several steps: - -=over - -=item - -The file *mowyw.conf* is read (if it exists) - -=item - -The source directory is traversed - -=item - -For all source file that is actually processed - -=over 8 - -=item - - -the file C is read, if it exists - -=item - - -the current file is read, all markup is processed - -=item - - -the file C is processed and prepended to the current -output file - -=item - - -the file C is processed and appended to the current -output file - -=back - -=back - - -=head1 MARKUP - -Normal text (including HTML markup) is copied verbatimely to the output file. - -Special directives are delimited either with C<[% ... %]> (preferred) or with -C<[[[ ... ]]]> (deprecated, but still supported for compatibility). - -Many elements take options, which are usually whitespace delimited, for -example C<[% include includefile.html %]>. - -Inline elements consist only of one tag, while block elements run until the -matching end tag. - -The following inline elements are supported: - -=over - -=item - -C includes a file, and processes it. Example: -C<`[% include coypright.html %]>. - -=item - -C refers to a menu. See section L below. - -=item - -C defines a menu item. See section L below. - -=item - -C