From 7475e34f316cb15b880c4f257c19ca5f84bc1c33 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Fri, 28 Sep 2007 21:31:24 +0100 Subject: param parsing changed to multi-line (affects regex matching, watch); manpage related changes, manpage header @man: added in param and used in manpage --- data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile | 3 ++- data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm | 6 ++++++ 2 files changed, 8 insertions(+), 1 deletion(-) (limited to 'data') 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/ -- cgit v1.2.3 From 8efb2177056fdce16abb8e73cd786ba380ba8279 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Fri, 28 Sep 2007 21:44:16 +0100 Subject: remove additional (auto-generated) manpages, re-evaluate each addition --- data/doc/sisu/html/sisu_commands.1.html | 553 -------- data/doc/sisu/html/sisu_configuration.1.html | 254 ---- data/doc/sisu/html/sisu_doc.7.html | 121 -- data/doc/sisu/html/sisu_faq.8.html | 273 ---- data/doc/sisu/html/sisu_help.1.html | 213 --- data/doc/sisu/html/sisu_help_sources.1.html | 582 -------- data/doc/sisu/html/sisu_howto.8.html | 1447 -------------------- data/doc/sisu/html/sisu_markup.1.html | 1113 --------------- data/doc/sisu/html/sisu_quickstart.8.html | 332 ----- data/doc/sisu/html/sisu_remote.8.html | 189 --- data/doc/sisu/html/sisu_search.8.html | 512 ------- data/doc/sisu/html/sisu_skin.1.html | 162 --- data/doc/sisu/html/sisu_syntax_highlighting.8.html | 219 --- 13 files changed, 5970 deletions(-) delete mode 100644 data/doc/sisu/html/sisu_commands.1.html delete mode 100644 data/doc/sisu/html/sisu_configuration.1.html delete mode 100644 data/doc/sisu/html/sisu_doc.7.html delete mode 100644 data/doc/sisu/html/sisu_faq.8.html delete mode 100644 data/doc/sisu/html/sisu_help.1.html delete mode 100644 data/doc/sisu/html/sisu_help_sources.1.html delete mode 100644 data/doc/sisu/html/sisu_howto.8.html delete mode 100644 data/doc/sisu/html/sisu_markup.1.html delete mode 100644 data/doc/sisu/html/sisu_quickstart.8.html delete mode 100644 data/doc/sisu/html/sisu_remote.8.html delete mode 100644 data/doc/sisu/html/sisu_search.8.html delete mode 100644 data/doc/sisu/html/sisu_skin.1.html delete mode 100644 data/doc/sisu/html/sisu_syntax_highlighting.8.html (limited to 'data') 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 @@ - - - - - -"sisu_commands"("1") manual page - - -Table of Contents

-SISU - COMMANDS, RALPH AMISSAH -

SISU COMMANDS -

1. COMMANDS SUMMARY -

1.1 - -

SYNOPSIS -

SiSU - Structured information, Serialized Units - a document publishing - -

system -

sisu  [  -abcDdFHhIiMmNnopqRrSsTtUuVvwXxYyZz0-9  ]  [  filename/ -

sisu - [  -Ddcv  ]  [  instruction  ] -

sisu  [  -CcFLSVvW  ] -

Note: commands should be -issued from within the directory that contains the marked up files, cd -to markup directory. -

1.2 DESCRIPTION -

SiSU 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 ( structure -information. For more see: <http://www.jus.uio.no/sisu -> -

1.3 DOCUMENT PROCESSING - -

COMMAND FLAGS -

-

- -
 -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) -

- -
 -b   [filename/wildcard]
-
produces xhtml/XML -output for browser viewing (sax parsing). -

- -
 -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. -

- -
 -CC
-
 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 -

- -
 -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). -

- -
 -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. -

- -
 -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. -

- -
 -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 -

- -
 -H   [filename/wildcard]
-
produces html -without link suffixes (.html .pdf etc.) ( an appropriately configured web -server.  [behaviour  switched  after  0.35  see  -h]. -

- -
 -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 -

- -
 -I   [filename/wildcard] -
-
produces texinfo and info file, (view with pinfo). -

- -
 -L
-
 prints  license  information. - -

- -
 -M   [filename/wildcard/url]
-
maintenance mode files created for processing -preserved and their locations indicated. (also see -V) -

- -
 -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 -

- -
 -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. -

- -
 -n -  [filename/wildcard/url]
-
skip meta-markup (building of -m which is otherwise -assumed by most processing flags. -

- -
 -o   [filename/wildcard/url]
-
output basic -document in opendocument file format (opendocument.odt). -

- -
 -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). -

- -
 -q   [filename/wildcard] -
-
quiet less output to screen. -

- -
 -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 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 -

- -
 -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 -

- -
 -S
-
 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). -

- -
 -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. 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 - -

- -
 -s   [filename/wildcard]
-
copies sisu markup file to output directory. -

- -
 -t   [filename/wildcard - (*.termsheet.rb)]
-
standard form document builder, preprocessing feature -

-

- -
 -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 -

- -
 -u   [filename/wildcard] -
-
provides url mapping of output files for the flags requested for processing, - -

also see -U -

- -
 -V
-
 on  its  own,  provides  SiSU  version  and  environment  information - (sisu  --help  env) -

- -
 -V   [filename/wildcard]
-
even more verbose than the -v flag. -(also see -M) -

- -
 -v
-
 on  its  own,  provides  SiSU  version  information -

- -
 -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 -

- -
 -W
-
 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  ]. -

- -
 -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) -

- -
 -X   [filename/wildcard]
-
produces -XML output with deep document structure, in the nature of dom. -

- -
 -x   [filename/wildcard] -
-
produces XML output shallow structure (sax parsing). -

- -
 -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]) -

- -
 -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. -

- -
 -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. -

- -
 -z   [filename/wildcard]
-
produces php (zend)  [this  feature  is  disabled - for  the  time being] -

-
-2. COMMAND LINE MODIFIERS -

-

- -
 --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. -

- -
 --no-annotate
-
 strips  output  text  of - editor  endnotes[^*1] denoted by asterisk or dagger/plus sign -

- -
 --no-asterisk -
-
 strips  output  text  of  editor  endnotes[^*2] denoted by asterisk sign -

- -
 --no-dagger -
-
 strips  output  text  of  editor  endnotes[^+1] denoted by dagger/plus sign -

-

-
-3. DATABASE COMMANDS -

dbi - database interface -

-D or --pgsql set for postgresql --d or --sqlite default set for sqlite -d is modifiable with --db=[database  type - (pgsql  or  sqlite)] -

-

- -
 -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. -

- -
 -Dv - --import
-
  [filename/wildcard] imports data specified to postgresql db (rb.dbi) - [  -dv  --import  sqlite  equivalent] -

- -
 -Dv  --update
-
  [filename/wildcard] updates/imports -specified data to postgresql db (rb.dbi)  [  -dv  --update  sqlite  equivalent] - -

- -
 -D  --remove
-
  [filename/wildcard] removes specified data to postgresql db (rb.dbi) - [  -d  --remove  sqlite  equivalent] -

- -
 -D  --dropall
-
 kills  data &  indexes   [  -d  --dropall - sqlite  equivalent] -

The v in e.g. -Dv is for verbose output. -

-
-4. SHORTCUTS, -SHORTHAND FOR MULTIPLE FLAGS -

-

- -
 --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. -

- -
 -0  to  -5   [filename - or  wildcard]
-
Default shorthand mappings (note that the defaults can be -changed/configured in the sisurc.yml file): -

- -
 -0
-
 -mNhwpAobxXyYv   [this  is  the - default  action  run  when  no  i.e.  on  ’sisu   [filename]’] -

- -
 -1
-
 -mNHwpy  give,  i.e.  on - ’sisu   [filename]’] -

- -
 -2
-
 -mNHwpaoy give,  i.e.  on  ’sisu   [filename]’] -

- -
 -3
-
 -mNhwpAobxXyY - i.e.  on  ’sisu   [filename]’] -

- -
 -4
-
 -mNhwpAobxXDyY  --import  ’sisu   [filename]’] -

- -
 -5
-
 -mNhwpAobxXDyY - --update  ’sisu   [filename]’] -

add -v for verbose mode and -c for color, e.g. sisu --2vc  [filename  or wildcard] -

consider -u for appended url info or -v for - -

verbose output -

-
-4.0.1 COMMAND LINE WITH FLAGS - BATCH PROCESSING -

In the -data directory run sisu -mh filename or wildcard eg. cisg.sst documents. -

-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. -

DOCUMENT INFORMATION (METADATA) -

METADATA -

Document Manifest -@ <http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/sisu_manifest.html -> -

- Dublin Core (DC) -

DC tags included with this document are provided here. - -

DC Title: SiSU - Commands -

DC Creator: Ralph Amissah -

DC Rights: Copyright -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -

DC -Type: information -

DC Date created: 2002-08-28 -

DC Date issued: 2002-08-28 - -

DC Date available: 2002-08-28 -

DC Date modified: 2007-09-16 -

DC Date: 2007-09-16 - -

Version Information -

Sourcefile: sisu_commands.sst -

Filetype: SiSU text - -

0.58 -

Sourcefile Digest, MD5(sisu_commands.sst)= 68a4087f984baffbea779da25e1b6141 - -

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)= - -

20fc43cf3eb6590bc3399a1aef65c5a9 -

Generated -

Document (metaverse) last -generated: Mon Sep 24 15:36:13 +0100 2007 -

Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

-

- -
*1.
-
square brackets
- -
*2.
-
square brackets
- -
+1.
-
square brackets -

-

- -
Other versions of this document:
-
- -
manifest: <http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html - -> -
-
- -
html: <http://www.jus.uio.no/sisu/sisu_commands/toc.html - ->
-
- -
pdf: <http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf - -> -
-
- -
pdf: <http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf - ->
-
- -
at: <http://www.jus.uio.no/sisu - -> -
-
- -
* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
-
- -
* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-
- -
* Last Generated on: Mon Sep 24 -15:36:30 +0100 2007
-
- -
* SiSU http://www.jus.uio.no/sisu -
-
-
-

- - 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 @@ - - - - - -"sisu_configuration"("1") manual page - - -Table of Contents

-SISU - CONFIGURATION, RALPH AMISSAH -

CONFIGURATION OF ENVIRONMENT -

1. CONFIGURATION - -

1.1 DETERMINING THE CURRENT CONFIGURATION -

Information on the current -configuration of SiSU should be available with the help command: -

sisu --v
- -

which is an alias for: -

sisu --help env
- -

Either of these should be executed from within a directory that contains -sisu markup source documents. -

1.2 CONFIGURATION FILES (CONFIG.YML) -

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. -

The SiSU configuration file is a yaml file, which -means indentation is significant. -

SiSU resource configuration is determined -by looking at the following files if they exist: -

./_sisu/sisurc.yml
- -

~/.sisu/sisurc.yml
- -

/etc/sisu/sisurc.yml
- -

The search is in the order listed, and the first one found is used. -

- In the absence of instructions in any of these it falls back to the internal -program defaults. -

Configuration determines the output and processing directories -and the database access details. -

If SiSU is installed a sample sisurc.yml - -

may be found in /etc/sisu/sisurc.yml -

CONFIGURATION OF DOCUMENTS -

2. SKINS - -

Skins modify the default appearance of document output on a document, -directory, or site wide basis. Skins are looked for in the following locations: - -

./_sisu/skin
- -

~/.sisu/skin
- -

/etc/sisu/skin
- -

Within the skin directory are the following the default sub-directories -for document skins: -

./skin/doc
- -

./skin/dir
- -

./skin/site
- -

A skin is placed in the appropriate directory and the file named skin_[name].rb - -

The skin itself is a ruby file which modifies the default appearances -set in the program. -

2.1 DOCUMENT SKIN -

Documents take on a document skin, -if the header of the document specifies a skin to be used. -

-


-

  @skin: skin_united_nations
-
-

2.2 DIRECTORY SKIN -

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). -

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. - -

2.3 SITE SKIN -

A site skin, modifies the program default skin. -

2.4 SAMPLE - -

SKINS -

With SiSU installed sample skins may be found in: -

/etc/sisu/skin/doc -and
- /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc
- -

(or equivalent directory) and if sisu-markup-samples is installed also -under: -

/usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc
- -

Samples of list.yml and promo.yml (which are used to create the right -column list) may be found in: -

/usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml -(or equivalent
- directory)
- -

3. HOMEPAGES -

SiSU is about the ability to auto-generate documents. Home -pages are regarded as custom built items, and are not created by SiSU -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: -

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) - -

2. through providing what you want as the home page in a skin, -

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. -

3.1 HOME PAGE AND OTHER CUSTOM BUILT - -

PAGES IN A SUB-DIRECTORY -

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: -

sisu -CC
- -

3.2 HOME PAGE WITHIN A SKIN -

Skins are described in a separate section, -but basically are a file written in the programming language 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. -

- 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 -

-


-

    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
-
-

DOCUMENT INFORMATION (METADATA) -

METADATA -

Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/sisu_manifest.html -> - -

Dublin Core (DC) -

DC tags included with this document are provided here. - -

DC Title: SiSU - Configuration -

DC Creator: Ralph Amissah -

DC Rights: - -

Ralph Amissah -

DC Type: information -

DC Date created: 2002-08-28 -

DC Date -issued: 2002-08-28 -

DC Date available: 2007-08-28 -

DC Date modified: 2007-08-30 - -

DC Date: 2007-08-30 -

Version Information -

Sourcefile: sisu_configuration._sst - -

Filetype: SiSU text insert 0.58 -

Sourcefile Digest, MD5(sisu_configuration._sst)= - -

491d3da039162d60ae0e2951aa260915 -

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)= - -

20fc43cf3eb6590bc3399a1aef65c5a9 -

Generated -

Document (metaverse) last -generated: Mon Sep 24 15:36:17 +0100 2007 -

Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

-

-

- -
Other versions of this document:
-
- -
manifest: <http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html - -> -
-
- -
html: <http://www.jus.uio.no/sisu/sisu_configuration/toc.html - ->
-
- -
pdf: <http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf - -> -
-
- -
pdf: <http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf - ->
-
- -
at: <http://www.jus.uio.no/sisu - -> -
-
- -
* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
-
- -
* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-
- -
* Last Generated on: Mon Sep 24 -15:36:32 +0100 2007
-
- -
* SiSU http://www.jus.uio.no/sisu -
-
-
-

- - 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 @@ - - - - - -"sisu_doc"("1") manual page - - -Table of Contents

-SISU - SISU-DOC, RALPH AMISSAH -

SISU DOC -

SISU-DOC -

1.1 NAME -

SiSU - Structured -information, Serialized Units - a document publishing system. -

Information - -

related to sisu documentation -

1.2 DESCRIPTION -

sisu documentation is installed - -

in /usr/share/doc/sisu/sisu_manual or equivalent directory -

file:///usr/share/doc/sisu/sisu_manual - -

file:///usr/share/doc/sisu/sisu_manual/sisu_manual/ -

<http://www.jus.uio.no/sisu/sisu_manual -> - -

<http://www.sisudoc.org/sisu_manual -> -

DOCUMENT INFORMATION (METADATA) -

METADATA - -

Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_doc/sisu_manifest.html -> - -

Dublin Core (DC) -

DC tags included with this document are provided here. - -

DC Title: SiSU - sisu-doc -

DC Creator: Ralph Amissah -

DC Rights: Copyright -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -

DC -Type: information -

DC Date created: 2007-09-24 -

DC Date issued: 2007-09-24 - -

DC Date available: 2007-09-24 -

DC Date modified: 2007-09-24 -

DC Date: 2007-09-24 - -

Version Information -

Sourcefile: sisu_doc.sst -

Filetype: SiSU text 0.58 - -

Sourcefile Digest, MD5(sisu_doc.sst)= 00116fb664a23c87ce52dbe0d4c5a702 - -

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)= - -

20fc43cf3eb6590bc3399a1aef65c5a9 -

Generated -

Document (metaverse) last -generated: Mon Sep 24 15:36:19 +0100 2007 -

Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

-

-

- -
Other versions of this document:
-
- -
manifest: <http://www.jus.uio.no/sisu/sisu_doc/sisu_manifest.html - -> -
-
- -
html: <http://www.jus.uio.no/sisu/sisu_doc/toc.html - ->
-
- -
pdf: <http://www.jus.uio.no/sisu/sisu_doc/portrait.pdf - -> -
-
- -
pdf: <http://www.jus.uio.no/sisu/sisu_doc/landscape.pdf - ->
-
- -
at: <http://www.jus.uio.no/sisu - -> -
-
- -
* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
-
- -
* Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-
- -
* Last Generated on: Mon Sep 24 -15:36:32 +0100 2007
-
- -
* SiSU http://www.jus.uio.no/sisu -
-
-
-

- - 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 @@ - - - - - -"sisu_faq"("1") manual page - - -Table of Contents

-SISU - FAQ - FREQUENTLY ASKED/ANSWERED QUESTIONS, RALPH AMISSAH -

1. FAQ - -FREQUENTLY ASKED/ANSWERED QUESTIONS -

1.1 WHY ARE URLS PRODUCED WITH THE --V (AND -U) FLAG THAT POINT TO A WEB SERVER ON PORT 8081? -

Try the following -rune: -

* sisu -W -

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. -

1.2 I CANNOT FIND MY OUTPUT, WHERE IS IT? -

The following -should provide help on output paths: -

* sisu --help env -

* sisu -V  [same - as  the  previous  command] -

* sisu --help directory -

* sisu --help path -

* -sisu -U  [filename] -

* man sisu -

1.3 I DO NOT GET ANY PDF OUTPUT, WHY? -

-SiSU produces LaTeX and pdflatex is run against that to generate pdf files. - -

If you use Debian the following will install the required dependencies - -

* aptitude install sisu-pdf -

the following packages are required: tetex-bin, -tetex-extra, latex-ucs -

1.4 WHERE IS THE LATEX (OR SOME OTHER INTERIM) OUTPUT? - -

Try adding -M (for maintenance) to your command flags, e.g.: -

* sisu -HpMv - [filename] -

this should result in the interim processing output being -retained, and information being provided on where to find it. -

* sisu --help - -

directory -

* sisu --help path -

should also provide some relevant information -as to where it is placed. -

1.5 WHY ISN’T SISU MARKUP XML -

I worked with text -and (though I find XML immensely valuable) disliked noise ... better to sidestep -the question and say: -

SiSU currently accurately, converts from three -forms of XML to native 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 SiSU - -

VERSION CONVERSION -

sisu --to-sax  [filename/wildcard]
- -

sisu --to-dom  [filename/wildcard]
- -

sisu --to-node  [filename/wildcard]
- -

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  SiSU  markup]. -

sisu --from-xml2sst  [filename/wildcard]
- -

1.6 LATEX CLAIMS TO BE A DOCUMENT PREPARATION SYSTEM FOR HIGH-QUALITY TYPESETTING. -CAN THE SAME BE SAID ABOUT SISU? -

SiSU is not really about type-setting. - -

LaTeX is the ultimate computer instruction type-setting language for paper -based publication. -

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. -

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. - -

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 populates an SQL database in a useful way with the document -in object sized chunks and its meta-data. But 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. - -

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. -

Where there are large document sets, it provides -consistency in appearance in each output format for the documents. -

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 -SiSU tries to achieve this from minimal markup. -

1.7 HOW DO I CREATE GIN - -

OR GIST INDEX IN POSTGRESQL FOR USE IN SISU -

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: - -

I have tsearch2 slides which introduces tsearch2 <http://www.sai.msu.su/~megera/wiki/tsearch2slides -> - -

FTS in PostgreSQL is provided by tsearch2, which should works without -any indices (GiST or GIN) ! Indices provide performance, not functionality. - -

In your example I’d do ( simple way, just for demo): -

0. compile, install - -

tsearch2 and load tsearch2 into your database -

cd contrib/tsearch2; -make&&make&&install&&make installcheck; psql DB &lt;
- tsearch2.sql
- -

1. Add column fts, which holds tsvector -

alter table documents add -column fts tsvector;
- -

2. Fill fts column -

update document set fts = to_tsvector(clean);
- -

3. create index - just for performance ! -

create index fts_gin_idx -on document using gin(fts);
- -

4. Run vacuum -

vacuum analyze document;
- -

That’s all. -

Now you can search: -

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; -

1.8 WHERE IS VERSION 1.0? -

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. -

The feature set for html,[^1] LaTeX/pdf -and opendocument is in place. XML, and plaintext are in order. -

html and - -

LaTeX/pdf may be regarded as reference copy outputs -

With regard to the -populating of sql databases (postgresql and sqlite), there is a bit to -be done. -

We are still almost there. -

DOCUMENT INFORMATION (METADATA) -

-METADATA -

Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/sisu_manifest.html -> - -

Dublin Core (DC) -

DC tags included with this document are provided here. - -

DC Title: SiSU - FAQ - Frequently Asked/Answered Questions -

DC Creator: - -

Ralph Amissah -

DC Rights: Copyright (C) Ralph Amissah 2007, part of SiSU -documentation, License GPL 3 -

DC Type: information -

DC Date created: - -

2006-09-06 -

DC Date available: 2006-09-06 -

DC Date issued: 2006-09-06 -

DC -Date modified: 2007-09-16 -

DC Date: 2007-09-16 -

Version Information -

Sourcefile: - -

sisu_faq.sst -

Filetype: SiSU text 0.57 -

Sourcefile Digest, MD5(sisu_faq.sst)= - -

41577c9fc063cd232914a1a11a59e91a -

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)= - -

20fc43cf3eb6590bc3399a1aef65c5a9 -

Generated -

Document (metaverse) last -generated: Mon Sep 24 15:36:17 +0100 2007 -

Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

-

    -.
  1. html w3c compliance has been largely met. -

    - -

    Other versions of -this document:
    -
    - -
    manifest: <http://www.jus.uio.no/sisu/sisu_faq/sisu_manifest.html - -> -
    -
    - -
    html: <http://www.jus.uio.no/sisu/sisu_faq/toc.html - ->
    -
    - -
    pdf: <http://www.jus.uio.no/sisu/sisu_faq/portrait.pdf - -> -
    -
    - -
    pdf: <http://www.jus.uio.no/sisu/sisu_faq/landscape.pdf - ->
    -
    - -
    at: <http://www.jus.uio.no/sisu - -> -
    -
    - -
    * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
    -
    - -
    * Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
    -
    - -
    * Last Generated on: Mon Sep 24 -15:36:32 +0100 2007
    -
    - -
    * SiSU http://www.jus.uio.no/sisu -
    -
    - -

    - - 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 @@ - - - - - -"sisu_help"("1") manual page - - -Table of Contents

    -SISU - HELP, RALPH AMISSAH -

    SISU HELP -

    1. HELP -

    1.1 SISU MANUAL -

    The most -up to date information on sisu should be contained in the sisu_manual, -available at: -

    <http://www.jus.uio.no/sisu/sisu_manual/ ->
    - -

    and (from SiSU 0.59 onwards) installed locally at: -

    /usr/share/doc/sisu/sisu_manual/
    - -

    or equivalent directory -

    Within the SiSU tarball at: -

    ./data/doc/sisu/sisu_manual/
    - -

    1.2 SISU MAN PAGES -

    If SiSU is installed on your system usual man commands -should be available, try: -

    man sisu
    - -

    man sisu_markup
    - -

    man sisu_commands
    - -

    Most 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 SiSU tarball at: -

    ./data/doc/sisu/sisu_manual/
    - -

    Once installed, directory equivalent to: -

    /usr/share/doc/sisu/sisu_manual/
    - -

    Available man pages are converted back to html using man2html: -

    /usr/share/doc/sisu/html/
    - -

    ./data/doc/sisu/html/
    - -

    The SiSU man pages can be viewed online at:[^1] -

    An online version of -the sisu man page is available here: -

    * various sisu man pages <http://www.jus.uio.no/sisu/man/ -> - [^2] -

    * sisu.1 <http://www.jus.uio.no/sisu/man/sisu.1.html ->  [^3] -

    * sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8.html -> - [^4] -

    * sisu_examples.1 <http://www.jus.uio.no/sisu/man/sisu_examples.1.html ->  [^5] - -

    * sisu_webrick.1 <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html ->  [^6] -

    1.3 - -

    SISU BUILT-IN INTERACTIVE HELP -

    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. -

    sisu --help
    - -

    sisu --help  [subject]
    - -

    sisu --help env  [for  feedback  on  the  way  your  system  is
    - setup  with  regard  to  sisu]
    - -

    sisu -V  [same  as  above  command]
    - -

    sisu --help commands
    - -

    sisu --help markup
    - -

    Apart from real-time information on your current configuration the 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). -

    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. -

    1.4 HELP SOURCES -

    For lists of alternative help sources, -see: -

    man page -

    man sisu_help_sources
    - -

    man2html -

    /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html
    - -

    sisu generated html -

    /usr/share/doc/sisu/html/sisu_help_sources/index.html
    - -

    <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html ->
    - -

    <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html ->
    - -

    DOCUMENT INFORMATION (METADATA) -

    METADATA -

    Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/sisu_manifest.html -> - -

    Dublin Core (DC) -

    DC tags included with this document are provided here. - -

    DC Title: SiSU - Help -

    DC Creator: Ralph Amissah -

    DC Rights: Copyright -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -

    DC -Type: information -

    DC Date created: 2002-08-28 -

    DC Date issued: 2002-08-28 - -

    DC Date available: 2002-08-28 -

    DC Date modified: 2007-08-30 -

    DC Date: 2007-08-30 - -

    Version Information -

    Sourcefile: sisu_help.sst -

    Filetype: SiSU text - -

    0.58 -

    Sourcefile Digest, MD5(sisu_help.sst)= 66d04ba5f3dd4ede774ffa5549b3faba - -

    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)= - -

    20fc43cf3eb6590bc3399a1aef65c5a9 -

    Generated -

    Document (metaverse) last -generated: Mon Sep 24 15:36:13 +0100 2007 -

    Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

    Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

    -

      -.
    1. generated from source using rman <http://polyglotman.sourceforge.net/rman.html ->
      - With regard to
      - 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 ->
      -
    2. .
    3. <http://www.jus.uio.no/sisu/man/ ->
    4. .
    5. <http://www.jus.uio.no/sisu/man/sisu.1.html ->
    6. .
    7. <http://www.jus.uio.no/sisu/man/sisu.8.html -> -
    8. .
    9. <http://www.jus.uio.no/sisu/man/sisu_examples.1.html ->
    10. .
    11. <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html -> - -

      - -

      Other versions of this document:
      -
      - -
      manifest: <http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html - -> -
      -
      - -
      html: <http://www.jus.uio.no/sisu/sisu_help/toc.html - ->
      -
      - -
      pdf: <http://www.jus.uio.no/sisu/sisu_help/portrait.pdf - -> -
      -
      - -
      pdf: <http://www.jus.uio.no/sisu/sisu_help/landscape.pdf - ->
      -
      - -
      at: <http://www.jus.uio.no/sisu - -> -
      -
      - -
      * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
      -
      - -
      * Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
      -
      - -
      * Last Generated on: Mon Sep 24 -15:36:30 +0100 2007
      -
      - -
      * SiSU http://www.jus.uio.no/sisu -
      -
      - -

      - - 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 @@ - - - - - -"sisu_help_sources"("1") manual page - - -Table of Contents

      -SISU - REFERENCES, RALPH AMISSAH -

      SISU HELP SOURCES -

      1. HELP SOURCES -

      - For a summary of alternative ways to get help on SiSU try one of the following: - -

      man page -

      man sisu_help
      - -

      man2html -

      <file:///usr/share/doc/sisu/html/sisu_help.1.html>
      - -

      <http://www.jus.uio.no/sisu/man/sisu_help.1.html ->
      - -

      sisu generated output - links to html -

      <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html>
      - -

      <http://sisudoc.org/sisu_manual/sisu_help/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html ->
      - -

      help sources lists -

      Alternative sources for this help sources page -listed here: -

      man sisu_help_sources
      - -

      <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html>
      - -

      <file:///usr/share/doc/sisu/html/sisu_help_sources/index.html>
      - -

      <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html ->
      - -

      1.1 MAN PAGES -

      1.1.1 MAN -

      man sisu
      - -

      man sisu_commands
      - -

      man 7 sisu_complete
      - -

      man sisu_configuration
      - -

      man 8 sisu_faq
      - -

      man sisu_filetypes
      - -

      man sisu_help
      - -

      man sisu_help_sources
      - -

      man 8 sisu_howto
      - -

      man sisu_introduction
      - -

      man sisu_markup
      - -

      man sisu_output_overview
      - -

      man 7 sisu_pdf
      - -

      man 7 sisu_postgresql
      - -

      man 8 sisu_quickstart
      - -

      man 8 sisu_remote
      - -

      man 8 sisu_search
      - -

      man sisu_skin
      - -

      man 7 sisu_sqlite
      - -

      man 8 sisu_syntax_highlighting
      - -

      man 7 sisu_vim
      - -

      man sisu_webrick
      - -

      1.2 SISU GENERATED OUTPUT - LINKS TO HTML -

      Note SiSU documentation is -prepared in 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] -

      1.2.1 LOCALLY INSTALLED -

      <file:///usr/share/doc/sisu/sisu_manual/sisu_manual/index.html> - -

      <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html> -

      <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html> - -

      /usr/share/doc/sisu/sisu_manual/sisu/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_commands/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_configuration/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_description/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_examples/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_faq/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_filetypes/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_help/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_howto/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_introduction/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_manual/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_markup/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_output_overview/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_pdf/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_postgresql/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_quickstart/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_remote/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_search/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_skin/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_vim/index.html
      - -

      /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html
      - -

      1.2.2 WWW.SISUDOC.ORG -

      <http://sisudoc.org/sisu_manual/sisu_manual/index.html -> - -

      <http://sisudoc.org/sisu_manual/sisu/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_commands/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_complete/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_configuration/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_description/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_examples/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_faq/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_filetypes/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_help/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_howto/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_introduction/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_manual/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_markup/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_output_overview/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_pdf/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_postgresql/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_quickstart/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_remote/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_search/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_skin/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_sqlite/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_vim/index.html ->
      - -

      <http://sisudoc.org/sisu_manual/sisu_webrick/index.html ->
      - -

      1.2.3 WWW.JUS.UIO.NO/SISU -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html -> - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html ->
      - -

      <http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html ->
      - -

      1.2.4 MAN2HTML -

      1.2.5 LOCALLY INSTALLED -

      <file:///usr/share/doc/sisu/html/sisu_manual.1.html> - -

      <file:///usr/share/doc/sisu/html/sisu_help.1.html> -

      <file:///usr/share/doc/sisu/html/sisu_help_sources.1.html> - -

      /usr/share/doc/sisu/html/sisu.1.html
      - -

      /usr/share/doc/sisu/html/sisu_commands.1.html
      - -

      /usr/share/doc/sisu/html/sisu_complete.7.html
      - -

      /usr/share/doc/sisu/html/sisu_configuration.1.html
      - -

      /usr/share/doc/sisu/html/sisu_faq.8.html
      - -

      /usr/share/doc/sisu/html/sisu_help.1.html
      - -

      /usr/share/doc/sisu/html/sisu_help_sources.1.html
      - -

      /usr/share/doc/sisu/html/sisu_howto.8.html
      - -

      /usr/share/doc/sisu/html/sisu_markup.1.html
      - -

      /usr/share/doc/sisu/html/sisu_pdf.7.html
      - -

      /usr/share/doc/sisu/html/sisu_postgresql.7.html
      - -

      /usr/share/doc/sisu/html/sisu_quickstart.8.html
      - -

      /usr/share/doc/sisu/html/sisu_remote.8.html
      - -

      /usr/share/doc/sisu/html/sisu_search.8.html
      - -

      /usr/share/doc/sisu/html/sisu_skin.1.html
      - -

      /usr/share/doc/sisu/html/sisu_sqlite.7.html
      - -

      /usr/share/doc/sisu/html/sisu_syntax_highlighting.8.html
      - -

      /usr/share/doc/sisu/html/sisu_vim.7.html
      - -

      /usr/share/doc/sisu/html/sisu_webrick.1.html
      - -

      1.2.6 WWW.SISUDOC.ORG -

      <http:///sisudoc.org/man/sisu_manual.1.html -> -

      <http:///sisudoc.org/man/sisu_help.1.html -> - -

      <http:///sisudoc.org/man/sisu_help_sources.1.html -> -

      <http://sisudoc.org/man/sisu.1.html ->
      - -

      <http://sisudoc.org/man/sisu_commands.1.html ->
      - -

      <http://sisudoc.org/man/sisu_complete.7.html ->
      - -

      <http://sisudoc.org/man/sisu_configuration.1.html ->
      - -

      <http://sisudoc.org/man/sisu_faq.8.html ->
      - -

      <http://sisudoc.org/man/sisu_help.1.html ->
      - -

      <http://sisudoc.org/man/sisu_help_sources.1.html ->
      - -

      <http://sisudoc.org/man/sisu_howto.8.html ->
      - -

      <http://sisudoc.org/man/sisu_markup.1.html ->
      - -

      <http://sisudoc.org/man/sisu_pdf.7.html ->
      - -

      <http://sisudoc.org/man/sisu_postgresql.7.html ->
      - -

      <http://sisudoc.org/man/sisu_quickstart.8.html ->
      - -

      <http://sisudoc.org/man/sisu_remote.8.html ->
      - -

      <http://sisudoc.org/man/sisu_search.8.html ->
      - -

      <http://sisudoc.org/man/sisu_skin.1.html ->
      - -

      <http://sisudoc.org/man/sisu_sqlite.7.html ->
      - -

      <http://sisudoc.org/man/sisu_syntax_highlighting.8.html ->
      - -

      <http://sisudoc.org/man/sisu_vim.7.html ->
      - -

      <http://sisudoc.org/man/sisu_webrick.1.html ->
      - -

      1.2.7 WWW.JUS.UIO.NO/SISU -

      <http://www.jus.uio.no/sisu/man/sisu_manual.1.html -> -

      - <http://www.jus.uio.no/sisu/man/sisu_help.1.html -> -

      <http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html -> - -

      <http://www.jus.uio.no/sisu/man/sisu.1.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_commands.1.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_complete.7.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_configuration.1.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_faq.8.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_help.1.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_howto.8.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_markup.1.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_pdf.7.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_remote.8.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_search.8.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_skin.1.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_vim.7.html ->
      - -

      <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html ->
      - -

      DOCUMENT INFORMATION (METADATA) -

      METADATA -

      Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/sisu_manifest.html -> - -

      Dublin Core (DC) -

      DC tags included with this document are provided here. - -

      DC Title: SiSU - References -

      DC Creator: Ralph Amissah -

      DC Rights: Copyright -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -

      DC -Type: information -

      DC Date created: 2002-11-12 -

      DC Date issued: 2002-11-12 - -

      DC Date available: 2002-11-12 -

      DC Date modified: 2007-09-16 -

      DC Date: 2007-09-16 - -

      Version Information -

      Sourcefile: sisu_help_sources.sst -

      Filetype: SiSU - -

      text insert 0.58 -

      Sourcefile Digest, MD5(sisu_help_sources.sst)= ff6812b3008391d7a20d777bbbeb3ec1 - -

      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)= - -

      20fc43cf3eb6590bc3399a1aef65c5a9 -

      Generated -

      Document (metaverse) last -generated: Mon Sep 24 15:36:13 +0100 2007 -

      Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

      Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

      -

        -.
      1. named index.html or more extensively through sisu_manifest.html - -

        - -

        Other versions of this document:
        -
        - -
        manifest: <http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html - -> -
        -
        - -
        html: <http://www.jus.uio.no/sisu/sisu_help_sources/toc.html - ->
        -
        - -
        pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf - -> -
        -
        - -
        pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf - ->
        -
        - -
        at: <http://www.jus.uio.no/sisu - -> -
        -
        - -
        * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
        -
        - -
        * Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
        -
        - -
        * Last Generated on: Mon Sep 24 -15:36:30 +0100 2007
        -
        - -
        * SiSU http://www.jus.uio.no/sisu -
        -
        - -

        - - 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 @@ - - - - - -"sisu_howto"("1") manual page - - -Table of Contents

        -SISU - TECHNICAL, HOWTO, RALPH AMISSAH -

        SISU SOME TECHNICAL INFORMATION - -

        HOWTO -

        1. GETTING HELP -

        An online manual of sorts should be available -at: -

        <http://www.jus.uio.no/sisu_manual/ -> -

        The manual pages provided with -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. -

        1.1 SISU -

        If SiSU is installed on your system usual man -commands should be available, try: -

        man sisu -

        The SiSU man pages can -be viewed online at:[^1] -

        An online version of the sisu man page is available -here: -

        * various sisu man pages <http://www.jus.uio.no/sisu/man/ ->  [^2] -

        * sisu.1 -<http://www.jus.uio.no/sisu/man/sisu.1.html ->  [^3] -

        * sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8.html -> - [^4] -

        * sisu_examples.1 <http://www.jus.uio.no/sisu/man/sisu_examples.1.html ->  [^5] - -

        * sisu_webrick.1 <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html ->  [^6] -

        1.2 - -

        SISU BUILT-IN HELP -

        sisu --help
        - -

        sisu --help  [subject]
        - -

        sisu --help env  [for  feedback  on  the  way  your  system  is
        - setup  with  regard  to  sisu]
        - -

        sisu -V  [same  as  above  command]
        - -

        sisu --help commands
        - -

        sisu --help markup
        - -

        1.3 COMMAND LINE WITH FLAGS - BATCH PROCESSING -

        Running sisu (alone without -any flags, filenames or wildcards) brings up the interactive help, as does -any sisu command that is not recognised. -

        In the data directory run sisu --mh filename or wildcard eg. cisg.sst documents. -

        2. SETUP, INITIALISATION - -

        2.1 INITIALISE OUTPUT DIRECTORY -

        Images, css files for a document directory -are copied to their respective locations in the output directory. -

        while -within your document markup/preparation directory, issue the following - -

        command -

        sisu -CC
        - -

        2.1.1 USE OF SEARCH FUNCTIONALITY, AN EXAMPLE USING SQLITE -

        SiSU can populate -PostgreSQL and Sqlite databases and provides a sample search form for querying -these databases. -

        This note provides an example to get you started and - -

        will use sqlite -

        It is necessary to: -

        (1) make sure the required dependencies - -

        have been installed -

        (2) have a directory with sisu markup samples that - -

        is writable -

        (3) use sisu to create a database -

        (4) use sisu tp populate - -

        a database -

        (5) use sisu to start the webrick (httpd) server -

        (6) use - -

        sisu to create a search form -

        (7) copy the search form to the cgi directory - -

        (8) open up the form in your browser -

        (9) query the database using the - -

        search form -

        (1) make sure the required dependencies have been installed - -

        if you use Debian , the following command will install the required dependencies - -

        aptitude install sisu-sqlite -

        (2) have a directory with sisu markup samples - -

        that is writable -

        ideally copy the sisu-examples directory to your home -directory (because the directory in which you run this example should be -writable) -

        cp -rv /usr/share/sisu-examples/sample/document_samples_sisu_markup -~/. -

        (3) use sisu to create an sqlite database -

        within the sisu-examples - -

        directory -

        sisu -dv createall -

        (4) use sisu tp populate a database with - -

        some text -

        within the sisu-examples directory -

        sisu -div free_*.sst -

        or - -

        sisu -dv import free_*.sst debian_constitution_v1.2.sst debian_social_contract_v1.1.sst - -

        gpl2.fsf.sst -

        (5) use sisu to start the webrick (httpd) server (if it has -not already been started): -

        sisu -W -

        (6) use sisu to create a search form -(for use with the webrick server, and your sample documents) -

        within the - -

        sisu-examples directory -

        sisu -F webrick -

        #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 -

        #now this -should be possible: sisu -F webrick -

        (7) copy the search form to the cgi - -

        directory -

        the string should be provided as output from the previous command - -

        sudo cp -vi /usr/share/sisu-examples/sample/document_samples_sisu_markup/sisu_sqlite.cgi - -

        /usr/lib/cgi-bin -

        sudo chmod -v 755 /usr/lib/cgi-bin/sisu_sqlite.cgi -

        (8) - -

        open up the form in your browser and query it -

        url: -

        <http://localhost:8081/cgi-bin/sisu_sqlite.cgi -> - -

        or as instructed by command sisu -F webrick -

        (9) query the database using - -

        the search form -

        if there are other options in the dropdown menu select - -

        document_samples_sisu_markup -

        and search for some text, e.g.: -

        aim OR - -

        project -

        * selecting the index radio button gives an index of results - -

        using the object numbers -

        * selecting the text radio button gives the - -

        content of the matched paragraphs with the match highlighted -

        (10) to - -

        start again with a new database -

        to start from scratch you can drop the - -

        database with the command -

        sisu -dv dropall -

        and go to step 3 -

        to get - -

        to step 3 in one step with a single command -

        sisu -dv recreate -

        continue - -

        subsequent steps -

        2.2 MISC -

        2.2.1 URL FOR OUTPUT FILES -U -U -

        sisu -uv[and - other  flags]  [filename/wildcard]
        - -

        sisu -Uv  [filename/wildcard]
        - -

        2.2.2 TOGGLE SCREEN COLOR -

        sisu -cv[and  processing  flags]  [filename/wildcard]
        - -

        2.2.3 VERBOSE MODE -

        sisu -v[and  processing  flags]  [filename/wildcard]
        - -

        sisu -V[and  processing  flags]  [filename/wildcard]
        - -

        2.2.4 QUIET MODE -

        sisu -q[and  processing  flags]  [filename/wildcard]
        - -

        2.2.5 MAINTENANCE MODE INTERMEDIATE FILES KEPT -M -

        sisu -Mv[and  other - flags]  [filename/wildcard]
        - -

        2.2.6 START THE WEBRICK SERVER -

        sisu -W
        - -

        2.3 REMOTE PLACEMENT OF OUTPUT -

        configuration is necessary -

        scp -

        -sisu -vr[and  processing  flags]  [filename/wildcard]
        - -

        rsync -

        sisu -vR[and  processing  flags]  [filename/wildcard]
        - -

        3. CONFIGURATION FILES -

        Sample provided, on untarring the source tarball: - -

        conf/sisu/sisurc.yaml
        - -

        and on installation under: -

        /etc/sisu/sisurc.yaml
        - -

        The following paths are searched: -

        ./_sisu/sisurc.yaml
        - -

        ~/.sisu/sisurc.yaml
        - -

        ./etc/sisu/sisurc.yaml
        - -

        4. MARKUP -

        See sample markup provided on -

        <http://www.jus.uio.no/sisu -> -

        - <http://www.jus.uio.no/sisu_markup -> -

        <http://www.jus.uio.no/sisu/SiSU -> -

        in particular -for each of the document output samples provided, the source document is - -

        provided as well -

        <http://www.jus.uio.no/sisu/SiSU/2#books -> -

        on untarring -the source tarball: -

        data/sisu-examples/sample/document_samples_sisu_markup/
        - -

        or the same once source is installed (or sisu-examples) under: -

        /usr/share/sisu-examples/sample/document_samples_sisu_markup/
        - -

        Some notes are contained within the man page, man sisu and within sisu - -

        help via the commands sisu help markup and sisu help headers -

        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: -

        4.1 HEADERS -

        Headers @headername: provide information related -to the document, this may relate to -

        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 -

        2. semantic information about the document including - -

        the dublin core -

        4.2 FONT FACE -

        Defaults are set. You may change the face -to: bold, italics, underscore, strikethrough, ... -

        4.2.1 BOLD -

        @bold:  [list - of  words  that  should  be  made  bold  within or document] -

        bold line -

        !_ - -

        bold line -

        bold word or sentence -

        !{ bold word or sentence }! -

        *{ bold -word or sentence }* -

        boldword or boldword -

        *boldword* or !boldword! -

        - -

        4.2.2 ITALICS -

        @italics:  [list  of  words  that  should  be  italicised  within - -

        italicise word or sentence -

        /{ italicise word or sentence }/ -

        italicisedword - -

        /italicisedword/ -

        4.2.3 UNDERSCORE -

        underscore word or sentence -

        _{ underscore -word or sentence }_ -

        underscoreword -

        4.2.4 STRIKETHROUGH -

        <del> strikethrough -word or sentence </del> -

        -{ strikethrough word or sentence }- -

        <del>strikeword</del> - -

        -strikeword- -

        4.3 ENDNOTES -

        There are two forms of markup for endnotes, - -

        they cannot be mixed within the same document -

        here[^7] -

        1. preferred endnote - -

        markup -

        here~{ this is an endnote }~ -

        2. alternative markup equivalent, - -

        kept because it is possible to search and replace to get markup in existing - -

        texts such as Project Gutenberg -

        here~^ -

        ^~ this is an endote -

        4.4 LINKS - -

        SiSU <http://sisudoc.org -> -

        { SiSU }http://sisudoc.org - -

        sisu.png 120x39 <http://sisudoc.org -> - -

        {sisu.png }http://sisudoc.org - -

        [ tux.png ] -

        { tux.png 64x80 }image -

        SiSU -<http://sisudoc.org ->  [^8] -

        { SiSU }http://sisudoc.org - -

        is equivalent to: -

        - { SiSU }http://sisudoc.org - ~{ <http://sisudoc.org -> }~ -

        the same can be done -with an image: -

        sisu.png 120x39 -

        { sisu.png SiSU }http://sisudoc.org -
        - -

        4.5 NUMBER TITLES -

        Set with the header @markup: -

        4.6 LINE OPERATIONS -

        - Line Operations (marker placed at start of line) -

        !_ bold line -

        bold - -

        line -

        _1 indent paragraph one level -

        indent paragraph one level
        - -

        _2 indent paragraph two steps -

        indent paragraph two steps
        - -

        _* bullet paragraph -

        * bullet paragraph -

        # number paragraph (see headers -for numbering document headings) -

        1. number paragraph (see headers for -numbering document headings) -

        _# number paragraph level 2 (see headers -for numbering document headings) -

        a. number paragraph level 2 (see headers -for numbering document headings)
        - -

        4.7 TABLES -

        Table markup sample -

        -

        table{~h c3; 26; 32; 32;

        - -

        -

        This is -a table, column1

        -this would become row one of column two

        -column three of -row one is here

        - -

        -

        column one row 2

        -column two of row two

        -column three of -row two, and so on

        - -

        -

        column one row three

        -and so on

        -here

        - -

        -

        }table

        - -

        Alternative - -

        form of table markup -

        -


        -

          {t~h}
        -       |Mon|Tue|Wed|Thu|Fri|Sat|Sun
        -  0    | * | * | * | * | * | * | *
        -  1    | * | * | * | * |   |   |
        -  2    | - | * | * | * | * | * |
        -  3    | - | * | * | * | * | * | *
        -  4    | - |   |   | * | * | * |
        -  5    | * | * | * | * | * | * | *
        -
        -

        4.8 GROUPED TEXT -

        -


        -

            5.times { puts ’Ruby’ }
        -
        -

        code{ -

        -


        -

            5.times { puts ’Ruby’ }
        -
        -

        }code -

        -

        A Limerick

        - -

        -

        There was a young lady from Clyde,

        -who ate a green -apple and died,

        -but the apple fermented inside the lamented,

        -and made cider -inside her inside.

        - -

        -

        poem{

        - -

        -

        There was a young lady from Clyde,

        -who ate -a green apple and died,

        -but the apple fermented inside the lamented,

        -and -made cider inside her inside.

        - -

        -

        }poem

        - -

        4.9 COMPOSITE DOCUMENT -

        To import -another document, the master document or importing document should be named -filename.r3 (r for require) -

        &lt;&lt; { filename.sst } -

        &lt;&lt; { filename.ssi -} -

        5. CHANGE APPEARANCE -

        5.1 SKINS -

        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 SiSU output. -

        There are a few examples provided, -on untarring the source tarball: -

        conf/sisu/skin/doc/
        - -

        data/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc
        - -

        and on installation under: -

        /etc/sisu/skin/doc/
        - -

        /usr/share/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc
        - -

        The following paths are searched: -

        ./_sisu/skin
        - -

        ~/.sisu/skin
        - -

        /etc/sisu/skin
        - -

        Skins under the searched paths in a per document directory, a per directory -directory, or a site directory, named: -

        doc  [may  be  specified  individually - in  each  document] -

        dir  [used  if  identifier  part  of  name  matches  markup - directory  name] -

        site -

        It is usual to place all skins in the document -directory, with symbolic links as required from dir or site directories. - -

        5.2 CSS -

        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: -

        _./_sisu/css -

        ~/.sisu/css -

        and -

        /etc/sisu/css - -

        The contents of the first directory found in the search path are copied -to the corresponding sisu output directory with the commnd: -

        sisu -CC -

        - The SiSU standard css files for SiSU output are: -

        dom.css html.css html_tables.css - -

        index.css sax.css xhtml.css -

        A document may specify its own/bespoke css file -using the css header. -

        @css: -

        [expand] -

        EXTRACTS FROM THE README -

        6. README - -

        SiSU 0.55 2007w27/6 2007-07-07 -

        Homepage: <http://www.jus.uio.no/sisu -> -

        Description - -

        SiSU is lightweight markup based document creation and publishing framework -that is controlled from the command line. Prepare documents for SiSU using -your text editor of choice, then use SiSU to generate various output document -formats. -

        With minimal preparation of a plain-text (UTF-8) file using its -native markup-syntax, 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 -

        Outputs share a common citation numbering system, and any semantic -meta-data provided about the document. -

        SiSU also provides concordance files, -document content certificates and manifests of generated output. -

        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. SiSU 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). - -

        A vim syntax highlighting file and an ftplugin with folds for sisu markup -is provided. 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 -> - -

        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. -

        SiSU can be used for -Internet, Intranet, local filesystem or cd publishing. -

        SiSU can be used -directly off the filesystem, or from a database. -

        SiSU ’s scalability, is -be dependent on your hardware, and filesystem (in my case Reiserfs), and/or -database Postgresql. -

        Amongst it’s characteristics are: -

        * simple mnemonoic -markup style, -

        * 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, -

        * 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. -

        * it is command line driven, and can be set up on - -

        a remote server -

        * Documents are marked up in SiSU syntax in your favourite -editor. 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. -

        Input files should be UTF-8 -

        Once set up it is simple -to use. -

        6.1 ONLINE INFORMATION, PLACES TO LOOK -

        <http://www.jus.uio.no/sisu -> - -

        Download Sources: -

        <http://www.jus.uio.no/sisu/SiSU/download.html#current ->
        - -

        <http://www.jus.uio.no/sisu/SiSU/download.html#debian ->
        - -

        6.2 INSTALLATION -

        NB. Platform is Unix / Linux. -

        6.2.1 DEBIAN -

        If you use -Debian use the Debian packages, check the information at: -

        <http://www.jus.uio.no/sisu/SiSU/download.html#debian ->
        - -

        (A) SiSU is available directly off the Debian archives for Sid and testing. -It should necessary only to run as root: -

        aptitude update
        - -

        aptitude install sisu-complete
        - -

        (B) If there are newer versions of SiSU upstream of the Debian archives, - -

        they will be available by adding the following to your /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
        - -

        [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 -

        Then as root run: -

        aptitude update
        - -

        aptitude install sisu-complete
        - -

        6.2.2 RPM -

        RPMs are provided though untested, they are prepared by running -alien against the source package, and against the debs. -

        They may be downloaded -from: -

        <http://www.jus.uio.no/sisu/SiSU/download.html#rpm ->
        - -

        6.2.3 SOURCE PACKAGE .TGZ -

        Otherwise to install SiSU from source, check -information at: -

        <http://www.jus.uio.no/sisu/SiSU/download.html#current ->
        - -

        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, -

        Ruby is the essential dependency for the basic - -

        operation of SiSU -

        1. Download the latest source (information available) -from: -

        <http://www.jus.uio.no/sisu/SiSU/download.html#current ->
        - -

        2. Unpack the source -

        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. -

        6.2.4 TO USE SETUP.RB -

        this is a three step -process, in the root directory of the unpacked SiSU as root type: -

        ruby -setup.rb config
        - -

        ruby setup.rb setup
        - -

        as root: -

        ruby setup.rb install
        - -

        further information: -

        <http://i.loveruby.net/en/projects/setup/ ->
        - -

        <http://i.loveruby.net/en/projects/setup/doc/usage.html ->
        - -

        6.2.5 TO USE INSTALL (PRAPARED WITH -

        Rake must be installed on your system: - -

        <http://rake.rubyforge.org/ ->
        - -

        <http://rubyforge.org/frs/?group_id=50 ->
        - -

        in the root directory of the unpacked SiSU as root type: -

        rake
        - -

        or -

        rake base
        - -

        This makes use of Rake (by Jim Weirich) and the provided Rakefile -

        -For a list of alternative actions you may type: -

        rake help
        - -

        rake -T
        - -

        6.2.6 TO USE INSTALL (PRAPARED WITH -

        (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:) -

        in the -root directory of the unpacked SiSU as root type: -

        ruby ./sisu-install
        - -

        or -

        ruby ./sisu-install base
        - -

        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. -

        further -information: -

        <http://make.rubyforge.org/ ->
        - -

        <http://rubyforge.org/frs/?group_id=615 ->
        - -

        For a list of alternative actions you may type: -

        ruby ./sisu-install -help
        - -

        ruby ./sisu-install -T
        - -

        6.3 DEPENDENCIES -

        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 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. -

        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 Debian control file (end edited), -gives an idea of additional packages that SiSU can make use of if available, -(the use/requirement of some of which are interdependent for specific actions -by SiSU ). -

        The following is from the debian/control file of sisu-0.58.2, -which amongst other things provides the dependencies of sisu within Debian - -

        -


        -

          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
        -
        -

        -


        -

          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>
        -
        -

        -


        -

          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>
        -
        -

        -


        -

          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>
        -
        -

        -


        -

          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>
        -
        -

        -


        -

          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>
        -
        -

        6.4 QUICK START -

        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). -

        After installation of sisu-complete, - -

        move to the document samples directory -

        cd /usr/share/doc/sisu/sisu_markup_samples/dfsg
        - -

        and run -

        sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst
        - -

        or the same: -

        sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst
        - -

        look at output results, see the -

        or to generate an online document -move to a writable directory, as the file will be downloaded there and -e.g. -

        sisu -3 <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst -> - -

        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 -

        examine source document, vim has syntax support -

        gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst - -

        additional markup samples in -

        <http://www.jus.uio.no/sisu/SiSU/2.html ->
        - -

        For help -

        man sisu
        - -

        or -

        sisu --help
        - -

        e.g. -

        for the way sisu -

        sisu --help env
        - -

        for list of commands and so on -

        sisu --help commands
        - -

        6.5 CONFIGURATION FILES -

        The default configuration/setup is contained - -

        within the program and is altered by configuration settings in etc [sisu - -

         version]/sisurc.yml or in ~/.sisu/sisurc.yml -

        * configuration file - a yaml - -

        file -

        /etc/sisu/[sisu  version]/sisurc.yml
        - -

        ~/.sisu/sisurc.yml
        - -

        * directory structure - setting up of output and working directory. -

        -* skins - changing the appearance of a project, directory or individual - -

        documents within ~/.sisu/skin -

        ~/.sisu/skin/doc contains individual skins, -with symbolic links from
        - -

        ~/.sisu/skin/dir if the contents of a directory are to take a particular
        - document skin.
        - -

        * additional software - eg. Tex and LaTeX (tetex, tetex-base, tetex-extra -on Debian ), Postgresql,  [sqlite], trang, tidy, makeinfo, ... none of which -are required for basic html or XML processing. -

        * if you use Vim as editor -there is a syntax highlighter and fold resource config file for SiSU hope -more syntax highlighters follow. -

        There are post installation steps (which -are really part of the overall installation) -

        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). -

        6.6 USE - -

        GENERAL OVERVIEW -

        Documents are marked up in SiSU syntax and kept in an -ordinary text editable file, named with the suffix .sst, or .ssm -

        Marked - -

        up SiSU documents are usually kept in a sub-directory of your choosing -

        - use the interactive help and man pages -

        sisu --help
        - -

        man sisu
        - -

        6.7 HELP -

        interactive help described below, or man page: -

        man sisu
        - -

        man 8 sisu
        - -

        ’man sisu_markup-samples’  [if  the  sisu-markup-samples  package  is  also  installed] - -

        Once installed an interactive help is available typing ’sisu’ (without) -any flags, and select an option: -

        sisu
        - -

        alternatively, you could type e.g. -

        sisu --help commands
        - -

        sisu --help env
        - -

        sisu --help headers
        - -

        sisu --help markup
        - -

        sisu --help headings
        - -

        etc. -

        for questions about mappings, output paths etc. -

        sisu --help env
        - -

        sisu --help path
        - -

        sisu --help directory
        - -

        6.8 DIRECTORY STRUCTURE -

        Once installed, type: -

        sisu --help env
        - -

        or -

        sisu -V
        - -

        6.9 CONFIGURATION FILE -

        The defaults can be changed via 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) -

        6.10 MARKUP -

        - See man pages. -

        man sisu
        - -

        man 8 sisu
        - -

        Once installed there is some information on SiSU Markup in its help: - -

        sisu --help markup
        - -

        and -

        sisu --help headers
        - -

        Sample marked up document are provided with the download tarball in -the directory: -

        ./data/doc/sisu/sisu_markup_samples/dfsg
        - -

        These are installed on the system usually at: -

        /usr/share/doc/sisu/sisu_markup_samples/dfsg
        - -

        More markup samples are available in the package sisu-markup-samples -

        - <http://www.jus.uio.no/sisu/SiSU/download.html#sisu-markup-samples ->
        - -

        Many more are available online off: -

        <http://www.jus.uio.no/sisu/SiSU/2.html ->
        - -

        6.11 ADDITIONAL THINGS -

        There is syntax support for some editors provided -(together with a README file) in -

        ./data/sisu/conf/syntax
        - -

        usually installed to: -

        /usr/share/sisu/conf/syntax
        - -

        6.12 LICENSE -

        License: GPL 3 or later see the copyright file in -

        ./data/doc/sisu
        - -

        usually installed to: -

        /usr/share/doc/sisu
        - -

        6.13 SISU STANDARD -

        SiSU uses: -

        * Standard SiSU markup syntax, -

        * Standard -SiSU meta-markup syntax, and the -

        * Standard SiSU object citation numbering - -

        and system -

        © Ralph Amissah 1997, current 2006 All Rights Reserved. -

        * - -

        however note the License section -

        CHANGELOG -

        ./CHANGELOG
        - -

        and see -

        <http://www.jus.uio.no/sisu/SiSU/changelog.html ->
        - -

        <http://www.jus.uio.no/sisu/SiSU/changelog_markup_samples.html ->
        - -

        EXTRACTS FROM MAN 8 SISU -

        7. POST INSTALLATION SETUP -

        7.1 POST INSTALLATION -SETUP - QUICK START -

        After installation of sisu-complete, move to the document -samples directory, -

        cd /usr/share/doc/sisu/sisu_markup_samples/dfsg
        - -

        [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] -

        and in that directory, initialise - -

        the output directory with the command -

        sisu -CC
        - -

        then run: -

        sisu -1 free_as_in_freedom.rms_and_free_software.sam_williams.sst
        - -

        or the same: -

        sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst
        - -

        look at output results, see the -

        for an overview of your current sisu -setup, type: -

        sisu --help env
        - -

        or -

        sisu -V
        - -

        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. -

        sisu -1 <http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst ->
        - -

        sisu -3
        - <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst ->
        - -

        examine source document, vim has syntax highlighting support -

        gvim - -

        free_as_in_freedom.rms_and_free_software.sam_williams.sst -

        additional markup - -

        samples in -

        <http://www.jus.uio.no/sisu/SiSU/2.html ->
        - -

        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. -

        sisu -3
        - <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip ->
        - -

        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: - -

        sisu -3 --trust
        - <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip ->
        - -

        For help -

        man sisu
        - -

        sisu --help
        - -

        sisu --help env for the way sisu
        - -

        sisu --help commands for list of commands and so on
        - -

        7.2 DOCUMENT MARKUP DIRECTORY -

        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: -

        mkdir ~/sisu_test
        - -

        cd ~/sisu_test
        - -

        cp -a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* ~/sisu_test/.
        - -

        Tip: the markup syntax examples may be of interest -

        <http://www.jus.uio.no/sisu/sample/ ->
        - -

        Tip: -

        sisu -U  [sisu  markup  filename]
        - -

        should printout the different possible outputs and where sisu would -place them. -

        Tip: if you want to toggle ansi color add -

        c
        - -

        to your flags. -

        7.2.1 CONFIGURATION FILES -

        SiSU configuration file search -path is: -

        ./_sisu/sisurc.yaml
        - -

        ~/.sisu/sisurc.yaml
        - -

        /etc/sisu/sisurc.yaml
        - -

        Debian Installation Note -

        7.2.2 DEBIAN INSTALLATION NOTE -

        It is best - -

        you see -

        <http://www.jus.uio.no/sisu/SiSU/download.html#debian ->
        - -

        for up the most up to date information. -

        notes taken from the Debian -control file (end edited), gives an idea of additional packages that SiSU -can make use of if available, (the use/requirement of some of which are -interdependent for specific actions by SiSU ): -

        Package: sisu -

        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 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 -> - -

        7.2.3 DOCUMENT RESOURCE CONFIGURATION -

        sisu resource configuration information -is obtained from sources (where they exist): -

        ~/.sisu/sisurc.yaml
        - -

        /etc/sisu/[sisu  version]/sisurc.yaml
        - -

        sisu program defaults
        - -

        7.2.4 SKINS -

        Skins default document appearance may be modified using skins -contained in sub-directories located at the following paths: -

        ./_sisu/skin
        - -

        ~/.sisu/skin
        - -

        /etc/sisu/skin
        - -

        more specifically, the following locations (or their /etc/sisu equivalent) -should be used: -

        ~/.sisu/skin/doc
        - -

        skins for individual documents; -

        ~/.sisu/skin/dir
        - -

        skins for directories of matching names; -

        ~/.sisu/skin/site
        - -

        site-wide skin modifying the site-wide appearance of documents. -

        Usually -all skin files are placed in the document skin directory: -

        ~/.sisu/skin/doc
        - -

        with softlinks being made to the skins contained there from other skin -directories as required. -

        DOCUMENT INFORMATION (METADATA) -

        METADATA -

        -Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/sisu_manifest.html -> - -

        Dublin Core (DC) -

        DC tags included with this document are provided here. - -

        DC Title: SiSU - Technical, Howto -

        DC Creator: Ralph Amissah -

        DC Rights: -Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL - -

        3 -

        DC Type: information -

        DC Date created: 2002-11-12 -

        DC Date issued: - -

        2002-11-12 -

        DC Date available: 2002-11-12 -

        DC Date modified: 2007-09-16 -

        DC -Date: 2007-09-16 -

        Version Information -

        Sourcefile: sisu_howto.sst -

        Filetype: - -

        SiSU text insert 0.57 -

        Sourcefile Digest, MD5(sisu_howto.sst)= bb17770a0fa5b4ef035ebf0bcfca3faa - -

        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)= - -

        20fc43cf3eb6590bc3399a1aef65c5a9 -

        Generated -

        Document (metaverse) last -generated: Mon Sep 24 15:36:16 +0100 2007 -

        Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

        Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

        -

          -.
        1. generated from source using rman <http://polyglotman.sourceforge.net/rman.html ->
          - With regard to
          - 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 ->
          -
        2. .
        3. <http://www.jus.uio.no/sisu/man/ ->
        4. .
        5. <http://www.jus.uio.no/sisu/man/sisu.1.html ->
        6. .
        7. <http://www.jus.uio.no/sisu/man/sisu.8.html -> -
        8. .
        9. <http://www.jus.uio.no/sisu/man/sisu_examples.1.html ->
        10. .
        11. <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html -> -
        12. .
        13. this is an endnote
        14. .
        15. <http://sisudoc.org ->
        16. .
        17. <http://sisudoc.org -> -

          - -

          Other versions -of this document:
          -
          - -
          manifest: <http://www.jus.uio.no/sisu/sisu_howto/sisu_manifest.html - -> -
          -
          - -
          html: <http://www.jus.uio.no/sisu/sisu_howto/toc.html - ->
          -
          - -
          pdf: <http://www.jus.uio.no/sisu/sisu_howto/portrait.pdf - -> -
          -
          - -
          pdf: <http://www.jus.uio.no/sisu/sisu_howto/landscape.pdf - ->
          -
          - -
          at: <http://www.jus.uio.no/sisu - -> -
          -
          - -
          * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
          -
          - -
          * Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
          -
          - -
          * Last Generated on: Mon Sep 24 -15:36:31 +0100 2007
          -
          - -
          * SiSU http://www.jus.uio.no/sisu -
          -
          - -

          - - 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 @@ - - - - - -"sisu_markup"("1") manual page - - -Table of Contents

          -SISU - MARKUP, RALPH AMISSAH -

          SISU MARKUP -

          1. INTRODUCTION TO SISU MARKUP[^1] - -

          1.1 SUMMARY -

          SiSU source documents are plaintext (UTF-8)[^2] files -

          All -paragraphs are separated by an empty line. -

          Markup is comprised of: -

          * -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) -

          * 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: -

          * heading levels defines document structure
          - -

          * text basic attributes, italics, bold etc.
          - -

          * grouped text (objects), which are to be treated differently, such -as code
          - blocks or poems.
          - -

          * footnotes/endnotes
          - -

          * linked text and images
          - -

          * paragraph actions, such as indent, bulleted, numbered-lists, etc.
          - -

          Some interactive help on markup is available, by typing sisu and selecting - -

          markup or sisu --help markup -

          1.2 MARKUP EXAMPLES -

          1.2.1 ONLINE -

          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/ -> - -

          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/ -> - -

          Some example marked up files are available as html with syntax highlighting -for viewing: <http://www.jus.uio.no/sisu/sample/syntax -> -

          an alternative presentation -of markup syntax: <http://www.jus.uio.no/sisu/sample/on_markup.txt -> -

          1.2.2 INSTALLED - -

          With 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 -

          2. MARKUP OF HEADERS -

          - 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. -

          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: -

          -


          -

            % this would be a comment
          -
          -

          2.1 SAMPLE HEADER -

          This current document has a header similar to this -one (without the comments): -

          -


          -

            % 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
          -
          -

          2.2 AVAILABLE HEADERS -

          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 -

          @indentifier: information or instructions - -

          where the information -

          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. -

          This - -

          is a sample header -

          % SiSU 0.38  [declared  file-type  identifier  with  markup - version] -

          @title:  [title  text] This is the title of the document and used -as such, this header is the only one that is mandatory -

          @subtitle: The - -

          Subtitle if any -

          @creator:  [or  @author:] Name of Author -

          @subject: (whatever -your subject) -

          @description: -

          @publisher: -

          @contributor: -

          @translator: - [or  @translated_by:] -

          @illustrator:  [or  @illustrated_by:] -

          @prepared_by: - [or  @digitized_by:] -

          @date: 2000-08-27  [  also  @date.created:  @date.issued: - @date.available:  @date.valid:  @date.modified:  ] -

          @type: article -

          @format: - -

          @identifier: -

          @source: -

          @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.] -

          [@language.original:  original  language - in  which  the  work  was published] -

          @papersize: (A4|US_letter|book_B5|book_A5|US_legal) - -

          @relation: -

          @coverage: -

          @rights: Copyright (c) Name of Right Holder, -all rights reserved, or as granted: public domain, copyleft, creative commons -variant, etc. -

          @owner: -

          @keywords: text document generation processing -management latex pdf structured xml citation  [your  keywords  here,  used - for  example  by  rss  feeds,  and  in  sql  searches] -

          @abstract:  [paper  abstract, - placed  after  table  of  contents] -

          @comment:  [...] -

          @catalogue: loc=[Library - of  Congress  classification]; dewey=[Dewey  rss  feeds, classification]; isbn=[ISBN]; -pg=[Project  Gutenberg  text  number] -

          @classify_loc:  [Library  of  Congress - classification] -

          @classify_dewey:  [Dewey  classification] -

          @classify_isbn: - [ISBN] -

          @classify_pg:  [Project  Gutenberg  text  number] -

          @prefix:  [prefix - is  placed  just  after  table  of  contents] -

          @prefix_a:  [prefix  is  placed - just  before  table  of  contents  -  not implemented] -

          @prefix_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 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  ] -

          @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:) -

          @level: newpage=3; -breakpage=4  [paragraph  level,  used  by  latex  to  breakpages,  the  page  in - newpage] -

          @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 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] -

          @bold:  [regular  expression  of  words/phrases  to  be  made - bold] -

          @italics:  [regular  expression  of  words/phrases  to  italicise] -

          -@vocabulary: name of taxonomy/vocabulary/wordlist to use against document - -

          @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. -

          @links: -{ SiSU }http://www.jus.uio.no/sisu/; - { FSF }http://www.fsf.org - -

          @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: and  promo.yml,  commented  out  sample  in  document free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst] - -

          3. MARKUP OF SUBSTANTIVE TEXT -

          3.1 HEADING LEVELS -

          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) -

          :A~  [heading - text] Top level heading  [this  usually  has  similar  content  to  the  ] NOTE: -the heading levels described here are in 0.38 notation, see heading -

          :B~ - [heading  text] Second level heading  [this  is  a  heading  level  divider] -

          - :C~  [heading  text] Third level heading  [this  is  a  heading  level  divider] - -

          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 - -

          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. -

          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 -

          -


          -

            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)
          -
          -

          3.2 FONT ATTRIBUTES -

          markup example: -

          -


          -

            normal text !{emphasis}! *{bold text}* _{underscore}_ /{italics}/
          -  normal text
          -  !{emphasis}!
          -  *{bold text}*
          -  _{underscore}
          -  /{italics}/
          - 
          -  ^{superscript}^
          -  ,{subscript},
          -  +{inserted text}+
          -  -{strikethrough}-
          -
          -

          resulting output: -

          normal text <em>emphasis</em> bold text underscore italics -<cite>citation</cite> ^superscript^  [subscript] <ins>inserted text</ins> <del>strikethrough</del> - -

          normal text -

          <em>emphasis</em> -

          bold text -

          underscore -

          italics -

          <cite>citation</cite> - -

          ^superscript^ -

          [subscript] -

          <ins>inserted text</ins> -

          <del>strikethrough</del> - -

          3.3 INDENTATION AND BULLETS -

          markup example: -

          -


          -

            ordinary paragraph
          -  _1 indent paragraph one step
          -  _2 indent paragraph two steps
          -  _9 indent paragraph nine steps
          -
          -

          resulting output: -

          ordinary paragraph -

          indent paragraph one step
          - -

          indent paragraph two steps
          - -

          indent paragraph nine steps
          - -

          markup example: -

          -


          -

            * bullet text
          -  _1* bullet text, first indent
          -  _2* bullet text, two step indent
          -
          -

          resulting output: -

          * bullet text -

          * bullet text, first indent
          - -

          * bullet text, two step indent
          - -

          Numbered List (not to be confused with headings/titles, (document structure)) - -

          markup example: -

          -


          -

            # numbered list                numbered list 1., 2., 3, etc.
          -  _# numbered list numbered list indented a., b., c., d., etc.
          -
          -

          3.4 FOOTNOTES / ENDNOTES -

          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. -

          markup example: -

          -


          -

            ~{ a footnote or endnote }~
          -
          -

          resulting output: -

          [^3] -

          markup example: -

          -


          -

            normal text~{ self contained endnote marker & endnote in one }~ continues
          -
          -

          resulting output: -

          normal text[^4] continues -

          markup example: -

          -


          -

            normal text ~{* unnumbered asterisk footnote/endnote, insert multiple
          -asterisks if required }~ continues
          -  normal text ~{** another unnumbered asterisk footnote/endnote }~ continues
          -
          -

          resulting output: -

          normal text  [^*] continues -

          normal text  [^**] continues - -

          markup example: -

          -


          -

            normal text ~[*  editors  notes,  numbered  asterisk  footnote/endnote  series
          - ]~ continues
          -  normal text ~[+  editors  notes,  numbered  asterisk  footnote/endnote  series
          - ]~ continues
          -
          -

          resulting output: -

          normal text  [^*1] continues -

          normal text  [^+1] continues - -

          Alternative endnote pair notation for footnotes/endnotes: -

          -


          -

          -  % note the endnote marker
          -  normal text~^ continues
          -  ^~ endnote text following the paragraph in which the marker occurs
          -
          -

          the standard and pair notation cannot be mixed in the same document -

          - -

          3.5 LINKS -

          3.5.1 NAKED URLS WITHIN TEXT, DEALING WITH URLS -

          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). -

          markup example: -

          -


          -

            normal text http://www.jus.uio.no/sisu continues
          -
          -

          resulting output: -

          normal text <http://www.jus.uio.no/sisu -> continues -

          An - -

          escaped url without decoration -

          markup example: -

          -


          -

            normal text http://www.jus.uio.no/sisu continues
          -  deb http://www.jus.uio.no/sisu/archive unstable main non-free
          -
          -

          resulting output: -

          normal text http://www.jus.uio.no/sisu - continues -

          deb - -

          http://www.jus.uio.no/sisu/archive - unstable main non-free -

          where a code block -is used there is neither decoration nor hyperlinking, code blocks are discussed - -

          later in this document -

          resulting output: -

          -


          -

            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
          -
          -

          To link text or an image to a url the markup is as follows -

          markup example: - -

          -


          -

            about { SiSU }http://url.org markup
          -
          -

          3.5.2 LINKING TEXT -

          resulting output: -

          about SiSU <http://www.jus.uio.no/sisu/ -> - -

          markup -

          A shortcut notation is available so the url link may also be provided - -

          automatically as a footnote -

          markup example: -

          -


          -

            about {~^ SiSU }http://url.org markup
          -
          -

          resulting output: -

          about SiSU <http://www.jus.uio.no/sisu/ ->  [^5] markup -

          3.5.3 - -

          LINKING IMAGES -

          markup example: -

          -


          -

                [ tux.png ]
          -  % various url linked images
          -      [ tux.png ]
          -      [ GnuDebianLinuxRubyBetterWay.png ]
          -  {~^ ruby_logo.png
          -
          -

          resulting output: -

          [ tux.png ] -

          tux.png 64x80 -

          [  ruby_logo  (png  missing) - ]  [^6] -

          GnuDebianLinuxRubyBetterWay.png 100x101 and Ruby -

          linked url footnote - -

          shortcut -

          -


          -

            {~^  [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
          -
          -

          -


          -

            text marker *~name
          -
          -

          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. -

          3.6 GROUPED TEXT -

          3.6.1 - -

          TABLES -

          Tables may be prepared in two either of two forms -

          markup example: - -

          -


          -

            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
          -
          -

          resulting output: -

           [table  omitted,  see  other  document  formats]
          - -

          a second form may be easier to work with in cases where there is not - -

          much information in each column -

          markup example: [^7] -

          -


          -

            !_ 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.
          -
          -

          resulting output: -

          Table 3.1: Contributors to Wikipedia, January 2001 -- June 2005 -

           [table  omitted,  see  other  document  formats]
          - -

          * Contributed at least ten times; ** at least 5 times in last month; -*** more than 100 times in last month. -

          3.6.2 POEM -

          basic markup: -

          -


          -

            poem{
          -    Your poem here
          -  }poem
          -  Each verse in a poem is given a separate object number.
          -
          -

          markup example: -

          -


          -

            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
          -
          -

          resulting output: -

          -

          ’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.
          -

          - -

          3.6.3 GROUP -

          basic markup: -

          -


          -

            group{
          -    Your grouped text here
          -  }group
          -  A group is treated as an object and given a single object number.
          -
          -

          markup example: -

          -


          -

            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
          -
          -

          resulting output: -

          -

          ’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.
          -

          - -

          3.6.4 CODE -

          Code tags are used to escape regular sisu markup, and have -been used extensively within this document to provide examples of 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. -

          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] -

          use of code tags instead of -poem compared, resulting output: -

          -


          -

                                ’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.
          -
          -

          4. COMPOSITE DOCUMENTS MARKUP -

          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 .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 .sst regular markup file, or .ssi (insert/information) - -

          A secondary file of the composite document is built prior to processing - -

          with the same prefix and the suffix ._sst -

          basic markup for importing a - -

          document into a master document -

          -


          -

            << |filename1.sst|@|^|
          -  << |filename2.ssi|@|^|
          -
          -

          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. - -

          -


          -

            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>
          -
          -

          MARKUP SYNTAX HISTORY -

          5. NOTES RELATED TO FILES-TYPES AND MARKUP SYNTAX - -

          0.38 is substantially current, depreciated 0.16 supported, though file - -

          names were changed at 0.37 -

          0.52 (2007w14/6) declared document type identifier -at start of text/document: -

          .B SiSU
          - 0.52 -

          or, backward compatible using the comment marker: -

          %
          - SiSU 0.38 -

          variations include ’ SiSU (text|master|insert)  [version]’ and ’sisu-[version]’ - -

          0.51 (2007w13/6) skins changed (simplified), markup unchanged -

          0.42 (2006w27/4) -* (asterisk) type endnotes, used e.g. in relation to author -

          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) -

          0.37 (2006w09/7) introduced new file naming convention, -.sst (text), .ssm (master), .ssi (insert), markup syntax unchanged -

          0.35 (2005w52/3) -sisupod, zipped content file introduced -

          0.23 (2005w36/2) utf-8 for markup - -

          file -

          0.22 (2005w35/3) image dimensions may be omitted if rmagick is available - -

          to be relied upon -

          0.20.4 (2005w33/4) header 0~links -

          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 -

          DOCUMENT INFORMATION (METADATA) -

          METADATA -

          Document Manifest -@ <http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/sisu_manifest.html -> -

          Dublin -Core (DC) -

          DC tags included with this document are provided here. -

          DC -Title: SiSU - Markup -

          DC Creator: Ralph Amissah -

          DC Rights: Copyright -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -

          DC -Type: information -

          DC Date created: 2002-08-28 -

          DC Date issued: 2002-08-28 - -

          DC Date available: 2002-08-28 -

          DC Date modified: 2007-09-16 -

          DC Date: 2007-09-16 - -

          Version Information -

          Sourcefile: sisu_markup.sst -

          Filetype: SiSU text - -

          0.58 -

          Sourcefile Digest, MD5(sisu_markup.sst)= 6848f40f5844e0a7d59dbb86b3ddae92 - -

          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)= - -

          20fc43cf3eb6590bc3399a1aef65c5a9 -

          Generated -

          Document (metaverse) last -generated: Mon Sep 24 15:36:14 +0100 2007 -

          Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

          Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

          -

            -.
          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. -
          2. .
          3. files should be prepared using UTF-8 character encoding
          4. .
          5. a footnote or endnote -
          6. .
          7. self contained endnote marker & endnote in one - -
            *.
            -
            unnumbered asterisk footnote/endnote, -insert multiple asterisks if required
            - -
            **.
            -
            another unnumbered asterisk footnote/endnote -
            - -
            *1.
            -
            editors notes, numbered asterisk footnote/endnote series
            - -
            +1.
            -
            editors -notes, numbered asterisk footnote/endnote series
          8. .
          9. <http://www.jus.uio.no/sisu/ -> -
          10. .
          11. <http://www.ruby-lang.org/en/ ->
          12. .
          13. Table from the Wealth of Networks by Yochai Benkler - <http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler ->
            - -

            - -

            Other versions of this document:
            -
            - -
            manifest: <http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html - -> -
            -
            - -
            html: <http://www.jus.uio.no/sisu/sisu_markup/toc.html - ->
            -
            - -
            pdf: <http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf - -> -
            -
            - -
            pdf: <http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf - ->
            -
            - -
            at: <http://www.jus.uio.no/sisu - -> -
            -
            - -
            * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
            -
            - -
            * Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
            -
            - -
            * Last Generated on: Mon Sep 24 -15:36:30 +0100 2007
            -
            - -
            * SiSU http://www.jus.uio.no/sisu -
            -
            - -

            - - 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 @@ - - - - - -"sisu_quickstart"("1") manual page - - -Table of Contents

            -SISU - QUICKSTART, INSTALLATION AND USE, RALPH AMISSAH -

            QUICKSTART - SISU -INSTALLATION AND USE -

            1. QUICKSTART - GETTING STARTED HOWTO -

            1.1 INSTALLATION - -

            Installation is currently most straightforward and tested on the Debian -platform, as there are packages for the installation of sisu and all requirements -for what it does. -

            1.1.1 DEBIAN INSTALLATION -

            SiSU is available directly -from the Debian Sid and testing archives (and possibly Ubuntu), assuming -your /etc/apt/sources.list is set accordingly: -

            -


            -

                aptitude update
            -    aptitude install sisu-complete
            -
            -

            The following /etc/apt/sources.list setting permits the download of additional -markup samples: -

            -


            -

              #/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
            -
            -

            The aptitude commands become: -

            -


            -

                aptitude update
            -    aptitude install sisu-complete sisu-markup-samples
            -
            -

            If there are newer versions of SiSU upstream of the Debian archives, - -

            they will be available by adding the following to your /etc/apt/sources.list - -

            -


            -

              #/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
            -
            -

            repeat the aptitude commands -

            -


            -

                aptitude update
            -    aptitude install sisu-complete sisu-markup-samples
            -
            -

            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. -

            1.1.2 RPM INSTALLATION -

            RPMs are provided -though untested, they are prepared by running alien against the source -package, and against the debs. -

            They may be downloaded from: -

            <http://www.jus.uio.no/sisu/SiSU/download.html#rpm ->
            - -

            as root type: -

            rpm -i  [rpm  package  name]
            - -

            1.1.3 INSTALLATION FROM SOURCE -

            To install SiSU from source check information -at: -

            <http://www.jus.uio.no/sisu/SiSU/download.html#current ->
            - -

            * download the source package -

            * Unpack the source -

            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: -

            For basic use -SiSU is only dependent on the programming language in which it is written -Ruby , and 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. -

            setup.rb -

            This is -a standard ruby installer, using setup.rb is a three step process. In the -root directory of the unpacked SiSU as root type: -

            -


            -

                  ruby setup.rb config
            -      ruby setup.rb setup
            -      #[and  as  root:]
            -      ruby setup.rb install
            -
            -

            further information on setup.rb is available from: -

            <http://i.loveruby.net/en/projects/setup/ ->
            - -

            <http://i.loveruby.net/en/projects/setup/doc/usage.html ->
            - -

            -

            The root directory of the unpacked SiSU as root type: -

            ruby install -base
            - -

            or for a more complete installation: -

            ruby install
            - -

            or -

            ruby install base
            - -

            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. -

            Further - -

            information on -

            <http://make.rubyforge.org/ ->
            - -

            <http://rubyforge.org/frs/?group_id=615 ->
            - -

            For a list of alternative actions you may type: -

            ruby install help
            - -

            ruby install -T
            - -

            1.2 TESTING SISU, GENERATING OUTPUT -

            To check which version of sisu is -installed: -

            sisu -v -

            Depending on your mode of installation one or a number -of markup sample files may be found either in the directory: -

            -

            or -

            - -

            change directory to the appropriate one: -

            cd /usr/share/doc/sisu/sisu_markup_samples/dfsg - -

            1.2.1 BASIC TEXT, PLAINTEXT, HTML, XML, ODF -

            Having moved to the directory -that contains the markup samples (see instructions above if necessary), - -

            choose a file and run sisu against it -

            sisu -NhwoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst - -

            this will generate html including a concordance file, opendocument text -format, plaintext, XHTML and various forms of XML, and OpenDocument text - -

            1.2.2 LATEX / PDF -

            Assuming a LaTeX engine such as tetex or texlive is -installed with the required modules (done automatically on selection of -sisu-pdf in Debian ) -

            Having moved to the directory that contains the markup -samples (see instructions above if necessary), choose a file and run sisu - -

            against it -

            sisu -pv free_as_in_freedom.rms_and_free_software.sam_williams.sst - -

            sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst -

            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 -

            1.2.3 RELATIONAL DATABASE - POSTGRESQL, SQLITE - -

            Relational databases need some setting up - you must have permission to -create the database and write to it when you run sisu. -

            Assuming you have - -

            the database installed and the requisite permissions -

            sisu --sqlite --recreate - -

            sisu --sqlite -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst - -

            sisu --pgsql --recreate -

            sisu --pgsql -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst - -

            1.3 GETTING HELP -

            1.3.1 THE MAN PAGES -

            Type: -

            man sisu
            - -

            The man pages are also available online, though not always kept as up -to date as within the package itself: -

            * sisu.1 <http://www.jus.uio.no/sisu/man/sisu.1 -> - [^2] -

            * sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8 ->  [^3] -

            * man directory <http://www.jus.uio.no/sisu/man -> - [^4] -

            1.3.2 BUILT IN HELP -

            sisu --help -

            sisu --help --env -

            sisu --help --commands - -

            sisu --help --markup -

            1.3.3 THE HOME PAGE -

            <http://www.jus.uio.no/sisu -> -

            <http://www.jus.uio.no/sisu/SiSU -> - -

            1.4 MARKUP SAMPLES -

            A number of markup samples (along with output) are -available off: -

            <http://www.jus.uio.no/sisu/SiSU/2.html -> -

            Additional markup -samples are packaged separately in the file: -

            * -

            On 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. -

            DOCUMENT INFORMATION -(METADATA) -

            METADATA -

            Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/sisu_manifest.html -> - -

            Dublin Core (DC) -

            DC tags included with this document are provided here. - -

            DC Title: SiSU - Quickstart, installation and use -

            DC Creator: Ralph - -

            Amissah -

            DC Rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, - -

            License GPL 3 -

            DC Type: information -

            DC Date created: 2006-09-06 -

            DC Date -available: 2006-09-06 -

            DC Date issued: 2006-09-06 -

            DC Date modified: 2007-09-16 - -

            DC Date: 2007-09-16 -

            Version Information -

            Sourcefile: sisu_quickstart.sst - -

            Filetype: SiSU text 0.57 -

            Sourcefile Digest, MD5(sisu_quickstart.sst)= - -

            e76db98ca0d8c2bfe526dad55622fa7a -

            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)= - -

            20fc43cf3eb6590bc3399a1aef65c5a9 -

            Generated -

            Document (metaverse) last -generated: Mon Sep 24 15:36:15 +0100 2007 -

            Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

            Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

            -

              -.
            1. There is nothing to stop MySQL support being added in future. -
            2. .
            3. <http://www.jus.uio.no/sisu/man/sisu.1 ->
            4. .
            5. <http://www.jus.uio.no/sisu/man/sisu.8 ->
            6. .
            7. <http://www.jus.uio.no/sisu/man -> -
            8. .
            9. 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. -

              - -

              Other versions of -this document:
              -
              - -
              manifest: <http://www.jus.uio.no/sisu/sisu_quickstart/sisu_manifest.html - -> -
              -
              - -
              html: <http://www.jus.uio.no/sisu/sisu_quickstart/toc.html - ->
              -
              - -
              pdf: <http://www.jus.uio.no/sisu/sisu_quickstart/portrait.pdf - -> -
              -
              - -
              pdf: <http://www.jus.uio.no/sisu/sisu_quickstart/landscape.pdf - ->
              -
              - -
              at: <http://www.jus.uio.no/sisu - -> -
              -
              - -
              * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
              -
              - -
              * Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
              -
              - -
              * Last Generated on: Mon Sep 24 -15:36:31 +0100 2007
              -
              - -
              * SiSU http://www.jus.uio.no/sisu -
              -
              - -

              - - 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 @@ - - - - - -"sisu_remote"("1") manual page - - -Table of Contents

              -SISU - REMOTE OPERATIONS, RALPH AMISSAH -

              SISU REMOTE OPERATIONS -

              1. REMOTE -SOURCE DOCUMENTS -

              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 SiSU documents -can either be sisu marked up files in plaintext .sst or .ssm or; zipped sisu -files, sisupod.zip or filename.ssp -

              .sst / .ssm - sisu text files -

              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. -

              -


              -

                sisu -3 http://[provide  url  to  valid  .sst  or  .ssm  file]
              -
              -

              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. -

              NOTE: to set up a remote machine to serve SiSU documents -in this way, images should be in the directory relative to the document - -

              source ../_sisu/image -

              sisupod - zipped sisu files -

              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. -

              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. -

              -


              -

                sisu -3 http://[provide  url  to  valid  sisupod.zip  or  .ssp  file]
              -
              -

              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. -

              REMOTE DOCUMENT OUTPUT -

              2. REMOTE OUTPUT -

              Once properly -configured SiSU output can be automatically posted once generated to a -designated remote machine using either rsync, or scp. -

              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. -

              -


              -

                sisu -3R sisu_remote.sst
              -
              -

              2.1 COMMANDS -

              -

              - -
               -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 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 -

              - -
               -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 -

              -
              -2.2 CONFIGURATION -

              [expand  on  the  setting  up  of  an  ssh-agent  /  keychain] - -

              3. REMOTE SERVERS -

              As SiSU is generally operated using the command line, -and works within a Unix type environment, 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. -

              DOCUMENT INFORMATION (METADATA) -

              -METADATA -

              Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/sisu_manifest.html -> - -

              Dublin Core (DC) -

              DC tags included with this document are provided here. - -

              DC Title: SiSU - Remote Operations -

              DC Creator: Ralph Amissah -

              DC Rights: -Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL - -

              3 -

              DC Type: information -

              DC Date created: 2002-08-28 -

              DC Date issued: - -

              2002-08-28 -

              DC Date available: 2002-08-28 -

              DC Date modified: 2007-09-16 -

              DC -Date: 2007-09-16 -

              Version Information -

              Sourcefile: sisu_remote.sst -

              Filetype: - -

              SiSU text 0.58 -

              Sourcefile Digest, MD5(sisu_remote.sst)= 9bdac464998dc3f034fbd8f80df23b83 - -

              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)= - -

              20fc43cf3eb6590bc3399a1aef65c5a9 -

              Generated -

              Document (metaverse) last -generated: Mon Sep 24 15:36:17 +0100 2007 -

              Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

              Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

              -

              -

              - -
              Other versions of this document:
              -
              - -
              manifest: <http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html - -> -
              -
              - -
              html: <http://www.jus.uio.no/sisu/sisu_remote/toc.html - ->
              -
              - -
              pdf: <http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf - -> -
              -
              - -
              pdf: <http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf - ->
              -
              - -
              at: <http://www.jus.uio.no/sisu - -> -
              -
              - -
              * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
              -
              - -
              * Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
              -
              - -
              * Last Generated on: Mon Sep 24 -15:36:32 +0100 2007
              -
              - -
              * SiSU http://www.jus.uio.no/sisu -
              -
              -
              -

              - - 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 @@ - - - - - -"sisu_search"("1") manual page - - -Table of Contents

              -SISU - SEARCH, RALPH AMISSAH -

              SISU SEARCH -

              1. SISU SEARCH - INTRODUCTION - -

              SiSU output can easily and conveniently be indexed by a number of standalone -indexing tools, such as Lucene, Hyperestraier. -

              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. -

              In addition to this 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. -

              2. -SQL -

              2.1 POPULATING SQL TYPE DATABASES -

              SiSU feeds sisu markupd documents -into sql type databases PostgreSQL[^1] and/or SQLite[^2] database together -with information related to document structure. -

              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: - -

              * one containing semantic (and other) headers, including, title, author,
              - subject, (the Dublin Core...);
              - -

              * another the substantive texts by individual
              - 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
              - -

              * a third containing endnotes cross-referenced back to the paragraph -from
              - which they are referenced (both in formatted and clean text versions -for
              - searching).
              - -

              * 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.
              - -

              There is of course the possibility to add further structures. -

              At this -level 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. -

              Being able to search a relational -database at an object level with the SiSU citation system is an effective -way of locating content generated by SiSU 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). -

              3. -POSTGRESQL -

              3.1 NAME -

              SiSU - Structured information, Serialized Units - -a document publishing system, postgresql dependency package -

              3.2 DESCRIPTION - -

              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 SiSU to populate a postgresql database, this being -part of SiSU - man sisu). -

              3.3 SYNOPSIS -

              sisu -D  [instruction]  [filename/wildcard - if  required]
              - -

              sisu -D --pg --[instruction]  [filename/wildcard  if  required]
              - -

              3.4 COMMANDS -

              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 -

              -D or --pgsql may -be used interchangeably. -

              3.4.1 CREATE AND DESTROY DATABASE -

              -

              - -
               --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) the  same  name - as  working  directory,  as -

              - -
               sisu  -D  --createdb
              -
               creates  database  where  no  database - existed  before  as -

              - -
               sisu  -D  --create
              -
               creates  database  tables  where  no  database - tables  existed before  database  tables  where  no  database  tables  existed - -

              - -
               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).  a -

              - -
               sisu  -D  --recreate
              -
               destroys  existing - -

               database  and  builds  a  new  empty  database  structure -

              -
              -3.4.2 IMPORT AND REMOVE - -

              DOCUMENTS -

              -

              - -
               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). -

              - -
               sisu  -D  --update  -v   [filename/wildcard]
              -
              updates - -

              file contents in database -

              - -
               sisu  -D  --remove  -v   [filename/wildcard]
              -
              removes -specified document from postgresql database. -

              -
              -4. SQLITE -

              4.1 NAME -

              SiSU -- Structured information, Serialized Units - a document publishing system. - -

              4.2 DESCRIPTION -

              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 SiSU to populate an sqlite database, this being -part of SiSU - man sisu). -

              4.3 SYNOPSIS -

              sisu -d  [instruction]  [filename/wildcard - if  required]
              - -

              sisu -d --(sqlite|pg) --[instruction]  [filename/wildcard  if
              - required]
              - -

              4.4 COMMANDS -

              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 -

              -d or --sqlite may -be used interchangeably. -

              4.4.1 CREATE AND DESTROY DATABASE -

              -

              - -
               --sqlite  --createall -
              -
               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 -

              - -
               sisu  -d  --createdb
              -
               creates  database  where - no  database  existed  before  as -

              - -
               sisu  -d  --create
              -
               creates  database  tables  where - no  database  tables  existed before  database  tables  where  no  database  tables - existed -

              - -
               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).  a -

              - -
               sisu  -d  --recreate
              -
               destroys - -

               existing  database  and  builds  a  new  empty  database  structure -

              -
              -4.4.2 IMPORT - -

              AND REMOVE DOCUMENTS -

              -

              - -
               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). -

              - -
               sisu  -d  --update  -v   [filename/wildcard]
              -
              updates - -

              file contents in database -

              - -
               sisu  -d  --remove  -v   [filename/wildcard]
              -
              removes -specified document from sqlite database. -

              -
              -5. INTRODUCTION -

              5.1 SEARCH - DATABASE -FRONTEND SAMPLE, UTILISING DATABASE AND SISU FEATURES, INCLUDING OBJECT -CITATION NUMBERING (BACKEND CURRENTLY POSTGRESQL) -

              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, object citation numbering -to demonstrates functionality.[^4] -

              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. - -

              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] -

              -

              - -
               sisu  -F  --webserv-webrick
              -
               builds  a  cgi  web - -

               search  frontend  for  the  database  created -

              The following is feedback on -the setup on a machine provided by the help command: -

              sisu --help sql
              - -

              -


              -

                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
              -
              -

              Note on databases built -

              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 -

              -
              -5.2 SEARCH FORM -

              -

              - -
               sisu  -F
              -
               generates  a  sample  search  form,  which  must  be - copied  to  which  must  be  copied  to -

              - -
               sisu  -F  --webserv-webrick
              -
               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 -

              - -
               sisu - -Fv
              -
               as  above,  and  provides  some  information  on  setting  up -

              - -
               sisu  -W
              -
               starts - -

               the  webrick  server  which  should  be  available -

              The generated search form - -

              must be copied manually to the webserver directory as instructed -

              -
              -6. HYPERESTRAIER - -

              See the documentation for hyperestraier: -

              <http://hyperestraier.sourceforge.net/ ->
              - -

              /usr/share/doc/hyperestraier/index.html
              - -

              man estcmd
              - -

              on sisu_hyperestraier: -

              man sisu_hyperestraier
              - -

              /usr/share/doc/sisu/sisu_markup/sisu_hyperestraier/index.html
              - -

              NOTE: the examples that follow assume that sisu output is placed in - -

              the directory /home/ralph/sisu_www -

              (A) to generate the index within the -webserver directory to be indexed: -

              estcmd gather -sd  [index  name]  [directory - path  to  index]
              - -

              the following are examples that will need to be tailored according to -your needs: -

              cd /home/ralph/sisu_www
              - -

              estcmd gather -sd casket /home/ralph/sisu_www
              - -

              you may use the ’find’ command together with ’egrep’ to limit indexing to -particular document collection directories within the web server directory: - -

              find /home/ralph/sisu_www -type f | egrep
              - ’/home/ralph/sisu_www/sisu/.+?.html$’ |estcmd gather -sd casket -
              - -

              Check which directories in the webserver/output directory (~/sisu_www -or elsewhere depending on configuration) you wish to include in the search -index. -

              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. -

              find /home/ralph/sisu_www --type f | egrep
              - ’/sisu_www/(sisu|bookmarks)/.+?.html$’ | egrep -v
              - ’(doc|concordance).html$’ |estcmd gather -sd casket -
              - -

              from your current document preparation/markup directory, you would construct -a rune along the following lines: -

              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 -
              - -

              (B) to set up the search form -

              (i) copy estseek.cgi to your cgi directory -and set file permissions to 755: -

              sudo cp -vi /usr/lib/estraier/estseek.cgi -/usr/lib/cgi-bin
              - -

              sudo chmod -v 755 /usr/lib/cgi-bin/estseek.cgi
              - -

              sudo cp -v /usr/share/hyperestraier/estseek.* /usr/lib/cgi-bin
              - -

               [see  estraier  documentation  for  paths]
              - -

              (ii) edit estseek.conf, with attention to the lines starting ’indexname:’ -and ’replace:’: -

              indexname: /home/ralph/sisu_www/casket
              - -

              replace: ^file:///home/ralph/sisu_www{{!}}http://localhost -
              - -

              replace: /index.html?${{!}}/
              - -

              (C) to test using webrick, start webrick: -

              sisu -W
              - -

              and try open the url: <http://localhost:8081/cgi-bin/estseek.cgi -> -

              DOCUMENT -INFORMATION (METADATA) -

              METADATA -

              Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_search/sisu_manifest.html -> - -

              Dublin Core (DC) -

              DC tags included with this document are provided here. - -

              DC Title: SiSU - Search -

              DC Creator: Ralph Amissah -

              DC Rights: Copyright -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -

              DC -Type: information -

              DC Date created: 2002-08-28 -

              DC Date issued: 2002-08-28 - -

              DC Date available: 2002-08-28 -

              DC Date modified: 2007-09-16 -

              DC Date: 2007-09-16 - -

              Version Information -

              Sourcefile: sisu_search._sst -

              Filetype: SiSU text - -

              insert 0.58 -

              Sourcefile Digest, MD5(sisu_search._sst)= c085c2eb6d68f1b7d50435f673ede407 - -

              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)= - -

              20fc43cf3eb6590bc3399a1aef65c5a9 -

              Generated -

              Document (metaverse) last -generated: Mon Sep 24 15:36:19 +0100 2007 -

              Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

              Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

              -

                -.
              1. <http://www.postgresql.org/ -> <http://advocacy.postgresql.org/ ->
                - <http://en.wikipedia.org/wiki/Postgresql ->
                -
              2. .
              3. <http://www.hwaci.com/sw/sqlite/ -> <http://en.wikipedia.org/wiki/Sqlite ->
                -
              4. .
              5. <http://search.sisudoc.org ->
              6. .
              7. (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.
              8. .
              9. 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. - -

                - -

                Other versions of this document:
                -
                - -
                manifest: <http://www.jus.uio.no/sisu/sisu_search/sisu_manifest.html - -> -
                -
                - -
                html: <http://www.jus.uio.no/sisu/sisu_search/toc.html - ->
                -
                - -
                pdf: <http://www.jus.uio.no/sisu/sisu_search/portrait.pdf - -> -
                -
                - -
                pdf: <http://www.jus.uio.no/sisu/sisu_search/landscape.pdf - ->
                -
                - -
                at: <http://www.jus.uio.no/sisu - -> -
                -
                - -
                * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
                -
                - -
                * Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
                -
                - -
                * Last Generated on: Mon Sep 24 -15:36:32 +0100 2007
                -
                - -
                * SiSU http://www.jus.uio.no/sisu -
                -
                - -

                - - 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 @@ - - - - - -"sisu_skin"("1") manual page - - -Table of Contents

                -SISU - SKINS, RALPH AMISSAH -

                DOCUMENT SKINS - CONFIGURATION -

                1. SKINS -

                - Skins modify the default appearance of document output on a document, -directory, or site wide basis. Skins are looked for in the following locations: - -

                ./_sisu/skin
                - -

                ~/.sisu/skin
                - -

                /etc/sisu/skin
                - -

                Within the skin directory are the following the default sub-directories -for document skins: -

                ./skin/doc
                - -

                ./skin/dir
                - -

                ./skin/site
                - -

                A skin is placed in the appropriate directory and the file named skin_[name].rb - -

                The skin itself is a ruby file which modifies the default appearances -set in the program. -

                1.1 DOCUMENT SKIN -

                Documents take on a document skin, -if the header of the document specifies a skin to be used. -

                -


                -

                  @skin: skin_united_nations
                -
                -

                1.2 DIRECTORY SKIN -

                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). -

                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. - -

                1.3 SITE SKIN -

                A site skin, modifies the program default skin. -

                1.4 SAMPLE - -

                SKINS -

                With SiSU installed sample skins may be found in: -

                /etc/sisu/skin/doc -and
                - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc
                - -

                (or equivalent directory) and if sisu-markup-samples is installed also -under: -

                /usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc
                - -

                Samples of list.yml and promo.yml (which are used to create the right -column list) may be found in: -

                /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml -(or equivalent
                - directory)
                - -

                DOCUMENT INFORMATION (METADATA) -

                METADATA -

                Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html -> - -

                Dublin Core (DC) -

                DC tags included with this document are provided here. - -

                DC Title: SiSU - Skins -

                DC Creator: Ralph Amissah -

                DC Rights: Copyright -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 -

                DC -Type: information -

                DC Date created: 2002-11-12 -

                DC Date issued: 2002-11-12 - -

                DC Date available: 2002-11-12 -

                DC Date modified: 2007-09-16 -

                DC Date: 2007-09-16 - -

                Version Information -

                Sourcefile: sisu_skin.sst -

                Filetype: SiSU text - -

                insert 0.58 -

                Sourcefile Digest, MD5(sisu_skin.sst)= 8aebfb5312045c3a705ad6c314246f67 - -

                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)= - -

                20fc43cf3eb6590bc3399a1aef65c5a9 -

                Generated -

                Document (metaverse) last -generated: Mon Sep 24 15:36:15 +0100 2007 -

                Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

                Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

                -

                -

                - -
                Other versions of this document:
                -
                - -
                manifest: <http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html - -> -
                -
                - -
                html: <http://www.jus.uio.no/sisu/sisu_skin/toc.html - ->
                -
                - -
                pdf: <http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf - -> -
                -
                - -
                pdf: <http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf - ->
                -
                - -
                at: <http://www.jus.uio.no/sisu - -> -
                -
                - -
                * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
                -
                - -
                * Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
                -
                - -
                * Last Generated on: Mon Sep 24 -15:36:31 +0100 2007
                -
                - -
                * SiSU http://www.jus.uio.no/sisu -
                -
                -
                -

                - - 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 @@ - - - - - -"sisu_syntax_highlighting"("1") manual page - - -Table of Contents

                -SISU - SYNTAX HIGHLIGHTING, RALPH AMISSAH -

                SISU SYNTAX HIGHLIGHTING -

                1. -EDITOR FILES, SYNTAX HIGHLIGHTING -

                The directory: -

                ./data/sisu/conf/editor-syntax-etc/
                - -

                /usr/share/sisu/conf/editor-syntax-etc
                - -

                contains rudimentary sisu syntax highlighting files for: -

                * (g)vim -<http://www.vim.org -> -

                package: sisu-vim
                - -

                status: largely done -

                there is a vim syntax highlighting and folds -component
                - -

                * gedit <http://www.gnome.org/projects/gedit -> -

                * gobby <http://gobby.0x539.de/ -> - -

                file: sisu.lang
                - -

                place in: -

                /usr/share/gtksourceview-1.0/language-specs
                - -

                or -

                ~/.gnome2/gtksourceview-1.0/language-specs
                - -

                status: very basic syntax highlighting
                - -

                comments: this editor features display line wrap and is used by Goby!
                - -

                * nano <http://www.nano-editor.org -> -

                file: nanorc
                - -

                save as: -

                ~/.nanorc
                - -

                status: basic syntax highlighting
                - -

                comments: assumes dark background; no display line-wrap; does line -breaks
                - -

                * diakonos (an editor written in ruby) <http://purepistos.net/diakonos -> - -

                file: diakonos.conf -

                save as: -

                ~/.diakonos/diakonos.conf
                - -

                includes: -

                status: basic syntax highlighting
                - -

                comments: assumes dark background; no display line-wrap -

                * kate & kwrite -<http://kate.kde.org -> -

                file: sisu.xml
                - -

                place in:
                - -

                /usr/share/apps/katepart/syntax
                - -

                or
                - -

                ~/.kde/share/apps/katepart/syntax
                - -

                 [settings::configure  kate::{highlighting,filetypes}]
                - -

                 [tools::highlighting::{markup,scripts}::
                -  SiSU ] -

                * nedit <http://www.nedit.org -> -

                file: sisu_nedit.pats
                - -

                nedit -import sisu_nedit.pats
                - -

                status: a very clumsy first attempt  [not  really  done]
                - -

                comments: this editor features display line wrap
                - -

                * emacs <http://www.gnu.org/software/emacs/emacs.html -> -

                files: sisu-mode.el
                - -

                to file ~/.emacs add the following 2 lines:
                - -

                (add-to-list ’load-path
                - -

                (require ’sisu-mode.el)
                - -

                 [not  done  /  not  yet  included]
                - -

                * vim & gvim <http://www.vim.org -> -

                files:
                - -

                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)
                - -

                status: this includes: syntax highlighting; vim folds; some error -checking
                - -

                comments: this editor features display line wrap
                - -

                NOTE: -

                [  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] -

                DOCUMENT INFORMATION (METADATA) -

                METADATA -

                Document Manifest -@ <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/sisu_manifest.html -> - -

                Dublin Core (DC) -

                DC tags included with this document are provided here. - -

                DC Title: SiSU - Syntax Highlighting -

                DC Creator: Ralph Amissah -

                DC -Rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License - -

                GPL 3 -

                DC Type: information -

                DC Date created: 2002-11-12 -

                DC Date issued: - -

                2002-11-12 -

                DC Date available: 2002-11-12 -

                DC Date modified: 2007-09-16 -

                DC -Date: 2007-09-16 -

                Version Information -

                Sourcefile: sisu_syntax_highlighting.sst - -

                Filetype: SiSU text insert 0.58 -

                Sourcefile Digest, MD5(sisu_syntax_highlighting.sst)= - -

                28dd0275c6fcd67bbedcd8aee9df4b3e -

                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)= - -

                20fc43cf3eb6590bc3399a1aef65c5a9 -

                Generated -

                Document (metaverse) last -generated: Mon Sep 24 15:36:17 +0100 2007 -

                Generated by: SiSU 0.59.0 of -2007w38/0 (2007-09-23) -

                Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) - [i486-linux] -

                -

                -

                - -
                Other versions of this document:
                -
                - -
                manifest: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_manifest.html - -> -
                -
                - -
                html: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/toc.html - ->
                -
                - -
                pdf: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/portrait.pdf - -> -
                -
                - -
                pdf: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/landscape.pdf - ->
                -
                - -
                at: -<http://www.jus.uio.no/sisu - ->
                -
                - -
                * Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) -
                -
                - -
                * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
                -
                - -
                * Last Generated -on: Mon Sep 24 15:36:32 +0100 2007
                -
                - -
                * SiSU http://www.jus.uio.no/sisu -
                -
                -
                -

                - - -- cgit v1.2.3