diff options
Diffstat (limited to 'data/doc/manuals_generated/sisu_manual/sisu_manual/36.html')
| -rw-r--r-- | data/doc/manuals_generated/sisu_manual/sisu_manual/36.html | 404 |
1 files changed, 202 insertions, 202 deletions
diff --git a/data/doc/manuals_generated/sisu_manual/sisu_manual/36.html b/data/doc/manuals_generated/sisu_manual/sisu_manual/36.html index 0768ff36..7649ae1d 100644 --- a/data/doc/manuals_generated/sisu_manual/sisu_manual/36.html +++ b/data/doc/manuals_generated/sisu_manual/sisu_manual/36.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"> - 1205 + 1206 </p> </td></tr> </table><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> @@ -205,340 +205,329 @@ </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="o1367"><a name="1367" /> + <h1 class="norm" id="o1368"><a name="1368" /> 36. Quickstart - Getting Started Howto </h1> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1367 + 1368 </p> </td></tr> </table><h5 class="subtoc"> - <a href="#1368"> + <a href="#1369"> <i>36.1 Installation </i> </a> </h5><h6 class="subtoc"> - <a href="#1370"> + <a href="#1371"> <i>36.1.1 Debian Installation </i> </a> </h6><h6 class="subtoc"> - <a href="#1382"> + <a href="#1383"> <i>36.1.2 RPM Installation </i> </a> </h6><h6 class="subtoc"> - <a href="#1388"> + <a href="#1389"> <i>36.1.3 Installation from source </i> </a> </h6><h5 class="subtoc"> - <a href="#1415"> + <a href="#1416"> <i>36.2 Testing SiSU, generating output </i> </a> </h5><h6 class="subtoc"> - <a href="#1424"> + <a href="#1425"> <i>36.2.1 basic text, plaintext, html, XML, ODF </i> </a> </h6><h6 class="subtoc"> - <a href="#1428"> + <a href="#1429"> <i>36.2.2 LaTeX / pdf </i> </a> </h6><h6 class="subtoc"> - <a href="#1434"> + <a href="#1435"> <i>36.2.3 relational database - postgresql, sqlite </i> </a> </h6><h5 class="subtoc"> - <a href="#1441"> + <a href="#1442"> <i>36.3 Getting Help </i> </a> </h5><h6 class="subtoc"> - <a href="#1442"> + <a href="#1443"> <i>36.3.1 The man pages </i> </a> </h6><h6 class="subtoc"> - <a href="#1449"> + <a href="#1450"> <i>36.3.2 Built in help </i> </a> </h6><h6 class="subtoc"> - <a href="#1454"> + <a href="#1455"> <i>36.3.3 The home page </i> </a> </h6><h5 class="subtoc"> - <a href="#1457"> + <a href="#1458"> <i>36.4 Markup Samples </i> </a> </h5><table summary="normal text css" width="100%" border="0" bgcolor="white" cellpadding="2" align="center"> <tr><td valign="top" align="justify"> <a name="h36.1" id="h36.1"></a> - <p class="bold" id="o1368"><a name="1368" /> + <p class="bold" id="o1369"><a name="1369" /> 36.1 Installation </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1368 + 1369 </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="o1369"><a name="1369" /> + <p class="norm" id="o1370"><a name="1370" /> Installation is currently most straightforward and tested on the <b>Debian</b> platform, as there are packages for the installation of sisu and all requirements for what it does. </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1369 + 1370 </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"> <a name="h36.1.1" id="h36.1.1"></a> - <p class="bold" id="o1370"><a name="1370" /> + <p class="bold" id="o1371"><a name="1371" /> 36.1.1 Debian Installation </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1370 + 1371 </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="o1371"><a name="1371" /> + <p class="norm" id="o1372"><a name="1372" /> <b>SiSU</b> is available directly from the <b>Debian</b> Sid and testing archives (and possibly Ubuntu), assuming your /etc/apt/sources.list is set accordingly: </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1371 + 1372 </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="code" id="o1372"><a name="1372" /> + <p class="code" id="o1373"><a name="1373" /> aptitude update<br /> aptitude install sisu-complete </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1372 + 1373 </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="o1373"><a name="1373" /> + <p class="norm" id="o1374"><a name="1374" /> The following /etc/apt/sources.list setting permits the download of additional markup samples: </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1373 + 1374 </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="code" id="o1374"><a name="1374" /> + <p class="code" id="o1375"><a name="1375" /> #/etc/apt/sources.list<br /><br /> deb http://ftp.fi.debian.org/debian/ unstable main non-free contrib<br /> deb-src http://ftp.fi.debian.org/debian/ unstable main non-free contrib<br /> d </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1374 + 1375 </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="o1375"><a name="1375" /> + <p class="norm" id="o1376"><a name="1376" /> The aptitude commands become: </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1375 + 1376 </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="code" id="o1376"><a name="1376" /> + <p class="code" id="o1377"><a name="1377" /> aptitude update<br /> aptitude install sisu-complete sisu-markup-samples </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1376 + 1377 </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="o1377"><a name="1377" /> + <p class="norm" id="o1378"><a name="1378" /> If there are newer versions of <b>SiSU</b> upstream of the <b>Debian</b> archives, they will be available by adding the following to your /etc/apt/sources.list </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1377 + 1378 </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="code" id="o1378"><a name="1378" /> + <p class="code" id="o1379"><a name="1379" /> #/etc/apt/sources.list<br /><br /> deb http://www.jus.uio.no/sisu/archive unstable main non-free<br /> deb-src http://www.jus.uio.no/sisu/archive unstable main non-free </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1378 + 1379 </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="o1379"><a name="1379" /> + <p class="norm" id="o1380"><a name="1380" /> repeat the aptitude commands </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1379 + 1380 </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="code" id="o1380"><a name="1380" /> + <p class="code" id="o1381"><a name="1381" /> aptitude update<br /> aptitude install sisu-complete sisu-markup-samples </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1380 + 1381 </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="o1381"><a name="1381" /> + <p class="norm" id="o1382"><a name="1382" /> Note however that it is not necessary to install sisu-complete if not all components of sisu are to be used. Installing just the package sisu will provide basic functionality. </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1381 + 1382 </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"> <a name="h36.1.2" id="h36.1.2"></a> - <p class="bold" id="o1382"><a name="1382" /> + <p class="bold" id="o1383"><a name="1383" /> 36.1.2 RPM Installation </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1382 + 1383 </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="o1383"><a name="1383" /> + <p class="norm" id="o1384"><a name="1384" /> RPMs are provided though untested, they are prepared by running alien against the source package, and against the debs. </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1383 + 1384 </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="o1384"><a name="1384" /> + <p class="norm" id="o1385"><a name="1385" /> They may be downloaded from: </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1384 + 1385 </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="o1385"><a name="1385" /> + <p class="i1" id="o1386"><a name="1386" /> <<a href="http://www.jus.uio.no/sisu/SiSU/download.html#rpm" target="_top">http://www.jus.uio.no/sisu/SiSU/download.html#rpm</a>> </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1385 + 1386 </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="o1386"><a name="1386" /> + <p class="norm" id="o1387"><a name="1387" /> as root type: </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1386 + 1387 </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="o1387"><a name="1387" /> + <p class="i1" id="o1388"><a name="1388" /> rpm -i [rpm package name] </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1387 + 1388 </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"> <a name="h36.1.3" id="h36.1.3"></a> - <p class="bold" id="o1388"><a name="1388" /> + <p class="bold" id="o1389"><a name="1389" /> 36.1.3 Installation from source </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1388 + 1389 </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="o1389"><a name="1389" /> + <p class="norm" id="o1390"><a name="1390" /> To install <b>SiSU</b> from source check information at: </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1389 + 1390 </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="o1390"><a name="1390" /> + <p class="i1" id="o1391"><a name="1391" /> <<a href="http://www.jus.uio.no/sisu/SiSU/download.html#current" target="_top">http://www.jus.uio.no/sisu/SiSU/download.html#current</a>> </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1390 - </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"> - <li class="bullet" id="o1391"><a name="1391" /> - download the source package - </li> -</td> -<td width="2%" align="right" valign="top"> - <p class="ocn"> 1391 </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"> <li class="bullet" id="o1392"><a name="1392" /> - Unpack the source + download the source package </li> </td> <td width="2%" align="right" valign="top"> @@ -548,9 +537,9 @@ </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="o1393"><a name="1393" /> - Two alternative modes of installation from source are provided, setup.rb (by Minero Aoki) and a rant(by Stefan Lang) built install file, in either case: the first steps are the same, download and unpack the source file: - </p> + <li class="bullet" id="o1393"><a name="1393" /> + Unpack the source + </li> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> @@ -560,7 +549,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="o1394"><a name="1394" /> - For basic use <b>SiSU</b> is only dependent on the programming language in which it is written <b>Ruby</b>, and <b>SiSU</b> will be able to generate html, various XMLs, including ODF (and will also produce LaTeX). Dependencies required for further actions, though it relies on the installation of additional dependencies which the source tarball does not take care of, for things like using a database (postgresql or sqlite) <a name="-94" href="#_94"> <sup>94</sup> </a> or converting LaTeX to pdf. + Two alternative modes of installation from source are provided, setup.rb (by Minero Aoki) and a rant(by Stefan Lang) built install file, in either case: the first steps are the same, download and unpack the source file: </p> </td> <td width="2%" align="right" valign="top"> @@ -571,7 +560,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="o1395"><a name="1395" /> - <b>setup.rb</b> + For basic use <b>SiSU</b> is only dependent on the programming language in which it is written <b>Ruby</b>, and <b>SiSU</b> will be able to generate html, various XMLs, including ODF (and will also produce LaTeX). Dependencies required for further actions, though it relies on the installation of additional dependencies which the source tarball does not take care of, for things like using a database (postgresql or sqlite) <a name="-94" href="#_94"> <sup>94</sup> </a> or converting LaTeX to pdf. </p> </td> <td width="2%" align="right" valign="top"> @@ -582,7 +571,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="o1396"><a name="1396" /> - This is a standard ruby installer, using setup.rb is a three step process. In the root directory of the unpacked <b>SiSU</b> as root type: + <b>setup.rb</b> </p> </td> <td width="2%" align="right" valign="top"> @@ -592,8 +581,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="code" id="o1397"><a name="1397" /> - ruby setup.rb config <br /> ruby setup.rb setup <br /> #[and as root:]<br /> ruby setup.rb install + <p class="norm" id="o1397"><a name="1397" /> + This is a standard ruby installer, using setup.rb is a three step process. In the root directory of the unpacked <b>SiSU</b> as root type: </p> </td> <td width="2%" align="right" valign="top"> @@ -603,8 +592,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="o1398"><a name="1398" /> - further information on setup.rb is available from: + <p class="code" id="o1398"><a name="1398" /> + ruby setup.rb config <br /> ruby setup.rb setup <br /> #[and as root:]<br /> ruby setup.rb install </p> </td> <td width="2%" align="right" valign="top"> @@ -614,8 +603,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="o1399"><a name="1399" /> - <<a href="http://i.loveruby.net/en/projects/setup/" target="_top">http://i.loveruby.net/en/projects/setup/</a>> + <p class="norm" id="o1399"><a name="1399" /> + further information on setup.rb is available from: </p> </td> <td width="2%" align="right" valign="top"> @@ -626,7 +615,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="o1400"><a name="1400" /> - <<a href="http://i.loveruby.net/en/projects/setup/doc/usage.html" target="_top">http://i.loveruby.net/en/projects/setup/doc/usage.html</a>> + <<a href="http://i.loveruby.net/en/projects/setup/" target="_top">http://i.loveruby.net/en/projects/setup/</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -636,8 +625,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="o1401"><a name="1401" /> - <b>"install"</b> + <p class="i1" id="o1401"><a name="1401" /> + <<a href="http://i.loveruby.net/en/projects/setup/doc/usage.html" target="_top">http://i.loveruby.net/en/projects/setup/doc/usage.html</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -648,7 +637,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="o1402"><a name="1402" /> - The "install" file provided is an installer prepared using "rant". In the root directory of the unpacked <b>SiSU</b> as root type: + <b>"install"</b> </p> </td> <td width="2%" align="right" valign="top"> @@ -658,8 +647,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="o1403"><a name="1403" /> - ruby install base + <p class="norm" id="o1403"><a name="1403" /> + The "install" file provided is an installer prepared using "rant". In the root directory of the unpacked <b>SiSU</b> as root type: </p> </td> <td width="2%" align="right" valign="top"> @@ -669,8 +658,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="o1404"><a name="1404" /> - or for a more complete installation: + <p class="i1" id="o1404"><a name="1404" /> + ruby install base </p> </td> <td width="2%" align="right" valign="top"> @@ -680,8 +669,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="o1405"><a name="1405" /> - ruby install + <p class="norm" id="o1405"><a name="1405" /> + or for a more complete installation: </p> </td> <td width="2%" align="right" valign="top"> @@ -691,8 +680,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="o1406"><a name="1406" /> - or + <p class="i1" id="o1406"><a name="1406" /> + ruby install </p> </td> <td width="2%" align="right" valign="top"> @@ -702,8 +691,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="o1407"><a name="1407" /> - ruby install base + <p class="norm" id="o1407"><a name="1407" /> + or </p> </td> <td width="2%" align="right" valign="top"> @@ -713,8 +702,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="o1408"><a name="1408" /> - This makes use of Rant (by Stefan Lang) and the provided Rantfile. It has been configured to do post installation setup setup configuration and generation of first test file. Note however, that additional external package dependencies, such as tetex-extra are not taken care of for you. + <p class="i1" id="o1408"><a name="1408" /> + ruby install base </p> </td> <td width="2%" align="right" valign="top"> @@ -725,7 +714,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="o1409"><a name="1409" /> - Further information on "rant" is available from: + This makes use of Rant (by Stefan Lang) and the provided Rantfile. It has been configured to do post installation setup setup configuration and generation of first test file. Note however, that additional external package dependencies, such as tetex-extra are not taken care of for you. </p> </td> <td width="2%" align="right" valign="top"> @@ -735,8 +724,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="o1410"><a name="1410" /> - <<a href="http://make.rubyforge.org/" target="_top">http://make.rubyforge.org/</a>> + <p class="norm" id="o1410"><a name="1410" /> + Further information on "rant" is available from: </p> </td> <td width="2%" align="right" valign="top"> @@ -747,7 +736,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="o1411"><a name="1411" /> - <<a href="http://rubyforge.org/frs/?group_id=615" target="_top">http://rubyforge.org/frs/?group_id=615</a>> + <<a href="http://make.rubyforge.org/" target="_top">http://make.rubyforge.org/</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -757,8 +746,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="o1412"><a name="1412" /> - For a list of alternative actions you may type: + <p class="i1" id="o1412"><a name="1412" /> + <<a href="http://rubyforge.org/frs/?group_id=615" target="_top">http://rubyforge.org/frs/?group_id=615</a>> </p> </td> <td width="2%" align="right" valign="top"> @@ -768,8 +757,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="o1413"><a name="1413" /> - ruby install help + <p class="norm" id="o1413"><a name="1413" /> + For a list of alternative actions you may type: </p> </td> <td width="2%" align="right" valign="top"> @@ -780,7 +769,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="o1414"><a name="1414" /> - ruby install -T + ruby install help </p> </td> <td width="2%" align="right" valign="top"> @@ -790,31 +779,31 @@ </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="h36.2" id="h36.2"></a> - <p class="bold" id="o1415"><a name="1415" /> - 36.2 Testing SiSU, generating output + <p class="i1" id="o1415"><a name="1415" /> + ruby install -T </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1415 </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="o1416"><a name="1416" /> - To check which version of sisu is installed: +<a name="h36.2" id="h36.2"></a> + <p class="bold" id="o1416"><a name="1416" /> + 36.2 Testing SiSU, generating output </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1416 </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="o1417"><a name="1417" /> - sisu -v + To check which version of sisu is installed: </p> </td> <td width="2%" align="right" valign="top"> @@ -825,7 +814,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="o1418"><a name="1418" /> - Depending on your mode of installation one or a number of markup sample files may be found either in the directory: + sisu -v </p> </td> <td width="2%" align="right" valign="top"> @@ -836,7 +825,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="o1419"><a name="1419" /> - ... + Depending on your mode of installation one or a number of markup sample files may be found either in the directory: </p> </td> <td width="2%" align="right" valign="top"> @@ -847,7 +836,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="o1420"><a name="1420" /> - or + ... </p> </td> <td width="2%" align="right" valign="top"> @@ -858,7 +847,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="o1421"><a name="1421" /> - ... + or </p> </td> <td width="2%" align="right" valign="top"> @@ -869,7 +858,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="o1422"><a name="1422" /> - change directory to the appropriate one: + ... </p> </td> <td width="2%" align="right" valign="top"> @@ -880,7 +869,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="o1423"><a name="1423" /> - cd /usr/share/doc/sisu/sisu_markup_samples/dfsg + change directory to the appropriate one: </p> </td> <td width="2%" align="right" valign="top"> @@ -890,31 +879,31 @@ </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="h36.2.1" id="h36.2.1"></a> - <p class="bold" id="o1424"><a name="1424" /> - 36.2.1 basic text, plaintext, html, XML, ODF + <p class="norm" id="o1424"><a name="1424" /> + cd /usr/share/doc/sisu/sisu_markup_samples/dfsg </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1424 </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="o1425"><a name="1425" /> - Having moved to the directory that contains the markup samples (see instructions above if necessary), choose a file and run sisu against it +<a name="h36.2.1" id="h36.2.1"></a> + <p class="bold" id="o1425"><a name="1425" /> + 36.2.1 basic text, plaintext, html, XML, ODF </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1425 </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="o1426"><a name="1426" /> - sisu -NhwoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst + Having moved to the directory that contains the markup samples (see instructions above if necessary), choose a file and run sisu against it </p> </td> <td width="2%" align="right" valign="top"> @@ -925,7 +914,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="o1427"><a name="1427" /> - this will generate html including a concordance file, opendocument text format, plaintext, XHTML and various forms of XML, and OpenDocument text + sisu -NhwoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst </p> </td> <td width="2%" align="right" valign="top"> @@ -935,31 +924,31 @@ </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="h36.2.2" id="h36.2.2"></a> - <p class="bold" id="o1428"><a name="1428" /> - 36.2.2 LaTeX / pdf + <p class="norm" id="o1428"><a name="1428" /> + this will generate html including a concordance file, opendocument text format, plaintext, XHTML and various forms of XML, and OpenDocument text </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1428 </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="o1429"><a name="1429" /> - Assuming a LaTeX engine such as tetex or texlive is installed with the required modules (done automatically on selection of sisu-pdf in <b>Debian</b>) +<a name="h36.2.2" id="h36.2.2"></a> + <p class="bold" id="o1429"><a name="1429" /> + 36.2.2 LaTeX / pdf </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1429 </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="o1430"><a name="1430" /> - Having moved to the directory that contains the markup samples (see instructions above if necessary), choose a file and run sisu against it + Assuming a LaTeX engine such as tetex or texlive is installed with the required modules (done automatically on selection of sisu-pdf in <b>Debian</b>) </p> </td> <td width="2%" align="right" valign="top"> @@ -970,7 +959,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="o1431"><a name="1431" /> - sisu -pv free_as_in_freedom.rms_and_free_software.sam_williams.sst + Having moved to the directory that contains the markup samples (see instructions above if necessary), choose a file and run sisu against it </p> </td> <td width="2%" align="right" valign="top"> @@ -981,7 +970,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="o1432"><a name="1432" /> - sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu -pv free_as_in_freedom.rms_and_free_software.sam_williams.sst </p> </td> <td width="2%" align="right" valign="top"> @@ -992,7 +981,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="o1433"><a name="1433" /> - should generate most available output formats: html including a concordance file, opendocument text format, plaintext, XHTML and various forms of XML, and OpenDocument text and pdf + sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst </p> </td> <td width="2%" align="right" valign="top"> @@ -1002,31 +991,31 @@ </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="h36.2.3" id="h36.2.3"></a> - <p class="bold" id="o1434"><a name="1434" /> - 36.2.3 relational database - postgresql, sqlite + <p class="norm" id="o1434"><a name="1434" /> + should generate most available output formats: html including a concordance file, opendocument text format, plaintext, XHTML and various forms of XML, and OpenDocument text and pdf </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1434 </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="o1435"><a name="1435" /> - Relational databases need some setting up - you must have permission to create the database and write to it when you run sisu. +<a name="h36.2.3" id="h36.2.3"></a> + <p class="bold" id="o1435"><a name="1435" /> + 36.2.3 relational database - postgresql, sqlite </p> </td> <td width="2%" align="right" valign="top"> - <p class="ocn"> + <p class="ocn"> 1435 </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="o1436"><a name="1436" /> - Assuming you have the database installed and the requisite permissions + Relational databases need some setting up - you must have permission to create the database and write to it when you run sisu. </p> </td> <td width="2%" align="right" valign="top"> @@ -1037,7 +1026,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="o1437"><a name="1437" /> - sisu --sqlite --recreate + Assuming you have the database installed and the requisite permissions </p> </td> <td width="2%" align="right" valign="top"> @@ -1048,7 +1037,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="o1438"><a name="1438" /> - sisu --sqlite -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu --sqlite --recreate </p> </td> <td width="2%" align="right" valign="top"> @@ -1059,7 +1048,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="o1439"><a name="1439" /> - sisu --pgsql --recreate + sisu --sqlite -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst </p> </td> <td width="2%" align="right" valign="top"> @@ -1070,7 +1059,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="o1440"><a name="1440" /> - sisu --pgsql -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu --pgsql --recreate </p> </td> <td width="2%" align="right" valign="top"> @@ -1080,249 +1069,260 @@ </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="o1441"><a name="1441" /> + sisu --pgsql -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst + </p> +</td> +<td width="2%" align="right" valign="top"> + <p class="ocn"> + 1441 + </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"> <a name="h36.3" id="h36.3"></a> - <p class="bold" id="o1441"><a name="1441" /> + <p class="bold" id="o1442"><a name="1442" /> 36.3 Getting Help </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1441 + 1442 </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"> <a name="h36.3.1" id="h36.3.1"></a> - <p class="bold" id="o1442"><a name="1442" /> + <p class="bold" id="o1443"><a name="1443" /> 36.3.1 The man pages </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1442 + 1443 </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="o1443"><a name="1443" /> + <p class="norm" id="o1444"><a name="1444" /> Type: </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1443 + 1444 </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="o1444"><a name="1444" /> + <p class="i1" id="o1445"><a name="1445" /> man sisu </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1444 + 1445 </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="o1445"><a name="1445" /> + <p class="norm" id="o1446"><a name="1446" /> The man pages are also available online, though not always kept as up to date as within the package itself: </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1445 + 1446 </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"> - <li class="bullet" id="o1446"><a name="1446" /> + <li class="bullet" id="o1447"><a name="1447" /> <a href="http://www.jus.uio.no/sisu/man/sisu.1">sisu.1</a> <a name="-95" href="#_95"> <sup>95</sup> </a> </li> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1446 + 1447 </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"> - <li class="bullet" id="o1447"><a name="1447" /> + <li class="bullet" id="o1448"><a name="1448" /> <a href="http://www.jus.uio.no/sisu/man/sisu.8">sisu.8</a> <a name="-96" href="#_96"> <sup>96</sup> </a> </li> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1447 + 1448 </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"> - <li class="bullet" id="o1448"><a name="1448" /> + <li class="bullet" id="o1449"><a name="1449" /> <a href="http://www.jus.uio.no/sisu/man">man directory</a> <a name="-97" href="#_97"> <sup>97</sup> </a> </li> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1448 + 1449 </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"> <a name="h36.3.2" id="h36.3.2"></a> - <p class="bold" id="o1449"><a name="1449" /> + <p class="bold" id="o1450"><a name="1450" /> 36.3.2 Built in help </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1449 + 1450 </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="o1450"><a name="1450" /> + <p class="norm" id="o1451"><a name="1451" /> sisu --help </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1450 + 1451 </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="o1451"><a name="1451" /> + <p class="norm" id="o1452"><a name="1452" /> sisu --help --env </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1451 + 1452 </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="o1452"><a name="1452" /> + <p class="norm" id="o1453"><a name="1453" /> sisu --help --commands </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1452 + 1453 </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="o1453"><a name="1453" /> + <p class="norm" id="o1454"><a name="1454" /> sisu --help --markup </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1453 + 1454 </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"> <a name="h36.3.3" id="h36.3.3"></a> - <p class="bold" id="o1454"><a name="1454" /> + <p class="bold" id="o1455"><a name="1455" /> 36.3.3 The home page </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1454 + 1455 </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="o1455"><a name="1455" /> + <p class="norm" id="o1456"><a name="1456" /> <<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"> <p class="ocn"> - 1455 + 1456 </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="o1456"><a name="1456" /> + <p class="norm" id="o1457"><a name="1457" /> <<a href="http://www.jus.uio.no/sisu/SiSU" target="_top">http://www.jus.uio.no/sisu/SiSU</a>> </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1456 + 1457 </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"> <a name="h36.4" id="h36.4"></a> - <p class="bold" id="o1457"><a name="1457" /> + <p class="bold" id="o1458"><a name="1458" /> 36.4 Markup Samples </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1457 + 1458 </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="o1458"><a name="1458" /> + <p class="norm" id="o1459"><a name="1459" /> A number of markup samples (along with output) are available off: </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1458 + 1459 </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="o1459"><a name="1459" /> + <p class="norm" id="o1460"><a name="1460" /> <<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"> <p class="ocn"> - 1459 + 1460 </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="o1460"><a name="1460" /> + <p class="norm" id="o1461"><a name="1461" /> Additional markup samples are packaged separately in the file: </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1460 + 1461 </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="o1461"><a name="1461" /> + <p class="norm" id="o1462"><a name="1462" /> <b>*</b> </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1461 + 1462 </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="o1462"><a name="1462" /> + <p class="norm" id="o1463"><a name="1463" /> On <b>Debian</b> they are available in non-free <a name="-98" href="#_98"> <sup>98</sup> </a> to include them it is necessary to include non-free in your /etc/apt/source.list or obtain them from the sisu home site. </p> </td> <td width="2%" align="right" valign="top"> <p class="ocn"> - 1462 + 1463 </p> </td></tr> </table><p class="center" id="endnotes"> @@ -1497,7 +1497,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> |