MDC:Referencia del marcado Wiki
De MDC
Lo que sigue es una hoja de referencias específicas al marcado wiki de MDC que refleja las actualmente "mejores prácticas" para el marcado de páginas en este wiki. Está sujeta a cambios con el tiempo, por ello son más recomendaciones que reglas estrictas.
Si necesita utilizar algún marcado que vaya en contra de lo que se dice en esta guía, hágalo – nadie le va a reñir por ello. Simplemente intente seguir esta guía lo más posible.
Si tiene alguna pregunta sobre estas reglas, contacte con Dria, o pregunte en el canal IRC #devmo o #devmo-es en irc://irc.mozilla.org.
Tabla de contenidos |
[editar] Lo básico
[editar] Secciones, párrafos y líneas nuevas
| Resultado | Marcado |
| Secciones | |
|
Sub-Sección Sub-sub-Sección Sub-sub-sub-Sección Si su documento necesita más de cuatro niveles de sección, le recomendamos que lo divida en páginas más pequeñas y agrupe los enlaces. |
= Sección = == Sub-Sección == === Sub-sub-Sección === ==== Sub-sub-sub=section ==== |
| Párrafos y líneas nuevas | |
|
Un simple retorno de carro entre lineas no hace nada. Dejando una linea en blanco indicamos un nuevo párrafo. Puede |
Un simple retorno de carro entre lineas no hace nada. Dejando una línea en blanco indicamos un nuevo párrafo. Puede<br /> usar etiquetas "br"<br /> para forzar<br /> un salto de línea. |
[editar] Formato de texto
| Resultado | Marcado |
| Formato de texto | |
|
cursiva o énfasis |
''cursiva'' o ''énfasis'' |
|
negrita o destacado |
'''negrita''' o '''destacado''' |
|
negrita cursiva o muy destacado |
'''''negrita cursiva''''' o '''''muy destacado''''' |
|
Aquí un ejemplo de |
Aquí un ejemplo de <code>código en línea</code> |
Así es como
se hacen
bloques de código.
|
<pre>
Así es como
se hacen
bloques de código.
</pre>
|
Blockquotes - Esto es un blockquote, una cita en bloque. |
<blockquote> Blockquotes - Esto es un blockquote, una cita en bloque. </blockquote> |
|
Texto pequeño (small). |
<small>Texto pequeño (small).</small> |
|
Texto grande (big). |
<big>Texto grande (big).</big> |
|
|
<strike>Tachado.</strike> |
|
Subrayado. |
<u>Subrayado.</u> |
|
Superíndice. |
<sup>Super</sup>índice. |
|
Subíndice. |
<sub>Sub</sub>índice. |
[editar] Listas
| Resultado | Marcado |
| Listas con viñetas | |
Listas con viñetas, con sangrías y similares pueden ser cambiadas vía CSS. |
* Manuales ** Referencia ** Guía * Artículos ** Manuales *** JavaScript *** HTML *** CSS ** Consejos y trucos * PUFs - Preguntas frecuentes |
| Listas numeradas | |
Las lista numeradas y su estilo pueden ser cambiadas vía CSS. |
# Manuales ## Referencia ## Guía # Artículos ## Manuales ### JavaScript ### HTML ### CSS ## Consejos y trucos # PUFs - Preguntas frecuentes |
[editar] Enlaces
| Resultado | Marcado |
| Enlaces internos | |
|
Enlace interno a otra página... El 28 de diciembre es El día de los inocentes. |
El 28 de diciembre es [[El día de los inocentes]]. |
|
Enlace interno donde el título de la página es diferente del texto del enlace... El 28 de diciembre no es el cumpleaños de Dria. |
[[El día de los inocentes|El 28 de diciembre]] no es el cumpleaños de Dria. |
|
Enlace interno a una sección específica de otra página... |
[[El día de los inocentes#Cumpleaños|Cumpleaños del día de los inocentes]]. |
|
Título dentro del enlace... En abril, el azafrán comienza a florecer. Los mármoles, son duros. |
En abril, el [[azafrán]] comienza a florecer. Los [[mármol]]es, son duros. |
|
Añadir una firma que enlaza con tu página de usuario... o Dria 13:39, 15 Mar 2005 (EST) |
~~~ o ~~~~ |
| Enlaces externos | |
|
Enlaces planos a URLs... |
http://www.mozilla.org |
|
Enlaces externos con el texto del enlace diferente... |
[http://www.mozilla.org Proyecto Mozilla] |
|
Enlace a un bug en Bugzilla... |
{{bug|322603}}
|
| Enlaces entre wikis (Interwiki) | |
|
TBD |
TBD |
[editar] Comentarios
| Resultado | Marcado |
|
Los comentarios aquí no se muestran en el resultado. Es exactamente lo mismo que los comentarios HTML. Use los comentarios para dejar notas e instrucciones a otros escritores, editores y revisores. |
Los comentarios aquí no se muestran en el resultado. Son exactamente lo mismo que los comentarios HTML. Use los comentarios para dejar notas e instrucciones a otros escritores, editores y revisores. <!--- Aquí está un comentario. ---> |
[editar] Marcado avanzado
[editar] Tablas
| Resultado | Marcado | ||||
| Marcado con tablas | |||||
|
Puede usar el marcado habitual en HTML para hacer tablas en el wiki, o utilizar el marcado wiki. El marcado para tablas del wiki usa menos caracteres, pero esa es la única ventaja real. Utilice el que le sea más cómodo. | |||||
|
<table class="standard-table">
<tr>
<th>encabezado 1</th>
<th>encabezado 2</th>
</tr>
<tr>
<td>celda 1</td>
<td>celda 2</td>
</tr>
</table>
| ||||
|
{| class="standard-table"
|-
|class="header"|encabezado 1
|class="header"|encabezado 2
|-
|-
|celda 1
|celda 2
|-
|}
| ||||
[editar] Imágenes
| Resultado | Marcado |
| Imágenes | |
|
Imagen en una línea...
|
[[Imagen:Firefoxlogo.png]] |
|
Imagen en línea con un texto alternativo...
|
[[Imagen:Firefoxlogo.png|Firefox - Redescubra la web.]] |
|
Miniatura de una imagen con texto alternativo...
|
[[Imagen:netscape-gecko-logo.jpg|thumb|Logo de gecko-netscape.]] |
|
Enlace a una imagen... |
[[media:netscape-gecko-logo.jpg|Logo de gecko-netscape.]] |
[editar] Categorías
Todas las páginas del wiki deberían incluir al menos una Categoría MediaWiki. Para agregar una categoría a una página use la sintaxis siguiente:
[[Categoría:Nombre de la categoría]]
Estos enlaces de categoría deben ser añadidos al final de la página, después del contenido. Incorpore tantos enlaces de categoría como sean necesarios. Por ejemplo, un manual sobre como usar Venkman podría estar en las categorías "Venkman", "Herramientas", y "Manuales".
Todas las categorías, a su vez, deben estar en Categoría:Todas las Categorías.
[editar] Referencias a versiones en otros idiomas
Siempre es agradable cuando hay referencias a otras versiones de una página escrita en otros idiomas. Por ejemplo, para añadir en ésta página una referencia a la versión portuguesa de la misma página, simplemente se agrega la sintaxis siguiente al final de ésta página:
[[pt:Referência de Marcação Wiki]]
En otras palabras, sencillamente se pone un enlace interno al sitio deseado con el prefijo indicativo del idioma de esa página.
Las referencias a las páginas en otros idiomas también funcionan con las páginas de las categorías.
[editar] Ignorar el marcado Wiki
Si necesita que un trozo del marcado wiki sea ignorado por el programa lector, simplemente introdúzcalo entre las etiquetas "nowiki", de esta forma:
<nowiki>'''este marcado wiki no se interpretará'''</nowiki>
'''este marcado wiki no se interpretará'''
[editar] HTML en texto Wiki
Las siguientes etiquetas están permitidas actualmente en el marcado wiki:
[editar] Caracteres especiales
| Resultado | Marcado |
|
Acentos y diéresis: è é ê ë ì í À Á Â Ã Ä Å |
è é ê ë ì í À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü ß à á â ã ä å æ ç è é ê ë ì í î ï ñ ò ó ô œ õ ö ø ù ú û ü ÿ |
|
Puntuación: |
¿ ¡ « » § ¶ † ‡ • - – — |
|
Símbolos comerciales: |
™ © ® ¢ € ¥ £ ¤ |
| Caracteres griegos: α β γ δ ε ζ |
α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σ ς τ υ φ χ ψ ω Γ Δ Θ Λ Ξ Π Σ Φ Ψ Ω |
|
Caracteres matemáticos: |
∫ ∑ ∏ √ − ± ∞ ≈ ∝ ≡ ≠ ≤ ≥ × · ÷ ∂ ′ ″ ∇ ‰ ° ∴ ℵ ø ∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇ ¬ ∧ ∨ ∃ ∀ ⇒ ⇔ → ↔ ↑ |
x2 ≥ 0 true.
|
<i>x</i><sup>2</sup> ≥ 0 true. |
[editar] Extensiones útiles para Firefox
- La Extensión de Wikipedia para Firefox añade una barra de ayuda para etiquetas.
- Soporte para editores de texto externos para Firefox y Mediawiki.
[editar] Otras referencias
[editar] Específicas del MDC
- Clases CSS definidas para todas las páginas del MDC.
- Plantillas de MediWiki creadas para su uso en el MDC con su explicación.
- Como ayudar:
- Si no está seguro de como llamar a su página, visite la guía sobre el nombrado de páginas.
- MDC:Desambiguación