/usr/share/doc/HOWTO/fr-html/DocBook-Install.html is in doc-linux-fr-html 2013.01-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2157 2158 2159 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188 2189 2190 2191 2192 2193 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203 2204 2205 2206 2207 2208 2209 2210 2211 2212 2213 2214 2215 2216 2217 2218 2219 2220 2221 2222 2223 2224 2225 2226 2227 2228 2229 2230 2231 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250 2251 2252 2253 2254 2255 2256 2257 2258 2259 2260 2261 2262 2263 2264 2265 2266 2267 2268 2269 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2284 2285 2286 2287 2288 2289 2290 2291 2292 2293 2294 2295 2296 2297 2298 2299 2300 2301 2302 2303 2304 2305 2306 2307 2308 2309 2310 2311 2312 2313 2314 2315 2316 2317 2318 2319 2320 2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2335 2336 2337 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Linux (vers 25 March 2009), see www.w3.org">
<title>DocBook Install mini-HOWTO</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
</head>
<body class="ARTICLE" bgcolor="#FFFFFF" text="#000000" link=
"#0000FF" vlink="#840084" alink="#0000FF">
<div class="ARTICLE">
<div class="TITLEPAGE">
<h1 class="TITLE"><a name="AEN2" id="AEN2">DocBook Install
mini-HOWTO</a></h1>
<h3 class="AUTHOR"><a name="AEN4" id="AEN4">Robert B
Easter</a></h3>
<div class="AFFILIATION">
<div class="ADDRESS">
<p class="ADDRESS"> <code class="EMAIL"><<a href=
"mailto:reaster@comptechnews.com">reaster@comptechnews.com</a>></code><br>
</p>
</div>
</div>
<div class="REVHISTORY">
<table width="100%" border="0">
<tr>
<th align="left" valign="top" colspan="3"><b>Historique des
versions</b></th>
</tr>
<tr>
<td align="left">Version v1.7</td>
<td align="left">2001-03-28</td>
<td align="left">Revu par : rbe</td>
</tr>
<tr>
<td align="left" colspan="3"></td>
</tr>
</table>
</div>
<div>
<div class="ABSTRACT"><a name="AEN24" id="AEN24"></a>
<p>DocBook-Install-mini-HOWTO est un guide pratique et
détaillé pour permettre aux novices d'installer
rapidement DocBook et de générer des fichiers SGML en
HTML, PS et PDF sur un système GNU/Linux (mais cela peut
être similaire sur d'autres systèmes). La mise en
place de DocBook, qui nécessite des fichiers de plusieurs
paquetages distribués séparément, peut sembler
confuse aux débutants.</p>
</div>
</div>
<hr></div>
<div class="SECT1">
<h2 class="SECT1"><a name="INTRO" id="INTRO">Introduction</a></h2>
<div class="SECT2">
<h3 class="SECT2"><a name="VERSIONS" id="VERSIONS">A propos de ce
document</a></h3>
<p>La dernière version de ce mini-howto peut être
trouvée sur :</p>
<p><a href="http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/"
target=
"_top">http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/</a></p>
<p>Reportez-vous à la section <a href="#LEGAL">Annexe A</a>
pour des informations sur les copyright, licence et décharge
de responsabilité relatifs à ce document.</p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN35" id="AEN35">Qu'est-ce que
DocBook ?</a></h3>
<p>DocBook est une Définition de Type de Documents
(<acronym class="ACRONYM">DTD</acronym> - <span class=
"emphasis"><i class="EMPHASIS">Document Type Definition</i></span>)
en Langage Standard de Balisage Généralisé
(<acronym class="ACRONYM">SGML</acronym> - <span class=
"emphasis"><i class="EMPHASIS">Standard Generalized Markup
Language</i></span>), qui définit un ensemble de balises
pour des documents littéraux, et qui fonctionne comme le
langage HTML utilisé habituellement sur le Web.</p>
<p>DocBook est destiné à la rédaction de
livres et d'articles. Comme tel, il fournit des balises
(appelées encore marqueurs) pensées
spécifiquement pour décrire des livres et des
articles. Par exemple, les balises DocBook <code class=
"SGMLTAG"><book></code> et <code class=
"SGMLTAG"><article></code> sont utilisées pour
créer les livres et les articles. Dans ces documents, des
balises <code class="SGMLTAG"><chapter></code>, <code class=
"SGMLTAG"><sect1></code>, et <code class=
"SGMLTAG"><para></code> seront utilisées. Les fichiers
SGML DocBook sont stockés dans des fichiers texte avec un
suffixe .sgml ou .gml</p>
<p>Lors de son traitement, un unique fichier SGML DocBook peut
produire des fichiers HTML, PDF, PS, TXT ou d'autres formats de
publication papier ou électronique. Le traitement est
régi par des feuilles de style (<span class=
"emphasis"><i class="EMPHASIS">stylesheets</i></span>) qui peuvent
générer automatiquement une table des
matières, la numérotation des pages, la
numérotation des chapitres et des sections, et bien d'autres
possibilités.</p>
<p>DocBook est destiné également à
l'écriture de pages de manuel unix, en utilisant la balise
<code class="SGMLTAG"><refentry></code>.</p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN52" id="AEN52">Aperçu
rapide</a></h3>
<p>Voici une description brève des paquetages que nous
utiliserons dans les prochaines sections :</p>
<div class="FORMALPARA">
<p><b>OpenJade.</b> OpenJade est un processeur <acronym class=
"ACRONYM">DSSSL</acronym> (<span class="emphasis"><i class=
"EMPHASIS">Document Style Semantics and Specification
Language</i></span> - Langage de spécification et
Sémantique de présentation de document) pour
documents <acronym class="ACRONYM">SGML</acronym> (<span class=
"emphasis"><i class="EMPHASIS">Standard Generalized Markup
Language</i></span> - Langage Standard de Balisage
Généralisé). Il transforme des fichiers source
SGML DocBook en fichiers HTML, TEX, RTF, TXT et autres formats.
OpenJade est l'outil essentiel pour convertir un fichier DocBook
dans d'autres formats. Le format de sortie TEX est utilisé
surtout comme format intermédiaire pour obtenir des fichiers
DVI, PDF et PS par des macros TeX et des convertisseurs DVI.</p>
</div>
<div class="FORMALPARA">
<p><b>La DTD SGML DocBook.</b> Les fichiers <acronym class=
"ACRONYM">DTD</acronym> (Définition de Type de Document)
sont des fichiers SGML qui définissent le langage DocBook.
L'ensemble des balises valides et leurs règles d'utilisation
y sont définis. OpenJade a besoin d'accéder aux
fichiers DTD des documents qu'il doit traiter.</p>
</div>
<div class="FORMALPARA">
<p><b>ISO8879 ENTITY SGML.</b> Les entités
définissent la représentation des caractères
spéciaux qui n'ont pas de touche clavier associée ou
qui ont une signification particulière en SGML. Des exemples
connus en HTML sont "&eacute;" pour "é","&amp;" pour
"&" et "&gt;" pour ">".</p>
</div>
<div class="FORMALPARA">
<p><b>DSSSL DocBook.</b> Les fichiers <acronym class=
"ACRONYM">DSSSL</acronym> (<span class="emphasis"><i class=
"EMPHASIS">Document Style Semantics and Specification
Language</i></span>) pour une DTD particulière, en
l'occurrence DocBook, spécifient comment convertir le
document DocBook en fichiers au format HTML, RTF, TEX, etc.</p>
</div>
<div class="FORMALPARA">
<p><b>SgmlTools-lite.</b> <span class=
"APPLICATION">SgmlTools</span> est une interface pour lancer
OpenJade et les macros TeX <span class="APPLICATION">jadetex</span>
et <span class="APPLICATION">pdfjadetex</span> qui en font partie.
La conversion d'un fichier DocBook en format PS ou PDF est un
traitement en deux ou trois étapes. OpenJade crée un
fichier TEX qu'utilise jadetex pour produire un DVI, et pdfjadetex
pour produire un document PDF. Un fichier PS s'obtient en
transformant le fichier DVI avec <span class=
"APPLICATION">dvips</span>. Les scripts SgmlTools fournissent une
commande unique pour ces tâches.</p>
</div>
<div class="FORMALPARA">
<p><b>HTMLdoc.</b> <span class="APPLICATION">HTMLdoc</span> est un
programme libre pour convertir des fichiers HTML en documents PDF
ou PS.</p>
</div>
<div class="FORMALPARA">
<p><b>SGMLSpm and docbook2X.</b> Ces deux outils sont à
utiliser pour générer des pages de manuel. SGMLSpm
est une bibliothèque modulaire Perl5 pour traiter les
résultats du travail de <tt class="FILENAME">onsgmls</tt>,
un programme inclus dans OpenJade. SGMLSpm comprend une application
appelée <tt class="FILENAME">sgmlspl</tt> permettant
d'utiliser la bibliothèque SGMLSpm. <tt class=
"FILENAME">Sgmlspl</tt> nécessite des fichiers de
spécification, disponibles sur de nombreux sites internet,
pour chaque type de document à transformer. <span class=
"APPLICATION">DocBook2X</span> est un paquetage qui fournit des
fichiers de spécification pour transformer des fichiers
DocBook en pages de manuel.</p>
</div>
</div>
</div>
<div class="SECT1">
<hr>
<h2 class="SECT1"><a name="DOWNLOAD" id=
"DOWNLOAD">Télécharger les paquetages</a></h2>
<p>Dans cette section, nous localiserons et
téléchargerons les logiciels sur Internet.</p>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN95" id="AEN95">OpenJade</a></h3>
<p>OpenJade est un logiciel aux sources libres (open-source),
activement maintenu, basé sur le paquetage Jade de <a href=
"http://www.jclark.com/" target="_top">James Clark</a>.
Téléchargez la dernière version stable
(1.3 ?) sur :</p>
<p><a href="http://openjade.sourceforge.net/" target=
"_top">http://openjade.sourceforge.net/</a></p>
<p>OpenJade inclut également le paquetage OpenSP et les
macros TeX <span class="APPLICATION">jadetex</span> et <span class=
"APPLICATION">pdfjadetex</span> pour convertir les fichiers en DVI
et en PDF. Les programmes suivants sont installés par ce
paquetage :</p>
<ul>
<li>
<p><span class="APPLICATION">openjade</span></p>
</li>
<li>
<p><span class="APPLICATION">onsgmls</span></p>
</li>
<li>
<p><span class="APPLICATION">osgmlnorm</span></p>
</li>
<li>
<p><span class="APPLICATION">ospam</span></p>
</li>
<li>
<p><span class="APPLICATION">ospent</span></p>
</li>
<li>
<p><span class="APPLICATION">osx</span></p>
</li>
</ul>
<p>Afin de pouvoir utiliser jadetex et pdfjadetex pour créer
du DVI, PS et PDF, vous devez avoir une installation de TeX qui
fonctionne. Si vous n'avez pas TeX, cherchez dans votre
distribution Linux le paquetage à installer. Sinon, vous
pouvez télécharger la distribution TeX <span class=
"APPLICATION">teTeX</span> depuis :</p>
<p><a href="http://www.tug.org/tetex/" target=
"_top">http://www.tug.org/tetex/</a></p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN127" id="AEN127">La DTD SGML
DocBook</a></h3>
<p>Les DTD DocBook SGML et XML sont maintenues par un comité
technique à <a href="http://www.oasis-open.org/" target=
"_top">Oasis-Open.ORG</a>. Téléchargez la
dernière version (et les versions anciennes dont vous
pourriez avoir besoin) de DocBook SGML sur :</p>
<p><a href="http://www.oasis-open.org/docbook/sgml/index.html"
target=
"_top">http://www.oasis-open.org/docbook/sgml/index.html</a></p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN133" id="AEN133">ISO8879 ENTITY
SGML</a></h3>
<p>Les entités définissent la représentation
de caractères spéciaux ou de symboles qui ne peuvent
être saisis au clavier, y compris les symboles
mathématiques et les entités qui peuvent vous
être familières avec le HTML. Ces fichiers
d'entités doivent être installés pour avoir une
configuration correcte.</p>
<ul>
<li>
<p>Ressources à <a href="http://www.oasis-open.org/" target=
"_top">OASIS</a> :</p>
<ul>
<li>
<p><a href="http://www.oasis-open.org/cover/topics.html#entities"
target=
"_top">http://www.oasis-open.org/cover/topics.html#entities</a></p>
</li>
<li>
<p><a href="http://www.oasis-open.org/cover/ISOEnts.zip" target=
"_top">http://www.oasis-open.org/cover/ISOEnts.zip</a></p>
</li>
<li>
<p><a href="http://www.oasis-open.org/cover/isoENT-tar.gz" target=
"_top">http://www.oasis-open.org/cover/isoENT-tar.gz</a></p>
</li>
</ul>
</li>
</ul>
<p>ISOEnts.zip n'a besoin que d'être décompacté
dans le répertoire de la DTD DocBook et de rien d'autre,
mais les fichiers dans isoENT-tar.gz restent nécessaires.
Les fichiers de isoENT-tar.gz doivent donc également
être décompactés dans le répertoire de
la DTD DocBook (cf. <a href="#INSTALL">la section intitulée
<i>Installer les paquetages</i></a> pour les détails). Mais
ces fichiers possèdent un suffixe ".ent" qui doit être
renommé en ".gml". Vous pouvez le faire manuellement, ou
bien vous pouvez télécharger et utiliser le fichier
ci-dessous, préparé par l'auteur, qui contient les
fichiers des deux archives ISOEnts.zip et isoENT-tar.gz :</p>
<p><a href=
"http://www.comptechnews.com/~reaster/iso8879-entities.tar.gz"
target=
"_top">http://www.comptechnews.com/~reaster/iso8879-entities.tar.gz</a></p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="DSSSL" id="DSSSL">DSSSL DocBook</a></h3>
<p>Des fichiers DSSSL (<span class="emphasis"><i class=
"EMPHASIS">Document Style Semantics and Specification
Language</i></span>) pour la DTD DocBook (SGML/XML) sont fournis
par <a href="http://www.nwalsh.com/" target="_top">Norman
Walsh</a>. Ces fichiers, appelés <a href=
"http://nwalsh.com/docbook/dsssl/" target="_top">Modular DocBook
Stylesheets</a> (feuilles de style modulaires pour DocBook), disent
à <span class="APPLICATION">OpenJade</span> comment
convertir votre fichier SGML DocBook en un autre format. Un fichier
<tt class="FILENAME">dsl</tt> décrit par exemple la
correspondance entre une balise d'une DTD et une autre balise d'une
autre DTD, ou d'autres conversions programmées,
écrites dans un langage appelé <a href=
"http://www.nwalsh.com/" target="_top">Core Expression
Language</a>, qui est dérivé du <a href=
"http://www.gnu.org/manual/elisp-manual-20-2.5/html_chapter/elisp_2.html#SEC5"
target="_top">Scheme</a>. Le paquetage DSSSL DocBook et sa
documentation peuvent être téléchargés
sur le site de Norman Walsh :</p>
<p><a href="http://nwalsh.com/docbook/dsssl/" target=
"_top">http://nwalsh.com/docbook/dsssl/</a></p>
<a name="AEN166" id="AEN166"></a>
<blockquote class="BLOCKQUOTE">
<p>NdT : Norman Walsh a depuis ouvert un projet sur SourceForge,
qui doit maintenant être considéré comme le
principal lieu de téléchargement :</p>
<p><a href="http://docbook.sourceforge.net/" target=
"_top">http://docbook.sourceforge.net/</a></p>
</blockquote>
<p>Le <a href="http://www.linuxdoc.org/" target="_top">Projet de
Documentation Linux</a> a créé un fichier de
personnalisation des feuilles de style qui active des options de
présentation intéressantes. Il peut être
téléchargé sur :</p>
<p><a href="http://www.linuxdoc.org/authors/tools/ldp.dsl" target=
"_top">http://www.linuxdoc.org/authors/tools/ldp.dsl</a></p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN174" id=
"AEN174">Sgmltools-lite</a></h3>
<p><span class="APPLICATION">Sgmltools</span> est une interface
pour <span class="APPLICATION">OpenJade</span>, <span class=
"APPLICATION">jadetex</span>, <span class=
"APPLICATION">pdfjadetex</span>, <span class=
"APPLICATION">dvips</span>, et d'autres programmes. Sgmltools offre
une commande unique pour générer tous les formats
possibles avec ces outils. La dernière version, v1.3
à l'heure où nous écrivons ces lignes, peut
être téléchargée sur :</p>
<p><a href="http://www.sgmltools.org/" target=
"_top">http://www.sgmltools.org/</a></p>
<p><a href="http://sourceforge.net/projects/sgmltools-lite/"
target="_top">http://sourceforge.net/projects/sgmltools-lite/</a></p>
<p>Ce paquetage est optionnel, mais rend parfois les choses plus
faciles.</p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN187" id="AEN187">HTMLdoc</a></h3>
<p><span class="APPLICATION">HTMLdoc</span> est un programme libre
pour convertir des sites Web en documents au format <acronym class=
"ACRONYM">PDF</acronym> (<span class="emphasis"><i class=
"EMPHASIS">Portable Document Format</i></span>) ou <acronym class=
"ACRONYM">PS</acronym> (<span class="emphasis"><i class=
"EMPHASIS">Postscript</i></span>). Concernant le format PDF, il
crée une arborescence de signets correspondant aux sections,
rendant la navigation plus facile. HTMLdoc et pdfjadetex
créent tous deux des documents PDF, mais avec des rendus
légèrement différents. Comparez les deux pour
voir lequel produit le meilleur résultat pour un fichier
DocBook particulier. Reportez-vous à la <a href="#QUICK">la
section intitulée <i>Liens pour téléchargement
direct</i></a> pour connaître les adresses de
téléchargement.</p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN196" id="AEN196">DocBook2X</a></h3>
<p>DocBook2X nécessite Perl5 et le module Perl SGMLS.pm,
disponible sur le CPAN. SGMLS.pm fournit des bibliothèques
et un programme appelé <tt class="FILENAME">sgmlspl</tt> qui
convertissent les fichiers DocBook en d'autres formats en utilisant
des fichiers de spécification. Ces fichiers de
spécification sont des scripts Perl qui donnent le
mécanisme de traduction dans un format particulier.</p>
<p><a href="http://www.cpan.org/" target=
"_top">http://www.cpan.org/</a></p>
<p><a href="http://docbook2x.sourceforge.net/" target=
"_top">http://docbook2x.sourceforge.net/</a></p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="QUICK" id="QUICK">Liens pour
téléchargement direct</a></h3>
<p>Les fichiers ci-dessous sont donnés dans leur
dernière version au moment de la rédaction de ce
document :</p>
<div class="FORMALPARA">
<p><b><a href=
"http://download.sourceforge.net/openjade/openjade-1.3.tar.gz"
target="_top">openjade-1.3.tar.gz</a> .</b> OpenJade, version
1.3.</p>
</div>
<div class="FORMALPARA">
<p><b><a href=
"http://www.oasis-open.org/docbook/sgml/4.1/docbk41.zip" target=
"_top">docbk41.zip</a> .</b> DocBook SGML DTD, version 4.1.</p>
</div>
<div class="FORMALPARA">
<p><b><a href=
"http://www.comptechnews.com/~reaster/iso8879-entities.tar.gz"
target="_top">iso8879-entities.tar.gz</a> .</b> Entités ISO
8879 SGML. Cet unique fichier est plus pratique à utiliser.
Vous pouvez sinon télécharger les deux autres
fichiers et changer les suffixes des fichiers en <tt class=
"FILENAME">.gml</tt>.</p>
</div>
<div class="FORMALPARA">
<p><b><a href="http://nwalsh.com/docbook/dsssl/db160.zip" target=
"_top">db160.zip</a> & <a href=
"http://nwalsh.com/docbook/dsssl/db160d.zip" target=
"_top">db160d.zip</a> .</b> Feuilles de style Modulaires DSSSL
DocBook, version 1.60, et leur <a href=
"http://nwalsh.com/docbook/dsssl/doc/" target=
"_top">documentation</a>.</p>
</div>
<div class="FORMALPARA">
<p><b><a href=
"http://download.sourceforge.net/sgmltools-lite/sgmltools-lite-3.0.2.tar.gz"
target="_top">sgmltools-lite-3.0.2.tar.gz</a> .</b> Sgmltools-lite
version 3.0.2. Je rappelle que c'est un paquetage optionnel.</p>
</div>
<div class="FORMALPARA">
<p><b><a href="ftp://ftp.easysw.com/pub/htmldoc/1.8.9/" target=
"_top">ftp://ftp.easysw.com/pub/htmldoc/1.8.9/</a> .</b> HTMLdod
1.8.6. Des versions compilées sont disponibles avec le code
source. Choisissez en fonction de votre plate-forme. Les versions
compilées sont recommandées. Pour obtenir une version
compilée, vous pouvez la télécharger
directement par FTP sur les liens ci-dessous. Si le choix n'est pas
évident, consultez le site Internet de EasySw :
<a href="http://www.easysw.com/software.html" target=
"_top">http://www.easysw.com/software.html</a></p>
</div>
<div class="FORMALPARA">
<p><b><a href=
"http://www.cpan.org/authors/id/DMEGG/SGMLSpm-1.03ii.tar.gz"
target="_top">http://www.cpan.org/authors/id/DMEGG/SGMLSpm-1.03ii.tar.gz</a>
.</b> SGMLS.pm 1.03ii sur CPAN. (sgmlspl)</p>
</div>
<div class="FORMALPARA">
<p><b><a href=
"http://download.sourceforge.net/docbook2x/docbook2X-0.6.0.tar.gz"
target=
"_top">http://download.sourceforge.net/docbook2x/docbook2X-0.6.0.tar.gz</a>
.</b> DocBook2X 0.6.0 (fournit <tt class=
"FILENAME">docbook2man-spec.pl</tt> à utiliser avec
<tt class="FILENAME">sgmlspl</tt> vu
précédemment)</p>
</div>
</div>
</div>
<div class="SECT1">
<hr>
<h2 class="SECT1"><a name="INSTALL" id="INSTALL">Installer les
paquetages</a></h2>
<div class="SECT2">
<h3 class="SECT2"><a name="AEN247" id="AEN247">Installer
OpenJade</a></h3>
<div class="SECT3">
<h4 class="SECT3"><a name="AEN249" id="AEN249">OpenJade</a></h4>
<p>Voici ce qui est nécessaire de faire, mais pensez
à lire les fichiers fournis avec OpenJade pour voir s'il n'y
a pas des paramètres que vous pourriez personnaliser pour
votre plate-forme :</p>
<pre class="SCREEN">
cd /usr/local
tar -xvzf ~/openjade-1.3.tar.gz
cd openjade-1.3
./configure --prefix=/usr/local/openjade-1.3
make
make install
# Une fois installés, les fichiers objets etc.
# peuvent être supprimés
make clean
</pre>
A l'installation, les bibliothèques sont placées dans
<tt class="FILENAME">/usr/local/openjade-1.3/lib</tt>, aussi, vous
voudrez peut-être l'ajouter dans <tt class=
"FILENAME">/etc/ld.so.conf</tt> et lancer <b class=
"COMMAND">ldconfig</b>. Ajoutez <tt class=
"FILENAME">/usr/local/openjade-1.3/bin</tt> à votre
<code class="ENVAR">$PATH</code>.</div>
<div class="SECT3">
<hr>
<h4 class="SECT3"><a name="AEN258" id="AEN258">jadetex &
pdfjadetex</a></h4>
<p>Comme mentionné, jadetex et pdfjadetex sont des macros
TeX fournies avec OpenJade. Elles sont placées dans
<tt class="FILENAME">/usr/local/openjade-3.1/dsssl</tt>. Un guide
pratique sur l'installation de ces macros a été
écrit par Frank Atanassow Christoph et peut être
trouvé sur :</p>
<p><a href=
"ftp://ftp.dante.de/tex-archive/macros/jadetex/install.pdf" target=
"_top">ftp://ftp.dante.de/tex-archive/macros/jadetex/install.pdf</a></p>
<p><a href=
"http://www.comptechnews.com/~reaster/installjadetex.pdf" target=
"_top">http://www.comptechnews.com/~reaster/installjadetex.pdf</a></p>
<p>Les sections suivantes sont adaptées des instructions
trouvées dans <tt class=
"FILENAME">install.pdf</tt> :</p>
<div class="SECT4">
<hr>
<h5 class="SECT4"><a name="AEN274" id="AEN274">Créer
hugelatex (si nécessaire)</a></h5>
<p>Les macros TeX jadetex et pdfjadetex nécessitent plus de
mémoire qu'une utilisation habituelle de TeX. Souvent, la
configuration par défaut des limites d'utilisation
mémoire de TeX n'est pas adaptée. Le fichier de
configuration de TeX, <tt class="FILENAME">texmf.cnf</tt>, peut
être modifié et les valeurs des variables
correspondant à la limite d'utilisation de la mémoire
par TeX peuvent être augmentées. Cependant,
plutôt que de simplement éditer le fichier <tt class=
"FILENAME">texmf.cnf</tt> pour permettre à TeX d'utiliser
plus de mémoire en toutes circonstances, un contexte TeX
spécifique peut être créé, appelé
hugelatex. Si hugelatex est déjà configuré sur
votre système, vous pouvez sauter cette section (<b class=
"COMMAND">which hugelatex</b> vous donne l'emplacement de la macro
si elle est configurée).</p>
<p>Vérifiez qu'une version fonctionnelle de TeX est
installée et trouvez son emplacement :</p>
<pre class="SCREEN">
bash$ which tex
/usr/share/texmf/bin/tex
bash$ kpsewhich -expand-var='$TEXMFMAIN'
/usr/share/texmf
bash$
</pre>
<p>L'utilisation de <tt class="FILENAME">which</tt> devrait trouver
l'emplacement du programme TeX. Si TeX n'est pas trouvé,
vous aurez peut-être à installer <span class=
"APPLICATION">teTeX</span> puis à revenir ici. <span class=
"APPLICATION">kpsewhich</span> est un utilitaire fourni avec teTeX
qui donne, si tout va bien, le répertoire TeX principal.</p>
<p>Maintenant que le répertoire de texmf est connu,
l'installation peut débuter :</p>
<pre class="SCREEN">
cd /usr/share/texmf
cd tex/latex
cp -r config config-temp
cd config-temp
tex -ini -progname=hugelatex latex.ini
mv latex.fmt hugelatex.fmt
mv hugelatex.fmt /usr/share/texmf/web2c
cd ..
rm -r config-temp
cd /usr/share/texmf/bin
ln -s tex hugelatex
cd /usr/share/texmf/web2c
</pre>
Le répertoire <tt class="FILENAME">web2c</tt> contient le
fichier de configuration <tt class="FILENAME">texmf.cnf</tt>.
Faîtes une copie de sauvegarde de ce fichier : <b class=
"COMMAND">cp texmf.cnf texmf.cnf.orig</b>. Editez le fichier en
utilisant votre éditeur préféré, et
ajoutez les lignes suivantes à la fin :
<pre class="SCREEN">
% hugelatex settings
extra_mem_top.hugelatex = 8000000
extra_mem_bot.hugelatex = 8000000
hash_extra.hugelatex = 15000
pool_size.hugelatex = 5000000
string_vacancies.hugelatex = 45000
max_strings.hugelatex = 55000
pool_free.hugelatex = 47500
nest_size.hugelatex = 500
param_size.hugelatex = 1500
save_size.hugelatex = 5000
stack_size.hugelatex = 15000
% jadetex
extra_mem_top.jadetex = 8000000
extra_mem_bot.jadetex = 8000000
hash_extra.jadetex = 20000
pool_size.jadetex = 5000000
string_vacancies.jadetex = 45000
max_strings.jadetex = 55000
pool_free.jadetex = 47500
nest_size.jadetex = 500
param_size.jadetex = 1500
save_size.jadetex = 5000
stack_size.jadetex = 15000
% pdfjadetex
extra_mem_top.pdfjadetex = 8000000
extra_mem_bot.pdfjadetex = 8000000
hash_extra.pdfjadetex = 20000
pool_size.pdfjadetex = 5000000
string_vacancies.pdfjadetex = 45000
max_strings.pdfjadetex = 55000
pool_free.pdfjadetex = 47500
nest_size.pdfjadetex = 500
param_size.pdfjadetex = 1500
save_size.pdfjadetex = 5000
stack_size.pdfjadetex = 15000
</pre>
Nous avons pris de l'avance en ajoutant des entrées pour
jadetex et pdfjadetex, lesquels seront configurés
ci-dessous. Vous pouvez jouer avec les paramètres
mémoire précédents comme vous le voulez si
vous rencontrez des problèmes avec ceux-ci.
<p>Notez que la mise en place de hugelatex n'est prise en compte
qu'après avoir lancé le programme <span class=
"APPLICATION">texhash</span></p>
<pre class="SCREEN">
root# texhash
texhash: Updating /usr/share/texmf/ls-R...
texhash: Updating /var/cache/fonts/ls-R...
texhash: Done.
root#
</pre></div>
<div class="SECT4">
<hr>
<h5 class="SECT4"><a name="AEN295" id="AEN295">jadetex &
pdfjadetex</a></h5>
<p>La configuration de jadetex et de pdfjadetex est similaire
à celle de hugelatex.</p>
<pre class="SCREEN">
cd /usr/local/openjade-1.3/dsssl
make -f Makefile.jadetex install
# make crée et installe les fichiers .fmt
# dans /usr/share/texmf/web2c
# Création des liens symboliques...
cd /usr/share/texmf/bin
ln -s tex jadetex
ln -s pdftex pdfjadetex
# Enfin, lancement de texhash.
root# texhash
</pre>
Le Makefile utilise hugelatex, aussi hugelatex doit avoir
été configuré avant. Quand tex est
lancé par hugelatex, jadetex ou pdfjadetex, il
récupère le nom de la commande (donc le contexte)
dans la variable <code class="VARNAME">argv[0]</code>. Ensuite, il
parcourt <tt class="FILENAME">texmf.cnf</tt> et utilise les
configurations contextuelles qu'il y trouve. Les fichiers de format
(.fmt) placés dans <tt class=
"FILENAME">/usr/share/texmf/web2c</tt> sont également
chargés suivant le contexte.
<p>Jadetex utilise un fichier tex généré par
OpenJade pour créer un DVI. De même pdfjadetex utilise
le fichier tex généré par OpenJade et
crée un PDF. Le programme <span class=
"APPLICATION">dvips</span> utilise le fichier DVI et crée un
fichier postscript (PS).</p>
</div>
</div>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN304" id="AEN304">La DTD SGML
DocBook</a></h3>
<div class="SECT3">
<h4 class="SECT3"><a name="AEN306" id="AEN306">Décompresser
la DTD SGML DocBook</a></h4>
<p>La DTD DocBook n'est constituée que de fichiers texte
SGML, aussi il n'y a rien à compiler. Décompressez
uniquement ces fichiers dans un endroit choisi.</p>
<pre class="SCREEN">
# DocBook DTD V4.1 placé dans
# /usr/local/share/sgml/docbook/4.1
cd /usr/local/share
mkdir sgml; cd sgml
mkdir docbook; cd docbook
mkdir 4.1; cd 4.1
unzip -a ~/docbk41.zip
</pre>
Si vous installez doctools-1.2 de la distribution XFree86, cela
installera d'anciennes versions de la DTD DocBook dans des
sous-répertoires, comme les versions 2.4.1 et 3.0.
<p>Il y a des différences entre les diverses versions de la
DTD DocBook. Les fichiers <tt class="FILENAME">xxxissues.txt</tt>
documentent ces questions. Des balises ont été
ajoutées, retirées ou renommées entre les
versions.</p>
<p>Si vous devez utiliser la DTD DocBook dans sa version 3.1, elle
est disponible au même endroit où la version 4.1 se
télécharge. La version 3.1 est beaucoup
utilisée, aussi c'est une bonne idée de la
télécharger et de la placer dans un
sous-répertoire 3.1/.</p>
</div>
<div class="SECT3">
<hr>
<h4 class="SECT3"><a name="AEN313" id="AEN313">Décompresser
les entités ISO8879</a></h4>
<p>Allez dans le répertoire de chaque version
installée de la DTD DocBook, et décompressez-y le
fichier <tt class=
"FILENAME">iso8879-entities.tar.gz</tt> :</p>
<pre class="SCREEN">
cd /usr/local/share/sgml/docbook/4.1
tar -xvzf ~/iso8879-entities.tar.gz
</pre>
Il doit y avoir dans le répertoire de chaque version de la
DTD DocBook un fichier <tt class="FILENAME">docbook.cat</tt>, ou un
fichier <tt class="FILENAME">catalog</tt>, ou bien les deux. Si les
deux sont présents, ils sont probablement identiques. Si
seul <tt class="FILENAME">docbook.cat</tt> est présent,
allez dans le répertoire et créez un lien
symbolique :
<pre class="SCREEN">
# Si nécessaire...
cd /usr/local/share/sgml/docbook/4.1
ln -s docbook.cat catalog
</pre></div>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="DSSSLDB" id="DSSSLDB">Les DSSSL
DocBook</a></h3>
<p>L'installation des feuilles de style DSSSL DocBook, qui sont
compatibles avec toutes les versions de DocBook, ne
nécessitent que de les décompresser dans un
répertoire approprié :</p>
<pre class="SCREEN">
cd /usr/local/share/sgml
mkdir dsssl; cd dsssl
unzip -a ~/db160.zip
# Si vous avez téléchargé ldp.dsl le fichier de personnalisation
# des feuilles de style, copiez-le dans...
cd docbook
cp ~/ldp.dsl html
cp ~/ldp.dsl print
# ces deux répertoires
</pre>
C'est tout ce qu'il y a à faire pour installer les feuilles
de style DSSSL, hormis la configuration de la variable
d'environnement <code class="ENVAR">SGML_CATALOG_PATH</code> que
nous aborderons plus tard. N'oubliez pas de corriger les droits sur
les fichiers installés et leurs groupes/propriétaires
(qui sont souvent inappropriés).</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN327" id=
"AEN327">sgmltools-lite</a></h3>
<p>Si vous le voulez, vous pouvez installer <span class=
"APPLICATION">sgmltools-lite</span>, bien que ce soit optionnel.
Son installation est standard :</p>
<pre class="SCREEN">
cd /usr/src
tar -xvzf ~/sgmltools-lite-3.0.2.tar.gz
cd sgmltools-lite-3.0.2
./configure
make install
</pre>
Ceci installe le script python dans <tt class=
"FILENAME">/usr/local/bin</tt>. Notez que sgmltools-lite utilise
python, et est donc inutile si vous n'avez pas ce paquetage.
<p>Pour que le script sgmltools fonctionne il vous faudra
l'éditer pour corriger le chemin d'accès à
OpenJade : <b class="COMMAND">vi `which sgmltools`</b>. Consultez
sa documentation pour en savoir plus.</p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN335" id="AEN335">htmldoc</a></h3>
<div class="SECT3">
<h4 class="SECT3"><a name="AEN337" id="AEN337">binaires</a></h4>
<p>Préférez le téléchargement de la
version compilée de htmldoc pour votre plate-forme.
L'installation est on ne peut plus simple :
décompressez le paquetage et lancez le <tt class=
"FILENAME">setup</tt>. Lisez la documentation fournie pour plus
d'information.</p>
</div>
<div class="SECT3">
<hr>
<h4 class="SECT3"><a name="AEN341" id="AEN341">sources</a></h4>
<p>Si vous avez téléchargé les sources, vous
aurez également besoin de la bibliothèque
<span class="APPLICATION">Fast Light Tool Kit</span>, pour
réussir l'édition de liens.</p>
<p><a href="http://www.fltk.org/" target=
"_top">http://www.fltk.org/</a></p>
<p>L'installation est de la famille <span class=
"APPLICATION">autoconf</span>. Lancez simplement le script
<b class="COMMAND">./configure</b>, puis <b class=
"COMMAND">make</b> et <b class="COMMAND">make install</b>. Si tout
va bien, le programme sera installé dans <tt class=
"FILENAME">/usr/bin</tt>.</p>
</div>
<div class="SECT3">
<hr>
<h4 class="SECT3"><a name="AEN353" id="AEN353">ldp_print</a></h4>
<p>Le programme htmldoc a quelques soucis pour traiter les fichiers
HTML d'OpenJade. Par exemple, les puces des listes ne sont pas
rendues correctement, et les zones ombrées ne le sont pas
toujours.</p>
<p>Pour contourner ce problème, un script perl (<a href=
"http://www.linuxdoc.org/authors/tools/ldp_print.tar.gz" target=
"_top">ldp_print</a>) est disponible sur <a href=
"http://www.linuxdoc.org/" target="_top">LinuxDoc.org</a>. Le
script traite un fichier HTML unique créé par
OpenJade et lance htmldoc dessus, pour produire des fichiers aux
formats PDF et PS corrects.</p>
<div class="TIP">
<blockquote class="TIP">
<p><b>Conseil :</b> Adoptez-le !</p>
</blockquote>
</div>
<pre class="SCREEN">
tar -xvzf ldp_print.tar.gz
cd ldp_print
# Copiez la bibliothèque dans le chemin
# de recherche de Perl.
cp fix_print_html.lib /usr/lib/perl5/site_perl
cp ldp_print /usr/local/bin
</pre>
Jetez un oeil aux scripts au cas où il y aurait des lignes
que vous devriez adapter. Peut-être qu'un jour le bogue
d'htmldoc sera réparé, et que ce script ne sera plus
nécessaire.</div>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN364" id="AEN364">DocBook2X et
SGMLS.pm (sgmlspl)</a></h3>
<div class="SECT3">
<h4 class="SECT3"><a name="AEN366" id="AEN366">sgmlspl</a></h4>
<p>Pour que les fichiers de spécifications de DocBook2X
soient utiles, le module SGMLS.pm pour Perl5 doit être
installé, en supposant que Perl5 est déjà
installé. L'installation de ce module n'est pas autant
automatisée que le sont les installations de la plupart des
modules Perl. Il utilise un fichier <tt class=
"FILENAME">Makefile</tt> qui doit être édité
avant de lancer <b class="COMMAND">make</b>.</p>
<pre class="SCREEN">
cd /usr/src
tar -xvzf ~/SGMLSpm-1.03ii.tar.gz
cd SGMLSpm
# Editez Makefile
vi Makefile
# Adaptez la section du Makefile relative
# aux options utilisateurs afin qu'elles
# reflètent votre système.
# Exemple :
# PERL = /usr/bin/perl
# BINDIR = /usr/local/bin
# PERL5DIR = /usr/lib/perl5/site_perl
# MODULEDIR = ${PERL5DIR}/SGMLS
# SPECDIR = ${PERL5DIR}
# HTMLDIR= /usr/local/apache/htdocs
make install
</pre>
sgmlspl sera copié dans <tt class=
"FILENAME">/usr/local/bin</tt>.</div>
<div class="SECT3">
<hr>
<h4 class="SECT3"><a name="AEN373" id="AEN373">docbook2X
(docbook2man-spec.pl)</a></h4>
<p>DocBook2X ne contient aucun programme à compiler ou
installer, mais des scripts que vous voudrez certainement examiner,
aussi, tout ce qu'il y a à faire est de décompresser
le paquetage quelque part :</p>
<pre class="SCREEN">
cd /usr/local/share/sgml
tar -xvzf ~/docbook2X-0.6.0.tar.gz
cd docbook2X
</pre>
<tt class="FILENAME">docbook2man-spec.pl</tt> se trouvera dans le
répertoire de l'archive, avec un fichier patch qui corrige
quelques petites choses. Appliquer le patch reste optionnel mais
est recommandé.
<pre class="SCREEN">
patch docbook2man-spec.pl docbook2man-spec.pl.patch
</pre>
Vous verrez par la suite dans la <a href="#USING">la section
intitulée <i>Utiliser DocBook</i></a> comment utiliser
sgmlspl et docbook2man-spec.pl pour générer des pages
de manuel depuis un document DocBook <code class=
"SGMLTAG"><refentry></code>.</div>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN381" id=
"AEN381">$SGML_CATALOG_FILES</a></h3>
<p>La variable d'environnement <code class=
"ENVAR">SGML_CATALOG_FILES</code> est utilisée par OpenJade
(ainsi que d'autres logiciels SGML) pour localiser les DTD et les
feuilles de style DSSSL. Les logiciels SGML ne peuvent pas
travailler sans trouver ces fichiers, lesquels ont
été placés dans de nombreux
répertoires. Au point où nous en sommes de notre
configuration, voici comment <code class=
"ENVAR">SGML_CATALOG_FILES</code> peut être
positionnée dans <tt class=
"FILENAME">/etc/profile</tt> :</p>
<pre class="SCREEN">
######################################################################################
# SGML DocBook - openjade sgmltools-lite
JADE_HOME=/usr/local/openjade-1.3
SGML_SHARE=/usr/local/share/sgml
PATH=$PATH:$JADE_HOME/bin
# feuilles de style DSSSL
# Modular DocBook Stylesheets de Norman Walsh
SGML_CATALOG_FILES=$SGML_SHARE/dsssl/docbook/catalog
# Feuilles de style OpenJade
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$JADE_HOME/dsssl/catalog
# Feuilles de style sgmltools-lite
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/stylesheets/sgmltools/sgmltools.cat
# DTD DocBook
# D'OASIS-Open.org
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/3.1/catalog
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/4.1/catalog
# Ces anciennes versions ont été installées par
# doctools-1.2 d'XFree86.org
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/2.4.1/catalog
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/docbook/3.0/catalog
# Catalogues sgmltools-lite pour LinuxDoc
SGML_CATALOG_FILES=$SGML_CATALOG_FILES:$SGML_SHARE/dtd/sgmltools/catalog
export JADE_HOME SGML_SHARE PATH SGML_CATALOG_FILES
######################################################################################
</pre>
Sauvegardez votre profil, déconnectez-vous et revenez pour
que les changements prennent effet.
<p>L'installation est terminée ! Dans la section
suivante, nous testerons notre configuration et convertirons
quelques fichiers DocBook.</p>
</div>
</div>
<div class="SECT1">
<hr>
<h2 class="SECT1"><a name="USING" id="USING">Utiliser
DocBook</a></h2>
<p>Maintenant que tout est installé, il est temps de tester
notre configuration, et de voir comment utiliser OpenJade et les
autres outils.</p>
<div class="FIGURE"><a name="AEN393" id="AEN393"></a>
<p><b>Figure 1. Exemple de fichier SGML DocBook - test.sgml</b></p>
<pre class="SCREEN">
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<article lang="fr">
<articleinfo>
<title>Ceci est un test</title>
<author>
<firstname>John</firstname>
<surname>Doe</surname>
<othername role="mi">L</othername>
<affiliation>
<address>
<email>j.doe@jdoe dot com</email>
</address>
</affiliation>
</author>
<revhistory>
<revision>
<revnumber>v1.0</revnumber>
<date>2000-12-30</date>
<authorinitials>jld</authorinitials>
</revision>
</revhistory>
<abstract>
<para>
Ceci est un document DocBook de test.
</para>
</abstract>
</articleinfo>
<sect1 id="test1">
<title>Test 1</title>
<para>
Test section 1.
</para>
<sect2>
<title>Test 1.1</title>
<para>
Test section 1.1
</para>
</sect2>
<sect2>
<title>Test 1.2</title>
<para>
<screen>
-- Test section 1.2
openjade -t sgml -d $DSLFILE test.sgml
</screen>
</para>
</sect2>
</sect1>
<sect1 id="test2">
<title>Test 2</title>
<para>
Test section 2.
</para>
<sect2>
<title>Test 2.1</title>
<para>
Test section 2.1
</para>
</sect2>
<sect2>
<title>Test 2.2</title>
<para>
Test section 2.2
</para>
</sect2>
</sect1>
</article>
</pre></div>
Pour un guide sur DocBook et une référence sur les
balises DocBook, voyez :
<div class="FORMALPARA">
<p><b>DocBook: The Definitive Guide.</b> <a href=
"http://www.docbook.org/tdg/html/docbook.html" target=
"_top">http://www.docbook.org/tdg/html/docbook.html</a></p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN400" id=
"AEN400">Générer du HTML</a></h3>
<div class="SECT3">
<h4 class="SECT3"><a name="AEN402" id="AEN402">docbook.dsl</a></h4>
<div class="FIGURE"><a name="AEN405" id="AEN405"></a>
<p><b>Figure 2. Création de documents HTML avec
docbook.dsl</b></p>
<pre class="SCREEN">
bash$ ls -l
total 4
-rw-r--r-- 1 reaster users 1077 Dec 31 16:25 test.sgml
bash$ echo $SGML_SHARE
/usr/local/share/sgml
bash$ openjade -t sgml -d $SGML_SHARE/dsssl/docbook/html/docbook.dsl test.sgml
[Coupé - "DTDDECL catalog entries are not supported" - Message répété]
bash$ ls -l
total 12
-rw-r--r-- 1 reaster users 1885 Dec 31 17:34 t1.htm
-rw-r--r-- 1 reaster users 1077 Dec 31 16:25 test.sgml
-rw-r--r-- 1 reaster users 1544 Dec 31 17:34 x27.htm
bash$
</pre></div>
Les messages d'avertissement concernant DTDDECL peuvent être
ignorés. Ils peuvent être légèrement
gênants, mais ils sont normaux lorsqu'on utilise Jade. Les
autres messages d'avertissement et d'erreur doivent être
surveillés, et indiquent souvent des erreurs de syntaxe qui
doivent être corrigées.
<p>Deux fichiers htm sont créés. Un pour chaque
<SECT1>. Les noms des fichiers ne sont pas très
informatifs. La première section apparaît sur la
même page que les informations sur l'article. C'est le
résultat de l'utilisation de la feuille de style de base qui
est donnée avec les Modular DocBook Stylesheets, <tt class=
"FILENAME">docbook.dsl</tt>.</p>
<p>Les feuilles de style peuvent être personnalisées
pour améliorer ces comportements. Si vous avez
téléchargé le fichier <tt class=
"FILENAME">ldp.dsl</tt> du <a href="http://www.linuxdoc.org/"
target="_top">Projet de Documentation Linux</a>, et l'avez
installé comme indiqué à la <a href=
"#DSSSLDB">la section intitulée <i>Les DSSSL
DocBook</i></a>, alors vous avez déjà un style
personnalisé disponible.</p>
</div>
<div class="SECT3">
<hr>
<h4 class="SECT3"><a name="AEN414" id="AEN414">ldp.dsl</a></h4>
<div class="FIGURE"><a name="AEN417" id="AEN417"></a>
<p><b>Figure 3. Création de documents HTML avec
ldp.dsl</b></p>
<pre class="SCREEN">
bash$ openjade -t sgml -d $SGML_SHARE/dsssl/docbook/html/ldp.dsl#html test.sgml
bash$ ls -l
total 16
-rw-r--r-- 1 reaster users 2006 Dec 31 18:00 index.html
-rw-r--r-- 1 reaster users 1077 Dec 31 16:25 test.sgml
-rw-r--r-- 1 reaster users 1677 Dec 31 18:00 test1.html
-rw-r--r-- 1 reaster users 1598 Dec 31 18:00 test2.html
bash$
</pre></div>
<p>En utilisant <tt class="FILENAME">ldp.dsl</tt>, le
résultat est plus satisfaisant :</p>
<ul>
<li>
<p>Un fichier d'index contenant les informations sur l'article a
été créé.</p>
</li>
<li>
<p>Une table des matières a été
créée automatiquement.</p>
</li>
<li>
<p>A chaque <code class="SGMLTAG"><SECT1></code> correspond
son propre fichier.</p>
</li>
<li>
<p>Les noms de fichier correspondent à l'attribut ID des
balises <code class="SGMLTAG"><SECT1></code></p>
</li>
<li>
<p>Les suffixes des noms de fichier sont maintenant .html.</p>
</li>
<li>
<p>Le contenu des balises <code class=
"SGMLTAG"><SCREEN></code> est grisé.</p>
</li>
</ul>
<p>Remarquez comment le fichier ldp.dsl a été saisi
sur la ligne de commande : "<b class="COMMAND">#html</b>" lui
a été accolé. <tt class=
"FILENAME">ldp.dsl</tt> contient deux balises <code class=
"SGMLTAG"><STYLE-SPECIFICATION></code>, une avec un attribut
ID="html" et l'autre avec un ID="print". Notre commande permet
ainsi de sélectionner le style html dans ldp.dsl. Les DSSSL
DocBook permettent de convertir les fichiers DocBook en html ou en
format papier. Dans la <a href="#DSSSLDB">la section
intitulée <i>Les DSSSL DocBook</i></a>, nous avons
copié <tt class="FILENAME">ldp.dsl</tt> dans les deux
répertoires html et print. Quand nous générons
du html, le style <span class="emphasis"><i class=
"EMPHASIS">html</i></span> doit être
sélectionné comme précédemment. La
génération d'autres formats comme RTF ou TEX est du
ressort de la documentation papier et aussi le style <span class=
"emphasis"><i class="EMPHASIS">print</i></span> doit être
sélectionné dans ldp.dsl. Une alternative est de
mettre en commentaire ou de supprimer le style <span class=
"emphasis"><i class="EMPHASIS">print</i></span> ou <span class=
"emphasis"><i class="EMPHASIS">html</i></span> suivant le cas, dans
les répertoires respectifs. Si un fichier dsl comporte plus
d'une spécification de style, mais qu'aucune n'est
sélectionnée comme l'exemple précédent,
alors c'est le premier style rencontré dans le fichier qui
sera sélectionné. Concernant ldp.dsl, les
premières spécifications sont pour le style
<span class="emphasis"><i class="EMPHASIS">print</i></span>, aussi
il est sélectionné par défaut. Ainsi, en
reprenant l'exemple précédent, et en omettant le
"<b class="COMMAND">#html</b>" lorsqu'on spécifie ldp.dsl
comme feuille de style DSSSL, les spécifications de style
"<span class="emphasis"><i class="EMPHASIS">print</i></span>"
seront sélectionnées et utilisées lors de la
génération de HTML. Ces feuilles fonctionneront, mais
sont normalement prévues pour être appelées par
<tt class="FILENAME">print/ldp.dsl</tt>, et le formatage sera
différent.</p>
<p>Pour en savoir plus sur la façon dont les fichiers de
personnalisation des feuilles de style sont conçus, lisez la
<a href="http://nwalsh.com/docbook/dsssl/doc/" target=
"_top">documentation des Modular DocBook Stylesheets</a>. La
personnalisation consiste principalement au positionnement de
paramètres booléens pour activer ou non des options
de style. Une nouvelle logique de style peut également
être programmée en utilisant le langage DSSSL <a href=
"http://www.mulberrytech.com/dsssl/dsssldoc/tutorials/core-exp/core-exp.html"
target="_top">Core Programming Language</a>, comme mentionné
dans la <a href="#DSSSL">la section intitulée <i>DSSSL
DocBook</i></a>.</p>
<p>L'option OpenJade <code class="OPTION">-t type_sortie</code>
spécifie le type sortie. L'option <code class="OPTION">-d
dsssl_spec</code> est le chemin d'accès à la feuille
de style à utiliser. Dans l'exemple précédent,
le type de sortie spécifié est <code class=
"OPTION">sgml</code>, qui est destiné aux transformations
SGML vers SGML. Le HTML, comme défini par la <a href=
"http://www.w3.org/TR/html4/sgml/dtd.html" target=
"_top">Définition de Type de Document (DTD) HTML</a>, est un
type de document SGML, tout comme DocBook, aussi, <code class=
"OPTION">sgml</code> est le type de sortie approprié. Les
deux autres types de sortie communément utilisés sont
"rtf" et "tex". Le type tex sera utilisé plus tard comme
format intermédiaire pour la génération de
formats PDF et PS. L'option <code class="OPTION">-d
dsssl_spec</code> doit spécifier un fichier et non un
répertoire.</p>
</div>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN463" id=
"AEN463">Générer du RTF et du TEX</a></h3>
<pre class="SCREEN">
bash$ ls -l
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
bash$ openjade -t rtf -d $SGML_SHARE/dsssl/docbook/print/ldp.dsl#print test.sgml
bash$ openjade -t tex -d $SGML_SHARE/dsssl/docbook/print/ldp.dsl#print test.sgml
bash$ ls -l
-rw-r--r-- 1 reaster users 4584 Dec 31 20:51 test.rtf
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
-rw-r--r-- 1 reaster users 18719 Dec 31 20:51 test.tex
</pre></div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN467" id=
"AEN467">Générer du DVI et du PS</a></h3>
<div class="FIGURE"><a name="AEN470" id="AEN470"></a>
<p><b>Figure 4. Utiliser jadetex pour générer un
fichier DVI (DeVice Independant)</b></p>
<pre class="SCREEN">
-rw-r--r-- 1 reaster users 4584 Dec 31 20:51 test.rtf
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
-rw-r--r-- 1 reaster users 18719 Dec 31 20:51 test.tex
bash$ jadetex test.tex
This is TeX, Version 3.14159 (Web2C 7.3.1)
(test.tex
JadeTeX 1999/06/29: 2.7
(/usr/share/texmf/tex/latex/psnfss/t1ptm.fd)
(/usr/share/texmf/tex/jadetex/isoents.tex)
Elements will be labelled
Jade begin document sequence at 19
No file test.aux.
(/usr/share/texmf/tex/latex/cyrillic/ot2cmr.fd)
(/usr/share/texmf/tex/latex/base/ts1cmr.fd)
(/usr/share/texmf/tex/latex/lucidabr/lmrhlcm.fd)
(/usr/share/texmf/tex/latex/hyperref/nameref.sty)
(/usr/share/texmf/tex/latex/psnfss/t1phv.fd)
LaTeX Warning: Reference `TEST1' on page 1 undefined on input line 238.
LaTeX Warning: Reference `20' on page 1 undefined on input line 262.
LaTeX Warning: Reference `23' on page 1 undefined on input line 285.
LaTeX Warning: Reference `TEST2' on page 1 undefined on input line 316.
LaTeX Warning: Reference `30' on page 1 undefined on input line 340.
LaTeX Warning: Reference `33' on page 1 undefined on input line 363.
[1.0.46] (/usr/share/texmf/tex/latex/psnfss/t1pcr.fd) [2.0.46] [3.0.46]
(test.aux)
LaTeX Warning: There were undefined references.
)
Output written on test.dvi (3 pages, 34984 bytes).
Transcript written on test.log.
bash$ ls -l
total 80
-rw-r--r-- 1 reaster users 771 Dec 31 20:55 test.aux
-rw-r--r-- 1 reaster users 34984 Dec 31 20:55 test.dvi
-rw-r--r-- 1 reaster users 5072 Dec 31 20:55 test.log
-rw-r--r-- 1 reaster users 4584 Dec 31 20:51 test.rtf
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
-rw-r--r-- 1 reaster users 18719 Dec 31 20:51 test.tex
bash$ jadetex test.tex
This is TeX, Version 3.14159 (Web2C 7.3.1)
(test.tex
JadeTeX 1999/06/29: 2.7
(/usr/share/texmf/tex/latex/psnfss/t1ptm.fd)
(/usr/share/texmf/tex/jadetex/isoents.tex)
Elements will be labelled
Jade begin document sequence at 19
(test.aux) (/usr/share/texmf/tex/latex/cyrillic/ot2cmr.fd)
(/usr/share/texmf/tex/latex/base/ts1cmr.fd)
(/usr/share/texmf/tex/latex/lucidabr/lmrhlcm.fd)
(/usr/share/texmf/tex/latex/hyperref/nameref.sty)
(/usr/share/texmf/tex/latex/psnfss/t1phv.fd) [1.0.46]
(/usr/share/texmf/tex/latex/psnfss/t1pcr.fd) [2.0.46] [3.0.46] (test.aux) )
Output written on test.dvi (3 pages, 34148 bytes).
Transcript written on test.log.
You have new mail in /var/spool/mail/reaster
bash$ ls -l
total 80
-rw-r--r-- 1 reaster users 753 Dec 31 20:58 test.aux
-rw-r--r-- 1 reaster users 34148 Dec 31 20:58 test.dvi
-rw-r--r-- 1 reaster users 4433 Dec 31 20:58 test.log
-rw-r--r-- 1 reaster users 4584 Dec 31 20:51 test.rtf
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
-rw-r--r-- 1 reaster users 18719 Dec 31 20:51 test.tex
bash$
</pre></div>
<p>La première fois que jadetex est lancé sur un
fichier, des avertissements sont imprimés. Ils peuvent
être ignorés. Lancez-le une seconde fois sur le
même fichier et ils n'apparaissent plus.</p>
<div class="FIGURE"><a name="AEN475" id="AEN475"></a>
<p><b>Figure 5. Utiliser dvips pour générer un
fichier Postscript (PS)</b></p>
<pre class="SCREEN">
bash$ ls -l
total 80
-rw-r--r-- 1 reaster users 753 Dec 31 20:58 test.aux
-rw-r--r-- 1 reaster users 34148 Dec 31 20:58 test.dvi
-rw-r--r-- 1 reaster users 4433 Dec 31 20:58 test.log
-rw-r--r-- 1 reaster users 4584 Dec 31 20:51 test.rtf
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
-rw-r--r-- 1 reaster users 18719 Dec 31 20:51 test.tex
bash$ dvips test.dvi
This is dvips(k) 5.86 Copyright 1999 Radical Eye Software (www.radicaleye.com)
' TeX output 2000.12.31:2058' -> test.ps
<texc.pro><8r.enc><texps.pro><special.pro><color.pro>. [1] [2] [3]
bash$ ls -l
total 116
-rw-r--r-- 1 reaster users 753 Dec 31 20:58 test.aux
-rw-r--r-- 1 reaster users 34148 Dec 31 20:58 test.dvi
-rw-r--r-- 1 reaster users 4433 Dec 31 20:58 test.log
-rw-r--r-- 1 reaster users 34817 Dec 31 21:06 test.ps
-rw-r--r-- 1 reaster users 4584 Dec 31 20:51 test.rtf
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
-rw-r--r-- 1 reaster users 18719 Dec 31 20:51 test.tex
bash$
</pre></div>
<div class="FIGURE"><a name="AEN479" id="AEN479"></a>
<p><b>Figure 6. Utiliser htmldoc pour générer un
fichier Postscript (PS)</b></p>
<pre class="SCREEN">
bash$ ls -l
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
bash$ export DSL_HTML=$SGML_SHARE/dsssl/docbook/html/ldp.dsl\#html
bash$ openjade -t sgml -V nochunks -d $DSL_HTML test.sgml | htmldoc -f test-htmldoc.ps -
bash$ ls -l
-rw-r--r-- 1 reaster users 9050 Jan 1 00:44 test-htmldoc.ps
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
bash$
</pre></div>
Si le fichier PS n'offre pas le résultat attendu, cela est
dû à des bugs dans htmldoc. Examinez le script
ldp_print si vous voulez l'utiliser pour faire du poscript.</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN482" id=
"AEN482">Générer du PDF</a></h3>
<div class="FIGURE"><a name="AEN485" id="AEN485"></a>
<p><b>Figure 7. Utiliser pdfjadetex pour générer un
fichier PDF (<span class="emphasis"><i class="EMPHASIS">Portable
Document Format</i></span>)</b></p>
<pre class="SCREEN">
bash$ ls -l
-rw-r--r-- 1 reaster users 753 Dec 31 20:58 test.aux
-rw-r--r-- 1 reaster users 34148 Dec 31 20:58 test.dvi
-rw-r--r-- 1 reaster users 4433 Dec 31 20:58 test.log
-rw-r--r-- 1 reaster users 34817 Dec 31 21:06 test.ps
-rw-r--r-- 1 reaster users 4584 Dec 31 20:51 test.rtf
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
-rw-r--r-- 1 reaster users 18719 Dec 31 20:51 test.tex
bash$ pdfjadetex test.tex
This is pdfTeX, Version 3.14159-13d (Web2C 7.3.1)
(test.tex[/usr/share/texmf/pdftex/config/pdftex.cfg]
JadeTeX 1999/06/29: 2.7
(/usr/share/texmf/tex/latex/psnfss/t1ptm.fd)
(/usr/share/texmf/tex/jadetex/isoents.tex)
Elements will be labelled
Jade begin document sequence at 19
(test.aux) (/usr/share/texmf/tex/latex/cyrillic/ot2cmr.fd)
(/usr/share/texmf/tex/latex/base/ts1cmr.fd)
(/usr/share/texmf/tex/latex/lucidabr/lmrhlcm.fd)
(/usr/share/texmf/tex/context/base/supp-pdf.tex
(/usr/share/texmf/tex/context/base/supp-mis.tex
loading : Context Support Macros / Missing
)
loading : Context Support Macros / PDF
) (/usr/share/texmf/tex/latex/hyperref/nameref.sty)
(/usr/share/texmf/tex/latex/psnfss/t1phv.fd) [1.0.46[/usr/share/texmf/dvips/con
fig/pdftex.map]] (/usr/share/texmf/tex/latex/psnfss/t1pcr.fd) [2.0.46] [3.0.46]
(test.aux) )<8r.enc>
Output written on test.pdf (3 pages, 9912 bytes).
Transcript written on test.log.
bash$ ls -l
total 128
-rw-r--r-- 1 reaster users 753 Dec 31 21:13 test.aux
-rw-r--r-- 1 reaster users 34148 Dec 31 20:58 test.dvi
-rw-r--r-- 1 reaster users 5075 Dec 31 21:13 test.log
-rw-r--r-- 1 reaster users 9912 Dec 31 21:13 test.pdf
-rw-r--r-- 1 reaster users 34817 Dec 31 21:06 test.ps
-rw-r--r-- 1 reaster users 4584 Dec 31 20:51 test.rtf
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
-rw-r--r-- 1 reaster users 18719 Dec 31 20:51 test.tex
bash$
bash$ pdfjadetex test.tex
[coupé]
bash$ pdfjadetex test.tex
[coupé]
</pre></div>
Pdfjadetex doit être lancé jusqu'à trois fois
pour résoudre toutes les références internes
comme les numéros de pages dans les tables des
matières.
<div class="FIGURE"><a name="AEN490" id="AEN490"></a>
<p><b>Figure 8. Utiliser htmldoc pour générer un
fichier PDF (<span class="emphasis"><i class="EMPHASIS">Portable
Document Format</i></span>)</b></p>
<pre class="SCREEN">
bash$ ls -l
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
bash$ export DSL_HTML=$SGML_SHARE/dsssl/docbook/html/ldp.dsl\#html
bash$ openjade -t sgml -V nochunks -d $DSL_HTML test.sgml > test-htmldoc.htm
bash$ ldp_print test-htmldoc.htm
bash$ ls -l
-rw-r--r-- 1 reaster users 9050 Jan 1 01:17 test-htmldoc.pdf
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
bash$
</pre></div>
Si l'option est activée dans le script <tt class=
"FILENAME">ldp_print</tt>, un fichier PS sera également
généré.</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN495" id="AEN495">Utiliser
make</a></h3>
<p>La répétition des commandes pour
générer les différents formats est vite
fastidieuse. La commande <b class="COMMAND">make</b> fonctionne
parfaitement pour automatiser le processus.</p>
<div class="FIGURE"><a name="AEN500" id="AEN500"></a>
<p><b>Figure 9. Makefile - automatiser la génération
des documents</b></p>
<pre class="PROGRAMLISTING">
# Génère des versions en-ligne et papier depuis un fichier source SGML
BASENAME=DocBook-Install
# fichier source SGML.
SGML_FILE=$(BASENAME).sgml
# Feuilles de style
DSL_PRINT=$(SGML_SHARE)/dsssl/docbook/print/ldp.dsl\#print
DSL_HTML=$(SGML_SHARE)/dsssl/docbook/html/ldp.dsl\#html
# Fichiers générés
HTML_FILE=index.html
HTM_FILE=$(BASENAME).htm
TEX_FILE=$(BASENAME).tex
RTF_FILE=$(BASENAME).rtf
PDF_FILE=$(BASENAME).pdf
DVI_FILE=$(BASENAME).dvi
PS_FILE=$(BASENAME).ps
# Règles de création
html: $(HTML_FILE)
htm: $(HTM_FILE)
tex: $(TEX_FILE)
rtf: $(RTF_FILE)
pdf: $(PDF_FILE)
dvi: $(DVI_FILE)
ps: $(PS_FILE)
all: html htm tex rtf pdf dvi ps
clean:
rm -f $(BASENAME).{htm,log,aux,ps,pdf,tex,dvi,rtf,fot}
rm -f *.html
distclean: clean
rm -f $(BASENAME).tgz
package:
rm -f $(BASENAME).tgz
tar -C .. -czf /tmp/$(BASENAME).tgz $(BASENAME)
mv /tmp/$(BASENAME).tgz .
dist: clean package
distall: all package
# Règles de compilation
$(HTML_FILE): $(SGML_FILE)
openjade -t sgml -d $(DSL_HTML) $(SGML_FILE)
$(HTM_FILE): $(SGML_FILE)
openjade -t sgml -V nochunks -d $(DSL_HTML) \
$(SGML_FILE) > $(HTM_FILE)
$(TEX_FILE): $(SGML_FILE)
openjade -t tex -d $(DSL_PRINT) $(SGML_FILE)
$(RTF_FILE): $(SGML_FILE)
openjade -t rtf -d $(DSL_PRINT) $(SGML_FILE)
# [pdf]jadetex est lancé trois fois pour résoudre les références
#$(PDF_FILE): $(TEX_FILE)
# pdfjadetex $(TEX_FILE)
# pdfjadetex $(TEX_FILE)
# pdfjadetex $(TEX_FILE)
# Cela *devrait* fonctionner, mais htmldoc a des bugs...
#$(PDF_FILE): $(SGML_FILE)
# openjade -t sgml -V nochunks -d $(DSL_HTML) \
# $(SGML_FILE) | htmldoc -f $(PDF_FILE) -
# Utiliser ldp_print pour pallier les bugs de htmldoc
# ldp_print peut aussi générer un fichier PS - voir le script
$(PDF_FILE): $(HTM_FILE)
ldp_print $(HTM_FILE)
$(DVI_FILE): $(TEX_FILE)
jadetex $(TEX_FILE)
jadetex $(TEX_FILE)
jadetex $(TEX_FILE)
$(PS_FILE): $(DVI_FILE)
dvips $(DVI_FILE)
#$(PS_FILE): $(SGML_FILE)
# openjade -t sgml -V nochunks -d $(DSL_HTML) \
# $(SGML_FILE) | htmldoc -f $(PS_FILE) -
</pre></div>
<p>On l'utilise comme pour la plupart des projets :</p>
<div class="FIGURE"><a name="AEN504" id="AEN504"></a>
<p><b>Figure 10. Appeler make pour lancer le Makefile</b></p>
<pre class="SCREEN">
# générer du html (par défaut)
make
# générer du PDF uniquement
make pdf
# générer tous les formats
make all
# supprimer tous les fichiers générés
make clean
# créer un paquetage tgz
# sans génération de fichiers
make dist
# créer un paquetage tgz
# comprenant tous les formats générés
make distall
</pre></div>
<p>Notez la présence de règles de compilation de PDF
et de PS mises en commentaire, qui offrent des alternatives sur les
moyens de générer ces fichiers.</p>
</div>
<div class="SECT2">
<hr>
<h3 class="SECT2"><a name="AEN508" id="AEN508">Créer une
page de manuel</a></h3>
<p>Lors de l'installation des paquetages, nous avons
installé le module Perl5 SGMLSpm. Ensuite nous avons
installé docbook2X qui fournit les fichiers spec.pl
nécessaires à la transformation des documents DocBook
RefEntry en fichiers au format nroff (page de manuel) à
l'aide de sgmlspl.</p>
<p>Un exemple de document DocBook RefEntry pour la commande
<tt class="FILENAME">foo</tt> est donné
ci-dessous :</p>
<div class="FIGURE"><a name="AEN514" id="AEN514"></a>
<p><b>Figure 11. page de manuel foo - source DocBook RefEntry
(foo-ref.sgml)</b></p>
<pre class="SCREEN">
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<refentry>
<refentryinfo>
<date>2001-01-01</date>
</refentryinfo>
<refmeta>
<refentrytitle>
<application>foo</application>
</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo>foo 1.0</refmiscinfo>
</refmeta>
<refnamediv>
<refname>
<application>foo</application>
</refname>
<refpurpose>
Ne fait rien d'utile.
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsynopsisdivinfo>
<date>2001-01-01</date>
</refsynopsisdivinfo>
<cmdsynopsis>
<command>foo</command>
<arg><option>-f </option><replaceable class="parameter">bar</replaceable></arg>
<arg><option>-d<replaceable class="parameter">n</replaceable></option></arg>
<arg rep="repeat"><replaceable class="parameter">fichier</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<refsect1info>
<date>2001-01-01</date>
</refsect1info>
<title>DESCRIPTION</title>
<para>
<command>foo</command> ne fait rien d'utile.
</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term>-f <replaceable class="parameter">bar</replaceable></term>
<listitem>
<para>
Prend <filename>bar</filename> comme
fichier de contrôle à l'exécution. S'il s'agissait
d'un véritable programme, il y aurait plus à dire ici
sur ce qu'est le fichier bar et comment il serait utilisé.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-d<replaceable class="parameter">n</replaceable></term>
<listitem>
<para>
Fait quelque chose, où le nombre entier
<replaceable class="parameter">n</replaceable>
spécifie combien de fois.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fichier...</replaceable></term>
<listitem>
<para>
Traite les fichiers dans l'ordre de leur apparition
et envoie le résultat sur stdout.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>UTILISATION</title>
<para>
<command>foo</command> -f foo.conf -d2 foodata.foo
</para>
</refsect1>
<refsect1>
<title>MISE EN GARDE</title>
<para>
D'autres programmes appelés <command>foo</command> peuvent exister
et faire réellement quelque chose !
</para>
</refsect1>
<refsect1>
<title>BUGS</title>
<para>
Aucun. Le programme ne fait rien.
</para>
</refsect1>
<refsect1>
<title>AUTEUR</title>
<para>
<author>
<firstname>Foo</firstname>
<othername role="mi">E</othername>
<surname>Bar</surname>
<contrib>Auteur original</contrib>
</author>
</para>
</refsect1>
</refentry>
</pre></div>
<div class="FIGURE"><a name="AEN518" id="AEN518"></a>
<p><b>Figure 12. Créer une page de manuel avec onsgmls,
sgmlspl et docbook2man-spec.pl</b></p>
<pre class="SCREEN">
bash$ ls -l
-rw-r--r-- 1 reaster users 2434 Jan 3 03:51 foo-ref.sgml
bash$ onsgmls foo-ref.sgml | sgmlspl $SGML_SHARE/docbook2X/docbook2man-spec.pl
bash$ ls -l
-rw-r--r-- 1 reaster users 2434 Jan 3 03:51 foo-ref.sgml
-rw-r--r-- 1 reaster users 1129 Jan 3 04:03 foo.1
-rw-r--r-- 1 reaster users 0 Jan 3 04:03 manpage.links
-rw-r--r-- 1 reaster users 0 Jan 3 04:03 manpage.log
-rw-r--r-- 1 reaster users 15 Jan 3 04:03 manpage.refs
bash$ groff -mandoc -Tascii foo.1
FOO(1) FOO(1)
NAME
foo - Ne fait rien d'utile.
SYNOPSIS
foo [ -f bar ] [ -dn ] [ fichier... ]
DESCRIPTION
foo ne fait rien d'utile.
OPTIONS
-f bar Prend bar comme fichier de contrôle à l'exécution.
S'il s'agissait d'un véritable programme, il y
aurait plus à dire ici sur ce qu'est le fichier
bar et comment il serait utilisé.
-dn Fait quelque chose, où le nombre entier n spécifie
combien de fois.
fichier...
Traite les fichiers dans l'ordre de leur apparition
et envoie le résultat sur stdout.
UTILISATION
foo -f foo.conf -d2 foodata.foo
MISE EN GARDE
D'autres programmes appelés foo peuvent exister et faire
réellement quelque chose !
BUGS
Aucun. Le programme ne fait rien.
AUTEUR
Foo E Bar (Auteur original)
[coupé - plusieurs lignes blanches que man ne montrera pas]
foo 1.0 2001-01-01 1
bash$ groff -mandoc -Tascii foo.1 | less
bash$ less foo.1
</pre></div>
<p>La page de manuel <tt class="FILENAME">foo.1</tt> est
générée comme une page de la Section 1. La
commande <b class="COMMAND">groff</b> est utilisée pour
donner un aperçu de son apparence finale.</p>
<p>Pour être installée, cette page de manuel doit
être placée dans un répertoire <tt class=
"FILENAME">man/man1</tt>, où le répertoire <tt class=
"FILENAME">man/</tt> est ajouté à la variable
d'environnement <code class="ENVAR">$MANPATH</code>. L'emplacement
standard est <tt class="FILENAME">/usr/local/man/man1</tt>. Les
sections standard du système de pages de manuel sont
numérotées de 1 à 9. Chacune est
destinée à recevoir des documents d'une
catégorie spécifique.</p>
<div class="TABLE"><a name="AEN529" id="AEN529"></a>
<p><b>Tableau 1. Sections des pages de manuel</b></p>
<table border="1" class="CALSTABLE">
<col>
<col>
<thead>
<tr>
<th>Section</th>
<th>Catégorie</th>
</tr>
</thead>
<tbody>
<tr>
<td>man1</td>
<td>Programmes et commandes</td>
</tr>
<tr>
<td>man2</td>
<td>Appels système</td>
</tr>
<tr>
<td>man3</td>
<td>Fonctions et routines des bibliothèques</td>
</tr>
<tr>
<td>man4</td>
<td>Périphériques et fichiers spéciaux</td>
</tr>
<tr>
<td>man5</td>
<td>Formats de fichier et conventions</td>
</tr>
<tr>
<td>man6</td>
<td>Jeux</td>
</tr>
<tr>
<td>man7</td>
<td>Divers</td>
</tr>
<tr>
<td>man8</td>
<td>Administration système</td>
</tr>
<tr>
<td>man9</td>
<td>Variables et fonctions internes du noyau</td>
</tr>
</tbody>
</table>
</div>
<div class="TIP">
<blockquote class="TIP">
<p><b>Astuce :</b> Le fichier source d'une page de manuel,
comme <tt class="FILENAME">foo-ref.sgml</tt>, peut être
converti dans tous les autres formats, exactement comme tout autre
fichier DocBook. Aussi, l'utilisation des mêmes commandes
présentées auparavant pour générer des
fichiers au format HTML et papier, permet de sortir des pages de
manuel en HTML et RTF, TEX, PDF, DVI et PS. Cela peut vous
épargner un long travail de conversion !</p>
</blockquote>
</div>
<p>Et maintenant, amusez-vous !</p>
</div>
</div>
<div class="APPENDIX">
<hr>
<h1 class="APPENDIX"><a name="LEGAL" id="LEGAL">A.
Légalité</a></h1>
<div class="SECTION">
<h2 class="SECTION"><a name="COPYRIGHT" id="COPYRIGHT">Copyright et
Licences</a></h2>
<a name="AEN573" id="AEN573"></a>
<blockquote class="BLOCKQUOTE">
<p>Copyright (c) 2001 Robert B. Easter</p>
<p><span class="emphasis"><i class="EMPHASIS">Permission is granted
to copy, distribute and/or modify this document under the terms of
the GNU Free Documentation License, Version 1.1 or any later
version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts. A copy of the license is included in the section
entitled "GNU Free Documentation License".</i></span></p>
<p>Permission vous est donnée de copier, distribuer et/ou
modifier ce document selon les termes de la Licence GNU Free
Documentation License, Version 1.1 ou ultérieure
publiée par la Free Software Foundation ; sans section
inaltérable, sans texte inaltérable de
première page de couverture, sans texte inaltérable
de dernière page de couverture. Une copie de cette licence
est incluse dans la <a href="#LICENCE">la section intitulée
<i>La licence GNU Free Documentation License</i></a>.</p>
</blockquote>
</div>
<div class="SECTION">
<hr>
<h2 class="SECTION"><a name="DISCLAIMER" id=
"DISCLAIMER">Décharge de responsabilité</a></h2>
<p>Aucune responsabilité pour le contenu de ce document ne
peut être acceptée. Utilisez les concepts, exemples et
autre contenu à vos propres risques.</p>
<p>Tous les copyrights sont détenus par leurs
propriétaires respectifs, sauf mention contraire expresse.
L'utilisation d'un terme dans ce document ne doit pas être
vue comme affectant la valeur d'une marque de fabrique ou de
service.</p>
<p>La mention d'un produit particulier ou d'une marque ne doit pas
être considérée comme un acte
d'approbation.</p>
</div>
<div class="SECTION">
<hr>
<h2 class="SECTION"><a name="LICENCE" id="LICENCE">La licence GNU
Free Documentation License</a></h2>
<div class="WARNING">
<table class="WARNING" border="1" width="100%">
<tr>
<td align="center"><b>Avertissement</b></td>
</tr>
<tr>
<td align="left">
<p>NdT - Pour des raisons de droit, la seule licence applicable
concernant ce document est la licence <span class=
"emphasis"><i class="EMPHASIS">GNU Free Documentation
License</i></span>, dans sa version originale en langue anglaise,
retranscrite ci-après.</p>
<p>Le lecteur francophone pourra, à titre d'information, se
reporter sur le site de la <a href="http://www.gnu.org/copyleft/"
target="_top">copyleft</a> de la <a href=
"http://www.gnu.org/fsf/fsf.html" target="_top">Free Software
Foundation</a>, et en particulier sur la page <a href=
"http://www.gnu.org/copyleft/copyleft.html#translationsGFDL"
target="_top">http://www.gnu.org/copyleft/copyleft.html#translationsGFDL</a>
pour trouver des liens sur plusieurs traductions françaises
de cette licence, tout en sachant que seule la version originale
fait foi.</p>
</td>
</tr>
</table>
</div>
<div class="SECTION">
<hr>
<h3 class="SECTION"><a name="GFDL" id="GFDL">GNU Free Documentation
License</a></h3>
<p>Version 1.1, March 2000</p>
<a name="AEN598" id="AEN598"></a>
<blockquote class="BLOCKQUOTE">
<p>Copyright (C) 2000 Free Software Foundation, Inc. 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted
to copy and distribute verbatim copies of this license document,
but changing it is not allowed.</p>
</blockquote>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN600" id="AEN600">0.
PREAMBLE</a></h4>
<p>The purpose of this License is to make a manual, textbook, or
other written document "free" in the sense of freedom: to assure
everyone the effective freedom to copy and redistribute it, with or
without modifying it, either commercially or noncommercially.
Secondarily, this License preserves for the author and publisher a
way to get credit for their work, while not being considered
responsible for modifications made by others.</p>
<p>This License is a kind of "copyleft", which means that
derivative works of the document must themselves be free in the
same sense. It complements the GNU General Public License, which is
a copyleft license designed for free software.</p>
<p>We have designed this License in order to use it for manuals for
free software, because free software needs free documentation: a
free program should come with manuals providing the same freedoms
that the software does. But this License is not limited to software
manuals; it can be used for any textual work, regardless of subject
matter or whether it is published as a printed book. We recommend
this License principally for works whose purpose is instruction or
reference.</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN605" id="AEN605">1. APPLICABILITY
AND DEFINITIONS</a></h4>
<p>This License applies to any manual or other work that contains a
notice placed by the copyright holder saying it can be distributed
under the terms of this License. The "Document", below, refers to
any such manual or work. Any member of the public is a licensee,
and is addressed as "you".</p>
<p>A "Modified Version" of the Document means any work containing
the Document or a portion of it, either copied verbatim, or with
modifications and/or translated into another language.</p>
<p>A "Secondary Section" is a named appendix or a front-matter
section of the Document that deals exclusively with the
relationship of the publishers or authors of the Document to the
Document's overall subject (or to related matters) and contains
nothing that could fall directly within that overall subject. (For
example, if the Document is in part a textbook of mathematics, a
Secondary Section may not explain any mathematics.) The
relationship could be a matter of historical connection with the
subject or with related matters, or of legal, commercial,
philosophical, ethical or political position regarding them.</p>
<p>The "Invariant Sections" are certain Secondary Sections whose
titles are designated, as being those of Invariant Sections, in the
notice that says that the Document is released under this
License.</p>
<p>The "Cover Texts" are certain short passages of text that are
listed, as Front-Cover Texts or Back-Cover Texts, in the notice
that says that the Document is released under this License.</p>
<p>A "Transparent" copy of the Document means a machine-readable
copy, represented in a format whose specification is available to
the general public, whose contents can be viewed and edited
directly and straightforwardly with generic text editors or (for
images composed of pixels) generic paint programs or (for drawings)
some widely available drawing editor, and that is suitable for
input to text formatters or for automatic translation to a variety
of formats suitable for input to text formatters. A copy made in an
otherwise Transparent file format whose markup has been designed to
thwart or discourage subsequent modification by readers is not
Transparent. A copy that is not "Transparent" is called
"Opaque".</p>
<p>Examples of suitable formats for Transparent copies include
plain ASCII without markup, Texinfo input format, LaTeX input
format, SGML or XML using a publicly available DTD, and
standard-conforming simple HTML designed for human modification.
Opaque formats include PostScript, PDF, proprietary formats that
can be read and edited only by proprietary word processors, SGML or
XML for which the DTD and/or processing tools are not generally
available, and the machine-generated HTML produced by some word
processors for output purposes only.</p>
<p>The "Title Page" means, for a printed book, the title page
itself, plus such following pages as are needed to hold, legibly,
the material this License requires to appear in the title page. For
works in formats which do not have any title page as such, "Title
Page" means the text near the most prominent appearance of the
work's title, preceding the beginning of the body of the text.</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN615" id="AEN615">2. VERBATIM
COPYING</a></h4>
<p>You may copy and distribute the Document in any medium, either
commercially or noncommercially, provided that this License, the
copyright notices, and the license notice saying this License
applies to the Document are reproduced in all copies, and that you
add no other conditions whatsoever to those of this License. You
may not use technical measures to obstruct or control the reading
or further copying of the copies you make or distribute. However,
you may accept compensation in exchange for copies. If you
distribute a large enough number of copies you must also follow the
conditions in section 3.</p>
<p>You may also lend copies, under the same conditions stated
above, and you may publicly display copies.</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN619" id="AEN619">3. COPYING IN
QUANTITY</a></h4>
<p>If you publish printed copies of the Document numbering more
than 100, and the Document's license notice requires Cover Texts,
you must enclose the copies in covers that carry, clearly and
legibly, all these Cover Texts: Front-Cover Texts on the front
cover, and Back-Cover Texts on the back cover. Both covers must
also clearly and legibly identify you as the publisher of these
copies. The front cover must present the full title with all words
of the title equally prominent and visible. You may add other
material on the covers in addition. Copying with changes limited to
the covers, as long as they preserve the title of the Document and
satisfy these conditions, can be treated as verbatim copying in
other respects.</p>
<p>If the required texts for either cover are too voluminous to fit
legibly, you should put the first ones listed (as many as fit
reasonably) on the actual cover, and continue the rest onto
adjacent pages.</p>
<p>If you publish or distribute Opaque copies of the Document
numbering more than 100, you must either include a machine-readable
Transparent copy along with each Opaque copy, or state in or with
each Opaque copy a publicly-accessible computer-network location
containing a complete Transparent copy of the Document, free of
added material, which the general network-using public has access
to download anonymously at no charge using public-standard network
protocols. If you use the latter option, you must take reasonably
prudent steps, when you begin distribution of Opaque copies in
quantity, to ensure that this Transparent copy will remain thus
accessible at the stated location until at least one year after the
last time you distribute an Opaque copy (directly or through your
agents or retailers) of that edition to the public.</p>
<p>It is requested, but not required, that you contact the authors
of the Document well before redistributing any large number of
copies, to give them a chance to provide you with an updated
version of the Document.</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN625" id="AEN625">4.
MODIFICATIONS</a></h4>
<p>You may copy and distribute a Modified Version of the Document
under the conditions of sections 2 and 3 above, provided that you
release the Modified Version under precisely this License, with the
Modified Version filling the role of the Document, thus licensing
distribution and modification of the Modified Version to whoever
possesses a copy of it. In addition, you must do these things in
the Modified Version:</p>
<ol type="A">
<li>
<p>Use in the Title Page (and on the covers, if any) a title
distinct from that of the Document, and from those of previous
versions (which should, if there were any, be listed in the History
section of the Document). You may use the same title as a previous
version if the original publisher of that version gives
permission.</p>
</li>
<li>
<p>List on the Title Page, as authors, one or more persons or
entities responsible for authorship of the modifications in the
Modified Version, together with at least five of the principal
authors of the Document (all of its principal authors, if it has
less than five).</p>
</li>
<li>
<p>State on the Title page the name of the publisher of the
Modified Version, as the publisher.</p>
</li>
<li>
<p>Preserve all the copyright notices of the Document.</p>
</li>
<li>
<p>Add an appropriate copyright notice for your modifications
adjacent to the other copyright notices.</p>
</li>
<li>
<p>Include, immediately after the copyright notices, a license
notice giving the public permission to use the Modified Version
under the terms of this License, in the form shown in the Addendum
below.</p>
</li>
<li>
<p>Preserve in that license notice the full lists of Invariant
Sections and required Cover Texts given in the Document's license
notice.</p>
</li>
<li>
<p>Include an unaltered copy of this License.</p>
</li>
<li>
<p>Preserve the section entitled "History", and its title, and add
to it an item stating at least the title, year, new authors, and
publisher of the Modified Version as given on the Title Page. If
there is no section entitled "History" in the Document, create one
stating the title, year, authors, and publisher of the Document as
given on its Title Page, then add an item describing the Modified
Version as stated in the previous sentence.</p>
</li>
<li>
<p>Preserve the network location, if any, given in the Document for
public access to a Transparent copy of the Document, and likewise
the network locations given in the Document for previous versions
it was based on. These may be placed in the "History" section. You
may omit a network location for a work that was published at least
four years before the Document itself, or if the original publisher
of the version it refers to gives permission.</p>
</li>
<li>
<p>In any section entitled "Acknowledgements" or "Dedications",
preserve the section's title, and preserve in the section all the
substance and tone of each of the contributor acknowledgements
and/or dedications given therein.</p>
</li>
<li>
<p>Preserve all the Invariant Sections of the Document, unaltered
in their text and in their titles. Section numbers or the
equivalent are not considered part of the section titles.</p>
</li>
<li>
<p>Delete any section entitled "Endorsements". Such a section may
not be included in the Modified Version.</p>
</li>
<li>
<p>Do not retitle any existing section as "Endorsements" or to
conflict in title with any Invariant Section.</p>
</li>
</ol>
<p>If the Modified Version includes new front-matter sections or
appendices that qualify as Secondary Sections and contain no
material copied from the Document, you may at your option designate
some or all of these sections as invariant. To do this, add their
titles to the list of Invariant Sections in the Modified Version's
license notice. These titles must be distinct from any other
section titles.</p>
<p>You may add a section entitled "Endorsements", provided it
contains nothing but endorsements of your Modified Version by
various parties--for example, statements of peer review or that the
text has been approved by an organization as the authoritative
definition of a standard.</p>
<p>You may add a passage of up to five words as a Front-Cover Text,
and a passage of up to 25 words as a Back-Cover Text, to the end of
the list of Cover Texts in the Modified Version. Only one passage
of Front-Cover Text and one of Back-Cover Text may be added by (or
through arrangements made by) any one entity. If the Document
already includes a cover text for the same cover, previously added
by you or by arrangement made by the same entity you are acting on
behalf of, you may not add another; but you may replace the old
one, on explicit permission from the previous publisher that added
the old one.</p>
<p>The author(s) and publisher(s) of the Document do not by this
License give permission to use their names for publicity for or to
assert or imply endorsement of any Modified Version.</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN661" id="AEN661">5. COMBINING
DOCUMENTS</a></h4>
<p>You may combine the Document with other documents released under
this License, under the terms defined in section 4 above for
modified versions, provided that you include in the combination all
of the Invariant Sections of all of the original documents,
unmodified, and list them all as Invariant Sections of your
combined work in its license notice.</p>
<p>The combined work need only contain one copy of this License,
and multiple identical Invariant Sections may be replaced with a
single copy. If there are multiple Invariant Sections with the same
name but different contents, make the title of each such section
unique by adding at the end of it, in parentheses, the name of the
original author or publisher of that section if known, or else a
unique number. Make the same adjustment to the section titles in
the list of Invariant Sections in the license notice of the
combined work.</p>
<p>In the combination, you must combine any sections entitled
"History" in the various original documents, forming one section
entitled "History"; likewise combine any sections entitled
"Acknowledgements", and any sections entitled "Dedications". You
must delete all sections entitled "Endorsements."</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN666" id="AEN666">6. COLLECTIONS OF
DOCUMENTS</a></h4>
<p>You may make a collection consisting of the Document and other
documents released under this License, and replace the individual
copies of this License in the various documents with a single copy
that is included in the collection, provided that you follow the
rules of this License for verbatim copying of each of the documents
in all other respects.</p>
<p>You may extract a single document from such a collection, and
distribute it individually under this License, provided you insert
a copy of this License into the extracted document, and follow this
License in all other respects regarding verbatim copying of that
document.</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN670" id="AEN670">7. AGGREGATION
WITH INDEPENDENT WORKS</a></h4>
<p>A compilation of the Document or its derivatives with other
separate and independent documents or works, in or on a volume of a
storage or distribution medium, does not as a whole count as a
Modified Version of the Document, provided no compilation copyright
is claimed for the compilation. Such a compilation is called an
"aggregate", and this License does not apply to the other
self-contained works thus compiled with the Document, on account of
their being thus compiled, if they are not themselves derivative
works of the Document.</p>
<p>If the Cover Text requirement of section 3 is applicable to
these copies of the Document, then if the Document is less than one
quarter of the entire aggregate, the Document's Cover Texts may be
placed on covers that surround only the Document within the
aggregate. Otherwise they must appear on covers around the whole
aggregate.</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN674" id="AEN674">8.
TRANSLATION</a></h4>
<p>Translation is considered a kind of modification, so you may
distribute translations of the Document under the terms of section
4. Replacing Invariant Sections with translations requires special
permission from their copyright holders, but you may include
translations of some or all Invariant Sections in addition to the
original versions of these Invariant Sections. You may include a
translation of this License provided that you also include the
original English version of this License. In case of a disagreement
between the translation and the original English version of this
License, the original English version will prevail.</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN677" id="AEN677">9.
TERMINATION</a></h4>
<p>You may not copy, modify, sublicense, or distribute the Document
except as expressly provided for under this License. Any other
attempt to copy, modify, sublicense or distribute the Document is
void, and will automatically terminate your rights under this
License. However, parties who have received copies, or rights, from
you under this License will not have their licenses terminated so
long as such parties remain in full compliance.</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN680" id="AEN680">10. FUTURE
REVISIONS OF THIS LICENSE</a></h4>
<p>The Free Software Foundation may publish new, revised versions
of the GNU Free Documentation License from time to time. Such new
versions will be similar in spirit to the present version, but may
differ in detail to address new problems or concerns. See <a href=
"http://www.gnu.org/copyleft/" target=
"_top">http://www.gnu.org/copyleft/</a>.</p>
<p>Each version of the License is given a distinguishing version
number. If the Document specifies that a particular numbered
version of this License "or any later version" applies to it, you
have the option of following the terms and conditions either of
that specified version or of any later version that has been
published (not as a draft) by the Free Software Foundation. If the
Document does not specify a version number of this License, you may
choose any version ever published (not as a draft) by the Free
Software Foundation.</p>
</div>
<div class="SECTION">
<hr>
<h4 class="SECTION"><a name="AEN685" id="AEN685">How to use this
License for your documents</a></h4>
<p>To use this License in a document you have written, include a
copy of the License in the document and put the following copyright
and license notices just after the title page:</p>
<a name="AEN688" id="AEN688"></a>
<blockquote class="BLOCKQUOTE">
<p>Copyright (c) YEAR YOUR NAME. Permission is granted to copy,
distribute and/or modify this document under the terms of the GNU
Free Documentation License, Version 1.1 or any later version
published by the Free Software Foundation; with the Invariant
Sections being LIST THEIR TITLES, with the Front-Cover Texts being
LIST, and with the Back-Cover Texts being LIST. A copy of the
license is included in the section entitled "GNU Free Documentation
License".</p>
</blockquote>
<p>If you have no Invariant Sections, write "with no Invariant
Sections" instead of saying which ones are invariant. If you have
no Front-Cover Texts, write "no Front-Cover Texts" instead of
"Front-Cover Texts being LIST"; likewise for Back-Cover Texts.</p>
<p>If your document contains nontrivial examples of program code,
we recommend releasing these examples in parallel under your choice
of free software license, such as the GNU General Public License,
to permit their use in free software.</p>
</div>
</div>
</div>
</div>
</div>
</body>
</html>
|