aboutsummaryrefslogtreecommitdiffhomepage
path: root/data/doc/sisu
diff options
context:
space:
mode:
Diffstat (limited to 'data/doc/sisu')
-rw-r--r--data/doc/sisu/CHANGELOG_v530
-rw-r--r--data/doc/sisu/CHANGELOG_v675
-rw-r--r--data/doc/sisu/markup-samples/manual/en/sisu_commands.sst14
-rw-r--r--data/doc/sisu/markup-samples/manual/en/sisu_markup.sst88
4 files changed, 193 insertions, 14 deletions
diff --git a/data/doc/sisu/CHANGELOG_v5 b/data/doc/sisu/CHANGELOG_v5
index 04a836fb..8126efab 100644
--- a/data/doc/sisu/CHANGELOG_v5
+++ b/data/doc/sisu/CHANGELOG_v5
@@ -31,6 +31,36 @@ v2 branch is removed; it is available in sisu =< 3.3.2
%% Reverse Chronological:
+%% 5.3.5.orig.tar.xz (2014-05-12:19/1)
+http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.3.5
+http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.3.5-1
+http://www.jus.uio.no/sisu/pkg/src/sisu_5.3.5.orig.tar.xz
+ sisu_5.3.5.orig.tar.xz
+ sisu_5.3.5-1.dsc
+
+* sisu, ensure return to start dir
+
+* ao_syntax, address possible manual use of url delimiters「」
+
+* composite, fix includes, provide extra newline after inserted comment
+ (Closes: #744360) "includes do not work properly"
+
+* composite (inserts), missing includes doesn't give an error, fix
+ (Closes: #744379) see sisu.org for comment
+
+* param, metadata add 'Copyright:' tag to output related to copyright
+ (Closes: #744381) syntax: inconsistency \:copyright: and \:license:
+
+* metadata, pdf, remove link to manifest page where --no-manifest is used
+ (Closes: #744378)
+
+* constants, db table sizes synced with v6, not needed by v5 but keeps tables
+ compatible
+
+* digests, cleaning
+
+* added sisu.org emacs:evil:org mode notes related to sisu development
+
%% 5.3.4.orig.tar.xz (2014-02-14:06/5)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.3.4
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.3.4-1
diff --git a/data/doc/sisu/CHANGELOG_v6 b/data/doc/sisu/CHANGELOG_v6
index 922c84fd..a103a9ed 100644
--- a/data/doc/sisu/CHANGELOG_v6
+++ b/data/doc/sisu/CHANGELOG_v6
@@ -21,6 +21,81 @@ v2 branch is removed; it is available in sisu =< 3.3.2
%% Reverse Chronological:
+%% 6.0.5.orig.tar.xz (2014-05-12:19/1)
+http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_6.0.5
+http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_6.0.5-1
+http://www.jus.uio.no/sisu/pkg/src/sisu_6.0.5.orig.tar.xz
+ sisu_6.0.5.orig.tar.xz
+ sisu_6.0.5-1.dsc
+
+* sisu, ensure return to start dir
+
+* ao, document structure check, stop processing on major error
+ (with error message & text at location of failure)
+
+* ao_syntax, address possible manual use of url delimiters「」
+
+* ao, heading with no ocn, distinguish ~# from -#
+ * ~# is general & means no ocn (for any object to which it is applied)
+ * -# is relevant only for 1~ dummy headings & instructs that they should be
+ removed from output where possible, applied so far to pdf, odt & plaintext
+
+* composite, fix includes, provide extra newline after inserted comment
+ (Closes: #744360) "includes do not work properly"
+
+* composite (inserts), missing includes doesn't give an error, fix
+ (Closes: #744379) see sisu.org for comment
+
+* param, metadata add 'Copyright:' tag to output related to copyright
+ (Closes: #744381) syntax: inconsistency \:copyright: and \:license:
+
+* param, remove trailing semicolon after :copyright:
+ (Closes: #744358)
+
+* metadata, pdf, remove link to manifest page where --no-manifest is used
+ (Closes: #744378)
+
+* digests, digests sha512 option implemented
+ * options sha512 sha256 md5
+ * command line --sha512
+ * rcconf.yml ['defsault']['digest'] = sha512
+ (Closes: #744402)
+
+* texpdf, (internal coding)
+ * use symbols to identify page orientation
+ * renaming related to fontface
+
+* texpdf, pdf colored hyperlinks configurable (cli & sisurc.yml)
+ --pdf-hyperlinks-color │
+ --pdf-hyperlinks-no-color or --pdf-hyperlinks-monochrome │
+ default:
+ pdf_hyperlinks: 'color' │
+ (other options switch hyperlink color off 'no-color' 'color-off' 'monochrome') │
+ (Closes: #744391) no color on a4 portrait │
+
+* texpdf, headings and table of contents
+
+* texpdf, pdf default font size configurable (cli & sisurc.yml) (no fractions)
+ --pdf-fontsize-12 --pdf-fontsize-8
+ default:
+ texpdf_fontsize: 12
+ (Closes: #744405)
+
+* texpdf, for urls switch to sans serif (small fontsize),
+ instead of typewriter, latex default
+ (Closes: #744353)
+
+* texpdf, mailto markup links set for normal text objects
+ (Closes: #744357) but testing required
+
+* texpdf, urls in creator cause breakage
+ (Closes: #744541)
+
+* texpdf, & in heading breaks toc, now & is removed from toc not heading,
+ broken
+
+* added sisu.org emacs:evil:org mode notes related to sisu development
+
%% 6.0.4.orig.tar.xz (2014-02-14:06/5)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_6.0.4
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_6.0.4-1
diff --git a/data/doc/sisu/markup-samples/manual/en/sisu_commands.sst b/data/doc/sisu/markup-samples/manual/en/sisu_commands.sst
index c1a0788a..356f38e1 100644
--- a/data/doc/sisu/markup-samples/manual/en/sisu_commands.sst
+++ b/data/doc/sisu/markup-samples/manual/en/sisu_commands.sst
@@ -321,6 +321,12 @@ generate examples of (naive) cgi search form for SQLite or PgSQL depends on your
!_ --scp [filename/wildcard] \\
copies sisu output files to remote host using scp. This requires that sisurc.yml has been provided with information on hostname and username, and that you have your "keys" and ssh agent in place. Also see --rsync. Alias -r
+!_ --sha256 \\
+set hash digest where used to sha256
+
+!_ --sha512 \\
+set hash digest where used to sha512
+
!_ --sqlite --[instruction] [filename] \\
database type set to SQLite, this produces one of two possible databases, without additional database related instructions it produces a discreet SQLite file for the document processed; with additional instructions it produces a common SQLite database of all processed documents that (come from the same document preparation directory and as a result) share the same output directory base path (possible instructions include: --createdb; --create; --dropall; --import [filename]; --update [filename]; --remove [filename]); see database section below. Alias -d
@@ -384,11 +390,11 @@ on its own, provides SiSU version information
!_ -v [filename/wildcard] \\
see --verbose
-!_ --v3 [filename/wildcard] \\
-invokes the sisu v3 document parser/generator. You may run sisu3 instead.
+!_ --v5 [filename/wildcard] \\
+invokes the sisu v5 document parser/generator. You may run sisu5 instead. This is the current default and is normally omitted.
-!_ --v4 [filename/wildcard] \\
-invokes the sisu v4 document parser/generator. This is the default and is normally omitted.
+!_ --v6 [filename/wildcard] \\
+invokes the sisu v6 document parser/generator. You may run sisu6 instead.
!_ --verbose [filename/wildcard] \\
provides verbose output of what is being generated, where output is placed (and error messages if any), as with -u flag provides a url mapping of files created for each of the processing flag requests. Alias -v
diff --git a/data/doc/sisu/markup-samples/manual/en/sisu_markup.sst b/data/doc/sisu/markup-samples/manual/en/sisu_markup.sst
index fbd6d1f4..e3eefbac 100644
--- a/data/doc/sisu/markup-samples/manual/en/sisu_markup.sst
+++ b/data/doc/sisu/markup-samples/manual/en/sisu_markup.sst
@@ -65,6 +65,82 @@ or if for a particular version:
_1 sisu --query-0.38
+2~ Markup Rules, document structure and metadata requirements
+
+minimal content/structure requirement:
+
+[metadata]
+
+@title:
+
+@creator:
+
+[levels]
+
+``` code
+A~ (level A [title])
+1~ (at least one level 1 [segment/(chapter)])
+```
+
+structure rules (document heirarchy, heading levels):
+
+there are two sets of heading levels ABCD (title & parts if any) and 123 (segment & subsegments if any)
+
+sisu has the fllowing levels:
+
+``` code
+A~ [title] .
+ required (== 1) followed by B~ or 1~
+B~ [part] *
+ followed by C~ or 1~
+C~ [subpart] *
+ followed by D~ or 1~
+D~ [subsubpart] *
+ followed by 1~
+1~ [segment (chapter)] +
+ required (>= 1) followed by text or 2~
+text *
+ followed by more text or 1~, 2~
+ or relevant part *()
+2~ [subsegment] *
+ followed by text or 3~
+text *
+ followed by more text or 1~, 2~ or 3~
+ or relevant part, see *()
+3~ [subsubsegment] *
+ followed by text
+text *
+ followed by more text or 1~, 2~ or 3~ or relevant part, see *()
+
+*(B~ if none other used;
+ if C~ is last used: C~ or B~;
+ if D~ is used: D~, C~ or B~)
+```
+
+``` code
+* level A~ is the tile and is mandatory
+* there can only be one level A~
+* heading levels BCD, are optional and there may be several of each
+ (where all three are used corresponding to e.g. Book Part Section)
+ * sublevels that are used must follow each other sequentially
+ (alphabetically),
+* heading levels A~ B~ C~ D~ are followed by other heading levels rather
+ than substantive text
+ which may be the subsequent sequential (alphabetic) heading part level
+ or a heading (segment) level 1~
+* there must be at least one heading (segment) level 1~
+ (the level on which the text is segmented, in a book would correspond
+ to the Chapter level)
+* additional heading levels 1~ 2~ 3~ are optional and there may be several
+ of each
+* heading levels 1~ 2~ 3~ are followed by text (which may be followed by
+ the same heading level)
+ and/or the next lower numeric heading level (followed by text)
+ or indeed return to the relevant part level
+ (as a corollary to the rules above substantive text/ content
+ must be preceded by a level 1~ (2~ or 3~) heading)
+```
+
2~ Markup Examples
3~ Online
@@ -1168,9 +1244,9 @@ To draw a dividing line dividing paragraphs, see the section on page breaks.
Page breaks are only relevant and honored in some output formats. A page break or a new page may be inserted manually using the following markup on a line on its own:
-page new =\\= or <:pn> breaks the page, starts a new page.
+page new =\\= (or <:pn>) breaks the page, starts a new page.
-page break -\\- or <:pb> breaks a column, starts a new column, if using columns, else breaks the page, starts a new page.
+page break -\\- (or <:pb>) breaks a column, starts a new column, if using columns, else breaks the page, starts a new page.
page break line across page -..- draws a dividing line, dividing paragraphs
@@ -1180,10 +1256,6 @@ code{
-\\-
-or
-
-<:pb>
-
}code
page (break) new:
@@ -1192,10 +1264,6 @@ code{
=\\=
-or
-
-<:pn>
-
}code
page (break) line across page (dividing paragraphs):
generated by cgit v1.2.3 (git 2.25.1) at 2024-11-09 09:43:04 +0000