publish_cloud(1)

NAME
publish_cloud - convert a directory hierarchy to a web-ready format

SYNOPSIS
publish_cloud [options] source target

DESCRIPTION
publish_cloud converts all files under the source path to web-ready formats in the same hierarchy under the the target path, provided an applicable conversion scheme is available. An index of converted documents, also arrange hierarchically, can optionally be written at the top of the hierarchy as an HTML document (index.html) or snippet (index.m4).

File types are determined by file extensions. Text files (.txt) and files without an extension are probed for markdown and reStructuredText formatting, and treated as such when warranted.

If source is omitted, ~/Documents/Cloud is used. If target is omitted, ~/Sites/Cloud/Documents is used.

Files of types, and files of known types whose conversion utilities are missing, are ignored.

OPTIONS

-i FORMAT, --index-format=FORMAT
    Choose a file format for the document index. Use html to write a complete HTML document, m4 to write an HTML snippet, or none to suppress the index file altogether.

-s SORT, --sort=SORT
    Specify sort order for the document index. Sorting by name provides an alphabetical sort. Sorting by type arranges directories first, then files; within the types, sorting is alphabetic.

EXIT STATUS
0 on success, non-0 on error.

NOTES
tasks.py reads and writes only UTF-8, because it's no longer the bad old days.

SEE ALSO
queue2ics(1), rst2html(1), tasks(1), unrtf(1),

AUTHOR
Perette Barella <perette@deviousfish.com>