SiSU -->

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

idx txt

SiSU - Manual,
Ralph Amissah

What is SiSU?

1. Introduction - What is SiSU?

2. How does sisu work?

3. Summary of features

4. Help

4.1 SiSU Manual
4.2 SiSU man pages
4.3 SiSU built-in interactive help
4.4 Help Sources

5. Commands Summary

5.1 Synopsis
5.2 Description
5.3 Document Processing Command Flags

6. command line modifiers

7. database commands

8. Shortcuts, Shorthand for multiple flags

8.1 Command Line with Flags - Batch Processing

9. Introduction to SiSU Markup 

9.1 Summary
9.2 Markup Examples
9.2.1 Online
9.2.2 Installed

10. Markup of Headers

10.1 Sample Header
10.2 Available Headers

11. Markup of Substantive Text

11.1 Heading Levels
11.2 Font Attributes
11.3 Indentation and bullets
11.4 Footnotes / Endnotes
11.5 Links
11.5.1 Naked URLs within text, dealing with urls
11.5.2 Linking Text
11.5.3 Linking Images
11.6 Grouped Text
11.6.1 Tables
11.6.2 Poem
11.6.3 Group
11.6.4 Code
11.7 Book index

12. Composite documents markup

Markup Syntax History

13. Notes related to Files-types and Markup Syntax

14. SiSU filetypes

14.1 .sst .ssm .ssi marked up plain text
14.1.1 sisu text - regular files (.sst)
14.1.2 sisu master files (.ssm)
14.1.3 sisu insert files (.ssi)
14.2 sisupod, zipped binary container (sisupod.zip, .ssp)

15. Experimental Alternative Input Representations

15.1 Alternative XML
15.1.1 XML SAX representation
15.1.2 XML DOM representation
15.1.3 XML Node representation

16. Configuration

16.1 Determining the Current Configuration
16.2 Configuration files (config.yml)

17. Skins

17.1 Document Skin
17.2 Directory Skin
17.3 Site Skin
17.4 Sample Skins

18. CSS - Cascading Style Sheets (for html, XHTML and XML)

19. Organising Content

19.1 Directory Structure and Mapping
19.1.1 General Directories
19.1.2 Remote Directories
19.1.3 Sisupod
19.2 Organising Content

20. Homepages

20.1 Home page and other custom built pages in a sub-directory
20.2 Home page within a skin

21. Markup and Output Examples

21.1 Markup examples
21.2 A few book (and other) examples
"The Wealth of Networks", Yochai Benkler
"Two Bits", Christopher Kelty
"Free Culture", Lawrence Lessig
"Free as in Freedom: Richard Stallman's Crusade for Free Software", by Sam Williams
"Free For All: How Linux and the Free Software Movement Undercut the High Tech Titans", by Peter Wayner
"The Cathedral and the Bazaar", by Eric S. Raymond
"Accelerando", Charles Stross
"Tainaron", Leena Krohn
"Sphinx or Robot", Leena Krohn
"War and Peace", Leo Tolstoy, PG Etext 2600
"Don Quixote", Miguel de Cervantes [Saavedra], translated by John Ormsby, PG Etext 996
"Gulliver's Travels", Jonathan Swift, transcribed from the 1892 George Bell and Sons edition by David Price, PG Etext 829
"Alice's Adventures in Wonderland", Lewis Carroll, PG Etext 11
"Through The Looking-Glass", Lewis Carroll, PG Etext 12
"Alice's Adventures in Wonderland" and "Through The Looking-Glass", Lewis Carroll, PG Etexts 11 and 12
"Gnu Public License 2", (GPL 2) Free Software Foundation
"Gnu Public License v3 - Third discussion draft", (GPLv3) Free Software Foundation
"Debian Social Contract"
"Debian Constitution v1.3", (simple/default markup)
"Debian Constitution v1.3", (markup adjusted for output to more closely match the original)
"Debian Constitution v1.2", (simple/default markup)
"Debian Constitution v1.2", (markup adjusted for output to more closely match the original)
"A Uniform Sales Terminology", Vikki Rogers and Albert Kritzer
"The Autonomous Contract" 1997 - markup sample
"The Autonomous Contract Revisited" - markup sample
"United Nations Convention on Contracts for the International Sale of Goods"
PECL the "Principles of European Contract Law"
21.3 SQL - PostgreSQL, SQLite
21.4 Lex Mercatoria as an example
21.5 For good measure the markup for a document with lots of (simple) tables
21.6 And a link to the output of a reported case

22. A Checklist of Output Features

23. SiSU Search - Introduction

24. SQL

24.1 populating SQL type databases

25. Postgresql

25.1 Name
25.2 Description
25.3 Synopsis
25.4 Commands
25.4.1 create and destroy database
25.4.2 import and remove documents

26. Sqlite

26.1 Name
26.2 Description
26.3 Synopsis
26.4 Commands
26.4.1 create and destroy database
26.4.2 import and remove documents

27. Introduction

27.1 Search - database frontend sample, utilising database and SiSU features, including object citation numbering (backend currently PostgreSQL)
27.2 Search Form

28. Hyperestraier

29. sisu_webrick

29.1 Name
29.2 Synopsis
29.3 Description
29.4 Summary of man page
29.5 Document processing command flags
29.6 Further information
29.7 Author
29.8 SEE ALSO

30. Remote Source Documents

Remote Document Output

31. Remote Output

31.1 commands
31.2 configuration

32. Remote Servers

Download information

33. Download SiSU - Linux/Unix

SiSU Current Version - Linux/Unix
Source (tarball tar.gz)
Git (source control management)
Debian
RPM

Installation

34. Installation

34.1 Debian
34.2 Other Unix / Linux
34.2.1 source tarball

35. SiSU Components, Dependencies and Notes

35.1 sisu
35.2 sisu-complete
35.3 sisu-examples
35.4 sisu-pdf
35.5 sisu-postgresql
35.6 sisu-remote
35.7 sisu-sqlite

36. Quickstart - Getting Started Howto

36.1 Installation
36.1.1 Debian Installation
36.1.2 RPM Installation
36.1.3 Installation from source
36.2 Testing SiSU, generating output
36.2.1 basic text, plaintext, html, XML, ODF
36.2.2 LaTeX / pdf
36.2.3 relational database - postgresql, sqlite
36.3 Getting Help
36.3.1 The man pages
36.3.2 Built in help
36.3.3 The home page
36.4 Markup Samples

HowTo

37. Getting Help

37.1 SiSU "man" pages
37.2 SiSU built-in help
37.3 Command Line with Flags - Batch Processing

38. Setup, initialisation

38.1 initialise output directory
38.1.1 Use of search functionality, an example using sqlite
38.2 misc
38.2.1 url for output files -u -U
38.2.2 toggle screen color
38.2.3 verbose mode
38.2.4 quiet mode
38.2.5 maintenance mode intermediate files kept -M
38.2.6 start the webrick server
38.3 remote placement of output

39. Configuration Files

40. Markup

40.1 Headers
40.2 Font Face
40.2.1 Bold
40.2.2 Italics
40.2.3 Underscore
40.2.4 Strikethrough
40.3 Endnotes
40.4 Links
40.5 Number Titles
40.6 Line operations
40.7 Tables
40.8 Grouped Text
40.9 Composite Document

41. Change Appearance

41.1 Skins
41.2 CSS

Extracts from the README

42. README

42.1 Online Information, places to look
42.2 Installation
42.2.1 Debian
42.2.2 RPM
42.2.3 Source package .tgz
42.2.4 to use setup.rb
42.2.5 to use install (prapared with "Rake")
42.2.6 to use install (prapared with "Rant")
42.3 Dependencies
42.4 Quick start
42.5 Configuration files
42.6 Use General Overview
42.7 Help
42.8 Directory Structure
42.9 Configuration File
42.10 Markup
42.11 Additional Things
42.12 License
42.13 SiSU Standard

Extracts from man 8 sisu

43. Post Installation Setup

43.1 Post Installation Setup - Quick start
43.2 Document markup directory
43.2.1 Configuration files
43.2.2 Debian INSTALLATION Note
43.2.3 Document Resource Configuration
43.2.4 Skins

44. FAQ - Frequently Asked/Answered Questions

44.1 Why are urls produced with the -v (and -u) flag that point to a web server on port 8081?
44.2 I cannot find my output, where is it?
44.3 I do not get any pdf output, why?
44.4 Where is the latex (or some other interim) output?
44.5 Why isn't SiSU markup XML
44.6 LaTeX claims to be a document preparation system for high-quality typesetting. Can the same be said about SiSU?
44.7 Can the SiSU markup be used to prepare for a LaTex automatic building of an index to the work?
44.8 Can the conversion from SiSU to LaTeX be modified if we have special needs for the LaTeX, or do we need to modify the LaTeX manually?
44.9 How do I create GIN or GiST index in Postgresql for use in SiSU
44.10 Are there some examples of using Ferret Search with a SiSU repository?
44.11 Have you had any reports of building SiSU from tar on Mac OS 10.4?
44.12 Where is version 1.0?

45. Who might be interested in the SiSU feature set?

46. Work Needed

47. Wishlist

48. Editor Files, Syntax Highlighting

49. Help Sources

49.1 man pages
49.1.1 man
49.2 sisu generated output - links to html
49.2.1 www.sisudoc.org
49.3 man2html
49.3.1 locally installed
49.3.2 www.jus.uio.no/sisu

Endnotes

Manifest (alternative outputs)

Metadata

SiSU manifest of document filetypes and metadata

SiSU - Manual

Ralph Amissah

  Document, Available Filetypes

  Document Metadata

      (metadata suggested links (if any)

Available document filetypes

filetype description

filename

file size

(kB)

TOC linked HTML, table of contents (for segmented text)

toc.html

<http://www.sisudoc.org/sisu/sisu_manual/toc.html>

45.1

Full Text HTML, full length document

doc.html

<http://www.sisudoc.org/sisu/sisu_manual/doc.html>

664.7

PDF portrait PDF, U.S. letter size, portrait/vertical document (recommended for printing)

portrait.letter.pdf

<http://www.sisudoc.org/sisu/sisu_manual/portrait.letter.pdf>

991.6

PDF landscape PDF, U.S. letter size, landscape/horizontal document (recommended for screen viewing)

landscape.letter.pdf

<http://www.sisudoc.org/sisu/sisu_manual/landscape.letter.pdf>

959.3

PDF portrait PDF, A4 size, portrait/vertical document (recommended for printing)

portrait.a4.pdf

<http://www.sisudoc.org/sisu/sisu_manual/portrait.a4.pdf>

985.2

PDF landscape PDF, A4 size, landscape/horizontal document (recommended for screen viewing)

landscape.a4.pdf

<http://www.sisudoc.org/sisu/sisu_manual/landscape.a4.pdf>

957.7

ODF/ODT ODF:ODT (Open Document Format)

opendocument.odt

<http://www.sisudoc.org/sisu/sisu_manual/opendocument.odt>

296.9

● XHTML

scroll.xhtml

<http://www.sisudoc.org/sisu/sisu_manual/scroll.xhtml>

510.6

● XML SAX

sax.xml

<http://www.sisudoc.org/sisu/sisu_manual/sax.xml>

532.0

● XML DOM

dom.xml

<http://www.sisudoc.org/sisu/sisu_manual/dom.xml>

610.9

● Plaintext (Unix (UTF-8) with footnotes)

plain.txt

<http://www.sisudoc.org/sisu/sisu_manual/plain.txt>

248.7

● Concordance file (HTML - wordmap, alphabetical wordlist)

concordance.html

<http://www.sisudoc.org/sisu/sisu_manual/concordance.html>

1159.5

● Digest/DCC - Document Content Certificate (md5)

digest.txt

<http://www.sisudoc.org/sisu/sisu_manual/digest.txt>

195.6

Markup Composite File (SiSU source)

sisu_manual.ssm.sst   094edf7284fc13e323e39cf69bea2ec2
<http://www.sisudoc.org/sisu/src/sisu_manual.ssm.sst>

243.3

SiSU doc (zip)

sisu_manual.ssm.zip   3d0fb5adcbd39141a83de2674290c5d9
<http://www.sisudoc.org/sisu/pod/sisu_manual.ssm.zip>

131.6

Document Metadata

metadata

description

DC Title:

SiSU - Manual

Title:

SiSU

Subtitle:

Manual

DC Creator:

Ralph Amissah

DC Publisher:

SiSU http://www.jus.uio.no/sisu (this copy)

DC Subject:

ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search

DC Type:

information

DC Rights:

Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3

DC Date:

2008-07-21

DC Date created:

2002-08-28

DC Date issued:

2002-08-28

DC Date available:

2002-08-28

DC Date modified:

2008-07-21

DC Language:

English

DC Identifier:

http://www.sisudoc.org/sisu/sisu_manual/toc.html

Topics Registered:

SiSU

manual

electronic documents

SiSU

manual

Sourcefile:

sisu_manual.ssm.sst

Word Count approximate:

31397

Sourcefile Digest (md5):

d822e0a897570f5b6b1db80f377590d2

Document (metaverse) last generated:

Wed Dec 10 22:20:55 -0500 2008

Generated by:

SiSU 0.70.0 2008w48/3 (2008-12-03)

Ruby version:

ruby 1.8.7 (2008-08-11 patchlevel 72) [i486-linux]

metadata suggested links:

●

SiSU Manual

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

●

Book Samples and Markup Examples

  <http://www.jus.uio.no/sisu/SiSU/examples.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>

●

SiSU help

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

●

SiSU help sources

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

Document Language Versions, manifests

filename

description

 

English

English

<http://www.sisudoc.org/sisu/sisu_manual/sisu_manifest.html>

 

SiSU

Output generated by SiSU 0.70.0 2008-12-03 (2008w48/3)
SiSU Copyright © Ralph Amissah 1997, current 2008. All Rights Reserved.
SiSU is software for document structuring, publishing and search,
www.jus.uio.no/sisu and www.sisudoc.org
w3 since October 3 1993 ralph@amissah.com

SiSU using:
Standard SiSU markup syntax,
Standard SiSU meta-markup syntax, and the
Standard SiSU object citation numbering and system, (object/text positioning system)
Copyright © Ralph Amissah 1997, current 2008. All Rights Reserved.

GPLv3

SiSU is released under GPLv3 or later, <http://www.gnu.org/licenses/gpl.html>

SiSU, developed using Ruby on Debian/Gnu/Linux software infrastructure, with the usual GPL (or OSS) suspects.
Better - "performance, reliability, scalability, security & total cost of ownership" [not to mention flexibility & choice] use of and adherence to open standards (where practical and fair) and it is software libré.
Get With the Future Way Better!