Creando y editando páginas

Este artículo presenta a nuevos editores al proceso de modificación de páginas existentes y creación de páginas nuevas.

Editar una página existente

Editar una página es fácil: simplemente haz clic en el botón azul "Editar" a la derecha del título de la página. La página se actualizará con las opciones de formato para que puedas añadir o eliminar la información directamente en la página. Puedes añadir párrafos, borrar texto, insertar títulos y más.

Consulte la guía de Elementos UI del Editor en la Guía del Editor de MDN para obtener más información sobre el uso del editor incorporado de MDN.

Vista previa de cambios

Para ver cómo lucen tus modificaciones has clic en el botón "Vista previa" en la parte superior derecha de la página de edición. Una página de vista previa que incluye tus cambios se abrirá en una nueva ventana o pestaña. Puedes ver tus modificaciones con la frecuencia que desees, y cada vez que pulses el botón, podrás actualizar tu página de vista previa con los últimos cambios.

¡Ten cuidado! La vista previa de una página no guarda tu progreso, así que recuerda no cerrar tu pestaña de edición abierta.

Comentario de revisión

Después de haber previsualizado los cambios, tendrás que guardarlos. En la parte inferior de la página de edición se encuentra el cuadro de Comentario de la revisión.Antes de guardar, desplázate hacia abajo y deja un comentario para decir a otros colaboradores por qué hiciste el cambio.
Por ejemplo, puede que hayas cambiado algunas palabras para usar la terminología más coherente, reescrito un párrafo para aclarar el lenguaje o eliminado información porque era redundante.

Tabla de Contenidos

La sección 'Saltar a' de un artículo es una lista autogenerada de enlaces a los encabezados de la página. La redacción los elementos de esta sección se realiza editando el títulos de cada sección del documento. También es posible eliminar una tabla de contenido o disminuir su número de enlaces, seleccionando 'Traducir descripción' (o Edit Page Title and Properties si tienes seleccionado inglés como idioma del editor) y luego cambiando cambiando el valor del menú desplegable "TOC".

Etiquetas

Puedes añadir o quitar etiquetas que describen el contenido de la página y la función debajo de la sección de la página. Mira cómo etiquetar las páginas apropiadamente para información en lo que se pueden aplicar las etiquetas.

¿Se necesita revisión?

Si un experto o colaborador con experiencia debería revisar tus ediciones, puedes solicitar una revisión técnica (en el código, APIs, o tecnologías), una revisión editorial (para la prosa, la gramática y el contenido), o una revisión de plantillas (para el código KumaScript) asegurándote de que la casilla esté seleccionada antes de guardar.

Adjuntar archivos

Si desearas adjuntar un archivo a una página existente para agregar una ilustración o posterior aclaración, puedes añadir archivos adjuntos en la parte inferior de la página. Para más información vísita la sección Archivos adjuntos en el editor MDN

Guardar, descartar o seguir editando

Cuando hayas terminado de editar y estés contento con tu vista previa, guarda tus cambios y comentarios pulsando el enlace Guardar cambios a la derecha del título de la página.

Si cambias de opinión, puedes descartar las ediciones pulsando el botón rojo Descartar cambios a la derecha del título de la página.

Si desea continuar trabajando, haga clic en Publicar y seguir editando, lo que publicará sus cambios y mantendrá abierta la interfaz de edición.

Presionar Enter en el campo Comentario de revisión equivale a hacer clic en Publicar y seguir editando.

Nota: Si intenta guardar, pero los cambios se rechazan como no válidos y considera que el contenido es apropiado para MDN, envía un email al equipo de administradores de MDN para asistencia.

Obteniendo permisos de creación de página

Por razones de seguridad, las cuentas recién creadas no tienen la capacidad de crear nuevas páginas. Si intentas hacerlo, verás una página que te indica cómo crear la página. Hay dos opciones:

  • Solicite que se cree la página para usted. Para hacer esto, cree un ticket de solicitud, con el título "Create page: <page title>". Complete el campo URL de la plantilla con la ubicación en MDN donde desea que vaya la página si sabe dónde colocarla. En el texto del comentario, incluya información sobre por qué es necesario crear esta página.
  • Solicitar privilegios de creación de página. Si solicita privilegios de creación de páginas, y se les otorgan, podrá agregar nuevas páginas. Para solicitar estos privilegios, envíe un correo electrónico al equipo de administración de MDN con su solicitud. Incluya su nombre de usuario y porqué le gustaría tener la capacidad de crear nuevas páginas. Por ejemplo, Ud. está documentando una nueva API que involucra muchas páginas nuevas, o desea agregar nuevos términos al glosario. También debería haber hecho contribuciones útiles al contenido de este sitio y haber contribuido durante algún tiempo. Este período de tiempo y los otros factores se consideran colectivamente.

Crear una nueva página

Una vez que tenga permiso de los administradores, puede comenzar a crear páginas.

Si no sabes dónde poner un nuevo artículo, ¡no te preocupes! Ponlo en cualquier lugar y lo encontraremos y moveremos a donde pertenece o lo uniremos a un contenido existente si así tuviera más sentido. Tampoco necesitas preocuparte por que quede perfecto. Tenemos gnomos felices que ayudarán a que tu contenido quede limpio y reluciente!

Estas son algunas formas de crear una nueva página:

Vínculo a 'Página no existente'

Como con la mayoría de los wikis, es posible crear un enlace a una página que aún no existe. Por ejemplo, un autor puede crear una lista de todos los miembros de una API, antes de crear las páginas para esos miembros. En MDN, los enlaces a páginas inexistentes se muestran en rojo.

Para crear una página desde un enlace de 'página no existente':

  1. Inicie sesión en MDN y tenga permiso para crear páginas. Si no ha iniciado sesión, al hacer clic en el enlace 'página faltante' se produce un error 404 (página no encontrada).
  2. Haga clic en el enlace 'página faltante'. Si tiene permiso para crear una página, se abre la interfaz de usuario de MDN Editor, lista para que cree la página que falta.
  3. Escriba el contenido de la página y guárdelo.

Nueva página sin enlace

Para crear una página sin enlace desde otra página, ingresa un único nombre de página en el campo de la URL de tu navegador. Por ejemplo, si ingresas:

https://developer.mozilla.org/en-US/docs/FooBar

MDN crea una nueva página con el título "FooBar" y se abre el editor para que puedas agregar contenido a la nueva página. Vé a la sección Editar una página existente de este artículo para ver cómo usar el modo de edición.

Para crear una nueva página sin vincular desde otra página:

  1.      Inicie sesión y tenga permiso para crear páginas.
  2.      Ingrese lo siguiente en el campo URL de su navegador:
https://wiki.developer.mozilla.org/en-US/docs/new

MDN crea una nueva página, con un lugar para un título, abriendo el editor para agregar nuevo contenido a esta página. Consulte Creando y editando páginas para obtener información sobre el uso del modo editor.

Subpágina de una página existente

Para crear una página que quieres que esté debajo de otra en la jerarquía de páginas:

  1. En la página "padre", haz click en el menú Avanzado (el ícono engranage en la barra de herramientas), y haz click en la Nueva sub-página. Una vista de editor se abrirá para crear un nuevo documento.
  2. Tipea un título para el documento en el campo Título.
  3. Cambia el campo Slug si es necesario (por ejemplo, si el título es muy largo y quieres una URL más corta). Este campo se completa automáticamente por el editor sustituyendo espacios por guiones bajos en el título. En este caso, puedes cambiar sólo la última parte de la URL del documento.
  4. En el campo TOC, elige los niveles de encabezado que se mostraran automáticamente en la table de contenidos, o "Sin tabla de contenidos" si la página no necesita.
  5. Escribe contenido de la pagina en la caja del editor y guarda tus cambios. Vé a la sección Editar una página existente de este artículo para ver cómo usar el modo de editor.

Clonar una página existente

Si hay una página existente cuyo formato quieres usar para una nueva, puedes "clonar" la página y luego cambiar el contenido.

  1. En la página original, haz click en el menú Avanzado (el ícono engranage de la barra de herramientas), y haz click en Clonar esta página. Un visor del editor se abre para crear un nuevo documento.
  2. Cambia el Título de la página para que sea más apropiado con el nuevo contenido. El campo Slug se actualizará automáticamente cuando lo hagas.
  3. Si es necesario, cambia la porción de ruta del campo Slug, para poner el nuevo documento en una parte diferente de la jerarquía. (En la mayoría de los casos, esto no es necesario porque la página clonada tiene contenido similar a la original y en consecuencia deberían localizarse en un lugar similar.)
  4. En el campo TOC, selecciona los niveles de encabezado que quieres que se muestren automáticamente en la tabla de contenidos para la página  o "Sin tabla de contenidos" si la página no necesita.
  5. Escribe el contenido de la página en la caja del editor y graba tus cambios. Vé a la sección Editar una página existente de este artículo para ver cómo usar el modo de editor.

Enlace desde una página existente

Este tipo de creación es un poco híbrido. Puede crear un enlace en otra página, luego haga clic en el enlace que acaba de insertar para crear la nueva página:

  1. Ingresa el nombre de la nueva página en cualquier parte del texto (que tenga sentido) de una página existente.
  2. Resalta el nombre y cliquea en el ícono de enlaces () de la barra del editor. se abrirá el diálogo "Actualizar enlace", con el texto subrayado en el campo "Enlazar a".
  3. Por defecto, se inserta "/es/docs/" al comienzo del campo URL. Ingresa el nombre de la página después de eso. (El nombre no tiene que ser necesariamente el mismo del texto del enlace.)
  4. Haz click en Ok para crear e insertar el enlace.

Si la página ya no existe, se muestra el enlace en rojo. Si ya existe, el enlace se muestra en azul. Si quieres crear una nueva página pero el título de la página ya está en uso, primero verifica si tiene más sentido ayudar a editar y mejorar la página que ya existe allí. De otra manera, piensa en un título diferente para tu nueva página y créale un enlace. Vé a la guía de nombres de la página para tener referencias.

Para agregar contenido a tu nueva página, haz click en el enlace rojo que acabas de crear (luego de guardar y cerrar el editor). Se abre la nueva página en modo de edición para poder empezar a escribir. Ve a la sección Editar una página existente de este artículo para ver cómo usar el modo de edición.

Actualizando el contenido de la página

La compatibilidad de MDN con las macros de KumaScript y la integración del contenido de otras páginas a veces pueden verse obstaculizadas por la necesidad de almacenar en caché las páginas, por razones de rendimiento. Las páginas se crean a partir de su fuente, y esta salida se almacena en caché para futuras solicitudes. A partir de ese momento, las macros (plantillas) o las integraciones (que usan la macro Page) no reflejarán los cambios posteriores realizados en la macro, su salida o el contenido del material integrado.

  • Para actualizar manualmente una página, actualice forzadamente su navegador web (Shift + F5). MDN detecta esto, desencadenando una reconstrucción de la página, obteniendo una salida de macro actualizada e integrando el contenido de la página.
  • You can also configure pages to periodically rebuild, automatically. This should not be done unless you expect the page to update frequently. See Page regeneration, for detailed information.
  • También puede configurar páginas para que se reconstruyan periódicamente, automáticamente. Esto no debe hacerse a menos que espere que la página se actualice con frecuencia. Consulte Renderizado de páginas en MDN, para obtener información detallada.

Ver también