diff options
Diffstat (limited to 'data')
| l--------- | data/doc/sisu/html/_sisu | 1 | ||||
| -rw-r--r-- | data/doc/sisu/html/homepage/index.html | 264 | ||||
| l--------- | data/doc/sisu/html/index.html | 1 | ||||
| -rw-r--r-- | data/doc/sisu/html/sisu3.1.html | 3520 |
4 files changed, 0 insertions, 3786 deletions
diff --git a/data/doc/sisu/html/_sisu b/data/doc/sisu/html/_sisu deleted file mode 120000 index 0e977351..00000000 --- a/data/doc/sisu/html/_sisu +++ /dev/null @@ -1 +0,0 @@ -../sisu_manual/_sisu
\ No newline at end of file diff --git a/data/doc/sisu/html/homepage/index.html b/data/doc/sisu/html/homepage/index.html deleted file mode 100644 index 6c55c9c0..00000000 --- a/data/doc/sisu/html/homepage/index.html +++ /dev/null @@ -1,264 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> -<head> -<title>SiSU information Structuring Universe - Structured -information, Serialized Units - software for electronic texts, -documents, books, digital libraries in plaintext, html, xhtml, XML, -ODF (OpenDocument), LaTeX, pdf, SQL (PostgreSQL and SQLite), and -for search</title> -<meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> -<meta name="dc.title" content= -"SiSU information Structuring Universe, Structured information Serialised Units, 2007" /> -<meta name="dc.creator" content="Ralph Amissah" /> -<meta name="dc.subject" content= -"ebook, publishing, pdf, LaTeX, XML, ODF, SQL, postgresql, sqlite, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search, digital library" /> -<meta name="dc.publisher" content= -"SiSU http://www.jus.uio.no/sisu" /> -<meta name="dc.language" content="en" /> -<meta name="dc.rights" content="Copyright Ralph Amissah" /> -<meta name="generator" content="SiSU 0.48.9 of 2007w01/1 (20070101) (n*x and Ruby!)" /> -<link rel="generator" href="http://www.jus.uio.no/sisu/SiSU" /> -<link rel="stylesheet" href="./_sisu/css/html.css" type="text/css" /> -<link rel="shortcut icon" href="./_sisu/image/rb7.ico" /> -</head> -<body> -<div id="top_band"> -<p class="top_band_image"> - <a href="http://www.jus.uio.no/sisu/SiSU" target="_top" > - <img border="0" src="./_sisu/image/sisu.png" alt="SiSU >>"> - </a> -</p> -<h1 class="top_band"> - SiSU information Structuring Universe -</h1> -<h2 class="top_band_tiny"> - Structured information, Serialized Units -</h2> -<h2 class="top_band_tiny"> -software for electronic texts, document collections, books, digital libraries, and search -</h2> -<h2 class="top_band_tiny"> - with "atomic search" and text positioning system (shared text citation numbering: "<i>ocn</i>") -</h2> -<h2 class="top_band_tiny"> -outputs include: plaintext, html, xhtml, XML, ODF (OpenDocument), LaTeX, pdf, SQL (PostgreSQL and SQLite) -</h2> -</div> -<div id="column_left"> -<p class="bold"> - <a href="http://www.jus.uio.no/sisu/SiSU" target="_top" > - SiSU - </a> -</p> -<p class="tiny"> - --- -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/SiSU/1.html#summary" target="_top" > - What does SiSU do? Summary - </a> -</p> -<p class="tiny"> - --- -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/SiSU/2.html" target="_top" > - Book Samples and Markup Examples - </a> -</p> -<p class="tiny"> - --- -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/SiSU/1.html#ocn" target="_top" > - Object Citation Numbering - <i>ocn</i> - </a> -</p> -<p class="tiny">(a text positioning system)</p> -<p class="tiny"> - --- -</p> -<p class="small"> -<p> - <a href="http://www.jus.uio.no/sisu/SiSU/1.html#search" target="_top" > - Search - "<i>Atomic</i>" - </a> -</p> -<p class="tiny"> - Of interest is the ease of streaming documents to a relational database, at an object (roughly paragraph) level and the potential for increased precision in the presentation of matches that results thereby. The ability to serialise html, LaTeX, XML, SQL, (whatever) is also inherent in / incidental to the design. For a description see the - <a href="http://www.jus.uio.no/sisu/sisu_provisional_patent_application_200408" target="_top" > - abandoned U.S. provisional patent application - </a> -</p> -<p class="tiny"> - --- -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/SiSU/download.html" target="_top" > - <b>Download</b> - </a> -</p> -<p class="tiny"> - --- -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/SiSU/changelog.html" target="_top" > - Changelog - </a> -</p> -<p class="tiny"> - --- -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/SiSU/license.html" target="_top" > - License - </a> -</p> -<p class="tiny"> - Gnu / Linux / Unix -</p> -<p class="tiny"> - ============= -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/man" target="_top" > - sisu man pages - </a> -</p> -<p class="tiny"> - --- -</p> -<p class="tiny"> - document preparation can be on any platform, in any editor: - (syntax highlight support currently for: vim, kate, write, gedit, diakonos) -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/syntax_highlight" target="_top" > - Syntax highlighting - </a> -</p> -<p class="tiny"> - ============= -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/SiSU" target="_top" > - * Composite document - </a> -</p> -<p class="tiny"> - the composite document is a superset of the following documents: -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/sisu_description" target="_top" > - SiSU description - </a> -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/sisu_examples" target="_top" > - SiSU examples - </a> -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/sisu_chronology" target="_top" > - SiSU chronology - </a> -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/sisu_technical_info" target="_top" > - SiSU technical - </a> -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/sisu_faq" target="_top" > - SiSU FAQ - </a> -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/sisu_download" target="_top" > - SiSU download - </a> -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/sisu_changelog" target="_top" > - SiSU changelog - </a> -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/sisu_license" target="_top" > - SiSU license - </a> -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/sisu_standard" target="_top" > - SiSU standard - </a> -</p> -<p class="small"> - <a href="http://www.jus.uio.no/sisu/sisu_provisional_patent_application_200408" target="_top" > - SiSU abandoned provisional patent - </a> -</p> -<p class="tiny"> - Note: the placement of SiSU documents on the Net predate the release of SiSU. -</p> -</div> -<div id="column_center"> -<p class="bold"> - For less markup than the most elementary HTML you can have so much more. -</p> -<p><a href="http://www.jus.uio.no/sisu/SiSU" target="_top" ><b>SiSU</b> - Structured information, Serialized Units</a> for Electronic Documents, is an information structuring, transforming and publishing framework with the following features:</p> -<p><b>(i)</b> markup syntax: (a) simpler than html, (b) mnemonic, influenced by mail/messaging/wiki markup practices, (c) human readable, and easily writable,</p> -<p><b>(ii)</b> (a) minimal markup requirement, (b) single file marked up for multiple outputs,</p> -<p><b>(iii)</b> (a) multiple outputs include amongst others: html; pdf via LaTeX; (structured) XML; ODF (OpenDocument); sql - currently PostgreSQL (and SQLite); ascii, (also texinfo), (b) takes advantage of the strengths implicit in these very different output types, (e.g. pdfs produced using typsetting of LaTeX, databases populated with documents at an individual object/paragraph level, with implications for search possibilities...)</p> -<p><b>(iv)</b> provides a common object positioning and citation system for all outputs, which is human relevant and machine usable: <u><i>object citation numbering</i></u>, all objects (paragraphs, headings, verse, tables etc. and images) are numbered identically, for citation purposes, in all outputs (html, pdf, sql etc.),</p> -<p><b>(v)</b> use of Dublin Core and other meta-tags to permit the addition of some semantic information on documents, and making easy integration of rdf/rss feeds etc.,</p> -<p><b>(vi)</b> creates organised directory/file structure for (file-system) output, easily mapped with its clearly defined structure, with all text objects numbered, you know in advance where in each document output type, a bit of text will be found (eg. from an sql search, you know where to go to find the prepared html output or pdf etc.)... there is more; easy directory management and document associations, the document preparation (sub-)directory may be used to determine output (sub-)directory, the skin used, and the sql database used,</p> -<p><b>(vii)</b> search of document sets, at object/paragraph level, the relational database retains information on the document structure, and citation numbering makes it possible for example to present search matches as an index of documents and locations within the document where the match is found,</p> -<p><b>(viii)</b> "Concordance file" wordmap, consisting of all the words in a document and their (text/ object) locations within the text, (and the possibility of adding vocabularies),</p> -<p><b>(ix)</b> document content certification and comparison considerations: (a) the document and each object within it stamped with an md5 hash making it possible to easily check or guarantee that the substantive content of a document is unchanged, (b) version control, documents integrated with time based source control system, default RCS or CVS with use of $Id$ tag, which SiSU checks -<p><b>(x)</b> SiSU's minimalist markup makes for meaningful "diffing" of the substantive content of markup-files,</p> -<p><b>(xi)</b> easily skinnable, document appearance on a project/site wide, directory wide, or document instance level easily controlled/changed,</p> -<p><b>(xii)</b> in many cases a regular expression may be used (once in the document header) to define all or part of a documents structure obviating or reducing the need to provide structural markup within the document,</p> -<p><b>(xiii)</b> is a batch processor for handling large document sets, ... though once generated they need not be re-generated, unless changes are made to the desired presentation of a particular output type,</p> -<p><b>(xiv)</b> possible to pre-process, which permits: the easy creation of standard form documents, and templates/term-sheets, or; building of composite documents (master documents) from other sisu marked up documents, or marked up parts, i.e. import documents or parts of text into a main document should this be desired</p> -<p><b>(xv)</b> future proofing, a framework for adding further capability or updating existing capability as required: (a) modular, (thanks in no small part to Ruby) another output format required, write another module....(b) easy to update output formats (eg html, xhtml, latex/pdf produced can be updated in program and run against whole document set), (c) easy to add, modify, or have alternative syntax rules for input, should you need to,</p> -<p><b>(xvi)</b> scalability, dependent on your file-system (in my case Reiserfs) and on the relational database used (currently Postgresql and SQLite), and your hardware,</p> -<p><b>(xvii)</b> only marked up files need be backed up, to secure the larger document set produced,</p> -<p><b>(xviii)</b> document management,</p> -<p><b>(xix)</b> use your favourite editor, syntax highlighting files for markup, primarily (g)vim so far,</p> -<p><b>(xx)</b> remote operations: (a) run SiSU on a remote server, (having prepared sisu markup documents locally or on that server, i.e. this solution where sisu is installed on the remote server, would work whatever type of machine you chose to prepare your markup documents on), (b) alternatively, (assuming sisu is available to you locally but not installed on the remote server) configure sisu to securely copy (scp) its output to your remote host and run sisu locally, (c) request a remotely located sisu markup file and process it locally by identifying it by its' url.</p> -<br /> -<p class="small"> -More information on <a href="http://www.jus.uio.no/sisu/SiSU/"><b>SiSU</b></a> provided at <a href="http://www.jus.uio.no/sisu/SiSU/">www.jus.uio.no/sisu/SiSU</a></p> -</div> -<div id="column_right"> -<p class="small"> - More information on <a href="http://www.jus.uio.no/sisu/SiSU/"><b>SiSU</b></a> provided at: - <a href="http://www.jus.uio.no/sisu/SiSU/"> - www.jus.uio.no/sisu/SiSU - </a> -<p class="tiny"> -SiSU was developed in relation to legal documents, and is strong across a wide variety of texts (law, literature...(humanities, law and part of the social sciences)). SiSU handles images but is not suitable for formulae/ statistics, or for technical writing at this time.</p> -<p class="tiny"> -SiSU has been developed and has been in use for several years. Requirements to cover a wide range of documents within its use domain have been explored.</p> -<p class="tiny"> -Some modules are more mature than others, the most mature being Html and LaTeX / pdf. PostgreSQL and search functions are useable and together with <i>ocn</i> unique (to the best of my knowledge). The XML output document set is "well formed" but largely proof of concept, as is the OpenDocument output which is a limited SiSU feature set (SiSU is interested in a very limited ODF feature set).</p> -<p class="small"> -<a href="mailto://ralph@amissah.com"> -ralph@amissah.com -</a> -</p> -<p class="small"> -<a href="mailto://ralph.amissah@gmail.com"> -ralph.amissah@gmail.com -</a> -</p> -<p class="small"> -2007 -</p> -<p class="tiny"> -w3 since October 3 1993 -</p> -</div> -</body> -</html> diff --git a/data/doc/sisu/html/index.html b/data/doc/sisu/html/index.html deleted file mode 120000 index c6513ea0..00000000 --- a/data/doc/sisu/html/index.html +++ /dev/null @@ -1 +0,0 @@ -../sisu_manual/index.html
\ No newline at end of file diff --git a/data/doc/sisu/html/sisu3.1.html b/data/doc/sisu/html/sisu3.1.html deleted file mode 100644 index 905b05ec..00000000 --- a/data/doc/sisu/html/sisu3.1.html +++ /dev/null @@ -1,3520 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> - -<h2><a name='sect0' href='#toc0'>Name</a></h2> -sisu - documents: markup, structuring, publishing in multiple standard -formats, and search -<h2><a name='sect1' href='#toc1'>Synopsis</a></h2> -sisu [-abcDdFehIiMmNnopqRrSsTtUuVvwXxYyZz0-9] -[filename/wildcard] -<p> sisu [-P] [language_directory/filename language_directory] - -<p> sisu [-Ddcv] [instruction] [filename/wildcard] -<p> sisu [-CcFLSVvW] -<p> sisu ---v2 [operations] -<p> sisu --v1 [operations] SISU - MANUAL, RALPH AMISSAH -<p> WHAT -IS SISU? -<p> 1. INTRODUCTION - WHAT IS SISU? -<p> <b>SiSU</b> is a framework for document -structuring, publishing (in multiple open standard formats) and search, -comprising of: (a) a lightweight document structure and presentation markup -syntax; and (b) an accompanying engine for generating standard document -format outputs from documents prepared in sisu markup syntax, which is -able to produce multiple standard outputs (including the population of -sql databases) that (can) share a common numbering system for the citation -of text within a document. -<p> <b>SiSU</b> is developed under an open source, software -libre license (GPL3). Its use case for development is work with medium to -large document sets and cope with evolving document formats/ representation -technologies. Documents are prepared once, and generated as need be to update -the technical presentation or add additional output formats. Various output -formats (including search related output) share a common mechanism for -cross-output-format citation. -<p> <b>SiSU</b> both defines a markup syntax and provides -an engine that produces open standards format outputs from documents prepared -with <b>SiSU</b> markup. From a single lightly prepared document sisu custom builds -several standard output formats which share a common (text object) numbering -system for citation of content within a document (that also has implications -for search). The sisu engine works with an abstraction of the document’s -structure and content from which it is possible to generate different forms -of representation of the document. Significantly <b>SiSU</b> markup is more sparse -than html and outputs which include html, EPUB, LaTeX, landscape and portrait -pdfs, Open Document Format (ODF), all of which can be added to and updated. -<b>SiSU</b> is also able to populate SQL type databases at an object level, which -means that searches can be made with that degree of granularity. -<p> Source -document preparation and output generation is a two step process: (i) document -source is prepared, that is, marked up in sisu markup syntax and (ii) the -desired output subsequently generated by running the sisu engine against -document source. Output representations if updated (in the sisu engine) -can be generated by re-running the engine against the prepared source. Using -<b>SiSU</b> markup applied to a document, <b>SiSU</b> custom builds (to take advantage -of the strengths of different ways of representing documents) various standard -open output formats including plain text, HTML, XHTML, XML, EPUB, OpenDocument, -LaTeX or PDF files, and populate an SQL database with objects[^1] (equating -generally to paragraph-sized chunks) so searches may be performed and matches -returned with that degree of granularity ( e.g. your search criteria is met -by these documents and at these locations within each document). Document -output formats share a common object numbering system for locating content. -This is particularly suitable for "published" works (finalized texts as -opposed to works that are frequently changed or updated) for which it provides -a fixed means of reference of content. -<p> In preparing a <b>SiSU</b> document you -optionally provide semantic information related to the document in a document -header, and in marking up the substantive text provide information on the -structure of the document, primarily indicating heading levels and footnotes. -You also provide information on basic text attributes where used. The rest -is automatic, sisu from this information custom builds[^2] the different -forms of output requested. -<p> <b>SiSU</b> works with an abstraction of the document -based on its structure which is comprised of its headings[^3] and objects[^4], -which enables <b>SiSU</b> to represent the document in many different ways, and -to take advantage of the strengths of different ways of presenting documents. -The objects are numbered, and these numbers can be used to provide a common -basis for citing material within a document across the different output -format types. This is significant as page numbers are not well suited to -the digital age, in web publishing, changing a browser’s default font or -using a different browser can mean that text will appear on a different -page; and publishing in different formats, html, landscape and portrait -pdf etc. again page numbers are not useful to cite text. Dealing with documents -at an object level together with object numbering also has implications -for search that <b>SiSU</b> is able to take advantage of. -<p> One of the challenges -of maintaining documents is to keep them in a format that allows use of -them independently of proprietary platforms. Consider issues related to -dealing with legacy proprietary formats today and what guarantee you have -that old proprietary formats will remain (or can be read without proprietary -software/equipment) in 15 years time, or the way the way in which html -has evolved over its relatively short span of existence. <b>SiSU</b> provides the -flexibility of producing documents in multiple non-proprietary open formats -including html, pdf[^5] ODF,[^6] and EPUB.[^7] Whilst <b>SiSU</b> relies on software, -the markup is uncomplicated and minimalistic which guarantees that future -engines can be written to run against it. It is also easily converted to -other formats, which means documents prepared in <b>SiSU</b> can be migrated to -other document formats. Further security is provided by the fact that the -software itself, <b>SiSU</b> is available under GPL3 a licence that guarantees -that the source code will always be open, and free as in libre, which means -that that code base can be used, updated and further developed as required -under the terms of its license. Another challenge is to keep up with a moving -target. <b>SiSU</b> permits new forms of output to be added as they become important, -(Open Document Format text was added in 2006 when it became an ISO standard -for office applications and the archival of documents), EPUB was introduced -in 2009; and allows the technical representations existing output to be -updated (html has evolved and the related module has been updated repeatedly -over the years, presumably when the World Wide Web Consortium (w3c) finalises -html 5 which is currently under development, the html module will again -be updated allowing all existing documents to be regenerated as html 5). - -<p> The document formats are written to the file-system and available for -indexing by independent indexing tools, whether off the web like Google -and Yahoo or on the site like Lucene and Hyperestraier. -<p> <b>SiSU</b> also provides -other features such as concordance files and document content certificates, -and the working against an abstraction of document structure has further -possibilities for the research and development of other document representations, -the availability of objects is useful for example for topic maps and thesauri, -together with the flexibility of <b>SiSU</b> offers great possibilities. -<p> <b>SiSU</b> -is primarily for published works, which can take advantage of the citation -system to reliably reference its documents. <b>SiSU</b> works well in a complementary -manner with such collaborative technologies as Wikis, which can take advantage -of and be used to discuss the substance of content prepared in <b>SiSU</b> -<p> -<<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -> -<p> 2. COMMANDS SUMMARY -<p> 2.1 DESCRIPTION -<p> <b>SiSU</b> <b>SiSU</b> -is a document publishing system, that from a simple single marked-up document, -produces multiple of output formats including: plaintext, html, xhtml, -XML, epub, odt (odf text), LaTeX, pdf, info, and SQL (PostgreSQL and SQLite), -which share numbered text objects ("object citation numbering") and the -same document structure information. For more see: <<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -> - -<p> 2.2 DOCUMENT PROCESSING COMMAND FLAGS -<p> -<dl> - -<dt><b>-a [filename/wildcard]</b> </dt> -<dd>produces plaintext -with Unix linefeeds and without markup, (object numbers are omitted), has -footnotes at end of each paragraph that contains them [ -A for equivalent - dos (linefeed) output file] [see -e for (Options include: --endnotes for endnotes ---footnotes for footnotes at the end of each paragraph --unix for unix linefeed -(default) --msdos for msdos linefeed) -<p> </dd> - -<dt><b>-b [filename/wildcard]</b> </dt> -<dd>see --xhtml -<p> </dd> - -<dt><b>--color-toggle -[filename/wildcard]</b> </dt> -<dd>screen toggle ansi screen colour on or off depending -on default set (unless -c flag is used: if sisurc colour default is set -to ’true’, output to screen will be with colour, if sisurc colour default -is set to ’false’ or is undefined screen output will be without colour). Alias - -<p>- -<p>c -<p> </dd> - -<dt><b>--concordance [filename/wildcard]</b> </dt> -<dd>produces concordance (wordmap) a rudimentary -index of all the words in a document. (Concordance files are not generated -for documents of over 260,000 words unless this limit is increased in the -file sisurc.yml). Alias -w -<p> </dd> - -<dt><b>-C [--init-site]</b> </dt> -<dd>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. -<p> </dd> - -<dt><b>-CC</b> </dt> -<dd>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). The equivalent of: --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 -CC is used. -<p> </dd> - -<dt><b>-c [filename/wildcard]</b> -</dt> -<dd> -<p>see --color-toggle -<p> </dd> - -<dt><b>--dal [filename/wildcard/url]</b> </dt> -<dd>assumed for most other flags, -creates new intermediate files for processing (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 -<p> </dd> - -<dt><b>--delete [filename/wildcard]</b> -</dt> -<dd> -<p>see --zap -<p> </dd> - -<dt><b>-D [instruction] [filename]</b> </dt> -<dd>see --pg -<p> </dd> - -<dt><b>-d [--db-[database type (sqlite|pg)]] ---[instruction] [filename]</b> </dt> -<dd>see --sqlite -<p> </dd> - -<dt><b>--epub [filename/wildcard]</b> </dt> -<dd>produces -an epub document, [sisu version 2 only] (filename.epub). Alias -e -<p> </dd> - -<dt><b>-e [filename/wildcard]</b> -</dt> -<dd> -<p>see --epub -<p> </dd> - -<dt><b>-F [--webserv=webrick]</b> </dt> -<dd>see --sample-search-form -<p> </dd> - -<dt><b>--git [filename/wildcard]</b> -</dt> -<dd>produces or updates markup source file structure in a git repo (experimental -and subject to change). Alias -g -<p> </dd> - -<dt><b>-g [filename/wildcard]</b> </dt> -<dd>see --git -<p> </dd> - -<dt><b>--harvest -*.ss[tm]</b> </dt> -<dd>makes two lists of sisu output based on the sisu markup documents -in a directory: list of author and authors works (year and titles), and; -list by topic with titles and author. Makes use of header metadata fields -(author, title, date, topic_register). Can be used with maintenance (-M) -and remote placement (-R) flags. -<p> </dd> - -<dt><b>--help [topic]</b> </dt> -<dd>provides help on the selected -topic, where topics (keywords) include: list, (com)mands, short(cuts), -(mod)ifiers, (env)ironment, markup, syntax, headers, headings, endnotes, -tables, example, customise, skin, (dir)ectories, path, (lang)uage, db, -install, setup, (conf)igure, convert, termsheet, search, sql, features, - -<p>license -<p> </dd> - -<dt><b>--html [filename/wildcard]</b> </dt> -<dd>produces html output, segmented text -with table of contents (toc.html and index.html) and the document in a single -file (scroll.html). Alias -h -<p> </dd> - -<dt><b>-h [filename/wildcard]</b> </dt> -<dd>see --html -<p> </dd> - -<dt><b>-I [filename/wildcard]</b> -</dt> -<dd> -<p>see --texinfo -<p> </dd> - -<dt><b>-i [filename/wildcard]</b> </dt> -<dd>see --manpage -<p> </dd> - -<dt><b>-L</b> </dt> -<dd>prints license information. - -<p> </dd> - -<dt><b>--machine [filename/wildcard/url]</b> </dt> -<dd>see --dal (document abstraction level/layer) - -<p> </dd> - -<dt><b>--maintenance [filename/wildcard/url]</b> </dt> -<dd>maintenance mode files created for -processing preserved and their locations indicated. (also see -V). Alias -M - -<p> </dd> - -<dt><b>--manpage [filename/wildcard]</b> </dt> -<dd>produces man page of file, not suitable for -all outputs. Alias -i -<p> </dd> - -<dt><b>-M [filename/wildcard/url]</b> </dt> -<dd>see --maintenance -<p> </dd> - -<dt><b>-m [filename/wildcard/url]</b> -</dt> -<dd>see --dal (document abstraction level/layer) -<p> </dd> - -<dt><b>--no-ocn</b> </dt> -<dd>[with --html --pdf or --epub] -switches off object citation numbering. Produce output without identifying -numbers in margins of html or LaTeX/pdf output. -<p> </dd> - -<dt><b>-N [filename/wildcard/url]</b> -</dt> -<dd>document digest or document content certificate ( DCC ) as md5 digest tree -of the document: the digest for the document, and digests for each object -contained within the document (together with information on software versions -that produced it) (digest.txt). -NV for verbose digest output to screen. -<p> </dd> - -<dt><b>-n -[filename/wildcard/url]</b> </dt> -<dd>skip the creation of intermediate processing files -(document abstraction) if they already exist, this skips the equivalent -of -m which is otherwise assumed by most processing flags. -<p> |