Copyright Philippe Martin 1998&nl; Ta sestavek lahko razširjate in/ali spreminjate, če upoštevate pogoje GNU-jevske splošne licence različice 2 ali poznejše. Zahvale

Posebej se zahvaljujem Sébastienu Blondeelu, ker me je tako mnogo vpraševal o nastavitvah Emacsa. Njegova bistra vprašanja so mi omogočila, da bolje poznam ta urejevalnik in s tem dokumentom prenesem znanje tudi na vas. Pripombe

Ne oklevajte in mi sporočite vsako pripombo in/ali kritiko tega dokumenta, za katero mislite, da bo prispevala k izboljšavi. &nl; Tudi ne oklevajte z zastavljanjem vprašanj, ki se nanašajo na tukaj obravnavane teme, z veseljem vam bom odgovoril. Različice

Ta sestavek obravnava naslednje različice: SGML-Tools različice 0.99, Emacs različice 19.34, Ispell različice 3.1, Vse knjižnice Emacs, na katere se sklicuje ta sestavek, se razširjajo z gornjo različico Emacs, razen Uvod Jezik SGML

Jezik Standard Generalised Mark-up Language) je jezik za definiranje tipov dokumentov.

Na primer, definira se lahko tip dokumenta za kuharski recept, katerega prvi del določa sestavine, drugi del pripomočke, tretji navodila za peko torte, v zadnjem delu pa je prikazana slika končnega rezultata.

Takšna definicija tipa dokumenta se imenuje DTD (ang. Document Type Definition). DTD ne določa izgleda končnega izdelka, temveč le definira, kaj vse lahko vsebuje.

Če spet uporabimo prejšnji primer: prepričan sem, da ste se po branju moje zamisli kuharskega recepta domislili svojega ali recepta vašega priljubljenega kuharja. Vseeno izgledajo drugačni: moj ima fotografijo, ki jo najdete v levem zgornjem kotu kopališke omarice, seznam sestavin pa najdete med bazenom in žarom. In vaš?

Zahvaljujoč tej standardni definiciji se lahko pišejo sestavki, ne da bi morali predvideti njihov izgled, kot ga bo videl bralec. Definicija tipa LinuxDoc

Ta tip omogoča pisanje, kot ste verjetno uganili, dokumentacije, povezane z Linuxom.

Ti dokumenti so navadno sestavljeni takole: začenjajo se z naslovom, ki mu sledi avtorjevo ime in številka različice ter datum. Potem pride povzetek, ki kratko razlaga vsebino sestavka (da vam ni treba brskati po njej za ugotovitev, da to ni to, kar iščete), potem kazalo, ki prikazuje strukturo sestavka, ter omogoča tistim, ki se jim mudi, da preidejo neposredno na del, ki ga želijo brati.

In nadalje sledi zbirka poglavij, razdelkov, odstavkov. Med temi odstavki lahko vstavite kodo programov, spremenite pisavo, da ponazorite besedo ali stavek, vstavljate sezname, se sklicujete na druge dele sestavka, itd.

Za pisanje takšnega sestavka zadostuje na primernem mestu določiti naslov, avtorja, datum in različico sestavka, nato pisati poglavja in razdelke, povedati, kdaj se vstavi seznam in kaj so njegovi elementi, itd. Paket SGML-Tools

Paket SGML-Tools omogoča izdelavo končnega formata dokumenta iz njegovega opisa. Če želite dokument uvrstiti v vašo osebno knjižnico, boste izbrali izhodni format PostScript, če ga želite deliti s svetom na svetovnem spletu, boste izbrali HTML, in če ne morete pomagati in morate stvar brati pod Windows, ga boste spremenili v RTF, da ga boste lahko uvozili v kakšen urejevalnik besedil. Morda boste želeli uporabljati različne fomrate, ki se bodo prilagajali vašem spremenljivem razpoloženju. Paket SGML-Tools je dostopen po anonimnem FTP-ju z arhiva . Vaš prvi sestavek

Iz tekstovne datoteke

Če želite spremeniti vaš tekstovni dokument v DTD LinuxDoc zaradi spremembe v razne druge formate, je to prava pot: Na samem začetku sestavka dodajte naslednje vrstice: