SiSU -->
[ document manifest ]
<< previous TOC next >>
< ^ >

SiSU - SiSU information Structuring Universe - Structured information, Serialized Units,
Ralph Amissah

Structured information, Serialized Units

SiSU - from less markup than the most elementary equivalent html, you can have more

1. Description

1.1 Outline
1.2 Short summary of features
1.3 How it works
1.4 Simple markup
1.4.1 Sparse markup requirement, try to get the most out of markup
1.4.2 Single markup file provides multiple output formats
1.4.3 Syntax relatively easy to read and remember
1.4.4 Kept simple by having a limited publishing feature set, and features identified as most important, are available across several document types
1.5 Designed with usability in mind
1.6 Code separate from content
1.7 Object citation numbering, a text or object positioning / citation system - "paragraph" (or text object) numbering, that remains same and usable across all output formats by people and machine
1.8 Handling of Dublin Core meta-tags making use of the Resource Description Framework
1.9 Easy directory management
1.10 Document Version Control Information
1.11 Table of contents
1.12 Auto-numbering of headings
1.13 Numbering and cross-hyperlinking of endnotes
1.14 "Skinnable"
1.15 Multiple Outputs
1.15.1 html - several presentations: full length & segmented; css & table based
1.15.2 EPUB
1.15.3 XML
1.15.4 ODT:ODF, Open Document Format - ISO/IEC 26300:2006
1.15.5 PDF - portrait and landscape, (through the generation of LaTeX output which is then transformed to pdf)
1.15.6 Search - loading/populating of relational database while retaining document structure information, object citation numbering and other features (currently PostgreSQL and/or SQLite)
1.15.7 Search - database frontend sample, utilising database and SiSU features, including object citation numbering (backend currently PostgreSQL)
1.15.8 Other forms
1.16 Concordance / Word Map or rudimentary index
1.17 Managed (document) directory, database, or site structure
1.18 Batch processing
1.19 Integration to superior Gnu/Linux and Unix tools
1.19.1 Backup and version control
1.19.2 Editor support
1.20 Modular design, need something new add a module

2. Markup and Output Examples

2.1 Markup examples
2.2 A few book (and other) examples
2.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"
2.3 SQL - PostgreSQL, SQLite
2.4 Lex Mercatoria as an example
2.5 For good measure the markup for a document with lots of (simple) tables
2.6 And a link to the output of a reported case

3. A Checklist of Output Features

4. Introduction to SiSU Markup  114 

4.1 Summary
4.2 Markup Examples
4.2.1 Online
4.2.2 Installed

5. Markup of Headers

5.1 Sample Header
5.2 Available Headers

6. Markup of Substantive Text

6.1 Heading Levels
6.2 Font Attributes
6.3 Indentation and bullets
6.4 Footnotes / Endnotes
6.5 Links
6.5.1 Naked URLs within text, dealing with urls
6.5.2 Linking Text
6.5.3 Linking Images
6.6 Grouped Text
6.6.1 Tables
6.6.2 Poem
6.6.3 Group
6.6.4 Code
6.7 Book index

7. Composite documents markup

Markup Syntax History

8. Notes related to Files-types and Markup Syntax

9. Commands Summary

9.1 Description
9.2 Document Processing Command Flags

10. command line modifiers

11. database commands

12. Shortcuts, Shorthand for multiple flags

12.1 Command Line with Flags - Batch Processing

Technical Information

13. Technical notes

13.1 See abandoned U.S. Provisional Patent Application

14. Diagram / Chart

14.1 The Chart
14.2 I/O
14.3 The Program
14.4 Software utilised
14.4.1 SiSU
14.4.2 SiSU Modules

15. SiSU development environment and technologies of interest, including data formats

15.1 Development environment, Debian
15.2 Programming language, Ruby
15.3 SGML & XML Family
15.3.1 SGML
15.3.2 XML Family
15.4 TeX Family
15.5 Pdf
15.6 Relational Databases, SQL
15.7 Other Databases
15.8 Text Search
15.9 Character Encoding, Unicode
15.10 Information Visualization
15.11 Metadata - semantic
15.12 Syndication, Web feed formats
15.13 Other
15.14 Editors
15.15 Version Control
15.16 Licenses

A Summary of notable events

16. A history of SiSU and its outputs including search

A Chronological history of developments on SiSU

1993

1994

1995

1996

1997

1998

1999

2000

2001

2002

2003

January
February
March
April
June
July
August
September
November
December

2004

January
February
March
April
May
June
July
August
September
October
November
December

2005

January
February
March
April
May
June
July
August
September
October
November
December

2006

January
February
March
April
May
June
July
August
September
October
November
December

2007

January
February
March
April
May
June
July
August
September
November
December

2008

January
February
April
June
September
October
November
December

2009

January
December

2010

March

2010

March

FAQ, Howto, Installation, etc.

HowTo

17. Getting Help

17.1 SiSU "man" pages
17.2 SiSU built-in help
17.3 Command Line with Flags - Batch Processing

18. Setup, initialisation

18.1 initialise output directory
18.1.1 Use of search functionality, an example using sqlite
18.2 misc
18.2.1 url for output files -u -U
18.2.2 toggle screen color
18.2.3 verbose mode
18.2.4 quiet mode
18.2.5 maintenance mode intermediate files kept -M
18.2.6 start the webrick server
18.3 remote placement of output

19. Configuration Files

20. Markup

20.1 Headers
20.2 Font Face
20.2.1 Bold
20.2.2 Italics
20.2.3 Underscore
20.2.4 Strikethrough
20.3 Endnotes
20.4 Links
20.5 Number Titles
20.6 Line operations
20.7 Tables
20.8 Grouped Text
20.9 Composite Document

21. Change Appearance

21.1 Skins
21.2 CSS

Extracts from the README

22. README

22.1 Online Information, places to look
22.2 Installation
22.2.1 Debian
22.2.2 RPM
22.2.3 Source package .tgz
22.2.4 to use setup.rb
22.2.5 to use install (prapared with "Rake")
22.2.6 to use install (prapared with "Rant")
22.3 Dependencies
22.4 Quick start
22.5 Configuration files
22.6 Use General Overview
22.7 Help
22.8 Directory Structure
22.9 Configuration File
22.10 Markup
22.11 Additional Things
22.12 License
22.13 SiSU Standard

Extracts from man 8 sisu

23. Post Installation Setup

23.1 Post Installation Setup - Quick start
23.2 Document markup directory
23.2.1 Configuration files
23.2.2 Debian INSTALLATION Note
23.2.3 Document Resource Configuration
23.2.4 Skins

24. FAQ - Frequently Asked/Answered Questions

24.1 Why are urls produced with the -v (and -u) flag that point to a web server on port 8081 ?
24.2 I cannot find my output, where is it?
24.3 I do not get any pdf output, why?
24.4 Where is the latex (or some other interim) output?
24.5 Why isn't SiSU markup XML
24.6 LaTeX claims to be a document preparation system for high-quality typesetting. Can the same be said about SiSU?
24.7 Can the SiSU markup be used to prepare for a LaTex automatic building of an index to the work?
24.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?
24.9 How do I create GIN or GiST index in Postgresql for use in SiSU
24.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?
24.12 Where is version 1?
24.13 What is the difference between version 1 and 2?

Installation

25. Installation

25.1 Debian
25.2 Other Unix / Linux
25.2.1 source tarball

26. SiSU Components, Dependencies and Notes

26.1 sisu
26.2 sisu-complete
26.3 sisu-examples
26.4 sisu-pdf
26.5 sisu-postgresql
26.6 sisu-remote
26.7 sisu-sqlite

27. Quickstart - Getting Started Howto

27.1 Installation
27.1.1 Debian Installation
27.1.2 RPM Installation
27.1.3 Installation from source
27.2 Testing SiSU, generating output
27.2.1 basic text, plaintext, html, XML, ODF, EPUB
27.2.2 LaTeX / pdf
27.2.3 relational database - postgresql, sqlite
27.3 Getting Help
27.3.1 The man pages
27.3.2 Built in help
27.3.3 The home page
27.4 Markup Samples

28. SiSU Components, Dependencies and Notes

29. Breakage and Fixes

31st October 2006 - SiSU < 0.48.3 break against Ruby > 1.8.5-3, break on cyclic include; Fixed SiSU: >=0.48.3 (see notes)
21st September 2005 - Avoid ruby-1.8.3 (2005-09-21) and (2005-10-12), Ruby Segfaults; Fixed: later versions of Ruby (see notes)

License, Standard

30. License

31. Things SiSU Standard

Download information

Download information

32. Download SiSU - Linux/Unix

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

Changelog - sisu

33. SiSU Version Manifest / changelog

Current version
3.0
Previous versions
2.7
2.6
2.5
2.4
2.3
2.2
2.1
2.0
1.0
0.71
0.70
0.69
0.68
0.67
0.66
0.65
0.64
0.63
0.62
0.61
0.60
0.59
0.58
0.57
0.56
0.55
0.54
0.53
0.52
0.51
0.50
0.49
0.48
0.47
0.46
0.45
0.44
0.43
0.42
0.41
0.40
0.39
0.38
0.37
0.36
0.35
0.34
0.33
0.32
0.31
0.30
0.29
0.28
0.27
0.26
0.25
0.24
0.23
0.22
0.21
0.20
0.18
0.16
0.14
0.12
0.10
0.8
0.6
0.4
0.2
0.1
Release

Changelog - sisu-markup-samples

34. Version Manifest / changelog - SiSU Markup Samples

Current version
2.0
1.1
1.0

Method for providing digital documents including a common citation structure

[SiSU Provisional Patent Application of 2004 based on much older idea and work on SiSU, Abandoned]

The 'Invention' described (and diagrams) by Ralph Amissah.
Provisional patent application text prepared by Stephan Filipek of Winston & Strawn LLP

35. 1. Background

36. 2. Definitions

37. 3. Brief Descriptions of the Drawings

38. 4. Detailed Description of the Preferred Embodiments

39. 5. Document Processing, examples of subsequent steps

40. 6. Advantages of the Invention

41. 7. THE CLAIMS

Post Filing Appendix

42. Post Filing Appendix: Reasons for Abandonment of Patent Process Claim

Endnotes

Endnotes

Metadata

SiSU Metadata, document information

Manifest

SiSU Manifest, alternative outputs etc.

SiSU - SiSU information Structuring Universe - Structured information, Serialized Units,
Ralph Amissah

Structured information, Serialized Units

A Chronological history of developments on SiSU

2003

January
February
March
April
June
July
August
September
November
December

January

10th January 2003 Some redesign has been done for better viewing with a text/console browser, specifically w3m.  311  w3m works so well (with our "table" html output) that all plans to make a module to produce output for lynx viewing, (which does not present our current html output formats well) have been abandoned. Came upon elinks  312  which works as well for console viewing in August 2003.

18th January 2003 Images of special characters embedded into html and pdf output where necessary, eg

20th January 2003 WordMaps now skinnable along with the rest of the site and/or individual documents to which they pertain.

February

2nd February 2003 Introduced alternative markup for headings, headers and endnotes, using the opening curly bracket. Influenced by use of vim with folds, (also thlnk & textlink though particularly evident in this modification)  313 

9-14th February 2003 Revisited & polished pre-processing for creation of documents from a term-sheet which specifies which set of standard forms should be used. Has been in place since 1998.

March


Business Week cover, March 2003

  314 

16th March 2003 Revisited & polished mailer, integrated to work with mutt... sends mail with content appended as a pdf.

April

4th April 2003 Started work on Ratchet, a backup and version control widget/utility, as an exercise in getting to know gtk2, and getting around the multitude of new/unfamiliar commands in arch, which I thought I preferred to subversion. Ratchet quickly became the snap-in backup and version control utility for SiSU, sharing the same configure/environment file, once SiSU is set up, ratchet has the information it needs as to program and data sources. SiSU is a frontend for arch, cvs, rdiff, rsync, and afio, ... and anything else that is particularly useful for use with SiSU, including control (ascii hyperlink), and description files. In its March 2004 incarnation it looked like so (if you go for the screenshot, it may be necessary to scroll right to see ratchet):  315 


ratchet, in the right corner of the screen, and some help output from SiSU

22th April 2003 Lout module added as an alternative way of producing pdf (or postscript) files.  316 

25th April 2003 Minor alterations to output/presentation of LaTeX module.

June

04th June 2003 Modifications to way in which metadata is presented in html documents, now using Dublin Core with Resource Description Framework. (The tech is in place, whether the tagging is done or suitable taxonomies are developed, helpful or used consistently is another matter.)

04th June 2003 Dual LICENSE is to be /GPL/ for non-commercial use, with a commercial license required for all other use.

For dual licensing three licenses are currently being looked at, as possibilities for the final form:

Nokia's ‹http://www.opensource.org/licenses/nokia.php› (Nokos - which is an open source license, rather than free as in /GPL/ license)

1059

A visual change for paragraph (text-object) numbers from the table-html document versions, took away the curly brackets around paragraph (text-object) numbers, and replaced them with a leading hash # (this to serve as a reminder that to access a given text-object number eg 43 you add #43 to the documents url). The css-html document versions like the pdf output have the object citation number in the margins without any marker.

Some "visual cue", simple curly bracket additions, to markup alternatives.  317 

30th June 2003 Re-did text markup vim syntax high-lighter (lost my original attempt, but this works better anyway).

July

29th July 2003 texinfo: my first look at any other multi-document producing format, I had thought that that would be Docbook, but it ends up being texinfo ... and I was not even aware that texinfo was a multi-document format.

I finally start to look at texinfo format, after re-setting up w3m with bookmarks, and pinfo to startup in "screen". The question for me being how practical it would be to generate texinfo files, from SiSU files, and how "good" could those texinfo files be made to be. (If you wanted to make texinfo files you would not use SiSU, but if you were to use SiSU you would have available as one set of output formats those provided by texinfo as formatted by SiSU) No conclusion as yet, would start very simply at first with a subset of features, building upon those and deciding whether it becomes worthwhile.  318 

This quotation is promising, in relation to auto-structuring texinfo files from SiSU:

"You can use node pointers and menus to structure an Info file any way you want; and you can write a texinfo file so that its Info output has a different structure than its printed output. However, virtually all texinfo files are written such that the structure for the Info output corresponds to the structure for the printed output. It is neither convenient nor understandable to the reader to do otherwise."

August

4th August 2003 Redid endnotes in metaverse. Now utilize the inline entry (endnote within paragraph at location where it occurs) instead of endnote marker and endnote following paragraph, to represent endnotes in metaverse. Either inline, or "binary" remain input/markup options.

6th August 2003 All downstream program changes resulting in change in metaverse (endnote representation), in place.

9th August 2003 Texinfo output files generated by SiSU (with -i flag). Now while if your primary intention is to create a texinfo file you probably would not use SiSU, but being able also to produce texinfo files at a whim is wonderful. Detail with headers and Dublin Core to be worked out (DC detail should also be incorporated into pdf output)...


screenshot of info file


screenshot of info file

Jazz favourites long tailish some of this ... :-)

Myra Melford and Mary Ehrlich "Yet Can Spring", 2001

Piano trios I enjoy, not particularly avant garde at all

Bobo Stenson p. "Serenity", 2000

Bobo Stenson p. "Reflections", 1996

Myra Melford "Dance Beyond the Color", 2000

Brad Mehldau p. "Places", 2000

Keith Jarrett p. "Changeless", 1987/1989

Piano Trios avant garde

Marilyn Crispell p. "Spring Tour", 1995

Myra Mellford p. "Alive in the House of Saints", 1993

Paul Bley p. "Not Two, Not One", 1999

Paul Bley p. (Franz Koglmann t.) "Annette", 1992

Joe McPhee Sweet Freedom - Now What?, 1994

Quartets

John Surman s. (Paul Bley p.) "Adventure Playground", 1992

Anthony Braxton s. (Mal Waldron p.) "Six Monk's Compositions", 1987

Tomasz Stanko t. (John Surman s.) "From The Green Hill", 1999

Dave Douglas "Leap of Faith", 2000

Larger groups

Sun Ra p. "Jazz in Silhouette", 1958

George Lewis s. t. "Homage to Charlie Parker", 1979

Carla Bley "Heavy Heart", 1984

Edward Vesala (Sound & Fury) "Lumi", 1987

Art Ensemble of Chicago "Alternative Express", 1989

Franz Koglmann t. "L'Heure Bleue", 1991

Edward Vesala (Sound & Fury) "Invisible Storm", 1992

Myra Melford p. "Even the Sounds Shine", 1994/1995

Tomasz Stanko t. (Bobo Stenson p.) "Leosia", 1997

Myra Melford p. "Above Blue - Same River Twice", 1999

Reggie Workman "Summit Conference", 2000

Dave Douglas "Witness", 2001

Larger groups with rhythm

Rodney Kendrick p. "Last Chance for Common Sense", 1995

Lounge Lizards (John Lurie s.), "Live in Berlin, Volume 1"  320  1991

Abdullah Ibrahim, "Ekaya" 1983

Various Artists (Barney Rachabane, Abudllah Ibrahim and others), "African Horns" 1989 (rec. much earlier)

Sun Ra, "Other Planes Of There", 1964/1992

John Surman s. and Jack DeJohnette d. and London Brass "Free and Equal", 2003

Live Improvised

Keith Jarrett p., "The Köln Concert", 1975

John Surman s. and Jack DeJohnette d. "Invisible Nature" (live in Tampere and Berlin, duet), 2002

Piano Classical

Tatiana Nikolaieva, Schostakovich 24 Preludes and Fugues for piano, 1987, 1994

Yefim Bronfman, Prokofiev Piano Sonatas Nos. 1, 4 and 6, 1991, 1994

Alfred Brendel, Schubert Piano Works

There are many more favourites, I may add a few more over time. This is a list of more recent material, a Sun Ra apart, adding Mingus, Monk, Miles, Ornette Coleman, Eric Dolphy, etc. would have made it too long, and I did come to appreciate jazz late, weaned by Kieth Jarrett's "Köln Concert" well after the fact. For veering towards the avant garde dating is fairly straightforward, in 1988/1989 I heard and enjoyed a new at the time Ornette Coleman "Virgin Beauty". A short time after this I found Anthony Braxton's "Six Monk Compositions" ... and that was it.

Additions to pop favourites date back longer, a few that spring to mind:

Supertramp "Crime of the Century", 1974

Supertramp "Crisis What Crises", 1975

Fleetwood Mac "Tusk", 1979

Bobby Womack "The Poet", 1981

Womack & Womack "Love Wars", 1983

Genesis "Duke", 1983

Prince and the Revolution "Purple Rain", 1984

There are of course many others, and World Music will have to wait another time.

1137

But my movie list is also fixed by this time, so I will indulge with that as well:

Brazil, 1985

Animatrix, 2003 first watched 7th February 2004

I am certainly missing a few but these readily come to mind.

14th August 2003 SiSU installer using stow... Stow is convenient though not necessary.

26th August 2003 Playing with Webrick. A convenient way of serving the site locally after its generation (sisu -W flag).

September

2nd September 2003 Ruby expect is useful to have.

15th September 2003 Generation of /PHP/ using information stored in yaml, in this case books and journals, and country information. An elegant solution, though questionable that I should use /PHP/ at all.

29th September 2003 Javascript (from knoppix.org) added to lexmercatoria's skin for a week, and then removed, trivial to add again.

November

15-16th November 2003 Here are few screenshots included of my work environment, for the heck of it, (requested by a friend).  321 

SiSU is a command line batch processor, and as such works independently of your selection of environment, ... you would choose your own window manager and editor, (and as SiSU's input syntax is easily modified, you could choose to make your own). My selection of work environment does not affect the way anyone else would work with SiSU. But ... for me it integrates well with Ion and gVim, together with my favourite vim plugins thlnk, textlink and project.

Why vim? (well gVim)  322 

It suits me best. That is gVim together with folds  323  and the plugins: project.vim,  324  thlnk,  325  and textlink:  326 


screenshot of Ion, gVim and ratchet (a frontend for version control and backup)


screenshot of Ion gVim (dotfiles, with project, thlnk, and textlink plugins) and ratchet


screenshot of Ion gVim (sisu project control, with project, thlnk, and textlink plugins) and ratchet


screenshot of Ion, gVim (fold search on 'award') and ratchet

Why Ion?  327 

... it suits me best, I need tabs, multiple desktops, and the keybindings (need is the right word). Like vim using it becomes second nature, and nothing else will do... for the foreseeable future.  328 

You create spaces for programs that are the size/shape of which you are most comfortable viewing them ... and they are available, that size, no more fiddling, and a key stroke away. It is easy, if necessary, to move a program to a new window (a feature I seldom have need for).

Use of Ion and helper program permutations are endless, for example in the remote update of servers, could use screen for aptitude and shorewall, or Ion tabs, instead of the visually all present Ion split screen approach ... what a "joy" to work with.

The tools I find most valuable or am most attached to have remained static for over a year now, Debian (Gnu/Linux) with /aptitude/ and: Ruby, gVim (with projects plugin, and using vimfolds, gVim for almost all text, along with SiSU which is not tied to a particular editor); /screen/, /zsh/, /mutt/, /ion/, /hnb/, /shorewall/, PostgreSQL, /ssh/, /keychain/, /apache/, ... and then the icing, /slrn/, /irssi/, /imcom/, /raggle/, /imagemagick/, /xmms-shell/ ... on X the (graphical) programs that are opened daily gVim apart: /gkrellm/, /epiphany/ and /mozilla-firefox/ and /mozilla-thunderbird/ ... beyond this Open Office, /Abiword/, /Gnumeric/, /Gucash/, /Gthumb/, /Gimp/ ... far too many to list.

A more recent example 200411:


Ion3 - window 7 of 10

20th November 2003 Ratchet (SiSU's graphical utility for backup and version control and other oft repeated tasks) made functionally prettier. Work on ratchet started 2003/04/04 and in it now looks like so:  329 


Ratchet, SiSU's backup and version control utility

23-24th November 2003 Made Dublin Core metadata available as human readable data attached to end of document.  330 

Also provide document version control information, (site specific), extracted from the expanded CVS ID tag:

$Id: sisu_chronology.sst,v 1.3 2008/12/29 19:34:44 ralph Exp $   331 

Dublin Core and Version Control information where available are placed near the end of a document, for example in the segmented html text at: ‹http://www.jus.uio.no/sisu/SiSU/metadata.html

24th November 2003 The comments made in response to an article on Slashdot today, lead to the testing of URIs without file name suffixes.  332  Very tidy, and interesting because SiSU plays with html and /PHP/ for example, and may use some Ruby (text output) variant in future. It does have disadvantages for offline work. It was nice that html and pdfs once prepared could be viewed offline or burnt on a disk and used. Will have to consider whether to retain this, but the software, and this document have (for now) been modified accordingly.

25th November 2003 See comments of yesterday, have made many changes, and will retain them, the issue is more down the line to ensure that SiSU has a flag, by which old style full suffix html and pdf at least can be generated, to escape the need for a sophisticated web server, and allow easy offline file (manager) based browsing.

27th November 2003 OT - music wifi hifi: finally implemented my plan dreamed up sometime in October (when I got wifi), to connect my hifi to old pc containing hi quality OggVorbis files of part of my music collection, and control that pc (and the hifi) remotely over wifi using xmms-shell in a console with screen. The OggVorbis files sound superb on my old Audiolab (so much so that it is unlikely that I will be replacing my cd player when it finally packs in). To recap there is no streaming, the data/music/ogg files reside on a pc connected to the hifi, you can then just instruct that pc remotely what should play. The encoded collection is available to the "couch potato", without cd changing, with playlist possibilities, volume control etc.

December

5th December 2003 A slashdot review recommendation  333  resulted in my purchase of "Effective XML"  334  by Elliotte Rusty Harold. Read over the following weekend, and yes, I give it a strong recommendation. Reading Effective XML lead amongst other things to my looking at Dave Raggett's html tidy  335  ... and that was the cue for a long overdue look at the html generated.

14th December 2003 First results of html tidy, have so far looked only at the segmented text version (not at navigation pages).

Will "tidy" as a matter of routine, but in a slow and hopefully steady manner.

Will only deviate from recommendations (or ignore warnings) when there is good reason to do so. For example, it appears that id attributes may not be numeric, (possibly that they must start with an a alphabetic character), rather than being alpha-numeric. Am satisfied with the current citation system solution, and it is difficult to see why citation system should have to introduce an arbitrary letter prefix for the identifying object citation number (although this is trivial to implement, and is the way it was some time back). The Google search string also throws warnings. Removed RDF section that made use of the Dublin Core, leaving only meta tags, as that was not recognised and threw errors. Otherwise cleanup so far has been mostly routine, html checking. Documents are recognised as looking like xhtml transitional, I do not expect to go all the way, and make it so. The appearance of documents, would be unchanged, except for the fact that I have made changes to the display font.

Started using tables for placing text-object numbers for css version as well, as this makes the css useable.

29th December 2003 Help info updated.

LaTeX to pdf text strike-through in place finally, using package ulem. Investigate workings of alternative package soul. LaTeX was sorted long ago, in a very short time, and has been pretty stable ever since. Figuring out which package implements strike-through though has been a bit of a rite of passage... something I have returned to with Google web and group searches periodically... well after fairly long intervals. Today I found it.




 311. for w3m see ‹http://w3m.sourceforge.net/

 312.http://elinks.or.cz/

 313. See ‹http://www.jus.uio.no/sisu/sisu_markup_table/doc.html#h200302

 314.http://businessweek.com

 315.http://localhost/reserved/sisu/1#h1.18.1› a bit on ratchet

 316. Sample output ‹http://www.jus.uio.no/sisu/autonomous.contract.2000.amissah/a4p.pdf› [status not currently maintained and broken]

 317. See ‹http://www.jus.uio.no/sisu/sisu_markup_table/doc.html#h200306

 318. have started by putting dummy program files in place that hope can be developed

 319. added 13 November 2006, on occasion of being asked asked to give some Jazz recommendations, by a friend who knows I tend towards the avant garde, I discover I have not chosen to listen to anything new since the summer of 2003 when I was listening most to "Invisible Nature", so today I add a list for August 2003.

 320. Amazon has the covers backwards and titles backwards, the black cover is for volume 1, and that is "the one"

 321. on this date started introducing thumbnails of screenshots to the rest of the document

 322. vim is one of the two most famed programmers editors, with good reason, see ‹http://www.vim.org/› (the other being emacs). gVim is a graphical variant of vim.

 323. fold, documentation: ‹http://vim.sourceforge.net/htmldoc/fold.html

 324. project.vim - a way to organize/Navigate projects of files (like IDE/ buffer explorer), see ‹http://www.vim.org/scripts/script.php?script_id=69

 325. thlnk.vim - a URL based hyperlinking for plain text, notation: <url:filename> see ‹http://www.vim.org/scripts/script.php?script_id=293

 326. - a way to hyperlink plain text files, notation: |FileName|@|SearchString| see ‹http://www.vim.org/scripts/script.php?script_id=347

 327. Ion is a window manager... lightweight and powerful, described as a product of the "... search for a graphical usable interface" see ‹http://modeemi.cs.tut.fi/~tuomov/ion/› "a tiling tabbed window manager designed with keyboard users in mind."

 328. previous favourite Enlightenment aka E16 ‹http://www.enlightenment.org› (E16 with tabbing would have it all) and to a lesser extent Fluxbox (with tabbing and docking configured), ... long ago Window Maker.

 329.http://localhost/reserved/sisu/1#h1.18.1› a bit on ratchet

 330. Dublin Core metatags included from October 2002 and tied to RDF in June 2003

 331. since the Id: tag is live, that will continue to increment with document updates, note the embedded Id: above was introduced in v 1.29 2003/11/24 14:32:03

 332. and in particular a reference to the article "Hypertext Style: Cool URIs don't change" by Tim Berners Lee

http://www.w3.org/Provider/Style/URI.html› the Slashdot article was more generally on dissapearing web pages -

http://science.slashdot.org/science/03/11/24/127250.shtml?tid=126&tid=134&tid=95

 333. Slashodot on Effective XML:

http://books.slashdot.org/article.pl?sid=03/11/24/194213&mode=thread&tid=126&tid=156&tid=188&tid=192

 334. Effective XML, 50 Specific Ways to Improve Your XML, by Elliotte Rusty Harold, published by Addison-Wesley, Pearson Education 2004, isbn 0321150406

 335.http://tidy.sourceforge.net/› and ‹http://www.w3.org/People/Raggett/tidy/› and of course included as a Debian package.


[ document manifest ]
<< previous TOC next >>
< ^ >



SiSU


Viral Spiral - How the Commoners Built a Digital Republic of Their Own

David Bollier

2009


The Wealth of Networks - How Social Production Transforms Markets and Freedom

Yochai Benkler

2006


Free Culture - How Big Media Uses Technology and the Law to Lock Down Culture and Control Creativity

Lawrence Lessig

2004


CONTENT - Selected Essays on Technology, Creativity, Copyright and the Future of the Future

Cory Doctorow

2008


Democratizing Innovation

Eric von Hippel

2005


Free As In Freedom - Richard Stallman's Crusade for Free Software

Sam Williams

2002


Two Bits - The Cultural Significance of Free Software

Christopher Kelty

2008


Free For All - How Linux and the Free Software Movement Undercut the High Tech Titans

Peter Wayner

2002


The Cathedral & the Bazaar - Musings on Linux and Open Source by an Accidental Revolutionary

Erik S. Raymond

1999


Little Brother

Cory Doctorow

2008


Down and Out in the Magic Kingdom

Cory Doctorow

2003


For the Win

Cory Doctorow

2008


Free Software Foundation - FSF