/doc/Basque/manpage-eu.man

  1.TH "TXT2TAGS" 1 "Abu, 2010" ""
  2
  3
  4.SH IZENA
  5
  6.P
  7txt2tags \- testu formateatze eta bihurtze tresna
  8
  9.SH SINOPSIA
 10
 11.P
 12\fBtxt2tags\fR [\fIaukerak\fR] [\fIFITXATEGIA\fR...]
 13
 14.SH DESKRIBAPENA
 15
 16.P
 17\fBtxt2tags\fR markatze minimoa duen testu fitxategi bat irakurri eta ondoko
 18helburuetara bihurtzen du:
 19\fIASCII Art\fR,
 20\fIAsciiDoc\fR,
 21\fICreole\fR,
 22\fIDocBook\fR,
 23\fIDokuWiki\fR,
 24\fIEskuliburu Orria (man)\fR,
 25\fIGoogle Code Wiki\fR,
 26\fIHTML\fR,
 27\fILaTeX\fR,
 28\fILout\fR,
 29\fIMagicPoint\fR,
 30\fIMoinMoin\fR,
 31\fIPageMaker\fR,
 32\fIPmWiki\fR,
 33\fISGML\fR,
 34\fITestu Soila\fR,
 35\fIWikipedia\fR eta
 36\fIXHTML\fR.
 37
 38.P
 39Eskuliburu orri hau \fBtxt2tags\fR\-ek sortua da testu fitxategi soil batetik.
 40Testu fitxategi bera HTML\-ra bihurtu da eskuliburuaren sareko bertsiorako.
 41
 42.P
 43Iturburu BAT, helburu ASKO \- http://txt2tags.org
 44
 45.SH SINTAXIA
 46
 47.nf
 48Goiburukoak               Iturburu fitxategiaren lehenbizko 3 lerroak
 49Izenburua                = hitzak =
 50Zenbakitutako izenburua  + hitzak +
 51Iruzkina                 % iruzkinak
 52Lerro bereizlea          -----------------------...
 53Lerro lodia              =======================...
 54Irudia                   [fitxategia.jpg]
 55Estekak                  [etiketa url]
 56
 57Lodia                    **hitzak**
 58Etzana                   //hitzak//
 59Azpimarratuta            __hitzak__
 60Marratua                 --hitzak--
 61Tarte bakarrekoa         ``hitzak``
 62Testu gordina            ""hitzak""
 63Etiketatua               ''hitzak''
 64
 65Paragrafoa                hitzak
 66Aipamena                 <TAB>hitzak
 67Zerrenda                 - hitzak
 68Zenbakitutako zerrenda   + hitzak
 69Definizioen zerrenda     : hitzak
 70Taula                    | gelaxka1 | gelaxka2 | gelaxka3...
 71
 72Hitzez hitzeko lerroa    ``` hitzak
 73Lerro gordina            """ hitzak
 74Etiketatutako lerroa     ''' hitzak
 75
 76Hitzez hitzeko area      ```
 77                         lerroak
 78                         ```
 79Area gordina             """
 80                         lerroak
 81                         """
 82Area etiketatua          '''
 83                         lerroak
 84                         '''
 85.fi
 86
 87
 88.SH AUKERAK
 89
 90.TP
 91     \fB\-\-art\-chars\fR=\fIPATROIA\fR
 92ASCII Art apainketarako erabiliko diren karaktereak definitzeko \fIPATROIA\fR ezarri, ondoko ordenean: Erpina, ertza, aldea, barra1, barra2, maila2, maila3, maila4, maila5. Defektuzko patroia +\-|\-==\-^" da. Aukera hau ASCII Art helbururako erabiltzeen da bakarrik.
 93
 94.TP
 95 \fB\-C\fR, \fB\-\-config\-file\fR=\fIFITXATEGIA\fR
 96Konfigurazioa kanpoko \fIFITXATEGIA\fR fitxategitik irakurri. Konfigurazioak \fI%!gakoa:balioa\fR formatua izan behar du. EZARPENAK atala ikusi xehetasunentzako.
 97
 98.TP
 99     \fB\-\-css\-sugar\fR
100CSS\-rekin jatorrak diren etiketak txertatu. HTML eta XHTML helburuen kodea CSS fitxategiekin erabiltzeko hobetzen du. Etiketen atributuak kentzen dira, aurkezpen etiketak sahiesten dira, goiburukoak H1, H2 eta H3 etiketekin egiten dira, eta DIV berriak sortzen dira: \fI#header\fR, \fI#body\fR, \fI.toc\fR.
101
102.TP
103     \fB\-\-css\-inside\fR
104CSS fitxategiaren edukiak HTML/XHTML goiburuetan txertatu. \-\-style erabili CSS fitxategia zehazteko.
105
106.TP
107     \fB\-\-dump\-config\fR
108Topatutako konfigurazio guztia inprimatu eta irten.
109
110.TP
111     \fB\-\-dump\-source\fR
112Dokumentuaren iturburua inprimatu, barneratzeko (%!include) guztiak txertatuta.
113
114.TP
115     \fB\-\-encoding\fR=\fIKODEKETA\fR
116Iturburu fitxategian erabiltzen den karaktere kodeketa \fIKODEKETA\fR\-ra ezarri. Adibidez UTF\-8 edo iso\-8859\-1.
117
118.TP
119     \fB\-\-gui\fR
120Tk Interfaze Grafikoa abiatu.
121
122.TP
123 \fB\-h\fR, \fB\-\-help\fR
124Laguntza mezua inprimatu eta irten.
125
126.TP
127 \fB\-H\fR, \fB\-\-no\-headers\fR
128Goiburukoa eta oinaren informazioa helburutik kendu. Edukia (gorputza) bakarrik ikusiko da.
129
130.TP
131     \fB\-\-headers\fR
132Goiburukoa eta oinaren informazioa helburuan erakutsi. Defektuz gaituta.
133
134.TP
135     \fB\-\-height\fR=\fIZENB\fR
136Irteeraren altuera \fIZENB\fR zutabeetan finkatu. Aukera hau ASCII ART helburuarekin bakarrik erabiltzen da, \-\-slides baita erabiltzen bada.
137
138.TP
139 \fB\-i\fR, \fB\-\-infile\fR=\fIFITX\fR
140FITX zehaztu sarrera fitxategi bezela, iturburu dokumentua.  '\-' erabili iiturburuak STDIN\-etik irakurtzeko.
141
142.TP
143     \fB\-\-mask\-email\fR
144Epostak spam robotengandik ezkutatu. @ eta puntuak kentzen ditu.  foo@bar.com helbidea <foo (a) bar com> bihurtzen du.
145
146.TP
147 \fB\-n\fR, \fB\-\-enum\-title\fR
148Gaitu izenburuen zenbakitze automatikoa. Aurrizki moduan 1, 1.1, 1.1.1, ...  erabiliko dira.
149
150.TP
151     \fB\-\-no\-dump\-config\fR
152\-\-dump\-config aukera ezgaitzen du.
153
154.TP
155     \fB\-\-no\-dump\-source\fR
156\-\-dump\-source aukera ezgaitzen du.
157
158.TP
159     \fB\-\-no\-encoding\fR
160Kodeketaren ezarpena garbitu.
161
162.TP
163     \fB\-\-no\-enum\-title\fR
164Izenburuen zenbakitze automatikoa ezgaitu.
165
166.TP
167     \fB\-\-no\-infile\fR
168Aurreko infile guztiak kendu.
169
170.TP
171     \fB\-\-no\-targets\fR
172\-\-targets aukera ezgaitzen du.
173
174.TP
175     \fB\-\-no\-mask\-email\fR
176Epostaz izkutatzea ezgaitu.
177
178.TP
179     \fB\-\-no\-outfile\fR
180Aurreko outfile guztiak kendu.
181
182.TP
183     \fB\-\-no\-quiet\fR
184Mezuak erakutsi, \-\-quiet aukera ezgaituz.
185
186.TP
187     \fB\-\-no\-rc\fR
188Ez irakurri ~/.txt2tagsrc erabiltzailearen konfigurazio fitxategia.
189
190.TP
191     \fB\-\-no\-slides\fR
192Diapositibak ezgaitu.
193
194.TP
195     \fB\-\-no\-style\fR
196Estilo ezarpenak garbitu.
197
198.TP
199     \fB\-\-no\-toc\fR
200Helburuan Edukien Taula kendu.
201
202.TP
203     \fB\-\-no\-toc\-only\fR
204\-\-toc\-only aukera ezgaitzen du.
205
206.TP
207 \fB\-o\fR, \fB\-\-outfile\fR=\fIFITX\fR
208FITX zehaztu irteera fitxategiaren izen bezala. '\-' erabili helbura STDOUT\-era bidaltzeko.
209
210.TP
211 \fB\-q\fR, \fB\-\-quiet\fR
212Modu geldia. Irteera mezurik ez, erroreak ezik.
213
214.TP
215     \fB\-\-rc\fR
216Erabiltzailearen ~/.txt2tagsrc konfigurazio fitxategia irakurri. Defektuz gaituta.
217
218.TP
219     \fB\-\-slides\fR
220Irteera aurkezpen diapositiba bezala formateatu. Aukera hau ASCII Art helburuarekin bakarrik erabiltzen da.
221
222.TP
223     \fB\-\-style\fR=\fIFITX\fR
224FITX erabili dokumentuaren estilo moduan. HTML/XHTML dokumentuen CSS fitxategiak edo LaTeX paketeak definitzeko erabilia. Aukera hau askotan erabili daiteke fitxategi bat baino gehiago sartzeko.
225
226.TP
227\fB\-t\fR, \fB\-\-target\fR=\fIMOTA\fR
228Helburuko dokumentuaren mota \fIMOTA\fR\-ra ezarri. Gehien erabilitako helburuak: \fIhtml\fR, \fIxhtml\fR, \fItex\fR, \fIman\fR, \fItxt\fR. \-\-targtets aukera erabili eskuragarri dauden helburu guztiak ikusteko.
229
230.TP
231     \fB\-\-targets\fR
232Eskuragarri dauden helburu guztiak erakutsi eta irten.
233
234.TP
235     \fB\-\-toc\fR
236Edukien Taula (TOC) automatiko gehitu helburu dokumentura, Goiburukoa eta Gorputzaren artean. TOC\-aren kokapena %%TOC makroarekin zehaztu dezakezu.
237
238.TP
239     \fB\-\-toc\-level\fR=\fIZENB\fR
240Edukien Taularen maila (sakonera) maximoa \fIZENB\fR\-en ezarri. \fIZENB\fR baino sakonago dauden izenburuak ez dira Edukin Taulan sartuko.
241
242.TP
243     \fB\-\-toc\-only\fR
244Dokumentuaren Edukien Taula inprimatu eta irten.
245
246.TP
247 \fB\-v\fR, \fB\-\-verbose\fR
248Bihurketaren bitartean mezu informatiboak inprimatu. Aukera hau behin baino gehiago erabili daiteke jasotako mezu kopurua handitzeko.
249
250.TP
251 \fB\-V\fR, \fB\-\-version\fR
252Programaren bertsioa inprimatu eta irten.
253
254.TP
255     \fB\-\-width\fR=\fIZENB\fR
256Irteeraren zabalera \fIZENB\fR zutabeetan finkatu. Aukera hau ASCII Art helburuarekin bakarrik erabiltzen da.
257
258.SH ITURBURU FITXATEGIAK
259
260.P
261Iturburu fitxategiak gehienetan \fI.t2t\fR luzapenarekin identifikatzen dira (nirefitx.t2t adibidez).
262Zure iturburuak hiru area eduki ditzake:
263
264.TP
265\fBGoiburukoa\fR (aukerakoa)
266Fitxategiaren lehenbiziko hiru lerroak. Zuriz hutsi behar ez badituzu. Dokumentuaren izenburu, egile, bertsio eta datarentzako erabilita.
267
268.TP
269\fBEzarpenak\fR (aukerakoa)
270Goiburukoaren ondoren hasten da (4. edo 2. lerroa) eta Gorputza hasten denean bukatzen da. Konfiguraziorako erabiltzen da, %!gakoa: balioa formatuan.
271
272.TP
273\fBGorputza\fR
274Goiburukoaren ondoren, baliozko lehenbiziko lerroan hasten da (iruzkin edo
275ezarpena ez dena) eta dokumentu bukaerarekin amaitzen da. Dokumentuaren
276edukientzakoe erabiltzen da.
277
278.SH EZARPENAK
279
280.P
281Ezarpenek, aukeren antzera, \fBtxt2tags\fR pertsonalizatzea ahalbidetzen dute. Hiru lekutan erabil daitezke: iturburu dokumentuaren Ezarpenak arean, ~/.txt2tagsrc fitxategian, \-\-config\-\-file aukerarekin zehaztutako kanpoko fitxategi batean.
282
283.TP
284\fB%!target\fR
285Helburu formatua ezartzen du, \-\-target\-ekin bezala. Adibidez:
286.nf
287%!target: html
288.fi
289
290
291
292.TP
293\fB%!options(target)\fR
294Helburu bakoitzerako aukera lehenetsiak zehazten ditu. Komando lerroko aukerak erabili behar dituzu. Adibidez:
295.nf
296%!options(html): --toc --toc-level 3 --css-sugar
297.fi
298
299
300
301.TP
302\fB%!includeconf\fR
303Kanpoko fitxategi batetik unekoan ezarpenak txertatzen du, \-\-config\-file\-k bezala. Adibidez:
304.nf
305%!includeconf: nirekonfigurazioa.t2t
306.fi
307
308
309
310.TP
311\fB%!style\fR
312Dokumentuan erabiltzeko estilo fitxategia ezartzen du, \-\-style\-k bezala. Adibidez:
313.nf
314%!style: koloreak.css
315.fi
316
317
318
319.TP
320\fB%!encoding\fR
321Dokumentuko karaktere kodeketa adierazteko, \-\-encoding\-ek bezala.  Adibidez:
322.nf
323%!encoding: UTF-8
324.fi
325
326
327
328.TP
329\fB%!preproc\fR
330Iturburu dokumentuko Gorputza aldatzeko erabiltzen den bilatu/ordeztu iragazkia, txt2tags\-ek inolako analisia egin BAINO LEHEN. Bilaketak Python\-eko adierazpen erregularrak erabiltzen ditu. Adibidez:
331.nf
332%!preproc:  "JJS"  "John J. Smith"
333.fi
334
335
336
337.TP
338\fB%!postproc\fR
339Sortutako dokumentua aldatzeko erabiltzen den irteerako bilatu/ordeztu iragazkia, txt2tags\-eko prozesu osoaren ONDOREN. Bilaketak Python\-eko adierazpen erregularrak erabiltzen ditu. Adibidez:
340.nf
341%!postproc(html):  "<B>"  "<STRONG>"
342.fi
343
344
345
346.SH KOMANDOAK
347
348.P
349Komandoek bihurketa garaian atazak burutzen dituzte. Iturburu dokumentuaren Gorputzean jarri behar dira.
350
351.TP
352\fB%!csv: fitxategia.csv\fR
353Kanpoko CSV fitxategi bat txertatzen du taula moduan.
354
355.TP
356\fB%!include: fitxategia.t2t\fR
357Dokumentuan txt2tags fitxategi bat txertatzen du.
358
359.TP
360\fB%!include: ``fitxategia.txt``\fR
361Dokumentuan testu fitxategi bat txertatzen du (hitzez hitz).
362
363.TP
364\fB%!include: fitxategia.html\fR
365Dokumentuan dagoeneko etiketatutako fitxategia txertatzen du.
366
367.SH MAKROAK
368
369.P
370Makroak zure dokumentuan eduki dinamikoa sartzeko lasterbide baliagarriak dira. Ituruburuko Gorputzean jarri behar dira. %%toc ezik, makro guztiak %Y eta %f bezalako parametro bereziekin pertsonalizatu daitezke. Begiratu txt2tags\-en Erabiltzaile Gida xehetasunetarako.
371
372.TP
373\fB%%date\fR
374Uneko data txertatzen du. Defektuzko formatua %%date(%Y%m%d) da, UUUUHHEE ematen duena.
375
376.TP
377\fB%%infile\fR
378Iturburu fitxategiaren bidea txertatzeko. Defektuzko formatua %%infile(%f) da. Dokumentuaren oinean [[Ikusi %%infile iturburua]] bezalako estekak jartzeko erabilgarria.
379
380.TP
381\fB%%mtime\fR
382Iturburu fitxategiaren aldaketa data txertatzeko. Defektuzko formatua %%mtime(%Y%m%d) da, UUUUHHEE ematen duena.
383
384.TP
385\fB%%outfile\fR
386Irteerako fitxategiaren bidea txertatzeko. Defektuzko formatua %%outfile(%f) da. "Hau manpage\-eu.man fitxategia da" bezalako aipamenentzako erabilgarria.
387
388.TP
389\fB%%toc\fR
390Edukien Taula non agertu behar den zehazten du. Behin baino gehiagotan
391adieraz dezakezu. Ohartu \-\-toc aukera erabili beharko duzula baita ere.
392
393.SH ADIBIDEAK
394
395.TP
396txt2tags \-t html fitx.t2t
397
398HTMLra bihurtu, fitx.html\-n gordez.
399
400.TP
401txt2tags \-t html \-o \- fitx.t2t
402
403HTMLra bihurtu, emaitzak STDOUT\-era bidaliz.
404
405.TP
406txt2tags \-t html \-\-toc fitx.t2t
407
408HTMLra bihurtu, Edukien Taula automatikoarekin.
409
410.TP
411txt2tags \-t html \-\-toc \-\-toc\-level 2 \-n fitx.t2t
412
413HTMLra bihurtu, bi mailatako Edukien Taularekin eta zenbakitutako izenburuekin.
414
415.TP
416txt2tags \-\-toc\-only fitx.t2t
417
418Edukien Taula erakutsi bakarrik, bihurketarik egin gabe.
419
420.TP
421txt2tags \-t html \-\-css\-sugar \-\-style oinarrizkoa.css \-\-style ui.css fitx.t2t
422
423HTMLra bihurtu, sortutako kodea CSSrekin erabiltzeko prestatuz, eta kanpoko bi CSS fitxategi erabiliz.
424
425.TP
426txt2tags \-t art \-\-slides \-\-width 80 \-\-height 25 \-o \- file.t2t | more
427
428Sortu ASCII Art aurkezpen diapositibak, 80x25\-eko terminal/leihoan ikusteko prest.
429
430.TP
431(echo ; echo "**bold**") | txt2tags \-t html \-H \-
432
433Lerro bakarreko dei lagungarria STDIN erabiliz froga azkarrak egiteko.
434
435.TP
436txt2tags \-t html \-o \- file.t2t | tidy > file.html
437
438Emaitzak STDOUTera bidali eta ondoren kanpoko programa baten bidez txukundu fitxategian gorde baino lehen.
439
440.SH FITXATEGIAK
441
442.TP
443~/.txt2tagsrc
444Erabiltzailearen defektuzko konfigurazio fitxategia.
445
446.SH INGURUNEA
447
448.TP
449T2TCONFIG
450Null ez bada, erabiltzailearen defektuzko konfigurazio fitxategiaren bide osoa adierazten du.
451
452.SH EGILEA
453
454.P
455Aurelio Jargas <verde@aurelio.net>
456
457.P
458Eskuliburu orriaren euskara itzulpena Ales Zabala Alava\-k (Shagi) <shagi@gisa\-elkartea.org> egin du.
459
460.SH ERROREAK
461
462.P
463http://bugs.txt2tags.org
464
465.SH COPYRIGHT
466
467.P
468Copyright (C) 2001\-2010 Aurelio Jargas, GNU GPL v2
469
470.\" man code generated by txt2tags 2.6 (http://txt2tags.org)
471.\" cmdline: txt2tags -t man doc/Basque/manpage-eu.t2t