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.

597

21.2 A few book (and other) examples

598

Aukio, by Leena Krohn

¹⁸

599

"The Wealth of Networks", Yochai Benkler

600

"The Wealth of Networks", Yochai Benkler
     document manifest   ¹⁹
       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

601

"Two Bits", Christopher Kelty

602

"Two Bits", Christopher Kelty
     document manifest   ²⁰
       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

603

"Free Culture", Lawrence Lessig

604

"Free Culture", Lawrence Lessig
     document manifest   ²¹
       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

605

"Free as in Freedom: Richard Stallman's Crusade for Free Software", by Sam Williams

606

"Free as in Freedom: Richard Stallman's Crusade for Free Software", by Sam Williams
     document manifest   ²²
       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

607

"Free For All: How Linux and the Free Software Movement Undercut the High Tech Titans", by Peter Wayner

608

"Free For All: How Linux and the Free Software Movement Undercut the High Tech Titans", by Peter Wayner
     document manifest   ²³
       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

609

"The Cathedral and the Bazaar", by Eric S. Raymond

610

"The Cathedral and the Bazaar", by Eric S. Raymond
     document manifest   ²⁴
       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

611

"Accelerando", Charles Stross

612

"Accelerando", Charles Stross
     document manifest   ²⁵
       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

613

"Tainaron", Leena Krohn

614

"Tainaron", Leena Krohn
     document manifest   ²⁶
       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

615

"Sphinx or Robot", Leena Krohn

616

Sphinx or Robot by Leena Krohn

617

"Sphinx or Robot", Leena Krohn
     document manifest   ²⁷
       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

618

"War and Peace", Leo Tolstoy, PG Etext 2600

619

"War and Peace", Leo Tolstoy   ²⁸
     document manifest   ²⁹
       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

620

"Don Quixote", Miguel de Cervantes [Saavedra], translated by John Ormsby, PG Etext 996

621

"Don Quixote", Miguel de Cervantes [Saavedra]
     document manifest   ³⁰
       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

622

"Gulliver's Travels", Jonathan Swift, transcribed from the 1892 George Bell and Sons edition by David Price, PG Etext 829

623

"Gulliver's Travels", Jonathan Swift
     document manifest   ³¹
       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

624

"Alice's Adventures in Wonderland", Lewis Carroll, PG Etext 11

625

"Alice's Adventures in Wonderland", Lewis Carroll
     document manifest   ³²
       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

626

"Through The Looking-Glass", Lewis Carroll, PG Etext 12

627

"Through The Looking-Glass", Lewis Carroll
     document manifest   ³³
       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

628

"Alice's Adventures in Wonderland" and "Through The Looking-Glass", Lewis Carroll, PG Etexts 11 and 12

629

"Alice's Adventures in Wonderland" and "Through The Looking-Glass", Lewis Carroll
     document manifest   ³⁴
       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

630

"Gnu Public License 2", (GPL 2) Free Software Foundation

631

"Gnu Public License 2", (GPL 2) Free Software Foundation
     document manifest   ³⁵
       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

632

"Gnu Public License v3 - Third discussion draft", (GPLv3) Free Software Foundation

633

"Gnu Public License 3 - Third discussion draft", (GPL v3 draft3) Free Software Foundation
     document manifest   ³⁶
       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

634

"Debian Social Contract"

635

"Debian Social Contract"
     document manifest   ³⁷
       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

636

"Debian Constitution v1.3", (simple/default markup)

637

"Debian Constitution v1.3"
     document manifest   ³⁸
       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

638

"Debian Constitution v1.3", (markup adjusted for output to more closely match the original)

639

"Debian Constitution v1.3", (markup adjusted for output to more closely match the original)
     document manifest   ³⁹
       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

640

"Debian Constitution v1.2", (simple/default markup)

641

"Debian Constitution v1.2 (more translations)"
     document manifest   ⁴⁰
       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

642

"Debian Constitution v1.2", (markup adjusted for output to more closely match the original)

643

"Debian Constitution (more translations)", (markup adjusted for output to more closely match the original)
     document manifest   ⁴¹
       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

644

"A Uniform Sales Terminology", Vikki Rogers and Albert Kritzer

645

"A Uniform Sales Terminology", Vikki Rogers and Albert Kritzer
     document manifest   ⁴²
       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

646

"The Autonomous Contract" 1997 - markup sample

647

"The Autonomous Contract" 1997 - markup sample
     document manifest   ⁴³
       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

648

"The Autonomous Contract Revisited" - markup sample

649

"The Autonomous Contract Revisited" - markup sample   ⁴⁴
     document manifest   ⁴⁵
       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

650

"United Nations Convention on Contracts for the International Sale of Goods"

651

"United Nations Convention on Contracts for the International Sale of Goods"   ⁴⁶
     document manifest   ⁴⁷
       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

652

PECL the "Principles of European Contract Law"

653

"Principles of European Contract Law"
     document manifest   ⁴⁸
       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

654

21.3 SQL - PostgreSQL, SQLite

655

A Sample search form is available at <http://search.sisudoc.org>

656

A few canned searches, showing object numbers. Search for:

657

English documents matching Linux OR Debian

658

GPL OR Richard Stallman

659

invention OR innovation in English language

660

661

Note that the searches done in this form are case sensitive.

662

Expand those same searches, showing the matching text in each document:

663

English documents matching Linux OR Debian

664

GPL OR Richard Stallman

665

invention OR innovation in English language

666

667

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

668

21.4 Lex Mercatoria as an example

669

There is quite a bit to peruse if you explore the site Lex Mercatoria:

670

<http://www.lexmercatoria.org/> ⁵⁰

671

or perhaps:

672

<http://lexmercatoria.org/treaties.and.organisations/lm.chronological> ⁵¹

673

21.5 For good measure the markup for a document with lots of (simple) tables

674

SiSU is not optimised for table making, but does handle simple tables.

675

SiSU marked up file with tables ⁵²

676

Output of table file example ⁵³

677

21.6 And a link to the output of a reported case

678

<http://www.jus.uio.no/lm/england.fothergill.v.monarch.airlines.hl.1980/toc.html>

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

^19. <http://www.sisudoc.org/sisu/the_wealth_of_networks.yochai_benkler/sisu_manifest.html>

^20. <http://www.sisudoc.org/sisu/two_bits.christopher_kelty/sisu_manifest.html>

^21. <http://www.sisudoc.org/sisu/free_culture.lawrence_lessig/sisu_manifest.html>

^22. <http://www.sisudoc.org/sisu/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams/sisu_manifest.html>

^23. <http://www.sisudoc.org/sisu/free_for_all.peter_wayner/sisu_manifest.html>

^24. <http://www.sisudoc.org/sisu/the_cathedral_and_the_bazaar.eric_s_raymond/sisu_manifest.html>

^25. <http://www.sisudoc.org/sisu/accelerando.charles_stross/sisu_manifest.html>

^26. <http://www.sisudoc.org/sisu/tainaron.leena_krohn.1998/sisu_manifest.html>

^27. <http://www.sisudoc.org/sisu/sphinx_or_robot.leena_krohn.1996/sisu_manifest.html>

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

^29. <http://www.sisudoc.org/sisu/war_and_peace.leo_tolstoy/sisu_manifest.html>

^30. <http://www.sisudoc.org/sisu/don_quixote.miguel_de_cervantes/sisu_manifest.html>

^31. <http://www.sisudoc.org/sisu/gullivers_travels.jonathan_swift/sisu_manifest.html>

^32. <http://www.sisudoc.org/sisu/alices_adventures_in_wonderland.lewis_carroll/sisu_manifest.html>

^33. <http://www.sisudoc.org/sisu/through_the_looking_glass.lewis_carroll/sisu_manifest.html>

^34. <http://www.sisudoc.org/sisu/alices_adventures_in_wonderland_and_through_the_looking_glass.lewis_carroll/sisu_manifest.html>

^35. <http://www.sisudoc.org/sisu/gpl2.fsf/sisu_manifest.html>

^36. <http://www.sisudoc.org/sisu/gpl3_draft3.fsf/sisu_manifest.html>

^37. <http://www.sisudoc.org/sisu/debian_social_contract_v1.1/sisu_manifest.html>

^38. <http://www.sisudoc.org/sisu/debian_constitution_v1.3/sisu_manifest.html>

^39. <http://www.sisudoc.org/sisu/debian_constitution_v1.3.adjusted/sisu_manifest.html>

^40. <http://www.sisudoc.org/sisu/debian_constitution_v1.2/sisu_manifest.html>

^41. <http://www.sisudoc.org/sisu/debian_constitution_v1.2.adjusted/sisu_manifest.html>

^42. <http://www.sisudoc.org/sisu/a_uniform_international_sales_terminology.vikki_rogers.and.albert_kritzer/sisu_manifest.html>

^43. <http://www.sisudoc.org/sisu/the_autonomous_contract.amissah.19970710/sisu_manifest.html>

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

^45. <http://www.sisudoc.org/sisu/autonomy_markup0/sisu_manifest.html>

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

^47. <http://www.sisudoc.org/sisu/un_contracts_international_sale_of_goods_convention_1980/sisu_manifest.html>

^48. <http://www.sisudoc.org/sisu/eu_contract_principles_parts_1_to_3_2002/sisu_manifest.html>

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

^50. <http://www.jus.uio.no/lm/index>

^51. <http://www.jus.uio.no/lm/treaties.and.organisations/lm.chronological>

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

^53. <http://www.jus.uio.no/lm/un_conventions_membership_status/toc.html>


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

SiSU - Manual,Ralph Amissah

What is SiSU?

Markup Syntax History

Remote Document Output

Download information

SiSU - Manual,
Ralph Amissah