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