Crear y editar enlaces

Nota: Toma en cuenta que tenemos  preferencias en el estilo de los vínculos (en ingles). Éstas se describen en esta página y en la guía de estilo (sección no disponible en español todavía).

Usar la barra de herramientas

La forma más obvia de crear un vínculo es hacer clic en el botón "vínculo" en la  barra  de herramientas, o presionar Ctl +K (Command +K en MacOs). El botón vinculo se ve así: el boton enlace 
(usado desde 4/mayo/2015). Puedes usar esta característica para crear un vínculo desde cero, o para añadir un vínculo a texto ya existente.

Crear vínculo desde cero

Una vez que hayas hecho clic en el botón vínculo, aparecerá la ventana de edición de vínculo, como se muestra aquí abajo:

menu editor cinculos

Aquí puedes crear el nuevo vínculo; los campos en esta ventana son:

Tipo de vínculo 
Es el tipo de vínculo que vas a crear. El valor por defecto es URL (Localizador uniforme de recursos), la URL es para especificar una dirección web, ya sea en la MDN o en cualquier sitio web externo.
También puedes elegir las opciones "Referencia en esta página" o "E-mail", la opción "Referencia en esta pagina"  te permite crear un vínculo a una referencia que hayas insertado anteriormente en la página usando el botón Referencia anchor button (anchor) de la barra de herramientas, si no has insertado ninguna referencia te mostrara un mensaje recordándotelo. La opción E-mail te permite insertar un vinculo mailto: para que el lector pueda enviar un correo (se abre una nueva ventana para el lector) a la dirección de correo electrónico que especifiques; tienes la opción de añadirle titulo y cuerpo. Casi siempre utilizaras la opcion URL.
Búsqueda del título del artículo / Texto del vínculo
Este campo tiene dos propósitos: el primero es permitirte especificar el texto del vínculo si no quieres que se muestre la URL completa; el segundo es buscar artículos en MDN que coincidan con el texto que pongas en este campo para crear un vínculo a ellos. Por ejemplo, si escribes "JavaScript" en este campo, veras algo como esto:
Aquí puedes ver una lista de títulos de páginas en MDN que incluyen el texto que escribiste. Puedes elegir una de ellas, o seguir escribiendo para encontrar otras opciones. Ten en cuenta que las opciones de la lista indican el idioma ("[es]" en este caso). El texto que indica el idioma "[es]" no aparece en el texto del vínculo; solo aparece para ayudarte a saber que estas creando un vínculo a un articulo de MDN que está disponible en el mismo idioma que estas editando.
Archivos adjuntos
También puedes hacer que el vínculo sea un enlace a algún archivo que se haya adjuntado a la página seleccionándolo en la opción: archivos adjuntos. Esta es una excelente manera para compartir código fuente (Source code), imágenes, o cualquier otro archivo para que el lector lo descargue.
URL
Por último, el campo URL te deja escribir directamente (o copiar/pegar) la URL; si elegiste un artículo de MDN en el campo Búsqueda del título del artículo / Texto del vínculo o seleccionaste un archivo en el campo Archivos adjuntos se mostrará la URL de estos. Es algo común copiar y pegar las URLs de otras páginas en MDN que estés revisando, sin embargo, el nombre del dominio (https://developer.mozilla.org) se debe borrar ya que no es necesaria.                                                                                                  Por ejemplo: https://developer.mozilla.org/es/docs/MDN/Contribute/Editor

Cuando el vínculo este configurado, haz clic en el botón: ok button [es] para insertarlo.

Existe una segunda pestaña—Avanzado—en la ventana del editor de vínculo. Por el momento, no te aconsejaremos usar alguna de las opciones en esa pestaña. Es posible que en el futuro existan diferentes estilos para los vínculos, pero es probable que se añadan nuevos widgets a la barra de herramientas para usar esas características cuando estén disponibles.

Vincular texto existente

Si hay alguna porción de texto que quieras convertir a un vínculo, puedes simplificar el proceso un poco. Selecciona la porción de texto que quieras convertir a un vínculo antes de abrir la ventana del editor de vínculos; esto añadirá el texto seleccionado al campo Búsqueda del articulo / Texto del vinculo. Por ejemplo; digamos que tenemos el siguiente texto

Anita lava la tina JavaScript la tina lava Anita

Y nosotros queremos que "JavaScript" sea un vínculo que nos enlace a una página relacionada con JavaScript. Solo selecciona esa palabra y abre el editor de vínculos. Al colocar el cursor sin hacer clic sobre alguna opción, podrás ver su "slug" (parte de la dirección URL que aparece después del nombre de dominio), el cual te puede dar una mejor idea de donde se localiza el artículo y que tipo de artículo es.

Aquí puedes buscar y elegir la opción que mejor te parezca. Al elegir cualquier opción (por ejemplo "Acerca de JavaScript [es]") automáticamente se llenará el campo de la ULR y podrás simplemente hacer clic en el boton ok button [es] y convertir el texto seleccionado en un vínculo, como a continuación:

Anita lava la tina JavaScript la tina lava Anita.

Usar macros de vínculos

MDN utiliza mucho las macros para crear vínculos automática y apropiadamente de un término, al mismo tiempo que le da el estilo correcto al vínculo de acuerdo con nuestra guía de estilo. Toma en cuenta esto: nuestra guía de estilo indica que los términos API, los elementos y atributos HTML, las propiedades CSS, el nombre de métodos, y parecidos, se les debe dar el estilo con el elemento: <code>. También, usualmente, deben ser vínculos que enlacen a la respectiva página en MDN

Toma algo de tiempo acostumbrarse a crear vínculos usando macros, pero tiene varias ventajas:

  • Aplica el estilo apropiado por ti.
  • Crea el vínculo por ti—y este es aprueba de futuros cambios en la estructura de MDN.
  • También puede crear descripciones emergentes (tooltips) para ti.

Existen demasiadas macros y nosotros no las veremos todas aquí. En vez de eso, veremos algunos ejemplos de las más comunes. Para ver la lista completa, mira la sección "Creating hyperlinks" (no disponible en español actualmente) en nuestra guía Custom macros for MDN. No cuesta nada revisar el código fuente de KumaScript (vinculo no disponible en español) para encontrar cualquier macro; la mayoría de estas tienen comentarios que explican cómo funcionan y cúales son sus parámetros, si es que tiene.

Crear vinculos a la documentacion para APIs.

Tenemos un numero de macros que resultan de mucha ayuda para crear vínculos con el estilo apropiado para las APIs. Aquí presentamos algunas de las más útiles; en cada caso, tal vez existan parámetros que puedas añadir para tener más control sobre lo que se va a mostrar (por ejemplo: evitar que se aplique el estilo del elemento: <code> ). Puedes hacer clic en cualquier nombre de macro de las 4 que se enlistan aquí abajo, para leer el código fuente de la macro (solo en inglés); todas las macros tienen comentarios al inicio que explican su funcionamiento y cuáles son sus parámetros.

HTMLElement
Inserta el nombre de un elemento HTML, con el vínculo y estilo apropiado. Por ejemplo: {{HTMLElement("table")}} se convierte en: <table>.
cssxref
Inserta una propiedad CSS, una regla-at (at = @), o la documentación de un selector en la referencia CSS. Por ejemplo: {{cssxref("background- color")}} te da como resultado: background-color.
domxref
Inserta un vinculo hacia la referencia API web de un término API. Por ejemplo: {{domxref("window")}} se convierte en: window y {{domxref("window.scrollBy()")}} se convierte en: window.scrollBy().
SVGElement
Inserta el nombre de un elemento SVG, con el vínculo y estilo correcto. Por ejemplo: {{SVGElement("circle")}} se convierte en: <circle>.

Crear vínculo a una seccion en el mismo artículo

Para crear un vínculo que te dirija a una sección dentro del mismo artículo/página, puedes usar la macro: anch La sintaxis es muy clara: {{anch ("Nombre de la seccion")}}. Por defecto, el texto del vínculo es el título de la sección, pero puedes agregar un segundo parámetro (opcional) que sirve para mostrar el texto del segundo parámetro en vez del título de la sección. Aquí un ejemplo:

Crear vínculos hacia bugs

Puedes crear un vínculo a un bug (error) en la base de datos de Mozilla con la macro: bug Esta macro acepta solo un parámetro: el número del bug al cual queremos dirigirnos. Por ejemplo, {{bug (765642)}} se ve así: error 765642.

Del mismo modo, puedes crear vínculos a bugs de otros navegadores web:

Microsoft Edge
EdgeBug: {{edgebug(10569045)}} se convierte en Edge bug 10569045.
Google Chrome
ChromeBug: {{chromebug(31277)}} se convierte en Error Chromium 31277.
WebKit (Safari, etc.)
WebkitBug: {{webkitbug(31277)}} se convierte en WebKit bug 31277.

Crear vínculos a RFCs

Mucho de la raíz del funcionamiento de la internet está documentado en los RFCs (Request For Comments). Puedes fácilmente hacer una referencia a un RFCs usando la macro: RFC Por ejemplo, {{RFC(2616)}} se convierte en: RFC 2616. Opcionalmente puedes añadir texto que sirva como texto del vínculo y/o también puedes añadir el numero de la sección dentro del articulo RFC al cual se va a dirigir el vínculo.

Crear vínculo a información acerca de las interfaces XPCOM

El staff de MDN ya no se encarga de mantener la documentación de XPCOM, pero cualquier contribución voluntaria es bienvenida.

Si estas documentando partes internas de Mozilla, la capacidad de crear vínculos a la documentación de las interfaces XPCOM es de mucha ayuda. Existen algunas macros para esto.

La sintaxis para crear un vinculo a toda la información de una interface es solamente la siguiente: {{interface("nombre de la interface")}}. Por ejemplo, si escribes:

Cuando necesites analizar o crear URIs, la interface: {{interface ("nsIIOService")}} te puede ayudar.

El resultado se verá así:

Cuando necesites analizar o crear URIs, la interface: nsIIOService te puede ayudar.

Si necesitas crear un vínculo a la información de un método o un atributo especifico de una interfaz XPCOM, la macro: ifmethod y la macro: ifattribute son para ti. Estas aceptan como parámetros el nombre de la interfaz y el nombre del método o atributo al cual quieres referenciar. La macro: ifmethod es particularmente interesante, ya que crea un formato especial que añade los paréntesis obligados por la guía de estilo después del nombre del método. Por ejemplo, {{ifmethod("nsIIOService", "newURI")}} se convierte en nsIIOService.newURI(). Este es uno de los casos en el que eres protegido de posibles cambios futuros en la guía de estilo.

Crear vínculo a la documentación de las preferencias de Mozilla

Para insertar el nombre de una preferencia Mozilla y hacer que se enlace con la página que le corresponde en la Preference reference (no disponible en español todavía) usa la macro: pref Esta macro acepta un parámetro: el nombre completo de la preferencia al cual quieres enlazar. Por ejemplo, puedes usar esto: {{pref ("javascript.options.showInConsole")}} para crear esto: javascript.options.showInConsole.

Crear vinculo a un archivo de codigo fuente de Mozilla

Puedes crear vínculos a archivos de código fuente de Mozilla (aunque probablemente no lo hagas muy seguido) usando la macro source. En vez de especificar la URL completa del archivo, puedes simplemente especificar una dirección en la carpeta /source/ sin escribir todo lo que le antecede. Por ejemplo: {{source("browser/Makefile.in")}} crea este vínculo: browser/Makefile.in (la dirección completa seria: https://dxr.mozilla.org/mozilla- central/source/browser/Makefile.in).

Opcionalmente, también puedes especificar el texto del vínculo con el que se va a mostrar el vínculo. Por ejemplo, puedes escribir esto: {{source ("browser/Makefile.in", "el archivo makefile de la carpeta browser")}} para que se muestre esto:: el archivo makefile de la carpeta browser.

Si tienes interés en aprender más acerca de usar macros, visita las paginas mencionadas en la sección: Usar macros de vínculos y checa nuestra documentación de KumaScript para aprender más acerca del propio sistema de macros.

Crear vínculo a contenido recomendado

Si quieres crear una lista de páginas relacionadas, o de algún otro material de lectura recomendado, puedes hacerlo creando un grupo de "quicklinks" en la barra lateral que se muestra al inicio de la página; este mecanismo reemplaza nuestra sección "véase también" que se mostraba al final del artículo. Los detalles acerca de cómo crear grupos de "quicklinks", visita: Quicklinks (no disponible en español todavía).

Esquemas URL

Por razones de seguridad, solo debes crear vínculos que usen los siguientes esquemas:

  • http://
  • https://
  • ftp://
  • mailto:

Tal vez otros esquemas puedan funcionar o no, pero no están aprobados y probablemente sean eliminados por el staff editorial.

Esquemas especiales de URL tales como about: y chrome: son usados por Firefox, Google Chrome, y otros navegadores para dar acceso a contenido especial como las preferencias, información acerca de debugging, y más. Esos vínculos no funcionan dentro de los artículos de MDN, por lo tanto, no intente crear vínculos usando esos esquemas. Lo mismo aplica para los esquemas: javascript: y jar: que están bloqueados por la mayoría de los navegadores modernos como medida de precaución.

Etiquetas y colaboradores del documento

Colaboradores en esta página: wbamberg, 0zxo, LeoHirsch
Última actualización por: wbamberg,