aboutsummaryrefslogtreecommitdiffhomepage
path: root/data/doc/manuals_generated/sisu_manual/sisu_skin/dom.xml
diff options
context:
space:
mode:
authorRalph Amissah <ralph@amissah.com>2007-09-23 05:16:21 +0100
committerRalph Amissah <ralph@amissah.com>2007-09-23 05:16:21 +0100
commit50d45c6deb0afd2e4222d2e33a45487a9d1fa676 (patch)
tree100c62d678f009139999bf77c26c81653a721eeb /data/doc/manuals_generated/sisu_manual/sisu_skin/dom.xml
parentsisu-0.58.3 + md5s (diff)
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
Diffstat (limited to 'data/doc/manuals_generated/sisu_manual/sisu_skin/dom.xml')
-rw-r--r--data/doc/manuals_generated/sisu_manual/sisu_skin/dom.xml427
1 files changed, 427 insertions, 0 deletions
diff --git a/data/doc/manuals_generated/sisu_manual/sisu_skin/dom.xml b/data/doc/manuals_generated/sisu_manual/sisu_skin/dom.xml
new file mode 100644
index 00000000..f50261a5
--- /dev/null
+++ b/data/doc/manuals_generated/sisu_manual/sisu_skin/dom.xml
@@ -0,0 +1,427 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<?xml-stylesheet type="text/css" href="../_sisu/css/dom.css"?>
+<!-- Document processing information:
+ * 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]
+ *
+ * Last Generated on: Sun Sep 23 04:12:10 +0100 2007
+ * SiSU http://www.jus.uio.no/sisu
+-->
+
+<document>
+
+<head>
+
+ <header>
+ <meta>Title:</meta>
+ <title>
+ SiSU - Skins [0.58]
+ </title>
+ </header>
+
+ <header>
+ <meta>Creator:</meta>
+ <creator>
+ Ralph Amissah
+ </creator>
+ </header>
+
+ <header>
+ <meta>Rights:</meta>
+ <rights>
+ Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
+ </rights>
+ </header>
+
+ <header>
+ <meta>Type:</meta>
+ <type>
+ information
+ </type>
+ </header>
+
+ <header>
+ <meta>Subject:</meta>
+ <subject>
+ ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search
+ </subject>
+ </header>
+
+ <header>
+ <meta>Date created:</meta>
+ <date_created>
+ 2002-11-12
+ </date_created>
+ </header>
+
+ <header>
+ <meta>Date issued:</meta>
+ <date_issued>
+ 2002-11-12
+ </date_issued>
+ </header>
+
+ <header>
+ <meta>Date available:</meta>
+ <date_available>
+ 2002-11-12
+ </date_available>
+ </header>
+
+ <header>
+ <meta>Date modified:</meta>
+ <date_modified>
+ 2007-09-16
+ </date_modified>
+ </header>
+
+ <header>
+ <meta>Date:</meta>
+ <date>
+ 2007-09-16
+ </date>
+ </header>
+
+
+
+
+
+
+</head>
+
+<body>
+
+<heading1>
+ <heading>
+ <object id="1">
+ <ocn>1</ocn>
+ <text>SiSU - Skins [0.58],<br /> Ralph Amissah</text>
+ </object>
+ </heading>
+
+ <heading2>
+ <heading>
+ <object id="2">
+ <ocn>2</ocn>
+ <text>Document Skins - configuration</text>
+ </object>
+ </heading>
+
+ <contents1>
+ <heading>
+ <object id="3">
+ <ocn>3</ocn>
+ <nametag>skins</nametag>
+
+ <text>1. Skins </text>
+ </object>
+ </heading>
+ <content>
+
+ <object id="4">
+
+
+ <ocn>4</ocn>
+
+
+ <text class="norm">Skins modify the default appearance of document output on a document, directory, or site wide basis. Skins are looked for in the following locations:</text>
+
+ </object>
+
+
+ <object id="5">
+
+
+ <ocn>5</ocn>
+
+
+ <text class="indent1"> ./_sisu/skin</text>
+
+ </object>
+
+
+ <object id="6">
+
+
+ <ocn>6</ocn>
+
+
+ <text class="indent1"> &#126;/.sisu/skin</text>
+
+ </object>
+
+
+ <object id="7">
+
+
+ <ocn>7</ocn>
+
+
+ <text class="indent1"> /etc/sisu/skin</text>
+
+ </object>
+
+
+ <object id="8">
+
+
+ <ocn>8</ocn>
+
+
+ <text class="norm"><b>Within the skin directory</b> are the following the default sub-directories for document skins:</text>
+
+ </object>
+
+
+ <object id="9">
+
+
+ <ocn>9</ocn>
+
+
+ <text class="indent1"> ./skin/doc</text>
+
+ </object>
+
+
+ <object id="10">
+
+
+ <ocn>10</ocn>
+
+
+ <text class="indent1"> ./skin/dir</text>
+
+ </object>
+
+
+ <object id="11">
+
+
+ <ocn>11</ocn>
+
+
+ <text class="indent1"> ./skin/site</text>
+
+ </object>
+
+
+ <object id="12">
+
+
+ <ocn>12</ocn>
+
+
+ <text class="norm">A skin is placed in the appropriate directory and the file named skin_[name].rb</text>
+
+ </object>
+
+
+ <object id="13">
+
+
+ <ocn>13</ocn>
+
+
+ <text class="norm">The skin itself is a ruby file which modifies the default appearances set in the program.</text>
+
+ </object>
+
+
+ </content>
+
+ <contents2>
+ <heading>
+ <object id="14">
+ <ocn>14</ocn>
+ <nametag>1.1</nametag>
+
+ <text>1.1 Document Skin</text>
+ </object>
+ </heading>
+ <content>
+
+ <object id="15">
+
+
+ <ocn>15</ocn>
+
+
+ <text class="norm">Documents take on a document skin, if the header of the document specifies a skin to be used.</text>
+
+ </object>
+
+
+ <object id="16">
+
+
+ <ocn>16</ocn>
+
+
+ <text class="code">
+
+ &#160;&#160; &nbsp;&nbsp;@skin: skin_united_nations&#160;&#160;&#160;&#160;
+
+ </text>
+
+ </object>
+
+
+ </content>
+
+ </contents2>
+
+ <contents2>
+ <heading>
+ <object id="17">
+ <ocn>17</ocn>
+ <nametag>1.2</nametag>
+
+ <text>1.2 Directory Skin</text>
+ </object>
+ </heading>
+ <content>
+
+ <object id="18">
+
+
+ <ocn>18</ocn>
+
+
+ <text class="norm">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).</text>
+
+ </object>
+
+
+ <object id="19">
+
+
+ <ocn>19</ocn>
+
+
+ <text class="norm">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.</text>
+
+ </object>
+
+
+ </content>
+
+ </contents2>
+
+ <contents2>
+ <heading>
+ <object id="20">
+ <ocn>20</ocn>
+ <nametag>1.3</nametag>
+
+ <text>1.3 Site Skin</text>
+ </object>
+ </heading>
+ <content>
+
+ <object id="21">
+
+
+ <ocn>21</ocn>
+
+
+ <text class="norm">A site skin, modifies the program default skin.</text>
+
+ </object>
+
+
+ </content>
+
+ </contents2>
+
+ <contents2>
+ <heading>
+ <object id="22">
+ <ocn>22</ocn>
+ <nametag>1.4</nametag>
+
+ <text>1.4 Sample Skins</text>
+ </object>
+ </heading>
+ <content>
+
+ <object id="23">
+
+
+ <ocn>23</ocn>
+
+
+ <text class="norm">With <b>SiSU</b> installed sample skins may be found in:</text>
+
+ </object>
+
+
+ <object id="24">
+
+
+ <ocn>24</ocn>
+
+
+ <text class="indent1"> /etc/sisu/skin/doc and /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc</text>
+
+ </object>
+
+
+ <object id="25">
+
+
+ <ocn>25</ocn>
+
+
+ <text class="norm">(or equivalent directory) and if sisu-markup-samples is installed also under:</text>
+
+ </object>
+
+
+ <object id="26">
+
+
+ <ocn>26</ocn>
+
+
+ <text class="indent1"> /usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc</text>
+
+ </object>
+
+
+ <object id="27">
+
+
+ <ocn>27</ocn>
+
+
+ <text class="norm">Samples of list.yml and promo.yml (which are used to create the right column list) may be found in:</text>
+
+ </object>
+
+
+ <object id="28">
+
+
+ <ocn>28</ocn>
+
+
+ <text class="indent1"> /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent directory)</text>
+
+ </object>
+
+
+ </content>
+ </contents2>
+
+
+ </contents1>
+
+ </heading2>
+
+</heading1>
+
+</body>
+
+</document>
+