Comenzando con Kuma

Esta es una guía introductoria a la plataforma wiki Kuma soportado por MDN. "Kuma" es la palabra japonesa denominada para "oso"; elegimos este nombre porque es una criatura más grande, más poderoso que Kitsune, el software en el cual esta basado soporta el sitio web SUMO.

Nota: Gran parte de esto necesita colocarse en el contenido de las instrucciones MDN, y esto no es necesario que bien organizado.

Proceso de desarrollo

Servidores

Tenemos varios servidores de MDN, basado en el estado de desarrollo de la plataforma.

Entorno URL Objetivos
Desarrollo https://developer-dev.allizom.org/ Nuevos arreglos y características se añaden inmediatamente después de pasar la revisión del código.
Beta https://developer.allizom.org/ Características y correcciones de Beta que serán impulsadas en la fase de producción.
Producción https://developer.mozilla.org/ El servidor MDN activo. El que usted está viendo.

Seguimiento del desarrollo

Usted puede ver la información acerca de la reciente actualización de los cambios de código en el servidor de producción, en nuestra Página de cambios.

Cosas que trabajan de forma diferente

Redirecciones

A veces es necesario tener una página que simplemente redirige a otra página, o a una sección de otra página. Esto puede ser necesario si una página se fusionó con otra página en algún momento de su creación, por ejemplo. Afortunadamente, esto es fácil de hacer. Usted puede simplemente haga clic en el botón de redirigir en la barra de herramientas, el cual se parece a esto:.

Se abrirá un cuadro de diálogo preguntando por el nombre del documento de destino y su dirección URL. El nombre no es muy importante, pero es sobre todo útil, si usted está buscando en la página de redireccionamiento y quieren saber hacia donde está redirigiendo. La URL debe ser una ruta completa desde la base de la página, como "/ en-US/docs/foo". La URL relativa no funcionará. Sin embargo, se puede especificar una sección dentro de la página de destino con el caracter almohadilla ("#"), como por ejemplo "/destino/url/aquí#nombre_sección". Esto le permite redirigir al usuario directamente a la sección de la página de destino.

Creación de vínculos de destino

Por defecto, usted crea vínculos especificando la función de anclaje (es decir, la parte que sigue a "#"), el nombre del encabezado de la sección que desea establecer el vínculo. Sin embargo, si usted está preocupado de que esto podría romperse si los encabezados se cambian con el tiempo, hay una manera de crear referencias permanentes para los encabezados. Sólo tiene que añadir el atributo nombre, para el elemento del encabezado. Actualmente, usted necesita hacer esto en el editor de código fuente, pero en el futuro tenemos la intención de tener una interfaz de usuario para esto. He aquí un ejemplo de cómo podría ser de parecido en la fuente:

<h2 name="Doing_foo">All about foo</h2>

Ahora la forma de la se puede acceder a esta sección, aunque cambie el texto del título, utilizando {{anch ("Doing foo")}}, o mediante el uso de "/ en-US/path/to/article # Doing_foo" como el destino del enlace .

Nuevas características de Kuma

Localización y traducción

KumaScript

Ver Introducción a KumaScript

Ejemplos en acción

Puede crear muestras en acción en Kuma añadiendo etiquetas especiales. Por ejemplo:

<section id="live-sample">
  <pre class="brush: html"><p class="shadow">text-shadow</p></pre>
  <pre class="brush: css">.shadow { text-shadow: 1px 1px 2px black, 0 0 1em blue, 0 0 0.2em blue; }</pre>
  <pre class="brush: js">window.alert("Alert!")</pre>
</section>

Nota: Usted debe envolver los bloques de código para los elementos no fragmentados - es decir, <section> en lugar de <ul>

Para ver muestras en acción, utilizar un iframe con la dirección: http://page-url$samples/{section_id}Por ejemplo, https://developer.mozilla.org/en-US/docs/Project:Getting_started_with_Kuma$samples/live_samples.

<p class="shadow">text-shadow</p>
.shadow { text-shadow: 1px 1px 2px black, 0 0 1em blue, 0 0 0.2em blue; }
console.log("Alert!")

Nota: Véase la documentación sobre este tema en la guía editor MDN para obtener más información acerca de cómo utilizar la herramientas integradas para facilitar la construcción de muestras en acción.

Encontrar páginas

Hay algunas consultas de búsqueda especiales que usted puede utilizar para encontrar las cosas:

URL Descripcion
https://developer.mozilla.org/admin/wiki/document/?slug__startswith=term Las búsquedas de páginas que comienzan con term.
https://developer.mozilla.org/admin/wiki/document/?slug__contains=term Las búsquedas de páginas que comienzan con term.

Adjuntos

Usted puede ver una lista de todos los archivos adjuntos.

Automatización y feeds

Kuma ofrece una API para recuperar información y (finalmente) la actualización automática de contenidos. Ver La API Kuma para más detalles.

Además, Kuma ofrece una serie de canales RSS que usted puede utilizar para controlar el lugar. Ver Kuma RSS feeds.

Véase también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: Sheppy, SamuelGJ
 Última actualización por: Sheppy,