From 74849f94f8ddd536ea2d2c1618d129b2dc33efc1 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 7 Jul 2010 10:54:27 -0400 Subject: documentation, minor updates --- data/doc/sisu/v2/html/sisu.1.html | 76 +++++++++++++--------- .../v2/sisu_markup_samples/sisu_manual/sisu.ssm | 2 +- .../sisu_manual/sisu_commands.sst | 7 +- .../sisu_manual/sisu_markup.sst | 12 +++- 4 files changed, 59 insertions(+), 38 deletions(-) (limited to 'data/doc') diff --git a/data/doc/sisu/v2/html/sisu.1.html b/data/doc/sisu/v2/html/sisu.1.html index 207475d4..9d4b35d6 100644 --- a/data/doc/sisu/v2/html/sisu.1.html +++ b/data/doc/sisu/v2/html/sisu.1.html @@ -338,21 +338,30 @@ the individual files for sending). See the -S option without [filename/wildcard]
copies sisu markup file to output directory.

-
-t [filename/wildcard +
-T [filename/wildcard  (*.termsheet.rb)]
standard form document builder, preprocessing feature

+
-t [filename/wildcard]
+
produces plaintext with Unix linefeeds and without +markup, (object numbers are omitted), has footnotes at end of each paragraph +that contains them [  -A  for  equivalent  dos  (linefeed)  output  file] [see + -e  for (Options include: --endnotes for endnotes --footnotes for footnotes at +the end of each paragraph --unix for unix linefeed (default) --msdos for msdos +linefeed) +

+
-U [filename/wildcard]
-
prints url output list/map for the available processing -flags options and resulting files that could be requested, (can be used -to get a list of processing options in relation to a file, together with -information on the output that would be produced), -u provides url output -mapping for those flags requested for processing. The default assumes sisu_webrick -is running and provides webrick url mappings where appropriate, but these +
prints url output list/map for the available +processing flags options and resulting files that could be requested, (can +be used to get a list of processing options in relation to a file, together +with information on the output that would be produced), -u provides url +output mapping for those flags requested for processing. The default assumes +sisu_webrick is running and provides webrick url mappings where appropriate, -

can be switched to file system paths in sisurc.yml +

but these can be switched to file system paths in sisurc.yml

-u [filename/wildcard] @@ -907,7 +916,9 @@ html

markup example:


-

  normal text !{emphasis}! *{bold text}* _{underscore}_ /{italics}/
+
  normal text,  *{emphasis}*, !{bold text}!, /{italics}/, _{underscore}_,
+"{citation}",
+  ^{superscript}^, ,{subscript},, +{inserted text}+, -{strikethrough}- #{monospace}#
   normal text
   !{emphasis}!
   *{bold text}*
@@ -918,25 +929,27 @@ html
   ,{subscript},
   +{inserted text}+
   -{strikethrough}-
+  #{monospace}#
 

resulting output:

normal text emphasis bold text underscore italics -"citation" ^superscript^ [subscript] ++inserted text++ --strikethrough-- -

normal +"citation" ^superscript^ [subscript] ++inserted text++ --strikethrough-- monospace -

text -

emphasis +

normal text +

emphasis [note:  can  be  configured  to  be  represented  by + bold,  italics  or  underscore]

bold text -

underscore

italics +

underscore

"citation" -

^superscript^ +

^superscript^

[subscript]

++inserted text++

--strikethrough-- -

9.3 INDENTATION AND BULLETS +

monospace +

9.3 INDENTATION AND BULLETS

markup example:


@@ -1017,7 +1030,6 @@ asterisks if required }~ continues

normal text [^*3] continues

normal text [^+2] continues -

Alternative endnote pair notation for footnotes/endnotes:


@@ -1030,11 +1042,11 @@ asterisks if required }~ continues

9.5 LINKS

9.5.1 NAKED URLS WITHIN TEXT, DEALING WITH URLS -

urls are found -within text and marked up automatically. A url within text is automatically -hyperlinked to itself and by default decorated with angled braces, unless -they are contained within a code block (in which case they are passed as -normal text), or escaped by a preceding underscore (in which case the decoration +

urls found within +text are marked up automatically. A url within text is automatically hyperlinked +to itself and by default decorated with angled braces, unless they are +contained within a code block (in which case they are passed as normal +text), or escaped by a preceding underscore (in which case the decoration is omitted).

markup example:

@@ -1091,11 +1103,11 @@ block is used there is neither decoration nor hyperlinking, code blocks

  about {~^ SiSU }http://url.org markup
 

resulting output: -

aboutSiSU <http://www.jus.uio.no/sisu/ +

abou tSiSU <http://www.jus.uio.no/sisu/ > [^14] markup -

9.5.3 +

-

LINKING IMAGES +

9.5.3 LINKING IMAGES

markup example:


@@ -3305,23 +3317,23 @@ are authors’ works that while freely distributable are not freely changeab

Source digest:
-
MD5(sisu.ssm.sst)= fd741a3ccf160aa55b942d76bd4e3f2a +
SHA256(sisu.ssm.sst)= a704e4b934fba753bf594990673cdd43a974d405702b78a12788ba80b5021850

Generated by:
-
Generated by: SiSU 2.0.0 of 2010w09/6 (2010-03-06) +
Generated by: SiSU 2.6.0 of 2010w27/3 (2010-07-07)

Ruby version:
-
ruby 1.8.7 (2010-01-10 patchlevel 249) [i486-linux] +
ruby 1.8.7 (2010-06-23 patchlevel 299) [i486-linux]

Document (dal) last generated:
-

Wed Mar 17 13:34:15 -0400 2010 +

Wed Jul 07 09:33:25 -0400 2010

Other versions of this document:
@@ -3361,14 +3373,14 @@ are authors’ works that while freely distributable are not freely changeab
-
* Generated by: SiSU 2.0.0 of 2010w09/6 (2010-03-06)
+
* Generated by: SiSU 2.6.0 of 2010w27/3 (2010-07-07)
* Ruby version: ruby 1.8.7 -(2010-01-10 patchlevel 249) [i486-linux]
+(2010-06-23 patchlevel 299) [i486-linux]
-
* Last Generated on: Wed Mar 17 13:34:17 +
* Last Generated on: Wed Jul 07 09:33:28 -0400 2010
diff --git a/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu.ssm b/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu.ssm index 230c247c..c162db3f 100644 --- a/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu.ssm +++ b/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu.ssm @@ -19,7 +19,7 @@ :created: 2002-08-28 :issued: 2002-08-28 :available: 2002-08-28 - :modified: 2010-03-03 + :modified: 2010-07-07 @make: :num_top: 1 diff --git a/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu_commands.sst b/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu_commands.sst index 9e4417ea..a406dc57 100644 --- a/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu_commands.sst +++ b/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu_commands.sst @@ -19,7 +19,7 @@ :issued: 2002-08-28 :available: 2002-08-28 :published: 2007-09-16 - :modified: 2009-12-16 + :modified: 2010-07-07 @make: :num_top: 1 @@ -130,9 +130,12 @@ produces a zipped file of the prepared document specified along with associated !_ -s [filename/wildcard]
copies sisu markup file to output directory. -!_ -t [filename/wildcard (*.termsheet.rb)]
+!_ -T [filename/wildcard (*.termsheet.rb)]
standard form document builder, preprocessing feature +!_ -t [filename/wildcard]
+produces plaintext with Unix linefeeds and without markup, (object numbers are omitted), has footnotes at end of each paragraph that contains them [ -A for equivalent dos (linefeed) output file] [see -e for endnotes]. (Options include: --endnotes for endnotes --footnotes for footnotes at the end of each paragraph --unix for unix linefeed (default) --msdos for msdos linefeed) + !_ -U [filename/wildcard]
prints url output list/map for the available processing flags options and resulting files that could be requested, (can be used to get a list of processing options in relation to a file, together with information on the output that would be produced), -u provides url output mapping for those flags requested for processing. The default assumes sisu_webrick is running and provides webrick url mappings where appropriate, but these can be switched to file system paths in sisurc.yml diff --git a/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu_markup.sst b/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu_markup.sst index baae0855..331e6af5 100644 --- a/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu_markup.sst +++ b/data/doc/sisu/v2/sisu_markup_samples/sisu_manual/sisu_markup.sst @@ -22,7 +22,7 @@ :issued: 2002-08-28 :available: 2002-08-28 :published: 2008-05-22 - :modified: 2010-05-25 + :modified: 2010-07-07 @make: :num_top: 1 @@ -330,7 +330,8 @@ code{ code{ -normal text, *{emphasis}*, !{bold text}!, /{italics}/, _{underscore}_, "{citation}", ^{superscript}^, ,{subscript},, +{inserted text}+, -{strikethrough}- +normal text, *{emphasis}*, !{bold text}!, /{italics}/, _{underscore}_, "{citation}", +^{superscript}^, ,{subscript},, +{inserted text}+, -{strikethrough}- #{monospace}# normal text @@ -352,11 +353,14 @@ _{underscore}_ -{strikethrough}- +#{monospace}# + }code !_ resulting output: -normal text, *{emphasis}*, !{bold text}!, /{italics}/, _{underscore}_, "{citation}", ^{superscript}^, ,{subscript},, +{inserted text}+, -{strikethrough}- +normal text, *{emphasis}*, !{bold text}!, /{italics}/, _{underscore}_, "{citation}", +^{superscript}^, ,{subscript},, +{inserted text}+, -{strikethrough}- #{monospace}# normal text @@ -378,6 +382,8 @@ _{underscore}_ -{strikethrough}- +#{monospace}# + 2~ Indentation and bullets !_ markup example: -- cgit v1.2.3 From 3b080ad4b340075ba0a10747cb78c643e5da72fc Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 7 Jul 2010 10:55:50 -0400 Subject: sisu version & changelog --- data/doc/sisu/v1/CHANGELOG | 8 ++++++++ data/doc/sisu/v2/CHANGELOG | 22 ++++++++++++++++++++++ 2 files changed, 30 insertions(+) (limited to 'data/doc') diff --git a/data/doc/sisu/v1/CHANGELOG b/data/doc/sisu/v1/CHANGELOG index 4b48f34f..28b9ae5c 100644 --- a/data/doc/sisu/v1/CHANGELOG +++ b/data/doc/sisu/v1/CHANGELOG @@ -12,6 +12,14 @@ Reverse Chronological: %% STABLE MANIFEST +%% 1.0.4.orig.tar.gz (2010-02-17:07/3) [2010-07-07] +http://www.jus.uio.no/sisu/pkg/src/sisu_1.0.3.orig.tar.gz + sisu_1.0.3.orig.tar.gz + sisu_1.0.3-1.dsc + sisu_1.0.3-1.diff.gz + + * sysenv, version.yml moved to /usr/share/sisu/v1/v (from /etc/sisu) + %% 2.0.0.orig.tar.gz (2010-03-06:09/6) http://www.jus.uio.no/sisu/pkg/src/sisu_2.0.0.orig.tar.gz sisu_2.0.0.orig.tar.gz diff --git a/data/doc/sisu/v2/CHANGELOG b/data/doc/sisu/v2/CHANGELOG index a47cebed..2bdacb95 100644 --- a/data/doc/sisu/v2/CHANGELOG +++ b/data/doc/sisu/v2/CHANGELOG @@ -12,6 +12,28 @@ Reverse Chronological: %% Development branch UNSTABLE +%% 2.6.0.orig.tar.gz (2010-07-07:27/3) +http://www.jus.uio.no/sisu/pkg/src/sisu_2.6.0.orig.tar.gz + sisu_2.6.0.orig.tar.gz + sisu_2.6.0-1.dsc + sisu_2.6.0-1.diff.gz + + * sysenv, version.yml moved to /usr/share/sisu/v2/v (from /etc/sisu) + + * provide alternative sisu command names for producing single output types + sisu-pdf, sisu-html, sisu-odf, sisu-epub, sisu-txt + + * monospace + * dal_syntax, constants, introduce #{ monospace }# tag + * monospace font for codeblocks and #{ monospace }# tag + * vim syntax, recognize #{ monospace }# tag + + * hub, make -t produce plaintext output + + * sysenv, make output directory if needed (if possible) + + * texpdf_format, output special characters, special circumstance fix + %% 2.5.1.orig.tar.gz (2010-06-12:23/6) http://www.jus.uio.no/sisu/pkg/src/sisu_2.5.1.orig.tar.gz c87a04a3071de4e8388b214fb6bb1a602657c5859a817bd0f001c92a4ce1f98d 2768984 sisu_2.5.1.orig.tar.gz -- cgit v1.2.3 From a058f50dc234dd4a47bf77db3f727071de8b9ccd Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 7 Jul 2010 11:07:00 -0400 Subject: provide alternative sisu command names sisu-pg & sisu-sqlite --- data/doc/sisu/v2/CHANGELOG | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'data/doc') diff --git a/data/doc/sisu/v2/CHANGELOG b/data/doc/sisu/v2/CHANGELOG index 2bdacb95..9eab9539 100644 --- a/data/doc/sisu/v2/CHANGELOG +++ b/data/doc/sisu/v2/CHANGELOG @@ -21,7 +21,7 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_2.6.0.orig.tar.gz * sysenv, version.yml moved to /usr/share/sisu/v2/v (from /etc/sisu) * provide alternative sisu command names for producing single output types - sisu-pdf, sisu-html, sisu-odf, sisu-epub, sisu-txt + sisu-pdf, sisu-html, sisu-odf, sisu-epub, sisu-txt sisu-pg sisu-sqlite * monospace * dal_syntax, constants, introduce #{ monospace }# tag -- cgit v1.2.3 From fd20f4a7a44586a07a1c0cb0125a0e77dbd0d872 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 7 Jul 2010 20:05:43 -0400 Subject: some cleaning of default outputs, ongoing --- data/doc/sisu/v2/CHANGELOG | 2 ++ 1 file changed, 2 insertions(+) (limited to 'data/doc') diff --git a/data/doc/sisu/v2/CHANGELOG b/data/doc/sisu/v2/CHANGELOG index 9eab9539..4f0506cf 100644 --- a/data/doc/sisu/v2/CHANGELOG +++ b/data/doc/sisu/v2/CHANGELOG @@ -34,6 +34,8 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_2.6.0.orig.tar.gz * texpdf_format, output special characters, special circumstance fix + * outputs, some cleaning of default outputs ... ongoing + %% 2.5.1.orig.tar.gz (2010-06-12:23/6) http://www.jus.uio.no/sisu/pkg/src/sisu_2.5.1.orig.tar.gz c87a04a3071de4e8388b214fb6bb1a602657c5859a817bd0f001c92a4ce1f98d 2768984 sisu_2.5.1.orig.tar.gz -- cgit v1.2.3