diff options
Diffstat (limited to 'data/doc/manuals_generated/sisu_manual/sisu_manual/howto_setup_post_installation.html')
| -rw-r--r-- | data/doc/manuals_generated/sisu_manual/sisu_manual/howto_setup_post_installation.html | 326 |
1 files changed, 163 insertions, 163 deletions
diff --git a/data/doc/manuals_generated/sisu_manual/sisu_manual/howto_setup_post_installation.html b/data/doc/manuals_generated/sisu_manual/sisu_manual/howto_setup_post_installation.html index 1a677d08..39b781ac 100644 --- a/data/doc/manuals_generated/sisu_manual/sisu_manual/howto_setup_post_installation.html +++ b/data/doc/manuals_generated/sisu_manual/sisu_manual/howto_setup_post_installation.html @@ -23,7 +23,7 @@ <meta name="dc.language" content="English" /> <meta name="dc.rights" content="Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3" /> - <meta name="generator" content="SiSU 0.59.0 of 2007w38/0 (2007-09-23) (n*x and Ruby!)" /> + <meta name="generator" content="SiSU 0.59.1 of 2007w39/2 (2007-09-25) (n*x and Ruby!)" /> <link rel="generator" href="http://www.jus.uio.no/sisu" /> <link rel="shortcut icon" href="../_sisu/image/rb7.ico" /> @@ -192,7 +192,7 @@ </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1925 + 1927 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> @@ -205,78 +205,56 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <h1 class="norm" id="o1926"><a name="1926" /> + <h1 class="norm" id="o1928"><a name="1928" /> 43. Post Installation Setup <a name="43"></a> </h1> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1926 + 1928 </p> </td></tr> </table><h5 class="subtoc"> - <a href="#1927"> + <a href="#1929"> <i>43.1 Post Installation Setup - Quick start </i> </a> </h5><h5 class="subtoc"> - <a href="#1958"> + <a href="#1960"> <i>43.2 Document markup directory </i> </a> </h5><h6 class="subtoc"> - <a href="#1971"> + <a href="#1973"> <i>43.2.1 Configuration files </i> </a> </h6><h6 class="subtoc"> - <a href="#1977"> + <a href="#1979"> <i>43.2.2 Debian INSTALLATION Note </i> </a> </h6><h6 class="subtoc"> - <a href="#1991"> + <a href="#1993"> <i>43.2.3 Document Resource Configuration </i> </a> </h6><h6 class="subtoc"> - <a href="#1996"> + <a href="#1998"> <i>43.2.4 Skins </i> </a> </h6><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <a name="h43.1" id="h43.1"></a> - <p class="bold" id="o1927"><a name="1927" /> + <p class="bold" id="o1929"><a name="1929" /> 43.1 Post Installation Setup - Quick start </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1927 - </p> -</td></tr> -</table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> -<tr><td valign="top" align="justify"> - <p class="norm" id="o1928"><a name="1928" /> - After installation of sisu-complete, move to the document samples directory, - </p> -</td> -<td width="2%" align="right" valign="top"> - <p class="ocn"> - 1928 - </p> -</td></tr> -</table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> -<tr><td valign="top" align="justify"> - <p class="i1" id="o1929"><a name="1929" /> - cd /usr/share/doc/sisu/sisu_markup_samples/dfsg - </p> -</td> -<td width="2%" align="right" valign="top"> - <p class="ocn"> 1929 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1930"><a name="1930" /> - [this is not where you would normally work but provides sample documents for testing, you may prefer instead to copy the contents of that directory to a local directory before proceeding] + After installation of sisu-complete, move to the document samples directory, </p> </td> <td width="2%" align="right" valign="top"> @@ -286,8 +264,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o1931"><a name="1931" /> - and in that directory, initialise the output directory with the command + <p class="i1" id="o1931"><a name="1931" /> + cd /usr/share/doc/sisu/sisu_markup_samples/dfsg </p> </td> <td width="2%" align="right" valign="top"> @@ -297,8 +275,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1932"><a name="1932" /> - sisu -CC + <p class="norm" id="o1932"><a name="1932" /> + [this is not where you would normally work but provides sample documents for testing, you may prefer instead to copy the contents of that directory to a local directory before proceeding] </p> </td> <td width="2%" align="right" valign="top"> @@ -309,7 +287,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1933"><a name="1933" /> - then run: + and in that directory, initialise the output directory with the command </p> </td> <td width="2%" align="right" valign="top"> @@ -320,7 +298,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1934"><a name="1934" /> - sisu -1 free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu -CC </p> </td> <td width="2%" align="right" valign="top"> @@ -331,7 +309,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1935"><a name="1935" /> - or the same: + then run: </p> </td> <td width="2%" align="right" valign="top"> @@ -342,7 +320,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1936"><a name="1936" /> - sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu -1 free_as_in_freedom.rms_and_free_software.sam_williams.sst </p> </td> <td width="2%" align="right" valign="top"> @@ -353,7 +331,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1937"><a name="1937" /> - look at output results, see the "sisu_manifest" page created for the document + or the same: </p> </td> <td width="2%" align="right" valign="top"> @@ -363,8 +341,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o1938"><a name="1938" /> - for an overview of your current sisu setup, type: + <p class="i1" id="o1938"><a name="1938" /> + sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst </p> </td> <td width="2%" align="right" valign="top"> @@ -374,8 +352,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1939"><a name="1939" /> - sisu --help env + <p class="norm" id="o1939"><a name="1939" /> + look at output results, see the "sisu_manifest" page created for the document </p> </td> <td width="2%" align="right" valign="top"> @@ -386,7 +364,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1940"><a name="1940" /> - or + for an overview of your current sisu setup, type: </p> </td> <td width="2%" align="right" valign="top"> @@ -397,7 +375,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1941"><a name="1941" /> - sisu -V + sisu --help env </p> </td> <td width="2%" align="right" valign="top"> @@ -408,7 +386,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1942"><a name="1942" /> - To generate a document from a remote url accessible location move to a writable directory, (create a work directory and cd into it) as the file will be downloaded there and e.g. + or </p> </td> <td width="2%" align="right" valign="top"> @@ -419,7 +397,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1943"><a name="1943" /> - sisu -1 <<a href="http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst" target="_top">http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst</a>> + sisu -V </p> </td> <td width="2%" align="right" valign="top"> @@ -429,8 +407,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1944"><a name="1944" /> - sisu -3 <<a href="http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst" target="_top">http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst</a>> + <p class="norm" id="o1944"><a name="1944" /> + To generate a document from a remote url accessible location move to a writable directory, (create a work directory and cd into it) as the file will be downloaded there and e.g. </p> </td> <td width="2%" align="right" valign="top"> @@ -440,8 +418,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o1945"><a name="1945" /> - examine source document, vim has syntax highlighting support + <p class="i1" id="o1945"><a name="1945" /> + sisu -1 <<a href="http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst" target="_top">http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -451,8 +429,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o1946"><a name="1946" /> - gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst + <p class="i1" id="o1946"><a name="1946" /> + sisu -3 <<a href="http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst" target="_top">http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -463,7 +441,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1947"><a name="1947" /> - additional markup samples in + examine source document, vim has syntax highlighting support </p> </td> <td width="2%" align="right" valign="top"> @@ -473,8 +451,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1948"><a name="1948" /> - <<a href="http://www.jus.uio.no/sisu/SiSU/2.html" target="_top">http://www.jus.uio.no/sisu/SiSU/2.html</a>> + <p class="norm" id="o1948"><a name="1948" /> + gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst </p> </td> <td width="2%" align="right" valign="top"> @@ -485,7 +463,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1949"><a name="1949" /> - it should also be possible to run sisu against sisupods (prepared zip files, created by running the command sisu -S [filename]), whether stored locally or remotely. + additional markup samples in </p> </td> <td width="2%" align="right" valign="top"> @@ -496,7 +474,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1950"><a name="1950" /> - sisu -3 <<a href="http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip" target="_top">http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip</a>> + <<a href="http://www.jus.uio.no/sisu/SiSU/2.html" target="_top">http://www.jus.uio.no/sisu/SiSU/2.html</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -507,7 +485,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1951"><a name="1951" /> - there is a security issue associated with the running of document skins that are not your own, so these are turned of by default, and the use of the following command, which switches on the associated skin is not recommended: + it should also be possible to run sisu against sisupods (prepared zip files, created by running the command sisu -S [filename]), whether stored locally or remotely. </p> </td> <td width="2%" align="right" valign="top"> @@ -518,7 +496,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1952"><a name="1952" /> - sisu -3 --trust <<a href="http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip" target="_top">http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip</a>> + sisu -3 <<a href="http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip" target="_top">http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -529,7 +507,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1953"><a name="1953" /> - For help + there is a security issue associated with the running of document skins that are not your own, so these are turned of by default, and the use of the following command, which switches on the associated skin is not recommended: </p> </td> <td width="2%" align="right" valign="top"> @@ -540,7 +518,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1954"><a name="1954" /> - man sisu + sisu -3 --trust <<a href="http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip" target="_top">http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -550,8 +528,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1955"><a name="1955" /> - sisu --help + <p class="norm" id="o1955"><a name="1955" /> + For help </p> </td> <td width="2%" align="right" valign="top"> @@ -562,7 +540,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1956"><a name="1956" /> - sisu --help env for the way sisu "sees/maps" your system + man sisu </p> </td> <td width="2%" align="right" valign="top"> @@ -573,7 +551,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1957"><a name="1957" /> - sisu --help commands for list of commands and so on + sisu --help </p> </td> <td width="2%" align="right" valign="top"> @@ -583,20 +561,19 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> -<a name="h43.2" id="h43.2"></a> - <p class="bold" id="o1958"><a name="1958" /> - 43.2 Document markup directory + <p class="i1" id="o1958"><a name="1958" /> + sisu --help env for the way sisu "sees/maps" your system </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1958 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o1959"><a name="1959" /> - Perhaps the easiest way to begin is to create a directory for sisu marked up documents within your home directory, and copy the file structure (and document samples) provided in the document sample directory: + <p class="i1" id="o1959"><a name="1959" /> + sisu --help commands for list of commands and so on </p> </td> <td width="2%" align="right" valign="top"> @@ -606,19 +583,20 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1960"><a name="1960" /> - mkdir ~/sisu_test +<a name="h43.2" id="h43.2"></a> + <p class="bold" id="o1960"><a name="1960" /> + 43.2 Document markup directory </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1960 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1961"><a name="1961" /> - cd ~/sisu_test + <p class="norm" id="o1961"><a name="1961" /> + Perhaps the easiest way to begin is to create a directory for sisu marked up documents within your home directory, and copy the file structure (and document samples) provided in the document sample directory: </p> </td> <td width="2%" align="right" valign="top"> @@ -629,7 +607,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1962"><a name="1962" /> - cp -a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* ~/sisu_test/. + mkdir ~/sisu_test </p> </td> <td width="2%" align="right" valign="top"> @@ -639,8 +617,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o1963"><a name="1963" /> - <b>Tip:</b> the markup syntax examples may be of interest + <p class="i1" id="o1963"><a name="1963" /> + cd ~/sisu_test </p> </td> <td width="2%" align="right" valign="top"> @@ -651,7 +629,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1964"><a name="1964" /> - <<a href="http://www.jus.uio.no/sisu/sample/" target="_top">http://www.jus.uio.no/sisu/sample/</a>> + cp -a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* ~/sisu_test/. </p> </td> <td width="2%" align="right" valign="top"> @@ -662,7 +640,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1965"><a name="1965" /> - <b>Tip:</b> + <b>Tip:</b> the markup syntax examples may be of interest </p> </td> <td width="2%" align="right" valign="top"> @@ -673,7 +651,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1966"><a name="1966" /> - sisu -U [sisu markup filename] + <<a href="http://www.jus.uio.no/sisu/sample/" target="_top">http://www.jus.uio.no/sisu/sample/</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -684,7 +662,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1967"><a name="1967" /> - should printout the different possible outputs and where sisu would place them. + <b>Tip:</b> </p> </td> <td width="2%" align="right" valign="top"> @@ -694,8 +672,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o1968"><a name="1968" /> - <b>Tip:</b> if you want to toggle ansi color add + <p class="i1" id="o1968"><a name="1968" /> + sisu -U [sisu markup filename] </p> </td> <td width="2%" align="right" valign="top"> @@ -705,8 +683,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1969"><a name="1969" /> - c + <p class="norm" id="o1969"><a name="1969" /> + should printout the different possible outputs and where sisu would place them. </p> </td> <td width="2%" align="right" valign="top"> @@ -717,7 +695,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1970"><a name="1970" /> - to your flags. + <b>Tip:</b> if you want to toggle ansi color add </p> </td> <td width="2%" align="right" valign="top"> @@ -727,20 +705,19 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> -<a name="h43.2.1" id="h43.2.1"></a> - <p class="bold" id="o1971"><a name="1971" /> - 43.2.1 Configuration files + <p class="i1" id="o1971"><a name="1971" /> + c </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1971 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1972"><a name="1972" /> - <b>SiSU</b> configuration file search path is: + to your flags. </p> </td> <td width="2%" align="right" valign="top"> @@ -750,19 +727,20 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1973"><a name="1973" /> - ./_sisu/sisurc.yaml +<a name="h43.2.1" id="h43.2.1"></a> + <p class="bold" id="o1973"><a name="1973" /> + 43.2.1 Configuration files </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1973 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1974"><a name="1974" /> - ~/.sisu/sisurc.yaml + <p class="norm" id="o1974"><a name="1974" /> + <b>SiSU</b> configuration file search path is: </p> </td> <td width="2%" align="right" valign="top"> @@ -773,7 +751,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1975"><a name="1975" /> - /etc/sisu/sisurc.yaml + ./_sisu/sisurc.yaml </p> </td> <td width="2%" align="right" valign="top"> @@ -783,8 +761,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o1976"><a name="1976" /> - .\"%% <b>Debian</b> Installation Note + <p class="i1" id="o1976"><a name="1976" /> + ~/.sisu/sisurc.yaml </p> </td> <td width="2%" align="right" valign="top"> @@ -794,20 +772,19 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> -<a name="h43.2.2" id="h43.2.2"></a> - <p class="bold" id="o1977"><a name="1977" /> - 43.2.2 Debian INSTALLATION Note + <p class="i1" id="o1977"><a name="1977" /> + /etc/sisu/sisurc.yaml </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1977 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1978"><a name="1978" /> - It is best you see + .\"%% <b>Debian</b> Installation Note </p> </td> <td width="2%" align="right" valign="top"> @@ -817,19 +794,20 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1979"><a name="1979" /> - <<a href="http://www.jus.uio.no/sisu/SiSU/download.html#debian" target="_top">http://www.jus.uio.no/sisu/SiSU/download.html#debian</a>> +<a name="h43.2.2" id="h43.2.2"></a> + <p class="bold" id="o1979"><a name="1979" /> + 43.2.2 Debian INSTALLATION Note </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1979 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1980"><a name="1980" /> - for up the most up to date information. + It is best you see </p> </td> <td width="2%" align="right" valign="top"> @@ -839,8 +817,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o1981"><a name="1981" /> - notes taken from the <b>Debian</b> control file (end edited), gives an idea of additional packages that <b>SiSU</b> can make use of if available, (the use/requirement of some of which are interdependent for specific actions by <b>SiSU</b>): + <p class="i1" id="o1981"><a name="1981" /> + <<a href="http://www.jus.uio.no/sisu/SiSU/download.html#debian" target="_top">http://www.jus.uio.no/sisu/SiSU/download.html#debian</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -851,7 +829,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1982"><a name="1982" /> - Package: sisu + for up the most up to date information. </p> </td> <td width="2%" align="right" valign="top"> @@ -862,7 +840,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1983"><a name="1983" /> - <b>SiSU</b> is a lightweight markup based, command line oriented, document structuring, publishing and search framework for document collections. + notes taken from the <b>Debian</b> control file (end edited), gives an idea of additional packages that <b>SiSU</b> can make use of if available, (the use/requirement of some of which are interdependent for specific actions by <b>SiSU</b>): </p> </td> <td width="2%" align="right" valign="top"> @@ -873,7 +851,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1984"><a name="1984" /> - With minimal preparation of a plain-text, (UTF-8) file, using its native markup syntax in your text editor of choice, <b>SiSU</b> can generate various document formats (most of which share a common object numbering system for locating content), including plain text, HTML, XHTML, XML, OpenDocument text (ODF:ODT), LaTeX, PDF files, and populate an SQL database with objects (roughly paragraph-sized chunks) so searches may be performed and matches returned with that degree of granularity: your search criteria is met by these documents and at these locations within each document. Object numbering is particularly suitable for "published" works (finalized texts as opposed to works that are frequently changed or updated) for which it provides a fixed means of reference of content. Document outputs also share semantic meta-data provided. + Package: sisu </p> </td> <td width="2%" align="right" valign="top"> @@ -884,7 +862,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1985"><a name="1985" /> - <b>SiSU</b> also provides concordance files, document content certificates and manifests of generated output. + <b>SiSU</b> is a lightweight markup based, command line oriented, document structuring, publishing and search framework for document collections. </p> </td> <td width="2%" align="right" valign="top"> @@ -895,7 +873,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1986"><a name="1986" /> - A vim syntax highlighting file and an ftplugin with folds for sisu markup is provided, as are syntax highlighting files for kate, kwrite, gedit and diakonos. Vim 7 includes syntax highlighting for <b>SiSU</b>. + With minimal preparation of a plain-text, (UTF-8) file, using its native markup syntax in your text editor of choice, <b>SiSU</b> can generate various document formats (most of which share a common object numbering system for locating content), including plain text, HTML, XHTML, XML, OpenDocument text (ODF:ODT), LaTeX, PDF files, and populate an SQL database with objects (roughly paragraph-sized chunks) so searches may be performed and matches returned with that degree of granularity: your search criteria is met by these documents and at these locations within each document. Object numbering is particularly suitable for "published" works (finalized texts as opposed to works that are frequently changed or updated) for which it provides a fixed means of reference of content. Document outputs also share semantic meta-data provided. </p> </td> <td width="2%" align="right" valign="top"> @@ -906,7 +884,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1987"><a name="1987" /> - man pages, and interactive help are provided. + <b>SiSU</b> also provides concordance files, document content certificates and manifests of generated output. </p> </td> <td width="2%" align="right" valign="top"> @@ -917,7 +895,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1988"><a name="1988" /> - Dependencies for various features are taken care of in sisu related packages. The package sisu-complete installs the whole of <b>SiSU</b>. + A vim syntax highlighting file and an ftplugin with folds for sisu markup is provided, as are syntax highlighting files for kate, kwrite, gedit and diakonos. Vim 7 includes syntax highlighting for <b>SiSU</b>. </p> </td> <td width="2%" align="right" valign="top"> @@ -928,7 +906,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1989"><a name="1989" /> - Additional document markup samples are provided in the package sisu-markup-samples which is found in the non-free archive the licenses for the substantive content of the marked up documents provided is that provided by the author or original publisher. + man pages, and interactive help are provided. </p> </td> <td width="2%" align="right" valign="top"> @@ -939,7 +917,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1990"><a name="1990" /> - Homepage: <<a href="http://www.jus.uio.no/sisu" target="_top">http://www.jus.uio.no/sisu</a>> + Dependencies for various features are taken care of in sisu related packages. The package sisu-complete installs the whole of <b>SiSU</b>. </p> </td> <td width="2%" align="right" valign="top"> @@ -949,20 +927,19 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> -<a name="h43.2.3" id="h43.2.3"></a> - <p class="bold" id="o1991"><a name="1991" /> - 43.2.3 Document Resource Configuration + <p class="norm" id="o1991"><a name="1991" /> + Additional document markup samples are provided in the package sisu-markup-samples which is found in the non-free archive the licenses for the substantive content of the marked up documents provided is that provided by the author or original publisher. </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1991 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o1992"><a name="1992" /> - <b>sisu</b> resource configuration information is obtained from sources (where they exist): + Homepage: <<a href="http://www.jus.uio.no/sisu" target="_top">http://www.jus.uio.no/sisu</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -972,19 +949,20 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1993"><a name="1993" /> - ~/.sisu/sisurc.yaml +<a name="h43.2.3" id="h43.2.3"></a> + <p class="bold" id="o1993"><a name="1993" /> + 43.2.3 Document Resource Configuration </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1993 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1994"><a name="1994" /> - /etc/sisu/[sisu version]/sisurc.yaml + <p class="norm" id="o1994"><a name="1994" /> + <b>sisu</b> resource configuration information is obtained from sources (where they exist): </p> </td> <td width="2%" align="right" valign="top"> @@ -995,7 +973,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o1995"><a name="1995" /> - sisu program defaults + ~/.sisu/sisurc.yaml </p> </td> <td width="2%" align="right" valign="top"> @@ -1005,20 +983,19 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> -<a name="h43.2.4" id="h43.2.4"></a> - <p class="bold" id="o1996"><a name="1996" /> - 43.2.4 Skins + <p class="i1" id="o1996"><a name="1996" /> + /etc/sisu/[sisu version]/sisurc.yaml </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1996 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o1997"><a name="1997" /> - <b>Skins</b> default document appearance may be modified using skins contained in sub-directories located at the following paths: + <p class="i1" id="o1997"><a name="1997" /> + sisu program defaults </p> </td> <td width="2%" align="right" valign="top"> @@ -1028,19 +1005,20 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1998"><a name="1998" /> - ./_sisu/skin +<a name="h43.2.4" id="h43.2.4"></a> + <p class="bold" id="o1998"><a name="1998" /> + 43.2.4 Skins </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1998 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o1999"><a name="1999" /> - ~/.sisu/skin + <p class="norm" id="o1999"><a name="1999" /> + <b>Skins</b> default document appearance may be modified using skins contained in sub-directories located at the following paths: </p> </td> <td width="2%" align="right" valign="top"> @@ -1051,7 +1029,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o2000"><a name="2000" /> - /etc/sisu/skin + ./_sisu/skin </p> </td> <td width="2%" align="right" valign="top"> @@ -1061,8 +1039,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o2001"><a name="2001" /> - more specifically, the following locations (or their /etc/sisu equivalent) should be used: + <p class="i1" id="o2001"><a name="2001" /> + ~/.sisu/skin </p> </td> <td width="2%" align="right" valign="top"> @@ -1073,7 +1051,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o2002"><a name="2002" /> - ~/.sisu/skin/doc + /etc/sisu/skin </p> </td> <td width="2%" align="right" valign="top"> @@ -1084,7 +1062,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o2003"><a name="2003" /> - skins for individual documents; + more specifically, the following locations (or their /etc/sisu equivalent) should be used: </p> </td> <td width="2%" align="right" valign="top"> @@ -1095,7 +1073,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o2004"><a name="2004" /> - ~/.sisu/skin/dir + ~/.sisu/skin/doc </p> </td> <td width="2%" align="right" valign="top"> @@ -1106,7 +1084,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o2005"><a name="2005" /> - skins for directories of matching names; + skins for individual documents; </p> </td> <td width="2%" align="right" valign="top"> @@ -1117,7 +1095,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="i1" id="o2006"><a name="2006" /> - ~/.sisu/skin/site + ~/.sisu/skin/dir </p> </td> <td width="2%" align="right" valign="top"> @@ -1128,7 +1106,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o2007"><a name="2007" /> - site-wide skin modifying the site-wide appearance of documents. + skins for directories of matching names; </p> </td> <td width="2%" align="right" valign="top"> @@ -1138,8 +1116,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="norm" id="o2008"><a name="2008" /> - Usually all skin files are placed in the document skin directory: + <p class="i1" id="o2008"><a name="2008" /> + ~/.sisu/skin/site </p> </td> <td width="2%" align="right" valign="top"> @@ -1149,8 +1127,8 @@ </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> - <p class="i1" id="o2009"><a name="2009" /> - ~/.sisu/skin/doc + <p class="norm" id="o2009"><a name="2009" /> + site-wide skin modifying the site-wide appearance of documents. </p> </td> <td width="2%" align="right" valign="top"> @@ -1161,7 +1139,7 @@ </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <p class="norm" id="o2010"><a name="2010" /> - with softlinks being made to the skins contained there from other skin directories as required. + Usually all skin files are placed in the document skin directory: </p> </td> <td width="2%" align="right" valign="top"> @@ -1169,6 +1147,28 @@ 2010 </p> </td></tr> +</table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> +<tr><td valign="top" align="justify"> + <p class="i1" id="o2011"><a name="2011" /> + ~/.sisu/skin/doc + </p> +</td> +<td width="2%" align="right" valign="top"> + <p class="ocn"> + 2011 + </p> +</td></tr> +</table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> +<tr><td valign="top" align="justify"> + <p class="norm" id="o2012"><a name="2012" /> + with softlinks being made to the skins contained there from other skin directories as required. + </p> +</td> +<td width="2%" align="right" valign="top"> + <p class="ocn"> + 2012 + </p> +</td></tr> </table><p class="center" id="endnotes"> <a href="#top">^</a></p><table summary="whitespace"><tr><td> </td></tr></table><table summary="segment navigation band" bgcolor="#ffffff" width="100%"><tr> <td width="20%" align="left"> @@ -1301,7 +1301,7 @@ <a href="http://www.jus.uio.no/sisu" > SiSU </a> - 0.59.0 2007-09-23 (2007w38/0) + 0.59.1 2007-09-25 (2007w39/2) <br /> <a href="http://www.jus.uio.no/sisu" > <b>SiSU</b> |