SiSU
Markup Samples, Output Examples
Ralph Amissah
copy @
SiSU
Rights: Copyright © Ralph Amissah 2007, part of SiSU documentation, License GPL 3
1
SiSU - Markup Samples, Output Examples, Ralph Amissah
2
SiSU Markup and Output Examples
3
1. Markup and Output Examples
7
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.
8
1.2 A few book (and other) examples
9
Aukio, by Leena Krohn
1
10
"The Wealth of Networks" , Yochai Benkler
11
"The Wealth of Networks", Yochai Benkler document manifest 2 html, segmented text html, scroll, document in one 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
12
"Two Bits" , Christopher Kelty
13
"Two Bits", Christopher Kelty document manifest 3 html, segmented text html, scroll, document in one 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
14
"Free Culture" , Lawrence Lessig
15
"Free Culture", Lawrence Lessig document manifest 4 html, segmented text html, scroll, document in one 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
16
"Free as in Freedom: Richard Stallman's Crusade for Free Software" , by Sam Williams
17
"Free as in Freedom: Richard Stallman's Crusade for Free Software", by Sam Williams document manifest 5 html, segmented text html, scroll, document in one 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
18
"Free For All: How Linux and the Free Software Movement Undercut the High Tech Titans" , by Peter Wayner
19
"Free For All: How Linux and the Free Software Movement Undercut the High Tech Titans", by Peter Wayner document manifest 6 html, segmented text html, scroll, document in one 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
20
"The Cathedral and the Bazaar" , by Eric S. Raymond
21
"The Cathedral and the Bazaar", by Eric S. Raymond document manifest 7 html, segmented text html, scroll, document in one 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
22
"Accelerando" , Charles Stross
23
"Accelerando", Charles Stross document manifest 8 html, segmented text html, scroll, document in one 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
24
"Tainaron" , Leena Krohn
25
"Tainaron", Leena Krohn document manifest 9 html, segmented text html, scroll, document in one 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
26
"Sphinx or Robot" , Leena Krohn
27
Sphinx or Robot by Leena Krohn
28
"Sphinx or Robot", Leena Krohn document manifest 10 html, segmented text html, scroll, document in one 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
29
"War and Peace" , Leo Tolstoy, PG Etext 2600
30
"War and Peace", Leo Tolstoy 11 document manifest 12 html, segmented text html, scroll, document in one 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
31
"Don Quixote" , Miguel de Cervantes [Saavedra], translated by John Ormsby, PG Etext 996
32
"Don Quixote", Miguel de Cervantes [Saavedra] document manifest 13 html, segmented text html, scroll, document in one 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
33
"Gulliver's Travels" , Jonathan Swift, transcribed from the 1892 George Bell and Sons edition by David Price, PG Etext 829
34
"Gulliver's Travels", Jonathan Swift document manifest 14 html, segmented text html, scroll, document in one 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
35
"Alice's Adventures in Wonderland" , Lewis Carroll, PG Etext 11
36
"Alice's Adventures in Wonderland", Lewis Carroll document manifest 15 html, segmented text html, scroll, document in one 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
37
"Through The Looking-Glass" , Lewis Carroll, PG Etext 12
38
"Through The Looking-Glass", Lewis Carroll document manifest 16 html, segmented text html, scroll, document in one 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
39
"Alice's Adventures in Wonderland" and "Through The Looking-Glass" , Lewis Carroll, PG Etexts 11 and 12
40
"Alice's Adventures in Wonderland" and "Through The Looking-Glass", Lewis Carroll document manifest 17 html, segmented text html, scroll, document in one 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
41
"Gnu Public License 2" , (GPL 2) Free Software Foundation
42
"Gnu Public License 2", (GPL 2) Free Software Foundation document manifest 18 html, segmented text html, scroll, document in one 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
43
"Gnu Public License v3 - Third discussion draft" , (GPLv3) Free Software Foundation
44
"Gnu Public License 3 - Third discussion draft", (GPL v3 draft3) Free Software Foundation document manifest 19 html, segmented text html, scroll, document in one 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
45
"Debian Social Contract"
47
"Debian Constitution v1.3" , (simple/default markup)
49
"Debian Constitution v1.3" , (markup adjusted for output to more closely match the original)
50
"Debian Constitution v1.3", (markup adjusted for output to more closely match the original) document manifest 22 html, segmented text html, scroll, document in one 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
51
"Debian Constitution v1.2" , (simple/default markup)
53
"Debian Constitution v1.2" , (markup adjusted for output to more closely match the original)
54
"Debian Constitution (more translations)", (markup adjusted for output to more closely match the original) document manifest 24 html, segmented text html, scroll, document in one 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
55
"A Uniform Sales Terminology" , Vikki Rogers and Albert Kritzer
56
"A Uniform Sales Terminology", Vikki Rogers and Albert Kritzer document manifest 25 html, segmented text html, scroll, document in one 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
57
"The Autonomous Contract" 1997 - markup sample
59
"The Autonomous Contract Revisited" - markup sample
61
"United Nations Convention on Contracts for the International Sale of Goods"
63
PECL the "Principles of European Contract Law"
65
1.3 SQL - PostgreSQL, SQLite
67
A few canned searches, showing object numbers. Search for:
72
Note that the searches done in this form are case sensitive.
73
Expand those same searches, showing the matching text in each document:
78
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. 32
79
1.4 Lex Mercatoria as an example
80
There is quite a bit to peruse if you explore the site Lex Mercatoria:
84
1.5 For good measure the markup for a document with lots of (simple) tables
85
SiSU is not optimised for table making, but does handle simple tables.
88
1.6 And a link to the output of a reported case
1. 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 >
2. <http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler/sisu_manifest.html >
3. <http://www.jus.uio.no/sisu/two_bits.christopher_kelty/sisu_manifest.html >
4. <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisu_manifest.html >
5. <http://www.jus.uio.no/sisu/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams/sisu_manifest.html >
6. <http://www.jus.uio.no/sisu/free_for_all.peter_wayner/sisu_manifest.html >
7. <http://www.jus.uio.no/sisu/the_cathedral_and_the_bazaar.eric_s_raymond/sisu_manifest.html >
8. <http://www.jus.uio.no/sisu/accelerando.charles_stross/sisu_manifest.html >
9. <http://www.jus.uio.no/sisu/tainaron.leena_krohn.1998/sisu_manifest.html >
10. <http://www.jus.uio.no/sisu/sphinx_or_robot.leena_krohn.1996/sisu_manifest.html >
11. <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. 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 is possible to do a simple search and replace to make Project Gutenberg ascii presentations suitable for SiSU using the older endnote markup style. There is 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 the < :insert1> and < :insert2> markers and the legal notices are available for similar insertion into the next Project Gutenberg text prepared for SiSU , should there be one.
12. <http://www.jus.uio.no/sisu/war_and_peace.leo_tolstoy/sisu_manifest.html >
13. <http://www.jus.uio.no/sisu/don_quixote.miguel_de_cervantes/sisu_manifest.html >
14. <http://www.jus.uio.no/sisu/gullivers_travels.jonathan_swift/sisu_manifest.html >
15. <http://www.jus.uio.no/sisu/alices_adventures_in_wonderland.lewis_carroll/sisu_manifest.html >
16. <http://www.jus.uio.no/sisu/through_the_looking_glass.lewis_carroll/sisu_manifest.html >
17. <http://www.jus.uio.no/sisu/alices_adventures_in_wonderland_and_through_the_looking_glass.lewis_carroll/sisu_manifest.html >
18. <http://www.jus.uio.no/sisu/gpl2.fsf/sisu_manifest.html >
19. <http://www.jus.uio.no/sisu/gpl3_draft3.fsf/sisu_manifest.html >
20. <http://www.jus.uio.no/sisu/debian_social_contract_v1.1/sisu_manifest.html >
21. <http://www.jus.uio.no/sisu/debian_constitution_v1.3/sisu_manifest.html >
22. <http://www.jus.uio.no/sisu/debian_constitution_v1.3.adjusted/sisu_manifest.html >
23. <http://www.jus.uio.no/sisu/debian_constitution_v1.2/sisu_manifest.html >
24. <http://www.jus.uio.no/sisu/debian_constitution_v1.2.adjusted/sisu_manifest.html >
25. <http://www.jus.uio.no/sisu/a_uniform_international_sales_terminology.vikki_rogers.and.albert_kritzer/sisu_manifest.html >
26. <http://www.jus.uio.no/sisu/the_autonomous_contract.amissah.19970710/sisu_manifest.html >
27. <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.
28. <http://www.jus.uio.no/sisu/autonomy_markup0/sisu_manifest.html >
29. <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).
30. <http://www.jus.uio.no/sisu/un_contracts_international_sale_of_goods_convention_1980/sisu_manifest.html >
31. <http://www.jus.uio.no/sisu/eu_contract_principles_parts_1_to_3_2002/sisu_manifest.html >
32. 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.
33. <http://www.jus.uio.no/lm/index >
34. <http://www.jus.uio.no/lm/treaties.and.organisations/lm.chronological >
35. <http://www.jus.uio.no/sisu/sample/syntax/un_conventions_membership_status.sst.html > <http://www.jus.uio.no/sisu/sample/markup/un_conventions_membership_status.sst >
36. <http://www.jus.uio.no/lm/un_conventions_membership_status/toc.html >
Document Information (metadata)
Metadata
DC tags included with this document are provided here.
Title: SiSU - Markup Samples, Output Examples
Rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
Date available: 2002-11-12
Date modified: 2007-09-16
Sourcefile: sisu_examples.sst
Filetype: symbolic link to `/home/ralph/grotto/theatre/scribe/sisu/src/sisu_examples.sst'
Sourcefile Digest, MD5(sisu_examples.sst)= 7bfcbd475513adeb0989cb4d10e34b3c
Skin_Digest: MD5(skin_sisu.rb)= ddff1ac8cec07711593d5b1011be9bb1
Document (metaverse) last generated: Sun Jan 18 21:34:51 -0500 2009
Generated by: SiSU 0.70.5 of 2009w02/7 (2009-01-18)
Ruby version: ruby 1.8.7 (2008-08-11 patchlevel 72) [i486-linux]
Output generated by
SiSU
0.70.5 2009-01-18 (2009w02/7)
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.
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!