aboutsummaryrefslogtreecommitdiffhomepage
path: root/data/doc
diff options
context:
space:
mode:
Diffstat (limited to 'data/doc')
-rw-r--r--data/doc/sisu/html/sisu.1.html41
-rw-r--r--data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst6
-rw-r--r--data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst4
-rw-r--r--data/doc/sisu/sisu_markup_samples/dfsg/gpl3.fsf.sst4
-rw-r--r--data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm4
-rw-r--r--data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst16
6 files changed, 48 insertions, 27 deletions
diff --git a/data/doc/sisu/html/sisu.1.html b/data/doc/sisu/html/sisu.1.html
index 1848611b..25b6e7e4 100644
--- a/data/doc/sisu/html/sisu.1.html
+++ b/data/doc/sisu/html/sisu.1.html
@@ -723,13 +723,13 @@ up files are available as html with syntax highlighting for viewing: &lt;<a href
<p>/usr/share/doc/sisu/sisu_markup_samples/non-free
<p> 8. MARKUP OF HEADERS
<p>
- Headers consist of semantic meta-data about a document, which can be used
-by any output module of the program; and may in addition include extra
-processing instructions.
-<p> Note: the first line of a document may include
-information on the markup version used in the form of a comment. Comments
-are a percentage mark at the start of a paragraph (and as the first character
-in a line of text) followed by a space and the comment:
+ Headers contain either: semantic meta-data about a document, which can
+be used by any output module of the program, or; processing instructions.
+
+<p> Note: the first line of a document may include information on the markup
+version used in the form of a comment. Comments are a percentage mark at
+the start of a paragraph (and as the first character in a line of text)
+followed by a space and the comment:
<p>
<p> <br>
<pre> % this would be a comment
@@ -742,18 +742,25 @@ one (without the comments):
<pre> % SiSU 0.57
@title: SiSU
@subtitle: Markup
- @creator: Ralph Amissah
+ @creator: Amissah, Ralph
+ % note formatting on author / creator field, surname comma then other
+names, if more than one author separate using semi-colon
@rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation,
License GPL 3
@type: information
@subject: ebook, epublishing, electronic book, electronic publishing,
electronic document, electronic citation, data structure, citation systems,
search
+ @topic_register: text markup language; application:text processing;output:html|xml|latex|pdf|sql
+ % note formatting for topic_register topic levels are separated by a
+colon, a semi-colon separates main topics
+ @date: 2007-09-16
+ % original publication date unless the substantive text is updated/modified,
+then date of update
@date.created: 2002-08-28
@date.issued: 2002-08-28
@date.available: 2002-08-28
@date.modified: 2007-09-16
- @date: 2007-09-16
@level: new=C; break=1; num_top=1
% comment: in this @level header num_top=1 starts automatic heading numbering
at heading level 1 (numbering continues 3 levels down); the new and break
@@ -1147,17 +1154,17 @@ is used there is neither decoration nor hyperlinking, code blocks are discussed
<p> <b>markup example:</b>
<p>
<p> <br>
-<pre> &nbsp;[ tux.png ]
+<pre> { tux.png 64x80 }image
% various url linked images
- &nbsp;[ tux.png ]
- &nbsp;[ GnuDebianLinuxRubyBetterWay.png ]
+ {tux.png 64x80
+ {GnuDebianLinuxRubyBetterWay.png 100x101
{~^ ruby_logo.png
</pre>
<p> <b>resulting output:</b>
<p> [ tux.png ]
<p> tux.png 64x80
<p> [ &nbsp;ruby_logo &nbsp;(png &nbsp;missing)
-&nbsp;] &nbsp;[^14]
+&nbsp;] [^14]
<p> GnuDebianLinuxRubyBetterWay.png 100x101 and Ruby
<p> <b>linked url footnote
@@ -3378,15 +3385,15 @@ of this document: </dt>
</dt>
<dd></dd>
-<dt>* Generated by: SiSU 0.68.0 of 2008w29/1 (2008-07-21) </dt>
+<dt>* Generated by: SiSU 0.70.0 of 2008w48/3 (2008-12-03) </dt>
<dd></dd>
<dt>* Ruby version: ruby
-1.8.7 (2008-06-20 patchlevel 22) [i486-linux] </dt>
+1.8.7 (2008-08-11 patchlevel 72) [i486-linux] </dt>
<dd></dd>
-<dt>* Last Generated on: Mon Jul 21
-02:54:35 -0400 2008 </dt>
+<dt>* Last Generated on: Tue Dec 09
+12:24:07 -0500 2008 </dt>
<dd></dd>
<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst b/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst
index 503e6a6d..74b90a4f 100644
--- a/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst
@@ -4,10 +4,14 @@
@subtitle: Richard Stallman's Crusade for Free Software
-@author: Sam Williams
+@author: Williams, Sam
@rights: Copyright (C) Sam Williams 2002, published under the GNU Free Documentation License. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Document License, Version 1.1 or any later version published by the Free Software Foundation; with the Invariant Sections being no invariant sections, with the Front-Cover Texts being no invariant sections, and with the Back-Cover Texts being no invariant sections. A copy of the license is included in Appendix C, GNU Free Documentation License. All images are to be included verbatim when the document is copied, distributed, or modified under the terms of the GFDL.
+@topic_register: SiSU:markup sample:book;copyright;GNU/Linux:GPL|copyleft|free software;free software;Software:Software Libré;GPL;Linux:GNU|Software Libré;book:biography
+
+@date: 2002
+
@language: US
@notes: March 2002
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst b/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst
index dfabc14e..b091616b 100644
--- a/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst
@@ -6,6 +6,10 @@
@rights: Copyright Copyright 1989, 1991 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+@date: 1991
+
+@topic_register: GPL;Software:license;GNU/Linux:License:GPL
+
@links: {Free Software Foundation}http://www.fsf.org
{GPL @ SiSU}http://www.jus.uio.no/sisu/gpl2.fsf
{Markup}http://www.jus.uio.no/sisu/sample/markup/gpl2.fsf.sst
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/gpl3.fsf.sst b/data/doc/sisu/sisu_markup_samples/dfsg/gpl3.fsf.sst
index 358accce..10889acf 100644
--- a/data/doc/sisu/sisu_markup_samples/dfsg/gpl3.fsf.sst
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/gpl3.fsf.sst
@@ -6,6 +6,8 @@ SiSU 0.52
@rights: Copyright (C) 2007 Free Software Foundation, Inc. http://fsf.org/ Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+@topic_register: GPL;Software:license
+
@date: 2007-06-29
@date.available: 2007-06-29
@@ -242,7 +244,7 @@ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY C
If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.
-END OF TERMS AND CONDITIONS
+!_ END OF TERMS AND CONDITIONS
1~ How to Apply These Terms to Your New Programs
diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm
index 676e23d7..9e891fcb 100644
--- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm
@@ -18,9 +18,9 @@
@date.available: 2002-08-28
-@date.modified: 2008-05-22
+@date.modified: 2008-12-14
-@date: 2008-05-22
+@date: 2008-12-14
@level: new=C; break=1; num_top=1
diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
index 292bfe13..dd620872 100644
--- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
@@ -10,17 +10,19 @@
@type: information
+@topic_register: SiSU:manual:sisu markup
+
@subject: ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search
+@date: 2008-12-14
+
@date.created: 2002-08-28
@date.issued: 2002-08-28
@date.available: 2002-08-28
-@date.modified: 2008-05-22
-
-@date: 2008-05-22
+@date.modified: 2008-12-14
@level: new=C; break=1; num_top=1
@@ -127,7 +129,7 @@ code{
@creator: Amissah, Ralph
-% note formatting on author / creator field, surname comma then other names, if more than one author separate by semi-colon
+% note formatting rules on author / creator field, "Surname, Other names", if more than one author separate by semi-colon (if name is of an institution just write name or the name contains a comma enclose in quotation marks)
@rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
@@ -139,6 +141,10 @@ code{
% note formatting for topic_register topic levels are separated by a colon, a semi-colon separates main topics
+@date: 2007-09-16
+
+% original publication date unless the substantive text is updated/modified, then date of update
+
@date.created: 2002-08-28
@date.issued: 2002-08-28
@@ -147,8 +153,6 @@ code{
@date.modified: 2007-09-16
-@date: 2007-09-16
-
@level: new=C; break=1; num_top=1
% comment: in this @level header num_top=1 starts automatic heading numbering at heading level 1 (numbering continues 3 levels down); the new and break instructions are used by the LaTeX/pdf and odf output to determine where to put page breaks (that are not used by html output or say sql database population).