[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:24 (UTC)] – [Introduction] slackwarespanoles:howtos:software:asciidoc [2019/08/26 17:05 (UTC)] (actual) – [Sources] slackwarespanol
Línea 7: Línea 7:
 // asciidoc // es una de las herramientas que proporcionan un marcado tan consistente. El resaltado de fuente, para aquellos que lo prefieren, puede aumentar la legibilidad del archivo de texto. // asciidoc // es una de las herramientas que proporcionan un marcado tan consistente. El resaltado de fuente, para aquellos que lo prefieren, puede aumentar la legibilidad del archivo de texto.
  
-// asciidoc // puede producir archivos HTML, una ventaja adicional ya que permite interconectar notas y hace que navegar con // lynx // sea más efectivo. También puede funcionar en conjunto con [[es:howtos:software:man2html_mini_howto | man2html]] para proporcionar acceso HTML a todas las páginas // man // instaladas sobre la marcha.+// asciidoc // puede producir archivos HTML, una ventaja adicional ya que permite interconectar notas y hace que navegar con // lynx // sea más efectivo. También puede funcionar en conjunto con [[howtos:software:man2html_mini_howto | man2html]] para proporcionar acceso HTML a todas las páginas // man // instaladas sobre la marcha.
  
 Para una lectura interesante sobre // asciidoc // ver [[https://medium.com/@chacon/living-the-future-of-technical-writing-2f368bd0a272|Living the Future of Technical Writing (Viviendo el futuro de la escritura técnica)]]. Para una lectura interesante sobre // asciidoc // ver [[https://medium.com/@chacon/living-the-future-of-technical-writing-2f368bd0a272|Living the Future of Technical Writing (Viviendo el futuro de la escritura técnica)]].
 ===== Helper Packages and Files ===== ===== Helper Packages and Files =====
 ==== Asciidoctor ==== ==== Asciidoctor ====
-Consider installing [[http://asciidoctor.org/|Asciidoctor]]. +Considere instalar [[http://asciidoctor.org/|Asciidoctor]].
 ==== Dblatex ==== ==== Dblatex ====
-To convert //asciidoc// files to PDF, install +Para convertir archivos // asciidoc // PDF, instale 
-[[http://slackbuilds.org/graphics/dblatex/|dblatex]] from SlackBuilds.org. See+[[http://slackbuilds.org/graphics/dblatex/|dblatex]] de SlackBuilds.org. Ver
 [[http://dblatex.sourceforge.net/|documentation]], [[#PDF]]. [[http://dblatex.sourceforge.net/|documentation]], [[#PDF]].
- +==== Fuente resaltada ==== 
-==== Source-highlight ==== +Para resaltar listados de origeninstale 
-To highlight source listingsinstall +[[http://slackbuilds.org/system/source-highlight/|source-highlight]] de SlackBuilds.org. Consulte [[https://www.gnu.org/software/src-highlite/source-highlight.html|manline en línea]]. 
-[[http://slackbuilds.org/system/source-highlight/|source-highlight]] from SlackBuilds.org. See [[https://www.gnu.org/software/src-highlite/source-highlight.html|online manual]]. +Esta:
-This:+
 <code> <code>
 [source,bash] [source,bash]
Línea 31: Línea 29:
 </code> </code>
  
-renders as (this is DokuWiki'GeSHi highlightingbut gives the general idea):+se muestra como (este es el resaltado GeSHi de DokuWikipero da la idea general):
 <code bash> <code bash>
 #!/bin/bash #!/bin/bash
Línea 38: Línea 36:
  
  
-==== Vim Syntax Highlighter ==== +==== Marcador de sintaxis de Vim ==== 
-If //asciidoc.vim// is not available locally, [[https://asciidoc.googlecode.com/hg/vim/syntax/asciidoc.vim|download]]. Otherwise:+Si //asciidoc.vim// no está disponible localmente, [[https://asciidoc.googlecode.com/hg/vim/syntax/asciidoc.vim|download]]. De otra manera:
  
 **''$ mkdir -p $HOME/.vim/syntax''** **''$ mkdir -p $HOME/.vim/syntax''**
  
 **''$ cp /usr/share/vim/vimVERSION/syntax/asciidoc.vim $HOME/.vim/syntax/''** **''$ cp /usr/share/vim/vimVERSION/syntax/asciidoc.vim $HOME/.vim/syntax/''**
 +y vea [[http://www.methods.co.nz/asciidoc/chunked/ape.html|Appendix E. Vim Syntax Highlighter]].
  
-and see [[http://www.methods.co.nz/asciidoc/chunked/ape.html|Appendix E. Vim Syntax Highlighter]]. +El resaltado también puede funcionar insertando en la parte inferior del archivo:
- +
-Highlighting can also work by inserting at the bottom of the file: +
 <code>// vim: set syntax=asciidoc:</code> <code>// vim: set syntax=asciidoc:</code>
  
  
  
-===== User Guide ===== +===== Guía del usuario ===== 
-The user guide file is found in ///usr/doc/asciidoc-VERSION/doc/asciidoc.txt//To make the //AsciiDoc User Guide//:+El archivo de la guía del usuario se encuentra en ///usr/doc/asciidoc-VERSION/doc/asciidoc.txt//Para hacer la // Guía del usuario de AsciiDoc //:
  
-**''$ asciidoc -b xhtml11 -a icons -a iconsdir=/etc/asciidoc/images/icons FILENAME''** +** '' $ asciidoc -b xhtml11 -a icons -a iconsdir = / etc / asciidoc / images / icons FILENAME '' **
- +
-and see ///usr/doc/asciidoc-VERSION/doc/asciidoc.html//. For more see [[http://asciidoc.org/|asciidoc.org]].+
  
 +y ver ///usr/doc/asciidoc-VERSION/doc/asciidoc.html//. Para más información, consulte [[http://asciidoc.org/|asciidoc.org]].
 ===== Source Files ===== ===== Source Files =====
 ==== TXT ==== ==== TXT ====
 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 filesmake a directory //include//Common pathsfor examplecan be put in a //paths.txt// as a series of:+Para organizar el uso de variables comunes en todos los archivoscree un directorio // include //. Las rutas comunespor ejemplose pueden poner en //paths.txt// como una serie de:
  
 <file> <file>
Línea 71: Línea 66:
 </file> </file>
  
-Thenat the header of each file put:+Luegoen el encabezado de cada archivo, coloque:
  
 <file> <file>
Línea 77: Línea 72:
 </file> </file>
  
-and in text use as:+y en uso de texto como:
  
 <file> <file>
Línea 83: 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 96: Línea 91:
  
 ==== Man ==== ==== Man ====
-Linking to //man// pages in HTML is very usefulSee [[howtos:software:man2html_mini_howto|man2html Mini HOWTO]] on how to set the infrastructureTo see grep(1) use+Vincular a // man // páginas en HTML es muy útilConsulte [[howtos: software: man2html_mini_howto | man2html Mini HOWTO]] sobre cómo configurar la infraestructuraPara 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 103: 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 iconosprincipalmente para párrafos de advertenciaagregue las opciones:
-To use iconsmainly for admonition paragraphsadd the options:+
  
 **''-a icons -a iconsdir=/etc/asciidoc/images/icons''** **''-a icons -a iconsdir=/etc/asciidoc/images/icons''**
  
- +Para tener un HTML de ancho fijoagregue:
-To have a fixed-width HTML, add:+
  
 **''-a max-width=45em''** **''-a max-width=45em''**
  
- +Para usar CSS personalizado adicionalagregue:
-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 133: Línea 124:
  
 ==== PDF ==== ==== PDF ====
-To make a PDF filefirst install [[#dblatex]]. Then:+Para hacer un archivo PDF, primero instale [[#dblatex]]. Entonces:
  
 **''$ asciidoc -b docbook45 FILENAME''** **''$ asciidoc -b docbook45 FILENAME''**
Línea 141: Línea 132:
 ==== DokuWiki ==== ==== DokuWiki ====
  
-The //asciidoc// files can be converted to //DokuWiki// format for the Slackware Documentation ProjectThere are various ways to do thisand 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 estoy 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 150: 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}}
 es:howtos:software:asciidoc ()