From 50d45c6deb0afd2e4222d2e33a45487a9d1fa676 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Sun, 23 Sep 2007 05:16:21 +0100 Subject: primarily todo with sisu documentation, changelog reproduced below: * start documenting sisu using sisu * sisu markup source files in data/doc/sisu/sisu_markup_samples/sisu_manual/ /usr/share/doc/sisu/sisu_markup_samples/sisu_manual/ * default output [sisu -3] in data/doc/manuals_generated/sisu_manual/ /usr/share/doc/manuals_generated/sisu_manual/ (adds substantially to the size of sisu package!) * help related edits * manpage, work on ability to generate manpages, improved * param, exclude footnote mark count when occurs within code block * plaintext changes made * shared_txt, line wrap visited * file:// link option introduced (in addition to existing https?:// and ftp://) a bit arbitrarily, diff here, [double check changes in sysenv and hub] * minor adjustments * html url match refinement * css added tiny_center * plaintext * endnotes fix * footnote adjustment to make more easily distinguishable from substantive text * flag -a only [flags -A -e -E dropped] controlled by modifiers --unix/msdos --footnote/endnote * defaults, homepage * renamed homepage (instead of index) implications for modifying skins, which need likewise to have any homepage entry renamed * added link to sisu_manual in homepage * css the css for the default homepage is renamed homepage.css (instead of index.css) [consider removing this and relying on html.css] * ruby version < ruby1.9 * place stop on installation and working with for now [ruby String.strip broken in ruby 1.9.0 (2007-09-10 patchlevel 0) [i486-linux], 2007-09-18:38/2] * debian/control restrict use to ruby > 1.8.4 and ruby < 1.9 * debian * debian/control restrict use to ruby > 1.8.4 and ruby < 1.9 * sisu-doc new sub-package for sisu documentation debian/control and sisu-doc.install --- .../sisu_manual/sisu_skin/doc.html | 1080 ++++++++++++++++++++ 1 file changed, 1080 insertions(+) create mode 100644 data/doc/manuals_generated/sisu_manual/sisu_skin/doc.html (limited to 'data/doc/manuals_generated/sisu_manual/sisu_skin/doc.html') diff --git a/data/doc/manuals_generated/sisu_manual/sisu_skin/doc.html b/data/doc/manuals_generated/sisu_manual/sisu_skin/doc.html new file mode 100644 index 00000000..0fd011a7 --- /dev/null +++ b/data/doc/manuals_generated/sisu_manual/sisu_skin/doc.html @@ -0,0 +1,1080 @@ + + + + + + SiSU + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + +
+ +
SiSU -->
+
+ + + + + + + + + + + + + + + +
+ + Full Text  scroll  + + + + + TOC linked  toc  + + + + + + PDF portrait +   pdf  + + + + + + PDF landscape +   pdf  + + + + + + ODF/ODT  odt  + + + + + +   A-Z  + + + + + + Document Manifest  + + + + + @ +
+
+   +
+

+ +

+ +
+ + +
+ +

SiSU +

+ +

Skins [0.58] +

+ +

Ralph Amissah +

+ +copy @ + + SiSU + + +
+ + + +

Copyright ©  Ralph Amissah 2007, part of SiSU documentation, License GPL 3

+

+ +
+ +

+ SiSU - Skins [0.58],
Ralph Amissah
+

+ +

+ Document Skins - configuration +

+ +

+ 1. Skins +

+ +
+ 1.1 Document Skin +
+ +
+ 1.2 Directory Skin +
+ +
+ 1.3 Site Skin +
+ +
+ 1.4 Sample Skins +
+ +

+ Document Information (metadata) +

+ + + + +
+

+ + SiSU - Skins [0.58],
Ralph Amissah +

+
+

+   1 +

+
+ + + + +
+

+ + Document Skins - configuration +

+
+

+   2 +

+
+ + + + +
+

+ + 1. Skins +

+
+

+   3 +

+
+ + + + +
+

+ Skins modify the default appearance of document output on a document, directory, or site wide basis. Skins are looked for in the following locations: +

+
+

+   4 +

+
+ + + + +
+

+ ./_sisu/skin +

+
+

+   5 +

+
+ + + + +
+

+ ~/.sisu/skin +

+
+

+   6 +

+
+ + + + +
+

+ /etc/sisu/skin +

+
+

+   7 +

+
+ + + + +
+

+ Within the skin directory are the following the default sub-directories for document skins: +

+
+

+   8 +

+
+ + + + +
+

+ ./skin/doc +

+
+

+   9 +

+
+ + + + +
+

+ ./skin/dir +

+
+

+   10 +

+
+ + + + +
+

+ ./skin/site +

+
+

+   11 +

+
+ + + + +
+

+ A skin is placed in the appropriate directory and the file named skin_[name].rb +

+
+

+   12 +

+
+ + + + +
+

+ The skin itself is a ruby file which modifies the default appearances set in the program. +

+
+

+   13 +

+
+ + + + +
+
+ + 1.1 Document Skin +
+
+

+   14 +

+
+ + + + +
+

+ Documents take on a document skin, if the header of the document specifies a skin to be used. +

+
+

+   15 +

+
+ + + + +
+

+ +  @skin: skin_united_nations + +

+
+

+   16 +

+
+ + + + +
+
+ + 1.2 Directory Skin +
+
+

+   17 +

+
+ + + + +
+

+ A directory may be mapped on to a particular skin, so all documents within that directory take on a particular appearance. If a skin exists in the skin/dir with the same name as the document directory, it will automatically be used for each of the documents in that directory, (except where a document specifies the use of another skin, in the skin/doc directory). +

+
+

+   18 +

+
+ + + + +
+

+ A personal habit is to place all skins within the doc directory, and symbolic links as needed from the site, or dir directories as required. +

+
+

+   19 +

+
+ + + + +
+
+ + 1.3 Site Skin +
+
+

+   20 +

+
+ + + + +
+

+ A site skin, modifies the program default skin. +

+
+

+   21 +

+
+ + + + +
+
+ + 1.4 Sample Skins +
+
+

+   22 +

+
+ + + + +
+

+ With SiSU installed sample skins may be found in: +

+
+

+   23 +

+
+ + + + +
+

+ /etc/sisu/skin/doc and /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc +

+
+

+   24 +

+
+ + + + +
+

+ (or equivalent directory) and if sisu-markup-samples is installed also under: +

+
+

+   25 +

+
+ + + + +
+

+ /usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc +

+
+

+   26 +

+
+ + + + +
+

+ Samples of list.yml and promo.yml (which are used to create the right column list) may be found in: +

+
+

+   27 +

+
+ + + + +
+

+ /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent directory) +

+
+

+   28 +

+
+ + + +
+ +

+


+

+   +
+ + + + +
+

+ + Document Information (metadata) +

+
+

+   0 +

+
+ +

+ Metadata +

+ + +     + + + + + +
+

+ <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html> +

+
+ + + +
+

+ Dublin Core (DC) +

+
+ + + +
+

+ DC tags included with this document are provided here. +

+
+ + + +
+

+ DC Title: SiSU - Skins [0.58] +

+
+ + + +
+

+ DC Creator: Ralph Amissah +

+
+ + + +
+

+ DC Rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 +

+
+ + + +
+

+ DC Type: information +

+
+ + + +
+

+ DC Date created: 2002-11-12 +

+
+ + + +
+

+ DC Date issued: 2002-11-12 +

+
+ + + +
+

+ DC Date available: 2002-11-12 +

+
+ + + +
+

+ DC Date modified: 2007-09-16 +

+
+ + + +
+

+ DC Date: 2007-09-16 +

+
+ + + +
+

+ Version Information +

+
+ + + +
+

+ Sourcefile: sisu_skin.sst +

+
+ + + +
+

+ Filetype: SiSU text insert 0.58 +

+
+ + + +
+

+ Sourcefile Digest, MD5(sisu_skin.sst)= 3686b1b7864132c8d6ab3b0398d6e2ae +

+
+ + + +
+

+ Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= 20fc43cf3eb6590bc3399a1aef65c5a9 +

+
+ + + +
+

+ Generated +

+
+ + + +
+

+ Document (metaverse) last generated: Sun Sep 23 04:11:00 +0100 2007 +

+
+ + + +
+

+ Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) +

+
+ + + +
+

+ Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] +

+
+ + + + + +
+ +
SiSU -->
+
+ + + + + + + + + + + + + + + +
+ + Full Text  scroll  + + + + + TOC linked  toc  + + + + + + PDF portrait +   pdf  + + + + + + PDF landscape +   pdf  + + + + + + ODF/ODT  odt  + + + + + +   A-Z  + + + + + + Document Manifest  + + + + + @ +
+
+   +
+

+ + + + + + + + +
+ +
+

+ + SiSU + +

+
+ +

+ Output generated by + + SiSU + + 0.59.0 2007-09-23 (2007w38/0) +
+ + SiSU + + Copyright © Ralph Amissah + 1997, current 2007. + All Rights Reserved. +
+ + SiSU + + is software for document structuring, publishing and search, +
+ + www.jus.uio.no/sisu + + and + + www.sisudoc.org + +
+ w3 since October 3 1993 + + ralph@amissah.com + +

+
+

+ SiSU using: +
Standard SiSU markup syntax, +
Standard SiSU meta-markup syntax, and the +
Standard SiSU object citation numbering and system, (object/text positioning system) +
+ Copyright © Ralph Amissah 1997, current 2007. + All Rights Reserved. +

+
+

+ + GPLv3 + +

+
+

+ + SiSU + + is released under + GPLv3 + or later, + <http://www.gnu.org/licenses/gpl.html> +

+
+

+ SiSU, developed using + + Ruby + + on + + Debian/Gnu/Linux + + software infrastructure, + with the usual GPL (or OSS) suspects. +
+ Better - "performance, reliability, scalability, security & total cost of ownership" + [not to mention flexibility & choice] use of and adherence to open standards (where practical and fair) and it is software libre. +
+ Get With the Future + + Way Better! + +

+
+ + + + + + + +

+ +
+
+ + +
+ + +
+ + + + idx + txt + + +
+
+ +
+

+ + +SiSU manual + +

+ + + + + + + + + + + +
+

+ + +SiSU + +

+ + + + + + + + + + + + + + + + +
+ + + + -- cgit v1.2.3