moodle/lang/es/help/advanced_markdown.html

142 lines
6.9 KiB
HTML
Raw Normal View History

2005-05-13 07:28:20 +00:00
<h2>Uso avanzado de Markdown</h2>
<div id="Main">
<div class="article">
<p>Esta secci<63>n ampl<70>a la informaci<63>n b<>sica ofrecida en la secci<63>n titulada 'Mejora del texto con Markdown' para proporcionar a quienes lo requieran la informaci<63>n necesaria para sacar el m<>ximo partido de Markdown. Si no es su caso, o no necesita los formatos que se muestran m<>s abajo, puede pasar por alto esta secci<63>n y regresar en caso necesario.</p>
<ul>
<li><a href="#linebreaks">Saltos de l<>nea</a></li>
<li><a href="#hr">Reglas horizontales</a></li>
<li><a href="#image_links">Im<EFBFBD>genes enlazadas</a></li>
<li><a href="#embedded">HTML anidado</a></li>
<li><a href="#preformatted">C<EFBFBD>digo pre-formateado</a></li>
<li><a href="#special_char">Uso de caracteres especiales</a></li>
<li><a href="#further">Lecturas adicionales</a></li>
</ul>
<h2><a id="linebreaks">Saltos de l<>nea</a></h2>
<p>En algunos textos, e.g. poes<65>a, a menudo es preciso insertar saltos de l<>nea. Hacerlo pulsando la tecla de retorno no producir<69> el efecto deseado toda vez que por defecto las l<>neas se juntan para crear un p<>rrafo.</p>
<p><strong><code>Si, como el Griego afirma en el Cratilo,<br />
El nombre es arquetipo de la cosa,<br />
En las letras de 'rosa' est<73> la rosa,<br />
Y todo el Nilo en la palabra 'Nilo'.</code></strong></p>
<p>En las l<>neas anteriores, si se utiliza la tecla ENTER para insertar saltos de l<>nea, se producir<69> el efecto que se ve a continuaci<63>n, de suerte que los saltos de l<>nea son pasados por alto:</p>
<p>Si, como el Griego afirma en el Cratilo,
El nombre es arquetipo de la cosa,
En las letras de 'rosa' est<73> la rosa,
Y todo el Nilo en la palabra 'Nilo'.</p>
<p>Pero si al final de cada l<>nea pulsamos dos espacios, forzaremos un salto de l<>nea como aparece a continuaci<63>n:</p>
<p>Si, como el Griego afirma en el Cratilo,<br />
El nombre es arquetipo de la cosa,<br />
En las letras de 'rosa' est<73> la rosa,<br />
Y todo el Nilo en la palabra 'Nilo'. </p>
<h2><a id="hr">Reglas horizontales</a></h2>
<p>Podemos crear reglas horizontales escribiendo tres o m<>s asteriscos (*), guiones (-) o guiones bajos (_) en una l<>nea.</p>
<p>As<EFBFBD> funciona:</p>
<p><strong><code>***</code></strong></p>
<p>pero usted puede a<>adir espacios o caracteres adicionales para conseguir un salto de secci<63>n en la ventana de edici<63>n de texto, e.g.:</p>
<p><strong><code>* * * * *</code></strong></p>
<p><strong><code>-------------------------</code></strong></p>
<p><strong><code>_ _ _ _ _</code></strong></p>
<p>Todos estos m<>todos conducen al mismo resultado:</p>
<hr />
<h2><a id="image_links">Im<EFBFBD>genes enlazadas</a></h2>
<p>El documento "Mejora del texto con Markdown" proporciona instrucciones para crear enlaces web y para insertar im<69>genes. Puede no resultar obvio que es posible combinarlos para crear im<69>genes que son al mismo tiempo enlaces sobre los que se puede hacer clic.</p>
<p><strong><code>[motor de b<>squeda google][google]</code></strong></p>
<p><strong><code>![logo de google][logo]</code></strong></p>
<p>Sobre esta l<>nea aparece un enlace web y una imagen est<73>ndar. Colocando la imagen en el lugar en que deber<65>a estar el texto de enlace, se consigue esto:</p>
<p><strong><code>[![the google logo][logo]][google]</code></strong></p>
<p><strong><code>[![logo de google][logo]][google]</code></strong></p>
<p>La l<>nea superior junto con las siguientes definiciones del enlace en cualquier lugar del documento</p>
<p><strong><code>[logo]: http://www.google.com/images/logo.gif</code></strong><br />
<strong><code>[google]: http://www.google.com/ "clic para visitar Google.com"</code></strong></p>
<p>se combinan para producir el siguiente enlace a la imagen sobre el que se puede hacer clic (apareciendo una indicaci<63>n cuando pasamos el rat<61>n sobre <20>l):</p>
<p><a href="http://www.google.com/" title="pulse aqu<71> para visitar Google.com"><img src="http://www.google.com/images/logo.gif" alt="el logo de google" /></a></p>
<p>Esta t<>cnica podr<64>a resultar <20>til, pongamos por caso, si utilizamos peque<75>as im<69>genes en miniatura enlazadas para descargar desde ellas las correspondientes im<69>genes m<>s grandes.</p>
<h2><a id="embedded">HTML anidado</a></h2>
<p>Si usted es h<>bil utilizando HTML, entonces puede haber ocasiones en que Markdown no le permitir<69> un contol tan exhaustivo como aqu<71>l al que est<73> habituado. Por fortuna, Markdown est<73> dise<73>ado para esta eventualidad y le permite anidar HTML directamente dentro de un texto formateado en Markdown.</p>
<p><strong><code>* &lt;small&gt;texto peque<75>o&lt;/small&gt;</code></strong><br />
<strong><code>* &lt;big&gt;texto grande&lt;/big&gt;</code></strong> </p>
<ul>
<li><small>texto peque<75>o</small> </li>
<li><big>texto grande</big> </li>
</ul>
<p>Advierta que la marca HTML coexiste con el c<>digo Markdown en las listas con topos. Esto lo libera a usted de la enojosa tarea de escribir HTML complejo para conseguir caracter<65>sticas b<>sicas de formateado tales como p<>rrafos y listas, en tanto que le sigue permitiendo contar con toda la potencia de HTML en situaciones espec<65>ficas.</p>
<h2><a id="preformatted">Mostrar HTML o texto pre-formateado</a></h2>
<p>Si, a diferencia de la secci<63>n anterior, usted desea que el HTML que introduce aparezca exactamente como lo ha escrito en lugar de ser procesado como HTML, entonces puede comenzar cada l<>nea con cuatro espacios.</p>
<pre><code>&lt;p&gt;Un p<>rrafo en &lt;b&gt;HTML&lt;/b&gt; mostrado como c<>digo&lt;/p&gt;
</code></pre>
<p>Esto tambi<62>n funciona para mostrar el c<>digo del ordenador</p>
<pre><code>imprimir "Argumentos de l<>nea de comandos: (@ARGV)\n";
</code></pre>
<p>Dado que este formateado con frecuencia se usa para confeccionar listas de programas de ordenador y otro texto que previsiblemente puede contener los caracteres que Markdown utiliza para indicar distintos tipos de formateado, el formato Markdown queda deshabilitado en estas l<>neas:</p>
<pre><code>Normalmente esta palabra ser<65>a **bold**.
</code></pre>
<p>Para incluir algunos caracteres dentro del texto normal, v<>ase la secci<63>n siguiente.</p>
<h2><a id="special_char">Uso de caracteres especiales</a></h2>
<p>Si desea utilizar cualesquiera de los caracteres especiales que ponen en marcha el formateado Markdown sin que sean procesados, simplemente escriba antes una barra invertida (\). Esto se ha venido en llamar 'escape' del car<61>cter. La barra invertida no es visible en el resultado, pero s<> el car<61>cter que le sigue, exactamenta como ha sido escrito.</p>
<p><strong><code>\*asteriscos, sin <20>nfasis\*</code></strong></p>
<p>produce</p>
<p>*asteriscos, sin <20>nfasis*</p>
<p>en lugar de</p>
<p><strong><code>*<2A>nfasis, sin asteriscos*</code></strong></p>
<p>lo que resulta en</p>
<p><em><EFBFBD>nfasis, sin asteriscos</em></p>
<h2><a id="further">Lecturas adicionales</a></h2>
<p>El sistema Markdown no es exclusivo de Moodle, sino que se utiliza en un n<>mero progresivamente creciente de herramientas de publicaci<63>n web. Puede encontrar m<>s informaci<63>n sobre <20>l en <a href="http://daringfireball.net/projects/markdown/">http://daringfireball.net/projects/markdown/</a></p>
</div></div>