diff options
36 files changed, 48 insertions, 15134 deletions
@@ -29,6 +29,9 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_0.60.0.orig.tar.gz * sysenv, sisurc.yml allow use of relative output paths, expand to absolute + * param, behavior changed to take in multi-lines, affects regex matching, + watch + * html segmented, bugfix: footnotes for headings levels :A,:B and :C correctly placed in first segment when batch-processing files/output @@ -37,6 +40,17 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_0.60.0.orig.tar.gz * sysenv, syslink issue, additional check + * sisu markup, header @man: accepting manpage parameters for: man_section, + man_name and man_synopsis + + * REVERT to manually constructed man-pages, sisu auto-generated man-pages + pretty good, but not ready without discussion for automatic inclusion in + package, sisu -i [filename] + + * NOTE you may be better off doing any diffs between 0.60 and 0.58 branch + than against 0.59 which includes a lot of generated within the package + documentation, 0.60 adds source only + %% sisu_0.59.1.orig.tar.gz (2007-09-25:39/2) http://www.jus.uio.no/sisu/pkg/src/sisu_0.59.1.orig.tar.gz cf512ec871aeb7cdabc0b3b35b7e6d05 10952059 sisu_0.59.1.orig.tar.gz diff --git a/data/doc/sisu/html/sisu_commands.1.html b/data/doc/sisu/html/sisu_commands.1.html deleted file mode 100644 index e519713e..00000000 --- a/data/doc/sisu/html/sisu_commands.1.html +++ /dev/null @@ -1,553 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_commands"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - COMMANDS, RALPH AMISSAH -<p> SISU COMMANDS -<p> 1. COMMANDS SUMMARY -<p> 1.1 - -<p>SYNOPSIS -<p> <b>SiSU</b> - Structured information, Serialized Units - a document publishing - -<p>system -<p> sisu [ -abcDdFHhIiMmNnopqRrSsTtUuVvwXxYyZz0-9 ] [ filename/ -<p> sisu - [ -Ddcv ] [ instruction ] -<p> sisu [ -CcFLSVvW ] -<p> Note: commands should be -issued from within the directory that contains the marked up files, cd -to markup directory. -<p> 1.2 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, LaTeX, pdf, xhtml, XML, info, -and SQL (PostgreSQL and SQLite), which share numbered text objects ( structure -information. For more see: <<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -> -<p> 1.3 DOCUMENT PROCESSING - -<p>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 endnotes]. (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>produces xhtml/XML -output for browser viewing (sax parsing). -<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 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. -such as css and dtd files are updated -<p> </dd> - -<dt><b> -c [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). -<p> </dd> - -<dt><b> -D [instruction] [filename]</b> </dt> -<dd>database postgresql -( --pgsql may be used instead) possible instructions, include: --createdb; ---create; --dropall; --import [filename]; --update [filename]; --remove [filename]; -see database section below. -<p> </dd> - -<dt><b> -d [--db-[database type (sqlite|pg)]] --[instruction] -</dt> -<dd>[filename] database type default set to sqlite, (for which --sqlite may be -used instead) or to specify another database --db-[pgsql, sqlite] (however -see -D) possible instructions include: --createdb; --create; --dropall; --import - [filename]; --update [filename]; --remove [filename]; see database section -below. -<p> </dd> - -<dt><b> -F [--webserv=webrick]</b> </dt> -<dd>generate examples of (naive) cgi search form -for sqlite and pgsql depends on your already having used sisu to populate -an sqlite and/or pgsql database, (the sqlite version scans the output directories -for existing sisu_sqlite databases, so it is first necessary to create -them, before generating the search form) see -d -D and the database section -below. If the optional parameter --webserv=webrick is passed, the cgi examples -created will be set up to use the default port set for use by the webrick -server, (otherwise the port is left blank and the system setting used, -usually 80). The samples are dumped in the present work directory which -must be writable, (with screen instructions given that they be copied to -the cgi-bin directory). -Fv (in addition to the above) provides some information - -<p>on setting up hyperestraier for sisu -<p> </dd> - -<dt><b> -H [filename/wildcard]</b> </dt> -<dd>produces html -without link suffixes (.html .pdf etc.) ( an appropriately configured web -server. [behaviour switched after 0.35 see -h]. -<p> </dd> - -<dt><b> -h [filename/wildcard]</b> </dt> -<dd>produces -html (with hardlinks i.e. with name suffixes in links/local urls). html, with -internal document links that include the document suffix, i.e. whether it -is .html or .pdf (required for browsing directly off a file system, and works -with most web servers). [behaviour switched after -<p> </dd> - -<dt><b> -I [filename/wildcard]</b> -</dt> -<dd>produces texinfo and info file, (view with pinfo). -<p> </dd> - -<dt><b> -L</b> </dt> -<dd> prints license information. - -<p> </dd> - -<dt><b> -M [filename/wildcard/url]</b> </dt> -<dd>maintenance mode files created for processing -preserved and their locations indicated. (also see -V) -<p> </dd> - -<dt><b> -m [filename/wildcard/url]</b> -</dt> -<dd>assumed for most other flags, creates new meta-markup file, (the metaverse -) that is used in all subsequent processing of other output. This step is -assumed for most processing flags. To skip it see -n -<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 meta-markup (building of -m which is otherwise -assumed by most processing flags. -<p> </dd> - -<dt><b> -o [filename/wildcard/url]</b> </dt> -<dd>output basic -document in opendocument file format (opendocument.odt). -<p> </dd> - -<dt><b> -p [filename/wildcard]</b> -</dt> -<dd>produces LaTeX pdf (portrait.pdf & landscape.pdf). Default paper size is set -in config file, or document header, or provided with additional command -line parameter, e.g. --papersize-a4 preset sizes include: ’A4’, U.S. ’letter’ and -’legal’ and book sizes ’A5’ and ’B5’ (system defaults to A4). -<p> </dd> - -<dt><b> -q [filename/wildcard]</b> -</dt> -<dd>quiet less output to screen. -<p> </dd> - -<dt><b> -R [filename/wildcard]</b> </dt> -<dd>copies sisu output files -to remote host using rsync. This requires that sisurc.yml has been provided -with information on hostname and username, and that you have your different -if -R is used with other flags from if used alone. Alone the rsync --delete -parameter is sent, useful for cleaning the remote directory (when -R is -used together with other flags, it is not). Also see -r -<p> </dd> - -<dt><b> -r [filename/wildcard]</b> -</dt> -<dd>copies sisu output files to remote host using scp. This requires that sisurc.yml -has been provided with information on hostname and username, and that you - -<p>have your -<p> </dd> - -<dt><b> -S</b> </dt> -<dd> produces a sisupod a zipped sisu directory of markup local - configuration file, images and skins. Note: this only includes the configuration - files or skins contained in ./_sisu not those in ~/.sisu -S [filename/wildcard] -option. Note: (this option is tested only with zsh). -<p> </dd> - -<dt><b> -S [filename/wildcard]</b> -</dt> -<dd>produces a zipped file of the prepared document specified along with associated -images, by default named sisupod.zip they may alternatively be named with -the filename extension .ssp This provides a quick way of gathering the relevant -parts of a sisu document which can then for example be emailed. A sisupod -includes sisu markup source file, (along with associated documents if a -master file, or available in multilingual versions), together with related -images and skin. <b>SiSU</b> commands can be run directly against a sisupod contained -in a local directory, or provided as a url on a remote site. As there is -a security issue with skins provided by other users, they are not applied -unless the flag --trust or --trusted is added to the command instruction, it -is recommended that file that are not your own are treated as untrusted. -The directory structure of the unzipped file is understood by sisu, and -sisu commands can be run within it. Note: if you wish to send multiple files, -it quickly becomes more space efficient to zip the sisu markup directory, -rather than the individual files for sending). See the -S option without - -<p> </dd> - -<dt><b> -s [filename/wildcard]</b> </dt> -<dd>copies sisu markup file to output directory. -<p> </dd> - -<dt><b> -t [filename/wildcard - (*.termsheet.rb)]</b> </dt> -<dd>standard form document builder, preprocessing feature -<p> -</dd> - -<dt><b> -U [filename/wildcard]</b> </dt> -<dd>prints url output list/map for the available processing -flags options and resulting files that could be requested, (can be used -to get a list of processing options in relation to a file, together with -information on the output that would be produced), -u provides url output -mapping for those flags requested for processing. The default assumes sisu_webrick -is running and provides webrick url mappings where appropriate, but these - -<p>can be switched to file system paths in sisurc.yml -<p> </dd> - -<dt><b> -u [filename/wildcard]</b> -</dt> -<dd>provides url mapping of output files for the flags requested for processing, - -<p>also see -U -<p> </dd> - -<dt><b> -V</b> </dt> -<dd> on its own, provides <b> SiSU</b> version and environment information - (sisu --help env) -<p> </dd> - -<dt><b> -V [filename/wildcard]</b> </dt> -<dd>even more verbose than the -v flag. -(also see -M) -<p> </dd> - -<dt><b> -v</b> </dt> -<dd> on its own, provides <b> SiSU</b> version information -<p> </dd> - -<dt><b> -v [filename/wildcard]</b> -</dt> -<dd>provides verbose output of what is being built, where it is being built -(and error messages if any), as with -u flag provides a url mapping of files -created for each of the processing flag requests. See also -V -<p> </dd> - -<dt><b> -W</b> </dt> -<dd> starts ruby’s - webrick webserver points at sisu output the default port is set to 8081 - and can be [tip: the so html output should be created using the -h option - rather than -H; also, note -F webrick ]. -<p> </dd> - -<dt><b> -w [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) -<p> </dd> - -<dt><b> -X [filename/wildcard]</b> </dt> -<dd>produces -XML output with deep document structure, in the nature of dom. -<p> </dd> - -<dt><b> -x [filename/wildcard]</b> -</dt> -<dd>produces XML output shallow structure (sax parsing). -<p> </dd> - -<dt><b> -Y [filename/wildcard]</b> -</dt> -<dd>produces a short sitemap entry for the document, based on html output and -the sisu_manifest. --sitemaps generates/updates the sitemap index of existing -sitemaps. (Experimental, [g,y,m announcement this week]) -<p> </dd> - -<dt><b> -y [filename/wildcard]</b> -</dt> -<dd>produces an html summary of output generated (hyperlinked to content) and -document specific metadata (sisu_manifest.html). This step is assumed for -most processing flags. -<p> </dd> - -<dt><b> -Z [filename/wildcard]</b> </dt> -<dd>Zap, if used with other processing -flags deletes output files of the type about to be processed, prior to -processing. If -Z is used as the lone processing related flag (or in conjunction -with a combination of -[mMvVq]), will remove the related document output -directory. -<p> </dd> - -<dt><b> -z [filename/wildcard]</b> </dt> -<dd>produces php (zend) [this feature is disabled - for the time being] -<p> </dd> -</dl> -2. COMMAND LINE MODIFIERS -<p> -<dl> - -<dt><b> --no-ocn</b> </dt> -<dd> [with -h -H or -p] switches -off object citation numbering. Produce output without identifying numbers -in margins of html or LaTeX/pdf output. -<p> </dd> - -<dt><b> --no-annotate</b> </dt> -<dd> strips output text of - editor endnotes[^*1] denoted by asterisk or dagger/plus sign -<p> </dd> - -<dt><b> --no-asterisk</b> -</dt> -<dd> strips output text of editor endnotes[^*2] denoted by asterisk sign -<p> </dd> - -<dt><b> --no-dagger</b> -</dt> -<dd> strips output text of editor endnotes[^+1] denoted by dagger/plus sign -<p> -</dd> -</dl> -3. DATABASE COMMANDS -<p> dbi - database interface -<p> -D or --pgsql set for postgresql --d or --sqlite default set for sqlite -d is modifiable with --db=[database type - (pgsql or sqlite)] -<p> -<dl> - -<dt><b> -Dv --createall</b> </dt> -<dd> initial step, creates required relations - (tables, indexes) in existing postgresql database (a database should be - created manually and given the same name as working directory, as requested) - (rb.dbi) [ -dv --createall sqlite equivalent] it may be necessary to run sisu --Dv --createdb initially NOTE: at the present time for postgresql it may be -necessary to manually create the database. The command would be ’createdb - [database name]’ where database name would be SiSU_[present working directory - name (without path)]. Please use only alphanumerics and underscores. -<p> </dd> - -<dt><b> -Dv - --import</b> </dt> -<dd> [filename/wildcard] imports data specified to postgresql db (rb.dbi) - [ -dv --import sqlite equivalent] -<p> </dd> - -<dt><b> -Dv --update</b> </dt> -<dd> [filename/wildcard] updates/imports -specified data to postgresql db (rb.dbi) [ -dv --update sqlite equivalent] - -<p> </dd> - -<dt><b> -D --remove</b> </dt> -<dd> [filename/wildcard] removes specified data to postgresql db (rb.dbi) - [ -d --remove sqlite equivalent] -<p> </dd> - -<dt><b> -D --dropall</b> </dt> -<dd> kills data & indexes [ -d --dropall - sqlite equivalent] -<p> The v in e.g. -Dv is for verbose output. -<p> </dd> -</dl> -4. SHORTCUTS, -SHORTHAND FOR MULTIPLE FLAGS -<p> -<dl> - -<dt><b> --update [filename/wildcard]</b> </dt> -<dd>Checks existing -file output and runs the flags required to update this output. This means -that if only html and pdf output was requested on previous runs, only the --hp files will be applied, and only these will be generated this time, together -with the summary. This can be very convenient, if you offer different outputs -of different files, and just want to do the same again. -<p> </dd> - -<dt><b> -0 to -5 [filename - or wildcard]</b> </dt> -<dd>Default shorthand mappings (note that the defaults can be -changed/configured in the sisurc.yml file): -<p> </dd> - -<dt><b> -0</b> </dt> -<dd> -mNhwpAobxXyYv [this is the - default action run when no i.e. on ’sisu [filename]’] -<p> </dd> - -<dt><b> -1</b> </dt> -<dd> -mNHwpy give, i.e. on - ’sisu [filename]’] -<p> </dd> - -<dt><b> -2</b> </dt> -<dd> -mNHwpaoy give, i.e. on ’sisu [filename]’] -<p> </dd> - -<dt><b> -3</b> </dt> -<dd> -mNhwpAobxXyY - i.e. on ’sisu [filename]’] -<p> </dd> - -<dt><b> -4</b> </dt> -<dd> -mNhwpAobxXDyY --import ’sisu [filename]’] -<p> </dd> - -<dt><b> -5</b> </dt> -<dd> -mNhwpAobxXDyY - --update ’sisu [filename]’] -<p> add -v for verbose mode and -c for color, e.g. sisu --2vc [filename or wildcard] -<p> consider -u for appended url info or -v for - -<p>verbose output -<p> </dd> -</dl> -4.0.1 COMMAND LINE WITH FLAGS - BATCH PROCESSING -<p> In the -data directory run sisu -mh filename or wildcard eg. cisg.sst documents. -<p> -Running sisu (alone without any flags, filenames or wildcards) brings up -the interactive help, as does any sisu command that is not recognised. Enter -to escape. -<p> DOCUMENT INFORMATION (METADATA) -<p> METADATA -<p> Document Manifest -@ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/sisu_manifest.html</a> -> -<p> - <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - Commands -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC Rights: <i>Copyright</i> -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -<p> DC -Type: <i>information</i> -<p> DC Date created: <i>2002-08-28</i> -<p> DC Date issued: <i>2002-08-28</i> - -<p> DC Date available: <i>2002-08-28</i> -<p> DC Date modified: <i>2007-09-16</i> -<p> DC Date: <i>2007-09-16</i> - -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_commands.sst</i> -<p> Filetype: <i>SiSU</i> text - -<p>0.58 -<p> Sourcefile Digest, MD5(sisu_commands.sst)= <i>68a4087f984baffbea779da25e1b6141</i> - -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:13 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<dl> - -<dt><b>*1.</b> </dt> -<dd>square brackets </dd> - -<dt><b>*2.</b> </dt> -<dd>square brackets </dd> - -<dt><b>+1.</b> </dt> -<dd>square brackets -<p> -</dd> - -<dt>Other versions of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_commands/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_commands/toc.html'>http://www.jus.uio.no/sisu/sisu_commands/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:30 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_configuration.1.html b/data/doc/sisu/html/sisu_configuration.1.html deleted file mode 100644 index e3be86fe..00000000 --- a/data/doc/sisu/html/sisu_configuration.1.html +++ /dev/null @@ -1,254 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_configuration"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - CONFIGURATION, RALPH AMISSAH -<p> CONFIGURATION OF ENVIRONMENT -<p> 1. CONFIGURATION - -<p> 1.1 DETERMINING THE CURRENT CONFIGURATION -<p> Information on the current -configuration of <b>SiSU</b> should be available with the help command: -<p> sisu --v<br> - -<p> which is an alias for: -<p> sisu --help env<br> - -<p> Either of these should be executed from within a directory that contains -sisu markup source documents. -<p> 1.2 CONFIGURATION FILES (CONFIG.YML) -<p> <b>SiSU</b> -configration parameters are adjusted in the configuration file, which can -be used to override the defaults set. This includes such things as which -directory interim processing should be done in and where the generated -output should be placed. -<p> The <b>SiSU</b> configuration file is a yaml file, which -means indentation is significant. -<p> <b>SiSU</b> resource configuration is determined -by looking at the following files if they exist: -<p> ./_sisu/sisurc.yml<br> - -<p> ~/.sisu/sisurc.yml<br> - -<p> /etc/sisu/sisurc.yml<br> - -<p> The search is in the order listed, and the first one found is used. -<p> - In the absence of instructions in any of these it falls back to the internal -program defaults. -<p> Configuration determines the output and processing directories -and the database access details. -<p> If <b>SiSU</b> is installed a sample sisurc.yml - -<p>may be found in /etc/sisu/sisurc.yml -<p> CONFIGURATION OF DOCUMENTS -<p> 2. SKINS - -<p> Skins modify the default appearance of document output on a document, -directory, or site wide basis. Skins are looked for in the following locations: - -<p> ./_sisu/skin<br> - -<p> ~/.sisu/skin<br> - -<p> /etc/sisu/skin<br> - -<p> <b>Within the skin directory</b> are the following the default sub-directories -for document skins: -<p> ./skin/doc<br> - -<p> ./skin/dir<br> - -<p> ./skin/site<br> - -<p> A skin is placed in the appropriate directory and the file named skin_[name].rb - -<p> The skin itself is a ruby file which modifies the default appearances -set in the program. -<p> 2.1 DOCUMENT SKIN -<p> Documents take on a document skin, -if the header of the document specifies a skin to be used. -<p> -<p> <br> -<pre> @skin: skin_united_nations -</pre> -<p> 2.2 DIRECTORY SKIN -<p> A directory may be mapped on to a particular skin, -so all documents within that directory take on a particular appearance. -If a skin exists in the skin/dir with the same name as the document directory, -it will automatically be used for each of the documents in that directory, -(except where a document specifies the use of another skin, in the skin/doc -directory). -<p> A personal habit is to place all skins within the doc directory, -and symbolic links as needed from the site, or dir directories as required. - -<p> 2.3 SITE SKIN -<p> A site skin, modifies the program default skin. -<p> 2.4 SAMPLE - -<p>SKINS -<p> With <b>SiSU</b> installed sample skins may be found in: -<p> /etc/sisu/skin/doc -and<br> - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc<br> - -<p> (or equivalent directory) and if sisu-markup-samples is installed also -under: -<p> /usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc<br> - -<p> Samples of list.yml and promo.yml (which are used to create the right -column list) may be found in: -<p> /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml -(or equivalent<br> - directory)<br> - -<p> 3. HOMEPAGES -<p> <b>SiSU</b> is about the ability to auto-generate documents. Home -pages are regarded as custom built items, and are not created by <b>SiSU</b> -<b>SiSU</b> has a default home page, which will not be appropriate for use with -other sites, and the means to provide your own home page instead in one -of two ways as part of a site’s configuration, these being: -<p> 1. through -placing your home page and other custom built documents in the subdirectory -_sisu/home/ (this probably being the easier and more convenient option) - -<p> 2. through providing what you want as the home page in a skin, -<p> Document -sets are contained in directories, usually organised by site or subject. -Each directory can/should have its own homepage. See the section on directory -structure and organisation of content. -<p> 3.1 HOME PAGE AND OTHER CUSTOM BUILT - -<p>PAGES IN A SUB-DIRECTORY -<p> Custom built pages, including the home page index.html -may be placed within the configuration directory _sisu/home/ in any of -the locations that is searched for the configuration directory, namely -./_sisu; ~/_sisu; /etc/sisu From there they are copied to the root of the -output directory with the command: -<p> sisu -CC<br> - -<p> 3.2 HOME PAGE WITHIN A SKIN -<p> Skins are described in a separate section, -but basically are a file written in the programming language <b>Ruby</b> that -may be provided to change the defaults that are provided with sisu with -respect to individual documents, a directories contents or for a site. -<p> - If you wish to provide a homepage within a skin the skin should be in -the directory _sisu/skin/dir and have the name of the directory for which -it is to become the home page. Documents in the directory commercial_law -would have the homepage modified in skin_commercial law.rb; or the directory - -<p>poems in skin_poems.rb -<p> -<p> <br> -<pre> class Home - def homepage - # place the html content of your homepage here, this will become -index.html - <<HOME <html> - <head></head> - <doc> - <p>this is my new homepage.</p> - </doc> - </html> - HOME - end - end -</pre> -<p> DOCUMENT INFORMATION (METADATA) -<p> METADATA -<p> Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - Configuration -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC Rights: - -<p><i>Ralph</i> Amissah -<p> DC Type: <i>information</i> -<p> DC Date created: <i>2002-08-28</i> -<p> DC Date -issued: <i>2002-08-28</i> -<p> DC Date available: <i>2007-08-28</i> -<p> DC Date modified: <i>2007-08-30</i> - -<p> DC Date: <i>2007-08-30</i> -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_configuration._sst</i> - -<p> Filetype: <i>SiSU</i> text insert 0.58 -<p> Sourcefile Digest, MD5(sisu_configuration._sst)= - -<p><i>491d3da039162d60ae0e2951aa260915</i> -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:17 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<p> -<dl> - -<dt>Other versions of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_configuration/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_configuration/toc.html'>http://www.jus.uio.no/sisu/sisu_configuration/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:32 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_doc.7.html b/data/doc/sisu/html/sisu_doc.7.html deleted file mode 100644 index 2496c3b6..00000000 --- a/data/doc/sisu/html/sisu_doc.7.html +++ /dev/null @@ -1,121 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_doc"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - SISU-DOC, RALPH AMISSAH -<p> SISU DOC -<p> SISU-DOC -<p> 1.1 NAME -<p> <b>SiSU</b> - Structured -information, Serialized Units - a document publishing system. -<p> Information - -<p>related to sisu documentation -<p> 1.2 DESCRIPTION -<p> sisu documentation is installed - -<p>in /usr/share/doc/sisu/sisu_manual or equivalent directory -<p> file:///usr/share/doc/sisu/sisu_manual - -<p> file:///usr/share/doc/sisu/sisu_manual/sisu_manual/ -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual'>http://www.jus.uio.no/sisu/sisu_manual</a> -> - -<p> <<a href='http://www.sisudoc.org/sisu_manual'>http://www.sisudoc.org/sisu_manual</a> -> -<p> DOCUMENT INFORMATION (METADATA) -<p> METADATA - -<p> Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_doc/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_doc/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - sisu-doc -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC Rights: <i>Copyright</i> -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -<p> DC -Type: <i>information</i> -<p> DC Date created: <i>2007-09-24</i> -<p> DC Date issued: <i>2007-09-24</i> - -<p> DC Date available: <i>2007-09-24</i> -<p> DC Date modified: <i>2007-09-24</i> -<p> DC Date: <i>2007-09-24</i> - -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_doc.sst</i> -<p> Filetype: <i>SiSU</i> text 0.58 - -<p> Sourcefile Digest, MD5(sisu_doc.sst)= <i>00116fb664a23c87ce52dbe0d4c5a702</i> - -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:19 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<p> -<dl> - -<dt>Other versions of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_doc/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_doc/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_doc/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_doc/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_doc/toc.html'>http://www.jus.uio.no/sisu/sisu_doc/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_doc/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_doc/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_doc/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_doc/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_doc/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_doc/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:32 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_faq.8.html b/data/doc/sisu/html/sisu_faq.8.html deleted file mode 100644 index 18284509..00000000 --- a/data/doc/sisu/html/sisu_faq.8.html +++ /dev/null @@ -1,273 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_faq"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - FAQ - FREQUENTLY ASKED/ANSWERED QUESTIONS, RALPH AMISSAH -<p> 1. FAQ - -FREQUENTLY ASKED/ANSWERED QUESTIONS -<p> 1.1 WHY ARE URLS PRODUCED WITH THE --V (AND -U) FLAG THAT POINT TO A WEB SERVER ON PORT 8081? -<p> Try the following -rune: -<p> * sisu -W -<p> This should start the ruby webserver. It should be done -after having produced some output as it scans the output directory for -what to serve. -<p> 1.2 I CANNOT FIND MY OUTPUT, WHERE IS IT? -<p> The following -should provide help on output paths: -<p> * sisu --help env -<p> * sisu -V [same - as the previous command] -<p> * sisu --help directory -<p> * sisu --help path -<p> * -sisu -U [filename] -<p> * man sisu -<p> 1.3 I DO NOT GET ANY PDF OUTPUT, WHY? -<p> -<b>SiSU</b> produces LaTeX and pdflatex is run against that to generate pdf files. - -<p> If you use <b>Debian</b> the following will install the required dependencies - -<p> * aptitude install sisu-pdf -<p> the following packages are required: tetex-bin, -tetex-extra, latex-ucs -<p> 1.4 WHERE IS THE LATEX (OR SOME OTHER INTERIM) OUTPUT? - -<p> Try adding -M (for maintenance) to your command flags, e.g.: -<p> * sisu -HpMv - [filename] -<p> this should result in the interim processing output being -retained, and information being provided on where to find it. -<p> * sisu --help - -<p>directory -<p> * sisu --help path -<p> should also provide some relevant information -as to where it is placed. -<p> 1.5 WHY ISN’T SISU MARKUP XML -<p> I worked with text -and (though I find XML immensely valuable) disliked noise ... better to sidestep -the question and say: -<p> <b>SiSU</b> currently accurately, converts from three -forms of XML to native <b>SiSU</b> markup for processing. The three types correspond -to SAX (structure described), DOM (structure embedded, whole document must -be read before structure is correctly discernable) and node based (a tree) -forms of XML document structure representation. Problem is I use them very -seldom and check that all is as it should be with them seldom, so I would -not be surprised if something breaks there, but as far as I know they are -working. I will check and add an XML markup help page before the next release. - -<p>There already is a bit of information in the man page under the title <b>SiSU</b> - -<p>VERSION CONVERSION -<p> sisu --to-sax [filename/wildcard]<br> - -<p> sisu --to-dom [filename/wildcard]<br> - -<p> sisu --to-node [filename/wildcard]<br> - -<p> The XML should be well formed... must check, but lacks sensible headers. -Suggestions welcome as to what to make of them. [For the present time I - am satisfied that I can convert (both ways) between 3 forms of XML representation - and <b> SiSU</b> markup]. -<p> sisu --from-xml2sst [filename/wildcard]<br> - -<p> 1.6 LATEX CLAIMS TO BE A DOCUMENT PREPARATION SYSTEM FOR HIGH-QUALITY TYPESETTING. -CAN THE SAME BE SAID ABOUT SISU? -<p> <b>SiSU</b> is not really about type-setting. - -<p> LaTeX is the ultimate computer instruction type-setting language for paper -based publication. -<p> LaTeX is able to control just about everything that -happens on page and pixel, position letters kerning, space variation between -characters, words, paragraphs etc. formula. -<p> <b>SiSU</b> is not really about type-setting -at all. It is about a lightweight markup instruction that provides enough -information for an abstraction of the documents structure and objects, -from which different forms of representation of the document can be generated. - -<p> <b>SiSU</b> with very little markup instruction is able to produce relatively -high quality pdf by virtue of being able to generate usable default LaTeX; -it produces populates an SQL database in a useful way with the document -in object sized chunks and its meta-data. But <b>SiSU</b> works on an abstraction -of the document’s structure and content and custom builds suitable uniform -output. The html for browser viewing and pdf for paper viewing/publishing -are rather different things with different needs for layout - as indeed -is what is needed to store information in a database in searchable objects. - -<p> The pdfs or html produced for example by open office based on open document -format and other office/word processor suits usually attempt to have similar -looking outputs - your document rendered in html looks much the same, or -in pdf... sisu is less this way, it seeks to have a starting point with as -little information about appearance as possible, and to come up with the -best possible appearance for each output that can be derived based on this -minimal information. -<p> Where there are large document sets, it provides -consistency in appearance in each output format for the documents. -<p> The -excuse for going this way is, it is a waste of time to think much about -appearance when working on substantive content, it is the substantive content -that is relevant, not the way it looks beyond the basic informational tags -- and yet you want to be able to take advantage of as many useful different -ways of representing documents as are available, and for various types -of output to to be/look as good as it can for each medium/format in which -it is presented, (with different mediums having different focuses) and -<b>SiSU</b> tries to achieve this from minimal markup. -<p> 1.7 HOW DO I CREATE GIN - -<p>OR GIST INDEX IN POSTGRESQL FOR USE IN SISU -<p> This at present needs to -be done alter the sample search form. The following is a helpful response -from one of the contributors of GiN to Postgresql Oleg Bartunov 2006-12-06: - -<p> I have tsearch2 slides which introduces tsearch2 <<a href='http://www.sai.msu.su/~megera/wiki/tsearch2slides'>http://www.sai.msu.su/~megera/wiki/tsearch2slides</a> -> - -<p> FTS in PostgreSQL is provided by tsearch2, which should works without -any indices (GiST or GIN) ! Indices provide performance, not functionality. - -<p> In your example I’d do ( simple way, just for demo): -<p> <b>0.</b> compile, install - -<p>tsearch2 and load tsearch2 into your database -<p> cd contrib/tsearch2; -make&&make&&install&&make installcheck; psql DB &lt;<br> - tsearch2.sql<br> - -<p> <b>1.</b> Add column fts, which holds tsvector -<p> alter table documents add -column fts tsvector;<br> - -<p> <b>2.</b> Fill fts column -<p> update document set fts = to_tsvector(clean);<br> - -<p> <b>3.</b> create index - just for performance ! -<p> create index fts_gin_idx -on document using gin(fts);<br> - -<p> <b>4.</b> Run vacuum -<p> vacuum analyze document;<br> - -<p> That’s all. -<p> Now you can search: -<p> select lid, metadata_tid, rank_cd(fts, -q,2)as rank from document, plainto_tsquery(’markup syntax’) q where q @@ -fts order by rank desc limit 10; -<p> 1.8 WHERE IS VERSION 1.0? -<p> <b>SiSU</b> works -pretty well as it is supposed to. Version 1.0 will have the current markup, -and directory structure. At this point it is largely a matter of choice -as to when the name change is made. -<p> The feature set for html,[^1] LaTeX/pdf -and opendocument is in place. XML, and plaintext are in order. -<p> html and - -<p>LaTeX/pdf may be regarded as reference copy outputs -<p> With regard to the -populating of sql databases (postgresql and sqlite), there is a bit to -be done. -<p> We are still almost there. -<p> DOCUMENT INFORMATION (METADATA) -<p> -METADATA -<p> Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - FAQ - Frequently Asked/Answered Questions -<p> DC Creator: - -<p><i>Ralph</i> Amissah -<p> DC Rights: <i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU -documentation, License GPL 3 -<p> DC Type: <i>information</i> -<p> DC Date created: - -<p><i>2006-09-06</i> -<p> DC Date available: <i>2006-09-06</i> -<p> DC Date issued: <i>2006-09-06</i> -<p> DC -Date modified: <i>2007-09-16</i> -<p> DC Date: <i>2007-09-16</i> -<p> <b>Version Information</b> -<p> Sourcefile: - -<p><i>sisu_faq.sst</i> -<p> Filetype: <i>SiSU</i> text 0.57 -<p> Sourcefile Digest, MD5(sisu_faq.sst)= - -<p><i>41577c9fc063cd232914a1a11a59e91a</i> -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:17 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<ol> -<b>.</b><li>html w3c compliance has been largely met. -<p> </dd> - -<dt>Other versions of -this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_faq/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_faq/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_faq/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_faq/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_faq/toc.html'>http://www.jus.uio.no/sisu/sisu_faq/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_faq/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_faq/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_faq/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_faq/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_faq/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_faq/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:32 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_help.1.html b/data/doc/sisu/html/sisu_help.1.html deleted file mode 100644 index 9b820917..00000000 --- a/data/doc/sisu/html/sisu_help.1.html +++ /dev/null @@ -1,213 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_help"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - HELP, RALPH AMISSAH -<p> SISU HELP -<p> 1. HELP -<p> 1.1 SISU MANUAL -<p> The most -up to date information on sisu should be contained in the sisu_manual, -available at: -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/'>http://www.jus.uio.no/sisu/sisu_manual/</a> -><br> - -<p> and (from <b>SiSU</b> 0.59 onwards) installed locally at: -<p> /usr/share/doc/sisu/sisu_manual/<br> - -<p> or equivalent directory -<p> Within the <b>SiSU</b> tarball at: -<p> ./data/doc/sisu/sisu_manual/<br> - -<p> 1.2 SISU MAN PAGES -<p> If <b>SiSU</b> is installed on your system usual man commands -should be available, try: -<p> man sisu<br> - -<p> man sisu_markup<br> - -<p> man sisu_commands<br> - -<p> Most <b>SiSU</b> man pages are generated directly from sisu documents that -are used to prepare the sisu manual, the sources files for which are located -within the <b>SiSU</b> tarball at: -<p> ./data/doc/sisu/sisu_manual/<br> - -<p> Once installed, directory equivalent to: -<p> /usr/share/doc/sisu/sisu_manual/<br> - -<p> Available man pages are converted back to html using man2html: -<p> /usr/share/doc/sisu/html/<br> - -<p> ./data/doc/sisu/html/<br> - -<p> The <b>SiSU</b> man pages can be viewed online at:[^1] -<p> An online version of -the sisu man page is available here: -<p> * various sisu man pages <<a href='http://www.jus.uio.no/sisu/man/'>http://www.jus.uio.no/sisu/man/</a> -> - [^2] -<p> * sisu.1 <<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a> -> [^3] -<p> * sisu.8 <<a href='http://www.jus.uio.no/sisu/man/sisu.8.html'>http://www.jus.uio.no/sisu/man/sisu.8.html</a> -> - [^4] -<p> * sisu_examples.1 <<a href='http://www.jus.uio.no/sisu/man/sisu_examples.1.html'>http://www.jus.uio.no/sisu/man/sisu_examples.1.html</a> -> [^5] - -<p> * sisu_webrick.1 <<a href='http://www.jus.uio.no/sisu/man/sisu_webrick.1.html'>http://www.jus.uio.no/sisu/man/sisu_webrick.1.html</a> -> [^6] -<p> 1.3 - -<p>SISU BUILT-IN INTERACTIVE HELP -<p> This is particularly useful when current -installation information is obtained as the interactive help is able to -provide information on your sisu configuration and setup. -<p> sisu --help<br> - -<p> sisu --help [subject]<br> - -<p> sisu --help env [for feedback on the way your system is <br> - setup with regard to sisu]<br> - -<p> sisu -V [same as above command]<br> - -<p> sisu --help commands<br> - -<p> sisu --help markup<br> - -<p> Apart from real-time information on your current configuration the <b>SiSU</b> -manual and man pages are likely to contain more up-to-date information than -the sisu interactive help (for example on commands and markup). -<p> NOTE: -Running the command sisu (alone without any flags, filenames or wildcards) -brings up the interactive help, as does any sisu command that is not recognised. -Enter to escape. -<p> 1.4 HELP SOURCES -<p> For lists of alternative help sources, -see: -<p> <b>man page</b> -<p> man sisu_help_sources<br> - -<p> <b>man2html</b> -<p> /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html<br> - -<p> <b>sisu generated html</b> -<p> /usr/share/doc/sisu/html/sisu_help_sources/index.html<br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_help_sources/index.html'>http://sisudoc.org/sisu_manual/sisu_help_sources/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html</a> -><br> - -<p> DOCUMENT INFORMATION (METADATA) -<p> METADATA -<p> Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - Help -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC Rights: <i>Copyright</i> -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -<p> DC -Type: <i>information</i> -<p> DC Date created: <i>2002-08-28</i> -<p> DC Date issued: <i>2002-08-28</i> - -<p> DC Date available: <i>2002-08-28</i> -<p> DC Date modified: <i>2007-08-30</i> -<p> DC Date: <i>2007-08-30</i> - -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_help.sst</i> -<p> Filetype: <i>SiSU</i> text - -<p>0.58 -<p> Sourcefile Digest, MD5(sisu_help.sst)= <i>66d04ba5f3dd4ede774ffa5549b3faba</i> - -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:13 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<ol> -<b>.</b><li>generated from source using rman <<a href='http://polyglotman.sourceforge.net/rman.html'>http://polyglotman.sourceforge.net/rman.html</a> -><br> - With regard to<br> - <b>SiSU</b> man pages the formatting generated for markup syntax is not quite -right, for that you might prefer the links under: <<a href='http://www.jus.uio.no/sample'>http://www.jus.uio.no/sample</a> -><br> - </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/'>http://www.jus.uio.no/sisu/man/</a> -> </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a> -> </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/sisu.8.html'>http://www.jus.uio.no/sisu/man/sisu.8.html</a> -> -</li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/sisu_examples.1.html'>http://www.jus.uio.no/sisu/man/sisu_examples.1.html</a> -> </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/sisu_webrick.1.html'>http://www.jus.uio.no/sisu/man/sisu_webrick.1.html</a> -> - -<p> </dd> - -<dt>Other versions of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_help/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_help/toc.html'>http://www.jus.uio.no/sisu/sisu_help/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_help/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_help/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_help/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_help/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_help/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_help/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:30 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_help_sources.1.html b/data/doc/sisu/html/sisu_help_sources.1.html deleted file mode 100644 index 8ff0d1de..00000000 --- a/data/doc/sisu/html/sisu_help_sources.1.html +++ /dev/null @@ -1,582 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_help_sources"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - REFERENCES, RALPH AMISSAH -<p> SISU HELP SOURCES -<p> 1. HELP SOURCES -<p> - For a summary of alternative ways to get help on <b>SiSU</b> try one of the following: - -<p> <b>man page</b> -<p> man sisu_help<br> - -<p> <b>man2html</b> -<p> <file:///usr/share/doc/sisu/html/sisu_help.1.html><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_help.1.html'>http://www.jus.uio.no/sisu/man/sisu_help.1.html</a> -><br> - -<p> <b>sisu generated output - links to html</b> -<p> <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_help/index.html'>http://sisudoc.org/sisu_manual/sisu_help/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html</a> -><br> - -<p> <b>help sources lists</b> -<p> Alternative sources for this help sources page -listed here: -<p> man sisu_help_sources<br> - -<p> <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html><br> - -<p> <file:///usr/share/doc/sisu/html/sisu_help_sources/index.html><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_help_sources/index.html'>http://sisudoc.org/sisu_manual/sisu_help_sources/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html</a> -><br> - -<p> 1.1 MAN PAGES -<p> 1.1.1 MAN -<p> man sisu<br> - -<p> man sisu_commands<br> - -<p> man 7 sisu_complete<br> - -<p> man sisu_configuration<br> - -<p> man 8 sisu_faq<br> - -<p> man sisu_filetypes<br> - -<p> man sisu_help<br> - -<p> man sisu_help_sources<br> - -<p> man 8 sisu_howto<br> - -<p> man sisu_introduction<br> - -<p> man sisu_markup<br> - -<p> man sisu_output_overview<br> - -<p> man 7 sisu_pdf<br> - -<p> man 7 sisu_postgresql<br> - -<p> man 8 sisu_quickstart<br> - -<p> man 8 sisu_remote<br> - -<p> man 8 sisu_search<br> - -<p> man sisu_skin<br> - -<p> man 7 sisu_sqlite<br> - -<p> man 8 sisu_syntax_highlighting<br> - -<p> man 7 sisu_vim<br> - -<p> man sisu_webrick<br> - -<p> 1.2 SISU GENERATED OUTPUT - LINKS TO HTML -<p> Note <b>SiSU</b> documentation is -prepared in <b>SiSU</b> and output is available in multiple formats including -amongst others html, pdf, and odf which may be also be accessed via the -html pages[^1] -<p> 1.2.1 LOCALLY INSTALLED -<p> <file:///usr/share/doc/sisu/sisu_manual/sisu_manual/index.html> - -<p> <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html> -<p> <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html> - -<p> /usr/share/doc/sisu/sisu_manual/sisu/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_commands/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_configuration/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_description/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_examples/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_faq/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_filetypes/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_help/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_howto/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_introduction/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_manual/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_markup/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_output_overview/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_pdf/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_postgresql/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_quickstart/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_remote/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_search/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_skin/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_vim/index.html<br> - -<p> /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html<br> - -<p> 1.2.2 WWW.SISUDOC.ORG -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_manual/index.html'>http://sisudoc.org/sisu_manual/sisu_manual/index.html</a> -> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu/index.html'>http://sisudoc.org/sisu_manual/sisu/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_commands/index.html'>http://sisudoc.org/sisu_manual/sisu_commands/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_complete/index.html'>http://sisudoc.org/sisu_manual/sisu_complete/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_configuration/index.html'>http://sisudoc.org/sisu_manual/sisu_configuration/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_description/index.html'>http://sisudoc.org/sisu_manual/sisu_description/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_examples/index.html'>http://sisudoc.org/sisu_manual/sisu_examples/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_faq/index.html'>http://sisudoc.org/sisu_manual/sisu_faq/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_filetypes/index.html'>http://sisudoc.org/sisu_manual/sisu_filetypes/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_help/index.html'>http://sisudoc.org/sisu_manual/sisu_help/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_help_sources/index.html'>http://sisudoc.org/sisu_manual/sisu_help_sources/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_howto/index.html'>http://sisudoc.org/sisu_manual/sisu_howto/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_introduction/index.html'>http://sisudoc.org/sisu_manual/sisu_introduction/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_manual/index.html'>http://sisudoc.org/sisu_manual/sisu_manual/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_markup/index.html'>http://sisudoc.org/sisu_manual/sisu_markup/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_output_overview/index.html'>http://sisudoc.org/sisu_manual/sisu_output_overview/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_pdf/index.html'>http://sisudoc.org/sisu_manual/sisu_pdf/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_postgresql/index.html'>http://sisudoc.org/sisu_manual/sisu_postgresql/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_quickstart/index.html'>http://sisudoc.org/sisu_manual/sisu_quickstart/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_remote/index.html'>http://sisudoc.org/sisu_manual/sisu_remote/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_search/index.html'>http://sisudoc.org/sisu_manual/sisu_search/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_skin/index.html'>http://sisudoc.org/sisu_manual/sisu_skin/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_sqlite/index.html'>http://sisudoc.org/sisu_manual/sisu_sqlite/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html'>http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_vim/index.html'>http://sisudoc.org/sisu_manual/sisu_vim/index.html</a> -><br> - -<p> <<a href='http://sisudoc.org/sisu_manual/sisu_webrick/index.html'>http://sisudoc.org/sisu_manual/sisu_webrick/index.html</a> -><br> - -<p> 1.2.3 WWW.JUS.UIO.NO/SISU -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html</a> -> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html</a> -><br> - -<p> 1.2.4 MAN2HTML -<p> 1.2.5 LOCALLY INSTALLED -<p> <file:///usr/share/doc/sisu/html/sisu_manual.1.html> - -<p> <file:///usr/share/doc/sisu/html/sisu_help.1.html> -<p> <file:///usr/share/doc/sisu/html/sisu_help_sources.1.html> - -<p> /usr/share/doc/sisu/html/sisu.1.html<br> - -<p> /usr/share/doc/sisu/html/sisu_commands.1.html<br> - -<p> /usr/share/doc/sisu/html/sisu_complete.7.html<br> - -<p> /usr/share/doc/sisu/html/sisu_configuration.1.html<br> - -<p> /usr/share/doc/sisu/html/sisu_faq.8.html<br> - -<p> /usr/share/doc/sisu/html/sisu_help.1.html<br> - -<p> /usr/share/doc/sisu/html/sisu_help_sources.1.html<br> - -<p> /usr/share/doc/sisu/html/sisu_howto.8.html<br> - -<p> /usr/share/doc/sisu/html/sisu_markup.1.html<br> - -<p> /usr/share/doc/sisu/html/sisu_pdf.7.html<br> - -<p> /usr/share/doc/sisu/html/sisu_postgresql.7.html<br> - -<p> /usr/share/doc/sisu/html/sisu_quickstart.8.html<br> - -<p> /usr/share/doc/sisu/html/sisu_remote.8.html<br> - -<p> /usr/share/doc/sisu/html/sisu_search.8.html<br> - -<p> /usr/share/doc/sisu/html/sisu_skin.1.html<br> - -<p> /usr/share/doc/sisu/html/sisu_sqlite.7.html<br> - -<p> /usr/share/doc/sisu/html/sisu_syntax_highlighting.8.html<br> - -<p> /usr/share/doc/sisu/html/sisu_vim.7.html<br> - -<p> /usr/share/doc/sisu/html/sisu_webrick.1.html<br> - -<p> 1.2.6 WWW.SISUDOC.ORG -<p> <<a href='http:///sisudoc.org/man/sisu_manual.1.html'>http:///sisudoc.org/man/sisu_manual.1.html</a> -> -<p> <<a href='http:///sisudoc.org/man/sisu_help.1.html'>http:///sisudoc.org/man/sisu_help.1.html</a> -> - -<p> <<a href='http:///sisudoc.org/man/sisu_help_sources.1.html'>http:///sisudoc.org/man/sisu_help_sources.1.html</a> -> -<p> <<a href='http://sisudoc.org/man/sisu.1.html'>http://sisudoc.org/man/sisu.1.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_commands.1.html'>http://sisudoc.org/man/sisu_commands.1.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_complete.7.html'>http://sisudoc.org/man/sisu_complete.7.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_configuration.1.html'>http://sisudoc.org/man/sisu_configuration.1.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_faq.8.html'>http://sisudoc.org/man/sisu_faq.8.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_help.1.html'>http://sisudoc.org/man/sisu_help.1.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_help_sources.1.html'>http://sisudoc.org/man/sisu_help_sources.1.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_howto.8.html'>http://sisudoc.org/man/sisu_howto.8.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_markup.1.html'>http://sisudoc.org/man/sisu_markup.1.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_pdf.7.html'>http://sisudoc.org/man/sisu_pdf.7.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_postgresql.7.html'>http://sisudoc.org/man/sisu_postgresql.7.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_quickstart.8.html'>http://sisudoc.org/man/sisu_quickstart.8.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_remote.8.html'>http://sisudoc.org/man/sisu_remote.8.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_search.8.html'>http://sisudoc.org/man/sisu_search.8.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_skin.1.html'>http://sisudoc.org/man/sisu_skin.1.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_sqlite.7.html'>http://sisudoc.org/man/sisu_sqlite.7.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_syntax_highlighting.8.html'>http://sisudoc.org/man/sisu_syntax_highlighting.8.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_vim.7.html'>http://sisudoc.org/man/sisu_vim.7.html</a> -><br> - -<p> <<a href='http://sisudoc.org/man/sisu_webrick.1.html'>http://sisudoc.org/man/sisu_webrick.1.html</a> -><br> - -<p> 1.2.7 WWW.JUS.UIO.NO/SISU -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_manual.1.html'>http://www.jus.uio.no/sisu/man/sisu_manual.1.html</a> -> -<p> - <<a href='http://www.jus.uio.no/sisu/man/sisu_help.1.html'>http://www.jus.uio.no/sisu/man/sisu_help.1.html</a> -> -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html'>http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html</a> -> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_commands.1.html'>http://www.jus.uio.no/sisu/man/sisu_commands.1.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_complete.7.html'>http://www.jus.uio.no/sisu/man/sisu_complete.7.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_configuration.1.html'>http://www.jus.uio.no/sisu/man/sisu_configuration.1.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_faq.8.html'>http://www.jus.uio.no/sisu/man/sisu_faq.8.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_help.1.html'>http://www.jus.uio.no/sisu/man/sisu_help.1.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html'>http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_howto.8.html'>http://www.jus.uio.no/sisu/man/sisu_howto.8.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_markup.1.html'>http://www.jus.uio.no/sisu/man/sisu_markup.1.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_pdf.7.html'>http://www.jus.uio.no/sisu/man/sisu_pdf.7.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html'>http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html'>http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_remote.8.html'>http://www.jus.uio.no/sisu/man/sisu_remote.8.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_search.8.html'>http://www.jus.uio.no/sisu/man/sisu_search.8.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_skin.1.html'>http://www.jus.uio.no/sisu/man/sisu_skin.1.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html'>http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html'>http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_vim.7.html'>http://www.jus.uio.no/sisu/man/sisu_vim.7.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/man/sisu_webrick.1.html'>http://www.jus.uio.no/sisu/man/sisu_webrick.1.html</a> -><br> - -<p> DOCUMENT INFORMATION (METADATA) -<p> METADATA -<p> Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - References -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC Rights: <i>Copyright</i> -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -<p> DC -Type: <i>information</i> -<p> DC Date created: <i>2002-11-12</i> -<p> DC Date issued: <i>2002-11-12</i> - -<p> DC Date available: <i>2002-11-12</i> -<p> DC Date modified: <i>2007-09-16</i> -<p> DC Date: <i>2007-09-16</i> - -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_help_sources.sst</i> -<p> Filetype: <i>SiSU</i> - -<p>text insert 0.58 -<p> Sourcefile Digest, MD5(sisu_help_sources.sst)= <i>ff6812b3008391d7a20d777bbbeb3ec1</i> - -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:13 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<ol> -<b>.</b><li>named index.html or more extensively through sisu_manifest.html - -<p> </dd> - -<dt>Other versions of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_help_sources/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_help_sources/toc.html'>http://www.jus.uio.no/sisu/sisu_help_sources/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:30 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_howto.8.html b/data/doc/sisu/html/sisu_howto.8.html deleted file mode 100644 index a5b9adf7..00000000 --- a/data/doc/sisu/html/sisu_howto.8.html +++ /dev/null @@ -1,1447 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_howto"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - TECHNICAL, HOWTO, RALPH AMISSAH -<p> SISU SOME TECHNICAL INFORMATION - -<p> HOWTO -<p> 1. GETTING HELP -<p> An online manual of sorts should be available -at: -<p> <<a href='http://www.jus.uio.no/sisu_manual/'>http://www.jus.uio.no/sisu_manual/</a> -> -<p> The manual pages provided with -<b>SiSU</b> are also available online, and there is an interactive help, which -is being superseded by the man page, and possibly some document which contains -this component. -<p> 1.1 SISU -<p> If <b>SiSU</b> is installed on your system usual man -commands should be available, try: -<p> man sisu -<p> The <b>SiSU</b> man pages can -be viewed online at:[^1] -<p> An online version of the sisu man page is available -here: -<p> * various sisu man pages <<a href='http://www.jus.uio.no/sisu/man/'>http://www.jus.uio.no/sisu/man/</a> -> [^2] -<p> * sisu.1 -<<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a> -> [^3] -<p> * sisu.8 <<a href='http://www.jus.uio.no/sisu/man/sisu.8.html'>http://www.jus.uio.no/sisu/man/sisu.8.html</a> -> - [^4] -<p> * sisu_examples.1 <<a href='http://www.jus.uio.no/sisu/man/sisu_examples.1.html'>http://www.jus.uio.no/sisu/man/sisu_examples.1.html</a> -> [^5] - -<p> * sisu_webrick.1 <<a href='http://www.jus.uio.no/sisu/man/sisu_webrick.1.html'>http://www.jus.uio.no/sisu/man/sisu_webrick.1.html</a> -> [^6] -<p> 1.2 - -<p>SISU BUILT-IN HELP -<p> sisu --help<br> - -<p> sisu --help [subject]<br> - -<p> sisu --help env [for feedback on the way your system is <br> - setup with regard to sisu]<br> - -<p> sisu -V [same as above command]<br> - -<p> sisu --help commands<br> - -<p> sisu --help markup<br> - -<p> 1.3 COMMAND LINE WITH FLAGS - BATCH PROCESSING -<p> Running sisu (alone without -any flags, filenames or wildcards) brings up the interactive help, as does -any sisu command that is not recognised. -<p> In the data directory run sisu --mh filename or wildcard eg. cisg.sst documents. -<p> 2. SETUP, INITIALISATION - -<p> 2.1 INITIALISE OUTPUT DIRECTORY -<p> Images, css files for a document directory -are copied to their respective locations in the output directory. -<p> while -within your document markup/preparation directory, issue the following - -<p>command -<p> sisu -CC<br> - -<p> 2.1.1 USE OF SEARCH FUNCTIONALITY, AN EXAMPLE USING SQLITE -<p> <b>SiSU</b> can populate -PostgreSQL and Sqlite databases and provides a sample search form for querying -these databases. -<p> This note provides an example to get you started and - -<p>will use sqlite -<p> It is necessary to: -<p> (1) make sure the required dependencies - -<p>have been installed -<p> (2) have a directory with sisu markup samples that - -<p>is writable -<p> (3) use sisu to create a database -<p> (4) use sisu tp populate - -<p>a database -<p> (5) use sisu to start the webrick (httpd) server -<p> (6) use - -<p>sisu to create a search form -<p> (7) copy the search form to the cgi directory - -<p> (8) open up the form in your browser -<p> (9) query the database using the - -<p>search form -<p> <b>(1) make sure the required dependencies have been installed</b> - -<p> if you use <b>Debian</b> , the following command will install the required dependencies - -<p> aptitude install sisu-sqlite -<p> <b>(2) have a directory with sisu markup samples - -<p>that is writable</b> -<p> ideally copy the sisu-examples directory to your home -directory (because the directory in which you run this example should be -writable) -<p> cp -rv /usr/share/sisu-examples/sample/document_samples_sisu_markup -~/. -<p> <b>(3) use sisu to create an sqlite database</b> -<p> within the sisu-examples - -<p>directory -<p> sisu -dv createall -<p> <b>(4) use sisu tp populate a database with - -<p>some text</b> -<p> within the sisu-examples directory -<p> sisu -div free_*.sst -<p> or - -<p> sisu -dv import free_*.sst debian_constitution_v1.2.sst debian_social_contract_v1.1.sst - -<p>gpl2.fsf.sst -<p> <b>(5) use sisu to start the webrick (httpd) server (if it has -not already</b> been started): -<p> sisu -W -<p> <b>(6) use sisu to create a search form -(for use with the webrick server, and</b> your sample documents) -<p> within the - -<p>sisu-examples directory -<p> sisu -F webrick -<p> #here i run into a problem, you -are working from a read only #directory..., not my usual mode of operation, - -<p>to complete the example #the following is necessary sudo touch sisu_sqlite.cgi - -<p>sisu_pgsql.cgi sudo -P chown $USER sisu_sqlite.cgi sisu_pgsql.cgi -<p> #now this -should be possible: sisu -F webrick -<p> <b>(7) copy the search form to the cgi - -<p>directory</b> -<p> the string should be provided as output from the previous command - -<p> sudo cp -vi /usr/share/sisu-examples/sample/document_samples_sisu_markup/sisu_sqlite.cgi - -<p>/usr/lib/cgi-bin -<p> sudo chmod -v 755 /usr/lib/cgi-bin/sisu_sqlite.cgi -<p> <b>(8) - -<p>open up the form in your browser and query it</b> -<p> url: -<p> <<a href='http://localhost:8081/cgi-bin/sisu_sqlite.cgi'>http://localhost:8081/cgi-bin/sisu_sqlite.cgi</a> -> - -<p> or as instructed by command sisu -F webrick -<p> <b>(9) query the database using - -<p>the search form</b> -<p> if there are other options in the dropdown menu select - -<p> document_samples_sisu_markup -<p> and search for some text, e.g.: -<p> aim OR - -<p>project -<p> * selecting the <b>index</b> radio button gives an index of results - -<p>using the object numbers -<p> * selecting the <b>text</b> radio button gives the - -<p>content of the matched paragraphs with the match highlighted -<p> <b>(10) to - -<p>start again with a new database</b> -<p> to start from scratch you can drop the - -<p>database with the command -<p> sisu -dv dropall -<p> and go to step 3 -<p> to get - -<p>to step 3 in one step with a single command -<p> sisu -dv recreate -<p> continue - -<p>subsequent steps -<p> 2.2 MISC -<p> 2.2.1 URL FOR OUTPUT FILES -U -U -<p> sisu -uv[and - other flags] [filename/wildcard]<br> - -<p> sisu -Uv [filename/wildcard]<br> - -<p> 2.2.2 TOGGLE SCREEN COLOR -<p> sisu -cv[and processing flags] [filename/wildcard]<br> - -<p> 2.2.3 VERBOSE MODE -<p> sisu -v[and processing flags] [filename/wildcard]<br> - -<p> sisu -V[and processing flags] [filename/wildcard]<br> - -<p> 2.2.4 QUIET MODE -<p> sisu -q[and processing flags] [filename/wildcard]<br> - -<p> 2.2.5 MAINTENANCE MODE INTERMEDIATE FILES KEPT -M -<p> sisu -Mv[and other - flags] [filename/wildcard]<br> - -<p> 2.2.6 START THE WEBRICK SERVER -<p> sisu -W<br> - -<p> 2.3 REMOTE PLACEMENT OF OUTPUT -<p> configuration is necessary -<p> scp -<p> -sisu -vr[and processing flags] [filename/wildcard]<br> - -<p> rsync -<p> sisu -vR[and processing flags] [filename/wildcard]<br> - -<p> 3. CONFIGURATION FILES -<p> Sample provided, on untarring the source tarball: - -<p> conf/sisu/sisurc.yaml<br> - -<p> and on installation under: -<p> /etc/sisu/sisurc.yaml<br> - -<p> The following paths are searched: -<p> ./_sisu/sisurc.yaml<br> - -<p> ~/.sisu/sisurc.yaml<br> - -<p> ./etc/sisu/sisurc.yaml<br> - -<p> 4. MARKUP -<p> See sample markup provided on -<p> <<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -> -<p> - <<a href='http://www.jus.uio.no/sisu_markup'>http://www.jus.uio.no/sisu_markup</a> -> -<p> <<a href='http://www.jus.uio.no/sisu/SiSU'>http://www.jus.uio.no/sisu/SiSU</a> -> -<p> in particular -for each of the document output samples provided, the source document is - -<p>provided as well -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/2#books'>http://www.jus.uio.no/sisu/SiSU/2#books</a> -> -<p> on untarring -the source tarball: -<p> data/sisu-examples/sample/document_samples_sisu_markup/<br> - -<p> or the same once source is installed (or sisu-examples) under: -<p> /usr/share/sisu-examples/sample/document_samples_sisu_markup/<br> - -<p> Some notes are contained within the man page, <b>man sisu</b> and within sisu - -<p>help via the commands <b>sisu help markup</b> and <b>sisu help headers</b> -<p> <b>SiSU</b> is -for literary and legal text, also for some social science material. In particular -it does not do formula, and is not particularly suited to technical documentation. -Despite the latter caveat, some notes will be provided here and added to -over time: -<p> 4.1 HEADERS -<p> Headers @headername: provide information related -to the document, this may relate to -<p> 1. how it is to be processed, such -as whether headings are to be numbered, what skin is to be used and markup -instructions, such as the document structure, or words to be made bold - -<p>within the document -<p> 2. semantic information about the document including - -<p>the dublin core -<p> 4.2 FONT FACE -<p> Defaults are set. You may change the face -to: bold, italics, underscore, strikethrough, ... -<p> 4.2.1 BOLD -<p> @bold: [list - of words that should be made bold within or document] -<p> <b>bold line</b> -<p> !_ - -<p>bold line -<p> <b>bold word or sentence</b> -<p> !{ bold word or sentence }! -<p> *{ bold -word or sentence }* -<p> <b>boldword</b> or <b>boldword</b> -<p> *boldword* or !boldword! -<p> - -<p>4.2.2 ITALICS -<p> @italics: [list of words that should be italicised within - -<p> <i>italicise</i> word or sentence -<p> /{ italicise word or sentence }/ -<p> <i>italicisedword</i> - -<p> /italicisedword/ -<p> 4.2.3 UNDERSCORE -<p> <i>underscore</i> word or sentence -<p> _{ underscore -word or sentence }_ -<p> <i>underscoreword</i> -<p> 4.2.4 STRIKETHROUGH -<p> <del> strikethrough -word or sentence </del> -<p> -{ strikethrough word or sentence }- -<p> <del>strikeword</del> - -<p> -strikeword- -<p> 4.3 ENDNOTES -<p> There are two forms of markup for endnotes, - -<p>they cannot be mixed within the same document -<p> here[^7] -<p> 1. preferred endnote - -<p>markup -<p> here~{ this is an endnote }~ -<p> 2. alternative markup equivalent, - -<p>kept because it is possible to search and replace to get markup in existing - -<p>texts such as Project Gutenberg -<p> here~^ -<p> ^~ this is an endote -<p> 4.4 LINKS - -<p> SiSU <<a href='http://sisudoc.org'>http://sisudoc.org</a> -> -<p> { <b>SiSU</b> }<a href='http://sisudoc.org'>http://sisudoc.org</a> - -<p> sisu.png 120x39 <<a href='http://sisudoc.org'>http://sisudoc.org</a> -> - -<p> {sisu.png }<a href='http://sisudoc.org'>http://sisudoc.org</a> - -<p> [ tux.png ] -<p> { tux.png 64x80 }image -<p> SiSU -<<a href='http://sisudoc.org'>http://sisudoc.org</a> -> [^8] -<p> { <b>SiSU</b> }<a href='http://sisudoc.org'>http://sisudoc.org</a> - -<p> is equivalent to: -<p> - { <b>SiSU</b> }<a href='http://sisudoc.org'>http://sisudoc.org</a> - ~{ <<a href='http://sisudoc.org'>http://sisudoc.org</a> -> }~ -<p> the same can be done -with an image: -<p> sisu.png 120x39 -<p> { sisu.png <b>SiSU</b> }<a href='http://sisudoc.org'>http://sisudoc.org</a> -<br> - -<p> 4.5 NUMBER TITLES -<p> Set with the header @markup: -<p> 4.6 LINE OPERATIONS -<p> - Line Operations (marker placed at start of line) -<p> !_ bold line -<p> <b>bold - -<p>line</b> -<p> _1 indent paragraph one level -<p> indent paragraph one level<br> - -<p> _2 indent paragraph two steps -<p> indent paragraph two steps<br> - -<p> _* bullet paragraph -<p> * bullet paragraph -<p> # number paragraph (see headers -for numbering document headings) -<p> 1. number paragraph (see headers for -numbering document headings) -<p> _# number paragraph level 2 (see headers -for numbering document headings) -<p> a. number paragraph level 2 (see headers -for numbering document headings)<br> - -<p> 4.7 TABLES -<p> Table markup sample -<p> -<p> table{~h c3; 26; 32; 32; <p> - -<p> -<p> This is -a table, column1 <p> -this would become row one of column two <p> -column three of -row one is here <p> - -<p> -<p> column one row 2 <p> -column two of row two <p> -column three of -row two, and so on <p> - -<p> -<p> column one row three <p> -and so on <p> -here <p> - -<p> -<p> }table <p> - -<p> Alternative - -<p>form of table markup -<p> -<p> <br> -<pre> {t~h} - |Mon|Tue|Wed|Thu|Fri|Sat|Sun - 0 | * | * | * | * | * | * | * - 1 | * | * | * | * | | | - 2 | - | * | * | * | * | * | - 3 | - | * | * | * | * | * | * - 4 | - | | | * | * | * | - 5 | * | * | * | * | * | * | * -</pre> -<p> 4.8 GROUPED TEXT -<p> -<p> <br> -<pre> 5.times { puts ’Ruby’ } -</pre> -<p> code{ -<p> -<p> <br> -<pre> 5.times { puts ’Ruby’ } -</pre> -<p> }code -<p> -<p> A Limerick <p> - -<p> -<p> There was a young lady from Clyde, <p> -who ate a green -apple and died, <p> -but the apple fermented inside the lamented, <p> -and made cider -inside her inside. <p> - -<p> -<p> poem{ <p> - -<p> -<p> There was a young lady from Clyde, <p> -who ate -a green apple and died, <p> -but the apple fermented inside the lamented, <p> -and -made cider inside her inside. <p> - -<p> -<p> }poem <p> - -<p> 4.9 COMPOSITE DOCUMENT -<p> To import -another document, the master document or importing document should be named -filename.r3 (r for require) -<p> &lt;&lt; { filename.sst } -<p> &lt;&lt; { filename.ssi -} -<p> 5. CHANGE APPEARANCE -<p> 5.1 SKINS -<p> Skins appearance, including such things -as the url for the home page on which the material will be published, information -on the credit band, and for html documents colours and icons used in navigation -bars. Skins are ruby files which permit changing of the default values set -within the program for <b>SiSU</b> output. -<p> There are a few examples provided, -on untarring the source tarball: -<p> conf/sisu/skin/doc/<br> - -<p> data/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc<br> - -<p> and on installation under: -<p> /etc/sisu/skin/doc/<br> - -<p> /usr/share/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc<br> - -<p> The following paths are searched: -<p> ./_sisu/skin<br> - -<p> ~/.sisu/skin<br> - -<p> /etc/sisu/skin<br> - -<p> Skins under the searched paths in a per document directory, a per directory -directory, or a site directory, named: -<p> doc [may be specified individually - in each document] -<p> dir [used if identifier part of name matches markup - directory name] -<p> site -<p> It is usual to place all skins in the document -directory, with symbolic links as required from dir or site directories. - -<p> 5.2 CSS -<p> The appearance of html and XML related output can be changed -for an ouput collection directory by prepareing and placing a new css file -in one of the sisu css directories searched in the sisu configuration path. -These are located at: -<p> _./_sisu/css -<p> ~/.sisu/css -<p> and -<p> /etc/sisu/css - -<p> The contents of the first directory found in the search path are copied -to the corresponding sisu output directory with the commnd: -<p> sisu -CC -<p> - The <b>SiSU</b> standard css files for <b>SiSU</b> output are: -<p> dom.css html.css html_tables.css - -<p>index.css sax.css xhtml.css -<p> A document may specify its own/bespoke css file -using the css header. -<p> @css: -<p> [expand] -<p> EXTRACTS FROM THE README -<p> 6. README - -<p> <b>SiSU</b> 0.55 2007w27/6 2007-07-07 -<p> Homepage: <<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -> -<p> <b>Description</b> - -<p> <b>SiSU</b> is lightweight markup based document creation and publishing framework -that is controlled from the command line. Prepare documents for <b>SiSU</b> using -your text editor of choice, then use <b>SiSU</b> to generate various output document -formats. -<p> With minimal preparation of a plain-text (UTF-8) file using its -native markup-syntax, <b>SiSU</b> produces: plain-text, HTML, XHTML, XML, ODF:ODT -(Opendocument), LaTeX, PDF, and populates an SQL database (PostgreSQL or -SQLite) in paragraph sized chunks so that document searches are done at - -<p>this -<p> Outputs share a common citation numbering system, and any semantic -meta-data provided about the document. -<p> <b>SiSU</b> also provides concordance files, -document content certificates and manifests of generated output. -<p> <b>SiSU</b> -takes advantage of well established open standard ways of representing -text, and provides a bridge to take advantage of the strengths of each, -while remaining simple. <b>SiSU</b> implements across document formats a from a - humanities, law, and possibly social sciences rather than technical or - scientific writing] ... focus is primarily on content and data integrity rather -than appearance, (though outputs in the various formats are respectable). - -<p> A vim syntax highlighting file and an ftplugin with folds for sisu markup -is provided. Vim 7 includes syntax highlighting for <b>SiSU</b> -<p> man pages, and -interactive help are provided. -<p> Dependencies for various features are taken -care of in sisu related packages. The package sisu-complete installs the -whole of <b>SiSU</b> -<p> Additional document markup samples are provided in the -package sisu-markup-samples which is found in the non-free archive the licenses -for the substantive content of the marked up documents provided is that -provided by the author or original publisher. -<p> Homepage: <<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -> - -<p> <b>SiSU</b> - simple information structuring universe, is a publishing tool, -document generation and management, (and search enabling) tool primarily -for literary, academic and legal published works. -<p> <b>SiSU</b> can be used for -Internet, Intranet, local filesystem or cd publishing. -<p> <b>SiSU</b> can be used -directly off the filesystem, or from a database. -<p> <b>SiSU</b> ’s scalability, is -be dependent on your hardware, and filesystem (in my case Reiserfs), and/or -database Postgresql. -<p> Amongst it’s characteristics are: -<p> * simple mnemonoic -markup style, -<p> * the ability to produce multiple output formats, including -html, structured XML, LaTeX, pdf (via LaTeX), stream to a relational database -whilst retaining document structure - Postgresql and Sqlite, -<p> * that all -share a common citation system (a simple idea from which much good), possibly -most exciting, the following: if fed into a relational database (as it -can be automatically), the document set is searchable, with results displayed -at a paragraph level, or the possibility of an indexed display of documents -in which the match is found together with a hyperlinked listing for each -of each paragraph in which the match is found. In any event citations using -this system (with or without the relational database) are relevant for -all output formats. -<p> * it is command line driven, and can be set up on - -<p>a remote server -<p> * Documents are marked up in <b>SiSU</b> syntax in your favourite -editor. <b>SiSU</b> syntax may be regarded as a type of smart ascii - which in its -basic form is simpler than the most elementary html. There is currently -a syntax highlighter, and folding for Vim. Syntax highlighters for other -editors are welcome. -<p> Input files should be UTF-8 -<p> Once set up it is simple -to use. -<p> 6.1 ONLINE INFORMATION, PLACES TO LOOK -<p> <<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -> - -<p> Download Sources: -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/download.html#current'>http://www.jus.uio.no/sisu/SiSU/download.html#current</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/download.html#debian'>http://www.jus.uio.no/sisu/SiSU/download.html#debian</a> -><br> - -<p> 6.2 INSTALLATION -<p> NB. Platform is Unix / Linux. -<p> 6.2.1 DEBIAN -<p> If you use -<b>Debian</b> use the <b>Debian</b> packages, check the information at: -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/download.html#debian'>http://www.jus.uio.no/sisu/SiSU/download.html#debian</a> -><br> - -<p> (A) <b>SiSU</b> is available directly off the <b>Debian</b> archives for Sid and testing. -It should necessary only to run as root: -<p> aptitude update<br> - -<p> aptitude install sisu-complete<br> - -<p> (B) If there are newer versions of <b>SiSU</b> upstream of the <b>Debian</b> archives, - -<p>they will be available by adding the following to your /etc/apt/sources.list - -<p> deb <<a href='http://www.jus.uio.no/sisu/archive'>http://www.jus.uio.no/sisu/archive</a> -> unstable main non-free<br> - -<p> deb-src <<a href='http://www.jus.uio.no/sisu/archive'>http://www.jus.uio.no/sisu/archive</a> -> unstable main non-free<br> - -<p> [the non-free line is for document markup samples, for which the substantive - text is provided under the author or which original publisher’s license - and which in most cases will -<p> Then as root run: -<p> aptitude update<br> - -<p> aptitude install sisu-complete<br> - -<p> 6.2.2 RPM -<p> RPMs are provided though untested, they are prepared by running -alien against the source package, and against the debs. -<p> They may be downloaded -from: -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/download.html#rpm'>http://www.jus.uio.no/sisu/SiSU/download.html#rpm</a> -><br> - -<p> 6.2.3 SOURCE PACKAGE .TGZ -<p> Otherwise to install <b>SiSU</b> from source, check -information at: -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/download.html#current'>http://www.jus.uio.no/sisu/SiSU/download.html#current</a> -><br> - -<p> alternative modes of installation from source are provided, setup.rb -(by Minero Aoki), rake (by Jim Weirich) built install file, rant (by Stefan -Lang) built install file, -<p> <b>Ruby</b> is the essential dependency for the basic - -<p>operation of <b>SiSU</b> -<p> 1. Download the latest source (information available) -from: -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/download.html#current'>http://www.jus.uio.no/sisu/SiSU/download.html#current</a> -><br> - -<p> 2. Unpack the source -<p> Note however, that additional external package -dependencies, such as texlive or postgresql should you desire to use it -are not taken care of for you. -<p> 6.2.4 TO USE SETUP.RB -<p> this is a three step -process, in the root directory of the unpacked <b>SiSU</b> as root type: -<p> ruby -setup.rb config<br> - -<p> ruby setup.rb setup<br> - -<p> as root: -<p> ruby setup.rb install<br> - -<p> further information: -<p> <<a href='http://i.loveruby.net/en/projects/setup/'>http://i.loveruby.net/en/projects/setup/</a> -><br> - -<p> <<a href='http://i.loveruby.net/en/projects/setup/doc/usage.html'>http://i.loveruby.net/en/projects/setup/doc/usage.html</a> -><br> - -<p> 6.2.5 TO USE INSTALL (PRAPARED WITH -<p> Rake must be installed on your system: - -<p> <<a href='http://rake.rubyforge.org/'>http://rake.rubyforge.org/</a> -><br> - -<p> <<a href='http://rubyforge.org/frs/?group_id=50'>http://rubyforge.org/frs/?group_id=50</a> -><br> - -<p> in the root directory of the unpacked <b>SiSU</b> as root type: -<p> rake<br> - -<p> or -<p> rake base<br> - -<p> This makes use of Rake (by Jim Weirich) and the provided Rakefile -<p> -For a list of alternative actions you may type: -<p> rake help<br> - -<p> rake -T<br> - -<p> 6.2.6 TO USE INSTALL (PRAPARED WITH -<p> (you may use the instructions above -for rake substituting rant if rant is installed on your system, or you -may use an independent installer created using rant as follows:) -<p> in the -root directory of the unpacked <b>SiSU</b> as root type: -<p> ruby ./sisu-install<br> - -<p> or -<p> ruby ./sisu-install base<br> - -<p> This makes use of Rant (by Stefan Lang) and the provided Rantfile. It -has been configured to do post installation setup setup configuration and -generation of first test file. Note however, that additional external package -dependencies, such as tetex-extra are not taken care of for you. -<p> further -information: -<p> <<a href='http://make.rubyforge.org/'>http://make.rubyforge.org/</a> -><br> - -<p> <<a href='http://rubyforge.org/frs/?group_id=615'>http://rubyforge.org/frs/?group_id=615</a> -><br> - -<p> For a list of alternative actions you may type: -<p> ruby ./sisu-install -help<br> - -<p> ruby ./sisu-install -T<br> - -<p> 6.3 DEPENDENCIES -<p> Once installed see ’man 8 sisu’ for some information -on additional programs that sisu makes use of, and that you may need or -wish to install. (this will depend on such factors as whether you want to -generate pdf, whether you will be using <b>SiSU</b> with or without a database, -...) ’man sisu_markup-samples’ may also be of interest if the sisu-markup-samples -package has also been installed. -<p> The information in man 8 may not be most -up to date, and it is possible that more useful information can be gleaned -from the following notes taken from the <b>Debian</b> control file (end edited), -gives an idea of additional packages that <b>SiSU</b> can make use of if available, -(the use/requirement of some of which are interdependent for specific actions -by <b>SiSU</b> ). -<p> The following is from the debian/control file of sisu-0.58.2, -which amongst other things provides the dependencies of sisu within <b>Debian</b> - -<p> -<p> <br> -<pre> Package: sisu - Architecture: all - Depends: ruby (>= 1.8.2), libwebrick-ruby, unzip, zip - Conflicts: vim-sisu, sisu-vim, sisu-remote - Replaces: vim-sisu, sisu-vim - Recommends: sisu-pdf, sisu-sqlite, sisu-postgresql, librmagick-ruby, trang, - tidy, librexml-ruby, openssl, rsync, openssh-client | lsh-client, keychain, - hyperestraier, kdissert, vim-addon-manager - Suggests: rcs | cvs, lv, texinfo, pinfo - Package: sisu-complete - Depends: ruby (>= 1.8.4), sisu, sisu-pdf, sisu-postgresql, sisu-sqlite - Recommends: hyperestraier - Package: sisu-pdf - Architecture: all - Depends: sisu, texlive-latex-base, texlive-fonts-recommended, - texlive-latex-recommended, texlive-latex-extra - Suggests: evince, xpdf - Package: sisu-postgresql - Depends: sisu, postgresql-8.1, libdbi-ruby, libdbm-ruby, libdbd-pg-ruby - Suggests: pgaccess, libdbd-pgsql, postgresql-contrib-8.1 - Package: sisu-sqlite - Depends: sisu, sqlite, libdbi-ruby, libdbm-ruby, libdbd-sqlite-ruby - Suggests: libdbd-sqlite - Package: sisu-markup-samples - Depends: sisu -</pre> -<p> -<p> <br> -<pre> Source: sisu - Section: text - Priority: optional - Maintainer: Ralph Amissah <ralph@amissah.com> - Build-Depends: debhelper (>= 5) - Standards-Version: 3.7.2 - Package: sisu - Architecture: all - Depends: ruby (>= 1.8.2), libwebrick-ruby, unzip, zip - Conflicts: vim-sisu, sisu-vim, sisu-remote - Replaces: vim-sisu, sisu-vim - Recommends: sisu-pdf, sisu-sqlite, sisu-postgresql, hyperestraier, keychain, -librmagick-ruby, librexml-ruby, openssl, openssh-client | lsh-client, rsync, -tidy, vim-addon-manager - Suggests: kdissert, lv, rcs | cvs, pinfo, texinfo, trang - Description: documents - structuring, publishing in multiple formats and -search - SiSU is a lightweight markup based, command line oriented, document - structuring, publishing and search framework for document collections. - . - With minimal preparation of a plain-text, (UTF-8) file, using its native - markup syntax in your text editor of choice, SiSU can generate various - document formats (most of which share a common object numbering system -for - locating content), including plain text, HTML, XHTML, XML, OpenDocument -text - (ODF:ODT), LaTeX, PDF files, and populate an SQL database with objects - (roughly paragraph-sized chunks) so searches may be performed and matches - returned with that degree of granularity: your search criteria is met -by these - documents and at these locations within each document. Object numbering -is - particularly suitable for - works that are frequently changed or updated) for which it provides -a fixed - means of reference of content. Document outputs also share semantic meta-data - provided. - . - SiSU also provides concordance files, document content certificates -and - manifests of generated output. - . - A vim syntax highlighting file and an ftplugin with folds for sisu markup -is - provided, as are syntax highlighting files for kate, kwrite, gedit and - diakonos. Vim 7 includes syntax highlighting for SiSU. - . - man pages, and interactive help are provided. - . - Dependencies for various features are taken care of in sisu related -packages. - The package sisu-complete installs the whole of SiSU. - . - Additional document markup samples are provided in the package - sisu-markup-samples which is found in the non-free archive the licenses -for - the substantive content of the marked up documents provided is that -provided - by the author or original publisher. - . - Homepage: <http://www.jus.uio.no/sisu> -</pre> -<p> -<p> <br> -<pre> Package: sisu-complete - Architecture: all - Depends: ruby (>= 1.8.2), sisu, sisu-pdf, sisu-postgresql, sisu-sqlite - Recommends: hyperestraier - Description: installs all SiSU related packages - This package installs SiSU and related packages that enable sisu to -produce - pdf and to populate postgresql and sqlite databases. - . - SiSU is a lightweight markup based document publishing framework. - . - See sisu for a description of the package. - . - Homepage: <http://www.jus.uio.no/sisu> -</pre> -<p> -<p> <br> -<pre> Package: sisu-pdf - Architecture: all - Depends: sisu, texlive-latex-base, texlive-fonts-recommended, texlive-latex-recommended, -texlive-latex-extra - #Suggests: evince, xpdf - Description: dependencies to convert SiSU LaTeX output to pdf - This package enables the conversion of SiSU LaTeX output to pdf. - . - SiSU is a lightweight markup based document publishing framework. - . - Homepage: <http://www.jus.uio.no/sisu> -</pre> -<p> -<p> <br> -<pre> Package: sisu-postgresql - Architecture: all - Depends: sisu, libdbd-pg-ruby, libdbi-ruby, libdbm-ruby, postgresql - Recommends: libfcgi-ruby - Suggests: postgresql-contrib - Description: SiSU dependencies for use with postgresql database - This package enables SiSU to populate a postgresql database. This is -done at - an object/paragraph level, making granular searches of documents possible. - . - This relational database feature of SiSU is not required but provides - interesting possibilities, including that of granular searches of documents - for matching units of text, primarily paragraphs that can be displayed -or - identified by object citation number, from which an index of documents - matched and each matched paragraph within them can be displayed. - . - SiSU is a lightweight markup based document publishing framework. - . - Homepage: <http://www.jus.uio.no/sisu> -</pre> -<p> -<p> <br> -<pre> Package: sisu-sqlite - Architecture: all - Depends: sisu, sqlite, libdbd-sqlite-ruby, libdbi-ruby, libdbm-ruby - Recommends: libfcgi-ruby - Description: SiSU dependencies for use with sqlite database - This package enables SiSU to populate an sqlite database. This is done -at an - object/paragraph level, making granular searches of documents possible. - . - This relational database feature of SiSU is not required but provides - interesting possibilities, including that of granular searches of documents - for matching units of text, primarily paragraphs that can be displayed -or - identified by object citation number, from which an index of documents - matched and each matched paragraph within them can be displayed. - . - SiSU is a lightweight markup based document publishing framework. - . - Homepage: <http://www.jus.uio.no/sisu> -</pre> -<p> 6.4 QUICK START -<p> Most of the installation should be taken care of by the -aptitude or rant install. (The rant install if run in full will also test -run the generation of the first document). -<p> After installation of sisu-complete, - -<p>move to the document samples directory -<p> cd /usr/share/doc/sisu/sisu_markup_samples/dfsg<br> - -<p> and run -<p> sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst<br> - -<p> or the same: -<p> sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst<br> - -<p> look at output results, see the -<p> or to generate an online document -move to a writable directory, as the file will be downloaded there and -e.g. -<p> sisu -3 <<a href='http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst'>http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst</a> -> - -<p> the database stuff is extra perhaps, the latex stuff could be considered - -<p>extra perhaps but neither needs to be installed for most of sisu output - -<p>to work -<p> examine source document, vim has syntax support -<p> gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst - -<p> additional markup samples in -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a> -><br> - -<p> For help -<p> man sisu<br> - -<p> or -<p> sisu --help<br> - -<p> e.g. -<p> for the way sisu -<p> sisu --help env<br> - -<p> for list of commands and so on -<p> sisu --help commands<br> - -<p> 6.5 CONFIGURATION FILES -<p> The default configuration/setup is contained - -<p>within the program and is altered by configuration settings in <i>etc</i> [sisu - -<p> version]/sisurc.yml or in ~/.sisu/sisurc.yml -<p> * configuration file - a yaml - -<p>file -<p> /etc/sisu/[sisu version]/sisurc.yml<br> - -<p> ~/.sisu/sisurc.yml<br> - -<p> * directory structure - setting up of output and working directory. -<p> -* skins - changing the appearance of a project, directory or individual - -<p>documents within ~/.sisu/skin -<p> ~/.sisu/skin/doc contains individual skins, -with symbolic links from<br> - -<p> ~/.sisu/skin/dir if the contents of a directory are to take a particular<br> - document skin.<br> - -<p> * additional software - eg. Tex and LaTeX (tetex, tetex-base, tetex-extra -on <b>Debian</b> ), Postgresql, [sqlite], trang, tidy, makeinfo, ... none of which -are required for basic html or XML processing. -<p> * if you use Vim as editor -there is a syntax highlighter and fold resource config file for <b>SiSU</b> <i>hope</i> -more syntax highlighters follow. -<p> There are post installation steps (which -are really part of the overall installation) -<p> sisu -C in your marked up -document directory, should do some auto-configuring provided you have the -right permissions for the output directories. (and provided the output directories -have already been specified if you are not using the defaults). -<p> 6.6 USE - -<p>GENERAL OVERVIEW -<p> Documents are marked up in <b>SiSU</b> syntax and kept in an -ordinary text editable file, named with the suffix .sst, or .ssm -<p> Marked - -<p>up <b>SiSU</b> documents are usually kept in a sub-directory of your choosing -<p> - use the interactive help and man pages -<p> sisu --help<br> - -<p> man sisu<br> - -<p> 6.7 HELP -<p> interactive help described below, or man page: -<p> man sisu<br> - -<p> man 8 sisu<br> - -<p> ’man sisu_markup-samples’ [if the sisu-markup-samples package is also installed] - -<p> Once installed an interactive help is available typing ’sisu’ (without) -any flags, and select an option: -<p> sisu<br> - -<p> alternatively, you could type e.g. -<p> sisu --help commands<br> - -<p> sisu --help env<br> - -<p> sisu --help headers<br> - -<p> sisu --help markup<br> - -<p> sisu --help headings<br> - -<p> etc. -<p> for questions about mappings, output paths etc. -<p> sisu --help env<br> - -<p> sisu --help path<br> - -<p> sisu --help directory<br> - -<p> 6.8 DIRECTORY STRUCTURE -<p> Once installed, type: -<p> sisu --help env<br> - -<p> or -<p> sisu -V<br> - -<p> 6.9 CONFIGURATION FILE -<p> The defaults can be changed via <b>SiSU</b> ’s configure -file sisurc.yml which the program expects to find in ./_sisu ~/.sisu or /etc/sisu -(searched in that order, stopping on the first one found) -<p> 6.10 MARKUP -<p> - See man pages. -<p> man sisu<br> - -<p> man 8 sisu<br> - -<p> Once installed there is some information on <b>SiSU</b> Markup in its help: - -<p> sisu --help markup<br> - -<p> and -<p> sisu --help headers<br> - -<p> Sample marked up document are provided with the download tarball in -the directory: -<p> ./data/doc/sisu/sisu_markup_samples/dfsg<br> - -<p> These are installed on the system usually at: -<p> /usr/share/doc/sisu/sisu_markup_samples/dfsg<br> - -<p> More markup samples are available in the package sisu-markup-samples -<p> - <<a href='http://www.jus.uio.no/sisu/SiSU/download.html#sisu-markup-samples'>http://www.jus.uio.no/sisu/SiSU/download.html#sisu-markup-samples</a> -><br> - -<p> Many more are available online off: -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a> -><br> - -<p> 6.11 ADDITIONAL THINGS -<p> There is syntax support for some editors provided -(together with a README file) in -<p> ./data/sisu/conf/syntax<br> - -<p> usually installed to: -<p> /usr/share/sisu/conf/syntax<br> - -<p> 6.12 LICENSE -<p> License: GPL 3 or later see the copyright file in -<p> ./data/doc/sisu<br> - -<p> usually installed to: -<p> /usr/share/doc/sisu<br> - -<p> 6.13 SISU STANDARD -<p> <b>SiSU</b> uses: -<p> * Standard <b>SiSU</b> markup syntax, -<p> * Standard -<b>SiSU</b> meta-markup syntax, and the -<p> * Standard <b>SiSU</b> object citation numbering - -<p>and system -<p> © Ralph Amissah 1997, current 2006 All Rights Reserved. -<p> * - -<p>however note the License section -<p> CHANGELOG -<p> ./CHANGELOG<br> - -<p> and see -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/changelog.html'>http://www.jus.uio.no/sisu/SiSU/changelog.html</a> -><br> - -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/changelog_markup_samples.html'>http://www.jus.uio.no/sisu/SiSU/changelog_markup_samples.html</a> -><br> - -<p> EXTRACTS FROM MAN 8 SISU -<p> 7. POST INSTALLATION SETUP -<p> 7.1 POST INSTALLATION -SETUP - QUICK START -<p> After installation of sisu-complete, move to the document -samples directory, -<p> cd /usr/share/doc/sisu/sisu_markup_samples/dfsg<br> - -<p> [this is not where you would normally work but provides sample documents - for testing, you may prefer instead to copy the contents of that directory - to a local directory before proceeding] -<p> and in that directory, initialise - -<p>the output directory with the command -<p> sisu -CC<br> - -<p> then run: -<p> sisu -1 free_as_in_freedom.rms_and_free_software.sam_williams.sst<br> - -<p> or the same: -<p> sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst<br> - -<p> look at output results, see the -<p> for an overview of your current sisu -setup, type: -<p> sisu --help env<br> - -<p> or -<p> sisu -V<br> - -<p> To generate a document from a remote url accessible location move to -a writable directory, (create a work directory and cd into it) as the file -will be downloaded there and e.g. -<p> sisu -1 <<a href='http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst'>http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst</a> -><br> - -<p> sisu -3<br> - <<a href='http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst'>http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst</a> -><br> - -<p> examine source document, vim has syntax highlighting support -<p> gvim - -<p>free_as_in_freedom.rms_and_free_software.sam_williams.sst -<p> additional markup - -<p>samples in -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a> -><br> - -<p> it should also be possible to run sisu against sisupods (prepared zip -files, created by running the command sisu -S [filename]), whether stored -locally or remotely. -<p> sisu -3<br> - <<a href='http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip'>http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip</a> -><br> - -<p> there is a security issue associated with the running of document skins -that are not your own, so these are turned of by default, and the use of -the following command, which switches on the associated skin is not recommended: - -<p> sisu -3 --trust<br> - <<a href='http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip'>http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip</a> -><br> - -<p> For help -<p> man sisu<br> - -<p> sisu --help<br> - -<p> sisu --help env for the way sisu<br> - -<p> sisu --help commands for list of commands and so on<br> - -<p> 7.2 DOCUMENT MARKUP DIRECTORY -<p> Perhaps the easiest way to begin is to -create a directory for sisu marked up documents within your home directory, -and copy the file structure (and document samples) provided in the document -sample directory: -<p> mkdir ~/sisu_test<br> - -<p> cd ~/sisu_test<br> - -<p> cp -a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* ~/sisu_test/.<br> - -<p> <b>Tip:</b> the markup syntax examples may be of interest -<p> <<a href='http://www.jus.uio.no/sisu/sample/'>http://www.jus.uio.no/sisu/sample/</a> -><br> - -<p> <b>Tip:</b> -<p> sisu -U [sisu markup filename]<br> - -<p> should printout the different possible outputs and where sisu would -place them. -<p> <b>Tip:</b> if you want to toggle ansi color add -<p> c<br> - -<p> to your flags. -<p> 7.2.1 CONFIGURATION FILES -<p> <b>SiSU</b> configuration file search -path is: -<p> ./_sisu/sisurc.yaml<br> - -<p> ~/.sisu/sisurc.yaml<br> - -<p> /etc/sisu/sisurc.yaml<br> - -<p> <b>Debian</b> Installation Note -<p> 7.2.2 DEBIAN INSTALLATION NOTE -<p> It is best - -<p>you see -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/download.html#debian'>http://www.jus.uio.no/sisu/SiSU/download.html#debian</a> -><br> - -<p> for up the most up to date information. -<p> notes taken from the <b>Debian</b> -control file (end edited), gives an idea of additional packages that <b>SiSU</b> -can make use of if available, (the use/requirement of some of which are -interdependent for specific actions by <b>SiSU</b> ): -<p> Package: sisu -<p> <b>SiSU</b> is -a lightweight markup based, command line oriented, document structuring, -publishing and search framework for document collections. -<p> With minimal -preparation of a plain-text, (UTF-8) file, using its native markup syntax -in your text editor of choice, <b>SiSU</b> can generate various document formats -(most of which share a common object numbering system for locating content), -including plain text, HTML, XHTML, XML, OpenDocument text (ODF:ODT), LaTeX, -PDF files, and populate an SQL database with objects (roughly paragraph-sized -chunks) so searches may be performed and matches returned with that degree -of granularity: your search criteria is met by these documents and at these -locations within each document. Object numbering is particularly suitable -for opposed to works that are frequently changed or updated) for which -it provides a fixed means of reference of content. Document outputs also -share semantic meta-data provided. -<p> <b>SiSU</b> also provides concordance files, -document content certificates and manifests of generated output. -<p> A vim -syntax highlighting file and an ftplugin with folds for sisu markup is -provided, as are syntax highlighting files for kate, kwrite, gedit and -diakonos. Vim 7 includes syntax highlighting for <b>SiSU</b> -<p> man pages, and -interactive help are provided. -<p> Dependencies for various features are taken -care of in sisu related packages. The package sisu-complete installs the -whole of <b>SiSU</b> -<p> Additional document markup samples are provided in the -package sisu-markup-samples which is found in the non-free archive the licenses -for the substantive content of the marked up documents provided is that -provided by the author or original publisher. -<p> Homepage: <<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -> - -<p> 7.2.3 DOCUMENT RESOURCE CONFIGURATION -<p> <b>sisu</b> resource configuration information -is obtained from sources (where they exist): -<p> ~/.sisu/sisurc.yaml<br> - -<p> /etc/sisu/[sisu version]/sisurc.yaml<br> - -<p> sisu program defaults<br> - -<p> 7.2.4 SKINS -<p> <b>Skins</b> default document appearance may be modified using skins -contained in sub-directories located at the following paths: -<p> ./_sisu/skin<br> - -<p> ~/.sisu/skin<br> - -<p> /etc/sisu/skin<br> - -<p> more specifically, the following locations (or their /etc/sisu equivalent) -should be used: -<p> ~/.sisu/skin/doc<br> - -<p> skins for individual documents; -<p> ~/.sisu/skin/dir<br> - -<p> skins for directories of matching names; -<p> ~/.sisu/skin/site<br> - -<p> site-wide skin modifying the site-wide appearance of documents. -<p> Usually -all skin files are placed in the document skin directory: -<p> ~/.sisu/skin/doc<br> - -<p> with softlinks being made to the skins contained there from other skin -directories as required. -<p> DOCUMENT INFORMATION (METADATA) -<p> METADATA -<p> -Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - Technical, Howto -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC Rights: -<i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU documentation, License GPL - -<p>3 -<p> DC Type: <i>information</i> -<p> DC Date created: <i>2002-11-12</i> -<p> DC Date issued: - -<p><i>2002-11-12</i> -<p> DC Date available: <i>2002-11-12</i> -<p> DC Date modified: <i>2007-09-16</i> -<p> DC -Date: <i>2007-09-16</i> -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_howto.sst</i> -<p> Filetype: - -<p><i>SiSU</i> text insert 0.57 -<p> Sourcefile Digest, MD5(sisu_howto.sst)= <i>bb17770a0fa5b4ef035ebf0bcfca3faa</i> - -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:16 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<ol> -<b>.</b><li>generated from source using rman <<a href='http://polyglotman.sourceforge.net/rman.html'>http://polyglotman.sourceforge.net/rman.html</a> -><br> - With regard to<br> - <b>SiSU</b> man pages the formatting generated for markup syntax is not quite -right, for that you might prefer the links under: <<a href='http://www.jus.uio.no/sample'>http://www.jus.uio.no/sample</a> -><br> - </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/'>http://www.jus.uio.no/sisu/man/</a> -> </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a> -> </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/sisu.8.html'>http://www.jus.uio.no/sisu/man/sisu.8.html</a> -> -</li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/sisu_examples.1.html'>http://www.jus.uio.no/sisu/man/sisu_examples.1.html</a> -> </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/sisu_webrick.1.html'>http://www.jus.uio.no/sisu/man/sisu_webrick.1.html</a> -> -</li><b>.</b><li>this is an endnote </li><b>.</b><li><<a href='http://sisudoc.org'>http://sisudoc.org</a> -> </li><b>.</b><li><<a href='http://sisudoc.org'>http://sisudoc.org</a> -> -<p> </dd> - -<dt>Other versions -of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_howto/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_howto/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_howto/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_howto/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_howto/toc.html'>http://www.jus.uio.no/sisu/sisu_howto/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_howto/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_howto/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_howto/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_howto/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_howto/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_howto/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:31 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_markup.1.html b/data/doc/sisu/html/sisu_markup.1.html deleted file mode 100644 index 3be61258..00000000 --- a/data/doc/sisu/html/sisu_markup.1.html +++ /dev/null @@ -1,1113 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_markup"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - MARKUP, RALPH AMISSAH -<p> SISU MARKUP -<p> 1. INTRODUCTION TO SISU MARKUP[^1] - -<p> 1.1 SUMMARY -<p> <b>SiSU</b> source documents are plaintext (UTF-8)[^2] files -<p> All -paragraphs are separated by an empty line. -<p> Markup is comprised of: -<p> * -at the top of a document, the document header made up of semantic meta-data -about the document and if desired additional processing instructions (such -an instruction to automatically number headings from a particular level -down) -<p> * followed by the prepared substantive text of which the most important -single characteristic is the markup of different heading levels, which -define the primary outline of the document structure. Markup of substantive -text includes: -<p> * heading levels defines document structure<br> - -<p> * text basic attributes, italics, bold etc.<br> - -<p> * grouped text (objects), which are to be treated differently, such -as code<br> - blocks or poems.<br> - -<p> * footnotes/endnotes<br> - -<p> * linked text and images<br> - -<p> * paragraph actions, such as indent, bulleted, numbered-lists, etc.<br> - -<p> Some interactive help on markup is available, by typing sisu and selecting - -<p>markup or sisu --help markup -<p> 1.2 MARKUP EXAMPLES -<p> 1.2.1 ONLINE -<p> Online markup -examples are available together with the respective outputs produced from -<<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a> -> or from <<a href='http://www.jus.uio.no/sisu/sisu_examples/'>http://www.jus.uio.no/sisu/sisu_examples/</a> -> - -<p> There is of course this document, which provides a cursory overview of -sisu markup and the respective output produced: <<a href='http://www.jus.uio.no/sisu/sisu_markup/'>http://www.jus.uio.no/sisu/sisu_markup/</a> -> - -<p> Some example marked up files are available as html with syntax highlighting -for viewing: <<a href='http://www.jus.uio.no/sisu/sample/syntax'>http://www.jus.uio.no/sisu/sample/syntax</a> -> -<p> an alternative presentation -of markup syntax: <<a href='http://www.jus.uio.no/sisu/sample/on_markup.txt'>http://www.jus.uio.no/sisu/sample/on_markup.txt</a> -> -<p> 1.2.2 INSTALLED - -<p> With <b>SiSU</b> installed sample skins may be found in: /usr/share/doc/sisu/sisu_markup_samples/dfsg -(or equivalent directory) and if sisu-markup-samples is installed also under: - -<p>/usr/share/doc/sisu/sisu_markup_samples/non-free -<p> 2. MARKUP OF HEADERS -<p> - Headers consist of semantic meta-data about a document, which can be used -by any output module of the program; and may in addition include extra -processing instructions. -<p> Note: the first line of a document may include -information on the markup version used in the form of a comment. Comments -are a percentage mark at the start of a paragraph (and as the first character -in a line of text) followed by a space and the comment: -<p> -<p> <br> -<pre> % this would be a comment -</pre> -<p> 2.1 SAMPLE HEADER -<p> This current document has a header similar to this -one (without the comments): -<p> -<p> <br> -<pre> % SiSU 0.57 - @title: SiSU - @subtitle: Markup - @creator: Ralph Amissah - @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, -License GPL 3 - @type: information - @subject: ebook, epublishing, electronic book, electronic publishing, -electronic document, electronic citation, data structure, citation systems, -search - @date.created: 2002-08-28 - @date.issued: 2002-08-28 - @date.available: 2002-08-28 - @date.modified: 2007-09-16 - @date: 2007-09-16 - @level: new=C; break=1; num_top=1 - % comment: in this @level header num_top=1 starts automatic heading numbering -at heading level 1 (numbering continues 3 levels down); the new and break -instructions are used by the LaTeX/pdf and odf output to determine where -to put page breaks (that are not used by html output or say sql database -population). - @skin: skin_sisu_manual - % skins modify the appearance of a document and are placed in a sub-directory -under ./_sisu/skin ~/.sisu/skin or /etc/sisu/skin. A skin may affect single -documents that request them, all documents in a directory, or be site-wide. -(A document is affected by a single skin) - @bold: /Gnu|Debian|Ruby|SiSU/ - @links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/ - { Book Samples and Markup Examples }http://www.jus.uio.no/sisu/SiSU/2.html - { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU - { SiSU @ Freshmeat }http://freshmeat.net/projects/sisu/ - { SiSU @ Ruby Application Archive }http://raa.ruby-lang.org/project/sisu/ - { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html - { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html - { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html -</pre> -<p> 2.2 AVAILABLE HEADERS -<p> Header tags appear at the beginning of a document -and provide meta information on the document (such as the Dublin Core), -or information as to how the document as a whole is to be processed. All -header instructions take either the form @headername: or 0~headername. All - -<p>Dublin Core meta tags are available -<p> <b>@indentifier:</b> information or instructions - -<p> where the information -<p> Note: a header where used should only be used -once; all headers apart from @title: are optional; the @structure: header -is used to describe document structure, and can be useful to know. -<p> This - -<p>is a sample header -<p> <b>% SiSU 0.38</b> [declared file-type identifier with markup - version] -<p> <b>@title:</b> [title text] This is the title of the document and used -as such, this header is the only one that is <i>mandatory</i> -<p> <b>@subtitle:</b> The - -<p>Subtitle if any -<p> <b>@creator:</b> [or @author:] Name of Author -<p> <b>@subject:</b> (whatever -your subject) -<p> <b>@description:</b> -<p> <b>@publisher:</b> -<p> <b>@contributor:</b> -<p> <b>@translator:</b> - [or @translated_by:] -<p> <b>@illustrator:</b> [or @illustrated_by:] -<p> <b>@prepared_by:</b> - [or @digitized_by:] -<p> <b>@date: 2000-08-27</b> [ also @date.created: @date.issued: - @date.available: @date.valid: @date.modified: ] -<p> <b>@type: article</b> -<p> <b>@format:</b> - -<p> <b>@identifier:</b> -<p> <b>@source:</b> -<p> <b>@language:</b> [or @language.document:] [country - code for language if available, or language, English, en is the default - setting] (en - English, fr - French, de - German, it - Italian, es - Spanish, -pt - Portuguese, sv - Swedish, da - Danish, fi - Finnish, no - Norwegian, is -- Icelandic, nl - Dutch, et - Estonian, hu - Hungarian, pl - Polish, ro - Romanian, -ru - Russian, el - Greek, uk - Ukranian, tr - Turkish, sk - Slovak, sl - Slovenian, -hr - Croatian, cs - Czech, bg - Bul garian ) [however, encodings are not available - for all of the languages listed.] -<p> [@language.original: original language - in which the work was published] -<p> <b>@papersize:</b> (A4|US_letter|book_B5|book_A5|US_legal) - -<p> <b>@relation:</b> -<p> <b>@coverage:</b> -<p> <b>@rights:</b> Copyright (c) Name of Right Holder, -all rights reserved, or as granted: public domain, copyleft, creative commons -variant, etc. -<p> <b>@owner:</b> -<p> <b>@keywords:</b> text document generation processing -management latex pdf structured xml citation [your keywords here, used - for example by rss feeds, and in sql searches] -<p> <b>@abstract:</b> [paper abstract, - placed after table of contents] -<p> <b>@comment:</b> [...] -<p> <b>@catalogue:</b> loc=[Library - of Congress classification]; dewey=[Dewey rss feeds, classification]; isbn=[ISBN]; -pg=[Project Gutenberg text number] -<p> <b>@classify_loc:</b> [Library of Congress - classification] -<p> <b>@classify_dewey:</b> [Dewey classification] -<p> <b>@classify_isbn:</b> - [ISBN] -<p> <b>@classify_pg:</b> [Project Gutenberg text number] -<p> <b>@prefix:</b> [prefix - is placed just after table of contents] -<p> <b>@prefix_a:</b> [prefix is placed - just before table of contents - not implemented] -<p> <b>@prefix_b:</b> -<p> <b>@rcs:</b> $Id: -sisu_markup.sst,v 1.2 2007/09/08 17:12:47 ralph Exp $ [used by rcs or cvs - to embed version (revision control) information into under ./_sisu/skin -~/.sisu/skin or /etc/sisu/skin. A skin may affect single documents that request -them, all documents in a directory, or be site-wide. (A document is affected -by a single skin) document, rcs or cvs can usefully provide a history of -under ./_sisu/skin ~/.sisu/skin or /etc/sisu/skin. A skin may affect single -documents that request them, all documents in a directory, or be site-wide. -(A document is affected by a single skin) updates to a document ] -<p> <b>@structure:</b> -PART; CHAPTER; SECTION; ARTICLE; none; none; optional, document structure -can be defined by words to match or regular expression (the regular expression -is assumed to start at the beginning of a line of text i.e. ^) default markers -:A~ to :C~ and 1~ to 6~ can be used within text instead, without this header -tag, and may be used to supplement the instructions provided in this header -tag if provided (@structure: is a synonym for @toc:) -<p> <b>@level:</b> newpage=3; -breakpage=4 [paragraph level, used by latex to breakpages, the page in - newpage] -<p> <b>@markup:</b> information on the markup used, e.g. new=1,2,3; break=4; -num_top=4 [or newpage=1,2,3; breakpage=4; num_top=4] newpage and breakpage, -heading level, used by LaTeX to breakpages. breakpage: starts on a new page -in single column text and on a new column in double column text; newpage: -starts on a new page for both single and double column texts. num_top=4 - [auto-number document, starting at level 4. the new default is to provide - 3 levels, as in 1 level 4, 1.1 1.1.1 level 6, markup to be merged within level] -num_extract [take numbering of headings provided (manually in and use - for numbering of Available where a clear numbering structure is without - the repetition of a number in a header.] [In 0.38 notation, you would map - to the equivalent levels, the examples provided would map to the following - new=A,B,C; break=1; num_top=1 [or newpage=A,B,C; breakpage=1; num_top=1] -see headings] -<p> <b>@bold:</b> [regular expression of words/phrases to be made - bold] -<p> <b>@italics:</b> [regular expression of words/phrases to italicise] -<p> -<b>@vocabulary:</b> name of taxonomy/vocabulary/wordlist to use against document - -<p> <b>@skin:</b> skin_doc_[name_of_desired_document_skin] skins change default -settings related to the appearance of documents generated, such as the -urls of the home site, and the icon/logo for the document or site. -<p> <b>@links:</b> -{ <b>SiSU</b> }<a href='http://www.jus.uio.no/sisu/;'>http://www.jus.uio.no/sisu/;</a> - { FSF }<a href='http://www.fsf.org'>http://www.fsf.org</a> - -<p> <b>@promo:</b> sisu, -ruby, search_libre_docs, open_society [places content in right pane in - html, makes use of list.yml and promo.yml, commented out sample in document -sample: and promo.yml, commented out sample in document free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst] - -<p> 3. MARKUP OF SUBSTANTIVE TEXT -<p> 3.1 HEADING LEVELS -<p> Heading levels are -:A~ ,:B~ ,:C~ ,1~ ,2~ ,3~ ... :A - :C being part / section headings, followed -by other heading levels, and 1 -6 being headings followed by substantive -text or sub-headings. :A~ usually the title :A~? conditional level 1 heading -(used where a stand-alone document may be imported into another) -<p> <b>:A~ [heading - text]</b> Top level heading [this usually has similar content to the ] NOTE: -the heading levels described here are in 0.38 notation, see heading -<p> <b>:B~ - [heading text]</b> Second level heading [this is a heading level divider] -<p> - <b>:C~ [heading text]</b> Third level heading [this is a heading level divider] - -<p> <b>1~ [heading text]</b> Top level heading preceding substantive text of document -or sub-heading 2, the heading level that would normally be marked 1. or 2. -or 3. etc. in a document, and the level on which sisu by default would break -html output into named segments, names are provided automatically if none -are given (a number), otherwise takes the form 1~my_filename_for_this_segment - -<p> <b>2~ [heading text]</b> Second level heading preceding substantive text of -document or sub-heading 3, the heading level that would normally be marked -1.1 or 1.2 or 1.3 or 2.1 etc. in a document. -<p> <b>3~ [heading text]</b> Third level -heading preceding substantive text of document, that would normally be -marked 1.1.1 or 1.1.2 or 1.2.1 or 2.1.1 etc. in a document -<p> -<p> <br> -<pre> 1~filename level 1 heading, - % the primary division such as Chapter that is followed by substantive -text, and may be further subdivided (this is the level on which by default -html segments are made) -</pre> -<p> 3.2 FONT ATTRIBUTES -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> normal text !{emphasis}! *{bold text}* _{underscore}_ /{italics}/ - normal text - !{emphasis}! - *{bold text}* - _{underscore} - /{italics}/ - - ^{superscript}^ - ,{subscript}, - +{inserted text}+ - -{strikethrough}- -</pre> -<p> <b>resulting output:</b> -<p> normal text <em>emphasis</em> <b>bold text</b> <i>underscore</i> <i>italics</i> -<cite>citation</cite> ^superscript^ [subscript] <ins>inserted text</ins> <del>strikethrough</del> - -<p> normal text -<p> <em>emphasis</em> -<p> <b>bold text</b> -<p> <i>underscore</i> -<p> <i>italics</i> -<p> <cite>citation</cite> - -<p> ^superscript^ -<p> [subscript] -<p> <ins>inserted text</ins> -<p> <del>strikethrough</del> - -<p> 3.3 INDENTATION AND BULLETS -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> ordinary paragraph - _1 indent paragraph one step - _2 indent paragraph two steps - _9 indent paragraph nine steps -</pre> -<p> <b>resulting output:</b> -<p> ordinary paragraph -<p> indent paragraph one step<br> - -<p> indent paragraph two steps<br> - -<p> indent paragraph nine steps<br> - -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> * bullet text - _1* bullet text, first indent - _2* bullet text, two step indent -</pre> -<p> <b>resulting output:</b> -<p> * bullet text -<p> * bullet text, first indent<br> - -<p> * bullet text, two step indent<br> - -<p> Numbered List (not to be confused with headings/titles, (document structure)) - -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> # numbered list numbered list 1., 2., 3, etc. - _# numbered list numbered list indented a., b., c., d., etc. -</pre> -<p> 3.4 FOOTNOTES / ENDNOTES -<p> Footnotes and endnotes not distinguished in -markup. They are automatically numbered. Depending on the output file format -(html, odf, pdf etc.), the document output selected will have either footnotes -or endnotes. -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> ~{ a footnote or endnote }~ -</pre> -<p> <b>resulting output:</b> -<p> [^3] -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> normal text~{ self contained endnote marker & endnote in one }~ continues -</pre> -<p> <b>resulting output:</b> -<p> normal text[^4] continues -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> normal text ~{* unnumbered asterisk footnote/endnote, insert multiple -asterisks if required }~ continues - normal text ~{** another unnumbered asterisk footnote/endnote }~ continues -</pre> -<p> <b>resulting output:</b> -<p> normal text [^*] continues -<p> normal text [^**] continues - -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> normal text ~[* editors notes, numbered asterisk footnote/endnote series - ]~ continues - normal text ~[+ editors notes, numbered asterisk footnote/endnote series - ]~ continues -</pre> -<p> <b>resulting output:</b> -<p> normal text [^*1] continues -<p> normal text [^+1] continues - -<p> <b>Alternative endnote pair notation for footnotes/endnotes:</b> -<p> -<p> <br> -<pre> - % note the endnote marker - normal text~^ continues - ^~ endnote text following the paragraph in which the marker occurs -</pre> -<p> the standard and pair notation cannot be mixed in the same document -<p> - -<p>3.5 LINKS -<p> 3.5.1 NAKED URLS WITHIN TEXT, DEALING WITH URLS -<p> urls are found -within text and marked up automatically. A url within text is automatically -hyperlinked to itself and by default decorated with angled braces, unless -they are contained within a code block (in which case they are passed as -normal text), or escaped by a preceding underscore (in which case the decoration -is omitted). -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> normal text http://www.jus.uio.no/sisu continues -</pre> -<p> <b>resulting output:</b> -<p> normal text <<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -> continues -<p> An - -<p>escaped url without decoration -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> normal text http://www.jus.uio.no/sisu continues - deb http://www.jus.uio.no/sisu/archive unstable main non-free -</pre> -<p> <b>resulting output:</b> -<p> normal text <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - continues -<p> deb - -<p><a href='http://www.jus.uio.no/sisu/archive'>http://www.jus.uio.no/sisu/archive</a> - unstable main non-free -<p> where a code block -is used there is neither decoration nor hyperlinking, code blocks are discussed - -<p>later in this document -<p> <b>resulting output:</b> -<p> -<p> <br> -<pre> deb http://www.jus.uio.no/sisu/archive unstable main non-free - deb-src http://www.jus.uio.no/sisu/archive unstable main non-free -</pre> -<p> To link text or an image to a url the markup is as follows -<p> <b>markup example:</b> - -<p> -<p> <br> -<pre> about { SiSU }http://url.org markup -</pre> -<p> 3.5.2 LINKING TEXT -<p> <b>resulting output:</b> -<p> about SiSU <<a href='http://www.jus.uio.no/sisu/'>http://www.jus.uio.no/sisu/</a> -> - -<p>markup -<p> A shortcut notation is available so the url link may also be provided - -<p>automatically as a footnote -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> about {~^ SiSU }http://url.org markup -</pre> -<p> <b>resulting output:</b> -<p> about SiSU <<a href='http://www.jus.uio.no/sisu/'>http://www.jus.uio.no/sisu/</a> -> [^5] markup -<p> 3.5.3 - -<p>LINKING IMAGES -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> [ tux.png ] - % various url linked images - [ tux.png ] - [ GnuDebianLinuxRubyBetterWay.png ] - {~^ ruby_logo.png -</pre> -<p> <b>resulting output:</b> -<p> [ tux.png ] -<p> tux.png 64x80 -<p> [ ruby_logo (png missing) - ] [^6] -<p> GnuDebianLinuxRubyBetterWay.png 100x101 and Ruby -<p> <b>linked url footnote - -<p>shortcut</b> -<p> -<p> <br> -<pre> {~^ [text to link] }http://url.org - % maps to: { [text to link] }http://url.org ~{ http://url.org }~ - % which produces hyper-linked text within a document/paragraph, with an -endnote providing the url for the text location used in the hyperlink -</pre> -<p> -<p> <br> -<pre> text marker *~name -</pre> -<p> note at a heading level the same is automatically achieved by providing -names to headings 1, 2 and 3 i.e. 2~[name] and 3~[name] or in the case of -auto-heading numbering, without further intervention. -<p> 3.6 GROUPED TEXT -<p> 3.6.1 - -<p>TABLES -<p> Tables may be prepared in two either of two forms -<p> <b>markup example:</b> - -<p> -<p> <br> -<pre> table{ c3; 40; 30; 30; - This is a table - this would become column two of row one - column three of row one is here - And here begins another row - column two of row two - column three of row two, and so on - }table -</pre> -<p> <b>resulting output:</b> -<p> [table omitted, see other document formats]<br> - -<p> a second form may be easier to work with in cases where there is not - -<p>much information in each column -<p> <b>markup example:</b> [^7] -<p> -<p> <br> -<pre> !_ Table 3.1: Contributors to Wikipedia, January 2001 - June 2005 - {table~h 24; 12; 12; 12; 12; 12; 12;} - |Jan. 2001|Jan. 2002|Jan. 2003|Jan. 2004|July -2004|June 2006 - Contributors* | 10| 472| 2,188| 9,653| - 25,011| 48,721 - Active contributors** | 9| 212| 846| 3,228| - 8,442| 16,945 - Very active contributors*** | 0| 31| 190| 692| - 1,639| 3,016 - No. of English language articles| 25| 16,000| 101,000| 190,000| -320,000| 630,000 - No. of articles, all languages | 25| 19,000| 138,000| 490,000| -862,000|1,600,000 - \* Contributed at least ten times; \** at least 5 times in last month; -\* more than 100 times in last month. -</pre> -<p> <b>resulting output:</b> -<p> <b>Table 3.1: Contributors to Wikipedia, January 2001 -- June 2005</b> -<p> [table omitted, see other document formats]<br> - -<p> * Contributed at least ten times; ** at least 5 times in last month; -*** more than 100 times in last month. -<p> 3.6.2 POEM -<p> <b>basic markup:</b> -<p> -<p> <br> -<pre> poem{ - Your poem here - }poem - Each verse in a poem is given a separate object number. -</pre> -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> poem{ - ’Fury said to a - mouse, That he - met in the - house, - - both go to - law: I will - prosecute - YOU. --Come, - I’ll take no - denial; We - must have a - trial: For - really this - morning I’ve - nothing - to do. - Said the - mouse to the - cur, - a trial, - dear Sir, - With - no jury - or judge, - would be - wasting - our - breath. - - judge, I’ll - be jury, - Said - cunning - old Fury: - - try the - whole - cause, - and - condemn - you - to - death. - }poem -</pre> -<p> <b>resulting output:</b> -<p> -<p> ’Fury said to a<br> - <p> - mouse, That he<br> - <p> - met in the<br> - <p> - house,<br> - <p> - <br> - <p> - both go to<br> - <p> - law: I will<br> - <p> - prosecute<br> - <p> - YOU. --Come,<br> - <p> - I’ll take no<br> - <p> - denial; We<br> - <p> - must have a<br> - <p> - trial: For<br> - <p> - really this<br> - <p> - morning I’ve<br> - <p> - nothing<br> - <p> - to do.<br> - <p> - Said the<br> - <p> - mouse to the<br> - <p> - cur,<br> - <p> - a trial,<br> - <p> - dear Sir,<br> - <p> - With<br> - <p> - no jury<br> - <p> - or judge,<br> - <p> - would be<br> - <p> - wasting<br> - <p> - our<br> - <p> - breath.<br> - <p> - <br> - <p> - judge, I’ll<br> - <p> - be jury,<br> - <p> - Said<br> - <p> - cunning<br> - <p> - old Fury:<br> - <p> - <br> - <p> - try the<br> - <p> - whole<br> - <p> - cause,<br> - <p> - and<br> - <p> - condemn<br> - <p> - you<br> - <p> - to<br> - <p> - death.<br> - <p> - -<p> 3.6.3 GROUP -<p> <b>basic markup:</b> -<p> -<p> <br> -<pre> group{ - Your grouped text here - }group - A group is treated as an object and given a single object number. -</pre> -<p> <b>markup example:</b> -<p> -<p> <br> -<pre> group{ - ’Fury said to a - mouse, That he - met in the - house, - - both go to - law: I will - prosecute - YOU. --Come, - I’ll take no - denial; We - must have a - trial: For - really this - morning I’ve - nothing - to do. - Said the - mouse to the - cur, - a trial, - dear Sir, - With - no jury - or judge, - would be - wasting - our - breath. - - judge, I’ll - be jury, - Said - cunning - old Fury: - - try the - whole - cause, - and - condemn - you - to - death. - }group -</pre> -<p> <b>resulting output:</b> -<p> -<p> ’Fury said to a<br> - <p> - mouse, That he<br> - <p> - met in the<br> - <p> - house,<br> - <p> - <br> - <p> - both go to<br> - <p> - law: I will<br> - <p> - prosecute<br> - <p> - YOU. --Come,<br> - <p> - I’ll take no<br> - <p> - denial; We<br> - <p> - must have a<br> - <p> - trial: For<br> - <p> - really this<br> - <p> - morning I’ve<br> - <p> - nothing<br> - <p> - to do.<br> - <p> - Said the<br> - <p> - mouse to the<br> - <p> - cur,<br> - <p> - a trial,<br> - <p> - dear Sir,<br> - <p> - With<br> - <p> - no jury<br> - <p> - or judge,<br> - <p> - would be<br> - <p> - wasting<br> - <p> - our<br> - <p> - breath.<br> - <p> - <br> - <p> - judge, I’ll<br> - <p> - be jury,<br> - <p> - Said<br> - <p> - cunning<br> - <p> - old Fury:<br> - <p> - <br> - <p> - try the<br> - <p> - whole<br> - <p> - cause,<br> - <p> - and<br> - <p> - condemn<br> - <p> - you<br> - <p> - to<br> - <p> - death.<br> - <p> - -<p> 3.6.4 CODE -<p> Code tags are used to escape regular sisu markup, and have -been used extensively within this document to provide examples of <b>SiSU</b> -markup. You cannot however use code tags to escape code tags. They are however -used in the same way as group or poem tags. -<p> A code-block is treated as -an object and given a single object number. [an more than 100 times in last -month. option to number each line of code may be considered at more than -100 times in last month. some later time] -<p> <b>use of code tags instead of -poem compared, resulting output:</b> -<p> -<p> <br> -<pre> ’Fury said to a - mouse, That he - met in the - house, - - both go to - law: I will - prosecute - YOU. --Come, - I’ll take no - denial; We - must have a - trial: For - really this - morning I’ve - nothing - to do. - Said the - mouse to the - cur, - a trial, - dear Sir, - With - no jury - or judge, - would be - wasting - our - breath. - - judge, I’ll - be jury, - Said - cunning - old Fury: - - try the - whole - cause, - and - condemn - you - to - death. -</pre> -<p> 4. COMPOSITE DOCUMENTS MARKUP -<p> It is possible to build a document by -creating a master document that requires other documents. The documents -required may be complete documents that could be generated independently, -or they could be markup snippets, prepared so as to be easily available -to be placed within another text. If the calling document is a master document -(built from other documents), it should be named with the suffix <b>.ssm</b> Within -this document you would provide information on the other documents that -should be included within the text. These may be other documents that would -be processed in a regular way, or markup bits prepared only for inclusion -within a master document <b>.sst</b> regular markup file, or <b>.ssi</b> (insert/information) - -<p>A secondary file of the composite document is built prior to processing - -<p>with the same prefix and the suffix <b>._sst</b> -<p> basic markup for importing a - -<p>document into a master document -<p> -<p> <br> -<pre> << |filename1.sst|@|^| - << |filename2.ssi|@|^| -</pre> -<p> The form described above should be relied on. Within the Vim editor it -results in the text thus linked becoming hyperlinked to the document it -is calling in which is convenient for editing. Alternative markup for importation -of documents under consideration, and occasionally supported have been. - -<p> -<p> <br> -<pre> r{filename} - {filename.ssi}require - << {filename.ssi} - % using textlink alternatives - |filename.ssi|@|^|require - << |filename.ssi|@|^| - % using thlnk alternatives - <url:filename.ssi>require - << <url:filename.ssi> -</pre> -<p> MARKUP SYNTAX HISTORY -<p> 5. NOTES RELATED TO FILES-TYPES AND MARKUP SYNTAX - -<p> 0.38 is substantially current, depreciated 0.16 supported, though file - -<p>names were changed at 0.37 -<p> <b>0.52</b> (2007w14/6) declared document type identifier -at start of text/document: -<p> .B SiSU<br> - 0.52 -<p> or, backward compatible using the comment marker: -<p> %<br> - <b>SiSU</b> 0.38 -<p> variations include ’ <b>SiSU</b> (text|master|insert) [version]’ and ’sisu-[version]’ - -<p> <b>0.51</b> (2007w13/6) skins changed (simplified), markup unchanged -<p> <b>0.42</b> (2006w27/4) -* (asterisk) type endnotes, used e.g. in relation to author -<p> <b>0.38</b> (2006w15/7) -introduced new/alternative notation for headers, e.g. @title: (instead of -0~title), and accompanying document structure markup, :A,:B,:C,1,2,3 (maps -to previous 1,2,3,4,5,6) -<p> <b>0.37</b> (2006w09/7) introduced new file naming convention, -.sst (text), .ssm (master), .ssi (insert), markup syntax unchanged -<p> <b>0.35</b> (2005w52/3) -sisupod, zipped content file introduced -<p> <b>0.23</b> (2005w36/2) utf-8 for markup - -<p>file -<p> <b>0.22</b> (2005w35/3) image dimensions may be omitted if rmagick is available - -<p>to be relied upon -<p> <b>0.20.4</b> (2005w33/4) header 0~links -<p> <b>0.16</b> (2005w25/2) substantial -changes introduced to make markup cleaner, header 0~title type, and headings - [1-6]~ introduced, also percentage sign (%) at start of a text line as comment - -<p>marker -<p> DOCUMENT INFORMATION (METADATA) -<p> METADATA -<p> Document Manifest -@ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/sisu_manifest.html</a> -> -<p> <b>Dublin -Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. -<p> DC -Title: <i>SiSU</i> - Markup -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC Rights: <i>Copyright</i> -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -<p> DC -Type: <i>information</i> -<p> DC Date created: <i>2002-08-28</i> -<p> DC Date issued: <i>2002-08-28</i> - -<p> DC Date available: <i>2002-08-28</i> -<p> DC Date modified: <i>2007-09-16</i> -<p> DC Date: <i>2007-09-16</i> - -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_markup.sst</i> -<p> Filetype: <i>SiSU</i> text - -<p>0.58 -<p> Sourcefile Digest, MD5(sisu_markup.sst)= <i>6848f40f5844e0a7d59dbb86b3ddae92</i> - -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:14 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<ol> -<b>.</b><li>From sometime after SiSU 0.58 it should be possible to describe -SiSU markup using SiSU, which though not an original design goal is useful. -</li><b>.</b><li>files should be prepared using UTF-8 character encoding </li><b>.</b><li>a footnote or endnote -</li><b>.</b><li>self contained endnote marker & endnote in one </dd> - -<dt><b>*.</b> </dt> -<dd>unnumbered asterisk footnote/endnote, -insert multiple asterisks if required </dd> - -<dt><b>**.</b> </dt> -<dd>another unnumbered asterisk footnote/endnote -</dd> - -<dt><b>*1.</b> </dt> -<dd>editors notes, numbered asterisk footnote/endnote series </dd> - -<dt><b>+1.</b> </dt> -<dd>editors -notes, numbered asterisk footnote/endnote series </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/'>http://www.jus.uio.no/sisu/</a> -> -</li><b>.</b><li><<a href='http://www.ruby-lang.org/en/'>http://www.ruby-lang.org/en/</a> -> </li><b>.</b><li>Table from the Wealth of Networks by Yochai Benkler - <<a href='http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler'>http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler</a> -><br> - -<p> </dd> - -<dt>Other versions of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_markup/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_markup/toc.html'>http://www.jus.uio.no/sisu/sisu_markup/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:30 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_quickstart.8.html b/data/doc/sisu/html/sisu_quickstart.8.html deleted file mode 100644 index 6afe5b27..00000000 --- a/data/doc/sisu/html/sisu_quickstart.8.html +++ /dev/null @@ -1,332 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_quickstart"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - QUICKSTART, INSTALLATION AND USE, RALPH AMISSAH -<p> QUICKSTART - SISU -INSTALLATION AND USE -<p> 1. QUICKSTART - GETTING STARTED HOWTO -<p> 1.1 INSTALLATION - -<p> Installation is currently most straightforward and tested on the <b>Debian</b> -platform, as there are packages for the installation of sisu and all requirements -for what it does. -<p> 1.1.1 DEBIAN INSTALLATION -<p> <b>SiSU</b> is available directly -from the <b>Debian</b> Sid and testing archives (and possibly Ubuntu), assuming -your /etc/apt/sources.list is set accordingly: -<p> -<p> <br> -<pre> aptitude update - aptitude install sisu-complete -</pre> -<p> The following /etc/apt/sources.list setting permits the download of additional -markup samples: -<p> -<p> <br> -<pre> #/etc/apt/sources.list - deb http://ftp.fi.debian.org/debian/ unstable main non-free contrib - deb-src http://ftp.fi.debian.org/debian/ unstable main non-free contrib - d -</pre> -<p> The aptitude commands become: -<p> -<p> <br> -<pre> aptitude update - aptitude install sisu-complete sisu-markup-samples -</pre> -<p> If there are newer versions of <b>SiSU</b> upstream of the <b>Debian</b> archives, - -<p>they will be available by adding the following to your /etc/apt/sources.list - -<p> -<p> <br> -<pre> #/etc/apt/sources.list - deb http://www.jus.uio.no/sisu/archive unstable main non-free - deb-src http://www.jus.uio.no/sisu/archive unstable main non-free -</pre> -<p> repeat the aptitude commands -<p> -<p> <br> -<pre> aptitude update - aptitude install sisu-complete sisu-markup-samples -</pre> -<p> Note however that it is not necessary to install sisu-complete if not -all components of sisu are to be used. Installing just the package sisu -will provide basic functionality. -<p> 1.1.2 RPM INSTALLATION -<p> RPMs are provided -though untested, they are prepared by running alien against the source -package, and against the debs. -<p> They may be downloaded from: -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/download.html#rpm'>http://www.jus.uio.no/sisu/SiSU/download.html#rpm</a> -><br> - -<p> as root type: -<p> rpm -i [rpm package name]<br> - -<p> 1.1.3 INSTALLATION FROM SOURCE -<p> To install <b>SiSU</b> from source check information -at: -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/download.html#current'>http://www.jus.uio.no/sisu/SiSU/download.html#current</a> -><br> - -<p> * download the source package -<p> * Unpack the source -<p> Two alternative -modes of installation from source are provided, setup.rb (by Minero Aoki) -and a rant(by Stefan Lang) built install file, in either case: the first -steps are the same, download and unpack the source file: -<p> For basic use -<b>SiSU</b> is only dependent on the programming language in which it is written -<b>Ruby</b> , and <b>SiSU</b> will be able to generate html, various XMLs, including -ODF (and will also produce LaTeX). Dependencies required for further actions, -though it relies on the installation of additional dependencies which the -source tarball does not take care of, for things like using a database -(postgresql or sqlite)[^1] or converting LaTeX to pdf. -<p> <b>setup.rb</b> -<p> This is -a standard ruby installer, using setup.rb is a three step process. In the -root directory of the unpacked <b>SiSU</b> as root type: -<p> -<p> <br> -<pre> ruby setup.rb config - ruby setup.rb setup - #[and as root:] - ruby setup.rb install -</pre> -<p> further information on setup.rb is available from: -<p> <<a href='http://i.loveruby.net/en/projects/setup/'>http://i.loveruby.net/en/projects/setup/</a> -><br> - -<p> <<a href='http://i.loveruby.net/en/projects/setup/doc/usage.html'>http://i.loveruby.net/en/projects/setup/doc/usage.html</a> -><br> - -<p> <b></b> -<p> The root directory of the unpacked <b>SiSU</b> as root type: -<p> ruby install -base<br> - -<p> or for a more complete installation: -<p> ruby install<br> - -<p> or -<p> ruby install base<br> - -<p> This makes use of Rant (by Stefan Lang) and the provided Rantfile. It -has been configured to do post installation setup setup configuration and -generation of first test file. Note however, that additional external package -dependencies, such as tetex-extra are not taken care of for you. -<p> Further - -<p>information on -<p> <<a href='http://make.rubyforge.org/'>http://make.rubyforge.org/</a> -><br> - -<p> <<a href='http://rubyforge.org/frs/?group_id=615'>http://rubyforge.org/frs/?group_id=615</a> -><br> - -<p> For a list of alternative actions you may type: -<p> ruby install help<br> - -<p> ruby install -T<br> - -<p> 1.2 TESTING SISU, GENERATING OUTPUT -<p> To check which version of sisu is -installed: -<p> sisu -v -<p> Depending on your mode of installation one or a number -of markup sample files may be found either in the directory: -<p> -<p> or -<p> - -<p> change directory to the appropriate one: -<p> cd /usr/share/doc/sisu/sisu_markup_samples/dfsg - -<p> 1.2.1 BASIC TEXT, PLAINTEXT, HTML, XML, ODF -<p> Having moved to the directory -that contains the markup samples (see instructions above if necessary), - -<p>choose a file and run sisu against it -<p> sisu -NhwoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst - -<p> this will generate html including a concordance file, opendocument text -format, plaintext, XHTML and various forms of XML, and OpenDocument text - -<p> 1.2.2 LATEX / PDF -<p> Assuming a LaTeX engine such as tetex or texlive is -installed with the required modules (done automatically on selection of -sisu-pdf in <b>Debian</b> ) -<p> Having moved to the directory that contains the markup -samples (see instructions above if necessary), choose a file and run sisu - -<p>against it -<p> sisu -pv free_as_in_freedom.rms_and_free_software.sam_williams.sst - -<p> sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst -<p> should -generate most available output formats: html including a concordance file, -opendocument text format, plaintext, XHTML and various forms of XML, and - -<p>OpenDocument text and pdf -<p> 1.2.3 RELATIONAL DATABASE - POSTGRESQL, SQLITE - -<p> Relational databases need some setting up - you must have permission to -create the database and write to it when you run sisu. -<p> Assuming you have - -<p>the database installed and the requisite permissions -<p> sisu --sqlite --recreate - -<p> sisu --sqlite -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst - -<p> sisu --pgsql --recreate -<p> sisu --pgsql -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst - -<p> 1.3 GETTING HELP -<p> 1.3.1 THE MAN PAGES -<p> Type: -<p> man sisu<br> - -<p> The man pages are also available online, though not always kept as up -to date as within the package itself: -<p> * sisu.1 <<a href='http://www.jus.uio.no/sisu/man/sisu.1'>http://www.jus.uio.no/sisu/man/sisu.1</a> -> - [^2] -<p> * sisu.8 <<a href='http://www.jus.uio.no/sisu/man/sisu.8'>http://www.jus.uio.no/sisu/man/sisu.8</a> -> [^3] -<p> * man directory <<a href='http://www.jus.uio.no/sisu/man'>http://www.jus.uio.no/sisu/man</a> -> - [^4] -<p> 1.3.2 BUILT IN HELP -<p> sisu --help -<p> sisu --help --env -<p> sisu --help --commands - -<p> sisu --help --markup -<p> 1.3.3 THE HOME PAGE -<p> <<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -> -<p> <<a href='http://www.jus.uio.no/sisu/SiSU'>http://www.jus.uio.no/sisu/SiSU</a> -> - -<p> 1.4 MARKUP SAMPLES -<p> A number of markup samples (along with output) are -available off: -<p> <<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a> -> -<p> Additional markup -samples are packaged separately in the file: -<p> <b>*</b> -<p> On <b>Debian</b> they are available -in non-free[^5] to include them it is necessary to include non-free in your -/etc/apt/source.list or obtain them from the sisu home site. -<p> DOCUMENT INFORMATION -(METADATA) -<p> METADATA -<p> Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - Quickstart, installation and use -<p> DC Creator: <i>Ralph</i> - -<p>Amissah -<p> DC Rights: <i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU documentation, - -<p>License GPL 3 -<p> DC Type: <i>information</i> -<p> DC Date created: <i>2006-09-06</i> -<p> DC Date -available: <i>2006-09-06</i> -<p> DC Date issued: <i>2006-09-06</i> -<p> DC Date modified: <i>2007-09-16</i> - -<p> DC Date: <i>2007-09-16</i> -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_quickstart.sst</i> - -<p> Filetype: <i>SiSU</i> text 0.57 -<p> Sourcefile Digest, MD5(sisu_quickstart.sst)= - -<p><i>e76db98ca0d8c2bfe526dad55622fa7a</i> -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:15 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<ol> -<b>.</b><li>There is nothing to stop MySQL support being added in future. -</li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/sisu.1'>http://www.jus.uio.no/sisu/man/sisu.1</a> -> </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man/sisu.8'>http://www.jus.uio.no/sisu/man/sisu.8</a> -> </li><b>.</b><li><<a href='http://www.jus.uio.no/sisu/man'>http://www.jus.uio.no/sisu/man</a> -> -</li><b>.</b><li>the .B Debian Free Software guidelines require that everything distributed -within .B Debian can be changed - and the documents are authors’ works that -while freely distributable are not freely changeable. -<p> </dd> - -<dt>Other versions of -this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_quickstart/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_quickstart/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_quickstart/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_quickstart/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_quickstart/toc.html'>http://www.jus.uio.no/sisu/sisu_quickstart/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_quickstart/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_quickstart/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_quickstart/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_quickstart/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_quickstart/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_quickstart/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:31 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_remote.8.html b/data/doc/sisu/html/sisu_remote.8.html deleted file mode 100644 index 6d453b15..00000000 --- a/data/doc/sisu/html/sisu_remote.8.html +++ /dev/null @@ -1,189 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_remote"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - REMOTE OPERATIONS, RALPH AMISSAH -<p> SISU REMOTE OPERATIONS -<p> 1. REMOTE -SOURCE DOCUMENTS -<p> <b>SiSU</b> processing instructions can be run against remote -source documents by providing the url of the documents against which the -processing instructions are to be carried out. The remote <b>SiSU</b> documents -can either be sisu marked up files in plaintext .sst or .ssm or; zipped sisu -files, sisupod.zip or filename.ssp -<p> <b>.sst / .ssm - sisu text files</b> -<p> <b>SiSU</b> can -be run against source text files on a remote machine, provide the processing -instruction and the url. The source file and any associated parts (such -as images) will be downloaded and generated locally. -<p> -<p> <br> -<pre> sisu -3 http://[provide url to valid .sst or .ssm file] -</pre> -<p> Any of the source documents in the sisu examples page can be used in -this way, see <<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a> -> and use the url for the -desired document. -<p> NOTE: to set up a remote machine to serve <b>SiSU</b> documents -in this way, images should be in the directory relative to the document - -<p>source ../_sisu/image -<p> <b>sisupod - zipped sisu files</b> -<p> A sisupod is the zipped -content of a sisu marked up text or texts and any other associated parts -to the document such as images. -<p> <b>SiSU</b> can be run against a sisupod on a -(local or) remote machine, provide the processing instruction and the url, -the sisupod will be downloaded and the documents it contains generated -locally. -<p> -<p> <br> -<pre> sisu -3 http://[provide url to valid sisupod.zip or .ssp file] -</pre> -<p> Any of the source documents in the sisu examples page can be used in -this way, see <<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a> -> and use the url for the -desired document. -<p> REMOTE DOCUMENT OUTPUT -<p> 2. REMOTE OUTPUT -<p> Once properly -configured <b>SiSU</b> output can be automatically posted once generated to a -designated remote machine using either rsync, or scp. -<p> In order to do this -some ssh authentication agent and keychain or similar tool will need to -be configured. Once that is done the placement on a remote host can be done -seamlessly with the -r (for scp) or -R (for rsync) flag, which may be used -in conjunction with other processing flags, e.g. -<p> -<p> <br> -<pre> sisu -3R sisu_remote.sst -</pre> -<p> 2.1 COMMANDS -<p> -<dl> - -<dt><b> -R [filename/wildcard]</b> </dt> -<dd>copies sisu output files to remote -host using rsync. This requires that sisurc.yml has been provided with information -on hostname and username, and that you have your different if -R is used -with other flags from if used alone. Alone the rsync --delete parameter is -sent, useful for cleaning the remote directory (when -R is used together -with other flags, it is not). Also see -r -<p> </dd> - -<dt><b> -r [filename/wildcard]</b> </dt> -<dd>copies sisu -output files to remote host using scp. This requires that sisurc.yml has -been provided with information on hostname and username, and that you have - -<p>your -<p> </dd> -</dl> -2.2 CONFIGURATION -<p> [expand on the setting up of an ssh-agent / keychain] - -<p> 3. REMOTE SERVERS -<p> As <b>SiSU</b> is generally operated using the command line, -and works within a Unix type environment, <b>SiSU</b> the program and all documents -can just as easily be on a remote server, to which you are logged on using -a terminal, and commands and operations would be pretty much the same as -they would be on your local machine. -<p> DOCUMENT INFORMATION (METADATA) -<p> -METADATA -<p> Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - Remote Operations -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC Rights: -<i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU documentation, License GPL - -<p>3 -<p> DC Type: <i>information</i> -<p> DC Date created: <i>2002-08-28</i> -<p> DC Date issued: - -<p><i>2002-08-28</i> -<p> DC Date available: <i>2002-08-28</i> -<p> DC Date modified: <i>2007-09-16</i> -<p> DC -Date: <i>2007-09-16</i> -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_remote.sst</i> -<p> Filetype: - -<p><i>SiSU</i> text 0.58 -<p> Sourcefile Digest, MD5(sisu_remote.sst)= <i>9bdac464998dc3f034fbd8f80df23b83</i> - -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:17 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<p> -<dl> - -<dt>Other versions of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_remote/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_remote/toc.html'>http://www.jus.uio.no/sisu/sisu_remote/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:32 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_search.8.html b/data/doc/sisu/html/sisu_search.8.html deleted file mode 100644 index 64fe307b..00000000 --- a/data/doc/sisu/html/sisu_search.8.html +++ /dev/null @@ -1,512 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_search"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - SEARCH, RALPH AMISSAH -<p> SISU SEARCH -<p> 1. SISU SEARCH - INTRODUCTION - -<p> <b>SiSU</b> output can easily and conveniently be indexed by a number of standalone -indexing tools, such as Lucene, Hyperestraier. -<p> Because the document structure -of sites created is clearly defined, and the text object citation system -is available hypothetically at least, for all forms of output, it is possible -to search the sql database, and either read results from that database, -or just as simply map the results to the html output, which has richer -text markup. -<p> In addition to this <b>SiSU</b> has the ability to populate a relational -sql type database with documents at an object level, with objects numbers -that are shared across different output types, which make them searchable -with that degree of granularity. Basically, your match criteria is met by -these documents and at these locations within each document, which can -be viewed within the database directly or in various output formats. -<p> 2. -SQL -<p> 2.1 POPULATING SQL TYPE DATABASES -<p> <b>SiSU</b> feeds sisu markupd documents -into sql type databases PostgreSQL[^1] and/or SQLite[^2] database together -with information related to document structure. -<p> This is one of the more -interesting output forms, as all the structural data of the documents are -retained (though can be ignored by the user of the database should they -so choose). All site texts/documents are (currently) streamed to four tables: - -<p> * one containing semantic (and other) headers, including, title, author,<br> - subject, (the Dublin Core...);<br> - -<p> * another the substantive texts by individual<br> - along with structural information, each paragraph being identifiable -by its<br> - paragraph number (if it has one which almost all of them do), and the<br> - substantive text of each paragraph quite naturally being searchable -(both in<br> - formatted and clean text versions for searching); and<br> - -<p> * a third containing endnotes cross-referenced back to the paragraph -from<br> - which they are referenced (both in formatted and clean text versions -for<br> - searching).<br> - -<p> * a fourth table with a one to one relation with the headers table -contains<br> - full text versions of output, eg. pdf, html, xml, and ascii.<br> - -<p> There is of course the possibility to add further structures. -<p> At this -level <b>SiSU</b> loads a relational database with documents chunked into objects, -their smallest logical structurally constituent parts, as text objects, -with their object citation number and all other structural information -needed to construct the document. Text is stored (at this text object level) -with and without elementary markup tagging, the stripped version being -so as to facilitate ease of searching. -<p> Being able to search a relational -database at an object level with the <b>SiSU</b> citation system is an effective -way of locating content generated by <b>SiSU</b> object numbers, and all versions -of the document have the same numbering, complex searches can be tailored -to return just the locations of the search results relevant for all available -output formats, with live links to the precise locations in the database -or in html/xml documents; or, the structural information provided makes -it possible to search the full contents of the database and have headings -in which search content appears, or to search only headings etc. (as the -Dublin Core is incorporated it is easy to make use of that as well). -<p> 3. -POSTGRESQL -<p> 3.1 NAME -<p> <b>SiSU</b> - Structured information, Serialized Units - -a document publishing system, postgresql dependency package -<p> 3.2 DESCRIPTION - -<p> Information related to using postgresql with sisu (and related to the -sisu_postgresql dependency package, which is a dummy package to install -dependencies needed for <b>SiSU</b> to populate a postgresql database, this being -part of <b>SiSU</b> - man sisu). -<p> 3.3 SYNOPSIS -<p> sisu -D [instruction] [filename/wildcard - if required]<br> - -<p> sisu -D --pg --[instruction] [filename/wildcard if required]<br> - -<p> 3.4 COMMANDS -<p> Mappings to two databases are provided by default, postgresql -and sqlite, the same commands are used within sisu to construct and populate -databases however -d (lowercase) denotes sqlite and -D (uppercase) denotes -postgresql, alternatively --sqlite or --pgsql may be used -<p> <b>-D or --pgsql</b> may -be used interchangeably. -<p> 3.4.1 CREATE AND DESTROY DATABASE -<p> -<dl> - -<dt><b> --pgsql --createall</b> -</dt> -<dd> initial step, creates required relations (tables, indexes) in existing - (postgresql) database (a database should be created manually and given - the same name as working directory, as requested) (rb.dbi) the same name - as working directory, as -<p> </dd> - -<dt><b> sisu -D --createdb</b> </dt> -<dd> creates database where no database - existed before as -<p> </dd> - -<dt><b> sisu -D --create</b> </dt> -<dd> creates database tables where no database - tables existed before database tables where no database tables existed - -<p> </dd> - -<dt><b> sisu -D --Dropall</b> </dt> -<dd> destroys database (including all its content)! kills data -and drops tables, indexes and database associated with a given directory - (and directories of the same name). a -<p> </dd> - -<dt><b> sisu -D --recreate</b> </dt> -<dd> destroys existing - -<p> database and builds a new empty database structure -<p> </dd> -</dl> -3.4.2 IMPORT AND REMOVE - -<p>DOCUMENTS -<p> -<dl> - -<dt><b> sisu -D --import -v [filename/wildcard]</b> </dt> -<dd>populates database with -the contents of the file. Imports documents(s) specified to a postgresql -database (at an object level). -<p> </dd> - -<dt><b> sisu -D --update -v [filename/wildcard]</b> </dt> -<dd>updates - -<p>file contents in database -<p> </dd> - -<dt><b> sisu -D --remove -v [filename/wildcard]</b> </dt> -<dd>removes -specified document from postgresql database. -<p> </dd> -</dl> -4. SQLITE -<p> 4.1 NAME -<p> <b>SiSU</b> -- Structured information, Serialized Units - a document publishing system. - -<p> 4.2 DESCRIPTION -<p> Information related to using sqlite with sisu (and related -to the sisu_sqlite dependency package, which is a dummy package to install -dependencies needed for <b>SiSU</b> to populate an sqlite database, this being -part of <b>SiSU</b> - man sisu). -<p> 4.3 SYNOPSIS -<p> sisu -d [instruction] [filename/wildcard - if required]<br> - -<p> sisu -d --(sqlite|pg) --[instruction] [filename/wildcard if <br> - required]<br> - -<p> 4.4 COMMANDS -<p> Mappings to two databases are provided by default, postgresql -and sqlite, the same commands are used within sisu to construct and populate -databases however -d (lowercase) denotes sqlite and -D (uppercase) denotes -postgresql, alternatively --sqlite or --pgsql may be used -<p> <b>-d or --sqlite</b> may -be used interchangeably. -<p> 4.4.1 CREATE AND DESTROY DATABASE -<p> -<dl> - -<dt><b> --sqlite --createall</b> -</dt> -<dd> initial step, creates required relations (tables, indexes) in existing - (sqlite) database (a database should be created as requested) (rb.dbi) the - same name as working directory, as -<p> </dd> - -<dt><b> sisu -d --createdb</b> </dt> -<dd> creates database where - no database existed before as -<p> </dd> - -<dt><b> sisu -d --create</b> </dt> -<dd> creates database tables where - no database tables existed before database tables where no database tables - existed -<p> </dd> - -<dt><b> sisu -d --dropall</b> </dt> -<dd> destroys database (including all its content)! - kills data and drops tables, indexes and database associated with a given - directory (and directories of the same name). a -<p> </dd> - -<dt><b> sisu -d --recreate</b> </dt> -<dd> destroys - -<p> existing database and builds a new empty database structure -<p> </dd> -</dl> -4.4.2 IMPORT - -<p>AND REMOVE DOCUMENTS -<p> -<dl> - -<dt><b> sisu -d --import -v [filename/wildcard]</b> </dt> -<dd>populates database -with the contents of the file. Imports documents(s) specified to an sqlite -database (at an object level). -<p> </dd> - -<dt><b> sisu -d --update -v [filename/wildcard]</b> </dt> -<dd>updates - -<p>file contents in database -<p> </dd> - -<dt><b> sisu -d --remove -v [filename/wildcard]</b> </dt> -<dd>removes -specified document from sqlite database. -<p> </dd> -</dl> -5. INTRODUCTION -<p> 5.1 SEARCH - DATABASE -FRONTEND SAMPLE, UTILISING DATABASE AND SISU FEATURES, INCLUDING OBJECT -CITATION NUMBERING (BACKEND CURRENTLY POSTGRESQL) -<p> Sample search frontend -<<a href='http://search.sisudoc.org'>http://search.sisudoc.org</a> -> [^3] A small database and sample query front-end -(search from) that makes use of the citation system, <i>object</i> citation numbering -to demonstrates functionality.[^4] -<p> <b>SiSU</b> can provide information on which -documents are matched and at what locations within each document the matches -are found. These results are relevant across all outputs using object citation -numbering, which includes html, XML, LaTeX, PDF and indeed the SQL database. -You can then refer to one of the other outputs or in the SQL database expand -the text within the matched objects (paragraphs) in the documents matched. - -<p> Note you may set results either for documents matched and object number -locations within each matched document meeting the search criteria; or -display the names of the documents matched along with the objects (paragraphs) -that meet the search criteria.[^5] -<p> -<dl> - -<dt><b> sisu -F --webserv-webrick</b> </dt> -<dd> builds a cgi web - -<p> search frontend for the database created -<p> The following is feedback on -the setup on a machine provided by the help command: -<p> sisu --help sql<br> - -<p> -<p> <br> -<pre> Postgresql - user: ralph - current db set: SiSU_sisu - port: 5432 - dbi connect: DBI:Pg:database=SiSU_sisu;port=5432 - sqlite - current db set: /home/ralph/sisu_www/sisu/sisu_sqlite.db - dbi connect DBI:SQLite:/home/ralph/sisu_www/sisu/sisu_sqlite.db -</pre> -<p> Note on databases built -<p> By default, [unless otherwise specified] databases -are built on a directory basis, from collections of documents within that -directory. The name of the directory you choose to work from is used as -the database name, i.e. if you are working in a directory called /home/ralph/ebook -the database SiSU_ebook is used. [otherwise a manual mapping for the collection - is -<p> </dd> -</dl> -5.2 SEARCH FORM -<p> -<dl> - -<dt><b> sisu -F</b> </dt> -<dd> generates a sample search form, which must be - copied to which must be copied to -<p> </dd> - -<dt><b> sisu -F --webserv-webrick</b> </dt> -<dd> generates a sample - search form for use with the webrick which must be copied to the web-server - cgi directory which must be copied to the web-server cgi directory -<p> </dd> - -<dt><b> sisu - -Fv</b> </dt> -<dd> as above, and provides some information on setting up -<p> </dd> - -<dt><b> sisu -W</b> </dt> -<dd> starts - -<p> the webrick server which should be available -<p> The generated search form - -<p>must be copied manually to the webserver directory as instructed -<p> </dd> -</dl> -6. HYPERESTRAIER - -<p> See the documentation for hyperestraier: -<p> <<a href='http://hyperestraier.sourceforge.net/'>http://hyperestraier.sourceforge.net/</a> -><br> - -<p> /usr/share/doc/hyperestraier/index.html<br> - -<p> man estcmd<br> - -<p> on sisu_hyperestraier: -<p> man sisu_hyperestraier<br> - -<p> /usr/share/doc/sisu/sisu_markup/sisu_hyperestraier/index.html<br> - -<p> NOTE: the examples that follow assume that sisu output is placed in - -<p>the directory /home/ralph/sisu_www -<p> (A) to generate the index within the -webserver directory to be indexed: -<p> estcmd gather -sd [index name] [directory - path to index]<br> - -<p> the following are examples that will need to be tailored according to -your needs: -<p> cd /home/ralph/sisu_www<br> - -<p> estcmd gather -sd casket /home/ralph/sisu_www<br> - -<p> you may use the ’find’ command together with ’egrep’ to limit indexing to -particular document collection directories within the web server directory: - -<p> find /home/ralph/sisu_www -type f | egrep<br> - ’/home/ralph/sisu_www/sisu/.+?.html$’ |estcmd gather -sd casket -<br> - -<p> Check which directories in the webserver/output directory (~/sisu_www -or elsewhere depending on configuration) you wish to include in the search -index. -<p> As sisu duplicates output in multiple file formats, it it is probably -preferable to limit the estraier index to html output, and as it may also -be desirable to exclude files ’plain.txt’, ’toc.html’ and ’concordance.html’, as -these duplicate information held in other html output e.g. -<p> find /home/ralph/sisu_www --type f | egrep<br> - ’/sisu_www/(sisu|bookmarks)/.+?.html$’ | egrep -v<br> - ’(doc|concordance).html$’ |estcmd gather -sd casket -<br> - -<p> from your current document preparation/markup directory, you would construct -a rune along the following lines: -<p> find /home/ralph/sisu_www -type f -| egrep ’/home/ralph/sisu_www/([specify <br> - first directory for inclusion]|[specify second directory for <br> - inclusion]|[another directory for inclusion? ...])/.+?.html$’ |<br> - egrep -v ’(doc|concordance).html$’ |estcmd gather -sd<br> - /home/ralph/sisu_www/casket -<br> - -<p> (B) to set up the search form -<p> (i) copy estseek.cgi to your cgi directory -and set file permissions to 755: -<p> sudo cp -vi /usr/lib/estraier/estseek.cgi -/usr/lib/cgi-bin<br> - -<p> sudo chmod -v 755 /usr/lib/cgi-bin/estseek.cgi<br> - -<p> sudo cp -v /usr/share/hyperestraier/estseek.* /usr/lib/cgi-bin<br> - -<p> [see estraier documentation for paths]<br> - -<p> (ii) edit estseek.conf, with attention to the lines starting ’indexname:’ -and ’replace:’: -<p> indexname: /home/ralph/sisu_www/casket<br> - -<p> replace: ^file:///home/ralph/sisu_www{{!}}<a href='http://localhost'>http://localhost</a> -<br> - -<p> replace: /index.html?${{!}}/<br> - -<p> (C) to test using webrick, start webrick: -<p> sisu -W<br> - -<p> and try open the url: <<a href='http://localhost:8081/cgi-bin/estseek.cgi'>http://localhost:8081/cgi-bin/estseek.cgi</a> -> -<p> DOCUMENT -INFORMATION (METADATA) -<p> METADATA -<p> Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_search/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_search/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - Search -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC Rights: <i>Copyright</i> -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -<p> DC -Type: <i>information</i> -<p> DC Date created: <i>2002-08-28</i> -<p> DC Date issued: <i>2002-08-28</i> - -<p> DC Date available: <i>2002-08-28</i> -<p> DC Date modified: <i>2007-09-16</i> -<p> DC Date: <i>2007-09-16</i> - -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_search._sst</i> -<p> Filetype: <i>SiSU</i> text - -<p>insert 0.58 -<p> Sourcefile Digest, MD5(sisu_search._sst)= <i>c085c2eb6d68f1b7d50435f673ede407</i> - -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:19 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<ol> -<b>.</b><li><<a href='http://www.postgresql.org/'>http://www.postgresql.org/</a> -> <<a href='http://advocacy.postgresql.org/'>http://advocacy.postgresql.org/</a> -><br> - <<a href='http://en.wikipedia.org/wiki/Postgresql'>http://en.wikipedia.org/wiki/Postgresql</a> -><br> - </li><b>.</b><li><<a href='http://www.hwaci.com/sw/sqlite/'>http://www.hwaci.com/sw/sqlite/</a> -> <<a href='http://en.wikipedia.org/wiki/Sqlite'>http://en.wikipedia.org/wiki/Sqlite</a> -><br> - </li><b>.</b><li><<a href='http://search.sisudoc.org'>http://search.sisudoc.org</a> -> </li><b>.</b><li>(which could be extended further with current -back-end). As regards scaling of the database, it is as scalable as the database -(here Postgresql) and hardware allow. </li><b>.</b><li>of this feature when demonstrated -to an IBM software innovations evaluator in 2004 he said to paraphrase: -this could be of interest to us. We have large document management systems, -you can search hundreds of thousands of documents and we can tell you which -documents meet your search criteria, but there is no way we can tell you -without opening each document where within each your matches are found. - -<p> </dd> - -<dt>Other versions of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_search/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_search/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_search/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_search/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_search/toc.html'>http://www.jus.uio.no/sisu/sisu_search/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_search/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_search/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_search/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_search/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_search/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_search/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:32 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_skin.1.html b/data/doc/sisu/html/sisu_skin.1.html deleted file mode 100644 index 84b90fa5..00000000 --- a/data/doc/sisu/html/sisu_skin.1.html +++ /dev/null @@ -1,162 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_skin"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - SKINS, RALPH AMISSAH -<p> DOCUMENT SKINS - CONFIGURATION -<p> 1. SKINS -<p> - Skins modify the default appearance of document output on a document, -directory, or site wide basis. Skins are looked for in the following locations: - -<p> ./_sisu/skin<br> - -<p> ~/.sisu/skin<br> - -<p> /etc/sisu/skin<br> - -<p> <b>Within the skin directory</b> are the following the default sub-directories -for document skins: -<p> ./skin/doc<br> - -<p> ./skin/dir<br> - -<p> ./skin/site<br> - -<p> A skin is placed in the appropriate directory and the file named skin_[name].rb - -<p> The skin itself is a ruby file which modifies the default appearances -set in the program. -<p> 1.1 DOCUMENT SKIN -<p> Documents take on a document skin, -if the header of the document specifies a skin to be used. -<p> -<p> <br> -<pre> @skin: skin_united_nations -</pre> -<p> 1.2 DIRECTORY SKIN -<p> A directory may be mapped on to a particular skin, -so all documents within that directory take on a particular appearance. -If a skin exists in the skin/dir with the same name as the document directory, -it will automatically be used for each of the documents in that directory, -(except where a document specifies the use of another skin, in the skin/doc -directory). -<p> A personal habit is to place all skins within the doc directory, -and symbolic links as needed from the site, or dir directories as required. - -<p> 1.3 SITE SKIN -<p> A site skin, modifies the program default skin. -<p> 1.4 SAMPLE - -<p>SKINS -<p> With <b>SiSU</b> installed sample skins may be found in: -<p> /etc/sisu/skin/doc -and<br> - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc<br> - -<p> (or equivalent directory) and if sisu-markup-samples is installed also -under: -<p> /usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc<br> - -<p> Samples of list.yml and promo.yml (which are used to create the right -column list) may be found in: -<p> /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml -(or equivalent<br> - directory)<br> - -<p> DOCUMENT INFORMATION (METADATA) -<p> METADATA -<p> Document Manifest @ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - Skins -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC Rights: <i>Copyright</i> -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -<p> DC -Type: <i>information</i> -<p> DC Date created: <i>2002-11-12</i> -<p> DC Date issued: <i>2002-11-12</i> - -<p> DC Date available: <i>2002-11-12</i> -<p> DC Date modified: <i>2007-09-16</i> -<p> DC Date: <i>2007-09-16</i> - -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_skin.sst</i> -<p> Filetype: <i>SiSU</i> text - -<p>insert 0.58 -<p> Sourcefile Digest, MD5(sisu_skin.sst)= <i>8aebfb5312045c3a705ad6c314246f67</i> - -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:15 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<p> -<dl> - -<dt>Other versions of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_skin/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_skin/toc.html'>http://www.jus.uio.no/sisu/sisu_skin/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: <<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> -</dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt> -<dd></dd> - -<dt>* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated on: Mon Sep 24 -15:36:31 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/html/sisu_syntax_highlighting.8.html b/data/doc/sisu/html/sisu_syntax_highlighting.8.html deleted file mode 100644 index 3eb27e48..00000000 --- a/data/doc/sisu/html/sisu_syntax_highlighting.8.html +++ /dev/null @@ -1,219 +0,0 @@ -<!-- manual page source format generated by PolyglotMan v3.2, --> -<!-- available at http://polyglotman.sourceforge.net/ --> - -<html> -<head> -<title>"sisu_syntax_highlighting"("1") manual page</title> -</head> -<body bgcolor='white'> -<a href='#toc'>Table of Contents</a><p> -SISU - SYNTAX HIGHLIGHTING, RALPH AMISSAH -<p> SISU SYNTAX HIGHLIGHTING -<p> 1. -EDITOR FILES, SYNTAX HIGHLIGHTING -<p> The directory: -<p> ./data/sisu/conf/editor-syntax-etc/<br> - -<p> /usr/share/sisu/conf/editor-syntax-etc<br> - -<p> contains rudimentary sisu syntax highlighting files for: -<p> * (g)vim -<<a href='http://www.vim.org'>http://www.vim.org</a> -> -<p> package: sisu-vim<br> - -<p> status: largely done -<p> there is a vim syntax highlighting and folds -component<br> - -<p> * gedit <<a href='http://www.gnome.org/projects/gedit'>http://www.gnome.org/projects/gedit</a> -> -<p> * gobby <<a href='http://gobby.0x539.de/'>http://gobby.0x539.de/</a> -> - -<p> file: sisu.lang<br> - -<p> place in: -<p> /usr/share/gtksourceview-1.0/language-specs<br> - -<p> or -<p> ~/.gnome2/gtksourceview-1.0/language-specs<br> - -<p> status: very basic syntax highlighting<br> - -<p> comments: this editor features display line wrap and is used by Goby!<br> - -<p> * nano <<a href='http://www.nano-editor.org'>http://www.nano-editor.org</a> -> -<p> file: nanorc<br> - -<p> save as: -<p> ~/.nanorc<br> - -<p> status: basic syntax highlighting<br> - -<p> comments: assumes dark background; no display line-wrap; does line -breaks<br> - -<p> * diakonos (an editor written in ruby) <<a href='http://purepistos.net/diakonos'>http://purepistos.net/diakonos</a> -> - -<p> file: diakonos.conf -<p> save as: -<p> ~/.diakonos/diakonos.conf<br> - -<p> includes: -<p> status: basic syntax highlighting<br> - -<p> comments: assumes dark background; no display line-wrap -<p> * kate & kwrite -<<a href='http://kate.kde.org'>http://kate.kde.org</a> -> -<p> file: sisu.xml<br> - -<p> place in:<br> - -<p> /usr/share/apps/katepart/syntax<br> - -<p> or<br> - -<p> ~/.kde/share/apps/katepart/syntax<br> - -<p> [settings::configure kate::{highlighting,filetypes}]<br> - -<p> [tools::highlighting::{markup,scripts}::<br> - <b> SiSU</b> ] -<p> * nedit <<a href='http://www.nedit.org'>http://www.nedit.org</a> -> -<p> file: sisu_nedit.pats<br> - -<p> nedit -import sisu_nedit.pats<br> - -<p> status: a very clumsy first attempt [not really done]<br> - -<p> comments: this editor features display line wrap<br> - -<p> * emacs <<a href='http://www.gnu.org/software/emacs/emacs.html'>http://www.gnu.org/software/emacs/emacs.html</a> -> -<p> files: sisu-mode.el<br> - -<p> to file ~/.emacs add the following 2 lines:<br> - -<p> (add-to-list ’load-path<br> - -<p> (require ’sisu-mode.el)<br> - -<p> [not done / not yet included]<br> - -<p> * vim & gvim <<a href='http://www.vim.org'>http://www.vim.org</a> -> -<p> files:<br> - -<p> package is the most comprehensive sisu syntax highlighting and editor<br> - environment provided to date (is for vim/ gvim, and is separate from -the<br> - contents of this directory)<br> - -<p> status: this includes: syntax highlighting; vim folds; some error -checking<br> - -<p> comments: this editor features display line wrap<br> - -<p> NOTE: -<p> [ <b> SiSU</b> parses files with long lines or line breaks, but, display - linewrap (without line-breaks) is a convenient editor feature to have for - sisu markup] -<p> DOCUMENT INFORMATION (METADATA) -<p> METADATA -<p> Document Manifest -@ <<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/sisu_manifest.html</a> -> - -<p> <b>Dublin Core</b> (DC) -<p> <i>DC</i> tags included with this document are provided here. - -<p> DC Title: <i>SiSU</i> - Syntax Highlighting -<p> DC Creator: <i>Ralph</i> Amissah -<p> DC -Rights: <i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU documentation, License - -<p>GPL 3 -<p> DC Type: <i>information</i> -<p> DC Date created: <i>2002-11-12</i> -<p> DC Date issued: - -<p><i>2002-11-12</i> -<p> DC Date available: <i>2002-11-12</i> -<p> DC Date modified: <i>2007-09-16</i> -<p> DC -Date: <i>2007-09-16</i> -<p> <b>Version Information</b> -<p> Sourcefile: <i>sisu_syntax_highlighting.sst</i> - -<p> Filetype: <i>SiSU</i> text insert 0.58 -<p> Sourcefile Digest, MD5(sisu_syntax_highlighting.sst)= - -<p><i>28dd0275c6fcd67bbedcd8aee9df4b3e</i> -<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= - -<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i> -<p> <b>Generated</b> -<p> Document (metaverse) last -generated: <i>Mon</i> Sep 24 15:36:17 +0100 2007 -<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of -2007w38/0 (2007-09-23) -<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -<p> -<p> -<dl> - -<dt>Other versions of this document: </dt> -<dd></dd> - -<dt>manifest: <<a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_manifest.html</a> -</a> -> -</dt> -<dd></dd> - -<dt>html: <<a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/toc.html'>http://www.jus.uio.no/sisu/sisu_syntax_highlighting/toc.html</a> -</a> -> </dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_syntax_highlighting/portrait.pdf</a> -</a> -> -</dt> -<dd></dd> - -<dt>pdf: <<a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_syntax_highlighting/landscape.pdf</a> -</a> -> </dt> -<dd> </dd> - -<dt>at: -<<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> -</a> -> </dt> -<dd></dd> - -<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) -</dt> -<dd></dd> - -<dt>* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt> -<dd></dd> - -<dt>* Last Generated -on: Mon Sep 24 15:36:32 +0100 2007 </dt> -<dd></dd> - -<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> - </dt> -<dd></dd> -</dl> -<p> -</body> -</html> diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile b/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile index f62b7f5e..e9cba974 100644 --- a/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile +++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile @@ -163,7 +163,8 @@ def man_section(files_array,man_no='1') unless man_no =~/^1$/ system("mv -v #{path_man_sisu_output}/#{x} #{path_man_sisu_output}/#{y}") end - system("cp -v #{path_man_sisu_output}/#{y} #{path_man_sisu_package}/man#{man_no}/#{y}") + puts "cp -v #{path_man_sisu_output}/#{y} #{path_man_sisu_package}/man#{man_no}/#{y}" + #system("cp -v #{path_man_sisu_output}/#{y} #{path_man_sisu_package}/man#{man_no}/#{y}") end end def manpage_move diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm index 7e7a1add..50bd7dc9 100644 --- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm +++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm @@ -26,6 +26,12 @@ @skin: skin_sisu_manual +@man: 8; +name=sisu - documents: structuring, publishing in multiple formats, and search; +synopsis=sisu [-abcDdFHhIiMmNnopqRrSsTtUuVvwXxYyZz0-9] [filename/wildcard ] +sisu [-Ddcv] [instruction] +sisu [-CcFLSVvW] + @bold: /Gnu|Debian|Ruby|SiSU/ @links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/ diff --git a/lib/sisu/v0/hub.rb b/lib/sisu/v0/hub.rb index 47326b88..82ccc614 100644 --- a/lib/sisu/v0/hub.rb +++ b/lib/sisu/v0/hub.rb @@ -547,7 +547,7 @@ p "here #{__FILE__} #{__LINE__}" if @opt =~/M/ if @opt.mod.inspect =~/--help/ and not @opt.what.empty?; SiSU_Help::Help.new(@opt.what).help_request elsif @opt.mod.inspect =~/--help/; SiSU_Help::Help.new('list').help_request else SiSU_Help::Help.new('env',@opt).sisu_version - puts " for HELP type:\n\tsisu --help [help request]\n\tman sisu\n or see the system or online documentation" + tell=SiSU_Screen::Ansi.new(''," for HELP type:\n\tsisu --help [help request]\n\tman sisu\n or see the system or online documentation on SiSU:\n #{Config::CONFIG['datadir']}/doc/sisu/\n <http://www.jus.uio.no/sisu/>\n <http://sisudoc.org/>"); tell.puts_grey end end end diff --git a/lib/sisu/v0/manpage.rb b/lib/sisu/v0/manpage.rb index 5b2cef6f..768fbc48 100644 --- a/lib/sisu/v0/manpage.rb +++ b/lib/sisu/v0/manpage.rb @@ -473,7 +473,7 @@ WOK else '2007' #date missing decide on action end proj=SiSU_Env::Info_version.new.get_version - manpage[:open] = %{.TH "#{@md.fnb}" "1" "#{date}" "#{proj[:version]}" "#{@md.title}"} + manpage[:open] = %{.TH "#{@md.fnb}" "1" "#{date}" "#{proj[:version]}" "#{@md.title}"#{@md.man_name}#{@md.man_synopsis}} content << manpage[:open] content << manpage[:head] content << manpage[:body] @@ -493,6 +493,7 @@ WOK end def manpage #%manpage output SiSU_Env::SiSU_file.new(@md).mkdir + #filename_manpage=SiSU_Env::SiSU_file.new(@md,"#{@md.fnb}.#{@md.man_section}").mkfile_man filename_manpage=SiSU_Env::SiSU_file.new(@md,@md.fn[:manpage]).mkfile_man @sisu=[] @content.each do |para| # this is a hack diff --git a/lib/sisu/v0/param.rb b/lib/sisu/v0/param.rb index 446c2d46..a2036b8a 100644 --- a/lib/sisu/v0/param.rb +++ b/lib/sisu/v0/param.rb @@ -113,9 +113,11 @@ module SiSU_Param @doc={ :lv=>[] } @doc[:fns],@doc[:fnb],@doc[:scr_suffix]='','','' @@publisher='SiSU scribe' - attr_accessor :cmd,:mod,:env,:fn,:fns,:fnb,:fnn,:fnt,:fnl,:flv,:fnstex,:ocn,:sfx_src,:sfx,:pdf,:file_type,:dir_out,:dir_tex,:dir_lout,:txt_path,:site_skin,:sisu,:sisu_version,:ruby_version,:title,:dc_title,:html_title,:subtitle,:subtitle_tex,:creator_home,:dc_creator,:translator,:illustrator,:prepared_by,:digitized_by,:dc_subject,:dc_description,:dc_publisher,:dc_contributor,:dc_date,:dc_date_created,:dc_date_issued,:dc_date_available,:dc_date_valid,:dc_date_modified,:date_scheme,:date_created_scheme,:date_issued_scheme,:date_available_scheme,:date_valid_scheme,:date_modified_scheme,:dc_type,:dc_format,:dc_identifier,:dc_source,:dc_language,:language_original,:dc_relation,:dc_coverage,:dc_rights,:keywords,:comments,:abstract,:cls_loc,:cls_dewey,:cls_pg,:cls_isbn,:papersize,:toc,:lv1,:lv2,:lv3,:lv4,:lv5,:lv6,:pagenew,:pagebreak,:num_top,:toc_lev_limit,:flag_endnotes,:flag_auto_endnotes,:flag_separate_endnotes,:flag_separate_endnotes_make,:flag_auto_heading_num,:markup,:markup_instruction,:markup_version,:markup_declared,:make_bold,:make_italic,:flag_pdf,:flag_tables,:vocabulary,:doc_skin,:doc_css,:yaml,:lnk,:prefix_a,:prefix_b,:suffix,:information,:contact,:icon,:image,:ad_url,:ad_png,:ad_alt,:ad_began,:flag_promo,:promo,:ad_home,:stmp,:stmpd,:sc_filename,:sc_number,:sc_date,:sc_time,:sc_info,:yamladdr,:locale,:wc_lines,:wc_words,:wc_bytes,:file_encoding,:file_size,:user,:home,:hostname,:pwd,:firstseg,:programs,:creator_copymark,:lang,:en,:dgst,:dgst_skin,:generated,:tags,:tag_array,:concord_make,:seg_names,:seg_autoname_safe,:set_header_title,:set_heading_top,:set_heading_seg,:heading_seg_first,:heading_seg_first_flag,:base_program + attr_accessor :cmd,:mod,:env,:fn,:fns,:fnb,:fnn,:fnt,:fnl,:flv,:fnstex,:ocn,:sfx_src,:sfx,:pdf,:file_type,:dir_out,:dir_tex,:dir_lout,:txt_path,:site_skin,:sisu,:sisu_version,:ruby_version,:title,:dc_title,:html_title,:subtitle,:subtitle_tex,:creator_home,:dc_creator,:translator,:illustrator,:prepared_by,:digitized_by,:dc_subject,:dc_description,:dc_publisher,:dc_contributor,:dc_date,:dc_date_created,:dc_date_issued,:dc_date_available,:dc_date_valid,:dc_date_modified,:date_scheme,:date_created_scheme,:date_issued_scheme,:date_available_scheme,:date_valid_scheme,:date_modified_scheme,:dc_type,:dc_format,:dc_identifier,:dc_source,:dc_language,:language_original,:dc_relation,:dc_coverage,:dc_rights,:keywords,:comments,:abstract,:cls_loc,:cls_dewey,:cls_pg,:cls_isbn,:papersize,:toc,:lv1,:lv2,:lv3,:lv4,:lv5,:lv6,:pagenew,:pagebreak,:num_top,:toc_lev_limit,:flag_endnotes,:flag_auto_endnotes,:flag_separate_endnotes,:flag_separate_endnotes_make,:flag_auto_heading_num,:markup,:markup_instruction,:markup_version,:markup_declared,:make_bold,:make_italic,:flag_pdf,:flag_tables,:vocabulary,:doc_skin,:doc_css,:yaml,:lnk,:prefix_a,:prefix_b,:suffix,:information,:contact,:icon,:image,:ad_url,:ad_png,:ad_alt,:ad_began,:flag_promo,:promo,:ad_home,:stmp,:stmpd,:sc_filename,:sc_number,:sc_date,:sc_time,:sc_info,:yamladdr,:locale,:wc_lines,:wc_words,:wc_bytes,:file_encoding,:file_size,:user,:home,:hostname,:pwd,:firstseg,:programs,:creator_copymark,:lang,:en,:dgst,:dgst_skin,:generated,:tags,:tag_array,:concord_make,:seg_names,:seg_autoname_safe,:set_header_title,:set_heading_top,:set_heading_seg,:heading_seg_first,:heading_seg_first_flag,:base_program,:man_section,:man_name,:man_synopsis def initialize(fns_array,opt) - @env=@fn=@fns=@fnb=@fnn=@fnt=@fnl=@flv=@fnstex=@ocn=@sfx_src=@sfx=@pdf=@file_type=@dir_out=@dir_tex=@dir_lout=@txt_path=@flag_endnotes=@flag_auto_endnotes=@flag_separate_endnotes=@flag_separate_endnotes_make=@site_skin=@sisu=@sisu_version=@ruby_version=@title=@dc_title=@html_title=@subtitle=@subtitle_tex=@creator_home=@dc_creator=@translator=@illustrator=@prepared_by=@digitized_by=@dc_subject=@dc_description=@dc_publisher=@dc_contributor=@dc_date=@dc_date_created=@dc_date_issued=@dc_date_available=@dc_date_valid=@dc_date_modified=@date_scheme=@date_created_scheme=@date_issued_scheme=@date_available_scheme=@date_valid_scheme=@date_modified_scheme=@dc_type=@dc_format=@dc_identifier=@dc_source=@dc_language=@language_original=@dc_relation=@dc_coverage=@dc_rights=@keywords=@comments=@abstract=@cls_loc=@cls_dewey=@cls_pg=@cls_isbn=@papersize=@toc=@lv1=@lv2=@lv3=@lv4=@lv5=@lv6=@pagenew=@pagebreak=@num_top=@toc_lev_limit=@flag_auto_heading_num=@make_bold=@make_italic=@flag_pdf=@flag_tables=@vocabulary=@doc_skin=@doc_css=@yaml=@lnk=@prefix_a=@prefix_b=@suffix=@information=@contact=@icon=@ad_url=@ad_png=@ad_alt=@ad_began=@promo=@ad_home=@stmp=@stmpd=@sc_filename=@sc_number=@sc_date=@sc_time=@sc_info=@yamladdr=@locale=@wc_lines=@wc_words=@wc_bytes=@file_encoding=@file_size=@firstseg=@programs=@creator_copymark=@lang=@en=@dgst=@dgst_skin=@generated=@heading_seg_first=@base_program=nil + @env=@fn=@fns=@fnb=@fnn=@fnt=@fnl=@flv=@fnstex=@ocn=@sfx_src=@sfx=@pdf=@file_type=@dir_out=@dir_tex=@dir_lout=@txt_path=@flag_endnotes=@flag_auto_endnotes=@flag_separate_endnotes=@flag_separate_endnotes_make=@site_skin=@sisu=@sisu_version=@ruby_version=@title=@dc_title=@html_title=@subtitle=@subtitle_tex=@creator_home=@dc_creator=@translator=@illustrator=@prepared_by=@digitized_by=@dc_subject=@dc_description=@dc_publisher=@dc_contributor=@dc_date=@dc_date_created=@dc_date_issued=@dc_date_available=@dc_date_valid=@dc_date_modified=@date_scheme=@date_created_scheme=@date_issued_scheme=@date_available_scheme=@date_valid_scheme=@date_modified_scheme=@dc_type=@dc_format=@dc_identifier=@dc_source=@dc_language=@language_original=@dc_relation=@dc_coverage=@dc_rights=@keywords=@comments=@abstract=@cls_loc=@cls_dewey=@cls_pg=@cls_isbn=@papersize=@toc=@lv1=@lv2=@lv3=@lv4=@lv5=@lv6=@pagenew=@pagebreak=@num_top=@toc_lev_limit=@flag_auto_heading_num=@make_bold=@make_italic=@flag_pdf=@flag_tables=@vocabulary=@doc_skin=@doc_css=@yaml=@lnk=@prefix_a=@prefix_b=@suffix=@information=@contact=@icon=@ad_url=@ad_png=@ad_alt=@ad_began=@promo=@ad_home=@stmp=@stmpd=@sc_filename=@sc_number=@sc_date=@sc_time=@sc_info=@yamladdr=@locale=@wc_lines=@wc_words=@wc_bytes=@file_encoding=@file_size=@firstseg=@programs=@creator_copymark=@lang=@en=@dgst=@dgst_skin=@generated=@heading_seg_first=@base_program=@man_synopsis=nil + @man_section=1 + @man_name='man page "name/whatis" information not provided, set in header @man: name=[whatis information]' @data,@fns,@cmd,@mod,@opt=fns_array,opt.fns,opt.cmd,opt.mod,opt #@data used as data @flag_tables,@set_header_title,@set_heading_top,@set_heading_seg,@heading_seg_first_flag,@flag_promo=false,false,false,false,false,false @seg_autoname_safe=true @@ -235,12 +237,11 @@ module SiSU_Param tell.warn unless @cmd =~/q/ end @code_flag=false - fns_array.each do |par| #% Scan document - para=par.gsub(/\n/,' ') + fns_array.each do |para| #% Scan document if para !~/^\%+\s/ and para =~/<![abcdeghijklmnopqrstuvwxyz]/i # <!f not included raise "Old markup style in file #@fns, current version #{@sisu_version[:project]} #{@sisu_version[:version]} #{@sisu_version[:date_stamp]} #{@sisu_version[:date]}:\n\t\t#{para}\n\n" end - @code_flag=case par + @code_flag=case para when /^code\{\s*$/; true when /^\}code\s*$/; false else @code_flag @@ -364,7 +365,7 @@ module SiSU_Param when /^(?:0~comments?|@comments?:?)\s+(.+?)$/m; @comments=$1 #% metainfo DC when /^(?:0~abstract|@abstract)\s+(.+?)$/m; @abstract=$1 #% metainfo DC when /^(?:0~tags?|@tags?:)\s+\S/m #% metainfo - tags=par.match(/^(?:0~tags?|@tags?:)\s+(.+)$/m)[1] + tags=para.match(/^(?:0~tags?|@tags?:)\s+(.+)$/m)[1] tags.split(/,|$/).each do |tag| tag.strip! @tags << tag @@ -511,6 +512,14 @@ module SiSU_Param @sc_info=true if para[/(?:0~(?:rcs|cvs)|@(?:rcs|cvs):)\+/] when /^@base_program:\s+(.+?)$/; @base_program=$1 #% processing #% break - break, not necessary to process headers further :-) but necessary to extract endnotes etc. ;-( + when /^(?:0~man|@man:)\s+(.+?)\Z/m #% man pages + maninfo_str=$1 + maninfo=maninfo_str.split(/;\s*/m) + maninfo.each do |x| + @man_section= x[/^([1-8])/] if x =~/^([1-8])/ + @man_name= x[/name=(.+)/,1] if x =~/name=.+/ + @man_synopsis= x[/synopsis=(.+)/m,1] if x =~/synopsis=.+/ + end end @lv1 ||=/^1~/ @lv2 ||=/^2~/ @@ -583,6 +592,14 @@ module SiSU_Param end end end #% here endeth the document loop + @man_name.gsub!(/(-)/,"\\\\\\1") + @man_name.gsub!(/\n/,"\n.BR\n") + @man_name.gsub!(/\A/,"\n.SH NAME\n") + unless @man_synopsis.nil? + @man_synopsis.gsub!(/(-)/,"\\\\\\1") + @man_synopsis.gsub!(/\n/,"\n.BR\n") + @man_synopsis.gsub!(/\A/,"\n.SH SYNOPSIS\n") + end unless @dc_rights if @dc_creator @dc_rights ||=if @dc_date =~/([12][890]\d{2})/ #matches years 1800 through 20\d\d 2004w19 diff --git a/man/man1/sisu_commands.1 b/man/man1/sisu_commands.1 deleted file mode 100644 index ca60efc6..00000000 --- a/man/man1/sisu_commands.1 +++ /dev/null @@ -1,575 +0,0 @@ -.TH "sisu_commands" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- COMMANDS, -RALPH AMISSAH -.BR - -.SH -SISU COMMANDS -.BR - -.SH -1. COMMANDS SUMMARY -.BR - -.SH -1.1 SYNOPSIS - -.BR -.B SiSU -\- Structured information, Serialized Units \- a document publishing system - -.BR -sisu \ [ \ \-abcDdFHhIiMmNnopqRrSsTtUuVvwXxYyZz0\-9 \ ] \ [ \ filename/ \ -wildcard \ ] - -.BR -sisu \ [ \ \-Ddcv \ ] \ [ \ instruction \ ] - -.BR -sisu \ [ \ \-CcFLSVvW \ ] - -.BR -Note: commands should be issued from within the directory that contains the -marked up files, cd to markup directory. - -.SH -1.2 DESCRIPTION - -.BR -.B SiSU -.B SiSU -is a document publishing system, that from a simple single marked\-up -document, produces multiple of output formats including: plaintext, html, -LaTeX, pdf, xhtml, XML, info, and SQL (PostgreSQL and SQLite), which share -numbered text objects (\"object citation numbering\") and the same document -structure information. For more see: <http://www.jus.uio.no/sisu> - -.SH -1.3 DOCUMENT PROCESSING COMMAND FLAGS - -.TP -.B \ \-a \ \ [filename/wildcard] -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 \ -endnotes]. (Options include: \-\-endnotes for endnotes \-\-footnotes for -footnotes at the end of each paragraph \-\-unix for unix linefeed (default) -\-\-msdos for msdos linefeed) - -.TP -.B \ \-b \ \ [filename/wildcard] -produces xhtml/XML output for browser viewing (sax parsing). - -.TP -.B \ \-C \ \ [\-\-init\-site] -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. - -.TP -.B \ \-CC -\ 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. \ - -.TP -.B \ \-c \ \ [filename/wildcard] -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). - -.TP -.B \ \-D \ \ [instruction] \ [filename] -database postgresql ( \-\-pgsql may be used instead) possible instructions, -include: \-\-createdb; \-\-create; \-\-dropall; \-\-import \ [filename]; -\-\-update \ [filename]; \-\-remove \ [filename]; see database section below. - -.TP -.B \ \-d \ \ [\-\-db\-[database \ type \ (sqlite|pg)]] \-\-[instruction] \ -[filename] -database type default set to sqlite, (for which \-\-sqlite may be used -instead) or to specify another database \-\-db\-[pgsql, \ sqlite] (however see -\-D) possible instructions include: \-\-createdb; \-\-create; \-\-dropall; -\-\-import \ [filename]; \-\-update \ [filename]; \-\-remove \ [filename]; see -database section below. - -.TP -.B \ \-F \ \ [\-\-webserv=webrick] -generate examples of (naive) cgi search form for sqlite and pgsql depends on -your already having used sisu to populate an sqlite and/or pgsql database, (the -sqlite version scans the output directories for existing sisu_sqlite databases, -so it is first necessary to create them, before generating the search form) see -\-d \-D and the database section below. If the optional parameter -\-\-webserv=webrick is passed, the cgi examples created will be set up to use -the default port set for use by the webrick server, (otherwise the port is left -blank and the system setting used, usually 80). The samples are dumped in the -present work directory which must be writable, (with screen instructions given -that they be copied to the cgi\-bin directory). \-Fv (in addition to the above) -provides some information on setting up hyperestraier for sisu - -.TP -.B \ \-H \ \ [filename/wildcard] -produces html without link suffixes (.html \.pdf etc.) (\"Hide\"). Requires -an appropriately configured web server. \ [behaviour \ switched \ after \ 0.35 -\ see \ \-h]. - -.TP -.B \ \-h \ \ [filename/wildcard] -produces html (with hardlinks i.e. with name suffixes in links/local urls). -html, with internal document links that include the document suffix, i.e. -whether it is \.html or \.pdf (required for browsing directly off a file -system, and works with most web servers). \ [behaviour \ switched \ after \ -0.35 \ see \ \-H]. - -.TP -.B \ \-I \ \ [filename/wildcard] -produces texinfo and info file, (view with pinfo). - -.TP -.B \ \-L -\ prints \ license \ information. \ - -.TP -.B \ \-M \ \ [filename/wildcard/url] -maintenance mode files created for processing preserved and their locations -indicated. (also see \-V) - -.TP -.B \ \-m \ \ [filename/wildcard/url] -assumed for most other flags, creates new meta\-markup file, (the metaverse ) -that is used in all subsequent processing of other output. This step is assumed -for most processing flags. To skip it see \-n - -.TP -.B \ \-N \ \ [filename/wildcard/url] -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. - -.TP -.B \ \-n \ \ [filename/wildcard/url] -skip meta\-markup (building of \"metaverse\"), this skips the equivalent of -\-m which is otherwise assumed by most processing flags. - -.TP -.B \ \-o \ \ [filename/wildcard/url] -output basic document in opendocument file format (opendocument.odt). - -.TP -.B \ \-p \ \ [filename/wildcard] -produces LaTeX pdf (portrait.pdf & landscape.pdf). Default paper size is set -in config file, or document header, or provided with additional command line -parameter, e.g. \-\-papersize\-a4 preset sizes include: \'A4\', U.S. \'letter\' -and \'legal\' and book sizes \'A5\' and \'B5\' (system defaults to A4). - -.TP -.B \ \-q \ \ [filename/wildcard] -quiet less output to screen. - -.TP -.B \ \-R \ \ [filename/wildcard] -copies sisu output files to remote host using rsync. This requires that -sisurc.yml has been provided with information on hostname and username, and -that you have your \"keys\" and ssh agent in place. Note the behavior of rsync -different if \-R is used with other flags from if used alone. Alone the rsync -\-\-delete parameter is sent, useful for cleaning the remote directory (when -\-R is used together with other flags, it is not). Also see \-r - -.TP -.B \ \-r \ \ [filename/wildcard] -copies sisu output files to remote host using scp. This requires that -sisurc.yml has been provided with information on hostname and username, and -that you have your \"keys\" and ssh agent in place. Also see \-R - -.TP -.B \ \-S -\ produces \ a \ sisupod \ a \ zipped \ sisu \ directory \ of \ markup \ -files \ including \ sisu \ markup \ source \ files \ and \ the \ directories \ -local \ configuration \ file, \ images \ and \ skins. \ Note: \ this \ only \ -includes \ the \ configuration \ files \ or \ skins \ contained \ in \ \./_sisu -\ not \ those \ in \ ~/.sisu \ \-S \ \ [filename/wildcard] option. Note: (this -option is tested only with zsh). - -.TP -.B \ \-S \ \ [filename/wildcard] -produces a zipped file of the prepared document specified along with -associated images, by default named sisupod.zip they may alternatively be named -with the filename extension \.ssp This provides a quick way of gathering the -relevant parts of a sisu document which can then for example be emailed. A -sisupod includes sisu markup source file, (along with associated documents if a -master file, or available in multilingual versions), together with related -images and skin. -.B SiSU -commands can be run directly against a sisupod contained in a local -directory, or provided as a url on a remote site. As there is a security issue -with skins provided by other users, they are not applied unless the flag -\-\-trust or \-\-trusted is added to the command instruction, it is recommended -that file that are not your own are treated as untrusted. The directory -structure of the unzipped file is understood by sisu, and sisu commands can be -run within it. Note: if you wish to send multiple files, it quickly becomes -more space efficient to zip the sisu markup directory, rather than the -individual files for sending). See the \-S option without \ -[filename/wildcard]. - -.TP -.B \ \-s \ \ [filename/wildcard] -copies sisu markup file to output directory. - -.TP -.B \ \-t \ \ [filename/wildcard \ (*.termsheet.rb)] -standard form document builder, preprocessing feature - -.TP -.B \ \-U \ \ [filename/wildcard] -prints url output list/map for the available processing flags options and -resulting files that could be requested, (can be used to get a list of -processing options in relation to a file, together with information on the -output that would be produced), \-u provides url output mapping for those flags -requested for processing. The default assumes sisu_webrick is running and -provides webrick url mappings where appropriate, but these can be switched to -file system paths in sisurc.yml - -.TP -.B \ \-u \ \ [filename/wildcard] -provides url mapping of output files for the flags requested for processing, -also see \-U - -.TP -.B \ \-V -\ on \ its \ own, \ provides -.B \ SiSU -\ version \ and \ environment \ information \ (sisu \ \-\-help \ env) \ - -.TP -.B \ \-V \ \ [filename/wildcard] -even more verbose than the \-v flag. (also see \-M) - -.TP -.B \ \-v -\ on \ its \ own, \ provides -.B \ SiSU -\ version \ information \ - -.TP -.B \ \-v \ \ [filename/wildcard] -provides verbose output of what is being built, where it is being built (and -error messages if any), as with \-u flag provides a url mapping of files -created for each of the processing flag requests. See also \-V - -.TP -.B \ \-W -\ starts \ ruby\'s \ webrick \ webserver \ points \ at \ sisu \ output \ -directories, \ the \ default \ port \ is \ set \ to \ 8081 \ and \ can \ be \ -changed \ in \ the \ resource \ configuration \ files. \ \ [tip: \ the \ -webrick \ server \ requires \ link \ suffixes, \ so \ html \ output \ should \ -be \ created \ using \ the \ \-h \ option \ rather \ than \ \-H; \ also, \ note -\ \-F \ webrick \ ]. - -.TP -.B \ \-w \ \ [filename/wildcard] -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) - -.TP -.B \ \-X \ \ [filename/wildcard] -produces XML output with deep document structure, in the nature of dom. - -.TP -.B \ \-x \ \ [filename/wildcard] -produces XML output shallow structure (sax parsing). - -.TP -.B \ \-Y \ \ [filename/wildcard] -produces a short sitemap entry for the document, based on html output and the -sisu_manifest. \-\-sitemaps generates/updates the sitemap index of existing -sitemaps. (Experimental, \ [g,y,m \ announcement \ this \ week]) - -.TP -.B \ \-y \ \ [filename/wildcard] -produces an html summary of output generated (hyperlinked to content) and -document specific metadata (sisu_manifest.html). This step is assumed for most -processing flags. - -.TP -.B \ \-Z \ \ [filename/wildcard] -Zap, if used with other processing flags deletes output files of the type -about to be processed, prior to processing. If \-Z is used as the lone -processing related flag (or in conjunction with a combination of \-[mMvVq]), -will remove the related document output directory. - -.TP -.B \ \-z \ \ [filename/wildcard] -produces php (zend) \ [this \ feature \ is \ disabled \ for \ the \ time \ -being] - -.SH -2. COMMAND LINE MODIFIERS -.BR - -.TP -.B \ \-\-no\-ocn -\ \ [with \ \-h \ \-H \ or \ \-p] switches off object citation numbering. -Produce output without identifying numbers in margins of html or LaTeX/pdf -output. - -.TP -.B \ \-\-no\-annotate -\ strips \ output \ text \ of \ editor \ endnotes[^*1] denoted by asterisk or -dagger/plus sign - -.TP -.B \ \-\-no\-asterisk -\ strips \ output \ text \ of \ editor \ endnotes[^*2] denoted by asterisk -sign - -.TP -.B \ \-\-no\-dagger -\ strips \ output \ text \ of \ editor \ endnotes[^+1] denoted by dagger/plus -sign - -.SH -3. DATABASE COMMANDS -.BR - -.BR -dbi \- database interface - -.BR -\-D or \-\-pgsql set for postgresql \-d or \-\-sqlite default set for sqlite -\-d is modifiable with \-\-db=[database \ type \ (pgsql \ or \ sqlite)] - -.TP -.B \ \-Dv \ \-\-createall -\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in -\ existing \ postgresql \ database \ (a \ database \ should \ be \ created \ -manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \ -requested) \ (rb.dbi) \ \ [ \ \-dv \ \-\-createall \ sqlite \ equivalent] it -may be necessary to run sisu \-Dv \-\-createdb initially NOTE: at the present -time for postgresql it may be necessary to manually create the database. The -command would be \'createdb \ [database \ name]\' where database name would be -SiSU_[present \ working \ directory \ name \ (without \ path)]. Please use only -alphanumerics and underscores. - -.TP -.B \ \-Dv \ \-\-import -\ \ [filename/wildcard] imports data specified to postgresql db (rb.dbi) \ [ -\ \-dv \ \-\-import \ sqlite \ equivalent] - -.TP -.B \ \-Dv \ \-\-update -\ \ [filename/wildcard] updates/imports specified data to postgresql db -(rb.dbi) \ [ \ \-dv \ \-\-update \ sqlite \ equivalent] - -.TP -.B \ \-D \ \-\-remove -\ \ [filename/wildcard] removes specified data to postgresql db (rb.dbi) \ [ -\ \-d \ \-\-remove \ sqlite \ equivalent] - -.TP -.B \ \-D \ \-\-dropall -\ kills \ data\" \ and \ drops \ (postgresql \ or \ sqlite) \ db, \ tables \ -& \ indexes \ \ [ \ \-d \ \-\-dropall \ sqlite \ equivalent] - -.BR -The v in e.g. \-Dv is for verbose output. - -.SH -4. SHORTCUTS, SHORTHAND FOR MULTIPLE FLAGS -.BR - -.TP -.B \ \-\-update \ \ [filename/wildcard] -Checks existing file output and runs the flags required to update this -output. This means that if only html and pdf output was requested on previous -runs, only the \-hp files will be applied, and only these will be generated -this time, together with the summary. This can be very convenient, if you offer -different outputs of different files, and just want to do the same again. - -.TP -.B \ \-0 \ to \ \-5 \ \ [filename \ or \ wildcard] -Default shorthand mappings (note that the defaults can be changed/configured -in the sisurc.yml file): - -.TP -.B \ \-0 -\ \-mNhwpAobxXyYv \ \ [this \ is \ the \ default \ action \ run \ when \ no \ -options \ are \ give, \ i.e. \ on \ \'sisu \ \ [filename]\'] - -.TP -.B \ \-1 -\ \-mNHwpy \ - -.TP -.B \ \-2 -\ \-mNHwpaoy \ - -.TP -.B \ \-3 -\ \-mNhwpAobxXyY \ - -.TP -.B \ \-4 -\ \-mNhwpAobxXDyY \ \-\-import \ - -.TP -.B \ \-5 -\ \-mNhwpAobxXDyY \ \-\-update \ - -.BR -add \-v for verbose mode and \-c for color, e.g. sisu \-2vc \ [filename \ or \ -wildcard] - -.BR -consider \-u for appended url info or \-v for verbose output - -.SH -4.0.1 COMMAND LINE WITH FLAGS \- BATCH PROCESSING - -.BR -In the data directory run sisu \-mh filename or wildcard eg. \"sisu \-h -cisg.sst\" or \"sisu \-h *.{sst,ssm}\" to produce html version of all -documents. - -.BR -Running sisu (alone without any flags, filenames or wildcards) brings up the -interactive help, as does any sisu command that is not recognised. Enter to -escape. - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Commands - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_commands.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_commands.sst)= -.I 68a4087f984baffbea779da25e1b6141 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:43 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI *1. -square brackets -.TP -.BI *2. -square brackets -.TP -.BI +1. -square brackets - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_commands/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_commands/sisu_commands.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:50 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man1/sisu_configuration.1 b/man/man1/sisu_configuration.1 deleted file mode 100644 index 98c8c8c0..00000000 --- a/man/man1/sisu_configuration.1 +++ /dev/null @@ -1,368 +0,0 @@ -.TH "sisu_configuration" "1" "2007-08-30" "0.59.1" "SiSU" -.SH -SISU \- CONFIGURATION, -RALPH AMISSAH -.BR - -.SH -CONFIGURATION OF ENVIRONMENT -.BR - -.SH -1. CONFIGURATION -.BR - -.SH -1.1 DETERMINING THE CURRENT CONFIGURATION - -.BR -Information on the current configuration of -.B SiSU -should be available with the help command: - -.BR - sisu \-v - -.BR -which is an alias for: - -.BR - sisu \-\-help env - -.BR -Either of these should be executed from within a directory that contains sisu -markup source documents. - -.SH -1.2 CONFIGURATION FILES (CONFIG.YML) - -.BR -.B SiSU -configration parameters are adjusted in the configuration file, which can be -used to override the defaults set. This includes such things as which directory -interim processing should be done in and where the generated output should be -placed. - -.BR -The -.B SiSU -configuration file is a yaml file, which means indentation is significant. - -.BR -.B SiSU -resource configuration is determined by looking at the following files if -they exist: - -.BR - \./_sisu/sisurc.yml - -.BR - ~/.sisu/sisurc.yml - -.BR - /etc/sisu/sisurc.yml - -.BR -The search is in the order listed, and the first one found is used. - -.BR -In the absence of instructions in any of these it falls back to the internal -program defaults. - -.BR -Configuration determines the output and processing directories and the database -access details. - -.BR -If -.B SiSU -is installed a sample sisurc.yml may be found in /etc/sisu/sisurc.yml - -.SH -CONFIGURATION OF DOCUMENTS -.BR - -.SH -2. SKINS -.BR - -.BR -Skins modify the default appearance of document output on a document, -directory, or site wide basis. Skins are looked for in the following locations: - -.BR - \./_sisu/skin - -.BR - ~/.sisu/skin - -.BR - /etc/sisu/skin - -.BR -.B Within the skin directory -are the following the default sub\-directories for document skins: - -.BR - \./skin/doc - -.BR - \./skin/dir - -.BR - \./skin/site - -.BR -A skin is placed in the appropriate directory and the file named skin_[name].rb - -.BR -The skin itself is a ruby file which modifies the default appearances set in -the program. - -.SH -2.1 DOCUMENT SKIN - -.BR -Documents take on a document skin, if the header of the document specifies a -skin to be used. - - -.nf - @skin: skin_united_nations -.fi - -.SH -2.2 DIRECTORY SKIN - -.BR -A directory may be mapped on to a particular skin, so all documents within that -directory take on a particular appearance. If a skin exists in the skin/dir -with the same name as the document directory, it will automatically be used for -each of the documents in that directory, (except where a document specifies the -use of another skin, in the skin/doc directory). - -.BR -A personal habit is to place all skins within the doc directory, and symbolic -links as needed from the site, or dir directories as required. - -.SH -2.3 SITE SKIN - -.BR -A site skin, modifies the program default skin. - -.SH -2.4 SAMPLE SKINS - -.BR -With -.B SiSU -installed sample skins may be found in: - -.BR - /etc/sisu/skin/doc and - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc - -.BR -(or equivalent directory) and if sisu\-markup\-samples is installed also under: - -.BR - /usr/share/doc/sisu/sisu_markup_samples/non\-free/_sisu/skin/doc - -.BR -Samples of list.yml and promo.yml (which are used to create the right column -list) may be found in: - -.BR - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent - directory) - -.SH -3. HOMEPAGES -.BR - -.BR -.B SiSU -is about the ability to auto\-generate documents. Home pages are regarded as -custom built items, and are not created by -.B SiSU -. More accurately, -.B SiSU -has a default home page, which will not be appropriate for use with other -sites, and the means to provide your own home page instead in one of two ways -as part of a site\'s configuration, these being: - -.BR -1. through placing your home page and other custom built documents in the -subdirectory _sisu/home/ (this probably being the easier and more convenient -option) - -.BR -2. through providing what you want as the home page in a skin, - -.BR -Document sets are contained in directories, usually organised by site or -subject. Each directory can/should have its own homepage. See the section on -directory structure and organisation of content. - -.SH -3.1 HOME PAGE AND OTHER CUSTOM BUILT PAGES IN A SUB\-DIRECTORY - -.BR -Custom built pages, including the home page index.html may be placed within the -configuration directory _sisu/home/ in any of the locations that is searched -for the configuration directory, namely \./_sisu; ~/_sisu; /etc/sisu From there -they are copied to the root of the output directory with the command: - -.BR - sisu \-CC - -.SH -3.2 HOME PAGE WITHIN A SKIN - -.BR -Skins are described in a separate section, but basically are a file written in -the programming language -.B Ruby -that may be provided to change the defaults that are provided with sisu with -respect to individual documents, a directories contents or for a site. - -.BR -If you wish to provide a homepage within a skin the skin should be in the -directory _sisu/skin/dir and have the name of the directory for which it is to -become the home page. Documents in the directory commercial_law would have the -homepage modified in skin_commercial law.rb; or the directory poems in -skin_poems.rb - - -.nf - class Home - def homepage - # place the html content of your homepage here, this will become index.html - <<HOME <html> - <head></head> - <doc> - <p>this is my new homepage.</p> - </doc> - </html> - HOME - end - end -.fi - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Configuration - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Ralph Amissah - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2007\-08\-28 - -.BR -DC Date modified: -.I 2007\-08\-30 - -.BR -DC Date: -.I 2007\-08\-30 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_configuration._sst - -.BR -Filetype: -.I SiSU text insert 0.58 - -.BR -Sourcefile Digest, MD5(sisu_configuration._sst)= -.I 491d3da039162d60ae0e2951aa260915 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:46 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_configuration/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_configuration/sisu_configuration.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:51 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man1/sisu_help.1 b/man/man1/sisu_help.1 deleted file mode 100644 index 95331031..00000000 --- a/man/man1/sisu_help.1 +++ /dev/null @@ -1,318 +0,0 @@ -.TH "sisu_help" "1" "2007-08-30" "0.59.1" "SiSU" -.SH -SISU \- HELP, -RALPH AMISSAH -.BR - -.SH -SISU HELP -.BR - -.SH -1. HELP -.BR - -.SH -1.1 SISU MANUAL - -.BR -The most up to date information on sisu should be contained in the sisu_manual, -available at: - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/> - -.BR -and (from -.B SiSU -0.59 onwards) installed locally at: - -.BR - /usr/share/doc/sisu/sisu_manual/ - -.BR -or equivalent directory - -.BR -Within the -.B SiSU -tarball at: - -.BR - \./data/doc/sisu/sisu_manual/ - -.SH -1.2 SISU MAN PAGES - -.BR -If -.B SiSU -is installed on your system usual man commands should be available, try: - -.BR - man sisu - -.BR - man sisu_markup - -.BR - man sisu_commands - -.BR -Most -.B SiSU -man pages are generated directly from sisu documents that are used to prepare -the sisu manual, the sources files for which are located within the -.B SiSU -tarball at: - -.BR - \./data/doc/sisu/sisu_manual/ - -.BR -Once installed, directory equivalent to: - -.BR - /usr/share/doc/sisu/sisu_manual/ - -.BR -Available man pages are converted back to html using man2html: - -.BR - /usr/share/doc/sisu/html/ - -.BR - \./data/doc/sisu/html/ - -.BR -The -.B SiSU -man pages can be viewed online at:[^1] - -.BR -An online version of the sisu man page is available here: - -.BR -* various sisu man pages <http://www.jus.uio.no/sisu/man/> \ [^2] - -.BR -* sisu.1 <http://www.jus.uio.no/sisu/man/sisu.1.html> \ [^3] - -.BR -* sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8.html> \ [^4] - -.BR -* sisu_examples.1 <http://www.jus.uio.no/sisu/man/sisu_examples.1.html> \ [^5] - -.BR -* sisu_webrick.1 <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> \ [^6] - -.SH -1.3 SISU BUILT\-IN INTERACTIVE HELP - -.BR -This is particularly useful when current installation information is obtained -as the interactive help is able to provide information on your sisu -configuration and setup. - -.BR - sisu \-\-help - -.BR - sisu \-\-help \ [subject] - -.BR - sisu \-\-help env \ [for \ feedback \ on \ the \ way \ your \ system \ is \ - setup \ with \ regard \ to \ sisu] - -.BR - sisu \-V \ [same \ as \ above \ command] - -.BR - sisu \-\-help commands - -.BR - sisu \-\-help markup - -.BR -Apart from real\-time information on your current configuration the -.B SiSU -manual and man pages are likely to contain more up\-to\-date information than -the sisu interactive help (for example on commands and markup). - -.BR -NOTE: Running the command sisu (alone without any flags, filenames or -wildcards) brings up the interactive help, as does any sisu command that is not -recognised. Enter to escape. - -.SH -1.4 HELP SOURCES - -.BR -For lists of alternative help sources, see: - -.BR -.B man page - -.BR - man sisu_help_sources - -.BR -.B man2html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html - -.BR -.B sisu generated html - -.BR - /usr/share/doc/sisu/html/sisu_help_sources/index.html - -.BR - <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html> - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_help/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Help - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-08\-30 - -.BR -DC Date: -.I 2007\-08\-30 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_help.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_help.sst)= -.I 66d04ba5f3dd4ede774ffa5549b3faba - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:42 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI 1. -generated from source using rman - <http://polyglotman.sourceforge.net/rman.html> - With regard to -.B SiSU -man pages the formatting generated for markup syntax is not quite right, for -that you might prefer the links under: - <http://www.jus.uio.no/sample> -.TP -.BI 2. -<http://www.jus.uio.no/sisu/man/> -.TP -.BI 3. -<http://www.jus.uio.no/sisu/man/sisu.1.html> -.TP -.BI 4. -<http://www.jus.uio.no/sisu/man/sisu.8.html> -.TP -.BI 5. -<http://www.jus.uio.no/sisu/man/sisu_examples.1.html> -.TP -.BI 6. -<http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_help/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_help/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_help/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_help/sisu_help.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:50 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man1/sisu_help_sources.1 b/man/man1/sisu_help_sources.1 deleted file mode 100644 index 2b907a23..00000000 --- a/man/man1/sisu_help_sources.1 +++ /dev/null @@ -1,729 +0,0 @@ -.TH "sisu_help_sources" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- REFERENCES, -RALPH AMISSAH -.BR - -.SH -SISU HELP SOURCES -.BR - -.SH -1. HELP SOURCES -.BR - -.BR -For a summary of alternative ways to get help on -.B SiSU -try one of the following: - -.BR -.B man page - -.BR - man sisu_help - -.BR -.B man2html - -.BR - <file:///usr/share/doc/sisu/html/sisu_help.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_help.1.html> - -.BR -.B sisu generated output \- links to html - -.BR - <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_help/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html> - -.BR -.B help sources lists - -.BR -Alternative sources for this help sources page listed here: - -.BR - man sisu_help_sources - -.BR - <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html> - -.BR - <file:///usr/share/doc/sisu/html/sisu_help_sources/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html> - -.SH -1.1 MAN PAGES - -.SH -1.1.1 MAN - -.BR - man sisu - -.BR - man sisu_commands - -.BR - man 7 sisu_complete - -.BR - man sisu_configuration - -.BR - man 8 sisu_faq - -.BR - man sisu_filetypes - -.BR - man sisu_help - -.BR - man sisu_help_sources - -.BR - man 8 sisu_howto - -.BR - man sisu_introduction - -.BR - man sisu_markup - -.BR - man sisu_output_overview - -.BR - man 7 sisu_pdf - -.BR - man 7 sisu_postgresql - -.BR - man 8 sisu_quickstart - -.BR - man 8 sisu_remote - -.BR - man 8 sisu_search - -.BR - man sisu_skin - -.BR - man 7 sisu_sqlite - -.BR - man 8 sisu_syntax_highlighting - -.BR - man 7 sisu_vim - -.BR - man sisu_webrick - -.SH -1.2 SISU GENERATED OUTPUT \- LINKS TO HTML - -.BR -Note -.B SiSU -documentation is prepared in -.B SiSU -and output is available in multiple formats including amongst others html, -pdf, and odf which may be also be accessed via the html pages[^1] - -.SH -1.2.1 LOCALLY INSTALLED - -.BR -<file:///usr/share/doc/sisu/sisu_manual/sisu_manual/index.html> - -.BR -<file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html> - -.BR -<file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html> - -.BR - /usr/share/doc/sisu/sisu_manual/sisu/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_commands/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_configuration/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_description/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_examples/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_faq/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_filetypes/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_help/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_howto/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_introduction/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_manual/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_markup/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_output_overview/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_pdf/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_postgresql/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_quickstart/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_remote/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_search/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_skin/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_vim/index.html - -.BR - /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html - -.SH -1.2.2 WWW.SISUDOC.ORG - -.BR -<http://sisudoc.org/sisu_manual/sisu_manual/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_commands/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_complete/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_configuration/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_description/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_examples/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_faq/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_filetypes/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_help/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_howto/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_introduction/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_manual/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_markup/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_output_overview/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_pdf/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_postgresql/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_quickstart/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_remote/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_search/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_skin/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_sqlite/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_vim/index.html> - -.BR - <http://sisudoc.org/sisu_manual/sisu_webrick/index.html> - -.SH -1.2.3 WWW.JUS.UIO.NO/SISU - -.BR -<http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html> - -.BR - <http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html> - -.SH -1.2.4 MAN2HTML - -.SH -1.2.5 LOCALLY INSTALLED - -.BR -<file:///usr/share/doc/sisu/html/sisu_manual.1.html> - -.BR -<file:///usr/share/doc/sisu/html/sisu_help.1.html> - -.BR -<file:///usr/share/doc/sisu/html/sisu_help_sources.1.html> - -.BR - /usr/share/doc/sisu/html/sisu.1.html - -.BR - /usr/share/doc/sisu/html/sisu_commands.1.html - -.BR - /usr/share/doc/sisu/html/sisu_complete.7.html - -.BR - /usr/share/doc/sisu/html/sisu_configuration.1.html - -.BR - /usr/share/doc/sisu/html/sisu_faq.8.html - -.BR - /usr/share/doc/sisu/html/sisu_help.1.html - -.BR - /usr/share/doc/sisu/html/sisu_help_sources.1.html - -.BR - /usr/share/doc/sisu/html/sisu_howto.8.html - -.BR - /usr/share/doc/sisu/html/sisu_markup.1.html - -.BR - /usr/share/doc/sisu/html/sisu_pdf.7.html - -.BR - /usr/share/doc/sisu/html/sisu_postgresql.7.html - -.BR - /usr/share/doc/sisu/html/sisu_quickstart.8.html - -.BR - /usr/share/doc/sisu/html/sisu_remote.8.html - -.BR - /usr/share/doc/sisu/html/sisu_search.8.html - -.BR - /usr/share/doc/sisu/html/sisu_skin.1.html - -.BR - /usr/share/doc/sisu/html/sisu_sqlite.7.html - -.BR - /usr/share/doc/sisu/html/sisu_syntax_highlighting.8.html - -.BR - /usr/share/doc/sisu/html/sisu_vim.7.html - -.BR - /usr/share/doc/sisu/html/sisu_webrick.1.html - -.SH -1.2.6 WWW.SISUDOC.ORG - -.BR -<http:///sisudoc.org/man/sisu_manual.1.html> - -.BR -<http:///sisudoc.org/man/sisu_help.1.html> - -.BR -<http:///sisudoc.org/man/sisu_help_sources.1.html> - -.BR - <http://sisudoc.org/man/sisu.1.html> - -.BR - <http://sisudoc.org/man/sisu_commands.1.html> - -.BR - <http://sisudoc.org/man/sisu_complete.7.html> - -.BR - <http://sisudoc.org/man/sisu_configuration.1.html> - -.BR - <http://sisudoc.org/man/sisu_faq.8.html> - -.BR - <http://sisudoc.org/man/sisu_help.1.html> - -.BR - <http://sisudoc.org/man/sisu_help_sources.1.html> - -.BR - <http://sisudoc.org/man/sisu_howto.8.html> - -.BR - <http://sisudoc.org/man/sisu_markup.1.html> - -.BR - <http://sisudoc.org/man/sisu_pdf.7.html> - -.BR - <http://sisudoc.org/man/sisu_postgresql.7.html> - -.BR - <http://sisudoc.org/man/sisu_quickstart.8.html> - -.BR - <http://sisudoc.org/man/sisu_remote.8.html> - -.BR - <http://sisudoc.org/man/sisu_search.8.html> - -.BR - <http://sisudoc.org/man/sisu_skin.1.html> - -.BR - <http://sisudoc.org/man/sisu_sqlite.7.html> - -.BR - <http://sisudoc.org/man/sisu_syntax_highlighting.8.html> - -.BR - <http://sisudoc.org/man/sisu_vim.7.html> - -.BR - <http://sisudoc.org/man/sisu_webrick.1.html> - -.SH -1.2.7 WWW.JUS.UIO.NO/SISU - -.BR -<http://www.jus.uio.no/sisu/man/sisu_manual.1.html> - -.BR -<http://www.jus.uio.no/sisu/man/sisu_help.1.html> - -.BR -<http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_commands.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_complete.7.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_configuration.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_faq.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_help.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_howto.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_markup.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_pdf.7.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_remote.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_search.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_skin.1.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_vim.7.html> - -.BR - <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- References - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-11\-12 - -.BR -DC Date issued: -.I 2002\-11\-12 - -.BR -DC Date available: -.I 2002\-11\-12 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_help_sources.sst - -.BR -Filetype: -.I SiSU text insert 0.58 - -.BR -Sourcefile Digest, MD5(sisu_help_sources.sst)= -.I ff6812b3008391d7a20d777bbbeb3ec1 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:42 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI 1. -named index.html or more extensively through sisu_manifest.html - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_help_sources/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_help_sources/sisu_help_sources.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:50 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man1/sisu_markup.1 b/man/man1/sisu_markup.1 deleted file mode 100644 index d8e58032..00000000 --- a/man/man1/sisu_markup.1 +++ /dev/null @@ -1,1532 +0,0 @@ -.TH "sisu_markup" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- MARKUP, -RALPH AMISSAH -.BR - -.SH -SISU MARKUP -.BR - -.SH -1. INTRODUCTION TO SISU MARKUP[^1] -.BR - -.SH -1.1 SUMMARY - -.BR -.B SiSU -source documents are plaintext (UTF\-8)[^2] files - -.BR -All paragraphs are separated by an empty line. - -.BR -Markup is comprised of: - -.BR -* at the top of a document, the document header made up of semantic meta\-data -about the document and if desired additional processing instructions (such an -instruction to automatically number headings from a particular level down) - -.BR -* followed by the prepared substantive text of which the most important single -characteristic is the markup of different heading levels, which define the -primary outline of the document structure. Markup of substantive text includes: - -.BR - * heading levels defines document structure - -.BR - * text basic attributes, italics, bold etc. - -.BR - * grouped text (objects), which are to be treated differently, such as code - blocks or poems. - -.BR - * footnotes/endnotes - -.BR - * linked text and images - -.BR - * paragraph actions, such as indent, bulleted, numbered\-lists, etc. - -.BR -Some interactive help on markup is available, by typing sisu and selecting -markup or sisu \-\-help markup - -.SH -1.2 MARKUP EXAMPLES - -.SH -1.2.1 ONLINE - -.BR -Online markup examples are available together with the respective outputs -produced from <http://www.jus.uio.no/sisu/SiSU/2.html> or from -<http://www.jus.uio.no/sisu/sisu_examples/> - -.BR -There is of course this document, which provides a cursory overview of sisu -markup and the respective output produced: -<http://www.jus.uio.no/sisu/sisu_markup/> - -.BR -Some example marked up files are available as html with syntax highlighting for -viewing: <http://www.jus.uio.no/sisu/sample/syntax> - -.BR -an alternative presentation of markup syntax: -<http://www.jus.uio.no/sisu/sample/on_markup.txt> - -.SH -1.2.2 INSTALLED - -.BR -With -.B SiSU -installed sample skins may be found in: -/usr/share/doc/sisu/sisu_markup_samples/dfsg (or equivalent directory) and if -sisu\-markup\-samples is installed also under: -/usr/share/doc/sisu/sisu_markup_samples/non\-free - -.SH -2. MARKUP OF HEADERS -.BR - -.BR -Headers consist of semantic meta\-data about a document, which can be used by -any output module of the program; and may in addition include extra processing -instructions. - -.BR -Note: the first line of a document may include information on the markup -version used in the form of a comment. Comments are a percentage mark at the -start of a paragraph (and as the first character in a line of text) followed by -a space and the comment: - - -.nf - % this would be a comment -.fi - -.SH -2.1 SAMPLE HEADER - -.BR -This current document has a header similar to this one (without the comments): - - -.nf - % SiSU 0.57 - @title: SiSU - @subtitle: Markup - @creator: Ralph Amissah - @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 - @type: information - @subject: ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search - @date.created: 2002\-08\-28 - @date.issued: 2002\-08\-28 - @date.available: 2002\-08\-28 - @date.modified: 2007\-09\-16 - @date: 2007\-09\-16 - @level: new=C; break=1; num_top=1 - % comment: in this @level header num_top=1 starts automatic heading numbering at heading level 1 (numbering continues 3 levels down); the new and break instructions are used by the LaTeX/pdf and odf output to determine where to put page breaks (that are not used by html output or say sql database population). - @skin: skin_sisu_manual - % skins modify the appearance of a document and are placed in a sub\-directory under \./_sisu/skin ~/.sisu/skin or /etc/sisu/skin. A skin may affect single documents that request them, all documents in a directory, or be site\-wide. (A document is affected by a single skin) - @bold: /Gnu|Debian|Ruby|SiSU/ - @links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/ - { Book Samples and Markup Examples }http://www.jus.uio.no/sisu/SiSU/2.html - { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU - { SiSU @ Freshmeat }http://freshmeat.net/projects/sisu/ - { SiSU @ Ruby Application Archive }http://raa.ruby\-lang.org/project/sisu/ - { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html - { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html - { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html -.fi - -.SH -2.2 AVAILABLE HEADERS - -.BR -Header tags appear at the beginning of a document and provide meta information -on the document (such as the Dublin Core), or information as to how the -document as a whole is to be processed. All header instructions take either the -form @headername: or 0~headername. All Dublin Core meta tags are available - -.BR -.B @indentifier: -information or instructions - -.BR -where the \"identifier\" is a tag recognised by the program, and the -\"information\" or \"instructions\" belong to the tag/indentifier specified - -.BR -Note: a header where used should only be used once; all headers apart from -@title: are optional; the @structure: header is used to describe document -structure, and can be useful to know. - -.BR -This is a sample header - -.BR -.B % SiSU 0.38 -\ [declared \ file\-type \ identifier \ with \ markup \ version] - -.BR -.B @title: -\ [title \ text] This is the title of the document and used as such, this -header is the only one that is -.I mandatory - -.BR -.B @subtitle: -The Subtitle if any - -.BR -.B @creator: -\ [or \ @author:] Name of Author - -.BR -.B @subject: -(whatever your subject) - -.BR -.B @description: - -.BR -.B @publisher: - -.BR -.B @contributor: - -.BR -.B @translator: -\ [or \ @translated_by:] - -.BR -.B @illustrator: -\ [or \ @illustrated_by:] - -.BR -.B @prepared_by: -\ [or \ @digitized_by:] - -.BR -.B @date: 2000\-08\-27 -\ [ \ also \ @date.created: \ @date.issued: \ @date.available: \ @date.valid: -\ @date.modified: \ ] - -.BR -.B @type: article - -.BR -.B @format: - -.BR -.B @identifier: - -.BR -.B @source: - -.BR -.B @language: -\ [or \ @language.document:] \ [country \ code \ for \ language \ if \ -available, \ or \ language, \ English, \ en \ is \ the \ default \ setting] (en -\- English, fr \- French, de \- German, it \- Italian, es \- Spanish, pt \- -Portuguese, sv \- Swedish, da \- Danish, fi \- Finnish, no \- Norwegian, is \- -Icelandic, nl \- Dutch, et \- Estonian, hu \- Hungarian, pl \- Polish, ro \- -Romanian, ru \- Russian, el \- Greek, uk \- Ukranian, tr \- Turkish, sk \- -Slovak, sl \- Slovenian, hr \- Croatian, cs \- Czech, bg \- Bul garian ) \ -[however, \ encodings \ are \ not \ available \ for \ all \ of \ the \ -languages \ listed.] - -.BR -[@language.original: \ original \ language \ in \ which \ the \ work \ was \ -published] - -.BR -.B @papersize: -(A4|US_letter|book_B5|book_A5|US_legal) - -.BR -.B @relation: - -.BR -.B @coverage: - -.BR -.B @rights: -Copyright (c) Name of Right Holder, all rights reserved, or as granted: -public domain, copyleft, creative commons variant, etc. - -.BR -.B @owner: - -.BR -.B @keywords: -text document generation processing management latex pdf structured xml -citation \ [your \ keywords \ here, \ used \ for \ example \ by \ rss \ feeds, -\ and \ in \ sql \ searches] - -.BR -.B @abstract: -\ [paper \ abstract, \ placed \ after \ table \ of \ contents] - -.BR -.B @comment: -\ [...] - -.BR -.B @catalogue: -loc=[Library \ of \ Congress \ classification]; dewey=[Dewey \ -classification]; isbn=[ISBN]; pg=[Project \ Gutenberg \ text \ number] - -.BR -.B @classify_loc: -\ [Library \ of \ Congress \ classification] - -.BR -.B @classify_dewey: -\ [Dewey \ classification] - -.BR -.B @classify_isbn: -\ [ISBN] - -.BR -.B @classify_pg: -\ [Project \ Gutenberg \ text \ number] - -.BR -.B @prefix: -\ [prefix \ is \ placed \ just \ after \ table \ of \ contents] - -.BR -.B @prefix_a: -\ [prefix \ is \ placed \ just \ before \ table \ of \ contents \ \- \ not \ -implemented] - -.BR -.B @prefix_b: - -.BR -.B @rcs: -$Id: sisu_markup.sst,v 1.2 2007/09/08 17:12:47 ralph Exp $ \ [used \ by \ rcs -\ or \ cvs \ to \ embed \ version \ (revision \ control) \ information \ into \ -document, \ rcs \ or \ cvs \ can \ usefully \ provide \ a \ history \ of \ -updates \ to \ a \ document \ ] - -.BR -.B @structure: -PART; CHAPTER; SECTION; ARTICLE; none; none; -optional, document structure can be defined by words to match or regular -expression (the regular expression is assumed to start at the beginning of a -line of text i.e. ^) default markers :A~ to :C~ and 1~ to 6~ can be used within -text instead, without this header tag, and may be used to supplement the -instructions provided in this header tag if provided (@structure: is a synonym -for @toc:) - -.BR -.B @level: -newpage=3; breakpage=4 -\ [paragraph \ level, \ used \ by \ latex \ to \ breakpages, \ the \ page \ -is \ optional \ eg. \ in \ newpage] - -.BR -.B @markup: -information on the markup used, e.g. new=1,2,3; break=4; num_top=4 \ [or \ -newpage=1,2,3; \ breakpage=4; \ num_top=4] newpage and breakpage, heading -level, used by LaTeX to breakpages. breakpage: starts on a new page in single -column text and on a new column in double column text; newpage: starts on a new -page for both single and double column texts. -num_top=4 \ [auto\-number \ document, \ starting \ at \ level \ 4. \ the \ -default \ is \ to \ provide \ 3 \ levels, \ as \ in \ 1 \ level \ 4, \ 1.1 \ -level \ 5, \ 1.1.1 \ level \ 6, \ markup \ to \ be \ merged \ within \ level] -num_extract \ [take \ numbering \ of \ headings \ provided \ (manually \ in \ -marked \ up \ source \ document), \ and \ use \ for \ numbering \ of \ -segments. \ Available \ where \ a \ clear \ numbering \ structure \ is \ -provided \ within \ document, \ without \ the \ repetition \ of \ a \ number \ -in \ a \ header.] \ [In \ 0.38 \ notation, \ you \ would \ map \ to \ the \ -equivalent \ levels, \ the \ examples \ provided \ would \ map \ to \ the \ -following \ new=A,B,C; \ break=1; \ num_top=1 \ \ [or \ newpage=A,B,C; \ -breakpage=1; \ num_top=1] see headings] - -.BR -.B @bold: -\ [regular \ expression \ of \ words/phrases \ to \ be \ made \ bold] - -.BR -.B @italics: -\ [regular \ expression \ of \ words/phrases \ to \ italicise] - -.BR -.B @vocabulary: -name of taxonomy/vocabulary/wordlist to use against document - -.BR -.B @skin: -skin_doc_[name_of_desired_document_skin] -skins change default settings related to the appearance of documents -generated, such as the urls of the home site, and the icon/logo for the -document or site. - -.BR -.B @links: -{ -.B SiSU -}http://www.jus.uio.no/sisu/; -{ FSF }http://www.fsf.org - -.BR -.B @promo: -sisu, ruby, search_libre_docs, open_society -\ [places \ content \ in \ right \ pane \ in \ html, \ makes \ use \ of \ -list.yml \ and \ promo.yml, \ commented \ out \ sample \ in \ document \ -sample: \ -free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst] - -.SH -3. MARKUP OF SUBSTANTIVE TEXT -.BR - -.SH -3.1 HEADING LEVELS - -.BR -Heading levels are :A~ ,:B~ ,:C~ ,1~ ,2~ ,3~ \... :A \- :C being part / section -headings, followed by other heading levels, and 1 \-6 being headings followed -by substantive text or sub\-headings. :A~ usually the title :A~? conditional -level 1 heading (used where a stand\-alone document may be imported into -another) - -.BR -.B :A~ \ [heading \ text] -Top level heading \ [this \ usually \ has \ similar \ content \ to \ the \ -title \ @title: \ ] NOTE: the heading levels described here are in 0.38 -notation, see heading - -.BR -.B :B~ \ [heading \ text] -Second level heading \ [this \ is \ a \ heading \ level \ divider] - -.BR -.B :C~ \ [heading \ text] -Third level heading \ [this \ is \ a \ heading \ level \ divider] - -.BR -.B 1~ \ [heading \ text] -Top level heading preceding substantive text of document or sub\-heading 2, -the heading level that would normally be marked 1. or 2. or 3. etc. in a -document, and the level on which sisu by default would break html output into -named segments, names are provided automatically if none are given (a number), -otherwise takes the form 1~my_filename_for_this_segment - -.BR -.B 2~ \ [heading \ text] -Second level heading preceding substantive text of document or sub\-heading -3, the heading level that would normally be marked 1.1 or 1.2 or 1.3 or 2.1 -etc. in a document. - -.BR -.B 3~ \ [heading \ text] -Third level heading preceding substantive text of document, that would -normally be marked 1.1.1 or 1.1.2 or 1.2.1 or 2.1.1 etc. in a document - - -.nf - 1~filename level 1 heading, - % the primary division such as Chapter that is followed by substantive text, and may be further subdivided (this is the level on which by default html segments are made) -.fi - -.SH -3.2 FONT ATTRIBUTES - -.BR -.B markup example: - - -.nf - normal text !{emphasis}! *{bold text}* _{underscore}_ /{italics}/ \"{citation}\" ^{superscript}^ ,{subscript}, +{inserted text}+ - normal text - !{emphasis}! - *{bold text}* - _{underscore} - /{italics}/ - \"{citation}\" - ^{superscript}^ - ,{subscript}, - +{inserted text}+ - \-{strikethrough}\- -.fi - -.BR -.B resulting output: - -.BR -normal text <em>emphasis</em> -.B bold text -.I underscore -.I italics -<cite>citation</cite> ^superscript^ \ [subscript] <ins>inserted text</ins> -<del>strikethrough</del> - -.BR -normal text - -.BR -<em>emphasis</em> - -.BR -.B bold text - -.BR -.I underscore - -.BR -.I italics - -.BR -<cite>citation</cite> - -.BR -^superscript^ - -.BR -[subscript] - -.BR -<ins>inserted text</ins> - -.BR -<del>strikethrough</del> - -.SH -3.3 INDENTATION AND BULLETS - -.BR -.B markup example: - - -.nf - ordinary paragraph - _1 indent paragraph one step - _2 indent paragraph two steps - _9 indent paragraph nine steps -.fi - -.BR -.B resulting output: - -.BR -ordinary paragraph - -.BR - indent paragraph one step - -.BR - indent paragraph two steps - -.BR - indent paragraph nine steps - -.BR -.B markup example: - - -.nf - * bullet text - _1* bullet text, first indent - _2* bullet text, two step indent -.fi - -.BR -.B resulting output: - -.BR -* bullet text - -.BR - * bullet text, first indent - -.BR - * bullet text, two step indent - -.BR -Numbered List (not to be confused with headings/titles, (document structure)) - -.BR -.B markup example: - - -.nf - # numbered list numbered list 1., 2., 3, etc. - _# numbered list numbered list indented a., b., c., d., etc. -.fi - -.SH -3.4 FOOTNOTES / ENDNOTES - -.BR -Footnotes and endnotes not distinguished in markup. They are automatically -numbered. Depending on the output file format (html, odf, pdf etc.), the -document output selected will have either footnotes or endnotes. - -.BR -.B markup example: - - -.nf - ~{ a footnote or endnote }~ -.fi - -.BR -.B resulting output: - -.BR -[^3] - -.BR -.B markup example: - - -.nf - normal text~{ self contained endnote marker & endnote in one }~ continues -.fi - -.BR -.B resulting output: - -.BR -normal text[^4] continues - -.BR -.B markup example: - - -.nf - normal text ~{* unnumbered asterisk footnote/endnote, insert multiple asterisks if required }~ continues - normal text ~{** another unnumbered asterisk footnote/endnote }~ continues -.fi - -.BR -.B resulting output: - -.BR -normal text \ [^*] continues - -.BR -normal text \ [^**] continues - -.BR -.B markup example: - - -.nf - normal text ~[* \ editors \ notes, \ numbered \ asterisk \ footnote/endnote \ series \ ]~ continues - normal text ~[+ \ editors \ notes, \ numbered \ asterisk \ footnote/endnote \ series \ ]~ continues -.fi - -.BR -.B resulting output: - -.BR -normal text \ [^*1] continues - -.BR -normal text \ [^+1] continues - -.BR -.B Alternative endnote pair notation for footnotes/endnotes: - - -.nf -.nf - % note the endnote marker \"~^\" - normal text~^ continues - ^~ endnote text following the paragraph in which the marker occurs -.fi - -.BR -the standard and pair notation cannot be mixed in the same document - -.SH -3.5 LINKS - -.SH -3.5.1 NAKED URLS WITHIN TEXT, DEALING WITH URLS - -.BR -urls are found within text and marked up automatically. A url within text is -automatically hyperlinked to itself and by default decorated with angled -braces, unless they are contained within a code block (in which case they are -passed as normal text), or escaped by a preceding underscore (in which case the -decoration is omitted). - -.BR -.B markup example: - - -.nf - normal text http://www.jus.uio.no/sisu continues -.fi - -.BR -.B resulting output: - -.BR -normal text <http://www.jus.uio.no/sisu> continues - -.BR -An escaped url without decoration - -.BR -.B markup example: - - -.nf - normal text http://www.jus.uio.no/sisu continues - deb http://www.jus.uio.no/sisu/archive unstable main non\-free -.fi - -.BR -.B resulting output: - -.BR -normal text http://www.jus.uio.no/sisu continues - -.BR -deb http://www.jus.uio.no/sisu/archive unstable main non\-free - -.BR -where a code block is used there is neither decoration nor hyperlinking, code -blocks are discussed later in this document - -.BR -.B resulting output: - - -.nf - deb http://www.jus.uio.no/sisu/archive unstable main non\-free - deb\-src http://www.jus.uio.no/sisu/archive unstable main non\-free -.fi - -.BR -To link text or an image to a url the markup is as follows - -.BR -.B markup example: - - -.nf - about { SiSU }http://url.org markup -.fi - -.SH -3.5.2 LINKING TEXT - -.BR -.B resulting output: - -.BR -about SiSU <http://www.jus.uio.no/sisu/> markup - -.BR -A shortcut notation is available so the url link may also be provided -automatically as a footnote - -.BR -.B markup example: - - -.nf - about {~^ SiSU }http://url.org markup -.fi - -.BR -.B resulting output: - -.BR -about SiSU <http://www.jus.uio.no/sisu/> \ [^5] markup - -.SH -3.5.3 LINKING IMAGES - -.BR -.B markup example: - - -.nf - [ tux.png ] - % various url linked images - [ tux.png ] - [ GnuDebianLinuxRubyBetterWay.png ] - {~^ ruby_logo.png \"Ruby\" }http://www.ruby\-lang.org/en/ -.fi - -.BR -.B resulting output: - -.BR -[ tux.png ] - -.BR -tux.png 64x80 \"Gnu/Linux \- a better way\" <http://www.jus.uio.no/sisu/> - -.BR -[ \ ruby_logo \ (png \ missing) \ ] \ [^6] - -.BR -GnuDebianLinuxRubyBetterWay.png 100x101 \"Way Better \- with Gnu/Linux, Debian -and Ruby\" <http://www.jus.uio.no/sisu/> - -.BR -.B linked url footnote shortcut - - -.nf - {~^ \ [text \ to \ link] }http://url.org - % maps to: { \ [text \ to \ link] }http://url.org ~{ http://url.org }~ - % which produces hyper\-linked text within a document/paragraph, with an endnote providing the url for the text location used in the hyperlink -.fi - - -.nf - text marker *~name -.fi - -.BR -note at a heading level the same is automatically achieved by providing names -to headings 1, 2 and 3 i.e. 2~[name] and 3~[name] or in the case of -auto\-heading numbering, without further intervention. - -.SH -3.6 GROUPED TEXT - -.SH -3.6.1 TABLES - -.BR -Tables may be prepared in two either of two forms - -.BR -.B markup example: - - -.nf - table{ c3; 40; 30; 30; - This is a table - this would become column two of row one - column three of row one is here - And here begins another row - column two of row two - column three of row two, and so on - }table -.fi - -.BR -.B resulting output: - - \ [table \ omitted, \ see \ other \ document \ formats] - -.BR -a second form may be easier to work with in cases where there is not much -information in each column - -.BR -.B markup example: -[^7] - - -.nf - !_ Table 3.1: Contributors to Wikipedia, January 2001 \- June 2005 - {table~h 24; 12; 12; 12; 12; 12; 12;} - |Jan. 2001|Jan. 2002|Jan. 2003|Jan. 2004|July 2004|June 2006 - Contributors* | 10| 472| 2,188| 9,653| 25,011| 48,721 - Active contributors** | 9| 212| 846| 3,228| 8,442| 16,945 - Very active contributors*** | 0| 31| 190| 692| 1,639| 3,016 - No. of English language articles| 25| 16,000| 101,000| 190,000| 320,000| 630,000 - No. of articles, all languages | 25| 19,000| 138,000| 490,000| 862,000|1,600,000 - \\* Contributed at least ten times; \\** at least 5 times in last month; \\*\** more than 100 times in last month. -.fi - -.BR -.B resulting output: - -.BR -.B Table 3.1: Contributors to Wikipedia, January 2001 \- June 2005 - - \ [table \ omitted, \ see \ other \ document \ formats] - -.BR -* Contributed at least ten times; ** at least 5 times in last month; *** more -than 100 times in last month. - -.SH -3.6.2 POEM - -.BR -.B basic markup: - - -.nf - poem{ - Your poem here - }poem - Each verse in a poem is given a separate object number. -.fi - -.BR -.B markup example: - - -.nf - poem{ - \'Fury said to a - mouse, That he - met in the - house, - \"Let us - both go to - law: I will - prosecute - YOU. \-\-Come, - I\'ll take no - denial; We - must have a - trial: For - really this - morning I\'ve - nothing - to do.\" - Said the - mouse to the - cur, \"Such - a trial, - dear Sir, - With - no jury - or judge, - would be - wasting - our - breath.\" - \"I\'ll be - judge, I\'ll - be jury,\" - Said - cunning - old Fury: - \"I\'ll - try the - whole - cause, - and - condemn - you - to - death.\"\' - }poem -.fi - -.BR -.B resulting output: - - - \'Fury said to a -.P - mouse, That he -.P - met in the -.P - house, -.P - \"Let us -.P - both go to -.P - law: I will -.P - prosecute -.P - YOU. \-\-Come, -.P - I\'ll take no -.P - denial; We -.P - must have a -.P - trial: For -.P - really this -.P - morning I\'ve -.P - nothing -.P - to do.\" -.P - Said the -.P - mouse to the -.P - cur, \"Such -.P - a trial, -.P - dear Sir, -.P - With -.P - no jury -.P - or judge, -.P - would be -.P - wasting -.P - our -.P - breath.\" -.P - \"I\'ll be -.P - judge, I\'ll -.P - be jury,\" -.P - Said -.P - cunning -.P - old Fury: -.P - \"I\'ll -.P - try the -.P - whole -.P - cause, -.P - and -.P - condemn -.P - you -.P - to -.P - death.\"\' -.P - -.SH -3.6.3 GROUP - -.BR -.B basic markup: - - -.nf - group{ - Your grouped text here - }group - A group is treated as an object and given a single object number. -.fi - -.BR -.B markup example: - - -.nf - group{ - \'Fury said to a - mouse, That he - met in the - house, - \"Let us - both go to - law: I will - prosecute - YOU. \-\-Come, - I\'ll take no - denial; We - must have a - trial: For - really this - morning I\'ve - nothing - to do.\" - Said the - mouse to the - cur, \"Such - a trial, - dear Sir, - With - no jury - or judge, - would be - wasting - our - breath.\" - \"I\'ll be - judge, I\'ll - be jury,\" - Said - cunning - old Fury: - \"I\'ll - try the - whole - cause, - and - condemn - you - to - death.\"\' - }group -.fi - -.BR -.B resulting output: - - - \'Fury said to a -.P - mouse, That he -.P - met in the -.P - house, -.P - \"Let us -.P - both go to -.P - law: I will -.P - prosecute -.P - YOU. \-\-Come, -.P - I\'ll take no -.P - denial; We -.P - must have a -.P - trial: For -.P - really this -.P - morning I\'ve -.P - nothing -.P - to do.\" -.P - Said the -.P - mouse to the -.P - cur, \"Such -.P - a trial, -.P - dear Sir, -.P - With -.P - no jury -.P - or judge, -.P - would be -.P - wasting -.P - our -.P - breath.\" -.P - \"I\'ll be -.P - judge, I\'ll -.P - be jury,\" -.P - Said -.P - cunning -.P - old Fury: -.P - \"I\'ll -.P - try the -.P - whole -.P - cause, -.P - and -.P - condemn -.P - you -.P - to -.P - death.\"\' -.P - -.SH -3.6.4 CODE - -.BR -Code tags are used to escape regular sisu markup, and have been used -extensively within this document to provide examples of -.B SiSU -markup. You cannot however use code tags to escape code tags. They are -however used in the same way as group or poem tags. - -.BR -A code\-block is treated as an object and given a single object number. \ [an \ -option \ to \ number \ each \ line \ of \ code \ may \ be \ considered \ at \ -some \ later \ time] - -.BR -.B use of code tags instead of poem compared, resulting output: - - -.nf - \'Fury said to a - mouse, That he - met in the - house, - \"Let us - both go to - law: I will - prosecute - YOU. \-\-Come, - I\'ll take no - denial; We - must have a - trial: For - really this - morning I\'ve - nothing - to do.\" - Said the - mouse to the - cur, \"Such - a trial, - dear Sir, - With - no jury - or judge, - would be - wasting - our - breath.\" - \"I\'ll be - judge, I\'ll - be jury,\" - Said - cunning - old Fury: - \"I\'ll - try the - whole - cause, - and - condemn - you - to - death.\"\' -.fi - -.SH -4. COMPOSITE DOCUMENTS MARKUP -.BR - -.BR -It is possible to build a document by creating a master document that requires -other documents. The documents required may be complete documents that could be -generated independently, or they could be markup snippets, prepared so as to be -easily available to be placed within another text. If the calling document is a -master document (built from other documents), it should be named with the -suffix -.B \.ssm -Within this document you would provide information on the other documents -that should be included within the text. These may be other documents that -would be processed in a regular way, or markup bits prepared only for inclusion -within a master document -.B \.sst -regular markup file, or -.B \.ssi -(insert/information) A secondary file of the composite document is built -prior to processing with the same prefix and the suffix -.B \._sst - -.BR -basic markup for importing a document into a master document - - -.nf - << |filename1.sst|@|^| - << |filename2.ssi|@|^| -.fi - -.BR -The form described above should be relied on. Within the Vim editor it results -in the text thus linked becoming hyperlinked to the document it is calling in -which is convenient for editing. Alternative markup for importation of -documents under consideration, and occasionally supported have been. - - -.nf - r{filename} - {filename.ssi}require - << {filename.ssi} - % using textlink alternatives - |filename.ssi|@|^|require - << |filename.ssi|@|^| - % using thlnk alternatives - <url:filename.ssi>require - << <url:filename.ssi> -.fi - -.SH -MARKUP SYNTAX HISTORY -.BR - -.SH -5. NOTES RELATED TO FILES\-TYPES AND MARKUP SYNTAX -.BR - -.BR -0.38 is substantially current, depreciated 0.16 supported, though file names -were changed at 0.37 - -.BR -.B 0.52 -(2007w14/6) declared document type identifier at start of text/document: - -.BR - .B SiSU -0.52 - -.BR -or, backward compatible using the comment marker: - -.BR - % -.B SiSU -0.38 - -.BR -variations include \' -.B SiSU -(text|master|insert) \ [version]\' and \'sisu\-[version]\' - -.BR -.B 0.51 -(2007w13/6) skins changed (simplified), markup unchanged - -.BR -.B 0.42 -(2006w27/4) * (asterisk) type endnotes, used e.g. in relation to author - -.BR -.B 0.38 -(2006w15/7) introduced new/alternative notation for headers, e.g. @title: -(instead of 0~title), and accompanying document structure markup, -:A,:B,:C,1,2,3 (maps to previous 1,2,3,4,5,6) - -.BR -.B 0.37 -(2006w09/7) introduced new file naming convention, \.sst (text), \.ssm -(master), \.ssi (insert), markup syntax unchanged - -.BR -.B 0.35 -(2005w52/3) sisupod, zipped content file introduced - -.BR -.B 0.23 -(2005w36/2) utf\-8 for markup file - -.BR -.B 0.22 -(2005w35/3) image dimensions may be omitted if rmagick is available to be -relied upon - -.BR -.B 0.20.4 -(2005w33/4) header 0~links - -.BR -.B 0.16 -(2005w25/2) substantial changes introduced to make markup cleaner, header -0~title type, and headings \ [1\-6]~ introduced, also percentage sign (%) at -start of a text line as comment marker - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Markup - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_markup.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_markup.sst)= -.I 6848f40f5844e0a7d59dbb86b3ddae92 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:43 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI 1. -From sometime after SiSU 0.58 it should be possible to describe SiSU markup -using SiSU, which though not an original design goal is useful. -.TP -.BI 2. -files should be prepared using UTF-8 character encoding -.TP -.BI 3. -a footnote or endnote -.TP -.BI 4. -self contained endnote marker & endnote in one -.TP -.BI *. -unnumbered asterisk footnote/endnote, insert multiple asterisks if required -.TP -.BI **. -another unnumbered asterisk footnote/endnote -.TP -.BI *1. -editors notes, numbered asterisk footnote/endnote series -.TP -.BI +1. -editors notes, numbered asterisk footnote/endnote series -.TP -.BI 5. -<http://www.jus.uio.no/sisu/> -.TP -.BI 6. -<http://www.ruby-lang.org/en/> -.TP -.BI 7. -Table from the Wealth of Networks by Yochai Benkler - <http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler> - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_markup/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_markup/sisu_markup.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:50 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man1/sisu_skin.1 b/man/man1/sisu_skin.1 deleted file mode 100644 index 20f337d8..00000000 --- a/man/man1/sisu_skin.1 +++ /dev/null @@ -1,222 +0,0 @@ -.TH "sisu_skin" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- SKINS, -RALPH AMISSAH -.BR - -.SH -DOCUMENT SKINS \- CONFIGURATION -.BR - -.SH -1. SKINS -.BR - -.BR -Skins modify the default appearance of document output on a document, -directory, or site wide basis. Skins are looked for in the following locations: - -.BR - \./_sisu/skin - -.BR - ~/.sisu/skin - -.BR - /etc/sisu/skin - -.BR -.B Within the skin directory -are the following the default sub\-directories for document skins: - -.BR - \./skin/doc - -.BR - \./skin/dir - -.BR - \./skin/site - -.BR -A skin is placed in the appropriate directory and the file named skin_[name].rb - -.BR -The skin itself is a ruby file which modifies the default appearances set in -the program. - -.SH -1.1 DOCUMENT SKIN - -.BR -Documents take on a document skin, if the header of the document specifies a -skin to be used. - - -.nf - @skin: skin_united_nations -.fi - -.SH -1.2 DIRECTORY SKIN - -.BR -A directory may be mapped on to a particular skin, so all documents within that -directory take on a particular appearance. If a skin exists in the skin/dir -with the same name as the document directory, it will automatically be used for -each of the documents in that directory, (except where a document specifies the -use of another skin, in the skin/doc directory). - -.BR -A personal habit is to place all skins within the doc directory, and symbolic -links as needed from the site, or dir directories as required. - -.SH -1.3 SITE SKIN - -.BR -A site skin, modifies the program default skin. - -.SH -1.4 SAMPLE SKINS - -.BR -With -.B SiSU -installed sample skins may be found in: - -.BR - /etc/sisu/skin/doc and - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc - -.BR -(or equivalent directory) and if sisu\-markup\-samples is installed also under: - -.BR - /usr/share/doc/sisu/sisu_markup_samples/non\-free/_sisu/skin/doc - -.BR -Samples of list.yml and promo.yml (which are used to create the right column -list) may be found in: - -.BR - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent - directory) - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Skins - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-11\-12 - -.BR -DC Date issued: -.I 2002\-11\-12 - -.BR -DC Date available: -.I 2002\-11\-12 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_skin.sst - -.BR -Filetype: -.I SiSU text insert 0.58 - -.BR -Sourcefile Digest, MD5(sisu_skin.sst)= -.I 8aebfb5312045c3a705ad6c314246f67 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:44 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_skin/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_skin/sisu_skin.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:50 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man7/sisu_complete.7 b/man/man7/sisu_complete.7 deleted file mode 100644 index 4407bc7a..00000000 --- a/man/man7/sisu_complete.7 +++ /dev/null @@ -1,181 +0,0 @@ -.TH "sisu_complete" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- COMPLETE PACKAGE, -RALPH AMISSAH -.BR - -.SH -1. SISU_COMPLETE -.BR - -.SH -1.1 NAME - -.BR -.B SiSU -\- Structured information, Serialized Units \- a document publishing system, -complete dependency package - -.SH -1.2 SYNOPSIS - -.BR -.B Debian -dummy package installs the whole of -.B SiSU -, excluding sisu\-examples. - -.BR -sisu\-complete together with sisu\-examples is the whole of -.B SiSU - -.SH -1.3 FURTHER INFORMATION - -.BR -For more information on -.B SiSU -see: - -.BR -<http://www.jus.uio.no/sisu/sisu_manual> - -.BR -<http://www.jus.uio.no/sisu> - -.SH -1.4 AUTHOR - -.BR -Ralph Amissah ralph@amissah.com or ralph.amissah@gmail.com - -.SH -1.5 SEE - -.BR -sisu(1) - -.SH -1.6 ALSO SEE - -.BR -sisu_webrick(1), sisu_pdf(7) sisu_sqlite(7) sisu_postgresql(7) sisu_vim(7) -sisu_termsheet(1) - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Complete Package - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_complete.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_complete.sst)= -.I 0974a5dfc0c6bc648ac21c688177bec0 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:47 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_complete/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_complete/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_complete/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_complete/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_complete/sisu_complete.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:52 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man7/sisu_doc.7 b/man/man7/sisu_doc.7 deleted file mode 100644 index 169d74b6..00000000 --- a/man/man7/sisu_doc.7 +++ /dev/null @@ -1,160 +0,0 @@ -.TH "sisu_doc" "1" "2007-09-24" "0.59.1" "SiSU" -.SH -SISU \- SISU\-DOC, -RALPH AMISSAH -.BR - -.SH -SISU DOC -.BR - -.SH -SISU\-DOC -.BR - -.SH -1.1 NAME - -.BR -.B SiSU -\- Structured information, Serialized Units \- a document publishing system. - -.BR -Information related to sisu documentation - -.SH -1.2 DESCRIPTION - -.BR -sisu documentation is installed in /usr/share/doc/sisu/sisu_manual or -equivalent directory - -.BR -file:///usr/share/doc/sisu/sisu_manual - -.BR -file:///usr/share/doc/sisu/sisu_manual/sisu_manual/ - -.BR -<http://www.jus.uio.no/sisu/sisu_manual> - -.BR -<http://www.sisudoc.org/sisu_manual> - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_doc/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- sisu\-doc - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2007\-09\-24 - -.BR -DC Date issued: -.I 2007\-09\-24 - -.BR -DC Date available: -.I 2007\-09\-24 - -.BR -DC Date modified: -.I 2007\-09\-24 - -.BR -DC Date: -.I 2007\-09\-24 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_doc.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_doc.sst)= -.I 00116fb664a23c87ce52dbe0d4c5a702 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:48 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_doc/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_doc/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_doc/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_doc/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_doc/sisu_doc.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:52 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man7/sisu_pdf.7 b/man/man7/sisu_pdf.7 deleted file mode 100644 index 6c1d4fdb..00000000 --- a/man/man7/sisu_pdf.7 +++ /dev/null @@ -1,212 +0,0 @@ -.TH "sisu_pdf" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- PDF, -RALPH AMISSAH -.BR - -.SH -SISU PDF -.BR - -.SH -1. SISU PDF -.BR - -.SH -1.1 NAME - -.BR -.B SiSU -\- Structured information, Serialized Units \- a document publishing system. - -.SH -1.2 DESCRIPTION - -.BR -Information creating pdf output with sisu (and related to the sisu_pdf -dependency package, which is a dummy package to install dependencies needed for -.B SiSU -to generate pdfs (primarily related to LaTeX), sisu_pdf being part of -.B SiSU -\- man sisu). - -.BR -.B SiSU -generates LaTeX which is converted by LaTeX tools to pdf. - -.SH -1.3 SYNOPSIS - -.BR - sisu \-pv \ [filename/wildcard] - -.SH -1.4 COMMANDS - -.TP -.B \ sisu \ \-pv \ \ [filename/wildcard] -creates two pdf documents: vertical (portrait.pdf) and; horizontal -(landscape.pdf). -.B SiSU -generates LaTeX output which is converted to pdf if the appropriate LaTeX -dependencies are met on the system. - -.TP -.B \ sisu \ \-pv \ \-\-papersize\-a4 \ \ [filename/wildcard] -overrides the default papersize set to A4. Preset alternative sizes include: -\'A4\', U.S. \'letter\' and \'legal\' and book sizes \'A5\' and \'B5\' (system -defaults to A4). - -.SH -1.5 SETTING PAPER SIZE - -.BR -The paper\-size may be set to any of the following sizes: \'A4\', U.S. -\'letter\' and \'legal\' and book sizes: \'A5\' and \'B5\' - -.BR -1. The preset default if not otherwise given in the configuration file or -elsewhere is A4. - -.BR -2. The default paper size may be set in the configuration file sisurc.yml. See -sisu_configuration: - - -.nf - #% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal - default: - papersize: \'A4\' -.fi - -.BR -3. Paper size may be set in a document header: - - -.nf - @papersize: (A4|US_letter|book_B5|book_A5|US_legal) -.fi - -.BR -4. or provided with additional command line parameter, e.g. - -.BR - sisu \-pv \-\-papersize\-a4 \ [filename/wildcard] - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- PDF - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_pdf.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_pdf.sst)= -.I 63bca4cff790aa5ca87bea788c520076 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:47 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_pdf/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_pdf/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_pdf/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_pdf/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_pdf/sisu_pdf.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:52 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man7/sisu_postgresql.7 b/man/man7/sisu_postgresql.7 deleted file mode 100644 index 9ba0e5a4..00000000 --- a/man/man7/sisu_postgresql.7 +++ /dev/null @@ -1,223 +0,0 @@ -.TH "sisu_postgresql" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- SEARCH, -RALPH AMISSAH -.BR - -.SH -SISU SEARCH -.BR - -.SH -SISU POSTGRESQL -.BR - -.SH -1. POSTGRESQL -.BR - -.SH -1.1 NAME - -.BR -.B SiSU -\- Structured information, Serialized Units \- a document publishing system, -postgresql dependency package - -.SH -1.2 DESCRIPTION - -.BR -Information related to using postgresql with sisu (and related to the -sisu_postgresql dependency package, which is a dummy package to install -dependencies needed for -.B SiSU -to populate a postgresql database, this being part of -.B SiSU -\- man sisu). - -.SH -1.3 SYNOPSIS - -.BR - sisu \-D \ [instruction] \ [filename/wildcard \ if \ required] - -.BR - sisu \-D \-\-pg \-\-[instruction] \ [filename/wildcard \ if \ required] - -.SH -1.4 COMMANDS - -.BR -Mappings to two databases are provided by default, postgresql and sqlite, the -same commands are used within sisu to construct and populate databases however -\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql, -alternatively \-\-sqlite or \-\-pgsql may be used - -.BR -.B \-D or \-\-pgsql -may be used interchangeably. - -.SH -1.4.1 CREATE AND DESTROY DATABASE - -.TP -.B \ \-\-pgsql \ \-\-createall -\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in -\ existing \ (postgresql) \ database \ (a \ database \ should \ be \ created \ -manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \ -requested) \ (rb.dbi) \ - -.TP -.B \ sisu \ \-D \ \-\-createdb -\ creates \ database \ where \ no \ database \ existed \ before \ - -.TP -.B \ sisu \ \-D \ \-\-create -\ creates \ database \ tables \ where \ no \ database \ tables \ existed \ -before \ - -.TP -.B \ sisu \ \-D \ \-\-Dropall -\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \ -and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \ -given \ directory \ (and \ directories \ of \ the \ same \ name). \ - -.TP -.B \ sisu \ \-D \ \-\-recreate -\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database -\ structure \ - -.SH -1.4.2 IMPORT AND REMOVE DOCUMENTS - -.TP -.B \ sisu \ \-D \ \-\-import \ \-v \ \ [filename/wildcard] -populates database with the contents of the file. Imports documents(s) -specified to a postgresql database (at an object level). - -.TP -.B \ sisu \ \-D \ \-\-update \ \-v \ \ [filename/wildcard] -updates file contents in database - -.TP -.B \ sisu \ \-D \ \-\-remove \ \-v \ \ [filename/wildcard] -removes specified document from postgresql database. - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Search - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_postgresql.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_postgresql.sst)= -.I 5f9ca1acb186a64f8e924876892dc25e - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:47 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_postgresql/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_postgresql/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_postgresql/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_postgresql/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_postgresql/sisu_postgresql.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:52 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man7/sisu_sqlite.7 b/man/man7/sisu_sqlite.7 deleted file mode 100644 index b1061671..00000000 --- a/man/man7/sisu_sqlite.7 +++ /dev/null @@ -1,222 +0,0 @@ -.TH "sisu_sqlite" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- SEARCH, -RALPH AMISSAH -.BR - -.SH -SISU SEARCH -.BR - -.SH -SISU SQLITE -.BR - -.SH -1. SQLITE -.BR - -.SH -1.1 NAME - -.BR -.B SiSU -\- Structured information, Serialized Units \- a document publishing system. - -.SH -1.2 DESCRIPTION - -.BR -Information related to using sqlite with sisu (and related to the sisu_sqlite -dependency package, which is a dummy package to install dependencies needed for -.B SiSU -to populate an sqlite database, this being part of -.B SiSU -\- man sisu). - -.SH -1.3 SYNOPSIS - -.BR - sisu \-d \ [instruction] \ [filename/wildcard \ if \ required] - -.BR - sisu \-d \-\-(sqlite|pg) \-\-[instruction] \ [filename/wildcard \ if \ - required] - -.SH -1.4 COMMANDS - -.BR -Mappings to two databases are provided by default, postgresql and sqlite, the -same commands are used within sisu to construct and populate databases however -\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql, -alternatively \-\-sqlite or \-\-pgsql may be used - -.BR -.B \-d or \-\-sqlite -may be used interchangeably. - -.SH -1.4.1 CREATE AND DESTROY DATABASE - -.TP -.B \ \-\-sqlite \ \-\-createall -\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in -\ existing \ (sqlite) \ database \ (a \ database \ should \ be \ created \ -manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \ -requested) \ (rb.dbi) \ - -.TP -.B \ sisu \ \-d \ \-\-createdb -\ creates \ database \ where \ no \ database \ existed \ before \ - -.TP -.B \ sisu \ \-d \ \-\-create -\ creates \ database \ tables \ where \ no \ database \ tables \ existed \ -before \ - -.TP -.B \ sisu \ \-d \ \-\-dropall -\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \ -and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \ -given \ directory \ (and \ directories \ of \ the \ same \ name). \ - -.TP -.B \ sisu \ \-d \ \-\-recreate -\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database -\ structure \ - -.SH -1.4.2 IMPORT AND REMOVE DOCUMENTS - -.TP -.B \ sisu \ \-d \ \-\-import \ \-v \ \ [filename/wildcard] -populates database with the contents of the file. Imports documents(s) -specified to an sqlite database (at an object level). - -.TP -.B \ sisu \ \-d \ \-\-update \ \-v \ \ [filename/wildcard] -updates file contents in database - -.TP -.B \ sisu \ \-d \ \-\-remove \ \-v \ \ [filename/wildcard] -removes specified document from sqlite database. - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Search - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_sqlite.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_sqlite.sst)= -.I 2ffb869c7c41615ca4ec83d8bd70470d - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:47 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_sqlite/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_sqlite/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_sqlite/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_sqlite/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_sqlite/sisu_sqlite.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:52 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man8/sisu_faq.8 b/man/man8/sisu_faq.8 deleted file mode 100644 index 72b4e0f6..00000000 --- a/man/man8/sisu_faq.8 +++ /dev/null @@ -1,402 +0,0 @@ -.TH "sisu_faq" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- FAQ \- FREQUENTLY ASKED/ANSWERED QUESTIONS, -RALPH AMISSAH -.BR - -.SH -1. FAQ \- FREQUENTLY ASKED/ANSWERED QUESTIONS -.BR - -.SH -1.1 WHY ARE URLS PRODUCED WITH THE \-V (AND \-U) FLAG THAT POINT TO A WEB -SERVER ON PORT 8081? - -.BR -Try the following rune: - -.BR -* sisu \-W - -.BR -This should start the ruby webserver. It should be done after having produced -some output as it scans the output directory for what to serve. - -.SH -1.2 I CANNOT FIND MY OUTPUT, WHERE IS IT? - -.BR -The following should provide help on output paths: - -.BR -* sisu \-\-help env - -.BR -* sisu \-V \ [same \ as \ the \ previous \ command] - -.BR -* sisu \-\-help directory - -.BR -* sisu \-\-help path - -.BR -* sisu \-U \ [filename] - -.BR -* man sisu - -.SH -1.3 I DO NOT GET ANY PDF OUTPUT, WHY? - -.BR -.B SiSU -produces LaTeX and pdflatex is run against that to generate pdf files. - -.BR -If you use -.B Debian -the following will install the required dependencies - -.BR -* aptitude install sisu\-pdf - -.BR -the following packages are required: tetex\-bin, tetex\-extra, latex\-ucs - -.SH -1.4 WHERE IS THE LATEX (OR SOME OTHER INTERIM) OUTPUT? - -.BR -Try adding \-M (for maintenance) to your command flags, e.g.: - -.BR -* sisu \-HpMv \ [filename] - -.BR -this should result in the interim processing output being retained, and -information being provided on where to find it. - -.BR -* sisu \-\-help directory - -.BR -* sisu \-\-help path - -.BR -should also provide some relevant information as to where it is placed. - -.SH -1.5 WHY ISN\'T SISU MARKUP XML - -.BR -I worked with text and (though I find XML immensely valuable) disliked noise -\... better to sidestep the question and say: - -.BR -.B SiSU -currently \"understands\" three XML input representations \- or more -accurately, converts from three forms of XML to native -.B SiSU -markup for processing. The three types correspond to SAX (structure -described), DOM (structure embedded, whole document must be read before -structure is correctly discernable) and node based (a tree) forms of XML -document structure representation. Problem is I use them very seldom and check -that all is as it should be with them seldom, so I would not be surprised if -something breaks there, but as far as I know they are working. I will check and -add an XML markup help page before the next release. There already is a bit of -information in the man page under the title -.B SiSU -VERSION CONVERSION - -.BR - sisu \-\-to\-sax \ [filename/wildcard] - -.BR - sisu \-\-to\-dom \ [filename/wildcard] - -.BR - sisu \-\-to\-node \ [filename/wildcard] - -.BR -The XML should be well formed... must check, but lacks sensible headers. -Suggestions welcome as to what to make of them. \ [For \ the \ present \ time \ -I \ am \ satisfied \ that \ I \ can \ convert \ (both \ ways) \ between \ 3 \ -forms \ of \ XML \ representation \ and -.B \ SiSU -\ markup]. - -.BR - sisu \-\-from\-xml2sst \ [filename/wildcard] - -.SH -1.6 LATEX CLAIMS TO BE A DOCUMENT PREPARATION SYSTEM FOR HIGH\-QUALITY -TYPESETTING. CAN THE SAME BE SAID ABOUT SISU? - -.BR -.B SiSU -is not really about type\-setting. - -.BR -LaTeX is the ultimate computer instruction type\-setting language for paper -based publication. - -.BR -LaTeX is able to control just about everything that happens on page and pixel, -position letters kerning, space variation between characters, words, paragraphs -etc. formula. - -.BR -.B SiSU -is not really about type\-setting at all. It is about a lightweight markup -instruction that provides enough information for an abstraction of the -documents structure and objects, from which different forms of representation -of the document can be generated. - -.BR -.B SiSU -with very little markup instruction is able to produce relatively high -quality pdf by virtue of being able to generate usable default LaTeX; it -produces \"quality\" html by generating the html directly; likewise it -populates an SQL database in a useful way with the document in object sized -chunks and its meta\-data. But -.B SiSU -works on an abstraction of the document\'s structure and content and custom -builds suitable uniform output. The html for browser viewing and pdf for paper -viewing/publishing are rather different things with different needs for layout -\- as indeed is what is needed to store information in a database in searchable -objects. - -.BR -The pdfs or html produced for example by open office based on open document -format and other office/word processor suits usually attempt to have similar -looking outputs \- your document rendered in html looks much the same, or in -pdf... sisu is less this way, it seeks to have a starting point with as little -information about appearance as possible, and to come up with the best possible -appearance for each output that can be derived based on this minimal -information. - -.BR -Where there are large document sets, it provides consistency in appearance in -each output format for the documents. - -.BR -The excuse for going this way is, it is a waste of time to think much about -appearance when working on substantive content, it is the substantive content -that is relevant, not the way it looks beyond the basic informational tags \- -and yet you want to be able to take advantage of as many useful different ways -of representing documents as are available, and for various types of output to -to be/look as good as it can for each medium/format in which it is presented, -(with different mediums having different focuses) and -.B SiSU -tries to achieve this from minimal markup. - -.SH -1.7 HOW DO I CREATE GIN OR GIST INDEX IN POSTGRESQL FOR USE IN SISU - -.BR -This at present needs to be done \"manually\" and it is probably necessary to -alter the sample search form. The following is a helpful response from one of -the contributors of GiN to Postgresql Oleg Bartunov 2006\-12\-06: - -.BR -\"I have tsearch2 slides which introduces tsearch2 -<http://www.sai.msu.su/~megera/wiki/tsearch2slides> - -.BR -FTS in PostgreSQL is provided by tsearch2, which should works without any -indices (GiST or GIN) ! Indices provide performance, not functionality. - -.BR -In your example I\'d do ( simple way, just for demo): - -.BR -.B 0. -compile, install tsearch2 and load tsearch2 into your database - -.BR - cd contrib/tsearch2; make&&make&&install&&make installcheck; psql DB < - tsearch2.sql - -.BR -.B 1. -Add column fts, which holds tsvector - -.BR - alter table documents add column fts tsvector; - -.BR -.B 2. -Fill fts column - -.BR - update document set fts = to_tsvector(clean); - -.BR -.B 3. -create index \- just for performance ! - -.BR - create index fts_gin_idx on document using gin(fts); - -.BR -.B 4. -Run vacuum - -.BR - vacuum analyze document; - -.BR -That\'s all. - -.BR -Now you can search: - -.BR -select lid, metadata_tid, rank_cd(fts, q,2)as rank from document, -plainto_tsquery(\'markup syntax\') q where q @@ fts order by rank desc limit -10; - -.SH -1.8 WHERE IS VERSION 1.0? - -.BR -.B SiSU -works pretty well as it is supposed to. Version 1.0 will have the current -markup, and directory structure. At this point it is largely a matter of choice -as to when the name change is made. - -.BR -The feature set for html,[^1] LaTeX/pdf and opendocument is in place. XML, and -plaintext are in order. - -.BR -html and LaTeX/pdf may be regarded as reference copy outputs - -.BR -With regard to the populating of sql databases (postgresql and sqlite), there -is a bit to be done. - -.BR -We are still almost there. - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- FAQ \- Frequently Asked/Answered Questions - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2006\-09\-06 - -.BR -DC Date available: -.I 2006\-09\-06 - -.BR -DC Date issued: -.I 2006\-09\-06 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_faq.sst - -.BR -Filetype: -.I SiSU text 0.57 - -.BR -Sourcefile Digest, MD5(sisu_faq.sst)= -.I 41577c9fc063cd232914a1a11a59e91a - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:46 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI 1. -html w3c compliance has been largely met. - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_faq/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_faq/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_faq/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_faq/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_faq/sisu_faq.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:51 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man8/sisu_howto.8 b/man/man8/sisu_howto.8 deleted file mode 100644 index 7717fd7d..00000000 --- a/man/man8/sisu_howto.8 +++ /dev/null @@ -1,2301 +0,0 @@ -.TH "sisu_howto" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- TECHNICAL, HOWTO, -RALPH AMISSAH -.BR - -.SH -SISU SOME TECHNICAL INFORMATION -.BR - -.SH -HOWTO -.BR - -.SH -1. GETTING HELP -.BR - -.BR -An online manual of sorts should be available at: - -.BR -<http://www.jus.uio.no/sisu_manual/> - -.BR -The manual pages provided with -.B SiSU -are also available online, and there is an interactive help, which is being -superseded by the man page, and possibly some document which contains this -component. - -.SH -1.1 SISU \"MAN\" PAGES - -.BR -If -.B SiSU -is installed on your system usual man commands should be available, try: - -.BR -man sisu - -.BR -The -.B SiSU -man pages can be viewed online at:[^1] - -.BR -An online version of the sisu man page is available here: - -.BR -* various sisu man pages <http://www.jus.uio.no/sisu/man/> \ [^2] - -.BR -* sisu.1 <http://www.jus.uio.no/sisu/man/sisu.1.html> \ [^3] - -.BR -* sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8.html> \ [^4] - -.BR -* sisu_examples.1 <http://www.jus.uio.no/sisu/man/sisu_examples.1.html> \ [^5] - -.BR -* sisu_webrick.1 <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> \ [^6] - -.SH -1.2 SISU BUILT\-IN HELP - -.BR - sisu \-\-help - -.BR - sisu \-\-help \ [subject] - -.BR - sisu \-\-help env \ [for \ feedback \ on \ the \ way \ your \ system \ is \ - setup \ with \ regard \ to \ sisu] - -.BR - sisu \-V \ [same \ as \ above \ command] - -.BR - sisu \-\-help commands - -.BR - sisu \-\-help markup - -.SH -1.3 COMMAND LINE WITH FLAGS \- BATCH PROCESSING - -.BR -Running sisu (alone without any flags, filenames or wildcards) brings up the -interactive help, as does any sisu command that is not recognised. - -.BR -In the data directory run sisu \-mh filename or wildcard eg. \"sisu \-h -cisg.sst\" or \"sisu \-h *.{sst,ssm}\" to produce html version of all -documents. - -.SH -2. SETUP, INITIALISATION -.BR - -.SH -2.1 INITIALISE OUTPUT DIRECTORY - -.BR -Images, css files for a document directory are copied to their respective -locations in the output directory. - -.BR -while within your document markup/preparation directory, issue the following -command - -.BR - sisu \-CC - -.SH -2.1.1 USE OF SEARCH FUNCTIONALITY, AN EXAMPLE USING SQLITE - -.BR -.B SiSU -can populate PostgreSQL and Sqlite databases and provides a sample search -form for querying these databases. - -.BR -This note provides an example to get you started and will use sqlite - -.BR -It is necessary to: - -.BR -(1) make sure the required dependencies have been installed - -.BR -(2) have a directory with sisu markup samples that is writable - -.BR -(3) use sisu to create a database - -.BR -(4) use sisu tp populate a database - -.BR -(5) use sisu to start the webrick (httpd) server - -.BR -(6) use sisu to create a search form - -.BR -(7) copy the search form to the cgi directory - -.BR -(8) open up the form in your browser - -.BR -(9) query the database using the search form - -.BR -.B (1) make sure the required dependencies have been installed - -.BR -if you use -.B Debian -, the following command will install the required dependencies - -.BR -aptitude install sisu\-sqlite - -.BR -.B (2) have a directory with sisu markup samples that is writable - -.BR -ideally copy the sisu\-examples directory to your home directory (because the -directory in which you run this example should be writable) - -.BR -cp \-rv /usr/share/sisu\-examples/sample/document_samples_sisu_markup ~/. - -.BR -.B (3) use sisu to create an sqlite database - -.BR -within the sisu\-examples directory - -.BR -sisu \-dv createall - -.BR -.B (4) use sisu tp populate a database with some text - -.BR -within the sisu\-examples directory - -.BR -sisu \-div free_*.sst - -.BR -or - -.BR -sisu \-dv import free_*.sst debian_constitution_v1.2.sst -debian_social_contract_v1.1.sst gpl2.fsf.sst - -.BR -.B (5) use sisu to start the webrick (httpd) server (if it has not already -been started): - -.BR -sisu \-W - -.BR -.B (6) use sisu to create a search form (for use with the webrick server, and -your sample documents) - -.BR -within the sisu\-examples directory - -.BR -sisu \-F webrick - -.BR -#here i run into a problem, you are working from a read only #directory..., not -my usual mode of operation, to complete the example #the following is necessary -sudo touch sisu_sqlite.cgi sisu_pgsql.cgi sudo \-P chown $USER sisu_sqlite.cgi -sisu_pgsql.cgi - -.BR -#now this should be possible: sisu \-F webrick - -.BR -.B (7) copy the search form to the cgi directory - -.BR -the string should be provided as output from the previous command - -.BR -sudo cp \-vi -/usr/share/sisu\-examples/sample/document_samples_sisu_markup/sisu_sqlite.cgi -/usr/lib/cgi\-bin - -.BR -sudo chmod \-v 755 /usr/lib/cgi\-bin/sisu_sqlite.cgi - -.BR -.B (8) open up the form in your browser and query it - -.BR -url: - -.BR -<http://localhost:8081/cgi\-bin/sisu_sqlite.cgi> - -.BR -or as instructed by command sisu \-F webrick - -.BR -.B (9) query the database using the search form - -.BR -if there are other options in the dropdown menu select - -.BR -document_samples_sisu_markup - -.BR -and search for some text, e.g.: - -.BR -aim OR project - -.BR -* selecting the -.B index -radio button gives an index of results using the object numbers - -.BR -* selecting the -.B text -radio button gives the content of the matched paragraphs with the match -highlighted - -.BR -.B (10) to start again with a new database - -.BR -to start from scratch you can drop the database with the command - -.BR -sisu \-dv dropall - -.BR -and go to step 3 - -.BR -to get to step 3 in one step with a single command - -.BR -sisu \-dv recreate - -.BR -continue subsequent steps - -.SH -2.2 MISC - -.SH -2.2.1 URL FOR OUTPUT FILES \-U \-U - -.BR - sisu \-uv[and \ other \ flags] \ [filename/wildcard] - -.BR - sisu \-Uv \ [filename/wildcard] - -.SH -2.2.2 TOGGLE SCREEN COLOR - -.BR - sisu \-cv[and \ processing \ flags] \ [filename/wildcard] - -.SH -2.2.3 VERBOSE MODE - -.BR - sisu \-v[and \ processing \ flags] \ [filename/wildcard] - -.BR - sisu \-V[and \ processing \ flags] \ [filename/wildcard] - -.SH -2.2.4 QUIET MODE - -.BR - sisu \-q[and \ processing \ flags] \ [filename/wildcard] - -.SH -2.2.5 MAINTENANCE MODE INTERMEDIATE FILES KEPT \-M - -.BR - sisu \-Mv[and \ other \ flags] \ [filename/wildcard] - -.SH -2.2.6 START THE WEBRICK SERVER - -.BR - sisu \-W - -.SH -2.3 REMOTE PLACEMENT OF OUTPUT - -.BR -configuration is necessary - -.BR -scp - -.BR - sisu \-vr[and \ processing \ flags] \ [filename/wildcard] - -.BR -rsync - -.BR - sisu \-vR[and \ processing \ flags] \ [filename/wildcard] - -.SH -3. CONFIGURATION FILES -.BR - -.BR -Sample provided, on untarring the source tarball: - -.BR - conf/sisu/sisurc.yaml - -.BR -and on installation under: - -.BR - /etc/sisu/sisurc.yaml - -.BR -The following paths are searched: - -.BR - \./_sisu/sisurc.yaml - -.BR - ~/.sisu/sisurc.yaml - -.BR - \./etc/sisu/sisurc.yaml - -.SH -4. MARKUP -.BR - -.BR -See sample markup provided on - -.BR -<http://www.jus.uio.no/sisu> - -.BR -<http://www.jus.uio.no/sisu_markup> - -.BR -<http://www.jus.uio.no/sisu/SiSU> - -.BR -in particular for each of the document output samples provided, the source -document is provided as well - -.BR -<http://www.jus.uio.no/sisu/SiSU/2#books> - -.BR -on untarring the source tarball: - -.BR - data/sisu\-examples/sample/document_samples_sisu_markup/ - -.BR -or the same once source is installed (or sisu\-examples) under: - -.BR - /usr/share/sisu\-examples/sample/document_samples_sisu_markup/ - -.BR -Some notes are contained within the man page, -.B man sisu -and within sisu help via the commands -.B sisu help markup -and -.B sisu help headers - -.BR -.B SiSU -is for literary and legal text, also for some social science material. In -particular it does not do formula, and is not particularly suited to technical -documentation. Despite the latter caveat, some notes will be provided here and -added to over time: - -.SH -4.1 HEADERS - -.BR -Headers @headername: provide information related to the document, this may -relate to - -.BR -1. how it is to be processed, such as whether headings are to be numbered, what -skin is to be used and markup instructions, such as the document structure, or -words to be made bold within the document - -.BR -2. semantic information about the document including the dublin core - -.SH -4.2 FONT FACE - -.BR -Defaults are set. You may change the face to: bold, italics, underscore, -strikethrough, \... - -.SH -4.2.1 BOLD - -.BR -\@bold: \ [list \ of \ words \ that \ should \ be \ made \ bold \ within \ -document] - -.BR -.B bold line - -.BR -!_ bold line - -.BR -.B bold word or sentence - -.BR -!{ bold word or sentence }! - -.BR -*{ bold word or sentence }* - -.BR -.B boldword -or -.B boldword - -.BR -*boldword* or !boldword! - -.SH -4.2.2 ITALICS - -.BR -\@italics: \ [list \ of \ words \ that \ should \ be \ italicised \ within \ -document] - -.BR -.I italicise word or sentence - -.BR -/{ italicise word or sentence }/ - -.BR -.I italicisedword - -.BR -/italicisedword/ - -.SH -4.2.3 UNDERSCORE - -.BR -.I underscore word or sentence - -.BR -_{ underscore word or sentence }_ - -.BR -.I underscoreword - -.SH -4.2.4 STRIKETHROUGH - -.BR -<del> strikethrough word or sentence </del> - -.BR -\-{ strikethrough word or sentence }\- - -.BR -<del>strikeword</del> - -.BR -\-strikeword\- - -.SH -4.3 ENDNOTES - -.BR -There are two forms of markup for endnotes, they cannot be mixed within the -same document - -.BR -here[^7] - -.BR -1. preferred endnote markup - -.BR -here~{ this is an endnote }~ - -.BR -2. alternative markup equivalent, kept because it is possible to search and -replace to get markup in existing texts such as Project Gutenberg - -.BR -here~^ - -.BR -^~ this is an endote - -.SH -4.4 LINKS - -.BR -SiSU <http://sisudoc.org> - -.BR -{ -.B SiSU -}http://sisudoc.org - -.BR -sisu.png 120x39 <http://sisudoc.org> - -.BR -{sisu.png }http://sisudoc.org - -.BR -[ tux.png ] - -.BR -{ tux.png 64x80 }image - -.BR -SiSU <http://sisudoc.org> \ [^8] - -.BR -{ -.B SiSU -}http://sisudoc.org - -.BR -is equivalent to: - -.BR -{ -.B SiSU -}http://sisudoc.org ~{ <http://sisudoc.org> }~ - -.BR -the same can be done with an image: - -.BR -sisu.png 120x39 \"SiSU\" <http://sisudoc.org> \ [^10] - -.BR -{ sisu.png \" -.B SiSU -\" }http://sisudoc.org - -.SH -4.5 NUMBER TITLES - -.BR -Set with the header @markup: - -.SH -4.6 LINE OPERATIONS - -.BR -Line Operations (marker placed at start of line) - -.BR -!_ bold line - -.BR -.B bold line - -.BR -_1 indent paragraph one level - -.BR - indent paragraph one level - -.BR -_2 indent paragraph two steps - -.BR - indent paragraph two steps - -.BR -_* bullet paragraph - -.BR -* bullet paragraph - -.BR -# number paragraph (see headers for numbering document headings) - -.BR -1. number paragraph (see headers for numbering document headings) - -.BR -_# number paragraph level 2 (see headers for numbering document headings) - -.BR - a. number paragraph level 2 (see headers for numbering document headings) - -.SH -4.7 TABLES - -.BR -Table markup sample - - -table{~h c3; 26; 32; 32; -.P - - -This is a table, column1 -.P -this would become row one of column two -.P -column three of row one is here -.P - - -column one row 2 -.P -column two of row two -.P -column three of row two, and so on -.P - - -column one row three -.P -and so on -.P -here -.P - - -}table -.P - -.BR -Alternative form of table markup - - -.nf - {t\~h} - |Mon|Tue|Wed|Thu|Fri|Sat|Sun - 0 | * | * | * | * | * | * | * - 1 | * | * | * | * | | | - 2 | \- | * | * | * | * | * | - 3 | \- | * | * | * | * | * | * - 4 | \- | | | * | * | * | - 5 | * | * | * | * | * | * | * -.fi - -.SH -4.8 GROUPED TEXT - - -.nf - 5.times { puts \'Ruby\' } -.fi - -.BR -code{ - - -.nf - 5.times { puts \'Ruby\' } -.fi - -.BR -}code - - -A Limerick -.P - - -There was a young lady from Clyde, -.P -who ate a green apple and died, -.P -but the apple fermented inside the lamented, -.P -and made cider inside her inside. -.P - - -poem{ -.P - - -There was a young lady from Clyde, -.P -who ate a green apple and died, -.P -but the apple fermented inside the lamented, -.P -and made cider inside her inside. -.P - - -}\poem -.P - -.SH -4.9 COMPOSITE DOCUMENT - -.BR -To import another document, the master document or importing document should be -named filename.r3 (r for require) - -.BR -<< { filename.sst } - -.BR -<< { filename.ssi } - -.SH -5. CHANGE APPEARANCE -.BR - -.SH -5.1 SKINS - -.BR -\"Skins\" may be used to change various aspects related to the output documents -appearance, including such things as the url for the home page on which the -material will be published, information on the credit band, and for html -documents colours and icons used in navigation bars. Skins are ruby files which -permit changing of the default values set within the program for -.B SiSU -output. - -.BR -There are a few examples provided, on untarring the source tarball: - -.BR - conf/sisu/skin/doc/ - -.BR - data/sisu\-examples/sample/document_samples_sisu_markup/_sisu/skin/doc - -.BR -and on installation under: - -.BR - /etc/sisu/skin/doc/ - -.BR - /usr/share/sisu\-examples/sample/document_samples_sisu_markup/_sisu/skin/doc - -.BR -The following paths are searched: - -.BR - \./_sisu/skin - -.BR - ~/.sisu/skin - -.BR - /etc/sisu/skin - -.BR -Skins under the searched paths in a per document directory, a per directory -directory, or a site directory, named: - -.BR -doc \ [may \ be \ specified \ individually \ in \ each \ document] - -.BR -dir \ [used \ if \ identifier \ part \ of \ name \ matches \ markup \ directory -\ name] - -.BR -site - -.BR -It is usual to place all skins in the document directory, with symbolic links -as required from dir or site directories. - -.SH -5.2 CSS - -.BR -The appearance of html and XML related output can be changed for an ouput -collection directory by prepareing and placing a new css file in one of the -sisu css directories searched in the sisu configuration path. These are located -at: - -.BR -_./_sisu/css - -.BR -~/.sisu/css - -.BR -and - -.BR -/etc/sisu/css - -.BR -The contents of the first directory found in the search path are copied to the -corresponding sisu output directory with the commnd: - -.BR -sisu \-CC - -.BR -The -.B SiSU -standard css files for -.B SiSU -output are: - -.BR -dom.css html.css html_tables.css index.css sax.css xhtml.css - -.BR -A document may specify its own/bespoke css file using the css header. - -.BR -\@css: - -.BR -[expand] - -.SH -EXTRACTS FROM THE README -.BR - -.SH -6. README -.BR - -.BR -.B SiSU -0.55 2007w27/6 2007\-07\-07 - -.BR -Homepage: <http://www.jus.uio.no/sisu> - -.BR -.B Description - -.BR -.B SiSU -is lightweight markup based document creation and publishing framework that -is controlled from the command line. Prepare documents for -.B SiSU -using your text editor of choice, then use -.B SiSU -to generate various output document formats. - -.BR -With minimal preparation of a plain\-text (UTF\-8) file using its native -markup\-syntax, -.B SiSU -produces: plain\-text, HTML, XHTML, XML, ODF:ODT (Opendocument), LaTeX, PDF, -and populates an SQL database (PostgreSQL or SQLite) in paragraph sized chunks -so that document searches are done at this \"atomic\" level of granularity. - -.BR -Outputs share a common citation numbering system, and any semantic meta\-data -provided about the document. - -.BR -.B SiSU -also provides concordance files, document content certificates and manifests -of generated output. - -.BR -.B SiSU -takes advantage of well established open standard ways of representing text, -and provides a bridge to take advantage of the strengths of each, while -remaining simple. -.B SiSU -implements across document formats a \"useful common feature set\" \ [coming -\ from \ a \ humanities, \ law, \ and \ possibly \ social \ sciences \ -perspective, \ rather \ than \ technical \ or \ scientific \ writing] \... -focus is primarily on content and data integrity rather than appearance, -(though outputs in the various formats are respectable). - -.BR -A vim syntax highlighting file and an ftplugin with folds for sisu markup is -provided. Vim 7 includes syntax highlighting for -.B SiSU -. - -.BR -man pages, and interactive help are provided. - -.BR -Dependencies for various features are taken care of in sisu related packages. -The package sisu\-complete installs the whole of -.B SiSU -. - -.BR -Additional document markup samples are provided in the package -sisu\-markup\-samples which is found in the non\-free archive the licenses for -the substantive content of the marked up documents provided is that provided by -the author or original publisher. - -.BR -Homepage: <http://www.jus.uio.no/sisu> - -.BR -.B SiSU -\- simple information structuring universe, is a publishing tool, document -generation and management, (and search enabling) tool primarily for literary, -academic and legal published works. - -.BR -.B SiSU -can be used for Internet, Intranet, local filesystem or cd publishing. - -.BR -.B SiSU -can be used directly off the filesystem, or from a database. - -.BR -.B SiSU -\'s scalability, is be dependent on your hardware, and filesystem (in my case -Reiserfs), and/or database Postgresql. - -.BR -Amongst it\'s characteristics are: - -.BR -* simple mnemonoic markup style, - -.BR -* the ability to produce multiple output formats, including html, structured -XML, LaTeX, pdf (via LaTeX), stream to a relational database whilst retaining -document structure \- Postgresql and Sqlite, - -.BR -* that all share a common citation system (a simple idea from which much good), -possibly most exciting, the following: if fed into a relational database (as it -can be automatically), the document set is searchable, with results displayed -at a paragraph level, or the possibility of an indexed display of documents in -which the match is found together with a hyperlinked listing for each of each -paragraph in which the match is found. In any event citations using this system -(with or without the relational database) are relevant for all output formats. - -.BR -* it is command line driven, and can be set up on a remote server - -.BR -* Documents are marked up in -.B SiSU -syntax in your favourite editor. -.B SiSU -syntax may be regarded as a type of smart ascii \- which in its basic form is -simpler than the most elementary html. There is currently a syntax highlighter, -and folding for Vim. Syntax highlighters for other editors are welcome. - -.BR -Input files should be UTF\-8 - -.BR -Once set up it is simple to use. - -.SH -6.1 ONLINE INFORMATION, PLACES TO LOOK - -.BR -<http://www.jus.uio.no/sisu> - -.BR -Download Sources: - -.BR - <http://www.jus.uio.no/sisu/SiSU/download.html#current> - -.BR - <http://www.jus.uio.no/sisu/SiSU/download.html#debian> - -.SH -6.2 INSTALLATION - -.BR -NB. Platform is Unix / Linux. - -.SH -6.2.1 DEBIAN - -.BR -If you use -.B Debian -use the -.B Debian -packages, check the information at: - -.BR - <http://www.jus.uio.no/sisu/SiSU/download.html#debian> - -.BR -(A) -.B SiSU -is available directly off the -.B Debian -archives for Sid and testing. It should necessary only to run as root: - -.BR - aptitude update - -.BR - aptitude install sisu\-complete - -.BR -(B) If there are newer versions of -.B SiSU -upstream of the -.B Debian -archives, they will be available by adding the following to your -/etc/apt/sources.list - -.BR - deb <http://www.jus.uio.no/sisu/archive> unstable main non\-free - -.BR - deb\-src <http://www.jus.uio.no/sisu/archive> unstable main non\-free - -.BR -[the \ non\-free \ line \ is \ for \ document \ markup \ samples, \ for \ which -\ the \ substantive \ text \ is \ provided \ under \ the \ author \ or \ -original \ publisher\'s \ license \ and \ which \ in \ most \ cases \ will \ -not \ be \ debian \ free \ software \ guideline \ compliant] - -.BR -Then as root run: - -.BR - aptitude update - -.BR - aptitude install sisu\-complete - -.SH -6.2.2 RPM - -.BR -RPMs are provided though untested, they are prepared by running alien against -the source package, and against the debs. - -.BR -They may be downloaded from: - -.BR - <http://www.jus.uio.no/sisu/SiSU/download.html#rpm> - -.SH -6.2.3 SOURCE PACKAGE \.TGZ - -.BR -Otherwise to install -.B SiSU -from source, check information at: - -.BR - <http://www.jus.uio.no/sisu/SiSU/download.html#current> - -.BR -alternative modes of installation from source are provided, setup.rb (by Minero -Aoki), rake (by Jim Weirich) built install file, rant (by Stefan Lang) built -install file, - -.BR -.B Ruby -is the essential dependency for the basic operation of -.B SiSU - -.BR -1. Download the latest source (information available) from: - -.BR - <http://www.jus.uio.no/sisu/SiSU/download.html#current> - -.BR -2. Unpack the source - -.BR -Note however, that additional external package dependencies, such as texlive or -postgresql should you desire to use it are not taken care of for you. - -.SH -6.2.4 TO USE SETUP.RB - -.BR -this is a three step process, in the root directory of the unpacked -.B SiSU -as root type: - -.BR - ruby setup.rb config - -.BR - ruby setup.rb setup - -.BR -as root: - -.BR - ruby setup.rb install - -.BR -further information: - -.BR - <http://i.loveruby.net/en/projects/setup/> - -.BR - <http://i.loveruby.net/en/projects/setup/doc/usage.html> - -.SH -6.2.5 TO USE INSTALL (PRAPARED WITH \"RAKE\") - -.BR -Rake must be installed on your system: - -.BR - <http://rake.rubyforge.org/> - -.BR - <http://rubyforge.org/frs/?group_id=50> - -.BR -in the root directory of the unpacked -.B SiSU -as root type: - -.BR - rake - -.BR -or - -.BR - rake base - -.BR -This makes use of Rake (by Jim Weirich) and the provided Rakefile - -.BR -For a list of alternative actions you may type: - -.BR - rake help - -.BR - rake \-T - -.SH -6.2.6 TO USE INSTALL (PRAPARED WITH \"RANT\") - -.BR -(you may use the instructions above for rake substituting rant if rant is -installed on your system, or you may use an independent installer created using -rant as follows:) - -.BR -in the root directory of the unpacked -.B SiSU -as root type: - -.BR - ruby \./sisu\-install - -.BR -or - -.BR - ruby \./sisu\-install base - -.BR -This makes use of Rant (by Stefan Lang) and the provided Rantfile. It has been -configured to do post installation setup setup configuration and generation of -first test file. Note however, that additional external package dependencies, -such as tetex\-extra are not taken care of for you. - -.BR -further information: - -.BR - <http://make.rubyforge.org/> - -.BR - <http://rubyforge.org/frs/?group_id=615> - -.BR -For a list of alternative actions you may type: - -.BR - ruby \./sisu\-install help - -.BR - ruby \./sisu\-install \-T - -.SH -6.3 DEPENDENCIES - -.BR -Once installed see \'man 8 sisu\' for some information on additional programs -that sisu makes use of, and that you may need or wish to install. (this will -depend on such factors as whether you want to generate pdf, whether you will be -using -.B SiSU -with or without a database, \...) \'man sisu_markup\-samples\' may also be of -interest if the sisu\-markup\-samples package has also been installed. - -.BR -The information in man 8 may not be most up to date, and it is possible that -more useful information can be gleaned from the following notes taken from the -.B Debian -control file (end edited), gives an idea of additional packages that -.B SiSU -can make use of if available, (the use/requirement of some of which are -interdependent for specific actions by -.B SiSU -). - -.BR -The following is from the debian/control file of sisu\-0.58.2, which amongst -other things provides the dependencies of sisu within -.B Debian -. - - -.nf - Package: sisu - Architecture: all - Depends: ruby (>= 1.8.2), libwebrick\-ruby, unzip, zip - Conflicts: vim\-sisu, sisu\-vim, sisu\-remote - Replaces: vim\-sisu, sisu\-vim - Recommends: sisu\-pdf, sisu\-sqlite, sisu\-postgresql, librmagick\-ruby, trang, - tidy, librexml\-ruby, openssl, rsync, openssh\-client | lsh\-client, keychain, - hyperestraier, kdissert, vim\-addon\-manager - Suggests: rcs | cvs, lv, texinfo, pinfo - Package: sisu\-complete - Depends: ruby (>= 1.8.4), sisu, sisu\-pdf, sisu\-postgresql, sisu\-sqlite - Recommends: hyperestraier - Package: sisu\-pdf - Architecture: all - Depends: sisu, texlive\-latex\-base, texlive\-fonts\-recommended, - texlive\-latex\-recommended, texlive\-latex\-extra - Suggests: evince, xpdf - Package: sisu\-postgresql - Depends: sisu, postgresql\-8.1, libdbi\-ruby, libdbm\-ruby, libdbd\-pg\-ruby - Suggests: pgaccess, libdbd\-pgsql, postgresql\-contrib\-8.1 - Package: sisu\-sqlite - Depends: sisu, sqlite, libdbi\-ruby, libdbm\-ruby, libdbd\-sqlite\-ruby - Suggests: libdbd\-sqlite - Package: sisu\-markup\-samples - Depends: sisu -.fi - - -.nf - Source: sisu - Section: text - Priority: optional - Maintainer: Ralph Amissah <ralph@amissah.com> - Build\-Depends: debhelper (>= 5) - Standards\-Version: 3.7.2 - Package: sisu - Architecture: all - Depends: ruby (>= 1.8.2), ruby (<< 1.9), libwebrick\-ruby, unzip, zip - Conflicts: vim\-sisu, sisu\-vim, sisu\-remote - Replaces: vim\-sisu, sisu\-vim - Recommends: sisu\-doc, sisu\-pdf, sisu\-sqlite, sisu\-postgresql, hyperestraier, keychain, librmagick\-ruby, librexml\-ruby, openssl, openssh\-client | lsh\-client, rsync, tidy, vim\-addon\-manager - Suggests: kdissert, lv, rcs | cvs, pinfo, texinfo, trang - Description: documents \- structuring, publishing in multiple formats and search - SiSU is a lightweight markup based, command line oriented, document - structuring, publishing and search framework for document collections. - \. - With minimal preparation of a plain\-text, (UTF\-8) file, using its native - markup syntax in your text editor of choice, SiSU can generate various - document formats (most of which share a common object numbering system for - locating content), including plain text, HTML, XHTML, XML, OpenDocument text - (ODF:ODT), LaTeX, PDF files, and populate an SQL database with objects - (roughly paragraph\-sized chunks) so searches may be performed and matches - returned with that degree of granularity: your search criteria is met by these - documents and at these locations within each document. Object numbering 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. Document outputs also share semantic meta\-data - provided. - \. - SiSU also provides concordance files, document content certificates and - manifests of generated output. - \. - A vim syntax highlighting file and an ftplugin with folds for sisu markup is - provided, as are syntax highlighting files for kate, kwrite, gedit and - diakonos. Vim 7 includes syntax highlighting for SiSU. - \. - man pages, and interactive help are provided. - \. - Dependencies for various features are taken care of in sisu related packages. - The package sisu\-complete installs the whole of SiSU. - \. - Additional document markup samples are provided in the package - sisu\-markup\-samples which is found in the non\-free archive the licenses for - the substantive content of the marked up documents provided is that provided - by the author or original publisher. - \. - Homepage: <http://www.jus.uio.no/sisu> -.fi - - -.nf - Package: sisu\-complete - Architecture: all - Depends: ruby (>= 1.8.2), ruby (<< 1.9), sisu, sisu\-doc, sisu\-pdf, sisu\-postgresql, sisu\-sqlite - Recommends: hyperestraier - Description: installs all SiSU related packages - This package installs SiSU and related packages that enable sisu to produce - pdf and to populate postgresql and sqlite databases. - \. - SiSU is a lightweight markup based document structuring, publishing and search - framework for document collections. - \. - See sisu for a description of the package. - \. - Homepage: <http://www.jus.uio.no/sisu> -.fi - - -.nf - Package: sisu\-doc - Architecture: all - Depends: sisu - Recommends: sisu\-pdf, sisu\-postgresql, sisu\-sqlite - Description: sisu manual and other documentation for sisu - Multiple file formats generated output of sisu documentation generated from - sisu markup source documents included in the main package - \. - SiSU is a lightweight markup based document structuring, publishing and search - framework for document collections. - \. - Homepage: <http://www.jus.uio.no/sisu> -.fi - - -.nf - Package: sisu\-pdf - Architecture: all - Depends: sisu, texlive\-latex\-base, texlive\-fonts\-recommended, texlive\-latex\-recommended, texlive\-latex\-extra - Recommends: sisu\-doc - Description: dependencies to convert SiSU LaTeX output to pdf - This package enables the conversion of SiSU LaTeX output to pdf. - \. - SiSU is a lightweight markup based document structuring, publishing and search - framework for document collections. - \. - Homepage: <http://www.jus.uio.no/sisu> -.fi - - -.nf - Package: sisu\-postgresql - Architecture: all - Depends: sisu, libdbd\-pg\-ruby, libdbi\-ruby, libdbm\-ruby, postgresql - Recommends: sisu\-doc, libfcgi\-ruby - Suggests: postgresql\-contrib - Description: SiSU dependencies for use with postgresql database - This package enables SiSU to populate a postgresql database. This is done at - an object/paragraph level, making granular searches of documents possible. - \. - This relational database feature of SiSU is not required but provides - interesting possibilities, including that of granular searches of documents - for matching units of text, primarily paragraphs that can be displayed or - identified by object citation number, from which an index of documents - matched and each matched paragraph within them can be displayed. - \. - SiSU is a lightweight markup based document structuring, publishing and search - framework for document collections. - \. - Homepage: <http://www.jus.uio.no/sisu> -.fi - - -.nf - Package: sisu\-sqlite - Architecture: all - Depends: sisu, sqlite, libdbd\-sqlite\-ruby, libdbi\-ruby, libdbm\-ruby - Recommends: sisu\-doc, libfcgi\-ruby - Description: SiSU dependencies for use with sqlite database - This package enables SiSU to populate an sqlite database. This is done at an - object/paragraph level, making granular searches of documents possible. - \. - This relational database feature of SiSU is not required but provides - interesting possibilities, including that of granular searches of documents - for matching units of text, primarily paragraphs that can be displayed or - identified by object citation number, from which an index of documents - matched and each matched paragraph within them can be displayed. - \. - SiSU is a lightweight markup based document structuring, publishing and search - framework for document collections. - \. - Homepage: <http://www.jus.uio.no/sisu> -.fi - -.SH -6.4 QUICK START - -.BR -Most of the installation should be taken care of by the aptitude or rant -install. (The rant install if run in full will also test run the generation of -the first document). - -.BR -After installation of sisu\-complete, move to the document samples directory - -.BR - cd /usr/share/doc/sisu/sisu_markup_samples/dfsg - -.BR -and run - -.BR - sisu \-3 free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.BR -or the same: - -.BR - sisu \-NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.BR -look at output results, see the \"sisu_manifest\" page created for the document - -.BR -or to generate an online document move to a writable directory, as the file -will be downloaded there and e.g. - -.BR -sisu \-3 -<http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst> - -.BR -the database stuff is extra perhaps, the latex stuff could be considered extra -perhaps but neither needs to be installed for most of sisu output to work - -.BR -examine source document, vim has syntax support - -.BR -gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.BR -additional markup samples in - -.BR - <http://www.jus.uio.no/sisu/SiSU/2.html> - -.BR -For help - -.BR - man sisu - -.BR -or - -.BR - sisu \-\-help - -.BR -e.g. - -.BR -for the way sisu \"sees/maps\" your system - -.BR - sisu \-\-help env - -.BR -for list of commands and so on - -.BR - sisu \-\-help commands - -.SH -6.5 CONFIGURATION FILES - -.BR -The default configuration/setup is contained within the program and is altered -by configuration settings in -.I etc -[sisu \ version]/sisurc.yml or in ~/.sisu/sisurc.yml - -.BR -* configuration file \- a yaml file - -.BR - /etc/sisu/[sisu \ version]/sisurc.yml - -.BR - ~/.sisu/sisurc.yml - -.BR -* directory structure \- setting up of output and working directory. - -.BR -* skins \- changing the appearance of a project, directory or individual -documents within ~/.sisu/skin - -.BR - ~/.sisu/skin/doc contains individual skins, with symbolic links from - -.BR - ~/.sisu/skin/dir if the contents of a directory are to take a particular - document skin. - -.BR -* additional software \- eg. Tex and LaTeX (tetex, tetex\-base, tetex\-extra on -.B Debian -), Postgresql, \ [sqlite], trang, tidy, makeinfo, \... none of which are -required for basic html or XML processing. - -.BR -* if you use Vim as editor there is a syntax highlighter and fold resource -config file for -.B SiSU -. I hope more syntax highlighters follow. - -.BR -There are post installation steps (which are really part of the overall -installation) - -.BR -sisu \-C in your marked up document directory, should do some auto\-configuring -provided you have the right permissions for the output directories. (and -provided the output directories have already been specified if you are not -using the defaults). - -.SH -6.6 USE GENERAL OVERVIEW - -.BR -Documents are marked up in -.B SiSU -syntax and kept in an ordinary text editable file, named with the suffix -\.sst, or \.ssm - -.BR -Marked up -.B SiSU -documents are usually kept in a sub\-directory of your choosing - -.BR -use the interactive help and man pages - -.BR - sisu \-\-help - -.BR - man sisu - -.SH -6.7 HELP - -.BR -interactive help described below, or man page: - -.BR - man sisu - -.BR - man 8 sisu - -.BR -\'man sisu_markup\-samples\' \ [if \ the \ sisu\-markup\-samples \ package \ is -\ also \ installed] - -.BR -Once installed an interactive help is available typing \'sisu\' (without) any -flags, and select an option: - -.BR - sisu - -.BR -alternatively, you could type e.g. - -.BR - sisu \-\-help commands - -.BR - sisu \-\-help env - -.BR - sisu \-\-help headers - -.BR - sisu \-\-help markup - -.BR - sisu \-\-help headings - -.BR -etc. - -.BR -for questions about mappings, output paths etc. - -.BR - sisu \-\-help env - -.BR - sisu \-\-help path - -.BR - sisu \-\-help directory - -.SH -6.8 DIRECTORY STRUCTURE - -.BR -Once installed, type: - -.BR - sisu \-\-help env - -.BR -or - -.BR - sisu \-V - -.SH -6.9 CONFIGURATION FILE - -.BR -The defaults can be changed via -.B SiSU -\'s configure file sisurc.yml which the program expects to find in \./_sisu -~/.sisu or /etc/sisu (searched in that order, stopping on the first one found) - -.SH -6.10 MARKUP - -.BR -See man pages. - -.BR - man sisu - -.BR - man 8 sisu - -.BR -Once installed there is some information on -.B SiSU -Markup in its help: - -.BR - sisu \-\-help markup - -.BR -and - -.BR - sisu \-\-help headers - -.BR -Sample marked up document are provided with the download tarball in the -directory: - -.BR - \./data/doc/sisu/sisu_markup_samples/dfsg - -.BR -These are installed on the system usually at: - -.BR - /usr/share/doc/sisu/sisu_markup_samples/dfsg - -.BR -More markup samples are available in the package sisu\-markup\-samples - -.BR - <http://www.jus.uio.no/sisu/SiSU/download.html#sisu\-markup\-samples> - -.BR -Many more are available online off: - -.BR - <http://www.jus.uio.no/sisu/SiSU/2.html> - -.SH -6.11 ADDITIONAL THINGS - -.BR -There is syntax support for some editors provided (together with a README file) -in - -.BR - \./data/sisu/conf/syntax - -.BR -usually installed to: - -.BR - /usr/share/sisu/conf/syntax - -.SH -6.12 LICENSE - -.BR -License: GPL 3 or later see the copyright file in - -.BR - \./data/doc/sisu - -.BR -usually installed to: - -.BR - /usr/share/doc/sisu - -.SH -6.13 SISU STANDARD - -.BR -.B SiSU -uses: - -.BR -* Standard -.B SiSU -markup syntax, - -.BR -* Standard -.B SiSU -meta\-markup syntax, and the - -.BR -* Standard -.B SiSU -object citation numbering and system - -.BR -© Ralph Amissah 1997, current 2006 All Rights Reserved. - -.BR -* however note the License section - -.BR -CHANGELOG - -.BR - \./CHANGELOG - -.BR -and see - -.BR - <http://www.jus.uio.no/sisu/SiSU/changelog.html> - -.BR - <http://www.jus.uio.no/sisu/SiSU/changelog_markup_samples.html> - -.SH -EXTRACTS FROM MAN 8 SISU -.BR - -.SH -7. POST INSTALLATION SETUP -.BR - -.SH -7.1 POST INSTALLATION SETUP \- QUICK START - -.BR -After installation of sisu\-complete, move to the document samples directory, - -.BR - cd /usr/share/doc/sisu/sisu_markup_samples/dfsg - -.BR -[this \ is \ not \ where \ you \ would \ normally \ work \ but \ provides \ -sample \ documents \ for \ testing, \ you \ may \ prefer \ instead \ to \ copy -\ the \ contents \ of \ that \ directory \ to \ a \ local \ directory \ before -\ proceeding] - -.BR -and in that directory, initialise the output directory with the command - -.BR - sisu \-CC - -.BR -then run: - -.BR - sisu \-1 free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.BR -or the same: - -.BR - sisu \-NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.BR -look at output results, see the \"sisu_manifest\" page created for the document - -.BR -for an overview of your current sisu setup, type: - -.BR - sisu \-\-help env - -.BR -or - -.BR - sisu \-V - -.BR -To generate a document from a remote url accessible location move to a writable -directory, (create a work directory and cd into it) as the file will be -downloaded there and e.g. - -.BR - sisu \-1 <http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst> - -.BR - sisu \-3 - <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst> - -.BR -examine source document, vim has syntax highlighting support - -.BR -gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.BR -additional markup samples in - -.BR - <http://www.jus.uio.no/sisu/SiSU/2.html> - -.BR -it should also be possible to run sisu against sisupods (prepared zip files, -created by running the command sisu \-S \ [filename]), whether stored locally -or remotely. - -.BR - sisu \-3 - <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip> - -.BR -there is a security issue associated with the running of document skins that -are not your own, so these are turned of by default, and the use of the -following command, which switches on the associated skin is not recommended: - -.BR - sisu \-3 \-\-trust - <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip> - -.BR -For help - -.BR - man sisu - -.BR - sisu \-\-help - -.BR - sisu \-\-help env for the way sisu \"sees/maps\" your system - -.BR - sisu \-\-help commands for list of commands and so on - -.SH -7.2 DOCUMENT MARKUP DIRECTORY - -.BR -Perhaps the easiest way to begin is to create a directory for sisu marked up -documents within your home directory, and copy the file structure (and document -samples) provided in the document sample directory: - -.BR - mkdir ~/sisu_test - -.BR - cd ~/sisu_test - -.BR - cp \-a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* ~/sisu_test/. - -.BR -.B Tip: -the markup syntax examples may be of interest - -.BR - <http://www.jus.uio.no/sisu/sample/> - -.BR -.B Tip: - -.BR - sisu \-U \ [sisu \ markup \ filename] - -.BR -should printout the different possible outputs and where sisu would place them. - -.BR -.B Tip: -if you want to toggle ansi color add - -.BR - c - -.BR -to your flags. - -.SH -7.2.1 CONFIGURATION FILES - -.BR -.B SiSU -configuration file search path is: - -.BR - \./_sisu/sisurc.yaml - -.BR - ~/.sisu/sisurc.yaml - -.BR - /etc/sisu/sisurc.yaml - -.BR -.\\"%% -.B Debian -Installation Note - -.SH -7.2.2 DEBIAN INSTALLATION NOTE - -.BR -It is best you see - -.BR - <http://www.jus.uio.no/sisu/SiSU/download.html#debian> - -.BR -for up the most up to date information. - -.BR -notes taken from the -.B Debian -control file (end edited), gives an idea of additional packages that -.B SiSU -can make use of if available, (the use/requirement of some of which are -interdependent for specific actions by -.B SiSU -): - -.BR -Package: sisu - -.BR -.B SiSU -is a lightweight markup based, command line oriented, document structuring, -publishing and search framework for document collections. - -.BR -With minimal preparation of a plain\-text, (UTF\-8) file, using its native -markup syntax in your text editor of choice, -.B SiSU -can generate various document formats (most of which share a common object -numbering system for locating content), including plain text, HTML, XHTML, XML, -OpenDocument text (ODF:ODT), LaTeX, PDF files, and populate an SQL database -with objects (roughly paragraph\-sized chunks) so searches may be performed and -matches returned with that degree of granularity: your search criteria is met -by these documents and at these locations within each document. Object -numbering 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. Document outputs also share semantic -meta\-data provided. - -.BR -.B SiSU -also provides concordance files, document content certificates and manifests -of generated output. - -.BR -A vim syntax highlighting file and an ftplugin with folds for sisu markup is -provided, as are syntax highlighting files for kate, kwrite, gedit and -diakonos. Vim 7 includes syntax highlighting for -.B SiSU -. - -.BR -man pages, and interactive help are provided. - -.BR -Dependencies for various features are taken care of in sisu related packages. -The package sisu\-complete installs the whole of -.B SiSU -. - -.BR -Additional document markup samples are provided in the package -sisu\-markup\-samples which is found in the non\-free archive the licenses for -the substantive content of the marked up documents provided is that provided by -the author or original publisher. - -.BR -Homepage: <http://www.jus.uio.no/sisu> - -.SH -7.2.3 DOCUMENT RESOURCE CONFIGURATION - -.BR -.B sisu -resource configuration information is obtained from sources (where they -exist): - -.BR - ~/.sisu/sisurc.yaml - -.BR - /etc/sisu/[sisu \ version]/sisurc.yaml - -.BR - sisu program defaults - -.SH -7.2.4 SKINS - -.BR -.B Skins -default document appearance may be modified using skins contained in -sub\-directories located at the following paths: - -.BR - \./_sisu/skin - -.BR - ~/.sisu/skin - -.BR - /etc/sisu/skin - -.BR -more specifically, the following locations (or their /etc/sisu equivalent) -should be used: - -.BR - ~/.sisu/skin/doc - -.BR -skins for individual documents; - -.BR - ~/.sisu/skin/dir - -.BR -skins for directories of matching names; - -.BR - ~/.sisu/skin/site - -.BR -site\-wide skin modifying the site\-wide appearance of documents. - -.BR -Usually all skin files are placed in the document skin directory: - -.BR - ~/.sisu/skin/doc - -.BR -with softlinks being made to the skins contained there from other skin -directories as required. - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Technical, Howto - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-11\-12 - -.BR -DC Date issued: -.I 2002\-11\-12 - -.BR -DC Date available: -.I 2002\-11\-12 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_howto.sst - -.BR -Filetype: -.I SiSU text insert 0.57 - -.BR -Sourcefile Digest, MD5(sisu_howto.sst)= -.I c0491e0093434f4d962ce3b59e4985ca - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:45 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI 1. -generated from source using rman - <http://polyglotman.sourceforge.net/rman.html> - With regard to -.B SiSU -man pages the formatting generated for markup syntax is not quite right, for -that you might prefer the links under: - <http://www.jus.uio.no/sample> -.TP -.BI 2. -<http://www.jus.uio.no/sisu/man/> -.TP -.BI 3. -<http://www.jus.uio.no/sisu/man/sisu.1.html> -.TP -.BI 4. -<http://www.jus.uio.no/sisu/man/sisu.8.html> -.TP -.BI 5. -<http://www.jus.uio.no/sisu/man/sisu_examples.1.html> -.TP -.BI 6. -<http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> -.TP -.BI 7. -this is an endnote -.TP -.BI 8. -<http://sisudoc.org> -.TP -.BI 10. -<http://sisudoc.org> - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_howto/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_howto/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_howto/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_howto/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_howto/sisu_howto.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:51 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man8/sisu_quickstart.8 b/man/man8/sisu_quickstart.8 deleted file mode 100644 index 5d03d4fc..00000000 --- a/man/man8/sisu_quickstart.8 +++ /dev/null @@ -1,513 +0,0 @@ -.TH "sisu_quickstart" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- QUICKSTART, INSTALLATION AND USE, -RALPH AMISSAH -.BR - -.SH -QUICKSTART \- SISU INSTALLATION AND USE -.BR - -.SH -1. QUICKSTART \- GETTING STARTED HOWTO -.BR - -.SH -1.1 INSTALLATION - -.BR -Installation is currently most straightforward and tested on the -.B Debian -platform, as there are packages for the installation of sisu and all -requirements for what it does. - -.SH -1.1.1 DEBIAN INSTALLATION - -.BR -.B SiSU -is available directly from the -.B Debian -Sid and testing archives (and possibly Ubuntu), assuming your -/etc/apt/sources.list is set accordingly: - - -.nf - aptitude update - aptitude install sisu\-complete -.fi - -.BR -The following /etc/apt/sources.list setting permits the download of additional -markup samples: - - -.nf - #/etc/apt/sources.list - deb http://ftp.fi.debian.org/debian/ unstable main non\-free contrib - deb\-src http://ftp.fi.debian.org/debian/ unstable main non\-free contrib - d -.fi - -.BR -The aptitude commands become: - - -.nf - aptitude update - aptitude install sisu\-complete sisu\-markup\-samples -.fi - -.BR -If there are newer versions of -.B SiSU -upstream of the -.B Debian -archives, they will be available by adding the following to your -/etc/apt/sources.list - - -.nf - #/etc/apt/sources.list - deb http://www.jus.uio.no/sisu/archive unstable main non\-free - deb\-src http://www.jus.uio.no/sisu/archive unstable main non\-free -.fi - -.BR -repeat the aptitude commands - - -.nf - aptitude update - aptitude install sisu\-complete sisu\-markup\-samples -.fi - -.BR -Note however that it is not necessary to install sisu\-complete if not all -components of sisu are to be used. Installing just the package sisu will -provide basic functionality. - -.SH -1.1.2 RPM INSTALLATION - -.BR -RPMs are provided though untested, they are prepared by running alien against -the source package, and against the debs. - -.BR -They may be downloaded from: - -.BR - <http://www.jus.uio.no/sisu/SiSU/download.html#rpm> - -.BR -as root type: - -.BR - rpm \-i \ [rpm \ package \ name] - -.SH -1.1.3 INSTALLATION FROM SOURCE - -.BR -To install -.B SiSU -from source check information at: - -.BR - <http://www.jus.uio.no/sisu/SiSU/download.html#current> - -.BR -* download the source package - -.BR -* Unpack the source - -.BR -Two alternative modes of installation from source are provided, setup.rb (by -Minero Aoki) and a rant(by Stefan Lang) built install file, in either case: the -first steps are the same, download and unpack the source file: - -.BR -For basic use -.B SiSU -is only dependent on the programming language in which it is written -.B Ruby -, and -.B SiSU -will be able to generate html, various XMLs, including ODF (and will also -produce LaTeX). Dependencies required for further actions, though it relies on -the installation of additional dependencies which the source tarball does not -take care of, for things like using a database (postgresql or sqlite)[^1] or -converting LaTeX to pdf. - -.BR -.B setup.rb - -.BR -This is a standard ruby installer, using setup.rb is a three step process. In -the root directory of the unpacked -.B SiSU -as root type: - - -.nf - ruby setup.rb config - ruby setup.rb setup - #[and \ as \ root:] - ruby setup.rb install -.fi - -.BR -further information on setup.rb is available from: - -.BR - <http://i.loveruby.net/en/projects/setup/> - -.BR - <http://i.loveruby.net/en/projects/setup/doc/usage.html> - -.BR -.B \"install\" - -.BR -The \"install\" file provided is an installer prepared using \"rant\". In the -root directory of the unpacked -.B SiSU -as root type: - -.BR - ruby install base - -.BR -or for a more complete installation: - -.BR - ruby install - -.BR -or - -.BR - ruby install base - -.BR -This makes use of Rant (by Stefan Lang) and the provided Rantfile. It has been -configured to do post installation setup setup configuration and generation of -first test file. Note however, that additional external package dependencies, -such as tetex\-extra are not taken care of for you. - -.BR -Further information on \"rant\" is available from: - -.BR - <http://make.rubyforge.org/> - -.BR - <http://rubyforge.org/frs/?group_id=615> - -.BR -For a list of alternative actions you may type: - -.BR - ruby install help - -.BR - ruby install \-T - -.SH -1.2 TESTING SISU, GENERATING OUTPUT - -.BR -To check which version of sisu is installed: - -.BR -sisu \-v - -.BR -Depending on your mode of installation one or a number of markup sample files -may be found either in the directory: - -.BR -... - -.BR -or - -.BR -... - -.BR -change directory to the appropriate one: - -.BR -cd /usr/share/doc/sisu/sisu_markup_samples/dfsg - -.SH -1.2.1 BASIC TEXT, PLAINTEXT, HTML, XML, ODF - -.BR -Having moved to the directory that contains the markup samples (see -instructions above if necessary), choose a file and run sisu against it - -.BR -sisu \-NhwoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.BR -this will generate html including a concordance file, opendocument text format, -plaintext, XHTML and various forms of XML, and OpenDocument text - -.SH -1.2.2 LATEX / PDF - -.BR -Assuming a LaTeX engine such as tetex or texlive is installed with the required -modules (done automatically on selection of sisu\-pdf in -.B Debian -) - -.BR -Having moved to the directory that contains the markup samples (see -instructions above if necessary), choose a file and run sisu against it - -.BR -sisu \-pv free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.BR -sisu \-3 free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.BR -should generate most available output formats: html including a concordance -file, opendocument text format, plaintext, XHTML and various forms of XML, and -OpenDocument text and pdf - -.SH -1.2.3 RELATIONAL DATABASE \- POSTGRESQL, SQLITE - -.BR -Relational databases need some setting up \- you must have permission to create -the database and write to it when you run sisu. - -.BR -Assuming you have the database installed and the requisite permissions - -.BR -sisu \-\-sqlite \-\-recreate - -.BR -sisu \-\-sqlite \-v \-\-import -free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.BR -sisu \-\-pgsql \-\-recreate - -.BR -sisu \-\-pgsql \-v \-\-import -free_as_in_freedom.rms_and_free_software.sam_williams.sst - -.SH -1.3 GETTING HELP - -.SH -1.3.1 THE MAN PAGES - -.BR -Type: - -.BR - man sisu - -.BR -The man pages are also available online, though not always kept as up to date -as within the package itself: - -.BR -* sisu.1 <http://www.jus.uio.no/sisu/man/sisu.1> \ [^2] - -.BR -* sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8> \ [^3] - -.BR -* man directory <http://www.jus.uio.no/sisu/man> \ [^4] - -.SH -1.3.2 BUILT IN HELP - -.BR -sisu \-\-help - -.BR -sisu \-\-help \-\-env - -.BR -sisu \-\-help \-\-commands - -.BR -sisu \-\-help \-\-markup - -.SH -1.3.3 THE HOME PAGE - -.BR -<http://www.jus.uio.no/sisu> - -.BR -<http://www.jus.uio.no/sisu/SiSU> - -.SH -1.4 MARKUP SAMPLES - -.BR -A number of markup samples (along with output) are available off: - -.BR -<http://www.jus.uio.no/sisu/SiSU/2.html> - -.BR -Additional markup samples are packaged separately in the file: - -.BR -.B * - -.BR -On -.B Debian -they are available in non\-free[^5] to include them it is necessary to -include non\-free in your /etc/apt/source.list or obtain them from the sisu -home site. - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Quickstart, installation and use - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2006\-09\-06 - -.BR -DC Date available: -.I 2006\-09\-06 - -.BR -DC Date issued: -.I 2006\-09\-06 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_quickstart.sst - -.BR -Filetype: -.I SiSU text 0.57 - -.BR -Sourcefile Digest, MD5(sisu_quickstart.sst)= -.I e76db98ca0d8c2bfe526dad55622fa7a - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:45 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI 1. -There is nothing to stop MySQL support being added in future. -.TP -.BI 2. -<http://www.jus.uio.no/sisu/man/sisu.1> -.TP -.BI 3. -<http://www.jus.uio.no/sisu/man/sisu.8> -.TP -.BI 4. -<http://www.jus.uio.no/sisu/man> -.TP -.BI 5. -the \.B Debian -Free Software guidelines require that everything distributed within \.B Debian -can be changed - and the documents are authors\' works that while freely -distributable are not freely changeable. - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_quickstart/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_quickstart/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_quickstart/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_quickstart/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_quickstart/sisu_quickstart.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:51 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man8/sisu_remote.8 b/man/man8/sisu_remote.8 deleted file mode 100644 index 41d836e1..00000000 --- a/man/man8/sisu_remote.8 +++ /dev/null @@ -1,251 +0,0 @@ -.TH "sisu_remote" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- REMOTE OPERATIONS, -RALPH AMISSAH -.BR - -.SH -SISU REMOTE OPERATIONS -.BR - -.SH -1. REMOTE SOURCE DOCUMENTS -.BR - -.BR -.B SiSU -processing instructions can be run against remote source documents by -providing the url of the documents against which the processing instructions -are to be carried out. The remote -.B SiSU -documents can either be sisu marked up files in plaintext \.sst or \.ssm or; -zipped sisu files, sisupod.zip or filename.ssp - -.BR -.B \.sst / \.ssm \- sisu text files - -.BR -.B SiSU -can be run against source text files on a remote machine, provide the -processing instruction and the url. The source file and any associated parts -(such as images) will be downloaded and generated locally. - - -.nf - sisu \-3 http://[provide \ url \ to \ valid \ \.sst \ or \ \.ssm \ file] -.fi - -.BR -Any of the source documents in the sisu examples page can be used in this way, -see <http://www.jus.uio.no/sisu/SiSU/2.html> and use the url for the desired -document. - -.BR -NOTE: to set up a remote machine to serve -.B SiSU -documents in this way, images should be in the directory relative to the -document source \../_sisu/image - -.BR -.B sisupod \- zipped sisu files - -.BR -A sisupod is the zipped content of a sisu marked up text or texts and any other -associated parts to the document such as images. - -.BR -.B SiSU -can be run against a sisupod on a (local or) remote machine, provide the -processing instruction and the url, the sisupod will be downloaded and the -documents it contains generated locally. - - -.nf - sisu \-3 http://[provide \ url \ to \ valid \ sisupod.zip \ or \ \.ssp \ file] -.fi - -.BR -Any of the source documents in the sisu examples page can be used in this way, -see <http://www.jus.uio.no/sisu/SiSU/2.html> and use the url for the desired -document. - -.SH -REMOTE DOCUMENT OUTPUT -.BR - -.SH -2. REMOTE OUTPUT -.BR - -.BR -Once properly configured -.B SiSU -output can be automatically posted once generated to a designated remote -machine using either rsync, or scp. - -.BR -In order to do this some ssh authentication agent and keychain or similar tool -will need to be configured. Once that is done the placement on a remote host -can be done seamlessly with the \-r (for scp) or \-R (for rsync) flag, which -may be used in conjunction with other processing flags, e.g. - - -.nf - sisu \-3R sisu_remote.sst -.fi - -.SH -2.1 COMMANDS - -.TP -.B \ \-R \ \ [filename/wildcard] -copies sisu output files to remote host using rsync. This requires that -sisurc.yml has been provided with information on hostname and username, and -that you have your \"keys\" and ssh agent in place. Note the behavior of rsync -different if \-R is used with other flags from if used alone. Alone the rsync -\-\-delete parameter is sent, useful for cleaning the remote directory (when -\-R is used together with other flags, it is not). Also see \-r - -.TP -.B \ \-r \ \ [filename/wildcard] -copies sisu output files to remote host using scp. This requires that -sisurc.yml has been provided with information on hostname and username, and -that you have your \"keys\" and ssh agent in place. Also see \-R - -.SH -2.2 CONFIGURATION - -.BR -[expand \ on \ the \ setting \ up \ of \ an \ ssh\-agent \ / \ keychain] - -.SH -3. REMOTE SERVERS -.BR - -.BR -As -.B SiSU -is generally operated using the command line, and works within a Unix type -environment, -.B SiSU -the program and all documents can just as easily be on a remote server, to -which you are logged on using a terminal, and commands and operations would be -pretty much the same as they would be on your local machine. - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Remote Operations - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_remote.sst - -.BR -Filetype: -.I SiSU text 0.58 - -.BR -Sourcefile Digest, MD5(sisu_remote.sst)= -.I 9bdac464998dc3f034fbd8f80df23b83 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:46 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_remote/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_remote/sisu_remote.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:51 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man8/sisu_search.8 b/man/man8/sisu_search.8 deleted file mode 100644 index bbe444e4..00000000 --- a/man/man8/sisu_search.8 +++ /dev/null @@ -1,639 +0,0 @@ -.TH "sisu_search" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- SEARCH, -RALPH AMISSAH -.BR - -.SH -SISU SEARCH -.BR - -.SH -1. SISU SEARCH \- INTRODUCTION -.BR - -.BR -.B SiSU -output can easily and conveniently be indexed by a number of standalone -indexing tools, such as Lucene, Hyperestraier. - -.BR -Because the document structure of sites created is clearly defined, and the -text object citation system is available hypothetically at least, for all forms -of output, it is possible to search the sql database, and either read results -from that database, or just as simply map the results to the html output, which -has richer text markup. - -.BR -In addition to this -.B SiSU -has the ability to populate a relational sql type database with documents at -an object level, with objects numbers that are shared across different output -types, which make them searchable with that degree of granularity. Basically, -your match criteria is met by these documents and at these locations within -each document, which can be viewed within the database directly or in various -output formats. - -.SH -2. SQL -.BR - -.SH -2.1 POPULATING SQL TYPE DATABASES - -.BR -.B SiSU -feeds sisu markupd documents into sql type databases PostgreSQL[^1] and/or -SQLite[^2] database together with information related to document structure. - -.BR -This is one of the more interesting output forms, as all the structural data of -the documents are retained (though can be ignored by the user of the database -should they so choose). All site texts/documents are (currently) streamed to -four tables: - -.BR - * one containing semantic (and other) headers, including, title, author, - subject, (the Dublin Core...); - -.BR - * another the substantive texts by individual \"paragraph\" (or object) \- - along with structural information, each paragraph being identifiable by its - paragraph number (if it has one which almost all of them do), and the - substantive text of each paragraph quite naturally being searchable (both in - formatted and clean text versions for searching); and - -.BR - * a third containing endnotes cross\-referenced back to the paragraph from - which they are referenced (both in formatted and clean text versions for - searching). - -.BR - * a fourth table with a one to one relation with the headers table contains - full text versions of output, eg. pdf, html, xml, and ascii. - -.BR -There is of course the possibility to add further structures. - -.BR -At this level -.B SiSU -loads a relational database with documents chunked into objects, their -smallest logical structurally constituent parts, as text objects, with their -object citation number and all other structural information needed to construct -the document. Text is stored (at this text object level) with and without -elementary markup tagging, the stripped version being so as to facilitate ease -of searching. - -.BR -Being able to search a relational database at an object level with the -.B SiSU -citation system is an effective way of locating content generated by -.B SiSU -. As individual text objects of a document stored (and indexed) together with -object numbers, and all versions of the document have the same numbering, -complex searches can be tailored to return just the locations of the search -results relevant for all available output formats, with live links to the -precise locations in the database or in html/xml documents; or, the structural -information provided makes it possible to search the full contents of the -database and have headings in which search content appears, or to search only -headings etc. (as the Dublin Core is incorporated it is easy to make use of -that as well). - -.SH -3. POSTGRESQL -.BR - -.SH -3.1 NAME - -.BR -.B SiSU -\- Structured information, Serialized Units \- a document publishing system, -postgresql dependency package - -.SH -3.2 DESCRIPTION - -.BR -Information related to using postgresql with sisu (and related to the -sisu_postgresql dependency package, which is a dummy package to install -dependencies needed for -.B SiSU -to populate a postgresql database, this being part of -.B SiSU -\- man sisu). - -.SH -3.3 SYNOPSIS - -.BR - sisu \-D \ [instruction] \ [filename/wildcard \ if \ required] - -.BR - sisu \-D \-\-pg \-\-[instruction] \ [filename/wildcard \ if \ required] - -.SH -3.4 COMMANDS - -.BR -Mappings to two databases are provided by default, postgresql and sqlite, the -same commands are used within sisu to construct and populate databases however -\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql, -alternatively \-\-sqlite or \-\-pgsql may be used - -.BR -.B \-D or \-\-pgsql -may be used interchangeably. - -.SH -3.4.1 CREATE AND DESTROY DATABASE - -.TP -.B \ \-\-pgsql \ \-\-createall -\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in -\ existing \ (postgresql) \ database \ (a \ database \ should \ be \ created \ -manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \ -requested) \ (rb.dbi) \ - -.TP -.B \ sisu \ \-D \ \-\-createdb -\ creates \ database \ where \ no \ database \ existed \ before \ - -.TP -.B \ sisu \ \-D \ \-\-create -\ creates \ database \ tables \ where \ no \ database \ tables \ existed \ -before \ - -.TP -.B \ sisu \ \-D \ \-\-Dropall -\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \ -and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \ -given \ directory \ (and \ directories \ of \ the \ same \ name). \ - -.TP -.B \ sisu \ \-D \ \-\-recreate -\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database -\ structure \ - -.SH -3.4.2 IMPORT AND REMOVE DOCUMENTS - -.TP -.B \ sisu \ \-D \ \-\-import \ \-v \ \ [filename/wildcard] -populates database with the contents of the file. Imports documents(s) -specified to a postgresql database (at an object level). - -.TP -.B \ sisu \ \-D \ \-\-update \ \-v \ \ [filename/wildcard] -updates file contents in database - -.TP -.B \ sisu \ \-D \ \-\-remove \ \-v \ \ [filename/wildcard] -removes specified document from postgresql database. - -.SH -4. SQLITE -.BR - -.SH -4.1 NAME - -.BR -.B SiSU -\- Structured information, Serialized Units \- a document publishing system. - -.SH -4.2 DESCRIPTION - -.BR -Information related to using sqlite with sisu (and related to the sisu_sqlite -dependency package, which is a dummy package to install dependencies needed for -.B SiSU -to populate an sqlite database, this being part of -.B SiSU -\- man sisu). - -.SH -4.3 SYNOPSIS - -.BR - sisu \-d \ [instruction] \ [filename/wildcard \ if \ required] - -.BR - sisu \-d \-\-(sqlite|pg) \-\-[instruction] \ [filename/wildcard \ if \ - required] - -.SH -4.4 COMMANDS - -.BR -Mappings to two databases are provided by default, postgresql and sqlite, the -same commands are used within sisu to construct and populate databases however -\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql, -alternatively \-\-sqlite or \-\-pgsql may be used - -.BR -.B \-d or \-\-sqlite -may be used interchangeably. - -.SH -4.4.1 CREATE AND DESTROY DATABASE - -.TP -.B \ \-\-sqlite \ \-\-createall -\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in -\ existing \ (sqlite) \ database \ (a \ database \ should \ be \ created \ -manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \ -requested) \ (rb.dbi) \ - -.TP -.B \ sisu \ \-d \ \-\-createdb -\ creates \ database \ where \ no \ database \ existed \ before \ - -.TP -.B \ sisu \ \-d \ \-\-create -\ creates \ database \ tables \ where \ no \ database \ tables \ existed \ -before \ - -.TP -.B \ sisu \ \-d \ \-\-dropall -\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \ -and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \ -given \ directory \ (and \ directories \ of \ the \ same \ name). \ - -.TP -.B \ sisu \ \-d \ \-\-recreate -\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database -\ structure \ - -.SH -4.4.2 IMPORT AND REMOVE DOCUMENTS - -.TP -.B \ sisu \ \-d \ \-\-import \ \-v \ \ [filename/wildcard] -populates database with the contents of the file. Imports documents(s) -specified to an sqlite database (at an object level). - -.TP -.B \ sisu \ \-d \ \-\-update \ \-v \ \ [filename/wildcard] -updates file contents in database - -.TP -.B \ sisu \ \-d \ \-\-remove \ \-v \ \ [filename/wildcard] -removes specified document from sqlite database. - -.SH -5. INTRODUCTION -.BR - -.SH -5.1 SEARCH \- DATABASE FRONTEND SAMPLE, UTILISING DATABASE AND SISU FEATURES, -INCLUDING OBJECT CITATION NUMBERING (BACKEND CURRENTLY POSTGRESQL) - -.BR -Sample search frontend <http://search.sisudoc.org> \ [^3] A small database and -sample query front\-end (search from) that makes use of the citation system, -.I object citation numbering -to demonstrates functionality.[^4] - -.BR -.B SiSU -can provide information on which documents are matched and at what locations -within each document the matches are found. These results are relevant across -all outputs using object citation numbering, which includes html, XML, LaTeX, -PDF and indeed the SQL database. You can then refer to one of the other outputs -or in the SQL database expand the text within the matched objects (paragraphs) -in the documents matched. - -.BR -Note you may set results either for documents matched and object number -locations within each matched document meeting the search criteria; or display -the names of the documents matched along with the objects (paragraphs) that -meet the search criteria.[^5] - -.TP -.B \ sisu \ \-F \ \-\-webserv\-webrick -\ builds \ a \ cgi \ web \ search \ frontend \ for \ the \ database \ created -\ - -.BR -The following is feedback on the setup on a machine provided by the help -command: - -.BR - sisu \-\-help sql - - -.nf - Postgresql - user: ralph - current db set: SiSU_sisu - port: 5432 - dbi connect: DBI:Pg:database=SiSU_sisu;port=5432 - sqlite - current db set: /home/ralph/sisu_www/sisu/sisu_sqlite.db - dbi connect DBI:SQLite:/home/ralph/sisu_www/sisu/sisu_sqlite.db -.fi - -.BR -Note on databases built - -.BR -By default, \ [unless \ otherwise \ specified] databases are built on a -directory basis, from collections of documents within that directory. The name -of the directory you choose to work from is used as the database name, i.e. if -you are working in a directory called /home/ralph/ebook the database SiSU_ebook -is used. \ [otherwise \ a \ manual \ mapping \ for \ the \ collection \ is \ -necessary] - -.SH -5.2 SEARCH FORM - -.TP -.B \ sisu \ \-F -\ generates \ a \ sample \ search \ form, \ which \ must \ be \ copied \ to \ -the \ web\-server \ cgi \ directory \ - -.TP -.B \ sisu \ \-F \ \-\-webserv\-webrick -\ generates \ a \ sample \ search \ form \ for \ use \ with \ the \ webrick \ -server, \ which \ must \ be \ copied \ to \ the \ web\-server \ cgi \ directory -\ - -.TP -.B \ sisu \ \-Fv -\ as \ above, \ and \ provides \ some \ information \ on \ setting \ up \ -hyperestraier \ - -.TP -.B \ sisu \ \-W -\ starts \ the \ webrick \ server \ which \ should \ be \ available \ -wherever \ sisu \ is \ properly \ installed \ - -.BR -The generated search form must be copied manually to the webserver directory as -instructed - -.SH -6. HYPERESTRAIER -.BR - -.BR -See the documentation for hyperestraier: - -.BR - <http://hyperestraier.sourceforge.net/> - -.BR - /usr/share/doc/hyperestraier/index.html - -.BR - man estcmd - -.BR -on sisu_hyperestraier: - -.BR - man sisu_hyperestraier - -.BR - /usr/share/doc/sisu/sisu_markup/sisu_hyperestraier/index.html - -.BR -NOTE: the examples that follow assume that sisu output is placed in the -directory /home/ralph/sisu_www - -.BR -(A) to generate the index within the webserver directory to be indexed: - -.BR - estcmd gather \-sd \ [index \ name] \ [directory \ path \ to \ index] - -.BR -the following are examples that will need to be tailored according to your -needs: - -.BR - cd /home/ralph/sisu_www - -.BR - estcmd gather \-sd casket /home/ralph/sisu_www - -.BR -you may use the \'find\' command together with \'egrep\' to limit indexing to -particular document collection directories within the web server directory: - -.BR - find /home/ralph/sisu_www \-type f | egrep - \'/home/ralph/sisu_www/sisu/.+?.html$\' |estcmd gather \-sd casket \- - -.BR -Check which directories in the webserver/output directory (~/sisu_www or -elsewhere depending on configuration) you wish to include in the search index. - -.BR -As sisu duplicates output in multiple file formats, it it is probably -preferable to limit the estraier index to html output, and as it may also be -desirable to exclude files \'plain.txt\', \'toc.html\' and -\'concordance.html\', as these duplicate information held in other html output -e.g. - -.BR - find /home/ralph/sisu_www \-type f | egrep - \'/sisu_www/(sisu|bookmarks)/.+?.html$\' | egrep \-v - \'(doc|concordance).html$\' |estcmd gather \-sd casket \- - -.BR -from your current document preparation/markup directory, you would construct a -rune along the following lines: - -.BR - find /home/ralph/sisu_www \-type f | egrep \'/home/ralph/sisu_www/([specify \ - first \ directory \ for \ inclusion]|[specify \ second \ directory \ for \ - inclusion]|[another \ directory \ for \ inclusion? \ \...])/.+?.html$\' | - egrep \-v \'(doc|concordance).html$\' |estcmd gather \-sd - /home/ralph/sisu_www/casket \- - -.BR -(B) to set up the search form - -.BR -(i) copy estseek.cgi to your cgi directory and set file permissions to 755: - -.BR - sudo cp \-vi /usr/lib/estraier/estseek.cgi /usr/lib/cgi\-bin - -.BR - sudo chmod \-v 755 /usr/lib/cgi\-bin/estseek.cgi - -.BR - sudo cp \-v /usr/share/hyperestraier/estseek.* /usr/lib/cgi\-bin - -.BR - \ [see \ estraier \ documentation \ for \ paths] - -.BR -(ii) edit estseek.conf, with attention to the lines starting \'indexname:\' and -\'replace:\': - -.BR - indexname: /home/ralph/sisu_www/casket - -.BR - replace: ^file:///home/ralph/sisu_www{{!}}http://localhost - -.BR - replace: /index.html?${{!}}/ - -.BR -(C) to test using webrick, start webrick: - -.BR - sisu \-W - -.BR -and try open the url: <http://localhost:8081/cgi\-bin/estseek.cgi> - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_search/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Search - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-08\-28 - -.BR -DC Date issued: -.I 2002\-08\-28 - -.BR -DC Date available: -.I 2002\-08\-28 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_search._sst - -.BR -Filetype: -.I SiSU text insert 0.58 - -.BR -Sourcefile Digest, MD5(sisu_search._sst)= -.I c085c2eb6d68f1b7d50435f673ede407 - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:48 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - -.TP -.BI 1. -<http://www.postgresql.org/> - <http://advocacy.postgresql.org/> - <http://en.wikipedia.org/wiki/Postgresql> -.TP -.BI 2. -<http://www.hwaci.com/sw/sqlite/> - <http://en.wikipedia.org/wiki/Sqlite> -.TP -.BI 3. -<http://search.sisudoc.org> -.TP -.BI 4. -(which could be extended further with current back-end). As regards scaling -of the database, it is as scalable as the database (here Postgresql) and -hardware allow. -.TP -.BI 5. -of this feature when demonstrated to an IBM software innovations evaluator in -2004 he said to paraphrase: this could be of interest to us. We have large -document management systems, you can search hundreds of thousands of documents -and we can tell you which documents meet your search criteria, but there is no -way we can tell you without opening each document where within each your -matches are found. - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_search/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_search/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_search/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_search/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_search/sisu_search.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:52 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu diff --git a/man/man8/sisu_syntax_highlighting.8 b/man/man8/sisu_syntax_highlighting.8 deleted file mode 100644 index ab43f9ff..00000000 --- a/man/man8/sisu_syntax_highlighting.8 +++ /dev/null @@ -1,307 +0,0 @@ -.TH "sisu_syntax_highlighting" "1" "2007-09-16" "0.59.1" "SiSU" -.SH -SISU \- SYNTAX HIGHLIGHTING, -RALPH AMISSAH -.BR - -.SH -SISU SYNTAX HIGHLIGHTING -.BR - -.SH -1. EDITOR FILES, SYNTAX HIGHLIGHTING -.BR - -.BR -The directory: - -.BR - \./data/sisu/conf/editor\-syntax\-etc/ - -.BR - /usr/share/sisu/conf/editor\-syntax\-etc - -.BR -contains rudimentary sisu syntax highlighting files for: - -.BR -* (g)vim <http://www.vim.org> - -.BR - package: sisu\-vim - -.BR -status: largely done - -.BR - there is a vim syntax highlighting and folds component - -.BR -* gedit <http://www.gnome.org/projects/gedit> - -.BR -* gobby <http://gobby.0x539.de/> - -.BR - file: sisu.lang - -.BR -place in: - -.BR - /usr/share/gtksourceview\-1.0/language\-specs - -.BR -or - -.BR - ~/.gnome2/gtksourceview\-1.0/language\-specs - -.BR - status: very basic syntax highlighting - -.BR - comments: this editor features display line wrap and is used by Goby! - -.BR -* nano <http://www.nano\-editor.org> - -.BR - file: nanorc - -.BR -save as: - -.BR - ~/.nanorc - -.BR - status: basic syntax highlighting - -.BR - comments: assumes dark background; no display line\-wrap; does line breaks - -.BR -* diakonos (an editor written in ruby) <http://purepistos.net/diakonos> - -.BR -file: diakonos.conf - -.BR -save as: - -.BR - ~/.diakonos/diakonos.conf - -.BR -includes: - -.BR - status: basic syntax highlighting - -.BR -comments: assumes dark background; no display line\-wrap - -.BR -* kate & kwrite <http://kate.kde.org> - -.BR - file: sisu.xml - -.BR - place in: - -.BR - /usr/share/apps/katepart/syntax - -.BR - or - -.BR - ~/.kde/share/apps/katepart/syntax - -.BR - \ [settings::configure \ kate::{highlighting,filetypes}] - -.BR - \ [tools::highlighting::{markup,scripts}:: -.B \ SiSU -] - -.BR -* nedit <http://www.nedit.org> - -.BR - file: sisu_nedit.pats - -.BR - nedit \-import sisu_nedit.pats - -.BR - status: a very clumsy first attempt \ [not \ really \ done] - -.BR - comments: this editor features display line wrap - -.BR -* emacs <http://www.gnu.org/software/emacs/emacs.html> - -.BR - files: sisu\-mode.el - -.BR - to file ~/.emacs add the following 2 lines: - -.BR - (add\-to\-list \'load\-path \"/usr/share/sisu\-examples/config/syntax_hi\") - -.BR - (require \'sisu\-mode.el) - -.BR - \ [not \ done \ / \ not \ yet \ included] - -.BR -* vim & gvim <http://www.vim.org> - -.BR - files: - -.BR - package is the most comprehensive sisu syntax highlighting and editor - environment provided to date (is for vim/ gvim, and is separate from the - contents of this directory) - -.BR - status: this includes: syntax highlighting; vim folds; some error checking - -.BR - comments: this editor features display line wrap - -.BR -NOTE: - -.BR -[ -.B \ SiSU -\ parses \ files \ with \ long \ lines \ or \ line \ breaks, \ but, \ display -\ linewrap \ (without \ line\-breaks) \ is \ a \ convenient \ editor \ feature -\ to \ have \ for \ sisu \ markup] - -.SH -DOCUMENT INFORMATION (METADATA) -.BR - -.SH -METADATA -.BR - -.BR -Document Manifest @ -<http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/sisu_manifest.html> - -.BR -.B Dublin Core -(DC) - -.BR -.I DC tags included with this document are provided here. - -.BR -DC Title: -.I SiSU \- Syntax Highlighting - -.BR -DC Creator: -.I Ralph Amissah - -.BR -DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL -3 - -.BR -DC Type: -.I information - -.BR -DC Date created: -.I 2002\-11\-12 - -.BR -DC Date issued: -.I 2002\-11\-12 - -.BR -DC Date available: -.I 2002\-11\-12 - -.BR -DC Date modified: -.I 2007\-09\-16 - -.BR -DC Date: -.I 2007\-09\-16 - -.BR -.B Version Information - -.BR -Sourcefile: -.I sisu_syntax_highlighting.sst - -.BR -Filetype: -.I SiSU text insert 0.58 - -.BR -Sourcefile Digest, MD5(sisu_syntax_highlighting.sst)= -.I 28dd0275c6fcd67bbedcd8aee9df4b3e - -.BR -Skin_Digest: -MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 - -.BR -.B Generated - -.BR -Document (metaverse) last generated: -.I Tue Sep 25 02:54:46 +0100 2007 - -.BR -Generated by: -.I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) - -.BR -Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] - - -.TP -Other versions of this document: -.TP -manifest: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_manifest.html> -.TP -html: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/toc.html> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/portrait.pdf> -.TP -pdf: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/landscape.pdf> -." .TP -." manpage: http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_syntax_highlighting.1 -.TP -at: <http://www.jus.uio.no/sisu> -.TP -.TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) -.TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] -.TP -* Last Generated on: Tue Sep 25 02:54:51 +0100 2007 -.TP -* SiSU http://www.jus.uio.no/sisu |