SysTutorials

Linux Manual Pages › Section 1

discount-theme(1)

NAME

theme – create a web page from a template file

SYNOPSIS

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

DESCRIPTION

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:

author
Prints the author name(s) from the mkd_doc_author3 function.
body
Prints the formatted markdown(7) input file.
date
Prints the date returned by mkd_doc_date3 or, if none, the date the input file was last modified.
dir
Prints the directory part of the pagename
include (file )
Prints the contents of file Markdown(7) translation will NOT be done on this file.
source
The filename part of the pagename.
style
Print any stylesheets (see mkd-extensions7 ) found in the input file.
title
Print the title returned by mkd_doc_title3, or, if that does not exist, the source filename.
version
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
-E
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.
-f
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.

RETURN VALUES

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

SEE ALSO

markdown(1), markdown(3), markdown(7), mkd-extensions7.

AUTHOR

An David Parsons (orc [at] pell.portland.or.us )