|
|
|
|
|
|
|
|
|
|
|
|
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
5. Commands Summary
5.1 Description
5.2 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 10
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
21.2.1 "Viral Spiral", David Bollier
"The Wealth of Networks", Yochai Benkler
"Two Bits", Christopher Kelty
"Free Culture", Lawrence Lessig
"CONTENT", Cory Doctorow
"Democratizing Innovation", by Eric von Hippel
"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
"Down and out in the Magic Kingdom", Cory Doctorow
"Little Brother", Cory Doctorow
"For the Win", Cory Doctorow
"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, EPUB
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?
Have you had any reports of building SiSU from tar on Mac OS 10.4?
44.12 Where is version 1?
44.13 What is the difference between version 1 and 2?
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.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
Endnotes
Metadata
SiSU Metadata, document information
Manifest
SiSU Manifest, alternative outputs etc.
SiSU - Manual,
What is SiSU?
Markup Syntax History
21.1 Markup examples
21.2 A few book (and other) examples
21.2.1 "Viral Spiral", David Bollier
"The Wealth of Networks", Yochai Benkler
"Two Bits", Christopher Kelty
"Free Culture", Lawrence Lessig
"CONTENT", Cory Doctorow
"Democratizing Innovation", by Eric von Hippel
"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
"Down and out in the Magic Kingdom", Cory Doctorow
"Little Brother", Cory Doctorow
"For the Win", Cory Doctorow
"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
Current markup examples and document output samples are provided at ‹http://www.jus.uio.no/sisu/SiSU/examples.html›
For some documents hardly any markup at all is required at all, other than a header, and an indication that the levels to be taken into account by the program in generating its output are.
"Viral Spiral", David Bollier
document manifest 20
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"The Wealth of Networks", Yochai Benkler
document manifest 21
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Two Bits", Christopher Kelty
document manifest 22
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Free Culture", Lawrence Lessig
document manifest 23
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"CONTENT", Cory Doctorow
document manifest 24
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Democratizing Innovation", by Eric von Hippel
document manifest 25
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Free as in Freedom: Richard Stallman's Crusade for Free Software", by Sam Williams
document manifest 26
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Free For All: How Linux and the Free Software Movement Undercut the High Tech Titans", by Peter Wayner
"Free For All: How Linux and the Free Software Movement Undercut the High Tech Titans", by Peter Wayner
document manifest 27
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"The Cathedral and the Bazaar", by Eric S. Raymond
document manifest 28
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Down and out in the Magic Kingdom", Cory Doctorow
document manifest 29
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Little Brother", Cory Doctorow
document manifest 30
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"For the Win", Cory Doctorow
document manifest 31
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Accelerando", Charles Stross
document manifest 32
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Tainaron", Leena Krohn
document manifest 33
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
Sphinx or Robot by Leena Krohn
"Sphinx or Robot", Leena Krohn
document manifest 34
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"War and Peace", Leo Tolstoy 35
document manifest 36
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Don Quixote", Miguel de Cervantes [Saavedra]
document manifest 37
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Gulliver's Travels", Jonathan Swift, transcribed from the 1892 George Bell and Sons edition by David Price, PG Etext 829
"Gulliver's Travels", Jonathan Swift
document manifest 38
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Alice's Adventures in Wonderland", Lewis Carroll
document manifest 39
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Through The Looking-Glass", Lewis Carroll
document manifest 40
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Alice's Adventures in Wonderland" and "Through The Looking-Glass", Lewis Carroll, PG Etexts 11 and 12
"Alice's Adventures in Wonderland" and "Through The Looking-Glass", Lewis Carroll
document manifest 41
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Gnu Public License 2", (GPL 2) Free Software Foundation
document manifest 42
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Gnu Public License 3 - Third discussion draft", (GPL v3 draft3) Free Software Foundation
document manifest 43
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Debian Social Contract"
document manifest 44
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Debian Constitution v1.3"
document manifest 45
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Debian Constitution v1.3", (markup adjusted for output to more closely match the original)
document manifest 46
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Debian Constitution v1.2 (more translations)"
document manifest 47
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Debian Constitution (more translations)", (markup adjusted for output to more closely match the original)
document manifest 48
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"A Uniform Sales Terminology", Vikki Rogers and Albert Kritzer
document manifest 49
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"The Autonomous Contract" 1997 - markup sample
document manifest 50
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"The Autonomous Contract Revisited" - markup sample 51
document manifest 52
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"United Nations Convention on Contracts for the International Sale of Goods" 53
document manifest 54
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
"Principles of European Contract Law"
document manifest 55
html, segmented text
html, scroll, document in one
epub
pdf, landscape
pdf, portrait
odf:odt, open document text
xhtml scroll
xml, sax
xml, dom
plain text utf-8
concordance
dcc, document content certificate (digests)
markup source text
markup source (zipped) pod
A Sample search form is available at ‹http://search.sisudoc.org›
A few canned searches, showing object numbers. Search for:
Note that the searches done in this form are case sensitive.
Expand those same searches, showing the matching text in each document:
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. 56
There is quite a bit to peruse if you explore the site Lex Mercatoria:
or perhaps:
SiSU is not optimised for table making, but does handle simple tables.
19. Reproduced with the kind permission of author and artist Leena Krohn, ‹http://www.kaapeli.fi/krohn› "Aukio" is from the work "Sphinx or Robot" ‹http://www.jus.uio.no/sisu/sphinx_or_robot.leena_krohn.1996› which is included as a book example in this section, together with another of the author's works, "Tainaron" ‹http://www.jus.uio.no/sisu/tainaron.leena_krohn.1998›
20. ‹http://www.sisudoc.org/sisu/viral_spiral.david_bollier/sisu_manifest.html›
21. ‹http://www.sisudoc.org/sisu/the_wealth_of_networks.yochai_benkler/sisu_manifest.html›
22. ‹http://www.sisudoc.org/sisu/two_bits.christopher_kelty/sisu_manifest.html›
23. ‹http://www.sisudoc.org/sisu/free_culture.lawrence_lessig/sisu_manifest.html›
24. ‹http://www.sisudoc.org/sisu/content.cory_doctorow/sisu_manifest.html›
25. ‹http://www.sisudoc.org/sisu/democratizing_innovation.eric_von_hippel/sisu_manifest.html›
26. ‹http://www.sisudoc.org/sisu/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams/sisu_manifest.html›
27. ‹http://www.sisudoc.org/sisu/free_for_all.peter_wayner/sisu_manifest.html›
28. ‹http://www.sisudoc.org/sisu/the_cathedral_and_the_bazaar.eric_s_raymond/sisu_manifest.html›
29. ‹http://www.sisudoc.org/sisu/down_and_out_in_the_magic_kingdom.cory_doctorow/sisu_manifest.html›
30. ‹http://www.sisudoc.org/sisu/little_brother.cory_doctorow/sisu_manifest.html›
31. ‹http://www.sisudoc.org/sisu/for_the_win.cory_doctorow/sisu_manifest.html›
32. ‹http://www.sisudoc.org/sisu/accelerando.charles_stross/sisu_manifest.html›
33. ‹http://www.sisudoc.org/sisu/tainaron.leena_krohn.1998/sisu_manifest.html›
34. ‹http://www.sisudoc.org/sisu/sphinx_or_robot.leena_krohn.1996/sisu_manifest.html›
35. ‹http://www.jus.uio.no/sisu/war_and_peace.leo_tolstoy/toc.html›
The ascii text was taken from Project Gutenberg. The markup transforms required are trivial. Of interest, in this instance I am saved by having alternative syntaxes/(structural modes) for marking up endnotes... as it was possible to do a simple search and replace to make the Project Gutenberg ascii presentation suitable for SiSU, using the older endnote markup style. This example instructs the program to use regular expressions, in this example the words: none; none; BOOK|FIRST|SECOND; CHAPTER; occurring at the beginning of a line, to identify what should be treated as different levels of heading in a document (and used to make the table of contents). Note that there was very little markup required after the document headers and Project Gutenberg legal notices. As I presume the legal notices are similar in Project Gutenberg documents, (and I could not bear to think of preparing the same legal notices twice), I moved those to the "skin" for the Project, and these are now represented in the markup by <:insert1> and <:insert2> and the legal notices are available for similar insertion into the next Project Gutenberg text prepared for SiSU, should there be one.
I did a stylesheet/skin for the Gutenberg Project, ... I may have to remove.
36. ‹http://www.sisudoc.org/sisu/war_and_peace.leo_tolstoy/sisu_manifest.html›
37. ‹http://www.sisudoc.org/sisu/don_quixote.miguel_de_cervantes/sisu_manifest.html›
38. ‹http://www.sisudoc.org/sisu/gullivers_travels.jonathan_swift/sisu_manifest.html›
39. ‹http://www.sisudoc.org/sisu/alices_adventures_in_wonderland.lewis_carroll/sisu_manifest.html›
40. ‹http://www.sisudoc.org/sisu/through_the_looking_glass.lewis_carroll/sisu_manifest.html›
41. ‹http://www.sisudoc.org/sisu/alices_adventures_in_wonderland_and_through_the_looking_glass.lewis_carroll/sisu_manifest.html›
42. ‹http://www.sisudoc.org/sisu/gpl2.fsf/sisu_manifest.html›
43. ‹http://www.sisudoc.org/sisu/gpl3_draft3.fsf/sisu_manifest.html›
44. ‹http://www.sisudoc.org/sisu/debian_social_contract_v1.1/sisu_manifest.html›
45. ‹http://www.sisudoc.org/sisu/debian_constitution_v1.3/sisu_manifest.html›
46. ‹http://www.sisudoc.org/sisu/debian_constitution_v1.3.adjusted/sisu_manifest.html›
47. ‹http://www.sisudoc.org/sisu/debian_constitution_v1.2/sisu_manifest.html›
48. ‹http://www.sisudoc.org/sisu/debian_constitution_v1.2.adjusted/sisu_manifest.html›
49. ‹http://www.sisudoc.org/sisu/a_uniform_international_sales_terminology.vikki_rogers.and.albert_kritzer/sisu_manifest.html›
50. ‹http://www.sisudoc.org/sisu/the_autonomous_contract.amissah.19970710/sisu_manifest.html›
51. ‹http://www.jus.uio.no/sisu/autonomy_markup0/toc.html›
alternative markup variations revolving around endnotes
(i) as above, markup with embedded endnotes, and header list of words/phrases to emphasise
‹http://www.jus.uio.no/sisu/sample/syntax/autonomy_markup0.sst.html›
‹http://www.jus.uio.no/sisu/sample/markup/autonomy_markup0.sst›
(ii) Again markup with embedded endnotes, but font faces changed within paragraphs rather than in header as in i
‹http://www.jus.uio.no/sisu/sample/syntax/autonomy_markup1.sst.html›
‹http://www.jus.uio.no/sisu/sample/markup/autonomy_markup1.sst›
(iii) Markup with endnote placemarks within paragraphs, the endnotes following the paragraph that contains them ‹http://www.jus.uio.no/sisu/sample/syntax/autonomy_markup2.sst.html›
‹http://www.jus.uio.no/sisu/sample/markup/autonomy_markup2.sst›
(iv) Another alternative is to place the marked up endnotes sequentially and at the end of the text. This also works. The paragraph variant iii is perhaps easier to visually check should there be missing endnotes; but this variant iv may better suit the conversion of alternatively pre-prepared documents.
52. ‹http://www.sisudoc.org/sisu/autonomy_markup0/sisu_manifest.html›
53. ‹http://www.jus.uio.no/sisu/un_contracts_international_sale_of_goods_convention_1980/toc.html›
This example instructs the program to use regular expressions, in this example the words: Part, Chapter, Section, Article occurring at the beginning of a line, to identify what should be treated as different levels of heading in a document (and used to make the table of contents).
This example instructs the program to use regular expressions, in this example the words: Part, Chapter, Section, Article occurring at the beginning of a line, to identify what should be treated as different levels of heading in a document (and used to make the table of contents).
54. ‹http://www.sisudoc.org/sisu/un_contracts_international_sale_of_goods_convention_1980/sisu_manifest.html›
55. ‹http://www.sisudoc.org/sisu/eu_contract_principles_parts_1_to_3_2002/sisu_manifest.html›
56. 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.
57. ‹http://www.jus.uio.no/lm/index›
58. ‹http://www.jus.uio.no/lm/treaties.and.organisations/lm.chronological›
59. ‹http://www.jus.uio.no/lm/un.conventions.membership.status/toc.html›