From 3faa85c6816466b6417891315f1402de4a4366fa Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Mon, 28 May 2012 04:34:33 -0400 Subject: v3: documentation update, command line control of output dir structure * --output-by-language; --output-by-filetype; --output-by-filename, or --by-language; --by-filetype; --by-filename * sisu_commands.ssi, manpage sisu.1, man2html --- .../sisu/markup-samples/sisu_manual/sisu_commands.sst | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) (limited to 'data/doc/sisu/markup-samples/sisu_manual/sisu_commands.sst') diff --git a/data/doc/sisu/markup-samples/sisu_manual/sisu_commands.sst b/data/doc/sisu/markup-samples/sisu_manual/sisu_commands.sst index 405b5b89..ff3b6a41 100644 --- a/data/doc/sisu/markup-samples/sisu_manual/sisu_commands.sst +++ b/data/doc/sisu/markup-samples/sisu_manual/sisu_commands.sst @@ -21,7 +21,7 @@ :issued: 2002-08-28 :available: 2002-08-28 :published: 2007-09-16 - :modified: 2011-09-18 + :modified: 2012-05-25 @make: :num_top: 1 @@ -63,6 +63,9 @@ produces plaintext with Unix linefeeds and without markup, (object numbers are o !_ -b [filename/wildcard] \\ see --xhtml +!_ --by-* \\ +see --output-by-* + !_ -C \\ configure/initialise shared output directory files initialize shared output directory (config files such as css and dtd files are not updated if they already exist unless modifier is used). -C --init-site configure/initialise site more extensive than -C on its own, shared output directory files/force update, existing shared output config files such as css and dtd files are updated if this modifier is used. @@ -104,7 +107,7 @@ produces an epub document, [sisu version >=2 ] (filename.epub). Alias -e !_ --exc-* \\ exclude output feature, overrides configuration settings - --exc-ocn, (exclude object citation numbering, affects html (seg, scroll), epub, xhtml, xml); + --exc-ocn, (exclude object citation numbering, (switches off object citation numbering), affects html (seg, scroll), epub, xhtml, xml, pdf); --exc-toc, (exclude table of contents, affects html (scroll), epub, pdf); --exc-links-to-manifest, --exc-manifest-links, (exclude links to manifest, affects html (seg, scroll)); --exc-search-form, (exclude search form, affects html (seg, scroll), manifest); @@ -195,9 +198,6 @@ skip the creation of intermediate processing files (document abstraction) if the !_ --no-* \\ see --exc-* -!_ --no-ocn \\ -[with --html --pdf or --epub] switches off object citation numbering. Produce output without identifying numbers in margins of html or LaTeX/pdf output. - !_ -o [filename/wildcard/url] \\ see --odt @@ -207,6 +207,13 @@ see --odt !_ --odt [filename/wildcard/url] \\ output basic document in opendocument file format (opendocument.odt). Alias -o +!_ --output-by-* \\ +select output directory structure from 3 alternatives: +--output-by-language, (language directory (based on language code) with filetype (html, epub, pdf etc.) subdirectories); +--output-by-filetype, (filetype directories with language code as part of filename); +--output-by-filename, (filename directories with language code as part of filename). +This is configurable. Alias --by-* + !_ -P [language_directory/filename language_directory] \\ see --po4a -- cgit v1.2.3