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

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

Structured information, Serialized Units

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

1. Description

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

2. Markup and Output Examples

2.1 Markup examples
2.2 A few book (and other) examples
2.2.1 "Viral Spiral", David Bollier
"The Wealth of Networks", Yochai Benkler
"Two Bits", Christopher Kelty
"Free Culture", Lawrence Lessig
"CONTENT", Cory Doctorow
"Democratizing Innovation", by Eric von Hippel
"Free as in Freedom: Richard Stallman's Crusade for Free Software", by Sam Williams
"Free For All: How Linux and the Free Software Movement Undercut the High Tech Titans", by Peter Wayner
"The Cathedral and the Bazaar", by Eric S. Raymond
"Down and out in the Magic Kingdom", Cory Doctorow
"Little Brother", Cory Doctorow
"For the Win", Cory Doctorow
"Accelerando", Charles Stross
"Tainaron", Leena Krohn
"Sphinx or Robot", Leena Krohn
"War and Peace", Leo Tolstoy, PG Etext 2600
"Don Quixote", Miguel de Cervantes [Saavedra], translated by John Ormsby, PG Etext 996
"Gulliver's Travels", Jonathan Swift, transcribed from the 1892 George Bell and Sons edition by David Price, PG Etext 829
"Alice's Adventures in Wonderland", Lewis Carroll, PG Etext 11
"Through The Looking-Glass", Lewis Carroll, PG Etext 12
"Alice's Adventures in Wonderland" and "Through The Looking-Glass", Lewis Carroll, PG Etexts 11 and 12
"Gnu Public License 2", (GPL 2) Free Software Foundation
"Gnu Public License v3 - Third discussion draft", (GPLv3) Free Software Foundation
"Debian Social Contract"
"Debian Constitution v1.3", (simple/default markup)
"Debian Constitution v1.3", (markup adjusted for output to more closely match the original)
"Debian Constitution v1.2", (simple/default markup)
"Debian Constitution v1.2", (markup adjusted for output to more closely match the original)
"A Uniform Sales Terminology", Vikki Rogers and Albert Kritzer
"The Autonomous Contract" 1997 - markup sample
"The Autonomous Contract Revisited" - markup sample
"United Nations Convention on Contracts for the International Sale of Goods"
/PECL/ the "Principles of European Contract Law"
2.3 SQL - PostgreSQL, SQLite
2.4 Lex Mercatoria as an example
2.5 For good measure the markup for a document with lots of (simple) tables
2.6 And a link to the output of a reported case

3. A Checklist of Output Features

4. Introduction to SiSU Markup  114 

4.1 Summary
4.2 Markup Examples
4.2.1 Online
4.2.2 Installed

5. Markup of Headers

5.1 Sample Header
5.2 Available Headers

6. Markup of Substantive Text

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

7. Composite documents markup

Markup Syntax History

8. Notes related to Files-types and Markup Syntax

9. Commands Summary

9.1 Description
9.2 Document Processing Command Flags

10. command line modifiers

11. database commands

12. Shortcuts, Shorthand for multiple flags

12.1 Command Line with Flags - Batch Processing

Technical Information

13. Technical notes

13.1 See abandoned U.S. Provisional Patent Application

14. Diagram / Chart

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

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

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

A Summary of notable events

16. A history of SiSU and its outputs including search

A Chronological history of developments on SiSU

1993

1994

1995

1996

1997

1998

1999

2000

2001

2002

2003

January
February
March
April
June
July
August
September
November
December

2004

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

2005

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

2006

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

2007

January
February
March
April
May
June
July
August
September
November
December

2008

January
February
April
June
September
October
November
December

2009

January
December

2010

March

2010

March

FAQ, Howto, Installation, etc.

HowTo

17. Getting Help

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

18. Setup, initialisation

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

19. Configuration Files

20. Markup

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

21. Change Appearance

21.1 Skins
21.2 CSS

Extracts from the README

22. README

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

Extracts from man 8 sisu

23. Post Installation Setup

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

24. FAQ - Frequently Asked/Answered Questions

24.1 Why are urls produced with the -v (and -u) flag that point to a web server on port 8081 ?
24.2 I cannot find my output, where is it?
24.3 I do not get any pdf output, why?
24.4 Where is the latex (or some other interim) output?
24.5 Why isn't SiSU markup XML
24.6 LaTeX claims to be a document preparation system for high-quality typesetting. Can the same be said about SiSU?
24.7 Can the SiSU markup be used to prepare for a LaTex automatic building of an index to the work?
24.8 Can the conversion from SiSU to LaTeX be modified if we have special needs for the LaTeX, or do we need to modify the LaTeX manually?
24.9 How do I create GIN or GiST index in Postgresql for use in SiSU
24.10 Are there some examples of using Ferret Search with a SiSU repository?
Have you had any reports of building SiSU from tar on Mac OS 10.4?
24.12 Where is version 1?
24.13 What is the difference between version 1 and 2?

Installation

25. Installation

25.1 Debian
25.2 Other Unix / Linux
25.2.1 source tarball

26. SiSU Components, Dependencies and Notes

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

27. Quickstart - Getting Started Howto

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

28. SiSU Components, Dependencies and Notes

29. Breakage and Fixes

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

License, Standard

30. License

31. Things SiSU Standard

Download information

Download information

32. Download SiSU - Linux/Unix

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

Changelog - sisu

33. SiSU Version Manifest / changelog

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

Changelog - sisu-markup-samples

34. Version Manifest / changelog - SiSU Markup Samples

Current version
2.0
1.1
1.0

Method for providing digital documents including a common citation structure

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

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

35. 1. Background

36. 2. Definitions

37. 3. Brief Descriptions of the Drawings

38. 4. Detailed Description of the Preferred Embodiments

39. 5. Document Processing, examples of subsequent steps

40. 6. Advantages of the Invention

41. 7. THE CLAIMS

Post Filing Appendix

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

Endnotes

Endnotes

Metadata

SiSU Metadata, document information

Manifest

SiSU Manifest, alternative outputs etc.

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

Structured information, Serialized Units

Changelog - sisu

33. SiSU Version Manifest / changelog

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

sisu_manual, sisu_download, remove references to versions of sisu

v2: debian/control depends ruby (>=1.8.7)

dal_syntax and affected downstream output modules, revised pattern match for mail, (removes occasional interference with urls having embedded email addresses)

dal_syntax: (internal document) link matching, a fix

[Debian-live, live-manual (Jose Luis Zabalza, Ben Armstrong, reported bug in Spanish translation markup (that crashed the pdf generator). Bug in markup subsequently identified as "versátil,#{iso-hybrid}#, se" which the interpreter identified as an internal document link to a comma (instead of as being monospace markup), markup should have been "versátil, iso-hybrid, se" this fix prevents that incorrect match, (but the markup remains faulty and the monospace markup is not identified as such without the corrected spacing). Unfortunate "grave" results for what is a pretty insignificant data entry typo (there are no doubt other such situations).]

dal_substitutions_and_insertions: regex for sisu header matching (in sisu markup code blocks), a fix

dal_doc_str: fix, looks like typo in regex

param: tidy, remove redundant document header tags

manpage output presentation fixes

manpage: (lowercase .br; correct newlines before .nf and after .fi; no escape of hyphens; remove redundant links; endnotes array requires flatten; screen info on output path)

param: manpage header .br and no escape of hyphens

urls: correct output path for manpage

texpdf: url (regex) pattern match fix (/https?/)

help (markup): correct path to markup-samples

documentation more link fixes

syntax highlighting

emacs sisu headers updated (subheaders omitted for now) sisu-mode.el

vim cleaning sisu.vim

v3, target ruby1.9.2, ruby1.9.2p180 is ok note: there are issues with sisu and early versions of ruby1.9.2 ruby1.9.2p0 is known to segfault on a number of operations ruby1.9.2p180 does not have these issues

make sisu: v3 require >=ruby1.9.2 (v2 require >=ruby1.8.7) bin/sisu bin/sisu3 modified accordingly

use rb1.9.2 "require_relative" syntax

ruby 1.9 hash symbol syntax adopted

space between each and opening curly brace e.g. "x.each {|y| p y}"

use "encoding: utf-8" (instead of coding)

sysenv, processing_path method (separated from path) and resulting necessary changes

urls, param, two unrelated regex fixes, check

hub, minor rearranging

v2, v3: manpage, adjust output, fewer backslashes

v2, v3: defaults, clean homepage

v2, v3: consolidate manual & markup samples sisu markup source, manpages, man2html

clean up headers

update and correct links

tidy

small fixes

conf/skin remove less important skins and use syslink to share doc/skin_sisu.rb

sysenv, sisurc.yml and elsewhere as affected, output_dir_structure: by_language_code; by_filetype; by_filename

css, fix css paths for xhtml, xml dom & xml sax

console feedback on selected files being processed, updates & fixes

sysenv & sisurc.yml: libreoffice, default odf reader

NOTE: Processing defaults to v2, for v3 use 'sisu3' or 'sisu --v3'

Versions 3 is experimental and attempts to introduce output more compatible with mobile devices and other non-web use and more internationalisation possibilities.

NOTE: v3 branch opened, big patch, changes interim/incomplete (with possibility of breakage) primarily for: ebook-readers and other downloading viewers (alternative directory structures and use of title based filenames); internationalisation (use with po4a, export pot & po, alternative directory structures, use of git to ensure changes not lost).

In v3 SiSU markup files may be organised in language directories that are given their language code. There are alternative output directory structures depending on whether you want: the v2 layout (mostly in a directory of the given filename/a generic filetype name); a monolingual version 3 layout, which organises files by filetype/given file name; multilingual v3 layout, which organises files by language code/filetype/given.



3219

Scaling the Universe / Crossing the Void


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

  996 

[debian freeze, fix]

dal, fix missing multi-line regex matches for line-wrap text (live-manual, to work better with po4a)

dal_doc_str, bulleted text (and headings), multi-line match, to permit line-wrapped paragraphs (requested fix, Ben Armstrong (live-manual))

dal_syntax, multi-line match for fontface markup (emphasis, bold, italics, underscore etc.)

texpdf, use of monospace in headings causes table of contents breakage, fix (requested fix, Ben Armstrong (live-manual))

texpdf, toc now contains level 3~ to be consistent with other output formats (requested fix, Ben Armstrong (live-manual) "all TOC for different formats include headings for 1~ 2~ and 3~ *except* PDF which only has 1~ and 2~. i consider this a bug. how do i fix it?") (the fix is a workaround manually indenting level 3 further than level 2 as both levels make use of LaTeX "subsubsection")

html & css, ocn (object numbers) now link to themselves, clicking on one places that object at the top of the browser and provides its url (requested, Ben Armstrong (live-manual))

epub, ocn (object numbers) now link to themselves, clicking on one places that object at the top of the viewer

document manifest links

html, link to "document manifest" remains (links to individual output types removed)

plaintext, link to "document manifest" fix(links to individual output types removed)

odf, manifest link fix

html search form, configuration check

[debian freeze, fix]

i18n, introduce header @make: :language: internationalization using codes from ‹http://www.debian.org/international/l10n/po/› at this time for texpdf, (able to satify needs of polyglossia for the likes of Brazilian Portugues) and in future for po files, where iso:639 for this purpose appears to have use limitations ‹http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

param, extract @make: :language: information if provided, default "english"

i18n, add code list and associated language (as listed by polyglossia)

texpdf_format, use param (@make: :language: (default english)), to set tex document language header (previously used file naming convention)

sisu.vim recognize @make: :language: (also elsewhere shortened :lang_code: from :language_code:)

internal links

dal, exclude parentheses and square brackets from matching (requested fix, Ben Armstrong)

html, remove space between link & following punctuation, parentheses &/or square brackets (requested fix, Ben Armstrong)

epub, remove space between link & following punctuation, parentheses &/or square brackets

html

remove "copy @" mark (requested, Daniel Baumann)

segments, title banner (including "copy @" mark) configurable, boolean, true/false (default false) (requested off option, Daniel Baumann)

quick ref links_guide configurable, boolean, true/false (default false) (requested off option, Daniel Baumann)

config.yml

html, seg title banner, boolean true/false setting (commented out, default false)

html, quick_ref, boolean true/false setting (commented out, default false)

[debian freeze, fix]

numbered codeblocks, fix, where codeblock opens with code{# (requested fix needed by debian-live:live-manual, Ben Armstrong, Mark Schneider & Daniel Baumann)

dal changes as required, flag markup request and number

constants, provide vertical line symbol, use to separate numbered codeblock from code

texpdf substitute \vline for numbered codeblock line separator

texpdf, first space following a bullet should be fixed width, fix (used \enspace (0.5em)) (requested fix and suggested latex solution, Ben Armstrong)

texpdf, bullet text, hanging indent, fix works for regular text (not grouped text) (requested fix, Ben Armstrong)

texpdf, codeblocks do not permit empty lines, fix

documentation related minor updates and fixes

[debian freeze, fix]

texpdf, codeblocks, code-line continuation backslash dropped, fix (requested fix, Ben Armstrong)

shared_metadata, odf, url characters to not match

sisu_convert, basic conversion script (seldom used/tested) start to get it working again

CHANGELOG v2 recount where some requests came from

[debian freeze, fix]

odf:odt

odf, fix odt cornercase document breakage when matching and representing " " and "&" (prior to this fix, odt for viral_spiral is broken in sisu-markup-samples)

shared_metadata, fix cornercase odt document breakage when matching and representing " ", "&" and urls in metadata

param, metadata rights, keep colon separator from interfering with urls

[debian freeze, fix]

texpdf, scaling of images (below the set maximum size), fix (requested fix; behaviour testing & request by Mark Schneider)

odf:odt, incorporation and scaling of images, fix (requested fix; behaviour testing & request by Mark Schneider)

html (html_tune) scaling of images, fix (requested fix; behaviour testing & request by Mark Schneider)

epub (epub_tune) scaling of images, fix (requested fix; behaviour testing & request by Mark Schneider)

[debian freeze, fix]

dal_images, where image dimensions are set in an object, use those (requested fix, behaviour testing & request by Mark Schneider)

hub, fix sisu breakage when -y (manifest) is run without the explicit or implicit calling of -m (creation of document abstraction for processing), (e.g. when --source or --sisupod is called on its own).

options, a few aliases added (long options)

urls, cleaning

[debian freeze, fix]

hub, test whether user name set, fix (requested fix)

epub, fix breakage where angle brackets used in used metadata header

texpdf_format, remove a few commented out lines

[debian freeze, fix]

texinfo

texinfo_format, texinfo output broken, fix (Closes: #598063)

ocn decoration use a hash (instead of angle braces)

urls cleaned and with angle bracket decoration

texpdf

provide line-break-points for long directory names (requested fix)

a5, increase headheight (11pt from 8pt)

shared_metadata

odt, fix breakage where angle brackets used in metadata headers (requested fix, Daniel Baumann)

a typo fix

param, a few fixes (checks, aliases, typo)

manifest, typo fix

share_src, hub cleaning

Debian Squeeze equivalent 2.6.3-6 ported upstream

[2.6.3-2 (2010-07-29:29/4)] [debian dependency fixes (pre-freeze)]

debian/control, sisu-pdf, Depends on texlive-xetex added (Closes: #590766), replacing Recommends

debian/control, sisu-pdf, Depends on lmodern added (Closes: #590767)

[2.6.3-3 (2010-08-22:33/7)] [debian in freeze for squeeze, the only changes are documentation related]

minor cleaning of headers (& a fix in book index) in document markup sample free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst

update of some links free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst list.yml promo.yml

debian document markup samples, add copyright and license information

[2.6.3-4 (2010-08-31:35/2)] [debian freeze, code and documentation fixes]

html_format, xml_format, reduce visibility of sisu in output

yml metadata, add subheading for a title

html headers do not include the "title" field, fix (Closes: #594949) (param, variable not set (presumably since change from v1 to v2))

[2.6.3-5 (2010-09-13:37/1)] [debian freeze, code fixes]

epub, fix xhtml line-break in rights metadata, results in unreadable epub (Closes: #596736) epub output not readable by all epub-reader software (else epub output can be viewed in calibre, but not in fbreader or okular)

options, add expressive options --[name] as alternative to flags -[x]

[2.6.3-6 (2010-09-20:38/1)] [debian freeze, documentation, minor fixes]

html, v2 update (including --long-options) (manpage sync adds files)

manpage, v2 update (including --long-options)

sisu_commands.sst v2 update (including --long-options)

help, minor update, revisit (includes minor fixes)

identify markup, update ... revisit

urls, sysenv, set manpage viewer to "man"

options, bullet proof matches for --long-options (effects minor fix) fixes issue noted with --sample-search-form (-F) (in the selection of webrick (--webserv-webrick))

odf, footnotes, asterisk series (**) fix

html_format, epub_format: subtoc, footnote content bug (fix)

odf: lt (<), gt (>) fix for codeblocks; & fix, messy

epub_format, removed some title & author info, check

epub_tune,
(from
)

epub_format, within head, title & author

epub, toc copyat link removed

manifest, defaults, minimal sisu footer

hub, add metaverse run for git (composite files)

git, param, refine filename regex for composite files

git sisu directory structure, lang dir beneath txt

html, links to output formats, remove icons

minitoc sisurc configurable (true/false)

sisu_2.6.3-2 (2010-07-28:30/3)  1008 

debian/control, sisu-pdf, Depends on texlive-xetex added (Closes: #590766), replacing Recommends

debian/control, sisu-pdf, Depends on lmodern added (Closes: #590767)

sisu_2.6.3-3 (2010-08-22:33/7)  1009 

[debian in freeze for squeeze, the only changes are documentation related]

minor cleaning of headers (& a fix in book index) in document markup sample free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst

update of some links (free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst list.yml promo.yml)

debian document markup samples, add copyright and license information

sisu_2.6.3-4 (2010-08-31:35/2)  1010 

[debian freeze, code and documentation fixes]

html_format, xml_format, reduce visibility of sisu in output

yml metadata, add subheading for a title

html headers do not include the "title" field, fix (Closes: #594949) (param, variable not set (presumably since change from v1 to v2))

sisu_2.6.3-5 (2010-09-13:37/1)  1011 

[debian freeze, code fixes]

epub, fix xhtml line-break in rights metadata, results in unreadable epub (Closes: #596736) epub output not readable by all epub-reader software (else epub output can be viewed in calibre, but not in fbreader or okular)

options, add expressive options --[name] as alternative to flags -[x]

sisu_2.6.3-6 (2010-09-20:38/1)  1012 

[debian freeze, documentation, minor fixes]

html, v2 update (including --long-options) (manpage sync adds files)

manpage, v2 update (including --long-options)

sisu_commands.sst v2 update (including --long-options)

help, minor update, revisit (includes minor fixes)

identify markup, update ... revisit

urls, sysenv, set manpage viewer to "man"

options, bullet proof matches for --long-options (effects minor fix) fixes issue noted with --sample-search-form (-F) (in the selection of webrick (--webserv-webrick))

param, header reading more robust (re: commented out parts)

vim syntax, in bulleted and indented text recognize bold

param, rights (all) add line breaks between copyright, license and other rights

texpdf, if no "copy @" info remove; rename left footer; asterisk issue

sisu-harvest, alias for sisu --harvest (with man page)

texpdf, codeblocks, left margin flush

html_segments, line space between end of text and section bottom navigation bar

markup samples moved to data/doc/sisu/v2/markup-samples

dal, manifest & metadata headings, non-substantive, ocn removed

dal_syntax, monospace (avoid url match false positive)

texpdf, monospace fix

html_scroll, index & endnotes

sysenv, default output path, fix

sysenv, version.yml moved to /usr/share/sisu/v2/v (from /etc/sisu)

provide alternative sisu command names for producing single output types: sisu-pdf, sisu-html, sisu-odf, sisu-epub, sisu-txt, sisu-pg, sisu-sqlite

monospace (requested feature, Daniel Baumann)

dal_syntax, constants, introduce monospace tag

monospace font for codeblocks and monospace tag

vim syntax, recognize monospace tag

hub, make -t produce plaintext output

sysenv, make output directory if needed (if possible)

texpdf_format, output special characters, special circumstance fix

outputs, some cleaning of default outputs ... ongoing

manpages, some additional manpages and some updates

texpdf, ensure programs default font is set (Liberation Sans) if none configured, (was intended, required fix)

texpdf, font selection permitted in sisurc.yml (default: texpdf_font:) or document header (@make: :texpdf_font:)

NOTE: this is a small addition, but texpdf requires that Liberation fonts be installed as 'Liberation Sans' is now the default, and thus can cause breakage unless this is installed, hence the version bump. This is taken care of in the debian package by depending on ttf-liberation

vim syntax (sisu.vim) updated to match @make: :texpdf_font:

param, fix breakage on malformed sisu identifier (top header line)

tables: blank lines (use tilde to indicate); allow line breaks

css for html, make right pane when used darker to distinguish from selected content

vim/ftplugin/sisu.vim make less intrusive (both for sisu v2 & v1), includes the following:

<leader>ls - dir files placed in vertically split window (also dir)

<leader>rd - search and replace down (in file)

<leader>rg - search and replace globally (in file)

<leader>rr - search and replace using ruby gsub (global search and replace)

Note: <leader>rf not used, ambiguous (replace forward or replace in file?)

remove language and spelling american english, can't have a fixed default

remove <CTRL>G - (search and replace) binding

remove <CTRL>F - for fold file removed, use still available :F instead as before includes:

statusline

change to the directory the file in your current buffer is in

wrap at textwrap width

cursor jumps a line at a time within wrapped text

^J paragraph formatting break line on 'textwidth'

:F folds on fold patterns for sisu markup (and foldsearch which opens result of search all else closed)

texpdf, polyglossia (xelatex) (start using, instead of babel)

documentation, text, much todo

remote file processing (url instead of local file), minor fix (related to reporting "http" file not found)

regex match, a number of http: matches needed to be extended to include https:

epub & odf, regex matching of http: should also match https:

texpdf, https: url match with tilde, fix

general extension of regex matches for http: to include https:

dal_syntax fix, no auto-bold or italics on relative or internal links

sisu markup syntax added to, related to internal document links and relative links, see note on additions to vim syntax highlighting (version bump)

dal, added internal document link to tagged point, affecting downstream processing

output formats internal document (and relative) linking as possible

vim syntax highlighting, added tag for internal document link to tagged point { Linked text }#tagname also relative link { linked }:document_name/file.html#23 which is the preferred equivalent of { linked }../document_name/file.html#23

sisu markup, documentation on_sisu_markup/sisu_markup.txt added much todo

dal_syntax, url match fix

dal_doc_str, name tags fix

html, epub, latex/pdf add name tag points

vim templates for .sst .ssm & .ssi

dal_syntax, italics match fix

urls, screen output control

sysenv, switch default hash digest fingerprints to sha256 (rather than md5)

texpdf, special word and number optional break points, (also, reduce text display size of digests, reduce image size, add some url braces)

sysenv, sisurc.yml, default shortform command flags, removal of verbose flag from default, add -v when needed, e.g. sisu -3v filename.sst

screen output (ansi), control

dal, markup, In cases where the line is interpreted as level 1~ (either by explicit 1~ tag or @make: :heading:) a hash (#) [octothorpe] will be auto-incremented, markup e.g. "1~ Chapter #: My Way".

markup for *{emphasis}* configurable as being displayed as bold, italics or underscore, the default is that emphasis output is in bold so there is no change unless configured, either in sisurc.yml (default: emphasis: 'bold'), or the markup source document header @make: :emphasis: 'bold' [requested]

plaintext, wrap width configurable between 20 to 200 characters, the default width being 78, configuration either in sisurc.yml (default: text_wrap: 78), or the markup source document header (@make: :plaintext_wrap: 78)

param_identify_markup, identify version 2 markup

manifest, info, expand on description of book indexes when available

screen output, reduce verbosity unless -v or other such option used

dal_numbering, number headings, a fix

param, for topic_register, an additional check required, bug fix, repost

db (sql) add oclc (Online Computer Library Center) number, affects table structure, (hence breakage & version bump)

new db name prefix "sisu_v2c_"; new pgsql db name prefix "SiSUv2c_"

metadata, classify add oclc (Online Computer Library Center) number

small fixes

constants for pgsql VARCHAR reduce max size to 2500 (from 3000), to be within default limit set for postgresql (debian)

default sisu home, correct link to document examples and description

sisu_download.ssi link to breakage info not of current interest

defaults, on default home, for search form always point to latest db

html metadata, show topic_register again

plaintext, bulleted grouped text, clean up output (still not line-wrapped though)

git, start to experiment with file structure to replace sisupod -g and will be in configure options, to track changes to document, enable creation of "pods" (zipped content) and allow for remote versioned (or unversioned) placement of content source; ideally would end up with two co-existing, distinct parsable structures whether local or remote, the existing directory structure with multiple documents and document images etc. and git directories with all content associated with a single document (including other language versions of it); cannot guarantee at this stage that the file structure will be retained, which may mean recreating any directory started and defeat the purpose of using it, though it is in a version control repo, so perhaps not ... best left alone for now ... nothing here yet really, move along

switch markup for emphasis and bold, now: *{emphasis}* and !{bold}! which is consistent with !_ declaring a line to be bold, the default is that emphasis output is in bold so there is no change at present, at some time in the future it is intended that it be possible to configure emphais aoutput alternatively to be in italics [requested]

db (sql) table structure, further review and changes (hence breakage & version bump)

new pgsql db name prefix "sisu_v2b_"

increase use of VARCHAR

new indexes

multiple fixes

db_sqltxt, sql issue at times with missing author field, fix

db_select, check for whether db exists, note this does not check whether tables have been created though

db_import sqlite, prevent multiple import of file with same filename(.sst) (cgi form should work correctly, without multiple entries)

db_indexes, db_drop fixes

cgi_sql_common, better presentation for next page where more matches than limit per page

shared_metadata, fixed wrong reference to md.gutenberg instead of md.pg, prevents building of latex/pdf in affected cases

param, extensive db column size checks for metadata

param, where rights.copyright missing, nag profusely but do not break, fix

shared_html_lite, markup heading objects

db (sql) database table name and column structure changes, new pgsql db name prefix "sisu_v2a_" (hence breakage & version bump), continue to review (db_columns, db_create, db_import, db_sqltxt)

db remove and update fix, match filename for removal with = (not LIKE or ~)

db sqlite, issue with --recreate, bugfix (db_drop)

db, shared_html_lite, link back to footnote/endnote reference

db, sysenv, sisurc.yml determine whether to share sisu markup source in db

param, check set db column sizes against metadata, drop entries that are too long with warning

param, classify "populated" a fix

cgi sample search form (cgi_sql_common)

update to work with database structure changes

add radio buttons to set increased match limit

vim syntax highlighting, minor

bug fixes

harvest, fixes bug in harvest_topics (v2)

manifest, search form for db fixed

sql, postgresql search form, next page, previous page

db_create, comments causing issues for sqlite

sql, search form, clearer information when results exceed match limit set

harvest, add search form for directory, if configured in sisurc.yml

bug fixes

correct method call for md.title.full a number of places [in db_import, results in failure of doc import when called]

free_as_in_freedom, additional links to available material

bug fixes

odf, xml, texpdf, bulleted group, clean

odf, metadata line break - prevent from breaking document [potential odf breakage]

xml_dom, behaviours fixes

bug fixes

param, recommended links (reinstated)

db_import, special character escape special endnote content [doc import

fails on occurrence]

vim syntax highlighter, sisu v2 & v1 version and date headers updated/corrected

bug fixes

html, tables fix

sysenv, html_promo, db name prefix from constants (now SiSUv2_)

texpdf_format, where image missing, escape image markup loop

epub, html: make robust where missing param values

vim syntax minor update in v2

docs, add epub, more to be done

sisu v2

default command 'sisu' runs version 2; to run version 1 use version flag 'sisu --v1 [filename]'

new middle layer (document abstraction) that uses ruby objects to represent data (instead of strings)

downstream libraries updated to use v2 middle layer

sisu markup, changes to headers (metadata), input otherwise unchanged

output much the same as for version 1 with some tweaks: * search, sql table structure changed for version 2, incompatible; * internal linking of documents is once again supported; * LaTeX/pdf book indexes link within the pdf text rather than to HTML version of document

EPUB output introduced using -e flag

sisu v1

this tarball also includes v1 see CHANGELOG_v1, if installed directly from tarball version 1 should be available as sisu1

version 1 should be available as sisu --v1 [filename]

plaintext, footnote / endnote fix, footnotes to occur immediately after paragraph that contains them (unless endnotes are selected instead)

document sample skins, utf-8 specified (in some cases needed by ruby 1.9.1)

Free as in Freedom (on RMS), Sam Williams, markup sample, markup variation, affects numbering

odf:odt odt.zip fix addressing issue with presentation of headings in produced open document text

markup samples directory structure, minor adjustments, (and no longer shared by package sisu_markup_samples, about which, see that package)

open v1 branch, bump series vesion number to 1

with the introduction of sisu version 2 (a new middle layer engine) imminent, that will be maintained in parallel with this version, it is time to have a version 1 branch

version 1 is pretty much the previous release, it will be maintained alongside version 2 (in the tarball) and the directory structure is modified to accommodate this

[version 2: will have a different middle layer; markup remains the same apart from some modification to document headers]

param / document header changed not to accept older markup, e.g. must use '@title:' rather than '0~title'

minor changes inter alia for new directory structure

documentation, modified description of command flags -m and -n (in line with communication on Debian bug #555496, closing it)

sql, fix, different solutions for postgresql and sqlite to populate database using ruby-dbi

fix to use imagemagick directly (when imagemagick is available and rmagick declares versions not in sync)

fixes

html book index, batch processing fix, re-initialize variable after use

sysenv, sha256 use fix, need to set variable with pwd

dal images, if no rmagick, system call imagemagick directly if available

manifest, include book index if available

html scroll css, left margin

html seg, navigation band buttons placement

prepare for version 1, (and make way for version 2)

move lib to v1 from v0 lib/sisu/v1

change to version1.yml from version.yml (conf/sisu/version1.yml)

make necessary program changes

[note on version 2 to come, input unchanged, output much the same, middle-layer (document abstraction) changed, uses ruby objects instead of strings to represent data]

sysenv, make sisu and ruby version info ruby instance methods

minor housekeeping:

texpdf mostly minor cleaning

html various minor:

use suffix provided in constants;

module SiSU_HTML_Tune;

possibility of use of adsense

dal_numbering, minor regex reduction

dal_idx, book_idx_html, match sysenv

xml related minor touches

* db dbi, interfaces to sqlite and pgsql, fixes

* cgi sample search form, fix

* minor touches

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]

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

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

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

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

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

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

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]

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.

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)  1078 

debian/changelog (take more care with git reset)

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

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,  1083  (-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)

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

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)  1087 

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

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

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

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

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)]

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

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

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])

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)

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

(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))

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]]

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)   1130  [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)  1131 

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)  1136  Debian Etch related fixes   1137 

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)  1138  Debian release snapshot   1139 

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)  1140  Debian release snapshot   1141 

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)  1142  Debian release snapshot   1143 

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

rollover year 2006 to 2007

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

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)  1149  Debian release snapshot   1150 

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)  1151  Debian release snapshot   1152 

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)  1153  Debian release snapshot   1154 

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)   1168 

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

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)

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)   1172  Debian release snapshot   1173  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).   1174 

[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)).   1175 

[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)   1176 

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

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  1200 

see 0.44.0

debian/rules compression mentioned twice, one removed

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

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  1203 

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  1204 

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)  1205 

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

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  1208 

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]

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)  1210 

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

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

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  1217 

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  1218 

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)  1219 

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]  1220 

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)

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  1229 

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]   1232 

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]  1238 

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]  1239 

[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]

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.

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  1248 

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)

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,  1253  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  1254  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

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]  1271 

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

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)   1306  Debian release snapshot, unified (SiSU/Debian) build  1307 

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]

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]

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

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

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]

-v -M etc. (cosmetic) url, output path information imp