|
|
|
|
|
|
|
sisu_3.0.4.orig.tar.gz (2011-03-11:10/5) 991 ‹http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.4-1›
sisu_manual, sisu_download, remove references to versions of sisu
v2: debian/control depends ruby (>=1.8.7)
sisu_3.0.3.orig.tar.gz (2011-03-11:10/5) 992 ‹http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.3-1›
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
sisu_3.0.2.orig.tar.gz (2011-03-05:09/6) 993 ‹http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.2-1›
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
sisu_3.0.1.orig.tar.gz (2011-02-16:07/3) 994 ‹http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.1-1›
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
sisu_3.0.0.orig.tar.gz (2011-02-07:06/1) 995 ‹http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.0-1›
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.
Scaling the Universe / Crossing the Void
[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
sisu_2.6.0.orig.tar.gz (2010-07-07:27/3) 1015 280288 su_2.6.0.orig.tar.gz 1016
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
<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
git clone http://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
sisu_0.48.8.orig.tar.gz (of 2006w48/1 - 20061127) 1132 Debian release snapshot 1133
metaverse, "visual" adjustment to allow inclusion of column width information
debian, dfsg document samples debian constitution v1.3 added [english, german, danish]
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
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
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-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)
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
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
xml and xhtml adjustment of regex match of urls for xlink
sisu_0.48.7.orig.tar.gz (of 2006w46/7 - 20061119) 1155 Debian release snapshot 1156
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
sisu_0.48.6.orig.tar.gz (of 2006w45/6 - 20061111) 1157 Debian release snapshot 1158
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
sisu_0.48.5.orig.tar.gz (of 2006w45/4 - 20061109) 1159 Debian release snapshot 1160
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
sisu_0.48.4.orig.tar.gz (of 2006w45/1 - 20061106) 1161 Debian release snapshot 1162
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...
sisu_0.48.3.orig.tar.gz (of 2006w44/2 - 20061031) 1163 Debian release snapshot 1164
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]
sisu_0.48.1.orig.tar.gz (of 2006w43/7 - 20061029) 1166 Debian release snapshot 1167
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
sisu_0.47.6.orig.tar.gz (of 2006w40/6 - 20061007) 1177 Debian release snapshot 1178
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]
sisu_0.47.5.orig.tar.gz (of 2006w39/7 - 20061001) 1179 Debian release snapshot 1180
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)
sisu_0.47.3.orig.tar.gz (of 2006w38/6 - 20060923) 1182 Debian release snapshot 1183
minor code review [takes care of RAM issue experienced with some forms of batch processing]
sisu_0.47.2.orig.tar.gz (of 2006w38/5 - 20060922) 1184 Debian release snapshot 1185
metaverse, a line of code needed changing for ruby-1.8.5
sisu_0.47.1.orig.tar.gz (of 2006w38/1 - 20060918) 1186 Debian release snapshot 1187
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
sisu_0.47.0.orig.tar.gz (of 2006w37/7 - 20060917) 1188 Debian release snapshot 1189
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
sisu_0.46.5.orig.tar.gz (of 2006w36/3 - 20060906) 1190 Debian release snapshot 1191
documentation adjustments
defaults html text/ accompanying blurb removed some Ruby / Debian / Linux / Unix text
sisu_0.46.3.orig.tar.gz (of 2006w36/1 - 20060904) 1193 Debian release snapshot 1194
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.
sisu_0.46.1.orig.tar.gz (of 2006w33/3 - 20060816) 1196 Debian release snapshot 1197
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
sisu_0.46.0.orig.tar.gz (of 2006w32/6 - 20060812) 1198 Debian release snapshot 1199
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
sisu_0.43.0.orig.tar.gz (of 2006w29/6 - 20060722) 1206 Debian release snapshot 1207
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]
sisu_0.42.3.orig.tar.gz (of 2006w28/2 - 20060711) 1213 Debian release snapshot 1214
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
sisu_0.42.2.orig.tar.gz (of 2006w27/6 - 20060708) 1215 Debian release snapshot 1216
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
sisu_0.42.1.orig.tar.gz (of 2006w27/4 - 20060706) 1221 Debian release snapshot 1222
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)
sisu_0.41.8.orig.tar.gz (of 2006w25/6 - 20060624) 1224 Debian release snapshot 1225
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_0.41.6.orig.tar.gz (of 2006w25/2 - 20060620) 1227 Debian release snapshot (queue new) 1228
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]
sisu_0.41.2.orig.tar.gz (of 2006w23/5 - 20060609) 1234 Debian release snapshot 1235
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)
sisu_0.38.10.orig.tar.gz (of 2006w18/4 - 20060504) 1250 Debian release snapshot 1251
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.
sisu -3 ‹http://www.jus.uio.no/sisu/sphinx_or_robot.leena_krohn.1996/sphinx_or_robot.leena_krohn.1996.sst›
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]
sisu_0.38.4.orig.tar.gz (of 2006w16/5 - 20060421) 1259 Debian release snapshot 1260
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
sisu_0.38.3.orig.tar.gz (of 2006w16/4 - 20060420) 1261 Debian release snapshot 1262
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_0.37.6.orig.tar.gz (of 2006w12/4 - 20060323) 1273 Debian release snapshot 1274
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]
sisu_0.37.4.orig.tar.gz (of 2006w10/4 - 20060309) 1276 Debian release snapshot 1277
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
sisu_0.37.2.orig.tar.gz (of 2006w10/2 - 20060307) 1279 Debian release snapshot 1280
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
sisu_0.36.18.orig.tar.gz (of 2006w08/1 - 20060220) 1290 Debian release snapshot 1291
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
sisu_0.36.12.orig.tar.gz (of 2006w06/4 - 20060209) 1297 Debian release snapshot 1298
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
sisu_0.36.9.orig.tar.gz (of 2006w06/2 - 20060207) 1301 Debian release snapshot 1302
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