[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

Ambos lados, revisión anteriorRevisión previa
Próxima revisión		Revisión previa
es:howtos:software:asciidoc [2019/08/26 14:44 (UTC)] – [User Guide] slackwarespanoles:howtos:software:asciidoc [2019/08/26 17:05 (UTC)] (actual) – [Sources] slackwarespanol
Línea 59: Línea 59:
 It is a //convention// for //asciidoc// files to have a //.txt// extension. It is a //convention// for //asciidoc// files to have a //.txt// extension.
  
-==== Common Variables ==== +==== Variables comunes ==== 
-To organize the use of common variables in all files, make a directory //include//. Common paths, for example, can be put in a //paths.txt// as a series of:+Para organizar el uso de variables comunes en todos los archivos, cree un directorio // include //. Las rutas comunes, por ejemplo, se pueden poner en //paths.txt// como una serie de:
  
 <file> <file>
Línea 66: Línea 66:
 </file> </file>
  
-Then, at the header of each file put:+Luego, en el encabezado de cada archivo, coloque:
  
 <file> <file>
Línea 72: Línea 72:
 </file> </file>
  
-and in text use as:+y en uso de texto como:
  
 <file> <file>
Línea 78: Línea 78:
 </file> </file>
  
-==== System Attributes ==== +==== Atributos del sistema ==== 
-Any variable that can be defined in //bash// with  +Cualquier variable que se pueda definir en // bash // con 
-**''NAME="$(commands)"''** +** '' NOMBRE = "$ (comandos)" '' ** 
-can also be defined in //asciidoc// as a [[http://asciidoc.org/userguide.html#X24|system attribute]]. First define the attribute in the header section:+también se puede definir en // asciidoc // como un [[http://asciidoc.org/userguide.html#X24|system attribute]]. Primero defina el atributo en la sección del encabezado:
 <file> <file>
 :NAME: {sys:commands} :NAME: {sys:commands}
 </file> </file>
-then use in text as:+luego usar en texto como:
 <file> <file>
 {NAME} {NAME}
Línea 91: Línea 91:
  
 ==== Man ==== ==== Man ====
-Linking to //man// pages in HTML is very useful. See [[howtos:software:man2html_mini_howto|man2html Mini HOWTO]] on how to set the infrastructure. To see grep(1) use+Vincular a // man // páginas en HTML es muy útil. Consulte [[howtos: software: man2html_mini_howto | man2html Mini HOWTO]] sobre cómo configurar la infraestructura. Para ver grep (1) use
 <file> <file>
 http://localhost/cgi-bin/man/man2html?1+grep[grep(1)] http://localhost/cgi-bin/man/man2html?1+grep[grep(1)]
Línea 98: Línea 98:
 ===== Output ===== ===== Output =====
 ==== XHTML ==== ==== XHTML ====
-To make an HTML file:+Para hacer un archivo HTML:
  
 **''$ asciidoc -b xhtml11 FILENAME''** **''$ asciidoc -b xhtml11 FILENAME''**
- +Para usar iconos, principalmente para párrafos de advertencia, agregue las opciones:
-To use icons, mainly for admonition paragraphs, add the options:+
  
 **''-a icons -a iconsdir=/etc/asciidoc/images/icons''** **''-a icons -a iconsdir=/etc/asciidoc/images/icons''**
  
- +Para tener un HTML de ancho fijo, agregue:
-To have a fixed-width HTML, add:+
  
 **''-a max-width=45em''** **''-a max-width=45em''**
  
- +Para usar CSS personalizado adicional, agregue:
-To use additional custom CSS, add:+
  
 **''-a stylesheet=/path/to/stylesheet.css''** **''-a stylesheet=/path/to/stylesheet.css''**
  
- +Puede ser útil poner un alias en //.bashrc//:
-It may be helpful to put an alias in //.bashrc//:+
 <code bash> <code bash>
 alias ad="/usr/bin/asciidoc.py \ alias ad="/usr/bin/asciidoc.py \
Línea 128: Línea 124:
  
 ==== PDF ==== ==== PDF ====
-To make a PDF file, first install [[#dblatex]]. Then:+Para hacer un archivo PDF, primero instale [[#dblatex]]. Entonces:
  
 **''$ asciidoc -b docbook45 FILENAME''** **''$ asciidoc -b docbook45 FILENAME''**
Línea 136: Línea 132:
 ==== DokuWiki ==== ==== DokuWiki ====
  
-The //asciidoc// files can be converted to //DokuWiki// format for the Slackware Documentation Project. There are various ways to do this, and one of the more straightforward ones is to convert the HTML files produced by //asciidoc// using the //perl// module [[http://search.cpan.org/~diberri/HTML-WikiConverter-DokuWiki-0.53/lib/HTML/WikiConverter/DokuWiki.pm|HTML::WikiConverter::DokuWiki]], see also [[http://search.cpan.org/dist/HTML-WikiConverter/lib/HTML/WikiConverter.pm|HTML::WikiConverter]].+Los archivos // asciidoc // se pueden convertir al formato // DokuWiki // para el Proyecto de documentación de Slackware. Hay varias formas de hacer esto, y una de las más sencillas es convertir los archivos HTML producidos por // asciidoc // usando el módulo // perl // [[http://search.cpan.org/~diberri /HTML-WikiConverter-DokuWiki-0.53/lib/HTML/WikiConverter/DokuWiki.pm|HTML::WikiConverter::DokuWiki]], consulte también [[http://search.cpan.org/dist/HTML-WikiConverter/lib /HTML/WikiConverter.pm|HTML::WikiConverter]].
  
 **''# cpan''** **''# cpan''**
Línea 145: Línea 141:
  
  
-====== Sources ======+====== Fuentes ====== 
 + 
 +   * Fuente original: [[http://www.linuxquestions.org/questions/slackware-14/asciidoc-mini-howto-4175528145/|asciidoc mini howto]] 
 +   * Originalmente escrito por [[wiki:usuario:pdi | pdi]] 
 +   * Contribuciones de [[wiki: usuario:markand | markand]] 
 +   * Traducido por [[wiki: usuario:slackwarespanol | Víctor]] 2019/08/26 17:03 (UTC)
  
-  * Original source: [[http://www.linuxquestions.org/questions/slackware-14/asciidoc-mini-howto-4175528145/|asciidoc mini howto]] 
-  * Originally written by [[wiki:user:pdi | pdi]] 
-  * Contributions by [[wiki:user:markand | markand]] 
  
 {{tag>howtos asciidoc}} {{tag>howtos asciidoc}}

Traza:

es:howtos:software:asciidoc ()