texinfo - Wikilingue - Encydia
| Texinfo | |
|---|---|
| Desarrollador | |
| Karl Berry http://texinfo.Org/ | |
| Ĝenerala informo | |
| Lasta stabila versio | 4.13Al 18a de septembro 2008 --> |
| Varo | Dokumentado |
| Platformo | Multiplataforma |
| Licenco | GNU Ĝenerala Public License |
| En la hispana | ? |
Texinfo[1] estas sistemo tipográfico por la preparado de dokumentado tiel en linio kiel presita de sola dosiero fonto. implementa kun programo de libera programaro de la sama nomo, kreita kaj eldonita de la Projekto GNU.
La ĉefa intenco de Texinfo estas havigi simplan formon de skribi manlibrojn de programaro. Simila al la sintakso de LaTeX, ĉiuj normalaj karakterizaĵoj de libro, kiel ĉapitroj, sekcioj, referencoj transiritaj, tabuloj kaj indicoj estas disponeblaj por uzo en dokumentoj. Uzante la diversaj generatoroj de eliroj kiuj estas disponeblaj en Texinfo, ĝi eblas gardi multajn tipojn de dokumentado ĝisdatigitaj (kiel la dokumentado en provizita linio vojo loko retejo, presita dokumentado, kiel la generita uzante la sistemo tipográfico TeX) uzante sola enarkivigas fonton. Kiel la hinda manlibro, "TeX laboras kun virtuale ĉiuj impresoras; Info laboras kun virtuale ĉiuj fina stacioj de komputiloj; la eliro HTML laboras kun virtuale ĉiuj navegadores retejo. Tiam, Texinfo eblas uzita de preskaŭ ajna uzanto de komputiloj".
Enhavo |
Dosiero fonto Texinfo
Texinfo permesas strukturi dokumenton kiel libro kun ĉapitroj, sekcioj, referencoj transiritaj kaj indicoj. La plej granda parto de la teksto fonto estas ebena teksto, sed teknike estas teksto formateado markita de comandos kiu komencas kun "@". Specimeno parcial de dosiero fonto estus:
@Ifnottex
@documentencoding ISO-8859-1
@documentlanguage estas
@node Top
@top mallonga Ekzemplo
@insertcopying
@end ifnottex
@menu
* Ĉapitro 1:: La unua ĉapitro estas la
sola en ĉi tiu ekzemplo.
* Indico:: kompleta Indico.
@End menu
La strukturo de comandos de markoj, tiaj kiel la ĉapitroj, denota parto de la teksto fonto kiu estos procesita nur por iuj tipoj de eliro.
Internacionalización
Por ke ĝi povas elporti aliajn lingvojn kaj karakteroj en la tekstoj, ekzistas du specialaj markoj, oni estas @documentlanguage por establi la lingvon de la teksto, kaj la alia estas @documentencoding, por la kodigo de karakteroj, kiel la akcentoj kaj la "ñ" se la lingvo estas la hispano.
En la kazo de la lingvoj, @documentlanguage ll[_cc], kie "ll" estas la kodo de la lingvo (estas: hispano, de: germano, ktp) kaj "cc" estas laŭvola, kaj ĝi indikas la landon, ekzemple @documentlanguage de_DE estas por la germano, parolita en Germanio.[2]
Koncerne al la kodigo de karakteroj Texinfo elportas la sekvajn kodigojn:[3]
- US-ASCII: karakteroj de la alfabeto en la angla, ĝi ne akceptas karakterojn de aliaj lingvoj.
- UTF-8: internaciaj karakteroj Unicode al 8 bitoj
- ISO-8859-1 (Latin 1), ISO-8859-15 (Latin 9), ISO-8859-2 (Latin 2): laŭ la normoj ISO, okcidentaj eŭropanoj la du unuaj, la lasta estas por la lingvoj de Orienta Eŭropo (kiuj ne uzas cirilajn karakterojn).
- KOI8-R, KOI8-Aŭ: Por la ruso kaj la ukraino respektive.
Ekzemple, por la hispana lingvo, ĝi povus uzi la kombinon:
@Documentencoding ISO-8859-1 @documentlanguage estas
En sistemoj Windows estas komuna la kodigo de arkivoj de teksto en ISO-8859-1, dum kiu en sistemoj unix, unicode UTF-8. La kodigo ISO-8859-15 (iomete malsama de la ISO-8859-1), ĝi korpigas la simbolon €.
Eliro generita
Por fari ebla kiu diversaj formatoj de eliro de dokumentado eblas ĝisdatigitaj sola fojo, kun nur ŝanĝi la originalan arkivon en Texinfo, multaj conversores de sintakso estas disponeblaj por ke ili eblas uzitaj en generi transliteraciones de la arkivo Texinfo en aliaj formatoj. La plimulto de ili estas kreitaj uzante la programo makeinfo, kiu estas parto de la dissendo GNU Texinfo. La formatoj de eliro elportitaj de Texinfo inkludas ebenan tekston, info, HTML, DVI, PDF, XML kaj DocBook.
- HTML
- (Eliro generita kun makeinfo --html) Kiel HTML estas la lingvo normo por dokumentoj prezentitaj en la World Wide Retejo, ĉi tiu formato de eliro eblas uzita efektive por produkti paĝojn de dokumentado online. La notoj de la manlibro de Texinfo klarigas ke la programo makeinfo provas restringuir liaj arkivoj de eliro al iu subconjunto de markita en HTML kiu eblas legita de tantos navegadores kiu eblu.
- DVI
- (Eliro generita kun texi2dvi) La formato de sendependa arkivo de mekanismoj estas generita de la sistemo de tipografía TeX, kaj ĝi eblas uzita por generi comandos specifaj al ĉiu mekanismo kiun ili eblas viditaj aŭ presitaj; ekzemple, tradukado al PostScript (arkivoj ps).
- (Eliro generita kun text2dvi --pdf aŭ texi2pdf) De la lingvo PostScript, ĉi tiu formato estis disvolvita de Adobo Systems por interŝanĝo de dokumentoj portables. Kiel la formato PostScript, ĝi povas reprezenti la ĝustan ŝajnon de dokumento kaj ĝi elportas grimpita arbitra. Estas desegnita por esti sendependa de la platformo kaj ĝi eblas vidita en granda vario de aplikoj. Texinfo uzas la programon pdftex, varianto de TeX, por generi PDF.
- DocBook
- (Eliro generita kun makeinfo --docbook) Ĉi tiu estas lingvo de markita bazita en XML por teknika dokumentado kiu havas simila al Texinfo, en esbozos ampleksaj. Estas Ankaŭ eble Igi arkivojn Docbook al Texinfo, uzante la programo docbook210a.
- XML
- (Eliro generita kun makeinfo --xml) Por ĝenerala intenco.
- Info
- (Eliro generita kun makeinfo) Ĉi tiu estas specifa formato kiu esence estas versio en ebena teksto de la originala sintakso de Texinfo en konjunkcio kun kelka karakteroj de kontrolo por disigi nodojn kaj havigi elementojn de navigacio por menúes, referencoj transiritaj, sekcioj kaj aliaj elementoj.
Por la presitaj formatoj en papero Texinfo uzas TeX kun la celo havigi la necesajn instrukciojn tia kiu la comandos Texinfo interpretu kvazaŭ estis propraj de TeX.
Estas destacable la foresto de la paĝoj man kiel formato de eliro. Texinfo uzas por skribi kaj formatear la dokumentado de la programaro GNU kiu kutime estas uzata en medioj de tipo Unikso, tiaj kiel GNU/Linukso, kie la tradicia formato por la dokumentado estis la paĝoj man. Ĉi tiuj paĝoj havas konvenciojn de formato tre striktaj, dum kiu la normala apliko de Texinfo centras en tutorías kaj manlibroj de referenco. Sekve ne ŝajnas esti profito en la uzo de Texinfo por krei paĝojn man, kiu estas tradicie gvidas de rapida referenco. Tamen, multaj programoj GNU pergeñan paĝoj man introductorias (ofte autodeclaradas sen bontenado), moderiĝante al la dokumento Info responda. Al lin antaŭa oni devus aldoni lin kiu Texinfo generas en unua petskribo la sistemo de dokumentado Info, kies radikoj estas en la interna sistemo de dokumentado de GNU Emacs, apartenanta al malsama tradicio al la de Unikso.
Historio kaj aktuala stato
La formato Texinfo estis kreita de Richard M. Stallman, dum kiu la disvolviĝo de la dissendo de programaro estis ĉefita de Brian Fox (ĝis la versio 3.8) kaj Karl Berry (post la versio 3.8).
Texinfo estas uzata kiel la oficiala sistemo de formateado de la dokumentado Info de la Projekto GNU. Texinfo eldonas sub la Ĝenerala Publika Licenco de GNU kaj estas parto de la projekto GNU.
Notoj kaj referencoj
- ↑ La oficiala dokumentado de Texinfo avertas ke la unua silabo de "Texinfo" prononcas kiel en "speck", ne kiel en "hex"; ĉi tiu prononco derivas de la de TeX. En la vorto "TeX", ŝin "Χ" estas la greka litero "Ji" kaj ne la eks angla "litero". "TeX" prononcas kvazaŭ ĝi iris al ŝi "Χ" la lastan sonon en la nomo "Bach", sed "Texinfo" prononcas kvazaŭ ĝi iris ŝin "k". Estas pli, la nomo "Texinfo" devas skribi kun nur majusklo (la "T") kaj la resto kun minuskulaj literoj.
- ↑ Free Programaro Foundation, Inc.. «@Documentlanguage ll[_cc: Serio the Document Language]» (en la angla). GNU, GNU Texinfo manlibro.
- ↑ Free Programaro Foundation, Inc.. «@Documentencoding enc: Serio Input Encoding» (en la angla). GNU, GNU Texinfo manlibro.
Vidu ankaŭ
Eksteraj ligoj
- Paĝo de Texinfo (en la angla)
- Manlibro de Texinfo (en la angla)
- Manlibro de Texinfo (en la hispana)
