%% SiSU version 3 * homepage at: * * * * data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_manual.ssm * data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_download.ssi * CHANGELOG CHANGELOG_v2 CHANGELOG_v3 README data/doc/sisu/ Reverse Chronological: %% Development branch UNSTABLE v3 branch once stable will supersede & replace current stable v2 branch %% 3.0.14.orig.tar.gz (2011-07-26:30/2) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.14-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.14.orig.tar.gz sisu_3.0.14.orig.tar.gz sisu_3.0.14-1.dsc sisu_3.0.14-1.debian.tar.gz * hanging indent partially implemented, added markup possibilities __[1-9] hanging indent (initial indent 0); paragraph text indent [1-9] _[0-9]?_[1-9] initial indent; paragraph text indent * done: dal, plaintext, css, html, epub, xhtml, xml sax, xml dom, pdf, sql; not done: odf, man, info check: po4a, html_lite (used in sql search results) * syntax highlighting done: vim (sisu.vim), emacs (sisu-mode.el) * indent added bold words markup syntax (_[1-9]!) (_[0-9]?_[1-9]!) for indents __[1-9]! bold words part of hanging indent paragraph text __[1-9]! bold words \\ part of hanging indent paragraph text * param, manifest, qrcode, epub, added creator.editor field * sql db, constants, cgi-sql, structure changed, creator editor field added * sisu_manual, manpage, manpage html (man2html) * sisu_commands: --qrcode -Q; update shortcut options; line-breaks use \\ * sisu_markup.sst: indent update; publisher * vim sisu syntax highlighting * markers for hanging indent added * added header for @creator: :editor: * minor comments added * deletion of an unused tag * emacs sisu-mode.el * markers for hanging indent added * line-break * qrcode, sysenv, manifest, generate & add QR code images of metadata to manifest (using qrencode) (consider where and how else to use images) * epub, opf fixes * sysenv, avoid creation of spurious directories in output tree (an image copy section removed, re-implement correctly later) * param, cleanup setting of auto endnotes * texpdf, XeTeX language settings ((setmainlanguage setotherlanguage) from directory or filename) if @make: :language: header not set * xmls (sax, dom, xhtml) use of xml tidy, correct output file location * urls, --concordance %% 3.0.13.orig.tar.gz (2011-06-26:25/7) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.13-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.13.orig.tar.gz 33d2358a39a69c1be4403b06b52eaeca604e851ee4e32c6f1625399944362fea 1943441 sisu_3.0.13.orig.tar.gz c741399aa3da6189854f7a532eae6db27370646a2b86b7427bf330401369bc13 1223 sisu_3.0.13-1.dsc 0fe5173e4973a4af7fba79dcf5ae3c702f34b5ac89e02f4be9e014641e7514d0 289790 sisu_3.0.13-1.debian.tar.gz * dal_syntax, linebreak within regular objects is \\ (
depreciated) [test, affects downstream outputs, there is the potential for breakage] [thanks to Jonas Stein for making me look at this, see bug: #617298,
was not documented because there has been no intention to keep it, but there was no markup replacement until now] * ok for plaintext, html, xhtml, xml, epub, pdf, manpage * not properly honored in paragraph objects for odt [todo fix, but issue] * sisurc.yml, config settings * vim * sisu syntax highlighting, linebreak \\ added (
kept) * colors, added cursor line & column * documentation, on additional breaks in document * linebreak \\ (previously undocumented
kept but depreciated) [it is intended that this should close #617298] * page break (breaks column if column, else breaks page) * page new (new page, breaks page) * removed section on hyperestraier, too specialised for general manpage (also section not checked recently) * texpdf * define latex \newcommands for some special characters to simplify dealing with them in sisu code \hardspace \caret \pipe \curlyopen \curlyclose \lt \gt \slash \backslash \underscore \exclaim * provide backslash character in code block * plaintext, codeblock keep backslashes * html_tune revision * deal with angle brackets in markup (test, could cause breakage) * reduce loops * manpage * start to honor line-breaks within objects (revisit) * show double escape \\ (backslashes) in code blocks * place under web server directory * texinfo * backslashes & line-breaks * place under web server directory * info tool setting prompt * shared source markup (.sst .ssm & sisupod.zip) * manifest enable * manpage (in fututure have config setting with default false/off) * info (texinfo) (in fututure have config setting with default false/off) * hash digests * locate markup source * sisupod * urls (ansi screen reporting), add document language code * sysenv, accommodate * manifest * manpage * info (texinfo) * sisupod * shared source markup (.sst .ssm & sisupod.zip) fix some paths * placement of markup source, output_path.src.dir, fix * output_path.src.url, fix * constants, a sisupod & an xml related addition * ansi screen reporting include document language code %% 3.0.12.orig.tar.gz (2011-06-09:23/4) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.12-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.12.orig.tar.gz 87b54e241067766c67233889ac973310d25ae12264ed65e9fd847626c9b95b2a 1943781 sisu_3.0.12.orig.tar.gz dad744f0f6521a9f6b0f0ba07dadee0dc6a6bcfb009fb5311b92528da15d6c1f 1223 sisu_3.0.12-1.dsc 4d3f83d9d923b3c8a9ac2c88dd119e93bb146c963b54b9e56fdb83d5cfdb58d7 288488 sisu_3.0.12-1.debian.tar.gz * harvest * correct paths to document manifests etc. for the possible output dir structures * produce authors and topics lists for the documents that are available, according to availability in each language * cgi generated sample search form * use ruby 1.9.2 shebang/header (sisu-pgsql, sisu-sqlite) recent upload of libdbi-ruby1.9.1 fixes bug reported as #596103 (against libdbd-pg-ruby1.9.1), search forms (pgsql & sqlite) can now use ruby 1.9.2, so cgi headers changed back to #!/usr/bin/env ruby [however must use ruby >=1.9.2] (from #!/usr/bin/ruby1.8) [see sisu-3.0.8 NOTE & "sample search form" solution, (now superseded)] * force utf-8 character encoding to avoid issues, fix (incompatible character encodings: UTF-8 and US-ASCII) * correction of a variable name, fix * options * restrict glob rule checks to when --glob (-G) or --find (-f) requested * carry information on document language (from filename and or directory * (additional test) * sysenv, limit/prevent the creation of spurious output directories (based on language subdirectories), revisit * manifest, fix a full name * html, index.html syslink, remove and remake syslink * texpdf, index.html syslink, made similar * param, remove unused class variable '@@symlnk' * help * --help language, provides list of available languages (ISO 639-1 code (as varied by po4a) & name) * s/Bul garian/Bulgarian/ (Closes: #619068) %% 3.0.11.orig.tar.gz (2011-05-29:21/7) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.11-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.11.orig.tar.gz b3ff82d967565a35f9693ad95812adcb850ac4f58f60f4cf9e5a9d613d886fcc 1940955 sisu_3.0.11.orig.tar.gz 69d15d75fbf3670b8609dd8d9ee65a10b2eddfbcddd9ee206cbc48cfde6eb899 1223 sisu_3.0.11-1.dsc 2a11d94922d6810b5a786d51a148cc955d8c676932b9341b8a30bf114cab4cee 288354 sisu_3.0.11-1.debian.tar.gz * sysenv, url webserver link (manifest) fix * cgi search form, fixes related to language code (filename with language code being required as unique document identifier) * options * filter out files not matching .ss[tm] * with -f -G (--find|--glob) flag glob all .ss[tm] files in dir including language sub-directories (e.g. in directory above language sub-directories where ./_sisu/sisurc.yml should be located:) sisu3 -3G live-manual * with -f (--find|--glob) flag and find .ss[tm] files that match given string in dir including language subdirectories sisu3 -3GR * i18n, constants, some language information moved to i18n (from constants) * documentation, minor update, includes --find / --glob %% 3.0.10.orig.tar.gz (2011-05-23:21/1) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.10-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.10.orig.tar.gz 8419b1523656789f5946fca32297b9ba58ec107ff52d12efa4698cabc242a3b8 1940966 sisu_3.0.10.orig.tar.gz eaaefd3f5d9ce76342c0df422ba023bb260b489f9f0830ef2f38097ebe21249f 1223 sisu_3.0.10-1.dsc 337a1f4e032e67388081317abf590a04e1abf4934265b69e0dcc52225cb6eaec 287644 sisu_3.0.10-1.debian.tar.gz * copyright (minor) touch, dates for setup.rb * sysenv, rsync, embedded * rsync to remote host alternative output structures, fix (remove blocking test path) * get rid of annoying new nag to terminal (-v reporting Dir.pwd), prevent attempt to change directory unless different directory requested * param, html, epub, xml, simplify file-naming convention with language code (language code occurs in fixed location within file-name, could previously be configured to occur in 1 of 3 locations within file-name) * texpdf filenames * i18n, add language name translation column to hash/table * prog_text_translation: * fix to Portuguese language class name (missed the 't') * language name matching ('Portuguese Brazil') * indentation * options, include markup source "base" path, used to parse alternative markup source dir structures * manifest * relative paths to "available outputs" (for each dir structure), fix * show language versions published (needs 2 runs of manifest, polls output as to whether manifest files exist) * html * close files * syslink index.html to toc.html, needs revisit (will only "work" properly with by_language directory structure) * defaults, fix path to homepage image (more fixes remain ...) %% 3.0.9.orig.tar.gz (2011-05-17:20/2) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.9-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.9.orig.tar.gz 90694ba44e6412f266fe0501975c3dcdc95824c5099f54729c436284f5948eab 1937861 sisu_3.0.9.orig.tar.gz f33e08e31d9497f5ab09e0bc35753837671ac80690e8142f0690353a069ba65f 1216 sisu_3.0.9-1.dsc 5482748d75af890a00d9ecdb4302b31ed4508d9eb6f668ad9bd2f9428158bba3 287102 sisu_3.0.9-1.debian.tar.gz * bin/sisu2 introduced (to complement bin/sisu3), currently same as bin/sisu (later switch bin/sisu to bin/sisu3; consider using update-alternatives) * vim, cterm colorschemes, touch search color * copyright file, softlink, make more visible in tarball and update * sisu-mode.el assigned to FSF (GNU EMACS) * options, expand name of file for selected language directories * only use for single file(name) available in multiple languages e.g. sisu3 -hv en/free_culture.lawrence_lessig.sst es fr * english assumed as default language, make default configurable later * particularly useful for po4a * sysenv * output directory structure check, fix & start testing alternatives sisurc.yml output_by: (language|filetype|filename) * output paths restructured, to have dir, url rel(ative) & rcp (for rsync or scp) * url paths to output files (requires setup in sisurc.yml) * consolidated output paths, directory & url, affecting many files * rsync of output must cope with alternative file structures * scp, disable until looked at * dal_expand_insertions, fix resulting urls for shortcut for sisu generated document in same output directory * cgi sample search form generated to provide different links depending on output structure, now links only to manifest and html toc * manifest, url path, fix * po4a, re-enabled, numerous issues %% 3.0.8.orig.tar.gz (2011-05-05:18/4) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.8-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.8.orig.tar.gz 87b595cc6e108e325d80e7ef78e58463ab3cdd0d7036fd943224114c8eb9b897 1936305 sisu_3.0.8.orig.tar.gz d3114d3aeba230501c79ab478c30985438ad1bf4a5cde628cb82ab7717028623 286421 sisu_3.0.8-1.dsc 43bc0459adb7174f03b91c67efd10d053a39da07dd1319f26fd2928f80876d03 1216 sisu_3.0.8-1.debian.tar.gz * bin/sisu3 bin/sisu /bin/sisu_webrick bin/sisu_termsheet * improved ruby version check * options, language setting, based on directory structure or filename * sysenv, language setting from options * affects multiple libraries * i18n, sysenv, options, language setting changes affecting many files * must be able to set language at options stage from filename or directory * prog_text_translation, renamed from what was i18n, i18n name reused * db, directory structure changed, database prefix renamed * language_document_char field made larger [consider renaming language_document_code or ..._id] * title, src_filename and language_document_char fields mandatory (title, title_main, src_filename, language_document_char) * NOTE: [libdbi-ruby1.9.1 fixed in unstable 2011-06-06, & for sisu-3.0.12] cgi sample search form caught by Ruby/DBI libdbi-ruby1.9.1 reported reported as libdbd-pg-ruby1.9.1 bug #596103, where "select_all fails". The cgi sample search scripts for postgresql and sqlite3 are almost identical, both work in ruby 1.8.7, both have the same error in ruby 1.9.2... a very similar bug is reported about the mysql library. Should #596103 and the upstream report be reported against Ruby/DBI (libdbi-ruby1.9.1) rather than libdbd-pg-ruby1.9.1? * * * fix/workaround options include: * await bugfix, (bug has existed at least since 2010-09) * rewrite for ruby-dbi using other constructs e.g. s.fetch {|row| ...} * revert to ruby 1.8.7 for the cgi script (they work independently of the rest of the program anyway) * rewrite for individual database dbi re: psql and sqlite3 * await rdbi (ruby-dbi replacement), also needs to be packaged for Debian and develop for that * use some other programming language for sample search form or some meaningful combination of any of the above. * sample search form, revert to generating ruby 1.8.7 sample * sisu3 using ruby >=1.9.2p180 generates search form for ruby 1.8.7, so: generate sample form using sisu3 -F (options), then; start webrick using ruby 1.8.7 & sisu -W (not sisu3) * take account of alternative output directory structures [work on, test] * manpage, reinstate escape of hyphens (clearly preferred, else lintian reports hyphen-used-as-minus-sign) * manpages, escaped hyphens reinstated (remove lintian info) * urls, a fix, sqlite * sysenv, lowriter (instead of libreoffice) * db_select, ansi screen reporting, correction for sqlite db update * concordance, output path, screen info correction * vim * sisu syntax change of a couple of color groups (Delimiter instead of Include) * 8 color cterm colorschemes * sparse series uses dark grey on black, usually looks better, but only works with a fixed color cursor, preferred in terms where you can get away with using it * frugal series avoids dark grey * slate for cterm now incorporates frugal-cterm-sisu * *-cterm-ruby & *-cterm-sisu colors adjusted where other color groupings are preferred for programming / sisu markup %% 3.0.7.orig.tar.gz (2011-04-20:16/3) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.7-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.7.orig.tar.gz 08474012bd979f4c18881be47d0b2e6c5add9a013b886ea6f7f943464db84825 1929419 sisu_3.0.7.orig.tar.gz 0028f57ed75fb1e358a0a14e197c607091d8a99c18b856750bd1d820c760ff6c 1216 sisu_3.0.7-1.dsc 9a9a9d139cc0f4c7ccdfcb41be7eaba517ce96914b68a483d08debd233c76929 285739 sisu_3.0.7-1.debian.tar.gz * param, md remove md.cmd and md.mod shortcut methods, use use md.opt (md.opt.cmd md.opt.mod) * affects many files that now use @md.opt.cmd & @md.opt.mod (instead of @md.cmd & @md.mod) * options * new alias (for -M / --maintenance) --keep-processing-files (see Bug#622902) * introduce opt.act booleans made up of opt.cmd and opt.mod, more flexible than overused cmd characters * where possible move option setting from hub to options * separate out a few methods * odf:odt * maintenance, processing in separate subdirectories, that can be kept * odt.zip (bin) directory renamed odt from odf * hub * some option setting moved to options * favor use of opt.act over opt.cmd where appropriate * sysenv * variable directory path fixing (language, filetype, filname), making the stub for at least manifest and html available early for processing that do not or should not need to process individual markup files completely, such as the cgi search form and harvest * odf:odt paths adjusted for changes in maintenance and odt.zip * harvest * place with document manifests * variable directory path fixing (language, filetype, filname) * cgi, sample-search-form * results still not right, (ruby1.9.2 libraries? double check script) * not yet done variable directory path fixing for result links * vim colors colorscheme Slate reviewed, cterm 8 colors, & frugal added * Slate, review conflicting group colors * 8, cterm colors to work with * frugal, cterm colors ... my term oddly has 8 colors plus 242 for dark grey possibly more but odd numbers to set * sisu-mode.el header notes copyright assignment to FSF 2011-04-08 (GNU EMACS) * url to sisu git repo source (when possible also track GNU EMACS location) * screen_text_color (ansi colors) touched, consider reviewing later * urls, report output locations * fix show all urls -U * share/reuse code * fix maintenance urls -M (where processing files are kept for examination) * odf maintenance added * html_tune maintenance fix * documentation, sisu-markup-samples, man page, html * document existence of new alias for -M (--maintenance) --keep-maintenance-files (see Bug#622902) %% 3.0.6.orig.tar.gz (2011-03-30:13/3) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.6-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.6.orig.tar.gz daa6671a08dd4eeb5848f73b3ecff23b05b7fa0e338b91cd9992dee8a005441e 1923985 sisu_3.0.6.orig.tar.gz a0ca253a6d9b8254f1acaf73d771e5afea12418d971a10d394e20c76c840ef7e 1216 sisu_3.0.6-1.dsc 9710bf09eb70fc6e456d7ee0fba746a5fe3486fa14a59001d7e17fcddc608aa8 284254 sisu_3.0.6-1.debian.tar.gz * (ruby 1.9.2 (transition related) fixes) * dal_doc_str * empty line not paragraph object * table structure issue, double spaced empty line creates spurious newline * dal_images, image path setting * cgi sample-search-form, string output (also cleaned unused help text) * sysenv, remove repeated method * vim colorscheme Slate, review console colors * change warning and diff colors, so as not to conflict * review cterm colors * for console use color names instead of numbers * rearrange %% 3.0.5.orig.tar.gz (2011-03-24:12/4) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.5-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.5.orig.tar.gz 9ac4622ff5e27188873d18bc0f92c508b72850eba8aebea25372e18a3c066fb4 1921835 sisu_3.0.5.orig.tar.gz 11a4c576eda0c95925150ea354bd267ee1147e800765855501dabc5421fc6204 1216 sisu_3.0.5-1.dsc d464fea52ecc63ef2dd79467caa8737ff4f438ef3ac2a4d31be19d87d938bb50 282094 sisu_3.0.5-1.debian.tar.gz 1cfa902db6e95f189094ea04aeffdf829b0587949474284c3d319c6538ab64e7 1216 sisu_3.0.5-2.dsc 6934656837f4cc9830a549dd96ac2592fde3c7132021db1d4c876fac40b63846 284916 sisu_3.0.5-2.debian.tar.gz 7316b1dc48da1b4b1f9ef0ffbb3ca5e7cbaebf57a1cdcb44acc5856c1ea0f852 1216 sisu_3.0.5-3.dsc 6984641a61f676e03a085953309c1ba728b263ce3a44e56d0df428406b65f03a 285568 sisu_3.0.5-3.debian.tar.gz * move to ruby >=1.9.2p180: simplify development of v3 and maintenance of v2 * bin/sisu demand ruby >=1.9.2p180 (version checks) * debian/control, dependencies [note should at least be v1.9.2p180, when issues in earlier versions of ruby-1.9.2 were first observed to be gone] * texpdf bugfix, where map_nametags not found, drop nametag (rather than crash) [Debian-live, live-manual (Ben Armstrong, chals?, reported new bug in a number of translations (that crashed the pdf generator). It turns out where map_nametags is not found the document crashes.] * vim syntax highlighting, fix typo %% 3.0.4.orig.tar.gz (2011-03-11:10/5) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.4-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.4.orig.tar.gz 145c409526b26cb0a14b43f4c46219fb828dc41c8211d8f77bad486a98300678 1920526 sisu_3.0.4.orig.tar.gz 4886196e536e3ad48b29d27b1f0664f77b58ee4b4b21e41c0351c6b3a33dd156 1216 sisu_3.0.4-1.dsc b41f225c61600a084a729b4d749b30eeebbdbfffc775e227a05159410b4c2a00 281648 sisu_3.0.4-1.debian.tar.gz * sisu_manual, sisu_download, remove references to versions of sisu %% 3.0.3.orig.tar.gz (2011-03-11:10/5) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.3-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.3.orig.tar.gz a48f327ccf025582a5301a8e6a754891ff56c154843f5992d6b9d1cac97247be 1920600 sisu_3.0.3.orig.tar.gz 1546cd20167f21ad6cfe06246f059f5476f206ca393bf4bc32e41d65bb20b688 1216 sisu_3.0.3-1.dsc d5f3c7631b3d81b7effec10fd188ebdb3ea21c88daff1c881c6a42967b76164e 281938 sisu_3.0.3-1.debian.tar.gz * dal_syntax and affected downstream output modules, revised pattern match for mail, (removes occasional interference with urls having embedded email addresses) * dal_syntax: (internal document) link matching, a fix [Debian-live, live-manual (Jose Luis Zabalza, Ben Armstrong, reported bug in Spanish translation markup (that crashed the pdf generator). Bug in markup subsequently identified as "versátil,#{iso-hybrid}#, se" which the interpreter identified as an internal document link to a comma (instead of as being monospace markup), markup should have been "versátil, #{iso-hybrid}#, se" this fix prevents that incorrect match, (but the markup remains faulty and the monospace markup is not identified as such without the corrected spacing). Unfortunate "grave" results for what is a pretty insignificant data entry typo (there are no doubt other such situations).] * dal_substitutions_and_insertions: regex for sisu header matching (in sisu markup code blocks), a fix * dal_doc_str: fix, looks like typo in regex * param: tidy, remove redundant document header tags * manpage output presentation fixes * manpage: (lowercase .br; correct newlines before .nf and after .fi; no escape of hyphens; remove redundant links; endnotes array requires flatten; screen info on output path) * param: manpage header .br and no escape of hyphens * urls: correct output path for manpage * texpdf: url (regex) pattern match fix (/https?/) * help (markup): correct path to markup-samples * documentation more link fixes * syntax highlighting * emacs sisu headers updated (subheaders omitted for now) sisu-mode.el * vim cleaning sisu.vim %% 3.0.2.orig.tar.gz (2011-03-05:09/6) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.2-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.2.orig.tar.gz 5211dcb37ab8aeb0889e3faaf567367f40f3b121a60cc6fd01fd78fe5adcd00d 1918497 sisu_3.0.2.orig.tar.gz b680fc9409d25149928a2b2067b60b610d0500ed93799e7d35f1b62642621f49 1216 sisu_3.0.2-1.dsc b09754d0dcefd0cfeb0e1b641e291d79f5a61dc9dad8138826d262f5d07f7c3a 280734 sisu_3.0.2-1.debian.tar.gz v3, target ruby1.9.2, ruby1.9.2p180 is ok note: there are issues with sisu and early versions of ruby1.9.2 ruby1.9.2p0 is known to segfault on a number of operations ruby1.9.2p180 does not have these issues * make sisu: v3 require >=ruby1.9.2 (v2 require >=ruby1.8.7) bin/sisu bin/sisu3 modified accordingly * use rb1.9.2 "require_relative" syntax * ruby 1.9 hash symbol syntax adopted * space between each and opening curly brace e.g. "x.each {|y| p y}" * use "encoding: utf-8" (instead of coding) * sysenv, processing_path method (separated from path) and resulting necessary changes * urls, param, two unrelated regex fixes, check * hub, minor rearranging * v2, v3: manpage, adjust output, fewer backslashes * v2, v3: defaults, clean homepage * v2, v3: consolidate manual & markup samples sisu markup source, manpages, man2html * clean up headers * update and correct links * tidy * small fixes * conf/skin remove less important skins and use syslink to share doc/skin_sisu.rb %% 3.0.1.orig.tar.gz (2011-02-16:07/3) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.1-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.1.orig.tar.gz 881a1fa51154c706c053c6cf136fbaa7c1f3abe96dd203dc649d42875dd55482 2716285 sisu_3.0.1.orig.tar.gz 9320cf50485fdc05a7c1b12d1f85257a9d8b8cdbb31786589ec79e5aea5935bd 1216 sisu_3.0.1-1.dsc c69a80680d786e3f9b9090997e9ba7bc39c048681564fa0af4e59d2cec74e3dc 279711 sisu_3.0.1-1.debian.tar.gz * sysenv, sisurc.yml and elsewhere as affected, output_dir_structure: by_language_code; by_filetype; by_filename * css, fix css paths for xhtml, xml dom & xml sax * console feedback on selected files being processed, updates & fixes * sysenv & sisurc.yml: libreoffice, default odf reader %% 3.0.0.orig.tar.gz (2011-02-07:06/1) http://git.sisudoc.org/?p=code/sisu.git;a=log;h=refs/tags/debian/3.0.0-1 http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.0.orig.tar.gz 53b9629bde5d27c504005ebc02c722d5d7d6cc3556e9dbfd1802dac682c52856 2716588 sisu_3.0.0.orig.tar.gz 7cd26f5d70bb5bfac33d74dc69eb0d00bf5d3864612c984f5db3e1c2058635cb 1222 sisu_3.0.0-1.dsc 3a319dc5863742c3b2e461b19802b284dfdb51240771d7f9517d1761a2912d06 279707 sisu_3.0.0-1.debian.tar.gz NOTE: Processing defaults to v2, for v3 use 'sisu3' or 'sisu --v3' Versions 3 is experimental and attempts to introduce output more compatible with mobile devices and other non-web use and more internationalisation possibilities. NOTE: v3 branch opened, big patch, changes interim/incomplete (with possibility of breakage) primarily for: ebook-readers and other downloading viewers (alternative directory structures and use of title based filenames); internationalisation (use with po4a, export pot & po, alternative directory structures, use of git to ensure changes not lost). In v3 SiSU markup files may be organised in language directories that are given their language code. There are alternative output directory structures depending on whether you want: the v2 layout (mostly in a directory of the given filename/a generic filetype name); a monolingual version 3 layout, which organises files by filetype/given file name; multilingual v3 layout, which organises files by language code/filetype/given which is illustrated below * alternative output directory structures, configurable ├── en │   ├── epub │   ├── hashes │   ├── html │   │   └── live-manual │   ├── manifest │   ├── odt │   ├── pdf │   ├── sitemaps │   ├── txt │   ├── xhtml │   └── xml ├── fr │   ├── epub │   ├── hashes │   ├── html │   │   └── live-manual │   ├── manifest │   ├── odt │   ├── pdf │   ├── sitemaps │   ├── txt │   ├── xhtml │   └── xml ├── po4a │   └── live-manual │   ├── po │   │   └── fr │   └── pot └── _sisu ├── css ├── image ├── image_sys -> ../../_sisu/image_sys └── xml ├── rnc ├── rng └── xsd [FIX todo: * post rsync, * output url paths, * also processing of url, * processing of sisupod, * search db?, * search cgi ] * sisu processing possibility of using directory path and sisu source filename, rather than only content in current directory by filename [rc config rules are that if not processing from current directory, or directory above language sub-directory, will not find _sisu in sisu source file directory, but rather will use ~/.sisu if any or /etc/sisu] * po4a, work on * pot, po output from source language and translation * directory structure * alternative source directory structures: source and translation files organised either by existing file naming convention (file.sst filename~es.sst filname~fr.sst filename~de.sst), or; by placement in language subdirectories (that follow debian po4a language identification convention) ( ./en/file.sst ./es/file.sst ./fr/file.sst ./de/file.sst [./_sisu]) * process po4a source composite file (.ssm) together with its includes (.ssi and/or .sst), by identifying composite file to process ... includes are identified and processed as well [extensive testing required, initial tests passed on "free_culture" and "live-manual" and translations] * integrate use of git, ensure changes are not lost * sisupod git, revisiting * internationalize directory structure ├── conf │   └── skin ├── mm │   └── image ├── po4a │   ├── po │   │   ├── en │   │   └── fr │   └── pot └── src ├── en └── fr [FIX todo: sisu parsing, not sorted!, directory path parsing major step] * object, block text of='block' (instead of 'group'), introduce is='block' * dal_doc_str, dal_doc_objects, identify * dal_syntax, introduce block syntax block{ }block, like group * vim syntax highlighting, match block * related downstream changes (many files affected) Note: adjust output representation later [UGLY HACKS: po4a, en assumed as source lanuage, should be configurable po4a, only configured so far to recognise fr & es, fix po4a for processing .ssm .ssi, skipping of md title & author ] [FIX todo: directory structure for multilingual outputs breakage to epub, where src and trans dirs manifest decide what to do about source output & po4a & git ]