From 06145fcda953ce6ea963b63a91e4ac8103c9cc58 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Fri, 14 Feb 2014 00:26:53 -0500 Subject: v5 v6: ocn, object citation numbering, --no-numbering option & default tuning * add less cryptic --numbering --no-numbering command-line options (to --no-ocn) * plaintext & odt switch default to ocn==true for consistency with other output * [decide how fine-grained ocn/numbering switches could be: could be per output type by command-line instruction (see txt & odt); currently set per sisu instruction for all outputs] --- README | 71 +++++++++++++++++++++++++++++++++--------------------------------- 1 file changed, 36 insertions(+), 35 deletions(-) (limited to 'README') diff --git a/README b/README index 16c4cadb..2fbe3bf8 100644 --- a/README +++ b/README @@ -253,7 +253,7 @@ paragraph --unix for unix linefeed (default) --msdos for msdos linefeed) assumed for most other flags, creates new intermediate files for processing (abstract objects, document abstraction) that is used in all subsequent processing of other output. This step is assumed for most processing flags. To -skip it see -n. Alias -m. (sisu v5) +skip it see -n. Alias -m. *-b [filename/wildcard]* see --xhtml @@ -310,16 +310,14 @@ see --pg see --sqlite *--dal [filename/wildcard/url]* -assumed for most other flags, creates new intermediate files for processing -(abstract objects, document abstraction) that is used in all subsequent -processing of other output. This step is assumed for most processing flags. To -skip it see -n. Renamed --ao (abstract objects) in sisu v5. Alias -m +(abstract objects, document abstraction renamed abstract objects in sisu5) see +--ao *--delete [filename/wildcard]* see --zap *--docbook [filename/wildcard/url]* -docbook smart text (sisu v5) +docbook smart text (not available) *--dump[=directory_path] [filename/wildcard]* places output in directory specified, if none is specified in the current @@ -333,23 +331,23 @@ see --epub produces an epub document, [sisu version >=2 ] (filename.epub). Alias -e *--exc-** -exclude output feature, overrides configuration settings --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); ---exc-minitoc, (exclude mini table of contents, affects html (seg), -concordance, manifest); --exc-manifest-minitoc, (exclude mini table of -contents, affects manifest); --exc-html-minitoc, (exclude mini table of -contents, affects html (seg), concordance); --exc-html-navigation, (exclude -navigation, affects html (seg)); --exc-html-navigation-bar, (exclude navigation -bar, affects html (seg)); --exc-html-search-form, (exclude search form, affects -html (seg, scroll)); --exc-html-right-pane, (exclude right pane/column, affects -html (seg, scroll)); --exc-html-top-band, (exclude top band, affects html (seg, -scroll), concordance (minitoc forced on to provide seg navigation)); ---exc-segsubtoc (exclude sub table of contents, affects html (seg), epub) ; see -also --inc-* +exclude output feature, overrides configuration settings --exc-numbering, see +--exc-ocn; --exc-ocn, (exclude "object citation numbering", (switches off +object citation numbers), 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); --exc-minitoc, (exclude mini table of contents, +affects html (seg), concordance, manifest); --exc-manifest-minitoc, (exclude +mini table of contents, affects manifest); --exc-html-minitoc, (exclude mini +table of contents, affects html (seg), concordance); --exc-html-navigation, +(exclude navigation, affects html (seg)); --exc-html-navigation-bar, (exclude +navigation bar, affects html (seg)); --exc-html-search-form, (exclude search +form, affects html (seg, scroll)); --exc-html-right-pane, (exclude right +pane/column, affects html (seg, scroll)); --exc-html-top-band, (exclude top +band, affects html (seg, scroll), concordance (minitoc forced on to provide seg +navigation)); --exc-segsubtoc (exclude sub table of contents, affects html +(seg), epub) ; see also --inc-* *-F [--webserv=webrick]* see --sample-search-form @@ -358,7 +356,7 @@ see --sample-search-form see --find *--fictionbook [filename/wildcard/url]* -fictionbook smart text (sisu v5) +fictionbook smart text (not available) *--find [optional string part of filename]* without match string, glob all .sst .ssm files in directory (including language @@ -453,7 +451,7 @@ maintenance mode, interim processing files are preserved and their locations indicated. (also see -V). Aliases -M and --keep-processing-files. *--markdown [filename/wildcard/url]* -markdown smart text (sisu v5) +markdown smart text (not available) *--manpage [filename/wildcard]* produces man page of file, not suitable for all outputs. Alias -i @@ -478,11 +476,14 @@ by most processing flags. *--no-** see --exc-* +*--numbering* +turn on "object citation numbers". See --inc-ocn and --exc-ocn + *-o [filename/wildcard/url]* see --odt *--ocn* -see --inc-ocn and --exc-ocn +"object citation numbers". See --inc-ocn and --exc-ocn *--odf [filename/wildcard/url]* see --odt @@ -586,7 +587,7 @@ subdirectory under the current directory (pwd). Unlike using default settings /HTML/ files have embedded css. Compare --dump *--rst [filename/wildcard/url]* -ReST (rST restructured text) smart text (sisu v5) +ReST (rST restructured text) smart text (not available) *--rsync [filename/wildcard]* copies sisu output files to remote host using rsync. This requires that @@ -679,7 +680,7 @@ see --txt produces texinfo and info file, (view with pinfo). Alias -I *--textile [filename/wildcard/url]* -textile smart text (sisu v5) +textile smart text (not available) *--txt [filename/wildcard]* produces /plaintext/ with Unix linefeeds and without markup, (object numbers @@ -2206,13 +2207,13 @@ Configure substitution in _sisu/sisu_document_make Filetype: SiSU text insert 5.0, Source digest: SHA256(README.ssm.sst)= - 5927789066d1eb9cf0321946d46e3ce2a66414557038d5c745bb009233611dd8 + e9ee6379dcf3a05c2b0ae19f091f7e2b1579d7b8a683996a8c53eb57249497c4 - Generated by: Generated by: SiSU 6.0.1 of 2014w05/2 (2014-02-04) + Generated by: Generated by: SiSU 6.0.4 of 2014w06/5 (2014-02-14) - Ruby version: ruby 2.0.0p353 (2013-11-22) [i386-linux-gnu] + Ruby version: ruby 2.1.0p0 (2013-12-25) [i386-linux-gnu] - Document (ao) last generated: 2014-02-04 23:45:41 -0500 + Document (ao) last generated: 2014-02-14 00:05:38 -0500 ============================================================================== @@ -2230,7 +2231,7 @@ at: -* Generated by: SiSU 6.0.3 of 2014w05/4 (2014-02-06) -* Ruby version: ruby 2.0.0p353 (2013-11-22) [i386-linux-gnu] -* Last Generated on: 2014-02-08 20:38:31 -0500 +* Generated by: SiSU 6.0.4 of 2014w06/5 (2014-02-14) +* Ruby version: ruby 2.1.0p0 (2013-12-25) [i386-linux-gnu] +* Last Generated on: 2014-02-14 00:05:39 -0500 * SiSU http://www.sisudoc.org/ -- cgit v1.2.3