SiSU -->
TOC linked  toc  Full Text  scroll  PDF portrait   pdf  PDF landscape   pdf  ODF/ODT  odt    A-Z  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 XML
1.15.3 ODT:ODF, Open Document Format - ISO/IEC 26300:2006
1.15.4 PDF - portrait and landscape, (through the generation of LaTeX output which is then transformed to pdf)
1.15.5 Search - loading/populating of relational database while retaining document structure information, object citation numbering and other features (currently PostgreSQL and/or SQLite)
1.15.6 Search - database frontend sample, utilising database and SiSU features, including object citation numbering (backend currently PostgreSQL)
1.15.7 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
"The Wealth of Networks", Yochai Benkler
"Two Bits", Christopher Kelty
"Free Culture", Lawrence Lessig
"Free as in Freedom: Richard Stallman's Crusade for Free Software", by Sam Williams
"Free For All: How Linux and the Free Software Movement Undercut the High Tech Titans", by Peter Wayner
"The Cathedral and the Bazaar", by Eric S. Raymond
"Accelerando", Charles Stross
"Tainaron", Leena Krohn
"Sphinx or Robot", Leena Krohn
"War and Peace", Leo Tolstoy, PG Etext 2600
"Don Quixote", Miguel de Cervantes [Saavedra], translated by John Ormsby, PG Etext 996
"Gulliver's Travels", Jonathan Swift, transcribed from the 1892 George Bell and Sons edition by David Price, PG Etext 829
"Alice's Adventures in Wonderland", Lewis Carroll, PG Etext 11
"Through The Looking-Glass", Lewis Carroll, PG Etext 12
"Alice's Adventures in Wonderland" and "Through The Looking-Glass", Lewis Carroll, PG Etexts 11 and 12
"Gnu Public License 2", (GPL 2) Free Software Foundation
"Gnu Public License v3 - Third discussion draft", (GPLv3) Free Software Foundation
"Debian Social Contract"
"Debian Constitution v1.3", (simple/default markup)
"Debian Constitution v1.3", (markup adjusted for output to more closely match the original)
"Debian Constitution v1.2", (simple/default markup)
"Debian Constitution v1.2", (markup adjusted for output to more closely match the original)
"A Uniform Sales Terminology", Vikki Rogers and Albert Kritzer
"The Autonomous Contract" 1997 - markup sample
"The Autonomous Contract Revisited" - markup sample
"United Nations Convention on Contracts for the International Sale of Goods"
PECL the "Principles of European Contract Law"
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

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 Synopsis
9.2 Description
9.3 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

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

FAQ, Howto, Installation, etc.

HowTo

34. Getting Help

34.1 SiSU "man" pages
34.2 SiSU built-in help
34.3 Command Line with Flags - Batch Processing

35. Setup, initialisation

35.1 initialise output directory
35.1.1 Use of search functionality, an example using sqlite
35.2 misc
35.2.1 url for output files -u -U
35.2.2 toggle screen color
35.2.3 verbose mode
35.2.4 quiet mode
35.2.5 maintenance mode intermediate files kept -M
35.2.6 start the webrick server
35.3 remote placement of output

36. Configuration Files

37. Markup

37.1 Headers
37.2 Font Face
37.2.1 Bold
37.2.2 Italics
37.2.3 Underscore
37.2.4 Strikethrough
37.3 Endnotes
37.4 Links
37.5 Number Titles
37.6 Line operations
37.7 Tables
37.8 Grouped Text
37.9 Composite Document

38. Change Appearance

38.1 Skins
38.2 CSS

Extracts from the README

39. README

39.1 Online Information, places to look
39.2 Installation
39.2.1 Debian
39.2.2 RPM
39.2.3 Source package .tgz
39.2.4 to use setup.rb
39.2.5 to use install (prapared with "Rake")
39.2.6 to use install (prapared with "Rant")
39.3 Dependencies
39.4 Quick start
39.5 Configuration files
39.6 Use General Overview
39.7 Help
39.8 Directory Structure
39.9 Configuration File
39.10 Markup
39.11 Additional Things
39.12 License
39.13 SiSU Standard

Extracts from man 8 sisu

40. Post Installation Setup

40.1 Post Installation Setup - Quick start
40.2 Document markup directory
40.2.1 Configuration files
40.2.2 Debian INSTALLATION Note
40.2.3 Document Resource Configuration
40.2.4 Skins

41. FAQ - Frequently Asked/Answered Questions

41.1 Why are urls produced with the -v (and -u) flag that point to a web server on port 8081?
41.2 I cannot find my output, where is it?
41.3 I do not get any pdf output, why?
41.4 Where is the latex (or some other interim) output?
41.5 Why isn't SiSU markup XML
41.6 LaTeX claims to be a document preparation system for high-quality typesetting. Can the same be said about SiSU?
41.7 Can the SiSU markup be used to prepare for a LaTex automatic building of an index to the work?
41.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?
41.9 How do I create GIN or GiST index in Postgresql for use in SiSU
41.10 Are there some examples of using Ferret Search with a SiSU repository?
41.11 Have you had any reports of building SiSU from tar on Mac OS 10.4?
41.12 Where is version 1.0?

Installation

42. Installation

42.1 Debian
42.2 Other Unix / Linux
42.2.1 source tarball

43. SiSU Components, Dependencies and Notes

43.1 sisu
43.2 sisu-complete
43.3 sisu-examples
43.4 sisu-pdf
43.5 sisu-postgresql
43.6 sisu-remote
43.7 sisu-sqlite

44. Quickstart - Getting Started Howto

44.1 Installation
44.1.1 Debian Installation
44.1.2 RPM Installation
44.1.3 Installation from source
44.2 Testing SiSU, generating output
44.2.1 basic text, plaintext, html, XML, ODF
44.2.2 LaTeX / pdf
44.2.3 relational database - postgresql, sqlite
44.3 Getting Help
44.3.1 The man pages
44.3.2 Built in help
44.3.3 The home page
44.4 Markup Samples

45. SiSU Components, Dependencies and Notes

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

47. License

48. Things SiSU Standard

Download information

Download information

49. Download SiSU - Linux/Unix

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

Changelog - sisu

50. SiSU Version Manifest / changelog

Current version
0.70
Previous versions
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

51. Version Manifest / changelog - SiSU Markup Samples

Current version
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

1. Background

2. Definitions

3. Brief Descriptions of the Drawings

4. Detailed Description of the Preferred Embodiments

5. Document Processing, examples of subsequent steps

6. Advantages of the Invention

7. THE CLAIMS

Post Filing Appendix

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

Endnotes

Concordance (wordlist)

Manifest (alternative outputs)

Metadata

SiSU - SiSU information Structuring Universe

Structured information, Serialized Units

Ralph Amissah

copy @ SiSU

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

Structured information, Serialized Units

Changelog - sisu

50. SiSU Version Manifest / changelog

Current version
0.70
Previous versions
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

Current version

0.70

git repo moved to:

git clone git://git.sisudoc.org/git/code/sisu.git

harvest fix where other languages used, links to appropriate files

year roll-over noted

copyright, 1997 - 2009 used to represent modifications made each year

debian/ new year cleaning, (coinciding with NY visit of Daniel Baumann)

debian/control made depends on fcgi-ruby for sisu-postgresql and sisu-sqlite as sample cgi search script depends on it

debian/copyright use machine parseable format

latex/pdf tilde mark (bug in texlive, missing (at this instant) provide workaround), similar to issue with "bullet" noted in sisu 0.70.1 [may be necessary to do an inventory of special characters?]

html and css, cosmetic changes (and the closing of a tag)

db/sql

sqlite fix, change ruby driver used to populate sisu sqlite3 db to rb sqlite3 for the time being. Use rb sqlite3 driver directly rather (than more convenient when working) rb dbi interface to populate content. Used to bypass problems with rb dbi sqlite3 interface noted in sisu 0.66.2 (2008-04-25) and 0.66.3 (2008-05-11) that have have persisted (apparently worked at end 2007 (v.0.62.4) and start of 2008 (v.0.64.0)

sqlite dropall, fix

fix to auto-generated sqlite cgi script sample, only works if at least one existing populated sisu sqlite database is found during the generation process

postgresql, much shared code, however, operation should be unchanged

harvest_authors, sort authors works

i18n (translation of manifest) fix, related to variable renaming in previous release (see git log)

manpage, help include: sisu --harvest *.ss[tm]

harvest

improved integration with sisu

close output files before remote posting

ensure html output is read by browser as utf-8

add publication date to author works summary

[integration not quite complete as not added to sql, reason, each addition of a field requires users recreating database, and there are other metadata header additions under consideration, though unavoidable reduce the number by grouping]

manifest, show topic register metadata for each document

css main html modified, run: sisu -CC

left margin changed, affects html generally

table th and td elements text top aligned

additions for manifest display of topic_register

html tables

html structure, fix

column width, fix

latex/pdf bullet mark (bug in texlive, missing (at this instant) provide workaround)

param

additional metadata fields

variable renaming (that affects modules that use param)

sql (postgresql), add proposed metadata fields for though not yet populated [if changes correctly anticipated, will enable future use of database structure built with current version, without need to re-create, will not affect existing sisu databases]

[version bump because formatting rule introduced to author / creator header - where new site metadata harvest feature is used, (at present changes changes should not be noticed except when using metadata harvest)]

sisu markup, additional header and new format rule:

@creator: / @author: header field, introduced author name format rules for more usable metadata harvesting: surname comma other names, additional authors separated by semi-colon

param added meta-tag, @topic_register: formatting topic levels are separated from sub-levels by a colon, a semi-colon separates main topics if there are multiple topics at lowest sub-level, a pipe can be used to create multiple headings

harvest module, harvests metadata from document set currently extracts: (i) authors and their writings from document set; (ii) topics and associated writings from document set (topics use topic_register header). harvest (when run against documents common to a directory of a site) extracts metadata and organises the documents on a site by author and topic information provided (there is a new "topic_register" header, with formatting rules similar to those of the book index), results are placed in [output_path]/sisu_site_metadata.

sisu --harvest *.sst

by author (see change in param @creator: / @author: header field)

by topic / subject index (see addition in param of @topic_register: header field) initially there should be an example samples here: <http://www.jus.uio.no/sisu/sisu_site_metadata/harvest_authors.html> <http://www.jus.uio.no/sisu/sisu_site_metadata/harvest_topics.html> together with update markup source files

The authors and their writings list will be made to take on a more biblographical form, with the use of additional fields as required. (concept example, suitable for medium sized sites [to remove size constraint: implement SQL equivalent]) make feature more robust

css, for harvest output added

remote placement of sisu_site_metadata (output produced by metadata harvest)

sisu markup, update document samples accordingly

tidy copyright marks in program headers, remove repetition of dates

[date changed, built just after midnight]

Previous versions

Scaling the Universe / Crossing the Void


'Day today, tomorrow etc.', by Adam Korpak

  998 

0.69

sisu-mode.el emacs syntax highlighting file contributed by Ambrose Kofi Laing data/sisu/conf/editor-syntax-etc/emacs/sisu-mode.el based on doc-mode.el (v1.14 2006-01-19) by Tong SUN, who granted permission for this adaptation and inclusion

vim syntax file, header, version number updated

ruby1.9 some testing minor changes (not all ruby libraries updated yet in Debian Sid) (sisu currently to be used with ruby 1.8 branch 1.8.4 or later)

dal, related to bold line instruction

minor touches

minor adjustment to book index code

manifest, reporting of sisupod, [path fix in sysenv]

Free as in Freedom markup sample now includes book index markup

identify markup helpers updated

dal fix, dal_substitutions_and_insertions get skin info

html

increased use of css, necessary to re-initialise sisu output directory with new css files [version number bump]

sisu -CC

html css, use of mini table of contents placed in left column for segmented text

manifest presentation

texpdf

pdf document typesetting dimensions

url matching and urlbreaks line breaks fix

landscape output, tables fixed

paragraph alignment, assigned 0 width to required space, (removing space _1 at beginning of paragraph)

footnote, number placement changed, and left alignment (ragged edges) _1 used

removal of a maths package gives back typeface changes like bold

url matching, special characters

better representation of tilde

tolerance

db table field lengths (varchar), increased

book type index

markup adjustment, book type index introduced

dal, book type indexing module

book type index and concordance, letter list for navigation

middle layer, url representation changed, downstream code affected

dummy headings removed when not used, latex/pdf, odf, html scroll

internal, greater use of passing of hash to formatting modules

dal, several modules split into separate files

vim syntax file updated to include syntax for book index

0.68

Should simplify maintenance; numerous small fixes

Not without risk but should be easier to maintain.

Middle layer document representation changed (changes to the programs internal representation of text (markup)). Input unchanged; output should remain much the same. Changed processing markup (middle layer), affects internal downstream processing. Should simplify writing of downstream parsers and should increase both consistency and flexibility (as internal markup is now more easily modified).

texpdf produces multiple pdf document sizes as specified in config

many small fixes

0.67

texpdf xetex and xelatex processing commands, fix

texpdf A5 size landscape pdf, tex document header, fix

remote sisu sourcefile and sisupod, fixes, download and generate locally

/tmp processing directory renamed to fix issues with default directory tab expansion of filenames and e.g. texpdf images

manifest minor changes to document information displayed

help environment fix "sisu --help env"

texpdf (sysenv), papersize re-fixed (xetex landscape pdf fix fixed)

texpdf (sysenv), fix for xetex landscape pdfs

syntax highlighting minor updates: nano; diakonos; kate [todo: gedit]

debian/vim-addon-manager, fix vim-sisu.yaml (closes: #464824)

composite document, simplify syntax for importation of external files, syntax change (minor), automatic version bump, document samples modified accordingly [when editing vim has get-file gf]

debian, vim-addon-manager

0.66

sqlite3, problem with transaction commits and disconnecting from db (including query and close), frustrating as sqlite is invaluable, bug has arisen with attempt to upgrade sisu from use of sqlite2 to sqlite3, may be within sisu [re-check connection requirements] but appears to be with sqlite3 component of (libdbi-ruby, libdbm-ruby); writing on the net at present suggests there may be a problem[1]; file bug report against sisu-sqlite and against libdbd-sqlite3-ruby, libdbd-sqlite3-ruby1.8,

[1] <http://www.sqlite.org/cvstrac/wiki?p=SqliteWrappers> discussing different program apis at this time writes the following on ruby-dbi (in bold) "Ruby DBI (dbd_sqlite). This needs some work (see mailing list!)."

sql, work on ability to create sql transaction file for manual sql commit

particulars, introduced an abstraction for getting: basic environment; document parameters; and machine coded document

debian/control use debhelper version 7

debian/control introduce vcs info git repo, browser

sisu-sqlite use sqlite3, unresolved issue finalizing transaction

debian, sisu-postgresql ruby-dbi dependencies refer to version 1.8

debian, sisu-sqlite ruby-dbi dependencies refer to version 1.8

tex to pdf, xetex (utf8) added as alternative to pdftex [for now special character processing is separate, consider merging common parts, that is, most of it]

debian, sisu-pdf recommends texlive-xetex

debian (control, compat), debhelper >= 6, (6 in lenny)

ruby identify program files as utf-8

# coding: utf-8

param identify markup type as 0.66 added

shared_sem semantic tag matching

sst_to_s_xml (sax/dom/node) semantic xml mockup naive conversion of known abbreviated tags, in flux, e.g.

sisu --to-sax autonomy_markup0.sst

* back to sst markup with:

sisu --from-sxml autonomy_markup0.sxs.xml

sst_to_s_dom fix to footnote/endnote conversion

vim

replace HiLink with "hi def link"

semantic tag matching, (may prune matches later)

no checking for vim versions

0.65

semantic tag, match refinement related, (consider a possible extension) [version bump for tags]

0.64

markup tag, semantic tag added

db sql pgsql future development and testing on version postgresql 8.3

encoding utf-8 some compatibility checks

db sql, for updates use match criteria '=' instead of LIKE (required for pgsql 8.3 with bigint)

ruby 1.9 testing, however remains closed

[(side note) ramaze looks good, search form re-done (cgi search form re-engineered)]

Dir.mkdir [instead of ftools File.mkpath], ruby 1.9

debian/control, permit running on ruby 1.9, needed for debian unstable install of current ruby (running remains stopped for the time being in bin/sisu, bin/sisu_webrick, bin/sisu_termsheet [details remain])

NOTE: past versions of SiSU are removed on receipt of message from University of Oslo, IT department (2008-01-14), requesting that SiSU use less disk space. A git repo exists, but this only goes back to 0.52.7.

odf output bug (preliminary) fix, related to angle-brackets in markup (reported by Jason Corfman)

sql, postgresql allow tcp/ip connections... take relevant parameters from resource configuration file, sisurc.yml

sql (postgresql, sqlite), switch primary keys to bigint (as requested)

processing, default processing directory moved to /tmp and renamed _sisu_processing~ [previously was in user's home ~/_sisu_processing] a user subdirectory is made and permissions set to user 700 pros: get rid of an unattractive directory in user's home cons: /tmp is usually in / which is frequently a relatively small directory compromise: is possible to set an alternative path for processing in sisurc.yml

copyright dates updated

debian/postrm.sisu on purge remove /etc/sisu, should fix packaging bug #454372 (reported by Kumar Appaiah), [thank you, and sorry for not having acknowledged this earlier]

0.63

texpdf, (latex pdf) generate sisu latex output in a single pass

implications if additional modules added e.g. provide dvi file without latex pdf headers or generate an A6 document by default for e-readers capable of reading pdf (this would otherwise require a separate pass/loop of content for each type to be generated) [current shortcoming, images are sized for smaller landscape output by default, image dimension adjustments not yet made (for different orientation)]

sisupod, bugfixes for rsync placement and for download and processing, (if made available) once downloaded may be converted when needed to the output format desired, outputs may also be generated by executing commands directly against pod at remote location, e.g.

0.62

cgi_sqlite, variable name bugfix, fixes sql auto-generated sample search form

some treatment of String and Array adjustment

gpl3 or later links to online license source updated

vim ftplugin search and replace keybinding set to C-@

debian build version update

debian/watch file

debian DM upload

gpg/pgp signature used changed (now B98F62B1 before BD76E77F)

html line separators, (in html scroll after toc and before and after endnotes; in html seg after text before footnotes)

rsync remote images partial fix

minor bug fix, related to error message passing, in texpdf and url

sisu_manual version info

vim ftplugin, status line info on cursor position modified

debian/control Dm-Upload-Allowed: yes

sisu_0.62.3-2 (2007-11-29:48/4)  1024 

debian/changelog (take more care with git reset)

sisu_0.62.3-3 (2007-11-30:48/5)  1025 

debian/control XS-Dm-Upload-Allowed: yes [dpkg does not yet recognize Dm-Upload-Allowed field unless prefixed by XS-]

db rearranging basic things todo (create, drop, update)

generate from remote markup source, image path fix, e.g.

vim

ftplugin, status line info update

colors slate, name fix [requested thanks]

debian/control Homepage: header (for the time being lintian override necessary)

[uploaded to Debian November 4th recorded at the time, Reis down, upload apparently lost, re-uploaded to Debian November 14th ]

db common and cgi, regex to match new composite file filename (.ssm.sst)

[NOTE/WARNING: some directories moved, for existing sites will need manual adjustment of output locations, (moving of a couple of image directories, and if sharing text source the creation of shared source directories src and pod), see notes below (on directory shunting)]

directory shunting ... [some resulting re-setting/configuration up necessary]

markup source and source pod directory (src and pod), all shared markup source placed in common directories src for text source, and pod for binary (instead of being in output files generated sub-directory) [NOTE: New src and new pod directory for shared markup source output required at [output path]/src and [output path]/pod ] [if nothing else makes repo of online submissions easier]

images, output images used by html moved, now in image directory instead of image_local; system images moved from image to image_sys (to make sure they are always available, i.e. not written over (by subsequent images given same name)) [NOTE: Image directories moved and may need to be tended to manually as existing directories are not overwritten, [output path]/_sisu/image_local is moved to [output path]/_sisu/image (and old _sisu/image is now _sisu/image_sys) ]

pwd directory stub name exception, regexs in sysenv and elsewhere, when determining the pwd stub, take stub from parent of a directory named src (todo with directory shunting, and placing of output source markup files where shared in a directory named src)

remote, (put, get) placed in single file (consider separating later)

conf, remote, work on rsync building of basic remote site structure

embedded content, included binaries such as images, audio, video, copy content associated with document to desired output locations, [decide how audio, video/multimedia are to be handled, initially just links to content]

image conditions and regex for matching and extracting list of images used by a document visited

copy images associated with document along with document, does not take care of skins though, for all images still need to use -CC

sysenv remote placement, and config, able to define multiple hosts for rsync or scp placement of output, for this sisurc.yml remote info given provided as array with '-' separator [old form of notation is also honoured]

special character exceptions, exception, fix (:code underscore angle bracket issue)

pruning

conditionals rearranged, (scope for breakage)

fictionbook,  1029  (-f) first pass at output, look into further and develop or drop? fictionbook is interesting.

debian/control added depends on rsync, used extensively (now also internally)

NOTE: fixed today in Debian Sid, bug with String.strip in ruby 1.9.0 (2007-09-10 patchlevel 0) [i486-linux]? [behaviour noted in 2007-09-18:38/2, existed till 2007-10-18:42/5]:

' apples, oranges'.strip #==> "apples," # expected "apples, oranges"

' apples, oranges '.strip #does as expected

ruby 1.9, for present time retain restriction on running and testing sisu with ruby 1.9, there are still issues with 1.9 (at the C stack level, and probably some in sisu compatibility/updating as well)

0.61

dal, markup shortcut for available outputs, present as grouped text object, (as opposed to each available output being a separate object) this makes more sense for search results - where matched returns all versions of a document, (rather than just e.g. the document title) [affects document objects and numbering where used, hence version number bump]

html, pdf, switch text object numbering off, may be set in: (a) document header, @markup: no_ocn; (b) skin (for documents sharing that skin) "def ocn_display_off" and set to true; or (c) as a processing flag "sisu -hpv --no-ocn [filename]". NOTE, now in html objects are still named, (i.e. will still work with searches though the relevance of the numbers returned is obscured)

shared markup source, composite documents, look to processing directory for both text (share source) and binary (sisupod (make)) [fixes 0.60 shared markup source bug, introduced by falling out of step with processing changes introduced in 0.60]

processing flag shortcuts,

sisurc.yml reduced -1 outputs [to -hwpoyv] (minimum output used in dynamic building of some documents)

sysenv (default) replaced (obsoleted) -A with -a

sisu manual, manpage, download info, change links to source to archive, rather than transient repo

special character exceptions, some fixes

0.60

param, multi-line parse, fixing @link: header

dal, fix to shortcut for listing available generated output (without source)

html, where no ocn selected, keep ocn id, just remove visible reference to ocn, as search result links will continue to function

xml, make sure   is used instead of  

sisu_manual, link to markup and book examples updated/corrected

generated documentation moved out of source tarball entirely, in sisu-0.59 series sisu documentation as generated by sisu was introduced, (the debian package made a separate sub-package of this), however: this made the tarball much larger than it was previously (in the order of 5 times the size, over 10Mb instead of under 2), and; this has very unattractive implications for source control management / git, as much of the output is in binary file format which as they include information on when they were built and which version of sisu they were built with, have different hash values from one generation to the next, which means large diffs and repeated storing of binary files which may contain essentially the same data, and rapid growth in size of the git repository. Solution sisu-0.60:

keep the sisu source tarball to as little binary content as is necessary by separating out the documents produced (this keeps diffs to essentials, and both the tarball and repository smaller in size)

keep a separate tarball for documentation as generated sisu-doc; offer that as a package on its own, (request that debian consider it for inclusion as such).

sysenv, sisurc.yml allow use of relative output paths, expand to absolute

parameter reading on first run of file, (initialization of parameters)

processing directory tmp_sisu_processing permissions set to 777 as processing for individual users occurs within sub-directory named after user

composite files (.ssm) building moved to processing directory, to overcome problem of non-writable sisu-source document directories, perhaps also cleaner (management of files)

param, behavior for reading headers changed to take in multi-lines, affects regex matching, watch

vim syntax highlighting for sisu markup, change to take account of possibility of multi-line headers

html segmented, bugfix: footnotes for headings levels :A,:B and :C correctly placed in first segment when batch-processing files/output

latex/pdf minor cleaning,

caret '^' is latex special character, additional match for escaping

clean major headings of markup heading tag with tilde and name e.g. '1~meta'

help, (hub), minor reorganisation and a change in info returned, most significantly the response for typing 'sisu' without options

sysenv, syslink issue, additional check made

sisu markup header, @man: accepting manpage parameters for: man_section, man_name and man_synopsis

man-pages, refinements to generation

param / metadata, hash sums now returns has sum and file-name only even for sisu-skin

NOTE you may be better off doing any diffs between 0.60 and 0.58 branch than against 0.59 which includes a lot of generated within the package documentation, 0.60 adds source only. [Am tempted to remove 0.59 completely from git history as it increases the size of the scm repository by so much...]

debian, 0.60 sorts issues with 0.59 branch

sisu_0.60.0-2 (2007-10-04:40/4)  1033 

debian/control

remove reference to sisu-doc, (sub-package created in 0.59 and removed again in 0.60)

sisu-pdf sub-package (now) suggests alternative pdf viewers

0.59

plaintext, more space between endnotes where chosen (default remains footnotes)

manpage special character handling improvement

manpage added for sisu-doc package

documentation headers cleanup

html table of contents

toc, css, distinguish "Document Information (metadata)" link from other links, made smaller

cosmetic fix for rights and prefix appearing with toc

start documenting sisu using sisu

sisu markup source files in:

data/doc/sisu/sisu_markup_samples/sisu_manual/

/usr/share/doc/sisu/sisu_markup_samples/sisu_manual/

default output [sisu -3] in

data/doc/manuals_generated/sisu_manual/

/usr/share/doc/manuals_generated/sisu_manual/

(adds substantially to the size of sisu package!)

help related edits

manpage, work on ability to generate manpages, improved

param, exclude footnote mark count when occurs within code block

plaintext changes made

shared_txt, line wrap visited

file:// link option introduced (in addition to existing https?:// and ftp://) a bit arbitrarily, diff here, [double check changes in sysenv and hub]

minor adjustments

html url match refinement

css added tiny_center

plaintext

endnotes fix

footnote adjustment to make more easily distinguishable from substantive text

flag -a only [flags -A -e -E dropped] controlled by modifiers --unix/msdos --footnote/endnote

defaults, homepage

renamed homepage (instead of index) implications for modifying skins, which need likewise to have any homepage entry renamed

added link to sisu_manual in homepage

css the css for the default homepage is renamed homepage.css (instead of index.css) [consider removing this and relying on html.css]

ruby version < ruby1.9

place stop on installation and working with for now [ruby String.strip broken in ruby 1.9.0 (2007-09-10 patchlevel 0) [i486-linux], 2007-09-18:38/2]

debian/control restrict use to ruby > 1.8.4 and ruby < 1.9

debian

debian/control restrict use to ruby > 1.8.4 and ruby < 1.9

sisu-doc new sub-package for sisu documentation debian/control and sisu-doc.install

0.58

param, identify markup type, fix, make sure distinguishable form standalone markup identify module

html & texpdf, cosmetic, 'copy @' reduced to smaller font size, consider removing

code-block exceptions for composite documents

code-block exceptions

dal, code block, url matching, should no longer be tagged with decoration escape mark

texpdf, code-blocks latex markup change to scriptsize from tiny (consider going back to footnotesize); other grouped-text including poem, indents fixed and set to footnotesize

angle bracket exceptions

code block, exclude from most markup, should make it possible (eventually) to describe sisu markup using sisu, which was not an initial goal, but useful nonetheless.

pdf, some issues with some line-wraps, changed code-block fontsize to tiny, (consider footnotesize also should prefer use of ttfamily (texttt))

html css, odf, xml, use black bullets instead of red, and introduce black_bullet images in sizes 8px to 12px default used 9px

man page update on sources of markup examples

debian/control moved trang and kdissert to suggests

0.57

markup addition, headings, shortcut for top level title (and author) :A~ @title @author (also available for level 2 (or 3) author) [version bump]

param markup identifier (and identifier) updated to identify markup addition in 0.57, :A~ @title

manifest

use relative link by default

in absence of configured url_root (http://) use info on location on local filesystem (file://)

html search form in navigation band/banner and promo, adjustments, hyperestraier option offered in promo, requires change in sisurc.yml

sisurc.yml requires changes to make use search form options, [version bump] sample updated and commented out

html outputs, navigation band/banner adjustment, in concordance and manifest

html scroll, fix to document information link in table of contents

0.56

manifest make file-type descriptions simpler to understand

copyright:

copyright marks and info restricted to rights tag, unless none, in which case rights tag gets creator information

copyright mark picked up in rights if 'Copyright (C)' is used

tex/pdf url matching semi-colon following url

endnote heading, apply tag to exclude numbering and segment heading where there is no segment

html scroll endnote text minor fix

initialize site structure, make copy site images default (sisu -CC)

odf, a few regex matches, a new fix (url), and an old one (grouped text with change to fontface)

dal, endnote / url matching refinement

same as 0.55.7 - use version number to flag (small) change to db structure

rebuilt with more significant version number to flag the likely need to rebuild search database if used, [results from need to enlarge db cell related to dc identifier, (which is automatically constructed and used to populate the database, (and is too small) as of 0.55.6)]

0.55

url matching refinement

add semi-colon as possible url terminator

dal match https

db increase identifier size, (varchar 256 from 100) url automatically constructed in param, it is necessary to rebuild database (re-create and re-populate) for this to take effect [sisu -Dv --recreate]

added processed count info for output urls and remote placement (to existing counts)

help info updated -0 no longer is used to generate output without numbering (ocn)

some unintended tabs replaced with spaces

matching multiple and consecutive urls within a paragraph, refinements

db html (html_lite), multiple urls, bug fix

consecutive url matching: html, html_lite, xml, odf, texpdf

open archive initiative for metadata harvesting, initial implementation, Dublin Core, XML output available (-O), decide use later (filenames, output dir etc.)

rinstall as both a rant and rake installer for sisu

Rakefile softlink to rinstall

Rantfile softlink to rinstall

debian vim

moved installation of syntax and ftplugin back to vim/addons

added recommends vim-addon-manager (thanks zack)

initialize output directory, fix (Closes: #434168) [(a trivial but serious) bug introduced with changed use of variable in 0.55.3, (serious because it prevents the initialization of new output directories "sisu -CC")]

dal, matching of underscore, so as not to be to greedy and incorrectly match url with escape url decoration tag (_url)

vim syntax highlighting, match url with escape url decoration tag (_url)

output note added on software libre's use and adherence to practical open standards

debian vim, syntax and ftplugin install moved to /usr/share/vim-scripts

db import, minor refactoring

cgi fixes

search form pre/next

scope for matches in individual documents

url

matching improved (plaintext, html, xml, odf, tex/pdf, db)

possibility to escape url decoration < http://url > with an underscore preceding url _http://url

texpdf

TeX line breaking tolerance altered, to deal with urls better

indentation levels reset

cgi, generated sample search form, improved

presentation adjustments, placement of info, larger text entry form

additional result information provided

canned searches provided to show matched text or indexes in individual matched documents

links to odf text

new results defaults set

better highlighting of matches

footnotes and footnote references have links to the main text in which they are found

no next page if there are none

manifest and concordance, output presentation title and author information more prominent

editor syntax highlighting (for SiSU), visited/improved (diakonos, gedit, kate, kwrite)

renamed directory "syntax" "editor-syntax-etc"

vim directory moved into editor-syntax-etc

debian install, map moved vim directory

cgi generated sample search form

order results on files of the same title, in multiple files (with different filenames)

postgresql, character case sensitivity, control, on/off

tail decoration, gplv3 & sisu info

texinfo/info (pinfo) module starts to do something vaguely useful again [not a much used module, testing required]

print XML rendition of document structure to screen -T

sisurc.yml default, color set to true [apologies if this causes anyone any inconvenience, it is configurable in sisurc.yml]

help, man pages, README (man(8) related and env, 'sisu -V')

docbook entries removed for the present time

sisu-install (install ruby rant script renamed) and permissions set to executable

dal, auto-numbering (minor) fix for segments/headings

odf break fix

cosmetic fixes:

screen output of project name

screen output when generating tex pdf

debian documents skins

html indent levels, regular and bulleted text

GPL 3 related changes:

LICENSE update/change: GPL v3 or later.

document markup samples added GPL 3

images added GPL 3

default skin, info re-arranged/redesign, (some content dropped else much the same apart from reference to GPL v3)

html, do not make link to concordance file in html output even if it exists if document has over 300,000 words (as concordance would be a large file), if generated will be listed in manifest (maximum number of words to prevent its generation can be set in sisurc.yml, (default is currently set to 260,000))

odf, url match bug fix

dal, text block fix, space follows url before line break <br>

minor:

cosmetic changes to html and digest code

man page and html (note concordance word limit)

debian make lib available to ruby1.9

0.54

cgi script (for search matching), fix (imperfect), match highlighting is now ignored in paragraphs with urls

indent levels (1-9) added [previously two levels] done for plaintext, html, xml, odf, latex/pdf [minor syntax addition (_3 - _9), version number change]

bullet indent levels (1-9) added [previously two levels] done for plaintext, html, odf, latex/pdf [minor syntax addition (_3* - _9*), version number change]

url decoration, open close, default angle brackets

fixes, some line-breaking for plaintext (and text groups for) odf and xml

css, modifications for extended indents in html and xml [sisu -CC (for update)]

vim syntax highlighter updated to take account of extended indent range

rant installer minor changes for future ruby

conversion script in data/sisu/conf/convert/sisu_convert

0.53

housekeeping, internal program adjustments (i.e. unrelated to output)

lib, moved lib base to v0 branch (major version preceded by a v), [from major.minor version (this version would otherwise be 0.53)], primarily to simplify reading of scm history (with fewer lib directory changes)

issues with strings and arrays (flatten and compact some arrays)

changed require

various little things

cleanup, including cleaning of end of line (hanging white) spaces

Note: dcc, several hash values change.

moved to git for scm including git-buildpackage (from a combination of mercurial and dars + darcs-buildpackage, [don't ask, it served me quite well though])

0.52

texpdf, related to special characters (fix)

texpdf, a url representation fix, escape of special characters

postgresql TCP/IP port setting changed, looks first at sisurc.yml else the environment variable PGPORT, else fallback is to set default to 5432

debian/control postgresql dependencies updated, version agnostic (Closes: #419294) [Martin Pitt thanks for report]

on debian postgresql-8.2 now replaces postgresql-8.1, migrate database.

you may need to set the TCP/IP port, and this can be done either by setting PGPORT (e.g. "export PGPORT=5432") or setting the port in sisurc.yml (check what the correct value should be [on my system the default was set to 5433 for 8.2, "ls -la /var/run/postgresql/" may help])

param, markup version detection added

some code cleaning and anchoring of some regexs to start and end of string

[checked against ruby 1.9.0 (2006-06-08) [i486-linux] in Debian Sid]

debian, debhelper (>= 5)

[very rough wiki text output/assist (-g), may remove, not documented]

texpdf, a fix, utf-8 markup/input file now required and assumed [file magic identification of sisu markup files changes, utf-8 info is not currently provided, (resulting in false assumption on encoding)]

debian/control, postgresql dependency reverted till ruby db driver dependencies are updated, [reopened: #419294] [not caught in 0.52.2 because both versions of postgresql were installed, 0.52.2 was not uploaded to the debian repository]

html, links to other output make use of the default settings as well as availability of software (e.g. to generate pdf from LaTeX)

debian/control, postgresql dependency update, (closes: #419294) [thank you for report Martin Pitt]

initial revisit of XML output (and input) models, lots as yet to be done

cleanup of some unused code, re-introduce if needed

0.52 introduces: file-type identifier declaration, the first line of SiSU a markup file should be the sisu file-type identifier, indicated by the word SiSU optionally (and preferably) followed by the version number of the markup used:

e.g. current markup files would start with the line:

'SiSU 0.52'

or

'sisu-0.52'

[most markup is unchanged since sisu-0.38 though there have been some additions since see e.g. sisu-0.42... (sisu-0.16 markup remains valid though depreciated) to keep backward compatibility use:] commented out equivalents:

'% SiSU 0.38'

or

'% sisu-0.38'

variants include:

'SiSU text 0.52' [filename].sst (equivalent to the default 'SiSU 0.52')

'SiSU insert 0.52' [filename].ssi

'SiSU master 0.52' [filename].ssm

sisupod (zip) files (currently) have inserted into the binary:

'SiSU sisupod 0.52.0'

and sisupod (zip) of directory content:

'SiSU sisupod 0.52.0 directory contents sisupod-sisu-2007-04-03.ssp'

command line options:

default action for 'sisu [filename]' introduced: sisu -0 [filename] ... [flag -0 introduced and can be configured in config as 'flag' 'default']

added long forms for -q (--verbose-0|--quiet) -v (--verbose-1|--verbose) -V (--verbose-2|--Verbose) -M (--maintenance) and -VM (--verbose-3)

sst_identify_markup minor adjustments

sst_do_inline_footnotes minor adjustments

xml input representation variants (sax, dom, node), minor adjustments in conversion to and from ordinary sisu markup (.sst)

shared_xml fix (occasionally affecting html) make sure content of <meta name= tag do not contain double quote character transform to single quote

ODF and XML special character and XML escape fixes

gpl3 draft3 included as document markup sample (requires the ODF and XML escape fixes made in this release version)

0.51

defaults and skins, refactoring (code simplification)

consequential pervasive small changes throughout code

existing skins need to be rewritten (necessary modifications relatively straightforward) [this is the reason for the version number bump up]

[NB. (i) document syntax remains unchanged;

(ii) refactoring changes pass initial tests but require further testing]

XML representations of sisu markup, small a touch

0.50

(rudimentary generated) sample search form

fix: db paths for files;

fix: highlighting of matches (not yet consistent)

feature: db select range can be set from url (limit and offset)

cosmetic: text adjustments

sample search form, generated cgi fixes, including selected db path for urls, and setting of webserver port

concordance, add search widget

html navigation band, need more space with search widget, descriptions shortened

cgi sample search form, a bit of work, needs more

url logic (testing required)

boolean constructs (passed to SQL engine) (requires work)

cgi_pgsql system call made to psql to extract list of available databases

search forms (embedding), incorporation into navigation bands, and promo panes (can be limited to search of document in question only, and provide as result matched: object number index or text)

configure sisurc.yml with information on action (cgi query url) and sisu database name

html_promo, search forms may be constructed for sisu databases (yaml samples promo.yml and list.yml provide commented out example)

promo (html) may be set (a) per document in document header or by document skin, by directory in directory skin, or directory sisurc file, or per site in per site skin or sisurc file

initialisation of directories -CC, set permissions of copied files to 644

help, man pages minor updates, default homepage update

[many small changes, extensive testing required]

initial tests with ruby-1.8.6 passed

promo/advertise minor extension

css default, minor changes

postgresql indexes, not built automatically on text fields, rely on tsearch, (suggest you build gin indexes)

cgi sample search form scripts visited

yaml sample files promo.yml and list.yml updated

CHANGELOG renamed from version_manifest.changelog

html some play with navigation bands (usability)

sisurc.yml used (instead of depreciated sisurc.yaml)

version.yml used (removed version.yaml)

dal, metaverse renamed da for document abstraction (layer), variables (and sisupod structure) renamed accordingly. [dal preferred to da because it is easier to find].

i18n, (babel renamed i18n)

texpdf pdf output make a note about sisu_manifest, alternative output formats

promo/advertise, html, permits division into a major and a minor pane (left) which is available for promotional material, links etc. the content of which is currently controlled header @promo: and yaml files promo.yml and list/yml usual path = = = _sisu/skin/yml ~/.sisu/skin/yml /etc/sisu/skin/yml added sample of promo.yml and list.yml and an edited out header for promo inclusion in "Free as in Freedom" and "GPL" document samples (these are called by the document (header) but stored externally from the document (in yml files (promo.yml and list.yml)), (will be possible to make a directory wide inclusion))

0.49

sysenv, for processing of remote files, download of remote images, correction to variable name

odf documents linebreaks removed

description, less mention of document management, more on lightweight markup, text structuring, publishing and search

minor refactoring

segmented html, minor user interface navigation changes (for pre next and toc):

navigation arrow buttons and available documents information trade places, navigation arrows moved right (less cursor movement used in navigation, the scroll bar is usually on the right, also more consistent presentation (placement as in toc))

removed two sets of html segment navigation bands, from very top and under title (cleaner presentation without reduction in functionality, (also for console clients))

remote placement, rsync, simplify mapping used, should be a bit more robust

user response abstraction, minor

metaverse, superscript, subscript regex adjusted, (consider adopting this modification more widely)

digests, representation of document structure updated to use @, :A-:C, 1-3 (instead of 0-6)

[consider object numbering rule change, re: paragraph/line consisting solely of * * * or *, should these be un-numbered?, currently are numbered]

substantially the same as 0.48.8-10 (minor change (sysenv mkdir)) 0.49 (opens post freeze development)

[0.48 branch should have become 0.49 with switch to iso 639-2 in 0.48.8-8 = = = 0.48.12-1 (as this requires the renaming of some markup files e.g. dk becomes da) [builds from now are post freeze (Etch), and the development routine should be more regular]]

0.48

sisu-0.48.8-8 equivalent

use ISO 639-2 for language codes, file names etc. (rename danish samples da (instead of dk), [took out Brazilian Portuguese and U.S. American English])

debian samples, tex pdf page breaking instruction modified/corrected, and danish examples renamed ISO 639-2

sisupod initialisation, fix, (should not fail when initiated in a new sisu work directory, (however do not mix regular sisu markup files and sisupod on command line))

sysenv, generic question/check added; used as safeguard against accidental making sisupod of (whole) directory.

xml, xhtml several adjustments (including use of xlink), also related css fixes

html, toc cosmetic correction

sisu-0.48.8-7 equivalent, which includes a fix to the sample cgi search form [0.48.8-4 introduced a bug]

substantially the same as 0.48.8-6, source tarball now incorporates all fixes for Etch found therein [NOTE: 0.48.8-6 is more recent than 0.48.9 (which incorporates modifications made in 0.48.8 post Etch freeze up to 0.48.8-2)]

debian control, sisu-pdf now depends on texlive alone (tetex removed) (and free from use of metapackages). Feedback from Frank Küster, Ralf Stubner and Norbert Preining [0.48.8-6] [closes: #402807]

rollover year 2006 to 2007 [0.48.8-5]

cgi sample form related modifications (relatively minor but nice to have sorted) [0.48.8-4]:

cgi_pgsql and cgi_sqlite, dynamic path used instead (fixed path will result in errors where the default path is not used).

cgi_pgsql and cgi_sqlite, "documentation" tip for copying generated cgi sample to cgi-bin directory, prevent accidental copying to a directory instead of file. Dynamic path used.

debian/control Recommends libfcgi-ruby1.8 moved to sisu-postgresql and sisu-sqlite (only used in this context) (previously suggested, needed for sample search form)

documentation/help on initially creating postgresql database for use if necessary [0.48.8-3]

LaTeX, bugfix - restores missing left column object/paragraph numbers (missing curly (close) brace) [important, though marked as normal] [bug introduced somewhere between 0.47 and 0.48] [0.48.8-2] [closes: #403037]

LaTeX use mathptmx.sty instead of "obsolete" times.sty (as suggested by Frank Küster in Bug#402807) [0.48.8-2]

cgi-sample form, an arbitrary limit set for sql query results (1000 better than none) [0.48.8-2] [closes: 403042]

defaults, update sisu default homepage to current, (mainly urls) [0.48.8-2]

css addition to correspond with change to homepage [0.48.8-2]

debian control, adds mention of editors other than vim for which there is some kind of syntax support, kate, kwrite, gedit, diakonos [0.48.8-2]

vim syntax file, minor adjustment (related to an endnote shortcut)

doc/sisu/html keep copy of default homepage in documentation directory [introduced in 0.48.9 (already exists in program/code defaults)]

sisu_0.48.9.orig.tar.gz (of 2006w48/1 - 20061127)   1076  [the 0.48.8 branch version -6 is more current]

source tarball incorporates fixes added after Etch freeze in deb 0.48.8-2

LaTeX, bugfix - restores missing left column object/paragraph numbers (missing curly (close) brace) [important, though marked as normal] [bug introduced somewhere between 0.47 and 0.48] (closes: #403037)

LaTeX use mathptmx.sty instead of "obsolete" times.sty (as suggested by Frank Küster in Bug#402807)

cgi-sample form, an arbitrary limit set for sql query results (1000 better than none) (closes: 403042)

defaults, update sisu default homepage to current, (mainly urls)

css addition to correspond with change to homepage

debian control, adds mention of editors other than vim for which there is some kind of syntax support, kate, kwrite, gedit, diakonos

texpdf, usepackage url

doc/sisu/html keep copy of homepage

debian control, sisu-pdf depends for tetex | texlive, take on board suggestion by Frank Küster (see #402807)

[NOTE rebuild of the 0.48.9 of (2006w52/1 | 20061225) to merge branch in version control, chronological break in sequence, this build is substantially the same as 0.48.8-2, subsequent versions of 48.8 are more recent, the latest being 0.48.8-6]

Originally released as:

sisu_0.48.9-1 (2006w52/1 | 20061225)  1077 

metaverse, "visual" adjustment to allow inclusion of column width information

debian, dfsg document samples debian constitution v1.3 added [english, german, danish]

sisu_0.48.8-2 (2006w50/4 | 20061214)  1082  Debian Etch related fixes   1083 

LaTeX, bugfix - left column did not get paragraph numbers, fixed (necessary closure of a curly brace) (closes: #403037) [important, though marked as normal]

LaTeX use mathptmx.sty instead of "obsolete" times.sty (as suggested by Frank Küster in Bug#402807)

cgi-sample form, an arbitrary limit set for sql query results (1000 better than none) (closes: #403042)

debian control, add mention of other supported editors, kate, kwrite, gedit, diakonos

defaults, update sisu default homepage to current, (mainly urls)

css addition to correspond with change to homepage

sisu_0.48.8-3 (2006w52/5 | 20061229)  1084  Debian release snapshot   1085 

texpdf, usepackage url (improved placement of urls)

debian control, sisu-pdf depends on texlive, (tetex removed (problems)), take on board suggestion by Frank Küster (closes #402807)

debian/control priority changed to extra (from optional) as depends on texlive (without option for use of tetex instead)

debian/control sisu recommends libfcgi-ruby1.8 (previously suggested, needed for sample search form)

documentation/help on initially creating postgresql database for use if necessary

sisu_0.48.8-4 (2006w52/7 | 20061231)  1086  Debian release snapshot   1087 

cgi sample form related modifications (relatively minor but nice to have sorted):

cgi_pgsql and cgi_sqlite, dynamic path used instead (fixed path will result in errors where the default path is not used).

cgi_pgsql and cgi_sqlite, "documentation" tip for copying generated cgi sample to cgi-bin directory, prevent accidental copying to a directory instead of file. Dynamic path used.

debian/control Recommends libfcgi-ruby1.8 moved to sisu-postgresql and sisu-sqlite (only used in this context)

sisu_0.48.8-5 (2007w01/2 | 20070101)  1088  Debian release snapshot   1089 

sisu-pdf texlive dependencies shortened and free from use of metapackages

rollover year 2006 to 2007

sisu_0.48.8-6 (2007w01/3 | 20070103)  1090  Debian release snapshot   1091 

sisu-pdf texlive dependency in -5 adjusted on feedback from Norbert Preining  1092  (Closes: #402807)

sisu_0.48.8-7 (2007w02/3 | 20070110)  1093  Debian release snapshot   1094 

the cgi sample form modifications introduced in -4 were premature, they break things, behaviour reverted to -2 [-3]. (Closes: #406281 and #406280) [same bug]

removed sisu-sqlite suggests on libdbd-sqlite and sisu-postgresql suggests on libdbd-pgsql which are not found in testing/Etch (Closes: #406282 and #406284)

sisu html man page regenerated (from man page)

sisu_0.48.8-8 (2007w03/7 | 20070121)  1095  Debian release snapshot   1096 

use ISO 639-2 for language codes, file names etc. (rename danish samples da (instead of dk), [took out Brazilian Portuguese and U.S. American English])

debian samples, tex pdf page breaking instruction modified/corrected, and danish examples renamed ISO 639-2

sisupod initialisation, fix, (should not fail when initiated in a new sisu work directory, (however do not mix regular sisu markup files and sisupod on command line))

sysenv, generic question/check added; used as safeguard against accidental making sisupod of (whole) directory.

xml, xhtml several adjustments (including use of xlink), also related css fixes

html, toc cosmetic correction

sisu_0.48.8-9 (2007w04/1 | 20070122)  1097  Debian release snapshot   1098 

removed Danish debian sample markup files to reduce the size of the inter-diff against the package in testing.

minor further adjustments to xml processing

sisu_0.48.8-10 (2007w04/2 | 20070123)  1099  Debian release snapshot   1100 

xml and xhtml adjustment of regex match of urls for xlink

cgi html test search form, multilingual documents, file naming convention resulted in incorrect url mapping of results, fixed

dcc, document content digest, multilingual/non-English documents, fixes related to translation and metadata extraction

defaults for html, invisible dot navigation buttons, text made cleaner for console clients, using < ^ > for pre, toc, and next, (there are other equivalent navigation options)

sitemaps, very early days, stubs in place to make this work (google, yahoo, ms announced their joint decision to use this week)

remote, placement of sitemaps directory to remote server, rsync

html, doc (single text, scroll version) tables, fixed

texpdf, bugfix for (asterisk marker type) footnotes in headings, fixed

metaverse, in "visual" table representation {table} may be used instead of {t} likewise {table~h} instead of {t~h}, (resulting output cleaned, fix)

vim syntax highlighting updated for {table} match

sisupod (directory zip) creation, file selection tuning

command line option papersize (texpdf), minor convention e.g. --papersize-letter (in addition to --papersize=letter) available options: European 'A4', book 'a5', 'b5' and U.S. 'letter', 'legal' (system defaults to A4). However, these can be and are better set in the config file (document headers being another though not recommended possibility),

'sisu --help env' should list the current (default/configuration) settings including papersize

minor checks, minor editing, e.g. man pages

texpdf, default table behaviour changed to accommodate tables with a lot of text, also some cleaning of tables (fixed)

plaintext, serious performance issue when dealing with a document with tables, [especially annoying as tables are omitted from this output format] addressed (fixed)

markup footnote conversion to paragraph inline footnotes, (fixed)

minor adjustment to sisupod directory name...

one file omitted in sisu 0.48.2 fix, see comments there.

debian ruby build ruby-1.8.5-3 (uploaded yesterday) detects and breaks on cyclic include errors which were found at a basic level of operation, rendering program effectively broken. New ruby build affects all previous versions of sisu. [Further code review is necessary to ascertain that this does not occur anywhere else within sisu code base]

metaverse, indicate image missing if a requested image is not found

processing directories default location moved to be placed under home or /tmp from pwd

(-1) debian/control, recommends hyperestraier removed as appears to cause issues (also rename and pgaccess)   1114 

(-2) debian/control recommends hyperestraier (sisu and sisu-complete) put back   1115 

sisupod, creation of (zipped sisu content files, primarily a way of bundling sisu content assocated with a prepared sisu file or set of files, that sisu commands can be run directly against) creation:

sisu -S [filename]

places a file named sisupod.zip in the output directory for directory

sisu -S

creates a sisupod of the pwd named: sisupod-[pwd.stub]_[date].ssp, e.g. sisupod-sisu_2006-10-26.ssp (uses system call to unix commands find and egrep)

sisupod, sisu can be run directly against a sisupod without manual unpacking, e.g.:

sisu -3 sisupod.zip

[early implementation, a system call used], run against the following filename/types: sisupod, sisupod.zip, [filename].ssp

security:

sisu does not ever use a sisurc.yaml within a sisupod

sisu will only use a skin within sisupod if --trust(ed) modifier is added to the command line

skins, note: copy dir skin to skin_sisupod.rb [doc skin keeps name as called with name within document]

remote operations possible on sisupod, e.g.

sysenv, sisu processing directory '_sisu_processing' default placement now first within pwd (markup text directory) if that is not writable under home ~ and if not available to /tmp (the preference of home over /tmp my be reconsidered, thinking is to default towards keeping processing related info within private space)

manifest, uses documents home button/icon, if available (rather than sisu default)

sisupod alternative names sisupod, siuspod.zip [filename].ssp

urls, tune, removed link to html 'tune' output file, no longer generated

sysenv, url path reporting fix, (broken by renaming in 0.47.7)

processing directories default location moved to be placed under home or /tmp from pwd, likewise sisupod creation directory moved [processing directory]/sisupod from ./_sisu/sisu_doc

extra testing, numerous small fixes, (several related to method renaming in sisu-0.47.7, also checks against both ruby 1.8.5 and current 1.9, $KCONV set to UTF-8 rather than rely on environment and many more also as above)

0.47

metaverse, minor fix related to link created for shared source file with regard to new syntax shortcut markup for listing multiple available output types produced by SiSU (introduced in 0.47.6)

sisu_0.47.7.orig.tar.gz (of 2006w41/6 - 20061014)   1118  Debian release snapshot   1119  freeze until is in testing.

sysenv, minor code play, some method re-naming, organisational (however affects rest of code, much testing, (smallish possibility of breakage remains))

gif, reinstate support, however use not yet recommended (gif no longer under patent, however, gif is not available for all pdf, does not yet appear to be available in tetex) [image support: png, jpg, (gif)]

[debian/control] sisu-pdf set to work/install with either tetex and texlive (tetex | texlive depends).   1120 

[debian/control] sisu-pdf depends set just for tetex; sisu for LaTeX to pdf, currently also works fine with the texlive meta-package installed (in the texlive meta-package's present form, without the need to install an additional package (such as sisu-pdf)).   1121 

[debian/control] sisu-pdf set to work with texlive (tetex|texlive depends) (sisu works out of the box with texlive installed, currently an issue with the default font in texlive)   1122 

tex/pdf, fixed paragraph indent with hyperlink (previously linking not parsed and dealt with)

tex/pdf, fixed closing double quote (was typo)

syntax, new shortcut markup for listing multiple available output types produced by SiSU (existing syntax unaffected)

[package structure, vim directory moved to data/sisu/conf/vim from data/vim]

sisupod, fix creation of, change of library name caused break in 0.47.4

syntax highlighting, kate, kwrite, nano minor updates, review

debian: browser and pdf reader icons removed, (Closes: #389500) fixes debian policy violation removed non-dfsg compliant firefox icon (also removed other browser related icons)

minor code review [takes care of RAM issue experienced with some forms of batch processing]

metaverse, a line of code needed changing for ruby-1.8.5

fixed, document content certificate, issue with batch processing (and cleaning of earlier document details) sorted

fixed, sharing document source for multilingual documents (-s), creates and copies to the wrong directory

plaintext minor adjustments, and a batch processing information sync fix

sisupod, use zip compression and file extension .zip (instead of tar gzip .tgz) interoperability, wider platform comprehension

sisupod, master documents (.ssm) bug in batch processing sorted (todo with filenames)

html tune, unnecessary hard output removed (except in maintenance mode -M)

(document content certificate, issue with batch processing sorted)

reduce system calls

odf base file, odt.zip (instead of odt.tgz), easy way to maintain directory structure (issue in version control, hg drops empty directories)

conversion, prefer -to to --to=, keep both, man page and help updated to use --to-[conversion] (also minor cleaning of screen output)

debian/control depends zip and unzip added, used for sisupod.zip and ODF output

0.46

documentation adjustments

defaults html text/ accompanying blurb removed some Ruby / Debian / Linux / Unix text

Ruby version upped to 1.8.4, (probably will work with earlier versions but not tested)

db option synonyms --pgsql for -D or --sqlite for -d

document structure, extended level, stubs in place

syntax highlighting, directory renamed and a quick look at kate and diakonos updated

help/man pages, db related minor update

termsheet checked

minor code play

debian/control moved from extra to optional - does not conflict with anything, though a bit specialised perhaps

debian/copyright, year 2006 added

[debian/control build does not permit changing ruby version to 1.8.4]

experimental conversion xml(sxs,sxn) to sst, (from xml that was converted from sst) [sxd not yet in place, and several errors identified]. Early days of two way conversion, sst, simple xml representation.

header metadata extraction and sharing changed (used by xml and other document types)

conversion file libraries, some renaming

zsh completion (see 0.46.1), simplified/corrected in response to feedback, still naive

help and man pages updated with conversion info between sst and xml and back

Ruby: ruby version restrict use to ruby-1.8.2 or later, but only tested for ruby-1.8.4 (and later) [may have to restrict to more recent versions of Ruby ]

Ruby: if|unless|elsif|where colon constructs are depreciated in Ruby 1.8.5. (released today), so (the aesthetically more pleasing) colons switched with semi-colons.

zsh, naive zsh completion file _sisu in data/sisu/conf/completion (on debian installed to /usr/share/sisu/conf/completion) works if copied somewhere within your $fpath (do it yourself on debian copy to ~/.zfunc or /usr/local/share/zsh/site-functions and run compinit)

code, minor alterations: creation of Arrays and Hashes, not intended to be substantive; in hub corrected calling of help for termsheet; small adjustments to calling of conversion scripts

debian/control, reminded that sisu-vim existed prior to vim-sisu (renamed due to vim policy) both now removed and replaced by default installation, control file modified accordingly for sisu-vim

0.44 branch reinstated (leapfrogging over 0.45 which was a reversion to 0.43)

metaverse changes for consistency, affects all downstream code (with attendant risk), numerous related changes; preliminary tests passed  1146 

see 0.44.0

debian/rules compression mentioned twice, one removed

0.45

an emergency reversion to 0.43 code, as 0.44 breaks many LaTeX/pdfs [the other components of 0.44 are fine but the LaTeX part does not play properly with the new code base] for the present time, ignore (jump over) the version changes in 0.44, and continue from 0.43

only the odf icon (noted in 0.44) and a cosmetic change to manifest are added to this release since 0.43

the debian related changes in 0.44 are retained

NB. only emergency maintenance on this branch, development is on 0.44

0.44

some juggling of code and renaming of some files (db broken into smaller chunks)

metaverse, document level structure moved to external shared library and determined therefrom

metaverse, ocn moved to an external shared library and together with "node" numbering determined therefrom  1149 

db operations broken up into smaller code files

numerous other little things

* Note: shared sisu libraries, practice is likely to become that these contain pointers to libraries, rather than the libraries themselves, e.g. shared_db

odf/odt added generic odf tiny icon. html, added icon and link to opendocument text (assumes output is always present, as do the pdf equivalents)

markup, experimenting with simple xml models, three xml representations of sisu markup, sxs, sxd, sxn. Export with:

sisu --to=sxs [filename]

[experimental, these will change]. Import, not done

--to made a synonym for --convert

debian/rules simplified  1150 

debian/control sisu-pdf Depends: changed to make TeX Live optional, actually part of it is now required as tetex along with tetex-extra do not contain all the LaTeX packages SiSU requires (in particular manyfoot.sty is missing)  1151 

debian/lintian/sisu added lintian override for man page and non-executables

0.43

footnotes, introduction of new editor (square bracket) series, using asterisk and plus signs ~[ asterisk editor note ]~ or ~[* asterisk ed. note ]~ and ~[+ dagger ed. note ]~ outputs updated: plaintext, latex, html, xml, odf, dcc, database the sample search form does not yet search the new (asterisk and plus) endnote series [easy to add additional symbols later, also consider it should be fairly straightforward to add possibility to use of name of note maker with numbered note sequences for each contributor; you may wish to think of sorting into different types for some of these like plaintext, later]

database, breaks existing database model by introducing new tables, to accommodate the new endnote series, (square bracket series). (there are alternative ways to add the information, e.g. add column with information on the endnote symbol involved; have in fact added a table for each of the symbols used)

additional footnote annotations (asterisk, dagger) can be dropped from output with command modifiers --no-asterisk, --no-dagger, --no-annotate

--convert=footnotes (convert to embedded footnote markup, do not make changes if footnote mismatch) --convert=footnotes-force (make changes even if there is a footnote mismatch) provide warning about changes what todo, make backup? or create new file, what filename to use?

--no-ocn switches off object citation numbering. Produce output without identifying numbers in margins of html or LaTeX/pdf output. [with -h -H or -p]

vim syntax highlighter recognises footnote/annotation additions

debian vim/addons/syntax/sisu.vim add the new syntax file  1154 

man page and help.rb updated on editor footnotes, square bracket series

relaxng object models, look at, included in data/doc/sisu/models/relaxng (some models quite old, and undeveloped, originally in sisu library relaxng.rb)

metaverse, and elsewhere, utf-8 is assumed: started cleaning out legacy code (character converting regex) sisu generates its first Chinese document in html, plaintext and sql databases (postgresql and sqlite) only, at this stage... [confirmation that first Chinese document presentation is fine, from author of test (law related) text; the listed text representations reasonably handle the utf-8 characters involved, and document structure is ok]

0.42

sisu_manifest, pdf description express portrait copy to be optimised/biased towards print, and landscape to have screen view bias/optimisation (orientation and colored links)

debian (mostly), meta-packages man pages moved to man(7)  1156 

debian, closed bug 377208 after informing submitter changes had been made and requesting review ('fixed' in 0.42.2)  1157 

debian/control added a Conflicts: vim-sisu, sisu-remote, to the existing Replaces: these two packages have been removed   1158 

ruby, also tested ok with ruby1.9 (Debian Version: 1.9.0+20060609-1) sisu -3v [filename] [database tests omitted, relevant ruby drivers not on system]

html, segments, cosmetic, removal of footnote marker in headings

sysenv, fix for when sisu sql related packages are not installed, should not then be loading rb dbi module

html, xhtml, added utf-8 specification [(previously relied on correct browser setting]

debian/control, removed sisu-remote, added recommends rsync, openssh-client|lsh-client, keychain, to main sisu package instead  1163 

debian/control, removed vim-sisu, this used to contain syntax highligter and color scheme now included in Vim 7, all that remains is ftplugin, now installed by main sisu package  1164 

debian/control, sisu Replaces: vim-sisu debian/sisu.install installs ftplugin originally in vim-sisu

debian/manpages, sisu (main package) now installs vim_sisu page in man(7)  1165 

debian/control, package description related issues:

modified sisu

modified sisu-complete

modified sisu-postgresql

modified sisu-sqlite

modified sisu-pdf

removed sisu-remote, (as sisu-remote is no more)

removed vim-sisu, (as vim-sisu is no more)

removed sisu-remote, (as sisu-remote is no more) [consider adding a note on remote placement of documents in sisu(8) later]  1166 

dbi fix (--createdb)

[ruby1.9, forward testing, general check, (tests ok db operations apart, drivers not installed)]

debian/control, removed recommends libtidy [non-existent, see current libtidy-0.99-0, called in by tidy which is recommended and sets libtidy dependency] (Closes: #377086)

texpdf fix, object citation numbering reinstated

asterisk (and plus sign) footnote/endnote marker/tags [SubTech2006::LII:TB "request": required for U.S. law articles] done: html, odf, xmls, plaintext, latex pdf (some cosmetic changes to come), digests(dcc), sql (specific issue not addressed but works sortof)

syntax, asterisk (and plus sign) footnote/endnote marker/tags introduced ~{* for an asterisk marked endnote }~ and plus sign equivalent [reason for version number change, as previous version won't parse]

texpdf portrait text now all black, including toc and endnote markers landscape retains color for toc (red) & linked text (blue) [online viewing] [introduce configuration options?]

help updated

kdissert conversion to sisu markup a refinement (with less-than & greater-than)

debian/control, ruby >= 1.8.2 (rebuilt: returned to, complained about availability of 1.8.4 though installed) [debian/control, ruby >= 1.8.4 (not done sufficient testing on 1.8.2, so not supported)]

debian/control, sisu-pdf added Depends: texlive-latex-extra

debian vim-sisu, description (Closes: #374873)

0.41

kdissert, texpdf, accept sisu page break and new page marker, used for LaTeX/pdf

relaxng, sisu object models, first pass at XML object models for sisu input structure, and sisu metaverse structure, alternative data representation

kdissert:

sisu headers, added a hack to permit the inclusion of sisu headers, by entering them in the top level node (for which sisu will now only process properly if empty or if it contains comments or sisu headers)

texpdf, tell when documents are prepared using kdissert

html default skin for kdissert with icon

[kept out for now: kdissert sisu sample file, and its converted sisu text equivalent]

document samples, created subdirectory dfsg for documents that comply with the Debian Free Software Guidelines and moved the "GPL2" and "Free as in Freedom" texts and associated images back into the source tarball and main (from sisu-markup-samples) [FaiF is published under the GNU Free Documentation License]

html segments, footnotes for segments, bugfix, [faulty regex matched more than it was supposed to resulting in dropping of some footnote sections - these remained available elsewhere in the endnote segment]

Debian control, response to improved package description request 'Home page' corrected to 'Homepage:' and vim folds described in greater detail. Some detail added and correction of name of package sisu-markup-samples (provided in non-free) (Closes: #374873)

Debian rules, .ssm and .ssi files added to list of not compressed file types (/usr/share/doc/sisu)

sisu_manifest, added possibility of sharing of kdissert source  1175 

kdissert fixes to make the following true:

"sisu --convert=kdi [kdissert filename]" will attempt to convert a simple file produced using kdissert to sisu markup, basic and experimental

kdissert_to_sisu: some fixes, still very basic and experimental [data/sisu/conf/convert or /usr/share/sisu/conf/convert]

[issue spotted with rsync, new output directories, fix later]

"sisu --convert=kdi [kdissert filename]" will attempt to convert a simple file produced using kdissert to sisu markup, basic and experimental

kdissert_to_sisu: some fixes, still very basic and experimental [data/sisu/conf/convert or /usr/share/sisu/conf/convert]

param, minor fix to "prefix" metadata regex

renamed a couple of libraries related to file conversion

kdissert_to_sisu: a very basic trial conversion script from kdissert .kdi to sisu .sst markup provided [preliminary/proof of concept, provided in data/sisu/conf/convert or /usr/share/sisu/conf/convert]   1178 

options parsing changes, possibility of letter duplication removed [-CC no longer will work use -C --init=site]

texpdf_format, old code rearranged

sysenv, fixes in File_map where @md (param) not available

info related to share source file and sisudoc, bug fix

[subsequent debian build primariy to prevent compression of sample files]

search form, options passing, sisu -F --webserv=webrick

html segments endnote fix for the deposit of endnotes occurring in levels :A - :C

texpdf, a4 text height re-fixed

digest, document metadata, info re-fix

plaintext, small fix, document metadata

defaults, html_format, some html cleaning (including fix of html comment marker that was problem for dillo in doc.html)

html segments endnotes, fix for first segment, (endnotes were deposited in first segment multiple times (or rather this happened in some segments following a level :A - :C heading ))

markup_convert, hub, changes, should now be possible to convert and generate in a single changed rune, e.g.

sisu --convert=to38 -h autonomy_markup0.sst gpl2.fsf.sst

options, (command line options) message passing (should become cleaner), program piping changed, command line information added as 'opt', (subsequently contained within param 'md'), creates considerable scope for further tidying (cosmetic refactoring) [most code affected, preliminary tests passed, (some possibility of bugs and breakage)]

hub, param, hooks in place to permit modification of default processing instructions set in config files or within document headers by way of command line processing instruction starting with -- (however, only implemented for latex/pdf paper size).

hub command line now accepts individual command instructions, previously was necessary to write, e.g.

sisu -mNhwpoabxXyv [filename/wildcard]  1184 

now may alternatively write:

sisu -m -N -h -w -p -o -a -b -x -X -y -v [filename/wildcard]

dbi command line rune now requires "--" before instruction, --import, --update, --recreate, etc. removed short forms for --import and --update (-i and -u)

texp pdf, adjustments to document presentation dimensions (A4, US_letter, book_b5, book_a5, US_legal)

texpdf, command line parameter may be used to change paper size output (preset sizes include: 'A4', U.S. 'letter' and 'legal' and 'book' sizes 'A5' and 'B5' (system defaults to A4)).

sisu -p --papersize='book' [filename]

texpdf, image resizing for different paper sizes (useful when offering on the fly alternative document dimension processing) (manually calibrated to suit default document layouts) [note however other blocks such as tables are not (yet) handled similarly]

help (interactive help) now needs to be invoked with:

sisu --help [help query]  1185 

[consider permitting multiple document size pdf outputs, (easily done, but promises slower processing as each additional size selected is generated) currently you select your size and get a portrait and landscape, the selection of whatever size over-writes the other, as they are saved to the same file-name]

0.40

tex pdf, minor adjustments, including page-breaks restored for 0.38 markup

package source directory renamed with underscore instead of hyphen

metaverse, fix reference to dc_publisher in param (not publisher)

rant installer checked, removed sisu-examples, and post install routine as document samples are now packaged separately as sisu-markup-samples

babel, more use of translation module, used in metaverse (originally used for manifest) [expand]

correction to apt sources.list information provided in version manifest for source tarball (and package) for 0.40.1, and updated in README

source tarball url path changed, see url provided above

debian archive sources.list changed, started using reprepro to produce archive, debian "upstream" /etc/apt/sources.list changes to:

        deb http://www.jus.uio.no/sisu/archive unstable main non-free
        deb-src http://www.jus.uio.no/sisu/archive unstable main non-free

aptitude update

aptitude install sisu-complete sisu-markup-samples

The non-free section provides sisu-markup-samples

previous string (obsolete for future releases) was:

        deb http://www.jus.uio.no/sisu/pkg_priv ./deb/
        deb-src http://www.jus.uio.no/sisu/pkg_priv ./src/

translate, an internal framework for the translation of related text used first for the document manifest. (it is suggested that i look at gettext) some initial translation by daniel (german), nicholas (french), agi (spanish), enrico (italian)

param, metaverse fix, 0.38 markup syntax to work with processing instructions related to levels and their translation from :A,:B,:C,1,2,3 to internal representation 1,2,3,4,5,6

debian package sisu-examples removed, debian packaging policy requires removal of un-modifiable documents from the main archive. accordingly the books provided as markup samples have been moved from the main sisu package to sisu-markup-samples (which should eventually make its way to the debian non-free archive). Considerable changes in packaging required, and new version number appropriate.

0.39

metaverse fix, changed rules on auto-naming of html segments resulted in the introduction of some undesirable artifacts, (actually a change in sequence, some risk of need for further modification)

what to do when missing required: header title; heading top; heading seg. carries risk, false positives not acceptable, testing required, may need to scrap

debian package: debian policy standards version 3.7.2; debian vim policy changes, rename sisu_vim vim_sisu; built for vim 7 which includes sisu syntax highlighting, filetypes, and a color scheme (which are removed from debian package) closes: bug#367018

digest/dcc (document content certificate), fix: image digests reinstated  1194 

metaverse, changes to auto-naming/numbering of headings, and segment names [back to the more elegant auto-naming of segments solution, however, need to determined to be reliable (naming used to be done in a similar way) release passes initial checks though further testing is required; changes involve reducing the use of extra characters where possible in the auto-naming of html segments (the tilde and underscore were added to reduce the chance of name collision, and have now been removed where possible), additional checks that duplication does not occur have been added. This does mean any existing indexes (sql or hyperestraier) will have to be regenerated and url mappings/ links made within a sisu markup file to other sisu output of html segments will need to be checked and updated. Long term the currently implemented naming should provide a preferable solution (primarily in its being easier on the eye.)

odf, odd regex related bug related to matching of + sign in link text and corresponding urls fix not particularly satisfactory

debian policy standards-version back to 3.7.0 ... (should be 3.7.2 but lintian and linda not up to date this instant)

0.38

minor fixes, need resulting from default removal of ._sst temporary files (master documents:processed composite documents:temporary files)

process .ssm master file instead where possible, e.g. -R (and url info), (implemented in hub)

_ flag provided as hack to have ._sst files kept at the end of a run, (as an alternative to use of the -M (maintenance) flag (which changes screen output))

vim ftplugin, minor irritation with vim folds sorted

sisupod/ sisu_doc, .ssm, renamed sisupod.tgz. Master document pod now contains the composite elements of the master, .ssm and .ssi files rather than the "composited document" ._sst,  1199  examine for example:

search, debian:sisu "recommends" added hyperestraier [option in addition to sisu "atomic" search with postgresql and sqlite]

some help on setting hyperestraier  1200  up (in very basic way) for sisu provided:

sisu --help hyperestraier

for help on sisu search generally follow suggestions in:

sisu --help search

vim filetypes fix, the temporary ._sst rather than ._ssi

temporary files ._sst are now removed after run, unless -M (maintenance) flag is used

rexml fix necessary

help prompt fix

fix, 0.38 markup interpretation, evident particularly in XML Dom variant -X of a few documents, more strict regex

removed reference to 0.38 markup as experimental in help and man page (conversion script makes it easy to switch between markup versions)

debian 'Standards' version changed to 3.7.0

images, in particular to do with remote sisu markup source, e.g.

should (once again) pull down and generate documents with images (consider using url base plus directory, to make unique image directories for external documents images)

vim: sisu syntax, spell [Re: use of Vim, have made the transition to Vim 7]

(html_tune, some renaming which could cause breaks)

sisu, code rearrangement, relatively minor, /usr/bin contains require only

vim: sisu ftplugin, only activate :setlocal spell spelllang if version >= 700

html, link to concordance only if < build concordance word count limit

(html, sub_toc fix for pg texts)

a glance forward at ruby 1.9, some early tests passed [ruby 1.9.0 (2006-04-21)]

vim: sisu: syntax: Spell on vim 7, not quite right; colors: slate, vim colors, toned down, endnotes (green changed to "darkkhaki")

concordance, wordmaps renamed

primarily a new debian build as lintian 1.23.17 "published" yesterday, complains about existing builds

vim ftplugin, folds, another minor modification [without which would have been built as 0.38.4-2]

param, fix, correction to a condition for setting markup type

param, for experimental markup set markup type to version number 0.38, seems more useful and forward looking than setting the term 'rad', though markup is expected to be pretty stable.

param introduced header @clatalogue: (documented in man)

markup_convert and param, a refinement to matching :A type headings

vim ftplugin, folds, minor modification

convert, refinement in 0.37 to 0.38 and back, required.

sample documents, header 'markup' not very descriptive, 'level' preferred, but not ideal either..., changed though accordingly

--identify; --convert; --query; minor adjustments

sisu --convert [filename/wildcard] converts between 0.38 and 0.37 markup (which is substantially the same as 0.16 markup, only the file names changed)

sisu --identify [filename/wildcard] attempts to recognises the markup version

sisu --query [version number| or history] provides a bit of information on changes to markup and file naming conventions used

urls, minor fix, (screen output of generated output omitted -H, (-h was ok))

generated cgi search form needs a writable present directory, warning of failure posted if it is not (consider placing result elsewhere)

vim folds minor touch

Summary: there is some scope for breakage. preliminary tests passed. New markup introduced, as alternative, existing markup is not affected -

new document header markup,

new document structure markup, experimental,

[new header for tagging categories or topics, stub]

a script modify.rb is provided for easy conversion between 0.36 standard and 0.38 experimental markup

having more than one markup numbering system for document structure reduces simplicity, question is whether justifiably, the addition is experimental

1. alternative header notation, for consideration, an example @title: is equivalent to 0~title

2. sisu structure, experimental alternative notation, A,B,C,1,2,3 mapping to 1,2,3,4,5,6

SiSU has in effect two sets of levels to be considered

1-3 headings/levels, pre-ordinary paragraphs /pre-substantive text, and

4-6 headings/levels, levels which are followed by ordinary text.

This may be conceptualised as levels A,B,C, 1,2,3, and using such letter number notation, in effect:

A must exist, optional B and C follow in the sequence

1 must exist, optional 2 and 3 follow in the sequence

i.e. there are two independent heading level sequences A,B,C and 1,2,3 or using the standard notation 1,2,3 and 4,5,6

on the positive side: (a) the A,B,C,1,2,3 alternative makes explicit an aspect of structuring documents in SiSU that is not otherwise obvious to the newcomer (though it appears more complicated, is more in your face and likely to be understood fairly quickly); (b) the substantive text follows levels 1,2,3 and it is 'nice' to do most work in those levels

a couple of issues to consider: (a) 1,2,3 usually precede A,B,C (and do for generated output), but in the form is better suited to this context, it takes some getting used to though, and may be necessary to add a marker (an optional exclamation mark (!) or colon (:) perhaps) to the A,B,C to indicate that they are not subsidiary values, and are 'greater' than 1,2,3. :A,:B,:C,1,2,3 colon selected as aesthetically more pleasing (to me) (despite exclamation mark already being in use for bold lines/headings) (b) there ends up being more in marking up to know, (which needs to be balanced against any perceived convenience) unless ultimately only one markup structure style is adopted (c) ok within code may confuse a bit, as things simple are not always what you would expect, present solution is to translate rad markup values to standard ones, so A,B,C,1,2,3 and references to them become 1,2,3,4,5,6 (where you expect to find 1 you may find a 4)

a note on implementation of 0.38 experimental (rad), within the program structural markup is converted back to the the standard notation, i.e. levels A,B,C,1,2,3 are re-mapped to 1,2,3,4,5,6 which is used for processing

3. param, header, 0~tag or to use newer notation @tag: introduced, a stub for topic lists, categories, classification within documents. Formal only in the sense that to make work you need to be aware of previous categories, a degree of organisation is necessary. Raises technical questions in relation to method and notation used for SiSU structuring.

Mapping may be fairly simple for an independent system, however, it is a bit more complex to directly map to SiSU structure as SiSU has in effect two sets of levels to be considered A technically simple but inconvenient solution for making SiSU pages out of tags would be to have them between 4 and 6 levels deep, four levels is however from a practical tagging perspective (a bit arbitrary and) an inconvenient minimum depth to require it also also could be inconvenient for other technical purposes

4. sysenv, utf-8 assumed if file encoding cannot be determined, 'fix' results from an unexpected issue with the use of alternative document header markup introduced in 0.38 (@title:) the program 'file' used to check document type no longer parses the markup document and recognises it as utf-8 unless the document starts with a sisu comment line %2

5. an auto-converter, with canned conversion from 0.36/traditional to 0.38 (rad) markup and back from 0.38 (rad) to 0.36/traditional is tossed in to sisu-examples (permissions at 644)

sisu-examples/config/convert/modify.rb

once enabled (permissions and path set), usage:

modify.rb --convert [filename/wildcard]

for further options and generally a better place to begin:

modify.rb --help

this is a fairly generic simple tool that can be used to store other canned conversions

6. refactor, minor, moved some dublin core checking, affects plaintext, html, xhtml, xml, odf ...

7. db, create added as synonym for createall

8. sqlite, common_db, create command makes directory for output if it does not already exist

9. @structure: added as a synonym for @toc: it is used to build the table of contents, but probably more usefully thought of and described as the document structure header

10. sisu --help, some additions and a fix; sisu --help env, 'issues' reporting when machine offline

11. vim syntax highlighting file (sisu-0.38), ftplugin more vimrc type defaults review, and colors minor

0.37

vim syntax highlighting file, further testing

vim related files, cleaning (filetype.vim, syntax/sisu.vim ftplugin/sisu.vim & colors/slate.vim) syntax/sisu.vim minor refinements; colors/slate.vim has become a bit of a christmas tree, pretty far from what it started out as, will probably tone it down again, (it works only on dark backgrounds)

help, 'environment' information, minor addition, (and sysenv remote host rescue so works when machine is offline): 'sisu --help env'

vim related files, cleaning (filetype.vim, syntax/sisu.vim ftplugin/sisu.vim & colors/slate.vim)

vim related files, cleaning (filetype.vim, syntax/sisu.vim ftplugin/sisu.vim & colors/slate.vim)

db common, fix for table representation

screen text ansi color turned off by default, (color does not suit all terms/consoles)

to turn color on by default, edit sisurc.yaml in (found in ./_sisu ~/.sisu or /etc/sisu) set flag: color: true

to toggle screen color (on/off) use the -c flag

processing path where markup directory is not writable [and no other default has been set] is now /tmp/_sisu_processing/$USER (instead of /tmp/_sisu_processing) [if document markup directory is writable, it remains ./_sisu_processing, unless a different processing path is set in active sisurc.yaml]  1217 

processing path when /tmp/_sisu_processing/$USER is used, clean of content after use (as is in public area on a multi-user system) unless maintenance flag (-M) is used

sisurc.yaml, removed processing directory entry, rely on sysenv default (can still change default in sisurc.yaml)

help, added a bit of 'environment' information, [expand further as needed] sisu --help env

common_db, fix affecting pgsql for endnotes in heading levels 1-3

sisu control, minor cleaning

gedit/gobby syntax highlighting, very basic start, in: sisu-examples/config/syntax_hi

metaverse, digest: sha256 offered as alternative to md5 (configure in sisurc.yaml, md5 should be sufficient for most purposes and remains default)

metaverse, auto bold markup fix

some code shuffling and method and variable renaming (including in sisu control file)

wmap, sorting of matches (object citation numbers)

wmap, words capitalised unless several letters uppercase or is a phrase (rather than a single word)

wmap, names/id associated to phrases, space replaced with underscore

html, heading tag names #h dropped if heading starts with alphabet so e.g.: #h1.2 but #linux [consider #h_linux]

w3c compliance in html for: default homepage, document manifest, and wordmap, (and check that renders properly in lynx, elinks, links2, w3m, dillo as well as the rest)

default home page, make sure that is w3c compliant, and renders in lynx, elinks, links2, w3m, dillo as well as the rest

editors (other than vim already done) filetypes match new filenames

filename extensions, (a) reduce in number of filename extensions and (b) rename processed secondary/temporary files to make matching of editable files trivial *.ss? (editable files .sst .ssm .ssi matched with *.ss? or more precisely *.ss[tmi]). Preliminary tests passed.

.sst (sisu structured text). .ssf removed, reason this is processed as being the same file as .sst and increases the possibility of confusion for the user.

.ssm (sisu structured master) .ssc removed for same reason as removal of .ssf described above. .ssm files may include .sst and/or .ssi files within them.

.ssi (sisu structured insert/information) unprocessed, sisu markup text, for use in master documents, is unchanged

filename extensions, processed secondary/temporary files

._sst was .sss and previously .t (substantive content of composite/master file)

.-sst was .ssu and previously .u (sisu markup .sst downloaded as url for processing)

reason for choice, identifies as .sst files and are processed as such, while easily ignored/excluded on the command line for editing and processing. These can be ignored by the user, but should be processable by sisu as .sst files.

.ssd (sisu structured document) is retained, for use in sisudoc, or sisupod, where a zipped file with image and other content necessary to reproduce the original is made.

filetypes.vim made to match (filename extensions)

cgi search forms in sisu-examples, updated to match filename extensions [and to match 'sisu-F webrick' equivalent]

WARNING: FILE RENAMING NECESSARY as file name extensions have been changed, (there is scope for program breakage as a result, though preliminary tests have been passed).

Also note that, SiSU markup syntax is unchanged. Repeat: there is NO CHANGE to SiSU markup syntax. Renaming of file-extensions should be all that is necessary for things to work as before.

File extension name changes, note this does not affect SiSU markup in any way... but the .s1 .s2 .s3 and like types are discontinued, files should be renamed as explained below

NEW FILE EXTENSIONS the obvious sd and sdf appear to be taken, and there is some use of .st and .sm extensions, so will use .ss extensions, which from an examination of vim filetype.vim and mime.types appear to be available.

sst ('sisu structured text'),

.sst == .s3 (also .s1 and .s2)

.ssf == .s3 (also .s1 and .s2)

rename 's/\.s[123]$/\.sst/' *.s{1,2,3}

ssm & ssc ('sisu structured master' and 'sisu structured composite')

.ssm == .r3 (also .r1 and .r2)

.ssc == .r3 (also .r1 and .r2)

[r was for require]

rename 's/\.r[123]$/\.ssc/' *.r{1,2,3}

suggested convention: use ssm where the master contains only requests for parts; use ssc where the composite document contains its own text but requests inserts. they are in fact (technically) interchangeable, not being recognised as distinct by sisu.

ssi ('sisu structured insert/information') (this is an unprocessed recognised as being in sisu markup but only used as part of a composite document .ssm or .ssc)

ssi == si

rename 's/\.si$/\.ssi/' *.si

ssd ('sisu structured document')

[filename].ssd should be mapped to sisudoc.tgz

THE FOLLOWING OCCUR IN PROCESSING they should be taken care of automatically on use of sisu

sss (secondary file)

.sss == .t3 [t was for tmp]

ssu (sisu structured text file downloaded via url)

.ssu == .u3 [u was for url]

sst_meta (human readable processing file (metaverse))

.sst_meta == .s3.meta

sst_meta.rbm (ruby marshal processing file (metaverse))

.sst_meta.rbm == .marshalMeta

OTHER CHANGES

sample markup documents file type extensions changed to .sst from .s3

sisu, provide warning and advice on renaming when requests are made to process files with old filename extensions.

xml(s) and xhtml, escape greater than and less than in "code" mode.

cgi search form, postgresql, fix - create canned url etc., in line with what sqlite form does

0.36

metaverse, don't number headings that are numbered (or rather, start with numbers), [may need an escape]

manifest, don't assume a document will contain header (related/recommended) links

vim syntax highlighting, sisu.vim, added check that url not preceded or followed by > or < without an intervening space (or <br> which is a bit redundant but a fairly common error that is highlighted as such in full), needed for auto-markup match

html, segmented, footnote in heading levels 1, 2, or 3, (deposit in first segment 4 that follows), and clean heading of the footnote reference marker after the segment in which footnote (for the heading) occurs

html, multilingual documents, ensure html filetype suffix is used in html i.e. use html file suffixes within html, even when -H (rather than -h) is selected [decision to hardcode protection is a bit arbitrary, suffixes required here by existing server configuration. Consequences of overlooking this requirement are a bit latent and fairly dire..., add configuration file escape of protection]

odf, use of brackets (also square) within linked text (and linked images with text), fix { text to link (use of brackets odf issue fix) }http://url

odf, issue with? in url in linked text and images, fix

odf, single step indent with bullet, fix

html, rights passed through special character filter... [do for other "fields"]

metaverse, a couple more characters sanitised, (some braces, long dashes and 'irrregular' whitespaces)

html, segmented, footnotes in subheadings (levels 5 & 6) a clumsy fix revisit and address upstream, [also notes name tag remains unclosed]

regex, set for utf-8, [you may wish to reconsider fixed default]

[sisu-examples, free_culture, minor adjustments to text]

odf, footnote fix for url matches

metaverse, further fix to catch exception for auto-heading/title numbering, change of 0.36.19 (non-substantive/editorial hedings)

html cosmetic, lower navigation band in scroll (doc.html), fix

metaverse, fix required, issue introduced by 0.36.19, affected pdf

metaverse, document auto-heading/title numbering, rule change

odf anchor of heading matches to start of line, fix

odf hyperlinked text match, escape brackets within linked text, fix

cgi sample form, sql search improved [development iterations necessary]

cgi sample forms (sqlite), match highlighting made case insensive, character 'i' added to two files in two places

cgi form (generator), canned url populates search field more cosmetic rearrangement of code, e.g. cgi_common_sql introduced for common code (in pgsql & sqlite forms)

manual cgi samples renamed and updated

         sisu-examples/sample/cgi-bin/sisu_search_pgsql.cgi
         sisu-examples/sample/cgi-bin/sisu_search_sqlite.cgi

cgi form (generator), some cosmetic rearrangement of code, order by output esp. for sqlite, image paths rearranged

cgi form (generator) for pgsql and sqlite split up,

cgi form (generator) match highlighting added [sample search form remains very basic]

images, minor change to sisu.png and inclusion of fsf/gnu levitating gnu

metaverse, sanitize a ' character

bold line shortcut tag, !_ where no bold list, a fix

minor, cosmetic code changes of tests with equivalents (of type .nil? and .empty?) [done a bit quickly though]

minor, one spelling correction in free_as_in_freedom

metaverse_syntax, fix required for alternative markup endnotes

cgi (frontend for pgsql), url link fix (.html suffix) for webrick server

digests/dcc, added info, minor

digest/dcc, (digest.txt) tuning of presentation

digest/dcc, (document content certificate), a bit more information provided, in output and on man pages, e.g. see <http://www.jus.uio.no/sisu/sisu_changelog/digest.txt> or <http://www.jus.uio.no/sisu/SiSU/digest.txt> etc.

sisu man page, minor fixes and minor embellishments

home page, in default and skins, minor change

fix of filelists where param is not parsed, relevant to rsync, scp and zap [problem introduced by changes made for multilingual documents which assumed that param is always parsed] [solution not elegant, but likely to remain a while]

plaintext dos/Unix, check that all dos linefeeds are in place

help (man pages, html, program), minor adjustments, and sync html with man pages

remote (rsync,scp) building of filelist for placement of output improved, relevant for multilingual documents [could be improved further especially for scp, where there is no language code all documents are copied, which results in duplication] [WARNING, this introduced a bug in the way file-lists were built that affected sisu -R (use of rsync), the option in any event is turned off by default]

metaverse, linefeed conversion, convert msdos line feeds \r\n to unix \n for processing

sisu(1) man page, note added on how to produce dos plaintext output file (instead of linux/unix)

plaintext, default shortcut flags changed to produce dos ascii files, reason, Unix/Gnu-Linux seldom has a problem dealing other ascii filetypes, MS based programs are more likely to stumble, also if manifest built concurrently with plaintext will use plaintext command flag to give information on output type - whether Unix or dos etc. [could add a file check of type where manifest is built separately, not really necessary]

skins, minor edits, path to css corrected

html (some w3c compliance steps) [20060115]:

object "id" number names changed, preceded by letter o

use of name tag to give objects numbers (instead of id for numeric value)

footnote links changed (use of underscore (instead of tilde not permitted))

image tags "closed"

skin adjustment

finally reinstate w3c transitional xhtml header

html tables, changed organisation of code [20060116]

odf tables [20060117] [display only without tables headings]

odf pagebreaks [20060117]

odf bullets [20060117]

odf multiple images in object [20060118], image handling, fix [20060122], image captions [20060122], placement within text "as char" [20060123]

overview.txt updated with things done

url screen display, fix to urls in batch processing [20060117] [overlooked because of personal practice of using rant /make to run all requested processes on each markup file in a batch process]

sisu headers, document recommended links, 12 link limit removed [20060120]

tables, introduced an alternative visual representation [20060120]

odf tables, max number of columns increased to 14 from 8 [20060122] (12 may be useful for months plus at least one to describe content)

sisu_test.s3 document added to serve as quick test of markup forms and a rough guide however it does not at all serve as an example of a typical document [20060121]

html anchor heading matches to start of line, [watch] [20060122]

odf text links [20060122]

odf bullets, as image, currently using "red pill" [20060123]

texpdf special character vertical bar / pipe, fix [20060123]

digests, document content certification, work on multiple images [20060126]

digests, document content certification, (digest info) digest for document skin digest, and repeat of document digest [20060127]

sql (pgsql, sqlite), special character escape, changes [20060128]

docbook experimental introduced, another form of xml (may need to rename, so far represents a quick first pass at docbook, and does not qualify as docbook: docbook is released under a liberal license permitting all manner of modifications, but if modified may not be called docbook) is as noted experimental and undocumented, (and may as easily be quietly removed, or renamed as improved upon) [20060131] [will need to study a number of things including embedding document parts (within parts)..., may take opportunity to introduce some substantive tags to sisu that are docbook compatible]

sisu_0.36.5.orig.tar.gz (of 2006w01/5 - 20060106)   1252  Debian release snapshot, unified (SiSU/Debian) build  1253 

sisu man page minor edit

copyright file contains information on setup.rb included with tarball and on Rant used to generate install, both under Gnu Lesser Public License

Debian build changed, fewer packages, hope to unify the SiSU development and SiSU Debian upload builds

plaintext, multi-language document url adjustments

termsheet, output path and urls

[some multi-language document markup samples added to debian build in sisu-examples]

adjustments made for consequences of possibility of multi-language documents in sysenv, wmap, sql (psql/sqlite), remote put

sql prefix column changed to TEXT (from VARCHAR)

sysenv, change to the initialization of constants [revisit]

sql (pgsql/sqlite), (a fix:) "manifest" column replaces "summary" column

html_format_table.rb removed, last dependency removed, rely on css

wmap use main css, and own styles

html batch processing fix, placement of files: index.html, toc.html and doc.html

html -h -H behaviour switch, -h now produces urls with suffixes (hardlinks, including .html .pdf etc.) (this being the default that just works, including for reading output in a browser directly off a file-system), -H omits them and requires an appropriately configured web server. [change in behaviour is the reason for this version number bump]

multilingual/(multiple language) document filenaming convention and associated behaviour, made default, unless turned off in configuration file

      default:
        multilingual: false

multilingual/(multiple language) document output filenaming convention set at 1 in following example list: (1) outputdir/es.[file].html (2) outputdir/[file].es.html (3) outputdir/[file].html.es (which Apache for example can be the first option is convenient in that it organises versions of document by language in the output directory, (i tend to use 2 though)

      default:
        language_file: 2

(the default in the absence of a setting is 1 es.index.html, rather than 2 index.es.html)

[contains a batch processing bug affecting some html output, fix in 0.36.1]

0.35

sisupod, sisu multi-language document pod, in place if config file permits, will search for multiple versions of the same document in different languages, by file naming convention, and all these will be placed into the same sisudoc source file, the intention will be to separate the sisudoc file format for single documents and sisupod for multi-lingual versions of the same. (changes to sysenv and sisudoc for this purpose)

multi-lingual versions of document naming and output conventions conceptually sorted, e.g. assuming config file set as appropriate language version name takes the form: filename~es.s3

output alternatives become, (depending on config file setting) (1) filename/es.index.html (2) filename/index.es.html (3) filename/index.html.es (which Apache for example can be configured to use for automatically serving the users preference)

      default:
        language_file: 2

param, config filename placement information gathering rules for multidocument version output are in place, done with flexibility in mind, language insertions may be made at any of three points in filename

sub-numbering system, default behaviour change/correction, reset when any major number changes [consider offering the alternative of running sub-numbers, below 4~, would be set in header]

urls (-u, -U, -v), match new multilingual file naming convention

manifest, show multilingual version manifests, if available

[contains a batch processing bug affecting some html output, fix in 0.36.1]

0.34

default css, fix to image links (paths), necessitated by changes to directory structure

digests, include in header url for set sisu_manifest, and time and version information at the top of the document

html and wmap output manifest cosmetic link change and a link fix in html

manifest, md5 if markup source is shared, show if -v

directory structure changes [reason for version number jump]

all sisu output server configuration goes into subdirectories named _sisu, one within the main server directory and another within each document collection directory used:

          _sisu/image
          _sisu/css
          _sisu/dtd

localised sisu markup/input configuration is placed directly under _sisu in the markup directory (rather than _sisu/config), the hierarchy becoming:

          ./_sisu
          ~/.sisu
          /etc/sisu

NOTE: it is again necessary to run sisu -CC

NOTE: the following have so far been considered and discarded as alternatives to _sisu: "sisu" discarded as a name sometimes used for a document directory; ".sisu" discarded as hidden output directories may be confusing to the user; "sisurc" remains a possible alternative which is a bit descriptive, however "_sisu" is consistent with the configuration directories, and chosen for now

see notes on css and images for changes to image and css output directories

see notes on configuration for notes on changes within _sisu in local markup directory

manifest, renamed from summary, sisu_manifest.html instead of summary.html [reason: less likely to be useful in other circumstances, summary freed as a reserved filename] [contains: #output #metadata #links]

_sisu: _sisu/conf files and subdirectories moved to _sisu [reason: the deeper directory structure made sense when sisu_processing was also contained with _sisu, it is no longer helpful, the directory structure of ./_sisu mirrors that of ~/.sisu]

images now placed within output directory sisu/image (there is a main sisurc directory and each subdirectory (mapping to a markup directory stub) contains its own sisurc directory)

generation of remote markup/source documents url, some work, on image mappings

css: logic in place for manually created css substitution

* -CC copies css files to output/webserver director sisu_css if they exist in ./_sisu/css, ~/.sisu/css or /etc/sisu/css

-H or -h html -x -X for xml etc. will look in output/webserver sisu_css directory for any requested css. If it exists, pages created will link to it, otherwise, the default css files provded by sisu are used.

css requests may be done on a document or directory stub basis 0~css grey will look for grey_html.css and the directory stub book, will look for book_html.css [note: check and make pages more css friendly]

fix, if the within a document markup directory the directory _sisu_processing exists and is writable it will be used for processing otherwise tmp_sisu_processing is used [i.e. to use ./_sisu_processing for processing, create it]

sisurc.yaml defaults set to false to prevent zap (-Z) and css changes

Sam Williams copyright notice, included under 0~rights in Free as in Freedom, not sure how this has been missed.

minor screen display url correction, in sax.xml

0.33

processing directory, moved to ./_sisu_processing from ./_sisu/processing [reason: makes it easier to backup _sisu [you will almost never want _sisu_processing]] /tmp/_sisu_processing is default and used if the former directory is absent (instead of /tmp/sisu_processing for consistency) [reason for local directory processing option if /tmp is default, exists, if you prefer to keep processing out of /tmp] [consider for /tmp adding to path /tmp/_sisu_processing/[$USER]/[directory stub] to minimise likelihood of collisions, unlikely currently as the default is to regenerate "metaverse" for each request]

css, moved to [web_output]/sisu_css from [web_output]/style [reason: collision with other efforts, manual or otherwise even less likely] this means it is necessary to reinitialise directories, see sisu -CC

external document (using url to call for processing), paths for processing and downloaded images adjusted (processing and output)

install (Rantfile and rant: install), a fix required

0.32

orig.tar.gz should now be updated together with debian package orig.tar.gz has not been updated properly since 0.31.4, debian package has issue with autopackage builder

debian package improved, however: diffs started from scratch, information/history abandoned Reason: undetermined problem with (home brewed) automated package builder. automated package builder (which uses darcs and darcs-buildpackage) builds package normally/properly with a pristine directory structure, but not with accumulated debian build history. For now, the orig.tar.gz and debian package structure are updated, and debian history is not included.

directory named extra removed from source tarball, extra/debian/man moved to debian/man

debian, correction of a man page

odf (opendocument), images - an image per paragraph/object only, at present (thanks Alex Hudson #odf so_solid_moo for feedback, was placing paragraphs within paragraphs, last step in getting images working)

odf (opendocument), sisu document metadata

html endnote url fix

sqlite, repair

minor code cleaning, mostly removal of commented out code, lib html_css.rb, removed as redundant

package: html files in data/doc/sisu moved to data/doc/sisu/html

debian/control a missing comma added to comma delimited depends list

-v urls, minor correction

-q quieter, pdflatex quieter [/dev/null screen ouput except for -v up]

-q -v -V -M -u screen information levels better sorted

[see 0.31.5]

0.31

-v -M etc. (cosmetic) url, output path information improved additional possibilities in configuration, sisurc.yaml setting of programs used: text_editer, web_browser, pdf_viewer, odf_viewer setting of viewing preference, vis path, and url

-CC re homepages, new option setting the (manually crafted) home page, copy from first found of:

./_sisu/conf/home/index.html

~/.sisu/home/index.html

/etc/sisu/home/index.html

otherwise, as before will look for home page in:

./_sisu/conf/skin/doc/skin_sisu.rb

~/.sisu/skin/doc/skin_sisu.rb

/etc/sisu/skin/doc/skin_sisu.rb

and as before if that is not found, take the sisu default

css styles, start implementing a more flexible model for using alternative stylesheets, stylesheets may be specified in document header 0~css or 0~stylesheet [name], and if that exists, or if a stylesheet exists that matches the markup directory stub, results in html, xhtml, xml as appropriate, requesting the matching stylesheets documunts [needs work and testing before it becomes really useable, for the time being is switched off by default to use must be enabled in conf file]

-CCr -CCRZ stubs for remote copying/building of base site, images, css stylesheets, index.html and toc.html (not to be confused with existing remote placement of generated output)

Debian package adjustment

Debian packages broken into smaller packages, for better control over dependencies, source package structure affected (control, .install, .manpages)

sisu-composite together with sisu-examples installs the whole of SiSU

remote url gathering of images re-fixed, e.g.

should produce html and pdf of Free Culture from the online marked up file, with the images [sisu -CC (to copy downloaded images to the output directory)]

[has even more images, you will have to repeat sisu -CC]

[includes a workaround for an odd bug: retry needed on first attempt

sisu control, ensure file array unique [some risk of unforeseen consequences, test]

-v verbose output, minor, tagged on mention of sisu -W starting ruby webserver on sisu output directory

add link to sisu_faq, maintain faq

[debian, started using pbuilder]  1273 

sisu_0.31.3-1 debian:control: Depends: ruby1.8 (>=1.8.3)

sisu_0.31.3-2 debian:control: Depends: ruby (>=1.8.2)

debian autobuild fix [external scaffolding]

odf, minor fix url match

[sample documents urls to amazon and barnes and noble added as courtesy to authors]

[Note: change to automated debian package build procedure]

metaverse, header, italicise and bold lists, results in significant changes markup change use regex directly [results in odf (openoffice) repair of 0.30.9]

0.30

rollback to 0.30.8 header, italicise and bold lists, use of semi-colon delimited list, [new version number 0.31 opened for header use of regex to italicise and bold]

setup.rb 3.4.1 by Minero Aoki included with SiSU as an installer

package directory structure modified to comply with setup.rb default data/man moved to man as setup.rb, affects debian

header, italicise and bold lists, markup change use regex directly [instead of converting semi-colon delimited list]

minor notes on installation in README

latex pdf, the pdfetex parameters used appear to be Debian specific, SiSU LaTeX is written for pdflatex. .. change precedence/ search order, use pdflatex if present, otherwise try use pdfetex (with pdflatex parameter)

url/document output, (largely cosmetic fix) screen information, sisudoc (-S) and sisu markup source (-s) [-S was linked to sqlite]

url (-U) print urls without -v

rsync screen message adjustment

skin:hp linked to sisu_changelog which has been separated from sisu_download

composite documents, fix manual closure of file is apparently necessary !

numeric shortcuts accept rsync extra command flag (-R)

rsync (-R), screen output minor (what default, verbose and quiet do)

conf, homepage, skin path precedence, fix (related to finding ./_sisu/conf/skin/doc/skin_sisu.rb)

summary, suggested links, cosmetic: fix to static url

sisu_doc, drop making of directory _sisu/config (using _sisu/conf)

html segments, summary button, fix (icon and link)

sisudoc, cosmetic: screen output, touch (remove repeat of output filename)

summary, suggested links, cosmetic: replace relative links with static url

configuration, change, use ./_sisu/conf [ WARNING ./_sisu/config is depreciated and will be removed]

db:pgsql bugfix, (for 8.1) added FROM in select statement

zap, delete, -Z disable by default, to use must enable in sisurc.yaml

rmagick, disable load/require by default, sisurc.yaml problem with some local installs of ruby

db:pgsql, bugfix FROM required in a select statement [postgresql 8.1 complained]

pdfetex, call with -fmt=pdflatex

summary, metadata suggested links added

xml, xhtml, html tidy only run with -V or -M rexml only with -M, primary reason a considerable speedup in skipping step unless specifically requested for testing

control file, changes a bit arbitrary, but a bit easier

summary and place of composite document source (-s -y), though just request for other documents [decide later whether to include constituent document parts]

help, update, sync with man pages

debian control suggests keychain (added)

minor cleaning

summary, include plain.txt where available

param, polishing...

sql metadata, reworked ... ongoing

sisudoc, re-named sisu_doc rather than sisu_ball

sisudoc, only -V and -M show verbose tgz of what goes in to sisudoc (previously -v d id)

name correction: SiSU is a recursive acronym, and has other alternative possible expansions, one of which i got wrong, under the influenced of the other !

SiSU information Structuring Universe

Simple information Structuring Universe

_Structured information Serialized Units_

[<-- i got my last name wrong consistently wrote Serialized information Structured Units, which makes less sense, (i am guessing i managed to overlook this because of the position of the word structured in the first and second expansion) i guess this correction calls for a major version number change! hope no one (else) notices ;-) ]

0.29

extremely minor touches for upload, regex match in param of metadata corrected, and copyright symbol matched for odf...

summary, make easily available from different outputs

metaverse, autonumbering of segments from manual text markup, re-checked/re-fixed [as presents some risk must be selected in heading]

metaverse, when run remove maintenance metaverse file unless -M flag used

param, endnotes checking, where endnote references and endotes are separate check than number count matches else report error, [and place error in document summary]

opendocument, renamed file odf

opnedocument, added matching & linking of urls and mail address

summary, warning of document error if endnote number mismatch, note this cannot occur if the preferred markup style for endnotes is used.

sysenv, pdfetex, debian renaming, search for pdfetex, pdftex and pdflatex to generate pdf from SiSU's LaTeX output

rsync use added for remote puts -R (scp is -r)

summary bug fix, variable scope reduced (incorrectly retained information from previous files in batch runs)

introduced -K which deletes output files prior to processing of files of same type

-s sisu markup source copied to output directory, (placed remotely with -sr)

-S sisudoc made and copied to output directory, (placed remotely with -Sr) [renamed from -Z]

--update updates previous output, with same filetype output only, useful

[-F renaming from -S naive cgi search form sample]

[minor editing of program file headers]

sql table metadata created, replaces table titles [breaks former table structure]

sql urls replaces links table

pgsql comments

cgi scripts use table:metadata instead of table:tiles

xml series, poem and group (and code) first pass

opendocument renamed odt.tgz instead of o_doc.tgz

summary, (-y) summary of document outputs generated and document metadata (metaverse includes links to summary, as does html band and latex doc info)

data/sisu (/usr/share/sisu) created for sisu shared images and odf, subdirectories, separating packages sisu from sisu-examples which is recommended only, and should not be needed to provide what sisu requires.

debian/sisu.install map data/sisu to /usr/share/sisu

[small changes: webserv var rename; cosmetic removal in html and xml of less-than greater-than on copy @ << home >>]

tar gzip files changed file suffix to .tgz (instead of .gz) comment added to man page and help

html some character encoding corrections (é and a few others)

param recognises rcs in addition to cvs and 0~rcs+ Id may be used [as alternative to 0~cvs equivalent, metaverse and downstream adjusted accordingly]

debian control added suggests lv and rcs as alternative to cvs [to which it is personally preferred for document control (as making more sense working with favoured used development distributed source control management systems, mercurial and darcs)]

metaverse autonumbering changed, affecting default html segment naming  1296 

0.28

opendocument -o now defaults to produce metaverse first -mo (this is behaviour for other outupts such as html, latex/pdf...)

metaverse footnote url matches, tuning

texpdf url matches, tuning, especially footnotes

help update of processing flags, checked against man pages

some changes to variable names, cf instead of rf (also used pf briefly)

debian control file, minor edit of description of SiSU

doc/overview.txt update on things not done in list

metaverse, bullets accidentally removed, and put back

texpdf character encoding bugfix, (removed iconv) however, sisu requires utf-8 input for extended character sets

character encoding touches, e.g. sample files saved as utf-8

character encoding, moved a basic transform to metaverse, hopefully more predictable characters to deal with and made easier to work with postgresql, affects other modules changes to html and texpdf, neither perfect, both need work esp. html. two steps forward one step back

some database operations visited, (update)

Release (and version number bump) primarily to put ruby sisu segfault bug behind us, Debian ruby-1.8.3-2 released and fixes this [an emergency build to work around the problem was made available as 0.27.0 see note there for details]

remote placement of open document files added (odt)

added open document format to several default shortcuts sisu -2 etc.

made note of opendocument format output on sisu home page [feature not complete]

synced skin_sisu.rb files, (there are a bit too many of them, most would normally be syslinks)

[now using mercurial as well as darcs, darcs to build]

0.27

Ignore this branch: sisu-0.26.2 upwards are more recent.

sisu-0.27.0 was an emergency build, (2005-09-26) released after sisu-0.26.1 as ruby 1.8.3 (2005-09-21) breaks SiSU, ruby segfaults.  1303  This was fixed in ruby 1.8.3 (2005-09-29), and uploaded to Debian unstable as ruby-1.8.3-2 on 2005-10-21. For notes on sisu-0.27.0 see <http://www.jus.uio.no/sisu/sisu_changelog/changelog#0.27.0>

Avoid segfaulting builds of Ruby. Ruby versions that segfault sisu:

ruby segfault first appeared in ruby 1.8.3 (2005-09-21) and was removed by TS:Guy in ruby 1.8.3 (2005-09-29)

ruby segfault reappeared in ruby 1.8.3 (2005-10-12) and was again removed by TS:Guy in ruby 1.8.3 (2005-10-13)

0.26

sisu file format flag moved to -Z (from -B)

sisu -Z without [filename/wildcard] makes gzip of sisu directory of marked up files, including sisu markup source files, local configuration file, images and skins.

sisu -Z [filename/wildcard] makes gzip of individual sisu file specified including sisu markup source file and related images and skin

opendocument format, -o, experimental, incomplete, [ignore]

done: headings; footnotes; bold, underscore, italics, strikethrough; superscript, subscript; extended ascii set; indents; groups - poem, code

todo: images; groups - table; bullet; line break?; page break?; table of contents; page header/footer?

debian build (i) recommends sqlite added, overlooked previously; (ii) added recommend zip, used in the making of open document; (iii) removed recommended incorrect libcgi_ruby. libfcgi-ruby1.8, remains; (iv) have added a basic open document file structure as a tgz file

a sisu file format introduced:, -B, a gzipped file, containing: sisu markup sourcefile, its images and its skins, opens as sisu_ball directory, which once unipped sisu may be run within, (sisu does not at present automatically unpack and run on these files, but is a convenient way of packing the contents of a file for sending) [early days]

man1/sisu.1 upadated and html on -B sisu file format (sisu help not yet done)

cosmetic firefox taken from list of lightweight browsers, remains very much amongst the heavies

cosmetic correction on info related to librmagick-ruby contained within sample document free_culture

css, minor, caption - display: inline;

syntax highlighting (sisu markup), editor configuration files, added, see:

sisu-examples/config/syntax_hi/README

/usr/share/sisu-examples/sisu-examples/config/syntax_hi/README

preliminary for the editors:

NOT REALLY DONE, but intitial attempt included anyway:

[vim-sisu still provides the most comprehensive sisu markup editor environment]

evince becomes the default pdf in maintenance urls etc. (previous was xpdf)

document samples image dimensions manually provided, affected document sample "Free Culture", Lawrence Lessig. Note this is not necessary from sisu-0.20.0 onwards, if you have rubymagick installed.  1307 

NOTE: this is an emergency version of SiSU that does not segfault with problem versions of ruby, see note follwing. It is prepared without Syck/Yaml

Problem ruby versions:

ruby 1.8.3 (2005-09-21) and was removed by TS:Guy in ruby 1.8.3 (2005-09-29), released as Debian unstable ruby-1.8.2-1, and in

ruby 1.8.3 (2005-10-12) and was again removed by TS:Guy in ruby 1.8.3 (2005-10-13).

Temporary build, to avoid ruby 1.8.3 (2005-09-21) segfault.

WARNING, ruby 1.8.3 (2005-09-21) breaks SiSU, ruby segfaults.  1309  This is fixed in ruby 1.8.3 (2005-09-29), but the new Ruby build is not yet uploaded to Debian unstable (as of 20050930).

A bug report has been made to ruby-core the nature of the bug is unclear but appears to be related to syck/yaml as ruby does not segfault without it.

Preferable solution to installing sisu-0.27.0, use any version of Ruby other than the problem versions, and the sisu-0.26 branch or later.

WARNING ruby 1.8.3 (2005-09-21) segfaults SiSU, fixed in ruby 1.8.3 (2005-09-29) thank you TS/Guy Decoux. 'Fixed' ruby not yet uploaded to Debian unstable 20050930

NOTE: this is a debug/emergency version of SiSU that does not segfault with ruby 1.8.3 (2005-09-21) [i486-linux]. It is prepared without Syck/Yaml

Temporary Emergency Release ruby 1.8.3 (2005-09-21) [i486-linux]] segfaults sisu

bug report made to ruby-core 2005-09-24

this version of sisu built without Syck/Yaml and is not configurable, (uses sisu default configuration only) ignoring yaml user config files

as such this emergency release:

only uses sisu default configuration settings, ignoring yaml user config files

does not provide sisu version information

css, minor, caption - display: inline;

syntax highlighting (sisu markup), editor configuration files, added, see:

sisu-examples/config/syntax_hi/README

/usr/share/sisu-examples/sisu-examples/config/syntax_hi/README

preliminary for the editors:

NOT REALLY DONE, but intitial attempt included anyway:

[vim-sisu still provides the most comprehensive sisu markup editor environment]

evince becomes the default pdf in maintenance urls etc. (previous was xpdf)

pruning, removed words.rb (vocab is used)

wmap & vocabulary, minor modifications, and runs metaverse

minor pruning and renaming, small changes

sisu_webrick, url path changed, server no longer builds url paths with tilde prefix

sysenv, and link urls updated accordingly

sisu-examples, cgi sql search form, minor updates sqlite sample set for webrick server defaults, port 8081, with url suffixes pgsql sample set without (port is default port, and no url suffixes)

sisu_webrick server defaults must be changed in rc files, rather than by command-line parameters (reason, the rest of sisu would not see command line parameter changes, and would continue to provide rc details)

start enforcing lower case sisu markup tagging

0.25

cgi, cgi sql search form sample generator, link suffixes added

cgi, cgi sql search form sample generator, -S takes additional parameter 'webrick' to provide port links that webrick server will use.

sisu_webrick, -W does cgi form.

sisu_skin & defaults, home page, adjustments

html output (tune), fix image, no link where non provided, i.e. where the { imagename.png }image notation is used

html output (css & tune), image caption, smaller font

configure, (-C & -CC) absence of trang is only reported if -V (extra verbose) flag is used

processing remote urls, (-C & -CC) absence of external_images is only reported if -V (extra verbose), is used [re-test]

man page, man sisu, updated to include "-S webrick"

urls, minor correction (maintenance mode output)

man sisu(1) and sisu(8), minor edits

minor code cleaning

latex/pdf, librmagick-ruby: will throw a warning and build latex/pdf document output without a given image if the image is marked up without the image dimension, if the librmagick library is not installed. [librmagick-ruby is not "required" as provided documents are marked up accordingly, it is never needed. As an example first image markup form requires the library, the second does not:

{ freeculture01.png }http://www.free-culture.cc/

{freeculture01.png 350x350 }http://www.free-culture.cc/

man pages additions, mostly "man 8 sisu"

metaverse, default is to run metaverse wherever it may be required, i.e. when any of - abDdeHhINptXxz

plaintext, endnotes version (-e) sorted, -a (footnotes following paragraphs) is ok [however is currently an either or, both output plain.txt]

texinfo, basic output working again (with pinfo). [fix later, moving of & to <=and>]

debian, recommends, added pinfo

help, fix help on markup \ escape character (escaped)

metaverse, possibility to escape backslash (\\ to produce \) [Special character escape set near complete for regular text, verify situation for code blocks (code{) where characters should be treated verbatim].

metaverse, markup, test and addition of possibility to escape contextual special characters, such as asterisk (*) and exclamation mark (!), which are not normally a special characters that need to be escaped, but the ability to do so is useful where for example used to describe their markup function as in *{bold}* !{emphasis}! verified others used in a similar way (*!/_^,+), either already available or also added /{italicise}/ _{underscore}_ ^{superscript}^  1319  ,{subscript}, +{inserted}+ -{strikethrough}-

man page and help, comments added on escaping special characters and headers

[extensive testing escaping the full range of special characters is necessary these include \ < > { } and the contextual * ! / _ ^, + ]

metaverse, cosmetic corrections related to bold, italics and punctuation

metaverse, and add a few language settings

latex/pdf start looking at language settings, set language selected for document: \documentclass \usepackage \selectlanguage

latex/pdf creator copymark turned off by adding minus sign to creator header, as in 0~creator- [name of author]

man pages, help files updated on language settings

copyright SiSU system, object numbering etc. in pdfs, (reduced font size and words from previous Debian release, [a bit more than in 0.25.5])

latex/pdf cosmetic reduced size of font related to document processing information

metaverse, fix related to 0.25.3 (interaction between operation of bold lines and bold words selected in header).

metaverse, subtle correction todo with interaction between operation of bold lines and bold words selected in header.

changes to text accompanying latex/pdfs, toning down of language, correction of gpl2 url to fsf.org rather than gnu.org

latex/pdf fix, produce text without object numbers (problem with documents including grouped text markers, poem{ etc.) fix affects processing with the -0 flag (zero), e.g. sisu -mHp0v [filename].s3

cgi search for generator: fix, removal of an errant line of code (removal of hardlink to version number)

db/sql: changes to database table names, cleaner

db/sql/search: cgi search examples and cgi search sample generator modified accordingly

db/sql: recreate, creates if no existing database, instead of complaining (createall complains if database exists - you may not wish to remove existing db)

db/sql: replaced oid table with links table, and provide links to output files, affects both pgsql and sqlite

NOTE: previously existing sisu pgsql or sqlite databases should be removed manually, (or with previous version of sisu), and then rebuilt using >= sisu-0.25.0

0.24

character encoding, existing table hash replaced with a KirbyBase db character encoding table builder. The modified lib is not currently used by sisu, (& KirbyBase  1328  is not included with sisu), hoever, this is a possible way forward should such a table be needed.

latex/pdf, also html, bugfix, a bit of work on escaping of sisu special characters, html latex/pdf, done { } ~ < > &   1330  examine the need. Several characters are only special characters in given particular locations or combinations,  1331  the idea being that characters that are special or potentially so can be escaped in any event. Further testing and work necessary, hash is still a problem.

escaped characters spaced: { } ~ < > _ - / & | : ! ^ #   1332 

escaped characters strung together: {}~<>_-/&|:!^#   1333 

LaTeX special characters: $ & % # _ { }

metaverse_syntax, in code mode special characters should not be escaped

      { } < > ~ _ - / & |: ! ^ #
      $ & @ *

test more extensively, and correct over time. Note that the hash is for the moment a problem (in latex/pdf)

latex/pdf and other files make sure headers are only given special treatment if at start of text, i.e. if actually headers, so can have a description of a header within text like 0~level new=1,2,3; break=4

0.23 development branch rolled back into "stable" version number branch, (see 0.23.0 and 0.23.1 for changes)

pdf page breaks, accepts header notation: 0~level new=1,2,3; break=4

html fix to links band -H added .html to home url, removed

metaverse_syntax, adjustment to lines parsed, (result affects some endnotes)

plaintext small fix & symbol

minor touches to documentation

some tested of supported file character encodings utf8 and iso8859 with unix line breaks

NOTE: sisu markup files should be saved with Unix line endings, and in utf-8 or iso8859.

0.23

fix to the still very naive sqlite search cgi example for sqlite

sisu -S will generate a copy of the naive sqlite and pgsql cgi search form it then needs to be copied to the cgi-bin directory. It differs from the example given in that it looks at output directories and includes them as database options. It is more accurate on sqlite, checking that a database exists, however both forms in their current form leave a lot to be desired.

url to location of sqlite database

latex/pdf cosmetic fix to front page removed angle brackets enclosing location information, they appeared incorrectly and it looks cleaner without them

texpdf, utf8 added properly by way of ucs package (now requires latex-ucs) breaks some things but in the long run is hopefully an improvement currently supported encodings utf8 and iso8859.

Iñtërnâtiônàlizætiøn a slightly more extended character set, using utf-8,   1337 

! # $ % & \ () * +, -. / ' 1 2 3 4 5 6 7 8 9: ; < = >? @

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ]

< - ~ t ¡ ¢ £ ¤ ¥ ¦ § ¨ © ª « ¬ ­ ® ¯ ° ± ² ³ ' µ ¶ * ¸ ¹ º » ¼ ½ ¾ ¿

À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ð Ñ Ò Ó Ô Õ Ö × Ø Ù Ú Û Ü Ý Þ ß à á â ã ä å æ ç è é ê ë ì í î ï ð ñ ò ó ô õ ö ÷ ø ù ú û ü ý þ ÿ

character encoding, utf-8 improved basic table, not yet utilised though, [and even as a small utf-8 table is on the large side]

minor code play with output (webserve) path

sqlite db output mapped to webserve path, current directory stub [instead of being deposited in pwd]

very naive sqlite search cgi example for sqlite, [badly broken frontend, look at, apparently taken too directly from working naive postgresql cgi frontend example, (the database created is fine though)]

metaverse, changes to automatic naming of levels 5 & 6 same methods used as has been for level 4, could possibly clash at times with level 4 in doc version consider implications [easy to attach somthing to level 5 & 6 names]

document digest in document information by default (previously only when cvs info also selected)

loading of skins for inserts

0.22

metaverse, regex fix for bold line syntax (!_)

latex/pdf, placement of object numbers re-sorted, an inelegant fix, revisit later.

sysenv, option to check load path and only load module if available reduce dependency on other packages, introduced for rmagick and now used also for dbi.

rmagick if installed can be used to calculate image dimensions, so these need not be provided in markup.

sql database operations only attempted if dbi is loaded(/available for loading)

texpdf, used parskip and removed use of smallskip from latex output (& other minor edits)

FSF address updated: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA  1340 

0.21

sisu-examples sisu_search.cgi sample correction

debian Sources.gz

minor code edits

changes to file structure for processing and provided images now placed under the markup directory in _sisu ./_sisu/processing [built by sisu] unless ./ is not writable then /tmp/sisu_processing ./_sisu/image [added to manually] ./_sisu/config [precedence: ./_sisu/config ~/.sisu /etc/sisu]

skin fix reading and precedence [uses ./_sisu/config/skin ~/.sisu/skin /etc/sisu/skin ./_sisu/processing/external_document/skin]

external documents, provide similar logic placed in ./_sisu/processing/external_document/(image,config) this should mean that along external documents are downloaded together with their skins and images and processed as a unit

changed a couple of search path statements (skin,sisurc) to use blocks.

sisu manpage updated to take account of changes (help not yet)

0.20

merged/rearranged (and renamed Postgresql and Sqlite classes). Now SiSU_SQL (avoid possibility of namespace clashes).

plaintext, xml (sax & dom), xhtml, run on a new file creates required output sub-directory, it was relying on other selections for directory creation [thought done previously] affects flags -a -x -X -b

minor sql database rationalisation, postgresql & sqlite logic in same files [additional testing required]

added metadata categories (to the Dublin Core 15) added the following metatags, which seemed appropriate/useful: translator (or translated_by); illustrator (or illustrated_by); prepared_by; digitized_by (added to parameters, metaverse, sql databases)

note in man pages and help about sisu markup files being in UNIX ASCII

sisu-vim auto-conversion to UNIX ASCII for sisu markup files (sisu parses unix ascii, not dos ascii ... consider further, an issue for example with many(most/all?) Project Gutenberg texts)

(e) fix for new header links where linbreak used and imported into composite document, result in .t? suffix

(sisu_search.cgi) sample search form, minor fixes & improvements, still a mess

fix for old style header links, (broken in 0.20.4 with introduction of new)

(m) header links notation made similar to links within text old markup syntax remains possible, (i.e. backward compatibility kept) [should possibly force version number change to 0.21 but is minor change]

small touch to sisu vim syntax file, remove false positive error highlighting for alternative links markup

touch to remove relevance of whitespace in image markup (previously a problem in composite texts for latex/pdf output)

(metaverse for html) touch, whitespace reintroduced where name is given to an object as easy solution to interference that may otherwise arise with urls

ruby-libyaml removed from debian control, [a DD had informed me that he had neeeded it early in packaging days he must have been working with a version of ruby older than sisu is written for]

fixed sisu -CC, removed attempt to create pg db (this is done rather on -D createall request if does not exist)

sisu_vim manpage

latex/pdf monospace font (ttfamily) where code delimiter is used

html monospace font where code delimiter is used

rescue and attempt to create pg db only if db of pg type requested

a rule for stripping deleted text from clean text md5 digest introcued

debian signing of package against <ralph@amissah.com>

console output XML clutter reduced, REXML parsed headers now only produced for -V not -v

debian package, started GPG signing dsc and changes file for sponsor:

  ID =
    BD76E77F

  Key fingerprint =
    F899 5A87 C648 3F38 5107  79F1 B97B 7C4D BD76 E77F

  -----BEGIN PGP PUBLIC KEY BLOCK-----
  Version: GnuPG v1.4.1 (GNU/Linux)

  mQGiBEL8fs4RBADNNhIsG6i13rDL4JLTgqy0fzcx8oJ9E/xDKeQo/5pqs18FvyKo
  VsHdkUrPptZgxowalPi2aWvZgdi56yUFt295pNedMNXfTnwkVF/9PSA3r4OTBFWw
  7NJYRUu2ZaSqtj3LpnBhsPpDqcl2g5Mry88mMLUeWB9OtsZE/QFVnoJqawCg4QSY
  IOtgdxZVJfibHbFA0/2iG3cD/A98l/BuRWF+kwNacj1q+D0glC/u9mvg56fnAzTL
  Osbhza/ebqvPgtFpP4PlIuvTcRZ9QsSJgmCTxNRPSKWPGqDmj7B7MDcPKUyJAPKB
  fSLm5v5BuKTCLl9jyihbOqIdTgF1hoBHxTyfYWpVVuhdFP1kahityDNGpRhSfTif
  doDLBACkB090RwyYBR589CMjF4miOo5m29ooQZO3tkR+6w5ny81H+qIHVx3TQZa9
  d2166YcxMOFLh2mXBcVNsF8gQpv8Otk+Oyu5FFKqJiGV6JkEPf/W+iXMdpvTrxtc
  rmU8cKagKxxBjue8PlI6bGusEjJXgmsTwOZB5WxCW4QQs49VoLQhUmFscGggQW1p
  c3NhaCA8cmFscGhAYW1pc3NhaC5jb20+iGQEExECACQFAkL8fs4CGwMFCQPCZwAG
  CwkIBwMCAxUCAwMWAgECHgECF4AACgkQuXt8Tb1253+R+gCg3KfzSGEmdWf01ryr
  QLm35LutXS8AoNVfXb3OB1BMph6bOSNJpIyZAOgstCdSYWxwaCBBbWlzc2FoIDxy
  YWxwaC5hbWlzc2FoQGdtYWlsLmNvbT6IZAQTEQIAJAUCQvyEaAIbAwUJA8JnAAYL
  CQgHAwIDFQIDAxYCAQIeAQIXgAAKCRC5e3xNvXbnf12SAJ44Tuntdnqv7lAGgRes
  KMFbHSt3YgCgjXkkHqY167kvDWmxrdAfupv7Ad65Ag0EQvx+2RAIAL23ShZnJJi/
  1un84eoUoQ/AaXmGAhYjVlYiJzMjTXBygS12TnpNkqibnnIqbn/6v1WFIgZNRhzS
  GzKo//MYtORdhB25UYe0YeOhZhyABLNSFKCye1ACBfDpJAFzc+kh7GjA1k2hnDsn
  zox49eJyubO1FxiXXYrKaSMOGkuhp/JaLEVHZZyY++Zq0TuS8t3bOmNkUbL5X5oZ
  n600yZzNfdQ8/5LjwIUvY9BDR+tHyypGyegDDmS5BVEjmW2d9ujDbVYRY6twA0q6
  6WSx2WqT/HzdvSirEiPp3ENwQAaTnGT0G5q2zmYtutb9Yd/V/5aQBMEkAXF/JT4H
  uw5ad3C6xNcAAwUH/jmC7wmvfA6Dqh9TfqDux9LzWbIny0NsgYTsE2Bkhg8kuHgb
  PeqpOeJRFYxQkhknzW1PZZVwtxmfFgWgvukW4fqGSPWSpWDaYL91zkx2HRMBG1Nb
  YwqNOLQnolRE9z/42b/M4oyIWhd0WTi6tZt5pMvpW5Dn7tOsnU3PlNM3AAv3Bjp9
  QBki1KRjZC7PdKnQa9KSwvr4hgvvBlT4Is9131vmAZhu41Ni8UORmoq5e/lqd5O/
  0QuySo+ZJEyLQuulfK19NPALZM+fu6/3dUHAu4D27MafYdQNqY3Xks4mquQ2p95k
  OhNer8Yu7SSyBCIO/8V71UhkgyUdG7fMl0BzqPmITwQYEQIADwUCQvx+2QIbDAUJ
  A8JnAAAKCRC5e3xNvXbnfzpwAJ0ZKPoWuWrx8K/zGSIRRj7ZRbf6KgCgji13BXoF
  tJaIUHauen7hNIoUQXo=
  =6US6
  -----END PGP PUBLIC KEY BLOCK-----

remap sisu psql database names to SiSU_[directory name stub] instead of just [directory name stub] as this will make name collisions (and accidents) with other databases, when using SiSU to creating, deleting and recreating databases much less likely happening to other databases far less likely. [renaming means databases need rebuilding for use]

(l) have made postgresql >=8.0.0 [should say postgresql-8.0] the default requirement. An issue showed up with sisu & postgresql 7 series and UNICODE sequences used, as sisu as released is fairly new there is little incentive to maintain it [however, problem would seem to indicate a lot of bug testing is required, i am currently using UTF-8 locale (en_GB.UTF-8)]

cgi script example updated to match SiSU_[directory name stub] convention and to default to search of sisu-examples as this is a standard/common directory anyone might generate (or rather ./document_samples_sisu_markup)

0.18

(webrick url) console display of output text default to webrick url (can be switched off in sisurc.yaml, by setting webserve,webrick_url: false) however this assumes people know to start sisu_webrick (it is a toss-up between advertising webrick's availability, and sticking with filesystem paths as default, may have to revert) have thought of tying webrick url output to starting sisu_webrick automatically, would need to look at log files and get logging off the console, else would disturb other sisu console output. [a problem appears to be that in some browsers old cached pdf is served when requested, so changes made in subsequent document generation may not be displayed, consider implications]

sisu_webrick port sysenv default set back to 8081 (instead of 8111, consider 8123)

use createdb to attempt to create relevant pgsql database (using stub of directory name; uses a system command and assumes user has permission to create db, if user does not, and the database does not exist, would not be able to proceed anyway)

inelegant handling of "" image bug (no image) that appears in a test document.

a few urls shortend back to <http://www.jus.uio.no/sisu> from <http://www.jus.uio.no/sisu/SiSU> in defaults

some license clean up, gpl2 or later (appearing in pdf text output), removed sentences referring to alternative, somehow missed in previous grand cleanup sisu_0.16.24 where all document headers were cleaned, and the rest i thought [apologies 0.18.7 was rebuilt to include this change, they occurred in the file defaults.rb and texpdf_format.rb].

fix -N md5 digests batch mode, garbage cleaning

fix -N remote placement (revisit remote placement)

sequence digests if requested follow on directly after metaverse -mN...

html and latex/pdf so far, continue tradition of assuming that a comma (,) or full stop (.) following a url is part of a sentence, i.e. if a url actually is terminated by a comma or a dot are not parsed correctly, is convenient, consider implications though, may need to change. The changes were to make the behaviour of marked up curly braces with urls attached versions correspond with the usual handling of urls in sisu

fixed digest tree where image not found

defaults for shortcut flags (-1v -3v etc.) set to create the digest tree (-N) and to include filetype suffix (-H) as this works with webrick (sisu_webrick)

jpg image support consistently added (to existing png & jpg) gif consistently removed as on cursory glance does not appear to be supported by tetex, trivial to add later

man page and help mention of verbose screen output of digest tree

fixed metadata (metaverse) sourcefilename (where rc not used)

bugfix output paths, may change again, currently the default if writable is /var/www/sisu (and if no ~/sisu_www) (in previous version wrote to /var/sisu/www/sisu if writable too idiosyncratic a solution)

bugfix image markup where image tag (rather than url) used working for html and pdf again

fix metadata (metaverse) sourcefilename (where rc not used)

detailed document md5 digest output as digest.txt generated with -N flag   1362 

added -N flag (document digests) to man pages and help

replaced uses of include? with plain regex (some vague recollection of rumours of depreciation in future ruby)... no rush, perhaps should have waited

(e)moved use of -o flag from old table based html

digests on clean text, rule... revisit, but body and endnotes treated "same"

tmp fix for special image characters, (e.g. Euro and Copyleft) tmp because image is taken from local directory images where ought to be taken from general image set, revisit.

document meta_data, version information re-organisation

texinfo cursory look, initial 0.18 fix

db pg/sqlite md5_all fix for level 4

latex/pdf, tmp bugfix, substitute & with 'and' in toc, needed e.g. for AT&T, see ffa, REVISIT

a bit of play with texinfo module, but (still) broken (in 0.18) until tested

some writing in man pages

sisu_0.17.5.orig.tar.gz  1367 

plaintext linebreaks in endnotes br

xml series, branch-fix todo with tables (common_xml)

html endnote section branch-fix

sisu_0.17.4.orig.tar.gz  1368 

url maintenance mode, minor fix

small fixes to latex pdf mostly todo with & character

sisu_0.17.3.orig.tar.gz  1369 

md5 into postgresql and sqlite modules, (including endnotes clean md5 digest)

Implemented, but need to be consistent about content of paragraphs on which md5 digest is made:

1. clean/stripped text without any markup, paragraph, headings etc. without endnotes

2. endnotes clean/stripped text digest only (there may be several endnotes within a paragraph)

3. whole object, text with markup and any endnotes

some renaming in db modules

sisu_0.17.2.orig.tar.gz  1370 

change in metaverse representation of md5 hashes

cleaning up of output after introduction of md5 digests

sisu_0.17.1.orig.tar.gz  1371 

version number switch to development branch, some consequential changes.

sisu_0.17.0.orig.tar.gz  1372 

incorporated md5 digest keys for each object (paragraph, table etc.) in "metaverse", available for use for downstream output/processing as desired, there will be a clean text hash (including endnotes contained within the paragraph), and a marked up tag..., (both taken from the metaverse) . This is a fluid situation. Debs though built, have not yet been made available, this is experimental, and it's final form (depending on making the most useful md5 hashes) uncertain.  1373 

0.18 md5 digests on every object (paragraph, endnotes etc.):

0. md5 digest taken of the document source and placed in the metaverse (implemented much earlier)

Produce md5 digests (in metaverse) for every paragraph and endnote, specifically an md5 digest for:

1. clean/stripped text without any markup, paragraph, headings etc. without endnotes

2. endnotes clean/stripped text digest only (there may be several endnotes within a paragraph)

3. whole object, text with markup and any endnotes

[digests should not include other digests]

Digests are available for use at will in downstream modules, e.g. in database mapping, to identical paragraphs, possibly in html scroll, to identify unchanged content, etc.

0.16

sisu-examples, Free as in Freedom ... minor touch, previous markup broken, will check later

copyright string made more clear as 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005 ... only question being whether it should not have been 1996.

copyright headers changed within files for Debian

some changes in use of ocn for segment naming in html output

a couple of postgresql fileds changed to text

using Rant 4.0 for package build and install(er)

cosmetic rearrangement of code

metaverse fix for alternative endnote markup marker at end of line

texpdf fix for images, (where dimensions not provided) not final, may need to pass through imagemagick at metaverse stage

fix to cgi sample sisu_search.cgi

small bugfix (param screen print)

for Debian build new sisu-vim package, the result of separating out sisu vim files (syntax & folds) from the main package (and it was previously in sisu-examples)

touch to syntax highlighting

small touches to vim syntax highlighting

some fixes to vim syntax highlighing: - changes to markup syntax introduced in 0.16 release broke parts of syntax highlighter, more no doubt to follow.

separated color file out from ftplugin ... called dusk (or slate) by me for several years i now call it sisu... perhaps i should stick with slate as it is pretty appropriate... hmmm, slate

package built off an older Debian installation  1384 

small touches to offer vim config files working the way i am used to with Debian install... needs testing by someone with different habits though.

separated vim syntax and ftplugin directory... have still got color file in ftplugin/sisu.vim file which is not acceptable.

sisu vim ftplugin ... for folds, syntax, colors, markup auto installed in debian, (but uses shared filetype in /usr/share/vim/addons check how that is supposed to work) else (non-debian install) Rantfile places in /usr/share/sisu-examples/config/vim

debian setup of vim syntax ok... however much vim setup still to automate, immediately noticeable: folds for sisu not sorted; and permitting cursor movement up and down without following long lines with screen wrap; (and no clever way yet to contribute colors other than through sisu-examples, but they being user preference should be contributed with care).

on_markup.txt quick check & minor update

home page index.html creation, path precedence set: ~/.sisu/skin/doc, /etc/sisu/skin/doc, defaults, and content is interchangeable (so future latent break is less likely)

touch to Rantfile

bugfix a default variable, in defaults version should be @ver introduced by cuts and pastes between different files, with recent default home page updates; make less likely to happen in future, for now quick fix, revisit: currently index.html taken from ~/.sisu/skin/doc if it exists else defaults, /etc/sisu/skin/doc is ignored, breaking expected path search precedence

small edits to man pages and help NB have taken out reference to alternative markup possibilities e.g. b{ for bold }b being available as well as *{ bold text }* (as the letter the and html equivalents are depreciated, having or using alternative markup styles is less tidy)

cleaning up of man pages, largely for html presentation generated by rman

minor edits

added the man pages in html (converted to html using rman)  1395 

and related rather cosmetic changes

vim folds for sisu markup files updated command is :F (ruby folds :R) assuming the file is in place and in use

some cleaning of wordmap output, regex exclusions added, not elegant (special issue pages include sha and md5 output, also excluded)

[released 0.16.6:] vim folds for sisu markup files updated command is :F (ruby folds :R) assuming the file is in place and in use

comments, url locations of samples, output, etc. added to markup syntax files (in addition to SiSU home which was already there)

removed from tarball markup samples "eu contract law principles" which can still be found at <http://www.jus.uio.no/sisu/sample>