diff options
Diffstat (limited to 'data/doc/manuals_generated/sisu_manual/sisu_configuration/scroll.xhtml')
| -rw-r--r-- | data/doc/manuals_generated/sisu_manual/sisu_configuration/scroll.xhtml | 467 |
1 files changed, 0 insertions, 467 deletions
diff --git a/data/doc/manuals_generated/sisu_manual/sisu_configuration/scroll.xhtml b/data/doc/manuals_generated/sisu_manual/sisu_configuration/scroll.xhtml deleted file mode 100644 index 38260ae7..00000000 --- a/data/doc/manuals_generated/sisu_manual/sisu_configuration/scroll.xhtml +++ /dev/null @@ -1,467 +0,0 @@ -<?xml version="1.0" encoding="UTF-8" standalone="no"?> -<?xml-stylesheet type="text/css" href="../_sisu/css/xhtml.css"?> -<!-- Document processing information: - * Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) - * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] - * - * Last Generated on: Tue Sep 25 02:54:03 +0100 2007 - * SiSU http://www.jus.uio.no/sisu ---> - -<document> -<head> - <meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> - <meta>Title:</meta> - <title class="dc"> - SiSU - Configuration - </title> - <br /> - <meta>Creator:</meta> - <creator class="dc"> - Ralph Amissah - </creator> - <br /> - <meta>Rights:</meta> - <rights class="dc"> - Ralph Amissah - </rights> - <br /> - <meta>Type:</meta> - <type class="dc"> - information - </type> - <br /> - <meta>Subject:</meta> - <subject class="dc"> - ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search - </subject> - <br /> - <meta>Date created:</meta> - <date_created class="extra"> - 2002-08-28 - </date_created> - <br /> - <meta>Date issued:</meta> - <date_issued class="extra"> - 2002-08-28 - </date_issued> - <br /> - <meta>Date available:</meta> - <date_available class="extra"> - 2007-08-28 - </date_available> - <br /> - <meta>Date modified:</meta> - <date_modified class="extra"> - 2007-08-30 - </date_modified> - <br /> - <meta>Date:</meta> - <date class="dc"> - 2007-08-30 - </date> - <br /> -</head> -<body> -<object id="1"> - <text class="h1"> - SiSU - Configuration,<br /> Ralph Amissah - </text> - <ocn>1</ocn> -</object> -<object id="2"> - <text class="h2"> - Configuration of Environment - </text> - <ocn>2</ocn> -</object> -<object id="3"> - <text class="h4"> - 1. Configuration - </text> - <ocn>3</ocn> -</object> -<object id="4"> - <text class="h5"> - 1.1 Determining the Current Configuration - </text> - <ocn>4</ocn> -</object> -<object id="5"> - <text class="norm"> - Information on the current configuration of <b>SiSU</b> should be -available with the help command: - </text> - <ocn>5</ocn> -</object> -<object id="6"> - <text class="indent1"> - sisu -v - </text> - <ocn>6</ocn> -</object> -<object id="7"> - <text class="norm"> - which is an alias for: - </text> - <ocn>7</ocn> -</object> -<object id="8"> - <text class="indent1"> - sisu --help env - </text> - <ocn>8</ocn> -</object> -<object id="9"> - <text class="norm"> - Either of these should be executed from within a directory that -contains sisu markup source documents. - </text> - <ocn>9</ocn> -</object> -<object id="10"> - <text class="h5"> - 1.2 Configuration files (config.yml) - </text> - <ocn>10</ocn> -</object> -<object id="11"> - <text class="norm"> - <b>SiSU</b> configration parameters are adjusted in the configuration -file, which can be used to override the defaults set. This includes -such things as which directory interim processing should be done in and -where the generated output should be placed. - </text> - <ocn>11</ocn> -</object> -<object id="12"> - <text class="norm"> - The <b>SiSU</b> configuration file is a yaml file, which means -indentation is significant. - </text> - <ocn>12</ocn> -</object> -<object id="13"> - <text class="norm"> - <b>SiSU</b> resource configuration is determined by looking at the -following files if they exist: - </text> - <ocn>13</ocn> -</object> -<object id="14"> - <text class="indent1"> - ./_sisu/sisurc.yml - </text> - <ocn>14</ocn> -</object> -<object id="15"> - <text class="indent1"> - ~/.sisu/sisurc.yml - </text> - <ocn>15</ocn> -</object> -<object id="16"> - <text class="indent1"> - /etc/sisu/sisurc.yml - </text> - <ocn>16</ocn> -</object> -<object id="17"> - <text class="norm"> - The search is in the order listed, and the first one found is used. - </text> - <ocn>17</ocn> -</object> -<object id="18"> - <text class="norm"> - In the absence of instructions in any of these it falls back to the -internal program defaults. - </text> - <ocn>18</ocn> -</object> -<object id="19"> - <text class="norm"> - Configuration determines the output and processing directories and the -database access details. - </text> - <ocn>19</ocn> -</object> -<object id="20"> - <text class="norm"> - If <b>SiSU</b> is installed a sample sisurc.yml may be found in -/etc/sisu/sisurc.yml - </text> - <ocn>20</ocn> -</object> -<object id="21"> - <text class="h2"> - Configuration of Documents - </text> - <ocn>21</ocn> -</object> -<object id="22"> - <text class="h4"> - 2. Skins - </text> - <ocn>22</ocn> -</object> -<object id="23"> - <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> - <ocn>23</ocn> -</object> -<object id="24"> - <text class="indent1"> - ./_sisu/skin - </text> - <ocn>24</ocn> -</object> -<object id="25"> - <text class="indent1"> - ~/.sisu/skin - </text> - <ocn>25</ocn> -</object> -<object id="26"> - <text class="indent1"> - /etc/sisu/skin - </text> - <ocn>26</ocn> -</object> -<object id="27"> - <text class="norm"> - <b>Within the skin directory</b> are the following the default -sub-directories for document skins: - </text> - <ocn>27</ocn> -</object> -<object id="28"> - <text class="indent1"> - ./skin/doc - </text> - <ocn>28</ocn> -</object> -<object id="29"> - <text class="indent1"> - ./skin/dir - </text> - <ocn>29</ocn> -</object> -<object id="30"> - <text class="indent1"> - ./skin/site - </text> - <ocn>30</ocn> -</object> -<object id="31"> - <text class="norm"> - A skin is placed in the appropriate directory and the file named -skin_[name].rb - </text> - <ocn>31</ocn> -</object> -<object id="32"> - <text class="norm"> - The skin itself is a ruby file which modifies the default appearances -set in the program. - </text> - <ocn>32</ocn> -</object> -<object id="33"> - <text class="h5"> - 2.1 Document Skin - </text> - <ocn>33</ocn> -</object> -<object id="34"> - <text class="norm"> - Documents take on a document skin, if the header of the document -specifies a skin to be used. - </text> - <ocn>34</ocn> -</object> -<object id="35"> - <ocn>35</ocn> - <text class="code"> -    @skin: skin_united_nations     - </text> -</object> -<object id="36"> - <text class="h5"> - 2.2 Directory Skin - </text> - <ocn>36</ocn> -</object> -<object id="37"> - <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> - <ocn>37</ocn> -</object> -<object id="38"> - <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> - <ocn>38</ocn> -</object> -<object id="39"> - <text class="h5"> - 2.3 Site Skin - </text> - <ocn>39</ocn> -</object> -<object id="40"> - <text class="norm"> - A site skin, modifies the program default skin. - </text> - <ocn>40</ocn> -</object> -<object id="41"> - <text class="h5"> - 2.4 Sample Skins - </text> - <ocn>41</ocn> -</object> -<object id="42"> - <text class="norm"> - With <b>SiSU</b> installed sample skins may be found in: - </text> - <ocn>42</ocn> -</object> -<object id="43"> - <text class="indent1"> - /etc/sisu/skin/doc and -/usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc - </text> - <ocn>43</ocn> -</object> -<object id="44"> - <text class="norm"> - (or equivalent directory) and if sisu-markup-samples is installed also -under: - </text> - <ocn>44</ocn> -</object> -<object id="45"> - <text class="indent1"> - /usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc - </text> - <ocn>45</ocn> -</object> -<object id="46"> - <text class="norm"> - Samples of list.yml and promo.yml (which are used to create the right -column list) may be found in: - </text> - <ocn>46</ocn> -</object> -<object id="47"> - <text class="indent1"> - /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or -equivalent directory) - </text> - <ocn>47</ocn> -</object> -<object id="48"> - <text class="h4"> - 3. Homepages - </text> - <ocn>48</ocn> -</object> -<object id="49"> - <text class="norm"> - <b>SiSU</b> is about the ability to auto-generate documents. Home pages -are regarded as custom built items, and are not created by <b>SiSU</b>. -More accurately, <b>SiSU</b> has a default home page, which will not be -appropriate for use with other sites, and the means to provide your own -home page instead in one of two ways as part of a site's configuration, -these being: - </text> - <ocn>49</ocn> -</object> -<object id="50"> - <text class="norm"> - 1. through placing your home page and other custom built documents in -the subdirectory _sisu/home/ (this probably being the easier and more -convenient option) - </text> - <ocn>50</ocn> -</object> -<object id="51"> - <text class="norm"> - 2. through providing what you want as the home page in a skin, - </text> - <ocn>51</ocn> -</object> -<object id="52"> - <text class="norm"> - Document sets are contained in directories, usually organised by site -or subject. Each directory can/should have its own homepage. See the -section on directory structure and organisation of content. - </text> - <ocn>52</ocn> -</object> -<object id="53"> - <text class="h5"> - 3.1 Home page and other custom built pages in a sub-directory - </text> - <ocn>53</ocn> -</object> -<object id="54"> - <text class="norm"> - Custom built pages, including the home page index.html may be placed -within the configuration directory _sisu/home/ in any of the locations -that is searched for the configuration directory, namely ./_sisu; -~/_sisu; /etc/sisu From there they are copied to the root of the -output directory with the command: - </text> - <ocn>54</ocn> -</object> -<object id="55"> - <text class="indent1"> - sisu -CC - </text> - <ocn>55</ocn> -</object> -<object id="56"> - <text class="h5"> - 3.2 Home page within a skin - </text> - <ocn>56</ocn> -</object> -<object id="57"> - <text class="norm"> - Skins are described in a separate section, but basically are a file -written in the programming language <b>Ruby</b> that may be provided to -change the defaults that are provided with sisu with respect to -individual documents, a directories contents or for a site. - </text> - <ocn>57</ocn> -</object> -<object id="58"> - <text class="norm"> - If you wish to provide a homepage within a skin the skin should be in -the directory _sisu/skin/dir and have the name of the directory for -which it is to become the home page. Documents in the directory -commercial_law would have the homepage modified in skin_commercial -law.rb; or the directory poems in skin_poems.rb - </text> - <ocn>58</ocn> -</object> -<object id="59"> - <ocn>59</ocn> - <text class="code"> -    class Home<br />   def homepage<br />   # place the html content of your homepage here, this will become index.html<br />   <<HOME <html><br />   <head></head><br />   <doc><br />   <p>this is my new homepage.</p><br />   </doc><br />   </html><br />   HOME<br />   end<br />   end     - </text> -</object> -</body> -</document> |