|
|
|
|
|
|
|
SiSU - SiSU information Structuring Universe
Structured information, Serialized Units
Ralph Amissah
copy @ SiSU
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]
Scaling the Universe / Crossing the Void
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
# 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) 1024
debian/changelog (take more care with git reset)
sisu_0.62.3-3 (2007-11-30:48/5) 1025
debian/control XS-Dm-Upload-Allowed: yes [dpkg does not yet recognize Dm-Upload-Allowed field unless prefixed by XS-]
db rearranging basic things todo (create, drop, update)
generate from remote markup source, image path fix, e.g.
vim
ftplugin, status line info update
colors slate, name fix [requested thanks]
debian/control Homepage: header (for the time being lintian override necessary)
[uploaded to Debian November 4th recorded at the time, Reis down, upload apparently lost, re-uploaded to Debian November 14th ]
db common and cgi, regex to match new composite file filename (.ssm.sst)
[NOTE/WARNING: some directories moved, for existing sites will need manual adjustment of output locations, (moving of a couple of image directories, and if sharing text source the creation of shared source directories src and pod), see notes below (on directory shunting)]
directory shunting ... [some resulting re-setting/configuration up necessary]
markup source and source pod directory (src and pod), all shared markup source placed in common directories src for text source, and pod for binary (instead of being in output files generated sub-directory) [NOTE: New src and new pod directory for shared markup source output required at [output path]/src and [output path]/pod ] [if nothing else makes repo of online submissions easier]
images, output images used by html moved, now in image directory instead of image_local; system images moved from image to image_sys (to make sure they are always available, i.e. not written over (by subsequent images given same name)) [NOTE: Image directories moved and may need to be tended to manually as existing directories are not overwritten, [output path]/_sisu/image_local is moved to [output path]/_sisu/image (and old _sisu/image is now _sisu/image_sys) ]
pwd directory stub name exception, regexs in sysenv and elsewhere, when determining the pwd stub, take stub from parent of a directory named src (todo with directory shunting, and placing of output source markup files where shared in a directory named src)
remote, (put, get) placed in single file (consider separating later)
conf, remote, work on rsync building of basic remote site structure
embedded content, included binaries such as images, audio, video, copy content associated with document to desired output locations, [decide how audio, video/multimedia are to be handled, initially just links to content]
image conditions and regex for matching and extracting list of images used by a document visited
copy images associated with document along with document, does not take care of skins though, for all images still need to use -CC
sysenv remote placement, and config, able to define multiple hosts for rsync or scp placement of output, for this sisurc.yml remote info given provided as array with '-' separator [old form of notation is also honoured]
special character exceptions, exception, fix (:code underscore angle bracket issue)
pruning
conditionals rearranged, (scope for breakage)
fictionbook, 1029 (-f) first pass at output, look into further and develop or drop? fictionbook is interesting.
debian/control added depends on rsync, used extensively (now also internally)
NOTE: fixed today in Debian Sid, bug with String.strip in ruby 1.9.0 (2007-09-10 patchlevel 0) [i486-linux]? [behaviour noted in 2007-09-18:38/2, existed till 2007-10-18:42/5]:
' apples, oranges'.strip #==> "apples," # expected "apples, oranges"
' apples, oranges '.strip #does as expected
ruby 1.9, for present time retain restriction on running and testing sisu with ruby 1.9, there are still issues with 1.9 (at the C stack level, and probably some in sisu compatibility/updating as well)
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) 1033
debian/control
remove reference to sisu-doc, (sub-package created in 0.59 and removed again in 0.60)
sisu-pdf sub-package (now) suggests alternative pdf viewers
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) 1076 [the 0.48.8 branch version -6 is more current]
source tarball incorporates fixes added after Etch freeze in deb 0.48.8-2
LaTeX, bugfix - restores missing left column object/paragraph numbers (missing curly (close) brace) [important, though marked as normal] [bug introduced somewhere between 0.47 and 0.48] (closes: #403037)
LaTeX use mathptmx.sty instead of "obsolete" times.sty (as suggested by Frank Küster in Bug#402807)
cgi-sample form, an arbitrary limit set for sql query results (1000 better than none) (closes: 403042)
defaults, update sisu default homepage to current, (mainly urls)
css addition to correspond with change to homepage
debian control, adds mention of editors other than vim for which there is some kind of syntax support, kate, kwrite, gedit, diakonos
texpdf, usepackage url
doc/sisu/html keep copy of homepage
debian control, sisu-pdf depends for tetex | texlive, take on board suggestion by Frank Küster (see #402807)
[NOTE rebuild of the 0.48.9 of (2006w52/1 | 20061225) to merge branch in version control, chronological break in sequence, this build is substantially the same as 0.48.8-2, subsequent versions of 48.8 are more recent, the latest being 0.48.8-6]
Originally released as:
sisu_0.48.9-1 (2006w52/1 | 20061225) 1077
sisu_0.48.8.orig.tar.gz (of 2006w48/1 - 20061127) 1078 Debian release snapshot 1079
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 1092 (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) 1101 Debian release snapshot 1102
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) 1103 Debian release snapshot 1104
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) 1105 Debian release snapshot 1106
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) 1107 Debian release snapshot 1108
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) 1109 Debian release snapshot 1110
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) 1112 Debian release snapshot 1113
metaverse, indicate image missing if a requested image is not found
processing directories default location moved to be placed under home or /tmp from pwd
(-1) debian/control, recommends hyperestraier removed as appears to cause issues (also rename and pgaccess) 1114
(-2) debian/control recommends hyperestraier (sisu and sisu-complete) put back 1115
sisupod, creation of (zipped sisu content files, primarily a way of bundling sisu content assocated with a prepared sisu file or set of files, that sisu commands can be run directly against) creation:
sisu -S [filename]
places a file named sisupod.zip in the output directory for directory
sisu -S
creates a sisupod of the pwd named: sisupod-[pwd.stub]_[date].ssp, e.g. sisupod-sisu_2006-10-26.ssp (uses system call to unix commands find and egrep)
sisupod, sisu can be run directly against a sisupod without manual unpacking, e.g.:
sisu -3 sisupod.zip
[early implementation, a system call used], run against the following filename/types: sisupod, sisupod.zip, [filename].ssp
security:
sisu does not ever use a sisurc.yaml within a sisupod
sisu will only use a skin within sisupod if --trust(ed) modifier is added to the command line
skins, note: copy dir skin to skin_sisupod.rb [doc skin keeps name as called with name within document]
remote operations possible on sisupod, e.g.
sysenv, sisu processing directory '_sisu_processing' default placement now first within pwd (markup text directory) if that is not writable under home ~ and if not available to /tmp (the preference of home over /tmp my be reconsidered, thinking is to default towards keeping processing related info within private space)
manifest, uses documents home button/icon, if available (rather than sisu default)
sisupod alternative names sisupod, siuspod.zip [filename].ssp
urls, tune, removed link to html 'tune' output file, no longer generated
sysenv, url path reporting fix, (broken by renaming in 0.47.7)
processing directories default location moved to be placed under home or /tmp from pwd, likewise sisupod creation directory moved [processing directory]/sisupod from ./_sisu/sisu_doc
extra testing, numerous small fixes, (several related to method renaming in sisu-0.47.7, also checks against both ruby 1.8.5 and current 1.9, $KCONV set to UTF-8 rather than rely on environment and many more also as above)
metaverse, minor fix related to link created for shared source file with regard to new syntax shortcut markup for listing multiple available output types produced by SiSU (introduced in 0.47.6)
sisu_0.47.7.orig.tar.gz (of 2006w41/6 - 20061014) 1118 Debian release snapshot 1119 freeze until is in testing.
sysenv, minor code play, some method re-naming, organisational (however affects rest of code, much testing, (smallish possibility of breakage remains))
gif, reinstate support, however use not yet recommended (gif no longer under patent, however, gif is not available for all pdf, does not yet appear to be available in tetex) [image support: png, jpg, (gif)]
[debian/control] sisu-pdf set to work/install with either tetex and texlive (tetex | texlive depends). 1120
[debian/control] sisu-pdf depends set just for tetex; sisu for LaTeX to pdf, currently also works fine with the texlive meta-package installed (in the texlive meta-package's present form, without the need to install an additional package (such as sisu-pdf)). 1121
[debian/control] sisu-pdf set to work with texlive (tetex|texlive depends) (sisu works out of the box with texlive installed, currently an issue with the default font in texlive) 1122
sisu_0.47.6.orig.tar.gz (of 2006w40/6 - 20061007) 1123 Debian release snapshot 1124
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) 1125 Debian release snapshot 1126
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) 1128 Debian release snapshot 1129
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) 1130 Debian release snapshot 1131
metaverse, a line of code needed changing for ruby-1.8.5
sisu_0.47.1.orig.tar.gz (of 2006w38/1 - 20060918) 1132 Debian release snapshot 1133
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) 1134 Debian release snapshot 1135
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) 1136 Debian release snapshot 1137
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) 1139 Debian release snapshot 1140
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) 1142 Debian release snapshot 1143
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) 1144 Debian release snapshot 1145
0.44 branch reinstated (leapfrogging over 0.45 which was a reversion to 0.43)
metaverse changes for consistency, affects all downstream code (with attendant risk), numerous related changes; preliminary tests passed 1146
see 0.44.0
debian/rules compression mentioned twice, one removed
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 1149
db operations broken up into smaller code files
numerous other little things
* Note: shared sisu libraries, practice is likely to become that these contain pointers to libraries, rather than the libraries themselves, e.g. shared_db
odf/odt added generic odf tiny icon. html, added icon and link to opendocument text (assumes output is always present, as do the pdf equivalents)
markup, experimenting with simple xml models, three xml representations of sisu markup, sxs, sxd, sxn. Export with:
sisu --to=sxs [filename]
[experimental, these will change]. Import, not done
--to made a synonym for --convert
debian/rules simplified 1150
debian/control sisu-pdf Depends: changed to make TeX Live optional, actually part of it is now required as tetex along with tetex-extra do not contain all the LaTeX packages SiSU requires (in particular manyfoot.sty is missing) 1151
debian/lintian/sisu added lintian override for man page and non-executables
sisu_0.43.0.orig.tar.gz (of 2006w29/6 - 20060722) 1152 Debian release snapshot 1153
footnotes, introduction of new editor (square bracket) series, using asterisk and plus signs ~[ asterisk editor note ]~ or ~[* asterisk ed. note ]~ and ~[+ dagger ed. note ]~ outputs updated: plaintext, latex, html, xml, odf, dcc, database the sample search form does not yet search the new (asterisk and plus) endnote series [easy to add additional symbols later, also consider it should be fairly straightforward to add possibility to use of name of note maker with numbered note sequences for each contributor; you may wish to think of sorting into different types for some of these like plaintext, later]
database, breaks existing database model by introducing new tables, to accommodate the new endnote series, (square bracket series). (there are alternative ways to add the information, e.g. add column with information on the endnote symbol involved; have in fact added a table for each of the symbols used)
additional footnote annotations (asterisk, dagger) can be dropped from output with command modifiers --no-asterisk, --no-dagger, --no-annotate
--convert=footnotes (convert to embedded footnote markup, do not make changes if footnote mismatch) --convert=footnotes-force (make changes even if there is a footnote mismatch) provide warning about changes what todo, make backup? or create new file, what filename to use?
--no-ocn switches off object citation numbering. Produce output without identifying numbers in margins of html or LaTeX/pdf output. [with -h -H or -p]
vim syntax highlighter recognises footnote/annotation additions
debian vim/addons/syntax/sisu.vim add the new syntax file 1154
man page and help.rb updated on editor footnotes, square bracket series
relaxng object models, look at, included in data/doc/sisu/models/relaxng (some models quite old, and undeveloped, originally in sisu library relaxng.rb)
metaverse, and elsewhere, utf-8 is assumed: started cleaning out legacy code (character converting regex) sisu generates its first Chinese document in html, plaintext and sql databases (postgresql and sqlite) only, at this stage... [confirmation that first Chinese document presentation is fine, from author of test (law related) text; the listed text representations reasonably handle the utf-8 characters involved, and document structure is ok]
sisu_manifest, pdf description express portrait copy to be optimised/biased towards print, and landscape to have screen view bias/optimisation (orientation and colored links)
debian (mostly), meta-packages man pages moved to man(7) 1156
debian, closed bug 377208 after informing submitter changes had been made and requesting review ('fixed' in 0.42.2) 1157
debian/control added a Conflicts: vim-sisu, sisu-remote, to the existing Replaces: these two packages have been removed 1158
ruby, also tested ok with ruby1.9 (Debian Version: 1.9.0+20060609-1) sisu -3v [filename] [database tests omitted, relevant ruby drivers not on system]
sisu_0.42.3.orig.tar.gz (of 2006w28/2 - 20060711) 1159 Debian release snapshot 1160
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) 1161 Debian release snapshot 1162
html, xhtml, added utf-8 specification [(previously relied on correct browser setting]
debian/control, removed sisu-remote, added recommends rsync, openssh-client|lsh-client, keychain, to main sisu package instead 1163
debian/control, removed vim-sisu, this used to contain syntax highligter and color scheme now included in Vim 7, all that remains is ftplugin, now installed by main sisu package 1164
debian/control, sisu Replaces: vim-sisu debian/sisu.install installs ftplugin originally in vim-sisu
debian/manpages, sisu (main package) now installs vim_sisu page in man(7) 1165
debian/control, package description related issues:
modified sisu
modified sisu-complete
modified sisu-postgresql
modified sisu-sqlite
modified sisu-pdf
removed sisu-remote, (as sisu-remote is no more)
removed vim-sisu, (as vim-sisu is no more)
removed sisu-remote, (as sisu-remote is no more) [consider adding a note on remote placement of documents in sisu(8) later] 1166
sisu_0.42.1.orig.tar.gz (of 2006w27/4 - 20060706) 1167 Debian release snapshot 1168
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) 1170 Debian release snapshot 1171
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) 1173 Debian release snapshot (queue new) 1174
sisu_manifest, added possibility of sharing of kdissert source 1175
kdissert fixes to make the following true:
"sisu --convert=kdi [kdissert filename]" will attempt to convert a simple file produced using kdissert to sisu markup, basic and experimental
kdissert_to_sisu: some fixes, still very basic and experimental [data/sisu/conf/convert or /usr/share/sisu/conf/convert]
[issue spotted with rsync, new output directories, fix later]
"sisu --convert=kdi [kdissert filename]" will attempt to convert a simple file produced using kdissert to sisu markup, basic and experimental
kdissert_to_sisu: some fixes, still very basic and experimental [data/sisu/conf/convert or /usr/share/sisu/conf/convert]
param, minor fix to "prefix" metadata regex
renamed a couple of libraries related to file conversion
kdissert_to_sisu: a very basic trial conversion script from kdissert .kdi to sisu .sst markup provided [preliminary/proof of concept, provided in data/sisu/conf/convert or /usr/share/sisu/conf/convert] 1178
options parsing changes, possibility of letter duplication removed [-CC no longer will work use -C --init=site]
texpdf_format, old code rearranged
sysenv, fixes in File_map where @md (param) not available
info related to share source file and sisudoc, bug fix
[subsequent debian build primariy to prevent compression of sample files]
sisu_0.41.2.orig.tar.gz (of 2006w23/5 - 20060609) 1180 Debian release snapshot 1181
search form, options passing, sisu -F --webserv=webrick
html segments endnote fix for the deposit of endnotes occurring in levels :A - :C
texpdf, a4 text height re-fixed
digest, document metadata, info re-fix
plaintext, small fix, document metadata
defaults, html_format, some html cleaning (including fix of html comment marker that was problem for dillo in doc.html)
html segments endnotes, fix for first segment, (endnotes were deposited in first segment multiple times (or rather this happened in some segments following a level :A - :C heading ))
markup_convert, hub, changes, should now be possible to convert and generate in a single changed rune, e.g.
sisu --convert=to38 -h autonomy_markup0.sst gpl2.fsf.sst
options, (command line options) message passing (should become cleaner), program piping changed, command line information added as 'opt', (subsequently contained within param 'md'), creates considerable scope for further tidying (cosmetic refactoring) [most code affected, preliminary tests passed, (some possibility of bugs and breakage)]
hub, param, hooks in place to permit modification of default processing instructions set in config files or within document headers by way of command line processing instruction starting with -- (however, only implemented for latex/pdf paper size).
hub command line now accepts individual command instructions, previously was necessary to write, e.g.
sisu -mNhwpoabxXyv [filename/wildcard] 1184
now may alternatively write:
sisu -m -N -h -w -p -o -a -b -x -X -y -v [filename/wildcard]
dbi command line rune now requires "--" before instruction, --import, --update, --recreate, etc. removed short forms for --import and --update (-i and -u)
texp pdf, adjustments to document presentation dimensions (A4, US_letter, book_b5, book_a5, US_legal)
texpdf, command line parameter may be used to change paper size output (preset sizes include: 'A4', U.S. 'letter' and 'legal' and 'book' sizes 'A5' and 'B5' (system defaults to A4)).
sisu -p --papersize='book' [filename]
texpdf, image resizing for different paper sizes (useful when offering on the fly alternative document dimension processing) (manually calibrated to suit default document layouts) [note however other blocks such as tables are not (yet) handled similarly]
help (interactive help) now needs to be invoked with:
sisu --help [help query] 1185
[consider permitting multiple document size pdf outputs, (easily done, but promises slower processing as each additional size selected is generated) currently you select your size and get a portrait and landscape, the selection of whatever size over-writes the other, as they are saved to the same file-name]
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 1194
metaverse, changes to auto-naming/numbering of headings, and segment names [back to the more elegant auto-naming of segments solution, however, need to determined to be reliable (naming used to be done in a similar way) release passes initial checks though further testing is required; changes involve reducing the use of extra characters where possible in the auto-naming of html segments (the tilde and underscore were added to reduce the chance of name collision, and have now been removed where possible), additional checks that duplication does not occur have been added. This does mean any existing indexes (sql or hyperestraier) will have to be regenerated and url mappings/ links made within a sisu markup file to other sisu output of html segments will need to be checked and updated. Long term the currently implemented naming should provide a preferable solution (primarily in its being easier on the eye.)
odf, odd regex related bug related to matching of + sign in link text and corresponding urls fix not particularly satisfactory
debian policy standards-version back to 3.7.0 ... (should be 3.7.2 but lintian and linda not up to date this instant)
sisu_0.38.10.orig.tar.gz (of 2006w18/4 - 20060504) 1196 Debian release snapshot 1197
minor fixes, need resulting from default removal of ._sst temporary files (master documents:processed composite documents:temporary files)
process .ssm master file instead where possible, e.g. -R (and url info), (implemented in hub)
_ flag provided as hack to have ._sst files kept at the end of a run, (as an alternative to use of the -M (maintenance) flag (which changes screen output))
vim ftplugin, minor irritation with vim folds sorted
sisupod/ sisu_doc, .ssm, renamed sisupod.tgz. Master document pod now contains the composite elements of the master, .ssm and .ssi files rather than the "composited document" ._sst, 1199 examine for example:
search, debian:sisu "recommends" added hyperestraier [option in addition to sisu "atomic" search with postgresql and sqlite]
some help on setting hyperestraier 1200 up (in very basic way) for sisu provided:
sisu --help hyperestraier
for help on sisu search generally follow suggestions in:
sisu --help search
vim filetypes fix, the temporary ._sst rather than ._ssi
temporary files ._sst are now removed after run, unless -M (maintenance) flag is used
rexml fix necessary
help prompt fix
fix, 0.38 markup interpretation, evident particularly in XML Dom variant -X of a few documents, more strict regex
removed reference to 0.38 markup as experimental in help and man page (conversion script makes it easy to switch between markup versions)
debian 'Standards' version changed to 3.7.0
images, in particular to do with remote sisu markup source, e.g.
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) 1205 Debian release snapshot 1206
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) 1207 Debian release snapshot 1208
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] 1217
processing path when /tmp/_sisu_processing/$USER is used, clean of content after use (as is in public area on a multi-user system) unless maintenance flag (-M) is used
sisurc.yaml, removed processing directory entry, rely on sysenv default (can still change default in sisurc.yaml)
help, added a bit of 'environment' information, [expand further as needed] sisu --help env
common_db, fix affecting pgsql for endnotes in heading levels 1-3
sisu_0.37.6.orig.tar.gz (of 2006w12/4 - 20060323) 1219 Debian release snapshot 1220
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) 1222 Debian release snapshot 1223
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) 1225 Debian release snapshot 1226
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) 1236 Debian release snapshot 1237
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) 1243 Debian release snapshot 1244
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) 1247 Debian release snapshot 1248
fix of filelists where param is not parsed, relevant to rsync, scp and zap [problem introduced by changes made for multilingual documents which assumed that param is always parsed] [solution not elegant, but likely to remain a while]
plaintext dos/Unix, check that all dos linefeeds are in place
help (man pages, html, program), minor adjustments, and sync html with man pages
remote (rsync,scp) building of filelist for placement of output improved, relevant for multilingual documents [could be improved further especially for scp, where there is no language code all documents are copied, which results in duplication] [WARNING, this introduced a bug in the way file-lists were built that affected sisu -R (use of rsync), the option in any event is turned off by default]
metaverse, linefeed conversion, convert msdos line feeds \r\n to unix \n for processing
sisu(1) man page, note added on how to produce dos plaintext output file (instead of linux/unix)
plaintext, default shortcut flags changed to produce dos ascii files, reason, Unix/Gnu-Linux seldom has a problem dealing other ascii filetypes, MS based programs are more likely to stumble, also if manifest built concurrently with plaintext will use plaintext command flag to give information on output type - whether Unix or dos etc. [could add a file check of type where manifest is built separately, not really necessary]
skins, minor edits, path to css corrected
html (some w3c compliance steps) [20060115]:
object "id" number names changed, preceded by letter o
use of name tag to give objects numbers (instead of id for numeric value)
footnote links changed (use of underscore (instead of tilde not permitted))
image tags "closed"
skin adjustment
finally reinstate w3c transitional xhtml header
html tables, changed organisation of code [20060116]
odf tables [20060117] [display only without tables headings]
odf pagebreaks [20060117]
odf bullets [20060117]
odf multiple images in object [20060118], image handling, fix [20060122], image captions [20060122], placement within text "as char" [20060123]
overview.txt updated with things done
url screen display, fix to urls in batch processing [20060117] [overlooked because of personal practice of using rant /make to run all requested processes on each markup file in a batch process]
sisu headers, document recommended links, 12 link limit removed [20060120]
tables, introduced an alternative visual representation [20060120]
odf tables, max number of columns increased to 14 from 8 [20060122] (12 may be useful for months plus at least one to describe content)
sisu_test.s3 document added to serve as quick test of markup forms and a rough guide however it does not at all serve as an example of a typical document [20060121]
html anchor heading matches to start of line, [watch] [20060122]
odf text links [20060122]
odf bullets, as image, currently using "red pill" [20060123]
texpdf special character vertical bar / pipe, fix [20060123]
digests, document content certification, work on multiple images [20060126]
digests, document content certification, (digest info) digest for document skin digest, and repeat of document digest [20060127]
sql (pgsql, sqlite), special character escape, changes [20060128]
docbook experimental introduced, another form of xml (may need to rename, so far represents a quick first pass at docbook, and does not qualify as docbook: docbook is released under a liberal license permitting all manner of modifications, but if modified may not be called docbook) is as noted experimental and undocumented, (and may as easily be quietly removed, or renamed as improved upon) [20060131] [will need to study a number of things including embedding document parts (within parts)..., may take opportunity to introduce some substantive tags to sisu that are docbook compatible]
sisu_0.36.5.orig.tar.gz (of 2006w01/5 - 20060106) 1252 Debian release snapshot, unified (SiSU/Debian) build 1253
sisu man page minor edit
copyright file contains information on setup.rb included with tarball and on Rant used to generate install, both under Gnu Lesser Public License
Debian build changed, fewer packages, hope to unify the SiSU development and SiSU Debian upload builds
plaintext, multi-language document url adjustments
termsheet, output path and urls
[some multi-language document markup samples added to debian build in sisu-examples]
adjustments made for consequences of possibility of multi-language documents in sysenv, wmap, sql (psql/sqlite), remote put
sql prefix column changed to TEXT (from VARCHAR)
sysenv, change to the initialization of constants [revisit]
sql (pgsql/sqlite), (a fix:) "manifest" column replaces "summary" column
html_format_table.rb removed, last dependency removed, rely on css
wmap use main css, and own styles
html batch processing fix, placement of files: index.html, toc.html and doc.html
html -h -H behaviour switch, -h now produces urls with suffixes (hardlinks, including .html .pdf etc.) (this being the default that just works, including for reading output in a browser directly off a file-system), -H omits them and requires an appropriately configured web server. [change in behaviour is the reason for this version number bump]
multilingual/(multiple language) document filenaming convention and associated behaviour, made default, unless turned off in configuration file
default:
multilingual: false
multilingual/(multiple language) document output filenaming convention set at 1 in following example list: (1) outputdir/es.[file].html (2) outputdir/[file].es.html (3) outputdir/[file].html.es (which Apache for example can be the first option is convenient in that it organises versions of document by language in the output directory, (i tend to use 2 though)
default:
language_file: 2
(the default in the absence of a setting is 1 es.index.html, rather than 2 index.es.html)
[contains a batch processing bug affecting some html output, fix in 0.36.1]
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 improved additional possibilities in configuration, sisurc.yaml setting of programs used: text_editer, web_browser, pdf_viewer, odf_viewer setting of viewing preference, vis path, and url
-CC re homepages, new option setting the (manually crafted) home page, copy from first found of:
./_sisu/conf/home/index.html
~/.sisu/home/index.html
/etc/sisu/home/index.html
otherwise, as before will look for home page in:
./_sisu/conf/skin/doc/skin_sisu.rb
~/.sisu/skin/doc/skin_sisu.rb
/etc/sisu/skin/doc/skin_sisu.rb
and as before if that is not found, take the sisu default
css styles, start implementing a more flexible model for using alternative stylesheets, stylesheets may be specified in document header 0~css or 0~stylesheet [name], and if that exists, or if a stylesheet exists that matches the markup directory stub, results in html, xhtml, xml as appropriate, requesting the matching stylesheets documunts [needs work and testing before it becomes really useable, for the time being is switched off by default to use must be enabled in conf file]
-CCr -CCRZ stubs for remote copying/building of base site, images, css stylesheets, index.html and toc.html (not to be confused with existing remote placement of generated output)
Debian package adjustment
Debian packages broken into smaller packages, for better control over dependencies, source package structure affected (control, .install, .manpages)
sisu-composite together with sisu-examples installs the whole of SiSU
remote url gathering of images re-fixed, e.g.
should produce html and pdf of Free Culture from the online marked up file, with the images [sisu -CC (to copy downloaded images to the output directory)]
sisu -pHv <http://www.jus.uio.no/sisu/sphinx_or_robot.leena_krohn.1996/sphinx_or_robot.leena_krohn.1996.s3>
[has even more images, you will have to repeat sisu -CC]
[includes a workaround for an odd bug: retry needed on first attempt
sisu control, ensure file array unique [some risk of unforeseen consequences, test]
-v verbose output, minor, tagged on mention of sisu -W starting ruby webserver on sisu output directory
add link to sisu_faq, maintain faq
[debian, started using pbuilder] 1273
sisu_0.31.3-1 debian:control: Depends: ruby1.8 (>=1.8.3)
sisu_0.31.3-2 debian:control: Depends: ruby (>=1.8.2)
debian autobuild fix [external scaffolding]
odf, minor fix url match
[sample documents urls to amazon and barnes and noble added as courtesy to authors]
[Note: change to automated debian package build procedure]
metaverse, header, italicise and bold lists, results in significant changes markup change use regex directly [results in odf (openoffice) repair of 0.30.9]
rollback to 0.30.8 header, italicise and bold lists, use of semi-colon delimited list, [new version number 0.31 opened for header use of regex to italicise and bold]
setup.rb 3.4.1 by Minero Aoki included with SiSU as an installer
package directory structure modified to comply with setup.rb default data/man moved to man as setup.rb, affects debian
header, italicise and bold lists, markup change use regex directly [instead of converting semi-colon delimited list]
minor notes on installation in README
latex pdf, the pdfetex parameters used appear to be Debian specific, SiSU LaTeX is written for pdflatex. .. change precedence/ search order, use pdflatex if present, otherwise try use pdfetex (with pdflatex parameter)
url/document output, (largely cosmetic fix) screen information, sisudoc (-S) and sisu markup source (-s) [-S was linked to sqlite]
url (-U) print urls without -v
rsync screen message adjustment
skin:hp linked to sisu_changelog which has been separated from sisu_download
composite documents, fix manual closure of file is apparently necessary !
numeric shortcuts accept rsync extra command flag (-R)
rsync (-R), screen output minor (what default, verbose and quiet do)
conf, homepage, skin path precedence, fix (related to finding ./_sisu/conf/skin/doc/skin_sisu.rb)
summary, suggested links, cosmetic: fix to static url
sisu_doc, drop making of directory _sisu/config (using _sisu/conf)
html segments, summary button, fix (icon and link)
sisudoc, cosmetic: screen output, touch (remove repeat of output filename)
summary, suggested links, cosmetic: replace relative links with static url
sisu_0.30.3.orig.tar.gz (of 2005w46/6 - 20051119) 1284 Debian release snapshot 1285
configuration, change, use ./_sisu/conf [ WARNING ./_sisu/config is depreciated and will be removed]
db:pgsql bugfix, (for 8.1) added FROM in select statement
zap, delete, -Z disable by default, to use must enable in sisurc.yaml
rmagick, disable load/require by default, sisurc.yaml problem with some local installs of ruby
db:pgsql, bugfix FROM required in a select statement [postgresql 8.1 complained]
pdfetex, call with -fmt=pdflatex
summary, metadata suggested links added
xml, xhtml, html tidy only run with -V or -M rexml only with -M, primary reason a considerable speedup in skipping step unless specifically requested for testing
control file, changes a bit arbitrary, but a bit easier
summary and place of composite document source (-s -y), though just request for other documents [decide later whether to include constituent document parts]
help, update, sync with man pages
debian control suggests keychain (added)
sisu_0.30.2.orig.tar.gz (of 2005w46/2 - 20051115) 1286 Debian release snapshot 1287
minor cleaning
summary, include plain.txt where available
param, polishing...
sql metadata, reworked ... ongoing
sisudoc, re-named sisu_doc rather than sisu_ball
sisudoc, only -V and -M show verbose tgz of what goes in to sisudoc (previously -v d id)
name correction: SiSU is a recursive acronym, and has other alternative possible expansions, one of which i got wrong, under the influenced of the other !
SiSU information Structuring Universe
Simple information Structuring Universe
_Structured information Serialized Units_
[<-- i got my last name wrong consistently wrote Serialized information Structured Units, which makes less sense, (i am guessing i managed to overlook this because of the position of the word structured in the first and second expansion) i guess this correction calls for a major version number change! hope no one (else) notices ;-) ]
extremely minor touches for upload, regex match in param of metadata corrected, and copyright symbol matched for odf...
summary, make easily available from different outputs
metaverse, autonumbering of segments from manual text markup, re-checked/re-fixed [as presents some risk must be selected in heading]
metaverse, when run remove maintenance metaverse file unless -M flag used
param, endnotes checking, where endnote references and endotes are separate check than number count matches else report error, [and place error in document summary]
opendocument, renamed file odf
opnedocument, added matching & linking of urls and mail address
summary, warning of document error if endnote number mismatch, note this cannot occur if the preferred markup style for endnotes is used.
sysenv, pdfetex, debian renaming, search for pdfetex, pdftex and pdflatex to generate pdf from SiSU's LaTeX output
rsync use added for remote puts -R (scp is -r)
summary bug fix, variable scope reduced (incorrectly retained information from previous files in batch runs)
introduced -K which deletes output files prior to processing of files of same type
-s sisu markup source copied to output directory, (placed remotely with -sr)
-S sisudoc made and copied to output directory, (placed remotely with -Sr) [renamed from -Z]
--update updates previous output, with same filetype output only, useful
[-F renaming from -S naive cgi search form sample]
[minor editing of program file headers]
sql table metadata created, replaces table titles [breaks former table structure]
sql urls replaces links table
pgsql comments
cgi scripts use table:metadata instead of table:tiles
xml series, poem and group (and code) first pass
opendocument renamed odt.tgz instead of o_doc.tgz
summary, (-y) summary of document outputs generated and document metadata (metaverse includes links to summary, as does html band and latex doc info)
data/sisu (/usr/share/sisu) created for sisu shared images and odf, subdirectories, separating packages sisu from sisu-examples which is recommended only, and should not be needed to provide what sisu requires.
debian/sisu.install map data/sisu to /usr/share/sisu
[small changes: webserv var rename; cosmetic removal in html and xml of less-than greater-than on copy @ << home >>]
tar gzip files changed file suffix to .tgz (instead of .gz) comment added to man page and help
html some character encoding corrections (é and a few others)
param recognises rcs in addition to cvs and 0~rcs+ Id may be used [as alternative to 0~cvs equivalent, metaverse and downstream adjusted accordingly]
debian control added suggests lv and rcs as alternative to cvs [to which it is personally preferred for document control (as making more sense working with favoured used development distributed source control management systems, mercurial and darcs)]
metaverse autonumbering changed, affecting default html segment naming 1296
opendocument -o now defaults to produce metaverse first -mo (this is behaviour for other outupts such as html, latex/pdf...)
metaverse footnote url matches, tuning
texpdf url matches, tuning, especially footnotes
help update of processing flags, checked against man pages
some changes to variable names, cf instead of rf (also used pf briefly)
debian control file, minor edit of description of SiSU
doc/overview.txt update on things not done in list
sisu_0.28.3.orig.tar.gz (of 2005w42/7 - 20051023) 1298 Debian release snapshot 1299
metaverse, bullets accidentally removed, and put back
texpdf character encoding bugfix, (removed iconv) however, sisu requires utf-8 input for extended character sets
character encoding touches, e.g. sample files saved as utf-8
character encoding, moved a basic transform to metaverse, hopefully more predictable characters to deal with and made easier to work with postgresql, affects other modules changes to html and texpdf, neither perfect, both need work esp. html. two steps forward one step back
some database operations visited, (update)
Release (and version number bump) primarily to put ruby sisu segfault bug behind us, Debian ruby-1.8.3-2 released and fixes this [an emergency build to work around the problem was made available as 0.27.0 see note there for details]
remote placement of open document files added (odt)
added open document format to several default shortcuts sisu -2 etc.
made note of opendocument format output on sisu home page [feature not complete]
synced skin_sisu.rb files, (there are a bit too many of them, most would normally be syslinks)
[now using mercurial as well as darcs, darcs to build]
Ignore this branch: sisu-0.26.2 upwards are more recent.
sisu-0.27.0 was an emergency build, (2005-09-26) released after sisu-0.26.1 as ruby 1.8.3 (2005-09-21) breaks SiSU, ruby segfaults. 1303 This was fixed in ruby 1.8.3 (2005-09-29), and uploaded to Debian unstable as ruby-1.8.3-2 on 2005-10-21. For notes on sisu-0.27.0 see <http://www.jus.uio.no/sisu/sisu_changelog/changelog#0.27.0>
Avoid segfaulting builds of Ruby. Ruby versions that segfault sisu:
ruby segfault first appeared in ruby 1.8.3 (2005-09-21) and was removed by TS:Guy in ruby 1.8.3 (2005-09-29)
ruby segfault reappeared in ruby 1.8.3 (2005-10-12) and was again removed by TS:Guy in ruby 1.8.3 (2005-10-13)
sisu file format flag moved to -Z (from -B)
sisu -Z without [filename/wildcard] makes gzip of sisu directory of marked up files, including sisu markup source files, local configuration file, images and skins.
sisu -Z [filename/wildcard] makes gzip of individual sisu file specified including sisu markup source file and related images and skin
opendocument format, -o, experimental, incomplete, [ignore]
done: headings; footnotes; bold, underscore, italics, strikethrough; superscript, subscript; extended ascii set; indents; groups - poem, code
todo: images; groups - table; bullet; line break?; page break?; table of contents; page header/footer?
debian build (i) recommends sqlite added, overlooked previously; (ii) added recommend zip, used in the making of open document; (iii) removed recommended incorrect libcgi_ruby. libfcgi-ruby1.8, remains; (iv) have added a basic open document file structure as a tgz file
a sisu file format introduced:, -B, a gzipped file, containing: sisu markup sourcefile, its images and its skins, opens as sisu_ball directory, which once unipped sisu may be run within, (sisu does not at present automatically unpack and run on these files, but is a convenient way of packing the contents of a file for sending) [early days]
man1/sisu.1 upadated and html on -B sisu file format (sisu help not yet done)
cosmetic firefox taken from list of lightweight browsers, remains very much amongst the heavies
cosmetic correction on info related to librmagick-ruby contained within sample document free_culture
css, minor, caption - display: inline;
syntax highlighting (sisu markup), editor configuration files, added, see:
sisu-examples/config/syntax_hi/README
/usr/share/sisu-examples/sisu-examples/config/syntax_hi/README
preliminary for the editors:
nano <http://www.nano-editor.org/>
diakonos <http://purepistos.net/diakonos/>
kate <http://kate.kde.org>
NOT REALLY DONE, but intitial attempt included anyway:
nedit <http://www.nedit.org/>
[vim-sisu still provides the most comprehensive sisu markup editor environment]
evince becomes the default pdf in maintenance urls etc. (previous was xpdf)
document samples image dimensions manually provided, affected document sample "Free Culture", Lawrence Lessig. Note this is not necessary from sisu-0.20.0 onwards, if you have rubymagick installed. 1307
NOTE: this is an emergency version of SiSU that does not segfault with problem versions of ruby, see note follwing. It is prepared without Syck/Yaml
Problem ruby versions:
ruby 1.8.3 (2005-09-21) and was removed by TS:Guy in ruby 1.8.3 (2005-09-29), released as Debian unstable ruby-1.8.2-1, and in
ruby 1.8.3 (2005-10-12) and was again removed by TS:Guy in ruby 1.8.3 (2005-10-13).
Temporary build, to avoid ruby 1.8.3 (2005-09-21) segfault.
WARNING, ruby 1.8.3 (2005-09-21) breaks SiSU, ruby segfaults. 1309 This is fixed in ruby 1.8.3 (2005-09-29), but the new Ruby build is not yet uploaded to Debian unstable (as of 20050930).
A bug report has been made to ruby-core the nature of the bug is unclear but appears to be related to syck/yaml as ruby does not segfault without it.
Preferable solution to installing sisu-0.27.0, use any version of Ruby other than the problem versions, and the sisu-0.26 branch or later.
WARNING ruby 1.8.3 (2005-09-21) segfaults SiSU, fixed in ruby 1.8.3 (2005-09-29) thank you TS/Guy Decoux. 'Fixed' ruby not yet uploaded to Debian unstable 20050930
NOTE: this is a debug/emergency version of SiSU that does not segfault with ruby 1.8.3 (2005-09-21) [i486-linux]. It is prepared without Syck/Yaml
Temporary Emergency Release ruby 1.8.3 (2005-09-21) [i486-linux]] segfaults sisu
bug report made to ruby-core 2005-09-24
this version of sisu built without Syck/Yaml and is not configurable, (uses sisu default configuration only) ignoring yaml user config files
as such this emergency release:
only uses sisu default configuration settings, ignoring yaml user config files
does not provide sisu version information
css, minor, caption - display: inline;
syntax highlighting (sisu markup), editor configuration files, added, see:
sisu-examples/config/syntax_hi/README
/usr/share/sisu-examples/sisu-examples/config/syntax_hi/README
preliminary for the editors:
nano <http://www.nano-editor.org/>
diakonos <http://purepistos.net/diakonos/>
kate <http://kate.kde.org>
NOT REALLY DONE, but intitial attempt included anyway:
nedit <http://www.nedit.org/>
[vim-sisu still provides the most comprehensive sisu markup editor environment]
evince becomes the default pdf in maintenance urls etc. (previous was xpdf)
pruning, removed words.rb (vocab is used)
wmap & vocabulary, minor modifications, and runs metaverse
minor pruning and renaming, small changes
sisu_webrick, url path changed, server no longer builds url paths with tilde prefix
sysenv, and link urls updated accordingly
sisu-examples, cgi sql search form, minor updates sqlite sample set for webrick server defaults, port 8081, with url suffixes pgsql sample set without (port is default port, and no url suffixes)
sisu_webrick server defaults must be changed in rc files, rather than by command-line parameters (reason, the rest of sisu would not see command line parameter changes, and would continue to provide rc details)
start enforcing lower case sisu markup tagging
cgi, cgi sql search form sample generator, link suffixes added
cgi, cgi sql search form sample generator, -S takes additional parameter 'webrick' to provide port links that webrick server will use.
sisu_webrick, -W does cgi form.
sisu_skin & defaults, home page, adjustments
html output (tune), fix image, no link where non provided, i.e. where the { imagename.png }image notation is used
html output (css & tune), image caption, smaller font
configure, (-C & -CC) absence of trang is only reported if -V (extra verbose) flag is used
processing remote urls, (-C & -CC) absence of external_images is only reported if -V (extra verbose), is used [re-test]
man page, man sisu, updated to include "-S webrick"
urls, minor correction (maintenance mode output)
man sisu(1) and sisu(8), minor edits
minor code cleaning
sisu_0.25.9.orig.tar.gz (of 2005w37/3 - 20050914) 1314 Debian release snapshot 1315
latex/pdf, librmagick-ruby: will throw a warning and build latex/pdf document output without a given image if the image is marked up without the image dimension, if the librmagick library is not installed. [librmagick-ruby is not "required" as provided documents are marked up accordingly, it is never needed. As an example first image markup form requires the library, the second does not:
{ freeculture01.png }http://www.free-culture.cc/
{freeculture01.png 350x350 }http://www.free-culture.cc/
man pages additions, mostly "man 8 sisu"
sisu_0.25.8.orig.tar.gz (of 2005w37/3 - 20050914) 1316 Debian release snapshot 1317
metaverse, default is to run metaverse wherever it may be required, i.e. when any of - abDdeHhINptXxz
plaintext, endnotes version (-e) sorted, -a (footnotes following paragraphs) is ok [however is currently an either or, both output plain.txt]
texinfo, basic output working again (with pinfo). [fix later, moving of & to <=and>]
debian, recommends, added pinfo
help, fix help on markup \ escape character (escaped)
metaverse, possibility to escape backslash (\\ to produce \) [Special character escape set near complete for regular text, verify situation for code blocks (code{) where characters should be treated verbatim].
metaverse, markup, test and addition of possibility to escape contextual special characters, such as asterisk (*) and exclamation mark (!), which are not normally a special characters that need to be escaped, but the ability to do so is useful where for example used to describe their markup function as in *{bold}* !{emphasis}! verified others used in a similar way (*!/_^,+), either already available or also added /{italicise}/ _{underscore}_ ^{superscript}^ 1319 ,{subscript}, +{inserted}+ -{strikethrough}-
man page and help, comments added on escaping special characters and headers
[extensive testing escaping the full range of special characters is necessary these include \ < > { } and the contextual * ! / _ ^, + ]
metaverse, cosmetic corrections related to bold, italics and punctuation
metaverse, and add a few language settings
latex/pdf start looking at language settings, set language selected for document: \documentclass \usepackage \selectlanguage
latex/pdf creator copymark turned off by adding minus sign to creator header, as in 0~creator- [name of author]
man pages, help files updated on language settings
copyright SiSU system, object numbering etc. in pdfs, (reduced font size and words from previous Debian release, [a bit more than in 0.25.5])
latex/pdf cosmetic reduced size of font related to document processing information
metaverse, fix related to 0.25.3 (interaction between operation of bold lines and bold words selected in header).
metaverse, subtle correction todo with interaction between operation of bold lines and bold words selected in header.
changes to text accompanying latex/pdfs, toning down of language, correction of gpl2 url to fsf.org rather than gnu.org
latex/pdf fix, produce text without object numbers (problem with documents including grouped text markers, poem{ etc.) fix affects processing with the -0 flag (zero), e.g. sisu -mHp0v [filename].s3
cgi search for generator: fix, removal of an errant line of code (removal of hardlink to version number)
db/sql: changes to database table names, cleaner
db/sql/search: cgi search examples and cgi search sample generator modified accordingly
db/sql: recreate, creates if no existing database, instead of complaining (createall complains if database exists - you may not wish to remove existing db)
db/sql: replaced oid table with links table, and provide links to output files, affects both pgsql and sqlite
NOTE: previously existing sisu pgsql or sqlite databases should be removed manually, (or with previous version of sisu), and then rebuilt using >= sisu-0.25.0
character encoding, existing table hash replaced with a KirbyBase db character encoding table builder. The modified lib is not currently used by sisu, (& KirbyBase 1328 is not included with sisu), hoever, this is a possible way forward should such a table be needed.
latex/pdf, also html, bugfix, a bit of work on escaping of sisu special characters, html latex/pdf, done { } ~ < > & 1330 examine the need. Several characters are only special characters in given particular locations or combinations, 1331 the idea being that characters that are special or potentially so can be escaped in any event. Further testing and work necessary, hash is still a problem.
escaped characters spaced: { } ~ < > _ - / & | : ! ^ # 1332
escaped characters strung together: {}~<>_-/&|:!^# 1333
LaTeX special characters: $ & % # _ { }
metaverse_syntax, in code mode special characters should not be escaped
{ } < > ~ _ - / & |: ! ^ #
$ & @ *
test more extensively, and correct over time. Note that the hash is for the moment a problem (in latex/pdf)
latex/pdf and other files make sure headers are only given special treatment if at start of text, i.e. if actually headers, so can have a description of a header within text like 0~level new=1,2,3; break=4
0.23 development branch rolled back into "stable" version number branch, (see 0.23.0 and 0.23.1 for changes)
pdf page breaks, accepts header notation: 0~level new=1,2,3; break=4
html fix to links band -H added .html to home url, removed
metaverse_syntax, adjustment to lines parsed, (result affects some endnotes)
plaintext small fix & symbol
minor touches to documentation
some tested of supported file character encodings utf8 and iso8859 with unix line breaks
NOTE: sisu markup files should be saved with Unix line endings, and in utf-8 or iso8859.
fix to the still very naive sqlite search cgi example for sqlite
sisu -S will generate a copy of the naive sqlite and pgsql cgi search form it then needs to be copied to the cgi-bin directory. It differs from the example given in that it looks at output directories and includes them as database options. It is more accurate on sqlite, checking that a database exists, however both forms in their current form leave a lot to be desired.
url to location of sqlite database
latex/pdf cosmetic fix to front page removed angle brackets enclosing location information, they appeared incorrectly and it looks cleaner without them
texpdf, utf8 added properly by way of ucs package (now requires latex-ucs) breaks some things but in the long run is hopefully an improvement currently supported encodings utf8 and iso8859.
Iñtërnâtiônàlizætiøn a slightly more extended character set, using utf-8, 1337
! # $ % & \ () * +, -. / ' 1 2 3 4 5 6 7 8 9: ; < = >? @
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ]
< - ~ t ¡ ¢ £ ¤ ¥ ¦ § ¨ © ª « ¬ ® ¯ ° ± ² ³ ' µ ¶ * ¸ ¹ º » ¼ ½ ¾ ¿
À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ð Ñ Ò Ó Ô Õ Ö × Ø Ù Ú Û Ü Ý Þ ß à á â ã ä å æ ç è é ê ë ì í î ï ð ñ ò ó ô õ ö ÷ ø ù ú û ü ý þ ÿ
character encoding, utf-8 improved basic table, not yet utilised though, [and even as a small utf-8 table is on the large side]
minor code play with output (webserve) path
sqlite db output mapped to webserve path, current directory stub [instead of being deposited in pwd]
very naive sqlite search cgi example for sqlite, [badly broken frontend, look at, apparently taken too directly from working naive postgresql cgi frontend example, (the database created is fine though)]
metaverse, changes to automatic naming of levels 5 & 6 same methods used as has been for level 4, could possibly clash at times with level 4 in doc version consider implications [easy to attach somthing to level 5 & 6 names]
document digest in document information by default (previously only when cvs info also selected)
loading of skins for inserts
metaverse, regex fix for bold line syntax (!_)
latex/pdf, placement of object numbers re-sorted, an inelegant fix, revisit later.
sysenv, option to check load path and only load module if available reduce dependency on other packages, introduced for rmagick and now used also for dbi.
rmagick if installed can be used to calculate image dimensions, so these need not be provided in markup.
sql database operations only attempted if dbi is loaded(/available for loading)
texpdf, used parskip and removed use of smallskip from latex output (& other minor edits)
FSF address updated: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA 1340
sisu-examples sisu_search.cgi sample correction
debian Sources.gz
minor code edits
sisu_0.21.0.orig.tar.gz (of 2005w34/7 - 20050828) 1343 Debian release snapshot 1344
changes to file structure for processing and provided images now placed under the markup directory in _sisu ./_sisu/processing [built by sisu] unless ./ is not writable then /tmp/sisu_processing ./_sisu/image [added to manually] ./_sisu/config [precedence: ./_sisu/config ~/.sisu /etc/sisu]
skin fix reading and precedence [uses ./_sisu/config/skin ~/.sisu/skin /etc/sisu/skin ./_sisu/processing/external_document/skin]
external documents, provide similar logic placed in ./_sisu/processing/external_document/(image,config) this should mean that along external documents are downloaded together with their skins and images and processed as a unit
changed a couple of search path statements (skin,sisurc) to use blocks.
sisu manpage updated to take account of changes (help not yet)
merged/rearranged (and renamed Postgresql and Sqlite classes). Now SiSU_SQL (avoid possibility of namespace clashes).
plaintext, xml (sax & dom), xhtml, run on a new file creates required output sub-directory, it was relying on other selections for directory creation [thought done previously] affects flags -a -x -X -b
minor sql database rationalisation, postgresql & sqlite logic in same files [additional testing required]
added metadata categories (to the Dublin Core 15) added the following metatags, which seemed appropriate/useful: translator (or translated_by); illustrator (or illustrated_by); prepared_by; digitized_by (added to parameters, metaverse, sql databases)
note in man pages and help about sisu markup files being in UNIX ASCII
sisu-vim auto-conversion to UNIX ASCII for sisu markup files (sisu parses unix ascii, not dos ascii ... consider further, an issue for example with many(most/all?) Project Gutenberg texts)
(e) fix for new header links where linbreak used and imported into composite document, result in .t? suffix
(sisu_search.cgi) sample search form, minor fixes & improvements, still a mess
fix for old style header links, (broken in 0.20.4 with introduction of new)
(m) header links notation made similar to links within text old markup syntax remains possible, (i.e. backward compatibility kept) [should possibly force version number change to 0.21 but is minor change]
small touch to sisu vim syntax file, remove false positive error highlighting for alternative links markup
touch to remove relevance of whitespace in image markup (previously a problem in composite texts for latex/pdf output)
(metaverse for html) touch, whitespace reintroduced where name is given to an object as easy solution to interference that may otherwise arise with urls
ruby-libyaml removed from debian control, [a DD had informed me that he had neeeded it early in packaging days he must have been working with a version of ruby older than sisu is written for]
sisu_0.20.3.orig.tar.gz (of 2005w32/7 - 20050814) 1351 Debian release snapshot 1352
fixed sisu -CC, removed attempt to create pg db (this is done rather on -D createall request if does not exist)
sisu_vim manpage
latex/pdf monospace font (ttfamily) where code delimiter is used
html monospace font where code delimiter is used
rescue and attempt to create pg db only if db of pg type requested
a rule for stripping deleted text from clean text md5 digest introcued
debian signing of package against <ralph@amissah.com>
console output XML clutter reduced, REXML parsed headers now only produced for -V not -v
ID =
BD76E77F
Key fingerprint =
F899 5A87 C648 3F38 5107 79F1 B97B 7C4D BD76 E77F
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.4.1 (GNU/Linux)
mQGiBEL8fs4RBADNNhIsG6i13rDL4JLTgqy0fzcx8oJ9E/xDKeQo/5pqs18FvyKo
VsHdkUrPptZgxowalPi2aWvZgdi56yUFt295pNedMNXfTnwkVF/9PSA3r4OTBFWw
7NJYRUu2ZaSqtj3LpnBhsPpDqcl2g5Mry88mMLUeWB9OtsZE/QFVnoJqawCg4QSY
IOtgdxZVJfibHbFA0/2iG3cD/A98l/BuRWF+kwNacj1q+D0glC/u9mvg56fnAzTL
Osbhza/ebqvPgtFpP4PlIuvTcRZ9QsSJgmCTxNRPSKWPGqDmj7B7MDcPKUyJAPKB
fSLm5v5BuKTCLl9jyihbOqIdTgF1hoBHxTyfYWpVVuhdFP1kahityDNGpRhSfTif
doDLBACkB090RwyYBR589CMjF4miOo5m29ooQZO3tkR+6w5ny81H+qIHVx3TQZa9
d2166YcxMOFLh2mXBcVNsF8gQpv8Otk+Oyu5FFKqJiGV6JkEPf/W+iXMdpvTrxtc
rmU8cKagKxxBjue8PlI6bGusEjJXgmsTwOZB5WxCW4QQs49VoLQhUmFscGggQW1p
c3NhaCA8cmFscGhAYW1pc3NhaC5jb20+iGQEExECACQFAkL8fs4CGwMFCQPCZwAG
CwkIBwMCAxUCAwMWAgECHgECF4AACgkQuXt8Tb1253+R+gCg3KfzSGEmdWf01ryr
QLm35LutXS8AoNVfXb3OB1BMph6bOSNJpIyZAOgstCdSYWxwaCBBbWlzc2FoIDxy
YWxwaC5hbWlzc2FoQGdtYWlsLmNvbT6IZAQTEQIAJAUCQvyEaAIbAwUJA8JnAAYL
CQgHAwIDFQIDAxYCAQIeAQIXgAAKCRC5e3xNvXbnf12SAJ44Tuntdnqv7lAGgRes
KMFbHSt3YgCgjXkkHqY167kvDWmxrdAfupv7Ad65Ag0EQvx+2RAIAL23ShZnJJi/
1un84eoUoQ/AaXmGAhYjVlYiJzMjTXBygS12TnpNkqibnnIqbn/6v1WFIgZNRhzS
GzKo//MYtORdhB25UYe0YeOhZhyABLNSFKCye1ACBfDpJAFzc+kh7GjA1k2hnDsn
zox49eJyubO1FxiXXYrKaSMOGkuhp/JaLEVHZZyY++Zq0TuS8t3bOmNkUbL5X5oZ
n600yZzNfdQ8/5LjwIUvY9BDR+tHyypGyegDDmS5BVEjmW2d9ujDbVYRY6twA0q6
6WSx2WqT/HzdvSirEiPp3ENwQAaTnGT0G5q2zmYtutb9Yd/V/5aQBMEkAXF/JT4H
uw5ad3C6xNcAAwUH/jmC7wmvfA6Dqh9TfqDux9LzWbIny0NsgYTsE2Bkhg8kuHgb
PeqpOeJRFYxQkhknzW1PZZVwtxmfFgWgvukW4fqGSPWSpWDaYL91zkx2HRMBG1Nb
YwqNOLQnolRE9z/42b/M4oyIWhd0WTi6tZt5pMvpW5Dn7tOsnU3PlNM3AAv3Bjp9
QBki1KRjZC7PdKnQa9KSwvr4hgvvBlT4Is9131vmAZhu41Ni8UORmoq5e/lqd5O/
0QuySo+ZJEyLQuulfK19NPALZM+fu6/3dUHAu4D27MafYdQNqY3Xks4mquQ2p95k
OhNer8Yu7SSyBCIO/8V71UhkgyUdG7fMl0BzqPmITwQYEQIADwUCQvx+2QIbDAUJ
A8JnAAAKCRC5e3xNvXbnfzpwAJ0ZKPoWuWrx8K/zGSIRRj7ZRbf6KgCgji13BXoF
tJaIUHauen7hNIoUQXo=
=6US6
-----END PGP PUBLIC KEY BLOCK-----
remap sisu psql database names to SiSU_[directory name stub] instead of just [directory name stub] as this will make name collisions (and accidents) with other databases, when using SiSU to creating, deleting and recreating databases much less likely happening to other databases far less likely. [renaming means databases need rebuilding for use]
(l) have made postgresql >=8.0.0 [should say postgresql-8.0] the default requirement. An issue showed up with sisu & postgresql 7 series and UNICODE sequences used, as sisu as released is fairly new there is little incentive to maintain it [however, problem would seem to indicate a lot of bug testing is required, i am currently using UTF-8 locale (en_GB.UTF-8)]
cgi script example updated to match SiSU_[directory name stub] convention and to default to search of sisu-examples as this is a standard/common directory anyone might generate (or rather ./document_samples_sisu_markup)
(webrick url) console display of output text default to webrick url (can be switched off in sisurc.yaml, by setting webserve,webrick_url: false) however this assumes people know to start sisu_webrick (it is a toss-up between advertising webrick's availability, and sticking with filesystem paths as default, may have to revert) have thought of tying webrick url output to starting sisu_webrick automatically, would need to look at log files and get logging off the console, else would disturb other sisu console output. [a problem appears to be that in some browsers old cached pdf is served when requested, so changes made in subsequent document generation may not be displayed, consider implications]
sisu_webrick port sysenv default set back to 8081 (instead of 8111, consider 8123)
use createdb to attempt to create relevant pgsql database (using stub of directory name; uses a system command and assumes user has permission to create db, if user does not, and the database does not exist, would not be able to proceed anyway)
inelegant handling of "" image bug (no image) that appears in a test document.
a few urls shortend back to <http://www.jus.uio.no/sisu> from <http://www.jus.uio.no/sisu/SiSU> in defaults
sisu_0.18.7.orig.tar.gz (of 2005w32/2 - 20050809) 1357 Debian release snapshot 1358
some license clean up, gpl2 or later (appearing in pdf text output), removed sentences referring to alternative, somehow missed in previous grand cleanup sisu_0.16.24 where all document headers were cleaned, and the rest i thought [apologies 0.18.7 was rebuilt to include this change, they occurred in the file defaults.rb and texpdf_format.rb].
fix -N md5 digests batch mode, garbage cleaning
fix -N remote placement (revisit remote placement)
sequence digests if requested follow on directly after metaverse -mN...
html and latex/pdf so far, continue tradition of assuming that a comma (,) or full stop (.) following a url is part of a sentence, i.e. if a url actually is terminated by a comma or a dot are not parsed correctly, is convenient, consider implications though, may need to change. The changes were to make the behaviour of marked up curly braces with urls attached versions correspond with the usual handling of urls in sisu
fixed digest tree where image not found
defaults for shortcut flags (-1v -3v etc.) set to create the digest tree (-N) and to include filetype suffix (-H) as this works with webrick (sisu_webrick)
jpg image support consistently added (to existing png & jpg) gif consistently removed as on cursory glance does not appear to be supported by tetex, trivial to add later
man page and help mention of verbose screen output of digest tree
fixed metadata (metaverse) sourcefilename (where rc not used)
bugfix output paths, may change again, currently the default if writable is /var/www/sisu (and if no ~/sisu_www) (in previous version wrote to /var/sisu/www/sisu if writable too idiosyncratic a solution)
bugfix image markup where image tag (rather than url) used working for html and pdf again
fix metadata (metaverse) sourcefilename (where rc not used)
detailed document md5 digest output as digest.txt generated with -N flag 1362
added -N flag (document digests) to man pages and help
replaced uses of include? with plain regex (some vague recollection of rumours of depreciation in future ruby)... no rush, perhaps should have waited
(e)moved use of -o flag from old table based html
digests on clean text, rule... revisit, but body and endnotes treated "same"
tmp fix for special image characters, (e.g. Euro and Copyleft) tmp because image is taken from local directory images where ought to be taken from general image set, revisit.
document meta_data, version information re-organisation
texinfo cursory look, initial 0.18 fix
db pg/sqlite md5_all fix for level 4
latex/pdf, tmp bugfix, substitute & with 'and' in toc, needed e.g. for AT&T, see ffa, REVISIT
a bit of play with texinfo module, but (still) broken (in 0.18) until tested
some writing in man pages
sisu_0.17.5.orig.tar.gz 1367
plaintext linebreaks in endnotes br
xml series, branch-fix todo with tables (common_xml)
html endnote section branch-fix
sisu_0.17.4.orig.tar.gz 1368
url maintenance mode, minor fix
small fixes to latex pdf mostly todo with & character
sisu_0.17.3.orig.tar.gz 1369
md5 into postgresql and sqlite modules, (including endnotes clean md5 digest)
Implemented, but need to be consistent about content of paragraphs on which md5 digest is made:
1. clean/stripped text without any markup, paragraph, headings etc. without endnotes
2. endnotes clean/stripped text digest only (there may be several endnotes within a paragraph)
3. whole object, text with markup and any endnotes
some renaming in db modules
sisu_0.17.2.orig.tar.gz 1370
change in metaverse representation of md5 hashes
cleaning up of output after introduction of md5 digests
sisu_0.17.1.orig.tar.gz 1371
version number switch to development branch, some consequential changes.
sisu_0.17.0.orig.tar.gz 1372
incorporated md5 digest keys for each object (paragraph, table etc.) in "metaverse", available for use for downstream output/processing as desired, there will be a clean text hash (including endnotes contained within the paragraph), and a marked up tag..., (both taken from the metaverse) . This is a fluid situation. Debs though built, have not yet been made available, this is experimental, and it's final form (depending on making the most useful md5 hashes) uncertain. 1373
0.18 md5 digests on every object (paragraph, endnotes etc.):
0. md5 digest taken of the document source and placed in the metaverse (implemented much earlier)
Produce md5 digests (in metaverse) for every paragraph and endnote, specifically an md5 digest for:
1. clean/stripped text without any markup, paragraph, headings etc. without endnotes
2. endnotes clean/stripped text digest only (there may be several endnotes within a paragraph)
3. whole object, text with markup and any endnotes
[digests should not include other digests]
Digests are available for use at will in downstream modules, e.g. in database mapping, to identical paragraphs, possibly in html scroll, to identify unchanged content, etc.
sisu_0.16.25.orig.tar.gz (of 2005w28/2 - 20050712) 1374 First Debian release 1375
sisu-examples, Free as in Freedom ... minor touch, previous markup broken, will check later
copyright string made more clear as 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005 ... only question being whether it should not have been 1996.
copyright headers changed within files for Debian
some changes in use of ocn for segment naming in html output
a couple of postgresql fileds changed to text
using Rant 4.0 for package build and install(er)
cosmetic rearrangement of code
metaverse fix for alternative endnote markup marker at end of line
texpdf fix for images, (where dimensions not provided) not final, may need to pass through imagemagick at metaverse stage
fix to cgi sample sisu_search.cgi
small bugfix (param screen print)
for Debian build new sisu-vim package, the result of separating out sisu vim files (syntax & folds) from the main package (and it was previously in sisu-examples)
touch to syntax highlighting
small touches to vim syntax highlighting
some fixes to vim syntax highlighing: - changes to markup syntax introduced in 0.16 release broke parts of syntax highlighter, more no doubt to follow.
separated color file out from ftplugin ... called dusk (or slate) by me for several years i now call it sisu... perhaps i should stick with slate as it is pretty appropriate... hmmm, slate
package built off an older Debian installation 1384
small touches to offer vim config files working the way i am used to with Debian install... needs testing by someone with different habits though.
separated vim syntax and ftplugin directory... have still got color file in ftplugin/sisu.vim file which is not acceptable.
sisu vim ftplugin ... for folds, syntax, colors, markup auto installed in debian, (but uses shared filetype in /usr/share/vim/addons check how that is supposed to work) else (non-debian install) Rantfile places in /usr/share/sisu-examples/config/vim
debian setup of vim syntax ok... however much vim setup still to automate, immediately noticeable: folds for sisu not sorted; and permitting cursor movement up and down without following long lines with screen wrap; (and no clever way yet to contribute colors other than through sisu-examples, but they being user preference should be contributed with care).
on_markup.txt quick check & minor update
home page index.html creation, path precedence set: ~/.sisu/skin/doc, /etc/sisu/skin/doc, defaults, and content is interchangeable (so future latent break is less likely)
touch to Rantfile
bugfix a default variable, in defaults version should be @ver introduced by cuts and pastes between different files, with recent default home page updates; make less likely to happen in future, for now quick fix, revisit: currently index.html taken from ~/.sisu/skin/doc if it exists else defaults, /etc/sisu/skin/doc is ignored, breaking expected path search precedence
small edits to man pages and help NB have taken out reference to alternative markup possibilities e.g. b{ for bold }b being available as well as *{ bold text }* (as the letter the and html equivalents are depreciated, having or using alternative markup styles is less tidy)
cleaning up of man pages, largely for html presentation generated by rman
minor edits
added the man pages in html (converted to html using rman) 1395
and related rather cosmetic changes
vim folds for sisu markup files updated command is :F (ruby folds :R) assuming the file is in place and in use
some cleaning of wordmap output, regex exclusions added, not elegant (special issue pages include sha and md5 output, also excluded)
[released 0.16.6:] vim folds for sisu markup files updated command is :F (ruby folds :R) assuming the file is in place and in use
comments, url locations of samples, output, etc. added to markup syntax files (in addition to SiSU home which was already there)
removed from tarball markup samples "eu contract law principles" which can still be found at <http://www.jus.uio.no/sisu/sample>