theme(1) create a web page from a template file


[-C option-flags ] [-c options ] [-d root ] [-E ] [-f ] [-o file ] [-p pagename ] [-t template ] [-V ] [textfile ]


The utility takes a markdown(7)Ns-formatted textfile (or stdin if not specified,) compiles it, and combines it with a template Po page.theme by default Pc to produce a web page. If a path to the template is not specified, looks for page.theme in the current directory, then each parent directory up to the document root Po set with -d or, if unset, the root directory of the system. Pc If page.theme is found, copies it to the output, looking for <?theme action?> html tags and processing the embedded action as appropriate.

processes the following actions:

Prints the author name(s) from the mkd_doc_author3 function.
Prints the formatted markdown(7) input file.
Prints the date returned by mkd_doc_date3 or, if none, the date the input file was last modified.
Prints the directory part of the pagename
include (file )
Prints the contents of file Markdown(7) translation will NOT be done on this file.
The filename part of the pagename.
Print any stylesheets (see mkd-extensions7 ) found in the input file.
Print the title returned by mkd_doc_title3, or, if that does not exist, the source filename.
Print the version of discount(7) that this copy of theme was compiled with.

If input is coming from a file and the output was not set with the -o option, writes the output to file-sans-text.html (if ) file has a .text suffix, that will be stripped off and replaced with .html otherwise a .html will be appended to the end of the filename.)

The options are as follows:

-d root
Set the document root to root
Normally theme will not expand <?theme body?> or <?theme toc?> in the <head> section, or <?theme style?> in the <body> section, but the -E option overrides this and allows expansions everywhere.
Forcibly overwrite existing html files.
-o filename
Write the output to filename
-p path
Set the pagename to path
-t filename
Use filename as the template file.


The utility exits 0 on success, and >0 if an error occurs.


An David Parsons ([email protected] )