/doc/Basque/manpage-eu.man

http://txt2tags.googlecode.com/ · Unknown · 471 lines · 340 code · 131 blank · 0 comment · 0 complexity · c70b02c0c1537fc41a310a028bbb4c45 MD5 · raw file

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