From 1109132f09d75da9a28b649c7677bb6ce07c40c0 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:41:45 -0500 Subject: initial commit --- files/es/mdn/about/index.html | 145 +++++ files/es/mdn/comunidad/index.html | 54 ++ files/es/mdn/contribute/community/index.html | 118 ++++ files/es/mdn/contribute/feedback/index.html | 46 ++ files/es/mdn/contribute/getting_started/index.html | 142 +++++ .../convert_code_samples_to_be_live/index.html | 44 ++ .../contribute/howto/crear_cuenta_mdn/index.html | 32 + .../howto/document_a_css_property/index.html | 82 +++ .../plantilla_propiedad/index.html | 120 ++++ .../howto/enlace_cuenta_github/index.html | 110 ++++ .../howto/etiquetas_paginas_javascript/index.html | 83 +++ files/es/mdn/contribute/howto/index.html | 15 + .../howto/remover_macros_experimentales/index.html | 48 ++ .../contribute/howto/revision_editorial/index.html | 54 ++ .../contribute/howto/revision_tecnica/index.html | 44 ++ .../howto/set_the_summary_for_a_page/index.html | 118 ++++ files/es/mdn/contribute/howto/tag/index.html | 385 ++++++++++++ .../index.html" | 78 +++ .../write_a_new_entry_in_the_glossary/index.html | 72 +++ .../index.html | 106 ++++ files/es/mdn/contribute/index.html | 70 +++ files/es/mdn/contribute/localize/index.html | 31 + .../localize/iniciar_una_localizacion/index.html | 108 ++++ .../project_colon_localization_projects/index.html | 405 ++++++++++++ .../project_colon_translating_mdn_pages/index.html | 57 ++ files/es/mdn/contribute/procesos/index.html | 14 + .../es/mdn/contribute/registro_persona/index.html | 36 ++ files/es/mdn/contribute/tareas/index.html | 17 + files/es/mdn/contribute/team_status/index.html | 93 +++ files/es/mdn/guidelines/content_blocks/index.html | 46 ++ .../convenciones_y_definiciones/index.html | 201 ++++++ files/es/mdn/guidelines/index.html | 10 + .../index.html" | 146 +++++ files/es/mdn/index.html | 37 ++ .../kuma/contributing/getting_started/index.html | 15 + files/es/mdn/kuma/contributing/index.html | 49 ++ files/es/mdn/kuma/index.html | 55 ++ .../mdn/structures/ejemplos_ejecutables/index.html | 243 ++++++++ files/es/mdn/structures/index.html | 16 + .../macros/commonly-used_macros/index.html | 210 +++++++ files/es/mdn/structures/macros/index.html | 53 ++ files/es/mdn/structures/macros/otras/index.html | 181 ++++++ .../structures/tablas_de_compatibilidad/index.html | 476 ++++++++++++++ files/es/mdn/tools/index.html | 45 ++ .../tools/introduction_to_kumascript/index.html | 683 +++++++++++++++++++++ files/es/mdn/tools/page_regeneration/index.html | 32 + files/es/mdn/tools/template_editing/index.html | 14 + files/es/mdn/user_guide/index.html | 13 + files/es/mdn/user_guide/writing/index.html | 67 ++ 49 files changed, 5319 insertions(+) create mode 100644 files/es/mdn/about/index.html create mode 100644 files/es/mdn/comunidad/index.html create mode 100644 files/es/mdn/contribute/community/index.html create mode 100644 files/es/mdn/contribute/feedback/index.html create mode 100644 files/es/mdn/contribute/getting_started/index.html create mode 100644 files/es/mdn/contribute/howto/convert_code_samples_to_be_live/index.html create mode 100644 files/es/mdn/contribute/howto/crear_cuenta_mdn/index.html create mode 100644 files/es/mdn/contribute/howto/document_a_css_property/index.html create mode 100644 files/es/mdn/contribute/howto/document_a_css_property/plantilla_propiedad/index.html create mode 100644 files/es/mdn/contribute/howto/enlace_cuenta_github/index.html create mode 100644 files/es/mdn/contribute/howto/etiquetas_paginas_javascript/index.html create mode 100644 files/es/mdn/contribute/howto/index.html create mode 100644 files/es/mdn/contribute/howto/remover_macros_experimentales/index.html create mode 100644 files/es/mdn/contribute/howto/revision_editorial/index.html create mode 100644 files/es/mdn/contribute/howto/revision_tecnica/index.html create mode 100644 files/es/mdn/contribute/howto/set_the_summary_for_a_page/index.html create mode 100644 files/es/mdn/contribute/howto/tag/index.html create mode 100644 "files/es/mdn/contribute/howto/usar_barras_laterales_de_navegaci\303\263n/index.html" create mode 100644 files/es/mdn/contribute/howto/write_a_new_entry_in_the_glossary/index.html create mode 100644 files/es/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html create mode 100644 files/es/mdn/contribute/index.html create mode 100644 files/es/mdn/contribute/localize/index.html create mode 100644 files/es/mdn/contribute/localize/iniciar_una_localizacion/index.html create mode 100644 files/es/mdn/contribute/localize/project_colon_localization_projects/index.html create mode 100644 files/es/mdn/contribute/localize/project_colon_translating_mdn_pages/index.html create mode 100644 files/es/mdn/contribute/procesos/index.html create mode 100644 files/es/mdn/contribute/registro_persona/index.html create mode 100644 files/es/mdn/contribute/tareas/index.html create mode 100644 files/es/mdn/contribute/team_status/index.html create mode 100644 files/es/mdn/guidelines/content_blocks/index.html create mode 100644 files/es/mdn/guidelines/convenciones_y_definiciones/index.html create mode 100644 files/es/mdn/guidelines/index.html create mode 100644 "files/es/mdn/guidelines/project_colon_gu\303\255a_de_estilo/index.html" create mode 100644 files/es/mdn/index.html create mode 100644 files/es/mdn/kuma/contributing/getting_started/index.html create mode 100644 files/es/mdn/kuma/contributing/index.html create mode 100644 files/es/mdn/kuma/index.html create mode 100644 files/es/mdn/structures/ejemplos_ejecutables/index.html create mode 100644 files/es/mdn/structures/index.html create mode 100644 files/es/mdn/structures/macros/commonly-used_macros/index.html create mode 100644 files/es/mdn/structures/macros/index.html create mode 100644 files/es/mdn/structures/macros/otras/index.html create mode 100644 files/es/mdn/structures/tablas_de_compatibilidad/index.html create mode 100644 files/es/mdn/tools/index.html create mode 100644 files/es/mdn/tools/introduction_to_kumascript/index.html create mode 100644 files/es/mdn/tools/page_regeneration/index.html create mode 100644 files/es/mdn/tools/template_editing/index.html create mode 100644 files/es/mdn/user_guide/index.html create mode 100644 files/es/mdn/user_guide/writing/index.html (limited to 'files/es/mdn') diff --git a/files/es/mdn/about/index.html b/files/es/mdn/about/index.html new file mode 100644 index 0000000000..1d6e739428 --- /dev/null +++ b/files/es/mdn/about/index.html @@ -0,0 +1,145 @@ +--- +title: Acerca de MDN +slug: MDN/About +tags: + - Colaboración + - Comunidad + - Derechos de Autor + - Documentación + - Guía + - Licencias + - MDN Meta +translation_of: MDN/About +--- +
{{MDNSidebar}}
+ +
{{IncludeSubNav("/es/docs/MDN")}}
+ +

MDN Web Docs es una plataforma de aprendizaje para las tecnologías Web y el software con el que funciona la Web, incluyendo:

+ + + +

Nuestra Misión

+ +

La misión de MDN es simple: Proporcionar a los desarrolladores la información que necesitan para construir fácilmente proyectos en la Web abierta. Si se trata de una tecnología expuesta en la Web Abierta, queremos documentarla.

+ +

Además, proporcionamos documentación sobre los productos de Mozilla y cómo crear y contribuir a los proyectos de Mozilla. También nos ocupamos del B2G OS (antes Firefox OS).

+ +

Si no está seguro si un tema en particular debe ser ofrecido en MDN, lea: ¿Pertenece esto a MDN?

+ +

Cómo puede ayudar

+ +

¡No necesitas ser capaz de codificar —o escribir bien— para poder colaborar en MDN!. Tenemos un montón de maneras con las que puede ayudar, desde revisar artículos para asegurarse de que tengan sentido, o contribuir con texto, hasta agregar código de ejemplo. De hecho, hay tantas maneras de ayudar que tenemos una Página de inicio que le ayuda a elegir tareas que hacer, en función de sus intereses. ¡Y cuánto tiempo tiene disponible!.

+ +

También puede ayudar promocionando MDN en su propio blog o sitio web.

+ +

La Comunidad MDN

+ +

¡Somos una comunidad global! Contamos con colaboradores increíbles de todo el mundo, en múltiples idiomas. Si desea aprender más sobre nosotros, o si necesita cualquier tipo de ayuda  con MDN. ¡Tómese la libertad de consultar nuestra foro de discusión o el Canal IRC!

+ +
+
+

Uneté a la comunidad MDN

+ +
+
Escoge tu método preferido para unirte al tema:
+ + +
+ +
+ +
+
+
+ +

Consulta el foro de documentación para desarrolladores:

+ + + +

Derechos de autor y Licencias

+ +

Los documentos wiki MDN se han preparado con las contribuciones de muchos autores, tanto dentro como fuera de la Fundación Mozilla. A menos que se indique lo contrario, los contenidos están disponibles bajo los términos de la Licencia Creative Commons: Attribution-Sharealike v2.5 o cualquier versión posterior. Por favor atribúyalos a los "Colaboradores Mozilla" e incluya un hipervínculo (en línea) o URL (en formato impreso) a la Wiki específica para el contenido referenciado.

+ +
+

Acerca de MDN realizado por Colaboradores Mozilla se distribuye bajo licencia CC-BY-SA 2.5.

+
+ +

Tenga en cuenta que el ejemplo, "Colaboradores de Mozilla" enlaza con el historial de la página citada. Vea  Las mejores prácticas para la atribución si desea una explicación más detallada.

+ +
+

Nota: Vea el contenido de MDN en WebPlatform.org para información acerca de como reutilizar y atribuir contenido MDN en ese sitio.

+
+ +

Los códigos de ejemplo agregados a esta Wiki antes del 20 de Agosto de 2010 están disponibles bajo la Licencia MIT; utilice la siguiente información de atribución: "© <fecha de la última revisión de la Wiki> <nombre de la persona que lo colocó en la Wiki>".

+ +

Los códigos de ejemplo agregados durante o después del 20 de Agosto de 2010 quedan bajo dominio público. Puedes utilizar el siguiente aviso si es necesario: "Cualquier derecho de autor se dedica al dominio público.  http://creativecommons.org/publicdomain/zero/1.0/ "

+ +

Si deseas contribuir al wiki, debes hacer que tu documentación esté disponible bajo la licencia de Attribution-ShareAlike (u ocasionalmente una licencia alternativa ya especificada por la página que estás editando), y los ejemplos de código disponibles bajo licencia Creative Commons CC-0 (Dedicada al dominio público). Añadir  contenido a este wiki significa que aceptas que tus contribuciones estén disponibles bajo esas licencias.

+ +

Algunos contenidos antiguos se pusieron a disposición bajo una licencia distinta de las licencias mencionadas anteriormente. Estos se indican en la parte inferior de cada página a través de un Bloque de Licencia Alternativo.

+ +
+

No se pueden crear nuevas páginas utilizando licencias alternativas.

+
+ +

Los derechos de autor sobre el material publicado permanecen con el autor a menos que este los asigne a otra persona.

+ +

Si tienes alguna pregunta o inquietud sobre algo expuesto aquí, por favor contacta con Eric Shepherd.

+ +
+

Los derechos sobre las marcas comerciales, logotipos, marcas al servicio de la Fundación Mozilla, así como la apariencia de este sitio Web, no se encuentran bajo la licencia Creative Commons, están exentos. Se reconoce que son obras de autoría (como logotipos y diseños gráficos), y no están incluidos en el trabajo que se autoriza bajo esos términos. Si utilizas el texto de los documentos, y deseas también usar cualquiera de estos derechos, o si tienes cualquier otra pregunta sobre el cumplimiento de nuestros términos de licencia para esta colección, contacta con la Fundación Mozilla por este medio: licensing@mozilla.org.

+ +

Descarga de contenido

+ +
 
+ +
+
Puede descargar un espejo tarball completo de MDN. (2.5 GB a partir de 2016-11-30).
+ +
 
+ +

Páginas únicas

+ +

Puede recuperar el contenido de una  página  única en MDN agregando parámetros de documento a la URL para especificar el formato que desea.

+ +

Herremientas de terceros

+ +

Puede ver el contenido de MDN a través de herramientas de terceros como Dash (para Mac OS) y Zeal (para Linux y Windows).

+ +

Kapeli también publica documentos offline de MDN que cubren HTML, CSS, JavaScript, SVG y XSLT.

+ +

Vincular a MDN

+ +

Consulte este artículo para obtener orientación sobre cómo vincular a MDN para obtener las mejores prácticas al enlazar.

+ +

Informar de problemas en MDN

+ +

Consulte Cómo informar de un problema en MDN.

+ +

Historia de MDN

+ +

El proyecto para el Centro de Desarrollo Mozilla (a.k.a. MDC, a.k.a. Devmo) comenzó a principios de 2005, cuando la Fundación Mozilla obtuvo una licencia de AOL para utilizar el contenido original Netscape DevEdge. El contenido DevEdge fue revisado en busca de material todavía útil, que luego fue migrado por voluntarios en este Wiki para que fuera más fácil de actualizar y mantener.

+ +

Desde entonces, el proyecto ha seguido creciendo y ahora forma un nexo central para toda la documentación de desarrollo relacionada con el proyecto Mozilla y las tecnologías de Web Abierta. En 2010, el nombre fue cambiado a Mozilla Developer Network. En 2011 se agregó Demostraciones de Tecnologías de Web Abierta para que los desarrolladores Web puedan compartir y mostrar su código y páginas de aprendizaje para proporcionar enlaces a los tutoriales. (El nombre de MDC viene de "MDN Doc Center" de la sección de documentación). Se espera que con el tiempo la Red de Desarrolladores de Mozilla se convierta en un recurso que los diseñadores Web, desarrolladores de aplicaciones, de extensiones y escritores visiten de forma regular.

+ +

Acerca de Mozilla

+ +

Si deseas aprender más acerca de quiénes somos, cómo ser parte de Mozilla, o simplemente, dónde encontrarnos, estás en el lugar correcto. Para saber lo que nos mueve y nos hace diferentes, por favor visita nuestra página de misión.

+
diff --git a/files/es/mdn/comunidad/index.html b/files/es/mdn/comunidad/index.html new file mode 100644 index 0000000000..fd3abc7f28 --- /dev/null +++ b/files/es/mdn/comunidad/index.html @@ -0,0 +1,54 @@ +--- +title: Únete a la comunidad de MDN web docs +slug: MDN/Comunidad +tags: + - Comunidad + - Documentación + - Guía + - Proyecto MDC +translation_of: MDN/Community +--- +
{{MDNSidebar}}
+ +
{{IncludeSubnav("/es/docs/MDN")}}
+ +
+

La documentación de la web de MDN (MDN web docs) es más que un wiki: Es una comunidad de desarrolladores que trabajan unidos para hacer que MDN sea un excelente recurso para todos los desarrolladores que usen cualquier tecnología de la Open Web.

+
+ +

Nos gustaría mucho que contribuyeras a MDN, pero nos encantaría si además de contribuir participaras en la comunidad de MDN. Aquí te explicamos cómo ponerte en contacto en tres sencillos pasos:

+ +
    +
  1. Crear cuenta MDN.
    2. +
  2. Join in conversations (aun no disponible en español).
    3. +
  3. Siga lo que está pasando.
    4. +
+ +

Cómo funciona la comunidad

+ +

Aquí encontraras más artículos que describen a la comunidad de MDN.

+ +
+
+
+
Community roles
+
No disponible en español por el momento.
+
Doc sprints
+
No disponible en español por el momento
+
Siga lo que está pasando
+
MDN es auspiciado por  La comunidad de la red de desarrolladores de Mozilla. Aquí encontraras algunas maneras por las cuales compartimos información acerca de lo que estamos haciendo.
+
+ +
+
+
+ +
+
+
MDN community conversations
+
no disponible en español por el momento
+
Trabajar con nuestra comunidad
+
Una gran parte de contribuir a la documentación de MDN en cualquier aspecto es saber cómo trabajar dentro de la comunidad MDN. Este artículo te ofrece tips para ayudarte a aprovechar las interacciones con otros colaboradores y con los equipos de desarrolladores.
+
+
+
diff --git a/files/es/mdn/contribute/community/index.html b/files/es/mdn/contribute/community/index.html new file mode 100644 index 0000000000..a80a67a1b4 --- /dev/null +++ b/files/es/mdn/contribute/community/index.html @@ -0,0 +1,118 @@ +--- +title: Trabajando con nuestra comunidad +slug: MDN/Contribute/Community +tags: + - Comunidad + - Guía + - MDN Meta +translation_of: MDN/Community/Working_in_community +--- +
{{MDNSidebar}}
+ +

Lo más importante para contribuir a la documentacion de MDN en cualquier escala es saber trabajar como parte de una comunidad. Este artículo brinda tips que te ayudarán a sacarle el máximo partido a tus interacciones con documentadores y el equipo de desarrolladores.

+ +

Reglas generales de comportamiento.

+ +

Aquí encontraras algunas reglas generales de conducta para cuando trabajes en la comunidad Mozilla.

+ + + +

Se cortés

+ +

Siempre se diplomático y respetuoso cuando te comuniques con los demás.

+ +

Señalando errores cortésmente

+ +

Si tu propósito al contactar a alguien es pedirle que haga algo diferente o señalar un error que ha estado cometiendo (especialmente si lo hace repetidamente), comienza tu mensaje con un comentario positivo. Esto suaviza el golpe, por así decirlo, y demuestra que estás tratando de ayudar, en lugar de convertirte en 'el malo de la película'.

+ +

Por ejemplo, si un colaborador nuevo ha estado creando muchas páginas sin etiquetas y te gustaría señalar este problema, tu mensaje podría verse así (las cosas que necesita cambiar para cada caso están subrayadas) :

+ +
+

Hola, MrBigglesworth, he notado sus contribuciones a la documentación de la API de Wormhole, ¡y es fantástico contar con su ayuda! Me gusta especialmente la forma en que equilibraste tu nivel de detalle con la legibilidad. Dicho esto, sin embargo, podría hacer que estos artículos sean aún mejores y más útiles si agrega las etiquetas correctas a las páginas sobre la marcha.

+ +

Consulte la guía de etiquetado de MDN (https://developer.mozilla.org/en-US/docs/MDN/Contribute/Howto/Tag) para obtener más detalles.

+ +

Gracias de nuevo y espero sus futuras contribuciones.

+
+ +

Intercambiando conocimiento

+ +

Al participar en el proyecto MDN, es útil saber lo que está pasando e interactuar con otros los demas miembros de nuestra comunidad. Al hacer esto, puedes compartir ideas, actualizaciones de estado y más. Además contamos con recursos y herramientas para ayudarte a saber que se está haciendo y por quiénes.

+ +

Canales de comunicación

+ +

Existen varias formas en las que puedes participar con los miembros de la comunidad, ya sea con documentadores o desarrolladores, cada uno de los cuales tiene sus propias reglas de comportamiento.

+ +

Discourse (en Inglés)

+ +

El foro MDN Discourse es un buen lugar para hacer preguntas generales sobre la contribución a MDN y empezar discusiones.

+ +

Chat (en Inglés)

+ +

Utiliza el sistema de chat Matrix para contactar con personas en tiempo real. Los miembros del personal de MDN están disponibles en la sala de MDN Web Docs  y están activos durante los días laborales en Europa y América del Norte. Explora las otras salas de chat para encontrar personas involucradas en temas que te interesen.

+ +

GitHub (en Inglés)

+ +

Si encuentras un problema en MDN, o deseas hacer una pregunta, ¡puedes presentar un problema en nuestro repo de GitHub! Luego serán evaluados y procesados en algún momento en el futuro.

+ +

Bugzilla

+ +

Cuando escribes documentacion para cubrir los cambios implementados como consecuencia de un error en Bugzilla, podrás interactuar en ocasiones con las personas involucradas en estos errores. ¡Asegurate de tener guía de comportamiento Bugzilla en mente todo el tiempo!

+ +

Email

+ +

En ocasiones, el intercambio de correo electrónico privado entre tú y una o más personas es el camino a seguir, si tienes su dirección de correo electronico.

+ +
+

Nota: Como regla general, si alguien a publicado su email en los documentos sobre la tecnología que estás documentando, te ha dado su correo, o es un correo muy conocido, un correo es un buen medio para realizar el "primer contacto". Si tienes que buscarlo, probablemente deberías intentar obtener permiso para Discourse o una lista de correo primero, a menos que hayas agotado todos los demás recursos para ponerte en contacto.

+
+ +

Estado del contenido

+ +

Tenemos varias herramientas útiles que te proporcionan información sobre el estado de la documentación.

+ +
+
Tablero de revisión
+
Esta es una herramienta fantástica para la revisión de los cambios realizados  en el contenido de MDN. Puedes ver el historial, seleccionar un rango de tiempo para ver, y filtrar por cosas como la configuración regional, nombre del contribuyente, y tema. Una vez que estés viendo la serie de revisiones, puedes ver los cambios realizados en cada una de ellas, abrir rápidamente la pagina, ver el historial completo o revertir cambios  (si tienes los permisos).
+
Visión general del estado de la documentación
+
Nuestra pagina de vista del estado de documentación provee una lista de todas las áreas de MDN que se han configurado para el seguimiento de estado, con información de algunas páginas y los diferentes trabajos que se necesitan. Haz click en un área en particular y mira un listado de los contenidos que necesitan trabajo, como páginas que no tienen etiquetas, o etiquetas que requieren cierto trabajo. Puedes ver una lista de páginas que no se han actualizado hace mucho tiempo, están desactualizados, o una lista de los errores encontrados y cómo han afectado a la documentación en esa área.
+
Los planes del proyecto de documentación
+
Tenemos una serie de proyectos de escritura que se encuentran en etapa de planificación, o son grandes y se encuentran en curso, para los que se han escrito los documentos de planificación y así tener un registro de lo que tenemos que hacer.
+
MDN Taiga (en Inglés)
+
Los redactores del personal de MDN utilizan una herramienta llamada Taiga para gestionar proyectos de documentación actuales y futuros. Puedes echar un vistazo para ver lo que estamos haciendo y cómo va, también puedes ver qué proyectos nos gustaría que sucedan pronto. Algunos de ellos serán asumidos por escritores del personal, ¡pero no dudes en hacerte cargo de uno si lo deseas! Para obtener más información sobre los procesos ágiles que sigue el equipo de MDN, consulta nuestra página de procesos en la  wiki de Mozilla.
+
+ +

La comunidad de desarrollo

+ +

Posiblemente las relaciones más importantes para desarrollar y mantener, como miembro de la comunidad de la escritura MDN, son las que mantengas  con los desarrolladores. Ellos crean el software que estamos desarrollando, pero también son la fuente más útil de información que tenemos. Es crucial que mantengamos buenas relaciones con los desarrolladores, ¡así es más probable que respondan a tus preguntas de forma rápida, precisa y adecuada!

+ +

Además, representas a la comunidad de escritura MDN. Por favor, ayuda a asegurar que mantengamos nuestra excelente relación de trabajo con el equipo de desarrollo haciendo que cada interacción que tengan con el equipo de escritura sea la mejor posible.

+ +

En una nota relacionada, una gran manera de encontrar a la persona adecuada para hablar es mirar la lista de propietarios del módulo.

+ +

La comunidad de escritura

+ +

La comunidad de la escritura es grande. Mientras que el número de contribuyentes frecuentes o de gran escala es relativamente pequeño, hay muchas docenas o cientos de personas que contribuyen al menos de vez en cuando. Afortunadamente, se trata de personas impresionantes, con un amor genuino por la Web, Mozilla, y/o la documentación, además, la interacción con ellos es casi siempre bastante fácil.

+ +

Mira el articulo Únete a la comunidad para mas información acerca de la comunidad MDN.

+ +

 El lugar donde más frecuentemente podrás interactuar directamente con otros escritores es en el foro Discourse.

+ +

Teniendo en cuenta la {{anch("Guía general de comportamiento")}} , usted notará que las cosas salen bien por lo general.

+ +

Mira también

+ + diff --git a/files/es/mdn/contribute/feedback/index.html b/files/es/mdn/contribute/feedback/index.html new file mode 100644 index 0000000000..780639f8f2 --- /dev/null +++ b/files/es/mdn/contribute/feedback/index.html @@ -0,0 +1,46 @@ +--- +title: Enviar feedback sobre MDN +slug: MDN/Contribute/Feedback +translation_of: MDN/Contribute/Feedback +--- +
{{MDNSidebar}}
+ +

{{IncludeSubnav("/es-ES/docs/MDN")}}

+ +

¡Bienvenido a la Red de Desarrolladores de Mozilla! si tienes algunas sugerencias, o estás teniendo problemas usando MDN, estás en el lugar correcto. El mismo hecho de que muestres interés en ofrecer feedback, te hace más parte de la comunidad de Mozilla, y te agradecemos de antemano tu interés.

+ +

Tienes varias opciones parar ofrecer tu punto de vista, este artículo te ayudará.

+ +

Actualizar la documentación

+ +

Para empezar, si has localizado un problema en la documentación, deberías sentirte libre de corregirlo tú mismo. Simplemente regístrate usando Github, luego haz click en cualquier botón Editar azul para abrir el editor e ingresar en el mundo de la contribución en la documentación MDN. La documentación aquí es una wiki, y está supervisada por un equipo de voluntarios y personal pagado, así que no seas tímido; tu gramática no tiene por qué ser perfecta. Arreglaremos cualquier error que puedas cometer; ¡No vas a estropear nada!

+ +

Para obtener más información sobre comó contribuir a la documentación MDN consulte:

+ + + +

Únete a la conversación

+ +

¡Háblanos! Existen varias maneras de conectar con otras personas que ya están trabajando concontenido MDN.

+ +

Chat (Síncrono)

+ + + +

Discusiones (Asíncrono)

+ +

Las discusiones más a largo plazo ocurren en el foro de discusión de MDN. Puedes postear en el foro bien por email escribiendo a mdn@mozilla-community.org. Si te unes al foro, podrás recibir notificaciones de las discusiones, directamente en tu email.

+ +

Informa de un problema

+ +

Problemas de documentación

+ +

Si ves un problema en la documentación que por cualquier razón, no puedas arreglar tú mismo, siempre puedes informar del problema. Puedes utilizar este formulario para cualquier problema relacionado con documentación, tanto si se trata de una correción simple o de una solicitud para una nuevo fragmento de contenido. Como se ha mencionado con anterioridad, te invitamos a que contribuyas con cambios de tu propia cosecha, pero esta opción está igualmente disponible.

+ +

Problemas en la web

+ +

Si encuentras problema de el sitio web de MDN, o tienes cualquier idea para nuevas funcionalidades para este sitio, puedes enviar un ticket al equipo de desarrollo de MDN.

diff --git a/files/es/mdn/contribute/getting_started/index.html b/files/es/mdn/contribute/getting_started/index.html new file mode 100644 index 0000000000..1c1297b806 --- /dev/null +++ b/files/es/mdn/contribute/getting_started/index.html @@ -0,0 +1,142 @@ +--- +title: Primeros pasos en MDN +slug: MDN/Contribute/Getting_started +tags: + - Comenzando + - Getting Started + - Guía + - New Contributors + - Nuevos Colaboradores +translation_of: MDN/Contribute/Getting_started +--- +
{{MDNSidebar}}
+ +
{{IncludeSubnav("/es/docs/MDN")}}
+ +

Somos una comunidad abierta de desarrolladores y escritores que crea recursos para tener una mejor Web sin importar la marca, navegador o plataforma. Cualquiera puede contribuir y cada persona que lo hace nos vuelve más fuertes. Juntos podemos continuar innovando la Web para servir al bien común. Esto empieza aquí, contigo.

+ +

Cada parte de MDN (desde el código que permite funcionar al sitio hasta la documentación; ejemplos, y demos) son creados por una comunidad de desarrolladores y escritores. Todos pueden ayudar en algo, y tenemos la esperanza de que te unas.

+ +

3 simples pasos hacia MDN

+ +

MDN es una wiki, donde cualquiera puede agregar y editar contenido. No necesitas ser programador o saber mucho sobre tecnología. Hay muchas actividades que necesitan ser completadas, desde tareas simples como revisar la redacción o la ortografía, hasta tareas complejas como escribir la documentación para una API. Esta guía te ayudará a empezar y te conducirá por el camino para que encuentres formas de mejorar el contenido de MDN.

+ +

Contribuir es fácil e inofensivo. Si cometes un error, es fácil corregirlo. Y aunque no estés seguro de cómo debe ser el contenido o tu ortografía no sea muy buena, no debes preocuparte. Tenemos un equipo que revisa el contenido de MDN y se asegura de que esté lo más correcto posible. Alguien estará al tanto para verificar que tu trabajo esté ordenado y bien escrito. Comparte lo que sabes y usa tus talentos. Confía en que la comunidad ayudará a mejorar tu trabajo.

+ +

Paso 1: Crea una cuenta en MDN

+ +

Para comenzar a contribuir en MDN, necesitas tener una cuenta. Para más detalles, por favor dirígete a crear una cuenta. Ten en cuenta que necesitarás una cuenta de Github para crear una cuenta en MDN ya que en este momento utilizamos Github para verificar las cuentas de MDN.

+ +

Paso 2: Elige en qué quieres contribuir

+ +

Una vez iniciada la sesión en MDN, lee las descripciones de los distintos tipos de tareas en la sección {{anch("Tipos de tareas")}} que se encuentra más abajo en esta misma página y elige la que mejor te parezca. Puedes hacer clic en cualquier tarea que sea de tu interés para empezar a contribuir.

+ +

Si la tarea elegida implica crear páginas nuevas, te pedimos por favor que leas Obteniendo permisos de creación de página donde encontrarás información importante acerca de cómo obtener permiso para crear nuevas páginas; por razones de seguridad, las cuentas nuevas tienen deshabilitada esta funcionalidad por defecto.

+ +

Paso 3: Lleva a cabo la tarea

+ +

Una vez que hayas decidido en qué quieres contribuir, busca una página, ejemplo de código, etc. en la cual quieras trabajar y ¡hazlo!

+ +

No te preocupes por hacerlo perfecto, hay otros colaboradores de MDN como tú que pueden ayudar a corregir los errores que hayan pasado inadvertidos. Si surgen preguntas mientras realizas la actividad, revisa la página de la comunidad para obtener información acerca de las listas de correo y chats donde puedes realizar tus preguntas.

+ +
+

Si te sientes inseguro de editar una página, quieres practicar o quieres realizar algún experimento, tenemos una página de pruebas que puedes editar sin ninguna preocupación. Dentro de esa página haz clic en editar y simplemente experimenta. Te pedimos de favor que solo experimentes en esa página y no hagas ningún cambio innesesario a las demás paginas solo para ver que sucede ya que podrías confundir a otros lectores que visiten MDN y cargar con trabajo innecesario a otros editores.

+
+ +

Cuando hayas completado la tarea que elegiste, puedes continuar con otra o ver más abajo otras actividades que puedes realizar en MDN.

+ +

Tipos de tareas

+ +

Hay muchos caminos que puedes elegir para contribuir a MDN dependiendo de tus habilidades e intereses. Existen algunas tareas que son pesadas, pero tenemos otras muchas simples disponibles de las cuales muchas de ellas solo necesitan cinco minutos (¡o menos!) de tu tiempo. Aquí debajo encontrarás los tipos de tareas y al lado del nombre de cada una de ellas verás el tiempo aproximado necesario para realizarla.

+ +

Opción 1: Me gustan las palabras

+ +

Puedes ayudarnos revisando o editando los documentos ya existentes y ponerles las etiquetas correctas.

+ + + +
Si vas a crear una nueva página/articulo te recomendamos leer la Style Guide (en inglés) para que conozcas los detalles y la estructura recomendada de las páginas. Y si corriges la ortografía, redacción, de algún artículo, puedes leer la Guía de Estilos si tienes alguna duda. Buscamos que todos los artículos sean consistentes en el sitio.
+ +

Opción 2: Me gusta el código fuente

+ +

¡Necesitamos más ejemplos de código! o también puedes ayudar a construir la plataforma de nuestro sitio: Kuma o puedes ayudar a actualizar la compatibilidad de navegadores en nuestra base de datos

+ + + +

Opción 3: Me gustan las palabras y el código fuente

+ +

Tenemos tareas que requieren conocimiento del idioma y habilidades técnicas como crear nuevos artículos, verificar la información técnica o adaptar documentos.

+ + + +

Opción 4: MDN en mi idioma

+ +

Todo el trabajo de adaptación y traducción en MDN es realizado por nuestra asombrosa comunidad de voluntarios.

+ + + +
+

Puedes revisar las páginas importantes que necesitan traducción aquí -> Estado de las paginas con prioridad para traducir y te recomendamos leer la Guía de Estilos para que conozcas las convenciones a la hora de traducir.

+
+ +

Opción 5: Encontré información errónea pero no sé cómo corregirla

+ +

Puedes reportar problemas creando un reporte de error de la documentación (en inglés).

+ +

Usa estos valores:

+ + + + + + + + + + + + + + + + + + + + + + + + +
Campo de BugzillaValor
productDeveloper Documentation
component[Escoge el área apropiada al tema, o "General" si no estás seguro o no encuentras el indicado]
URLLa dirección URL de la página donde encontraste el problema
DescripciónDescribir el problema y donde encontrar la información correcta. Esto puede incluir personas ("Describe los pasos uno a uno") como también links a direcciones web
+ +

Otras actividades que puedes realizar en MDN

+ + diff --git a/files/es/mdn/contribute/howto/convert_code_samples_to_be_live/index.html b/files/es/mdn/contribute/howto/convert_code_samples_to_be_live/index.html new file mode 100644 index 0000000000..699828214a --- /dev/null +++ b/files/es/mdn/contribute/howto/convert_code_samples_to_be_live/index.html @@ -0,0 +1,44 @@ +--- +title: Cómo convertir códigos de demostración para que estén "en vivo" +slug: MDN/Contribute/Howto/Convert_code_samples_to_be_live +tags: + - Código + - Demostración + - Sample +translation_of: MDN/Contribute/Howto/Convert_code_samples_to_be_live +--- +
{{MDNSidebar}}

MDN tiene ahora un sistema de "ejemplos en vivo", donde el código de demostración que aparece en la página se usa directamente para mostrar el resultado de dicho ejemplo. Sin embargo, muchos artículos existentes tienen ejemplos que todavía no usan este sistema y necesitan ser convertidos.

+ + + + + + + + + + + + + + + + +
¿Dónde hay que hacerlo?En artículos etiquetados como NecesitaMuestraEnVivo (NeedsLiveSample)
¿Qué necesitas saber para hacer esta tarea? +
    +
  • Entender HTML, CSS y/o JavaScript, dependiendo del código de muestra que sea.
    • +
  • Habilidad para usar macros KumaScript dentro de los artículos MDN.
    • +
+
¿Cuáles son los pasos para hacer la tarea? +

Para una descripción completa del sistema de demostración en vivo, incluyendo cómo crear las demostraciones en vivo, ver Usar el sistema de demostración en vivo.

+ +
    +
  1. Elige un artículo de la lista de artículos etiquetados como NecesitaMuestraEnVivo (NeedsLiveSample), donde el código sea para una característica con la que sientas que estas familiarizado.
    2. +
  2. Convierte el código para que sea "en vivo".
    3. +
  3. Borra cualquier código o imagen que haya sido usada para mostrar el resultado de la demostración.
    4. +
+ +

 

+
+ +

 

diff --git a/files/es/mdn/contribute/howto/crear_cuenta_mdn/index.html b/files/es/mdn/contribute/howto/crear_cuenta_mdn/index.html new file mode 100644 index 0000000000..8e254f6ac0 --- /dev/null +++ b/files/es/mdn/contribute/howto/crear_cuenta_mdn/index.html @@ -0,0 +1,32 @@ +--- +title: Cómo crear una cuenta MDN +slug: MDN/Contribute/Howto/Crear_cuenta_MDN +tags: + - Cuenta + - GitHub + - Perfil + - Persona + - Principiante + - account +translation_of: MDN/Contribute/Howto/Create_an_MDN_account +--- +
{{MDNSidebar}}
+ +

Para editar contenido en MDN, necesitas un perfil MDN. No es necesario un perfil si solo quieres buscar y leer los documentos de MDN:

+ +
    +
  1. En la parte superior de cada página en MDN encontrarás el botón de  Registrarse. Pasa el puntero del mouse por ahí (o toca sobre este botón si estás con un dispositivo móvil) para mostrar una lista de servicios de autenticación que son permitidos para registrarse en MDN.
    2. +
  2. Selecciona el servicio para registrarte. Actualmente, solo GitHub y Gmail están disponibles. Ten en cuenta que si seleccionas GitHub, un enlace a tu perfil de GitHub será incluido en tu página de perfil público de MDN.
    3. +
  3. Sigue las indicaciones de GitHub o de Gmail para conectar tu cuenta a MDN.
    4. +
  4. Una vez autenticado el servicio te retorna a MDN, se te pedirá que ingreses un nombre de usuario y una dirección de correo electrónico. Tu nombre de usuario será mostrado públicamente para darte el crédito del trabajo que has hecho. No utilices tu dirección de correo electrónico como nombre de usuario.
    5. +
  5. Click en Crear mi perfil MDN.
    6. +
  6. Si la dirección de correo electrónico que has especificado en el paso 4 no es el mismo que has utilizado  con el servicio de autenticación, revisa tu correo y dale click en el enlace en el correo de confirmación que se te envió.
    7. +
+ +

¡Listo! ¡Ya tienes una cuenta MDN y puedes editar páginas inmediatamente!

+ +

Puedes dar clic en tu nombre en la parte superior de cualquier página de MDN para ver tu perfil público. Desde ahí, puedes editar, hacer cambios o adicionar información en tu perfil.

+ +
+

Nota: Los nuevos nombres de usuario no pueden contener espacios ni el carácter "@". Ten en cuenta que tu nombre de usuario será mostrado públicamente para identificar los trabajos que hayas hecho!

+
diff --git a/files/es/mdn/contribute/howto/document_a_css_property/index.html b/files/es/mdn/contribute/howto/document_a_css_property/index.html new file mode 100644 index 0000000000..41b3fcb14f --- /dev/null +++ b/files/es/mdn/contribute/howto/document_a_css_property/index.html @@ -0,0 +1,82 @@ +--- +title: Cómo documentar una propiedad CSS +slug: MDN/Contribute/Howto/Document_a_CSS_property +translation_of: MDN/Contribute/Howto/Document_a_CSS_property +--- +
{{MDNSidebar}}
+ +
{{IncludeSubnav("/en-US/docs/MDN")}}
+ +

As the CSS standards evolve, new properties are always being added. The MDN CSS Reference needs to be kept up to date with these developments. This document gives step-by-step instructions for creating a CSS property reference page.

+ +

Each CSS property reference page follows the same structure. This helps readers find information more easily, especially once they are familiar with the standard reference page format.

+ +

Step 1 — Decide which property to document

+ +

First, you will need to decide which property to document. The CSS Documentation status page lists properties that need to be documented. For details about the CSS property you will need to find a relevant specification for it (e.g., a W3C specification, a Mozilla Wiki page, or a bug report for a non-standard property used in rendering engines like Gecko or Blink).

+ +
+

Pro tips:

+ + +
+ +

Step 2 — Check the database of CSS properties

+ +

Several characteristics of a CSS property, such as its syntax or if it can be animated, are mentioned in several pages and are therefore stored in an ad-hoc database. Macros that you'll use on the page need information about the property that is stored there, so start by checking that this information is there.

+ +

If not, contact an admin or a power user, either on the MDN Web Docs chat room, or, if nobody is available, by filing an issue report.

+ +

Step 3 — Creating the CSS property page

+ +

Preparations finished! Now we can add the actual CSS property page. The easiest way to create a new CSS property page is to copy the content of an existing page and to edit it. We will go through the different steps now.

+ +
+

Cloning a page is currently broken on MDN. That's why we need to go through these somewhat more complex steps. Please vote for ({{bug(870691)}}).

+
+ +
    +
  1. Clone the following page, set the title to your-property (without capitals) and the slug to Web/CSS/your-property.
    2. +
  2. Change the summary to fit, but keep it starting the same way : "The your-property CSS property…". Explain briefly what this property is for.
    3. +
  3. If the property is not experimental, remove the \{{SeeCompatTable}} macro. The purpose of this macro is to alert developers to the possibility that the feature may not yet have consistent support across browsers, and may change in the future as its specificaton evolves. Deciding whether a feature is experimental is a matter of judgement, and should include factors like: +
      +
    • Is the feature supported by several browsers?
      • +
    • Is the feature prefixed or behind a preference?
      • +
    • Is there any reason to think that the implementation of the feature will change in the future?
      • +
    +
    4. +
  4. Replace the parameter of the \{{cssinfo("animation-name")}} macro by the name of the CSS property you are documenting. This will allow you to build the summary box using the data you entered in step 2.
    5. +
  5. Replace the example of the syntax by relevant ones. Keep them very simple and don't forget that a lot of people don't understand a formal syntax so it needs to be simple and exhaustive. Keep the inherit, initial, and unset keywords examples at the end. It reminds users that these are valid values, too.
    6. +
  6. Under the chapter Values, put the meaning of each value. If it is a keyword, don't forget to mark it as code (select it and press CTRL-O). Each description should start by "Is a" followed by the type of the value, or indicating it is a keyword.
    7. +
  7. Clear the Examples chapter, we will add them at the end!
    8. +
  8. Update the specification table. For information about how to do it, read this tutorial.
    9. +
  9. Update the compatibility information. For information about how to do it, read this tutorial.
    10. +
  10. Update the See also section with relevant links. Do not link to specs here and usually link to internal documents. External documents are welcome, but only if they bring really good information. There are spam or SEO links often, so don't worry if external links are removed sometimes. Just start the discussion if you still find it useful and want to see it back.
    11. +
  11. Add the relevant tags: you need to add CSS, CSS Property, and Reference. You also need to add Experimental or Non-standard if this is the case. Finally you also need to add a CSS XYZ tag, where XYZ stands for the group of CSS properties it belongs to. It is often the spec short name. All these tags are used to generate quicklinks and other niceties.
    12. +
+ +

At any point, you can save by hitting the SAVE button. You can continue to edit right along. If you haven't saved your page until now, please do so! :-)

+ +

The last step is to add Examples. To do that follow this tutorial about live samples. Don't forget that we are in a document explaining one single property: you need to add examples that show how this property is working in isolation, not how the whole specification is used. That means, examples for list-style-type will show what the different values generate, but not how to combine it with other property, pseudo-classes or pseudo-elements to generate nice effects; tutorials and guide can be written to show more.

+ +

Step 4 — Getting a review

+ +

You have documented your CSS property! Congratulations!

+ +

In order to have a good quality and consistency throughout the MDN CSS reference, it is good practice to request a review. Just click on the checkbox at the bottom of the article (in edit mode), and, optional, if you want to have a more personal review helping you to improve editorial skills, ask for it on the MDN forum.

+ +

Step 5 — Integrating the new page in the MDN

+ +

Now that your page is created, you want it to be found by the readers. Adding tags helped about this already as it allowed it to appear in the quicklinks to related CSS pages. Also you want it to appear on the CSS index page. If the newly documented property is on the standard track and at least one major browser is implementing it, it deserves to be listed this. Only administrator can add it there, so contact the CSS driver on IRC (currently at #mdn ping teoli) or file a documentation bug requesting it.

+ +

Also, if the property is implemented by Firefox, you need to check that it is listed, and linked! in the correct Firefox for developers MDN page. The new CSS property is likely already listed in the HTML section, just be sure that its name links back to your newly created page.

+ +

Contact us

+ + diff --git a/files/es/mdn/contribute/howto/document_a_css_property/plantilla_propiedad/index.html b/files/es/mdn/contribute/howto/document_a_css_property/plantilla_propiedad/index.html new file mode 100644 index 0000000000..a0bdd5267f --- /dev/null +++ b/files/es/mdn/contribute/howto/document_a_css_property/plantilla_propiedad/index.html @@ -0,0 +1,120 @@ +--- +title: Plantilla de página para propiedades CSS +slug: MDN/Contribute/Howto/Document_a_CSS_property/Plantilla_propiedad +translation_of: MDN/Contribute/Howto/Document_a_CSS_property/Property_template +--- +
{{MDNSidebar}}
Esta es una página plantilla para las propiedades de CSS. Por favor utilice esto como una plantilla base cuando vaya a crear una nueva página para una propiedad de CSS. 
+Los comentarios en cursiva son información  sobre cómo usar parte de la plantilla
+ +
{{CSSRef}}
+ +
Agregue el encabezado no estándar si la propiedad no esta en el estándar. En la sección de resumen en una nota, describa como lograr su efecto usando tecnologías estándares de la Open Web.
+ +
{{non-standard_header}}
+ +
 
+ +
Agregue el encabezado experimental si a su juicio es probable que el comportamiento de la propiedad cambie en el fututo, por ejemplo; debido a especificaciones muy inmaduras o implementaciones incompatibles.
+ +
{{SeeCompatTable}}
+ +

 

+ +

Desripción de la propiedad. Debe comenzar por "La propiedad xyz CSS " seguido de una descripción de una oración. El primer párrafo de esta introducción se utilizará por defecto como la descripción de la página.

+ +

{{note("Para cualquier mensaje especial")}} Pero no agregue varias notas. Estas deben ser realmente importantes, ¡o ser parte de la decripción!

+ +

{{cssinfo}}

+ +

Sintaxis

+ +
/* Valores de palabras clave */
+property: value1;
+property: value2;
+
+/* <longitud> valores */
+property: 12.8em;   /* Una longitud válida */
+
+/* Valores globales */
+property: inherit;   <-- Para recordar que son valores posibles
+property: initial;
+property: unset;
+
+ +

La segunda parte es una traducción simple de lo que dice la sintaxis formal. Está dirigido a usuarios de nivel medio que no comprenderán bien la sintaxis formal.

+ +

Valores

+ +

Cada elemento de la sintaxis formal debe ser explicado

+ +
+
valor_1
+
Es una palabra clave que significa...
+
valor_2 {{ Non-standard_inline() }} {{experimental_inline()}}
+
Es una palabra clave que significa
+
+ +

Sintaxis formal

+ +

La sintaxis formal debe ser tomada de la especificación y agregarse a la plantilla de 'CSSData'. Es una herramienta importante para obtener información precisa de la sintaxis para los usuarios avanzados.

+ +
{{csssyntax}}
+ +

Ejemplos

+ +

Agregue esto solo si hay un ejemplo. Sin enlace roto aqui.

+ +

CSS

+ +
elementName {
+  property: value;
+  estoes: "ejemplo";
+  dream: 10000000mm;
+  amor: "peligro";
+}
+ +

HTML

+ +
<elementName>foo bar</elementName>
+ +

Resultado

+ +

{{EmbedLiveSample("Examples")}}

+ +

Especificaciones

+ +

Utilizar exclusivamente esta tabla estándar. Coloque la especificación más antigua en la parte inferior. Use las plantillas SpecName() para el nombre y Spec2() para el estado. De esa manera, cuando la especificación progresa en el estándar, o se mueve, el contenido de la tabla se adaptará automáticamente.

+ + + + + + + + + + + + + + + + + + + + + +
EspecificaciónEstadoComentario
{{SpecName("CSS3 Animations", "#fake-link", "fake-value")}}{{Spec2("CSS3 Animations")}}Sin cambios desde CSS 2.1
{{SpecName("CSS2.1", "#fake-link", "fake value")}}{{Spec2("CSS2.1")}}Definición inicial
+ +

Compatibilidad del navegador

+ +

(Ver Tablas de compatibilidad para más información)

+ +

Ver también

+ + diff --git a/files/es/mdn/contribute/howto/enlace_cuenta_github/index.html b/files/es/mdn/contribute/howto/enlace_cuenta_github/index.html new file mode 100644 index 0000000000..825081aead --- /dev/null +++ b/files/es/mdn/contribute/howto/enlace_cuenta_github/index.html @@ -0,0 +1,110 @@ +--- +title: Como unir tu cuenta GitHub a tu perfil MDN +slug: MDN/Contribute/Howto/enlace_cuenta_GitHub +translation_of: Archive/MDN/Howto_Link_a_Github_account +--- +
{{MDNSidebar}}
+ +
{{IncludeSubnav("/en-US/docs/MDN")}}
+ +
+

Note: Support for Persona logins on MDN was disabled on November 1, 2016. The method for adding a Github account to your profile therefore no longer works. If you didn't add a GitHub login to your MDN account before we disabled Persona logins, please file an "Account Help" bug on Bugzilla. For further reading about the end of life of Persona, see: Persona shutdown guidelines.

+
+ +

Debido a que el sistema de autentificacion de Persona  Mozilla esta siendo cerrado, todos los usuarios que deseen contribuir a MDN necesitaran otra manera de ingresar desde el 1 de Noviembre del 2016. Actualmente, la unica alternativa soportada es  GitHub, debido a esto necesitaras una cuenta en GitHub para editar y contribuir apartir de esta fecha. Este articulo describe como añadir la autentificacion de GitHub  a tu perfil MDN.

+ +
+

Debes hacer esto antes del 1 de Noviembre de 2016, o no tendras modo de ingresar a MDN!

+
+ +

Descripción

+ +

Añadir la autentificacion mediamte GitHub a tu cuenta no es dificíl. Entraremos en detalle más adelante, pero primero, aqui hay una pequeña lista de pasos necesarios:

+ +
    +
  1. ingresa a tu cuenta MDN mediante Persona.
    2. +
  2. Ve a la pagina cuentas asosiadas.
    3. +
  3. Añade la autentificacion GitHub.
    4. +
+ +

Instrucciones Detalladas

+ +

Esta es una guia paso a paso de todo lo que necesitas saber.

+ +

Ingresar a tu cuenta MDN

+ +
    +
  1. En la parte superior de la pagina de MDN, hubica el mouse sobre Registrarse o da tap para llegara este cuadro. aqui se muestran los metodos de autentificacion disponibles, Persona y GitHub.
    + Sign in box on MDN, showing Persona and Github.
    2. +
  2. Seleciona Persona, y usa tus datos de usuario usuales. si obtienes un error de inicio no reconocido, asegurese de estar ingresando la cuenta de correo con la que se unio a MDN, esta puede ser su direccion de correo usual. Si aún tienes problemas, mira {{anch("Persona no me reconoce")}}.
    3. +
+ +

Ir a la pagina "cuentas asociadas"

+ +

Existen dos maneras de llegara esta pagina.

+ +

La primera y mas gacil es dar click en el siguiente link.

+ +

Otra manera seria, haciendo:

+ +
    +
  1. Dar Click en tu nombre de usuario en la parte superior de cualquier pagina MDN. (en la misma posicion donde aparecia Registrarse cuando aún no habia ingresado.) Esta lo enviara a su pagina de perfil.
    2. +
  2. Abra el "menu", y da click en Cuentas Asociadas.
    + Gear menu in profile, showing the "Account connections" option
    3. +
+ +

Añadir autentificación GitHub

+ +

You're now on the "Account connections" page, which lists the external accounts you've already linked to your MDN profile. If GitHub is already listed, congratulations! You're ready to go! But test it to be sure you remember your password, by signing out of MDN and signing back in using your GitHub credentials.

+ +

If GitHub isn't already listed, then near the bottom of the page, look below the list of already-linked external accounts. There you'll find a section called Connect a new account, which lists the types of accounts you can connect to your MDN profile. It looks something like this:

+ +

+ +

To add GitHub:

+ +
    +
  1. Click  Connect with GitHub. MDN will contact GitHub to request  permission to link the accounts.  If you're not already signed in to GitHub, you'll be asked to do so:
    + Screenshot of GitHub sign in window.
    2. +
  2. If you have two-factor authentication enabled on your GitHub account, you'll be asked to enter your authentication code:
    + Screenshot of GitHub's Two-factor authentication window.
    3. +
  3. Now that you're signed in to your GitHub account, you'll be asked to authorize the link between GitHub and MDN (unless you already have this authorization on file for some reason). This page is shown below.
    + Screenshot of GitHub "Authorize application" window.
    + Click the green Authorize application button to grant permission for your MDN profile to access your GitHub account. If the GitHub account is successfully linked to your MDN profile, you'll see this message:
    + Account successfully created.
    4. +
+ +

Not only can you now use GitHub to sign in to MDN, but you're actually already signed in using your GitHub authentication! You're now ready for the Persona shutdown. Be sure to update any password managers you may have installed, if necessary.

+ +

Troubleshooting

+ +

If you run into problems while trying to add your GitHub account to your profile, hopefully the troubleshooting tips below will help. If they don't, please don't hesitate to ask us for help on the MDN Web Docs chat room.

+ +

Error: Could not find profile matching account

+ +

If you try to add your GitHub account to your profile and get the error "Could not find profile matching account," it can mean a few different things. If you have multiple accounts on your GitHub account, there may be some confusion; GitHub may not report the expected email address to MDN during the account pairing attempt, which will result in this error. Other glitches in the process may also result in the same error message.

+ +

One way to work around this problem: open a new private window in your browser; in Firefox, for example, choose "New Private Window" in the File menu (or press Ctrl+Shift+P [Cmd-Shift-P on Mac]). Browse to MDN there, sign into your MDN account, then try again to add your GitHub account to your profile as covered above.

+ +

Also, be sure that when you try to log into Persona to

+ +

My GitHub authorization is not displayed on the Account Connections page.

+ +

That might be a caching issue. Reloading the page or loggin out and loggin in again should solve the problem.

+ +

Persona doesn't remember me

+ +

If you try to log into Persona so you can add a GitHub login to your MDN account and get told "Your email address is new to us," this is likely because it's been long enough since you last logged into Persona that they've deleted your email address from their system. This happens after some period of time; the Persona login window looks like this in that situation:

+ +

+ +

If this happens, you need to simply follow Persona's instructions to create a new password for that email address. MDN doesn't care about this process; the fact that your email address matches up is all that matters. A confirmation email will be sent to verify that you own the email address, probably from no-reply@persona.org. If you have spam filtering, it may be sent to your spam folder.

+ +

Once you've finished the process of setting the password for the email address you used to log into MDN, your access to MDN will be restored. Then you can follow the steps in {{anch("Detailed instructions")}} above to add your GitHub login to your MDN account.

+ +

See also

+ + diff --git a/files/es/mdn/contribute/howto/etiquetas_paginas_javascript/index.html b/files/es/mdn/contribute/howto/etiquetas_paginas_javascript/index.html new file mode 100644 index 0000000000..42edc03ff0 --- /dev/null +++ b/files/es/mdn/contribute/howto/etiquetas_paginas_javascript/index.html @@ -0,0 +1,83 @@ +--- +title: Cómo etiquetar páginas Javascript +slug: MDN/Contribute/Howto/Etiquetas_paginas_javascript +tags: + - Etiquetas + - JavaScript +translation_of: MDN/Contribute/Howto/Tag_JavaScript_pages +--- +
{{MDNSidebar}}

Etiquetar consiste en agregar meta-información (o información adicional) a las páginas para que el contenido relacionado pueda agruparse, por ejemplo en la herramienta de búsqueda.

+ + + + + + + + + + + + + + + +
¿Dónde hay que hacerlo?Dentro de páginas específicas relacionadas con JavaScript que aún no tengan etiquetas
¿Qué necesitas saber para hacer esta tarea? +
    +
  • Conocimiento básico de código JavaScript, como saber qué es un método o una propiedad.
    • +
+
¿Cuáles son los pasos para hacerla? +
    +
  1. Elige una de las páginas del la lista que se encuentra en el enlace anterior.
    2. +
  2. Haz Click en el enlace del artículo para cargar la página.
    3. +
  3. Una vez cargada la página, haz click en el botón EDIT cerca de la parte superior ( esto te coloca en el editor MDN).
    4. +
  4. Cómo mínimo se debería agregar la etiqueta JavaScript. Aquí hay otras etiquetas que se pueden agregar:
    5. +

  5. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    TagWhat pages to use it on
    Methodmétodos
    Propertypropiedades
    prototypeprototipos
    Object type namemétodos de un objeto; por ejemplo String.fromCharCode debería llevar la etiqueta String
    ECMAScript6 and Experimentalcaracterísticas agregadas en una nueva versión ECMAScript
    Deprecatedcaracterísticas desaprobadas (cuyo uso está desaconsejado pero aún tiene soporte)
    Obsoletecaracterísticas obsoletas (que ya no tienen soporte en los navegadores modernos)
    othersVer Mestándares de etiquetado MDN para otras etiquetas posibles a aplicar
    +
    6. +
  6. Guarda con un comentario.
    7. +
  7. ¡Y Listo!
    8. +
+
+

 

diff --git a/files/es/mdn/contribute/howto/index.html b/files/es/mdn/contribute/howto/index.html new file mode 100644 index 0000000000..611bc03e83 --- /dev/null +++ b/files/es/mdn/contribute/howto/index.html @@ -0,0 +1,15 @@ +--- +title: Guías prácticas +slug: MDN/Contribute/Howto +tags: + - Documentation + - Landing + - MDN + - TopicStub +translation_of: MDN/Contribute/Howto +--- +
{{MDNSidebar}}
{{IncludeSubnav("/es/docs/MDN")}}
+ +

Estos artículos proveen guías paso a paso para lograr metas específicas cuando se contribuye a MDN.

+ +

{{LandingPageListSubpages}}

diff --git a/files/es/mdn/contribute/howto/remover_macros_experimentales/index.html b/files/es/mdn/contribute/howto/remover_macros_experimentales/index.html new file mode 100644 index 0000000000..25ee6439cd --- /dev/null +++ b/files/es/mdn/contribute/howto/remover_macros_experimentales/index.html @@ -0,0 +1,48 @@ +--- +title: Cómo y cuándo eliminar macros "experimentales" +slug: MDN/Contribute/Howto/Remover_Macros_Experimentales +tags: + - Experimental + - Guía + - MDN Meta + - Macros +translation_of: MDN/Contribute/Howto/Remove_Experimental_Macros +--- +
{{MDNSidebar}}{{IncludeSubnav("/en-US/docs/MDN")}}
+ +

Las páginas en MDN pueden incluirmacrosKumaScriptpara notificar a los lectores que una característica es experimental y aún no está estandarizada. Sin embargo, algún elementos experimental pueden estandarizarse y sin embargo su página todavía no refleja este cambio. Puedes ayudar a mejorar MDN revisando las páginas que contienen estas macros "experimentales" y eliminando las macros de los elementos que ya no son experimentales.

+ +

Las macros en cuestión son {{TemplateLink("experimental_inline")}} para marcar un elemento mencionado en una página, y {{TemplateLink("SeeCompatTable")}} para marcar toda la página.

+ +
+

Advertencia: ya no recomendamos usarSeeCompatTable. Ahora se espera que todos los datos sobre compatibilidad se presenten dentro de la tabla de compatibilidad del navegador y cualquier nota al pie de página.

+
+ +

Aquí está la definición de experimental del artículo MDN Definitions and Conventions:

+ +

¿Dónde debe hacerse esta tarea?

+ +

Páginas en las siguientes listas:

+ +
+
+ +
+
¿Qué necesitas saber para hacer la tarea?
+
Conocimiento del estado de estandarización o implementación del elemento relevante.
+
¿Cuáles son los pasos para hacer la tarea?
+
+
    +
  1. Revise la página para ver con qué elemento o elementos está asociada la macro.
    2. +
  2. Determine si cada elemento sigue siendo experimental o no. La tabla de compatibilidad en la página puede ser más actual que las macros; También puede probar utilizando el elemento en varios navegadores.
    3. +
  3. Si un elemento ya no es experimental, elimine la llamada de macro "experimental" asociada a él. (Nota: un elemento en una página de resumen que tiene la macro {{TemplateLink ("experimental_inline")}} al lado suele ser un enlace a una página de referencia completa, que contiene la macro {{TemplateLink ("SeeCompatTable")}}.
    4. +
  4. Guarde la página con un comentario sobre lo que hizo.
    5. +
  5. Si ha eliminado todas las macros "experimentales" de una página (para las macros en línea, puede eliminar solo algunas de ellas), fuerce una actualización (Mayús + Actualizar) en la página de resultados de búsqueda relevante (vinculada anteriormente) para asegurarse de que la lista esté actualizado.
    6. +
+
+
diff --git a/files/es/mdn/contribute/howto/revision_editorial/index.html b/files/es/mdn/contribute/howto/revision_editorial/index.html new file mode 100644 index 0000000000..454da031a0 --- /dev/null +++ b/files/es/mdn/contribute/howto/revision_editorial/index.html @@ -0,0 +1,54 @@ +--- +title: Cómo hacer una revisión editorial +slug: MDN/Contribute/Howto/revision_editorial +tags: + - Cómo hacerlo + - Documentación + - Guía + - Revisiones +translation_of: MDN/Contribute/Howto/Do_an_editorial_review +--- +
{{MDNSidebar}}
+ +

La revisión editorial consiste en reparar errores tipográficos y de ortografía, gramática, o errores de uso en un artículo. No todos los contribuyentes son expertos en escribir en español, pero gracias a su conocimiento han contribuído en los artículos en enorme cantidad, los cuales necesitan correcciones y revisiones. Esto se hace en la revisión editorial.

+ + + + + + + + + + + + + + + + + + + + +
¿Cuál es la tarea? Verificar y corregir la gramática, ortografía y contexto de los artículos.
¿Dónde hay que hacerla?Dentro de artículos específicos que están marcados como que requieren una revisión editorial.
¿Qué necesitas saber para hacer la tarea?Necesitas tener buen manejo de la gramática española y su ortografía.
¿Cuáles son los pasos para hacerlo? +
    +
  1. Elige un artículo: +
      +
    1. Ve a la lista de artículos que necesitan revisión editorial.  Esto lista todas las páginas para las que se solicitó una revisión editorial.
      2. +
    2. Elige una página que tenga un título en español y cuya ruta no empiece con Template:.
      3. +
    3. Haz click en el enlace del artículo para cargar la página.
      4. +
    +
    2. +
  2. Una vez cargada la página, haz click en el boton editar (EDIT) de la parte superior; esto te lleva al editor MDN. No dudes en cambiar a una página diferente si la primera que eliges no te conviene.
    3. +
  3. Corrige todos los errores tipográficos y ortográficos, gramática, o de uso que veas.
    4. +
  4. Ingresa un Comentario Revisión en la parte superior del artículo; algo como "Revisión editorial: errores de tipografía, gramática y ortografía reparados."
    5. +
  5. Haz click en el boton GUARDAR LOS CAMBIOS (SAVE CHANGES).
    6. +
  6. Una vez que el artículo corregido aparezca en la pantalla después de haberse cerrado el editor, marca la entrada Editorial al costado debajo de Se han solicitado las siguientes revisiones (The following reviews have been requested) y haz click en ENVIAR REVISION (SUBMIT REVIEW).
    7. +
  7. +

    ¡Listo!

    +
    8. +
+
+ +

 

diff --git a/files/es/mdn/contribute/howto/revision_tecnica/index.html b/files/es/mdn/contribute/howto/revision_tecnica/index.html new file mode 100644 index 0000000000..e1fc2d5d5a --- /dev/null +++ b/files/es/mdn/contribute/howto/revision_tecnica/index.html @@ -0,0 +1,44 @@ +--- +title: Cómo hacer una revisión técnica +slug: MDN/Contribute/Howto/revision_tecnica +translation_of: MDN/Contribute/Howto/Do_a_technical_review +--- +
{{MDNSidebar}}

La revisión técnica consiste en revisar la precisión técnica y lo completo que se encuentra un artículo, y corregirlo si es necesario. Si un escritor de un artículo quiere que alguien más chequee su contenido técnico, debe marcar la casilla "Revisión Técnica" (Technical review) al editarlo. A menudo el escritor contacta a un ingeniero específico para desempeñar la revisión técnica, pero cualquiera con habilidad técnica en el tema puede hacerla.

+ +

Este artículo describe cómo hacer para ejecutar una revisión técnica, ayudando así a asegurar que el contenido de MDN es preciso.

+ + + + + + + + + + + + + + + + +
¿Dónde hay que hacerla?En artículos específicos marcados requiriendo revisión técnica.
¿Qué necesitas saber para hacer la tarea? +
    +
  • Conocimiento experto del tema del artículo que estás revisando.
    • +
  • Habilidad para editar un artículo wiki en MDN.
    • +
+
¿Cuáles son los pasos para hacerlo? +
    +
  1. Vé a la lista de páginas que necesitan revisiones técnicas. Ésta lista todas las páginas para las cuales se solicitó revisión técnica.
    2. +
  2. Elige una página con cuyo tema estés muy familiarizado.
    3. +
  3. Haz click en el enlace del artículo para cargar la página.
    4. +
  4. Una vez cargada la página, haz click en el botón  EDITAR (EDIT) de la parte superior; esto te lleva al editor MDN. No dudes en cambiar a una página diferente si la primera que eliges no te conviene.
    5. +
  5. Mientras lees el artículo, corrige cualquier información técnica que no esté correcta y agrega cualquier información importante que falte.
    6. +
  6. Ingresa un comentario al pie del artículo que describa lo que hiciste, como "Revisión técnica completa". Si corregiste la información, incluye eso en tu comentario, por ejemplo "Revisión Técnica: descripciones de parámetros arregladas".
    7. +
  7. Haz click en el botón GUARDAR LOS CAMBIOS (SAVE CHANGES).
    8. +
  8. Una vez que corregiste el artículo aparece en la pantalla después que el editor se haya cerrado, chequea la entrada Técnica al costado, debajo de Las siguientes revisiones han sido solicitadas (The following reviews have been requested) y haz click en ENVIAR REVISIÓN (SUBMIT REVIEW).
    9. +
  9. Y listo!
    10. +
+
+ +

 

diff --git a/files/es/mdn/contribute/howto/set_the_summary_for_a_page/index.html b/files/es/mdn/contribute/howto/set_the_summary_for_a_page/index.html new file mode 100644 index 0000000000..26f62b04a2 --- /dev/null +++ b/files/es/mdn/contribute/howto/set_the_summary_for_a_page/index.html @@ -0,0 +1,118 @@ +--- +title: Cómo colocar el resumen de una página +slug: MDN/Contribute/Howto/Set_the_summary_for_a_page +tags: + - Documentación + - Resumen + - SEO + - Summary + - primeros pasos +translation_of: MDN/Contribute/Howto/Set_the_summary_for_a_page +--- +
{{MDNSidebar}}
+ +
+
{{IncludeSubnav("/en-US/docs/MDN")}}
+ +
+

En este artículo te mostraremos cómo configurar el resumen SEO (también conocido como la descripción o simplemente como el resumen) de un artículo en el sitio de MDN Web Docs. El resumen se usa de varias maneras:

+ +
    +
  • Lo utilizan Google y otros motores de búsqueda para ayudar a catalogar e indexar páginas.
    • +
  • Los motores de búsqueda muestran el resumen en las páginas de resultados de búsqueda para ayudar a los lectores a elegir la página que mejor se adapte a sus necesidades.
    • +
  • Los menús de MDN a menudo muestran el resumen debajo del título del artículo para ayudar a los usuarios a encontrar la información que buscan.
    • +
  • Los enlaces en MDN tienen información sobre las herramientas del resumen, para proporcionar una visión rápida a los usuarios sin tener que hacer clic en el artículo en sí.
    • +
+ +

Por lo tanto, el resumen debe ser un texto que tenga sentido tanto en el contexto del artículo como cuando se presenta solo en otros contextos. Se debe tener en cuenta la guía de estilo de escritura MDN al escribir el texto de resumen.

+
+
+ +

El resumen predeterminado

+ +

Las páginas para las que no se ha establecido un resumen toman como resumen el texto completo del primer bloque de {{Glossary("HTML")}} que parezca tener contenido de texto en lugar de un título. Sin embargo, este texto puede no se el mejor para usar por varias razones:

+ + + +

Por esto es mejor establecer explícitamente el resumen de la página, para ayudar a garantizar que el resumen sea lo más útil posible.

+ +

Estableciendo el resumen

+ +

Veamos cómo configurar el resumen de una página.

+ +

¿Cuál es la tarea?

+ +

Marcar el texto dentro de una página que debe usarse como resumen en otros contextos; Si el texto apropiado no está disponible, esta tarea puede incluir escribir una pequeña cantidad de texto apropiado.

+ +

¿Dónde necesita ser hecho?

+ +

En las páginas que carecen de un resumen, las que tengan un resumen que no sea útil, o que tengan un resumen que no cumpla innecesariamente con las pautas recomendadas.

+ +

¿Qué necesitas saber para hacer la tarea?

+ +

Necesitas saber usar el editor MDN. También necesitas buenas habilidades de escritura y familiaridad con el tema de la página a resumir.

+ +

¿Cuáles son los pasos para hacerlo?

+ +
    +
  1. Elige una página a la que quieras colocarle un resumen: +
      +
    1. En la página de estado de la documentación MDN, haz clic en el enlace debajo de  Secciones (Sections) para un tema en el que tengas conocimientos (por ejemplo, HTML).
      +
      2. +
    2. En la página de estado de la documentación del tema, haz clic en la cabecera Páginas (Pages) de la tabla Resumen (Summary). Esto te va a llevar a un índice de todas las páginas en esa sección del tema. Muestra los enlaces de la página en la columna izquierda y las etiquetas y resúmenes en la columna derecha.
      +
      3. +
    3. Elige una página en la que falte el resumen o que tenga uno pobre.
      +
      4. +
    4. Haz clic en el enlace para ir a esa página.
      5. +
    +
    2. +
  2. Haz clic en Editar (Edit) para abrir la página en el editor MDN.
    3. +
  3. Busca una oración o dos que anden como resumen fuera del contexto. Si fuera necesario, edita el contenido existente para crear o modificar las oraciones y así obtener un buen resumen.
    4. +
  4. Selecciona el texto a usar como resumen.
    5. +
  5. En el widget Estilos (Styles) de la barra de herramientas del editor selecciona Resumen SEO (SEO Summary). (En el código fuente de la página, esto crea un elemento  {{HTMLElement("span")}} con class="seoSummary" encerrando el texto seleccionado).
    +
    6. +
  6. Guarda tus cambios con un comentario de revisión como "Coloqué el resumen a la página".
    7. +
+ +

Elaboración de un buen resumen

+ +

El resumen se utiliza en diversos escenarios entre los que se pueden incluir:

+ + + +

Es importante tener presentes estos escenarios mientras se crea un resumen. Para garantizar que el resumen funcione bien en todas estas situaciones, esfuérzate por ceñirte a las pautas que se indican a continuación.

+ +
+

Nota: a menos que se indique específicamente lo contrario, estas son orientaciones, no reglas rígidas y rápidas. Aunque debes esforzarte por cumplir estas directrices, en ocasiones se presentan excepciones que no se pueden evitar.

+
+ + + +

Piensa en el resumen como si fuera una especie de {{interwiki("wikipedia", "blurb")}} en el interior de la cubierta o la contracubierta de un libro. Este texto corto tiene que captar la atención del lector rápidamente y animarle a seguir leyendo.

+ +

Puede ser un poco complicado redactar un resumen que funcione bien tanto para las páginas de resultados de los motores de búsqueda como dentro del propio texto del artículo, pero en el momento MDN no ofrece una forma de crear un resumen SEO separado del contenido de la página, de modo que haz tu mejor esfuerzo.

+ +

Ver también

+ + diff --git a/files/es/mdn/contribute/howto/tag/index.html b/files/es/mdn/contribute/howto/tag/index.html new file mode 100644 index 0000000000..d477bae0fc --- /dev/null +++ b/files/es/mdn/contribute/howto/tag/index.html @@ -0,0 +1,385 @@ +--- +title: Cómo etiquetar correctamente las páginas +slug: MDN/Contribute/Howto/Tag +tags: + - Colaborar + - Etiquetas + - Guia(2) + - Guía + - MDN + - Principiante +translation_of: MDN/Contribute/Howto/Tag +--- +
{{MDNSidebar}}

"Article tags" Las etiquetas del artículo son una forma importante para poner a los visitantes en contacto con contenido útil. Cada página normalmente debería contener varias etiquetas para ayudar a mantener organizado el contenido. En esta página se explica la mejor manera de marcar las páginas para que así  nuestros lectores puedan encontrar la información y podamos mantenernos organizados.

+ +

Si necesita ayuda con la interfaz de usuario de edición de etiquetas, consulte la sección de etiquetado tagging section en nuestra guía del editor.

+ +

Por favor utilice las etiquetas como se explica a continuación. Si no, nuestras herramientas automatizadas no generarán correctamente las listas de contenido, las páginas de destino y el entrecruzamiento de artículos.

+ +

Cómo usa MDN las etiquetas (tags)

+ +

Hay varias maneras de usar las etiquetas en MDN:

+ +
+
"Document categorization" Categorización de documentos
+
¿Qué clase de documento es? ¿Es una referencia? ¿Un tutorial? ¿Una página de inicio?  Nuestros visitantes pueden usar estas etiquetas para filtrar búsquedas, ¡así que son realmente importantes!
+
"Topic identification" Identificación del tema
+
¿Qué tema cubre el artículo? ¿Trata sobre una API? ¿El DOM? ¿Gráficos? Estas también son importantes porque se pueden usar en filtros de búsquedas.
+
"Technology status" Estado de la tecnología
+
¿Cuál es el estado de la tecnología? ¿No es estándar? ¿Obsoleto o en desuso? ¿Experimental?
+
"Skill level" Nivel de habilidad
+
Para tutoriales y guías, ¿cómo es de avanzado el material cubierto por el artículo?
+
"Document metadata" Documento de recursos
+
La comunidad de escritores utiliza las etiquetas para hacer un seguimiento de qué páginas necesitan qué tipo de trabajo.
+
+ +

Tipos de etiquetas

+ +

Guía rápida de tipos de etiquetas y sus posibles valores.

+ +

Categoría de documento

+ +

Cuando se etiqueta un artículo con una de estas categorías, estas ayudando a las herramientas automáticas a generar con mayor precisión las páginas de destino, tablas de contenido, etc. Estos términos también serán usados por nuestro nuevo motor de búsqueda,  para que nuestros visitantes puedan localizar a su antojo referencias o información de la guía.

+ +

Utilizamos los siguientes nombres de categoría como etiquetas de marcado estándar:

+ +
+
{{Tag("Introducción")}}
+
El artículo proporciona material introductorio sobre un tema. Lo ideal sería tener solo una etiqueta "Introducción" por tema tecnológico tratado.
+
{{Tag("Destacado")}}
+
El artículo es crítico y se mostrará de forma destacada en las páginas de inicio. Esta etiqueta se usara con moderación (nunca más de tres documentos por tema).
+
{{Tag("Referencia")}}
+
El artículo contiene material de referencia de una API, elemento, atributo, propiedad o similares.
+
{{Tag("Inicio")}}
+
Es una página de inicio.
+
{{Tag("Guía")}}
+
El artículo es una página de cómo hacerlo o guía.
+
{{Tag("Ejemplo")}}
+
El artículo es una página de ejemplo de código o contiene ejemplos de código (es decir, fragmentos reales de código útil y no de una sola línea "ejemplos de sintaxis").
+
+ +

Temas

+ +

Mediante la identificación del área temática del artículo, estás ayudando a generar mejores resultados de búsqueda, páginas de inicio y navegación.

+ +

Si bien hay cierta flexibilidad para identificar los nuevos temas, tratamos de limitarlos a los nombres de APIs o tecnologías. Algunos ejemplos:

+ + + +

En general, la etiqueta de identificación del tema será el nombre de la interfaz con que este relacionada la página (como nodo "Node", que tiene muchas páginas para sus diversas propiedades y métodos), o el nombre general de un tipo de tecnología. Puede etiquetar una página sobre WebGL con Graphics y WebGL ó una página sobre {{HTMLElement("canvas")}} con HTML, Element, Canvas y Graphics.

+ +

Estado tecnológico

+ +

Para ayudar al visitante a comprender el estado actual de una tecnología, usamos estas etiquetas en las páginas para describir la situación de las especificaciones de cada tecnología. Esta descripción no es suficientemente detallada como para explicar los aspectos y avances de las especificaciones (para ello existe la Tabla de Especificaciones), pero ayuda al lector a juzgar si es una buena idea usar la tecnología descrita en el artículo.

+ +

Aquí tienen los posibles valores de esta etiqueta:

+ +
+
{{Tag("Not-standard")}}
+
Indica que la tecnología o API descrita en la página no forma parte de un estándar, pero se considera estable en cualquier aplicación de navegador. Si no utiliza esta etiqueta, sus lectores asumirán que la tecnología es estándar. La tabla de compatibilidad en la página debe aclarar qué navegador o navegadores soportan esta tecnología o API.
+
<{{Tag("Deprecated")}}
+
La tecnología o API cubierta en la página se marca como en desuso en las especificaciones y es probable que con el tiempo sea eliminada de navegadores actuales.
+
+ +
+
{{Tag("Obsolete")}}
+
 La tecnología o API ha sido considerada obsoleta y ha sido eliminada (o actualmente se está retirando) de la totalidad de los navegadores actuales.
+
{{Tag ("Experimental")}}
+
La tecnología no es estandar y es una tecnología o API experimental que pueden o no llegar a ser parte de un estandar. También está sujeta a cambios en el motor del navegador (normalmente sólo uno) que lo implementa.
+
{{Tag("Necesita Privilegios")}}
+
La API requiere acceso privilegiado al dispositivo en el que se ejecuta el código.
+
+ +
+
{{Tag("Solo Certificado")}}
+
La API sólo funciona con código certificado.
+
+ +

¡Estas etiquetas no excluyen el uso de la tabla de compatibilidad en su artículo!

+ +

Nivel de habilidad

+ +
+
Utilice este tipo de etiquetas solo para guías y tutoriales (es decir, para páginas que ya esten etiquetadas como Guía)  para ayudar a los usuarios a elegir los tutoriales en base a su nivel. Hay tres valores posibles:
+
{{Tag ("Principiante")}}
+
Los artículos diseñados para introducir al lector en una tecnología que nunca han usado o sólo tienen una vaga familiaridad.
+
{{Tag ("Intermedio")}}
+
Artículos para los usuarios que ya saben trabajar con la tecnología, pero no son expertos.
+
{{Tag ("Advanced")}}
+
Artículos sobre como ampliar las capacidades de una tecnología y del lector.
+
+ +

Metadatos

+ +
+
La comunidad de escritores utiliza estas etiquetas para designar los artículos que requieran algun tipo trabajo específico. He aquí una lista de los que más utilizamos:
+
{{Tag ("basura")}}
+
El artículo debe ser eliminado.
+
{{Tag ("NecesitaContenido")}}
+
El artículo es un esbozo o carece de información. Esta etiqueta significa que alguien debe revisar el contenido, añadir más detalles y/o terminar de escribir el artículo.
+
{{Tag ("NecesitaEjemplos")}}
+
El artículo necesita uno o más ejemplos para ayudar a demostrar la finalidad el artículo. Estos ejemplos deben utilizar el sistema live sample system.
+
{{Tag ("NecesitaEjemplosReales")}}
+
El artículo tiene uno o más ejemplos que necesitan ser actualizados para usar el sistema live sample system.
+
{{Tag ("NecesitaActualizacion")}}
+
El contenido no está actualizado y necesita una actualización.
+
{{Tag ("excluir")}}
+
El contenido no necesita ser localizado y no aparecerá en las páginas de estados de localización.
+
{{Tag ("prioridad")}}
+
El contenido es importante y debe ser marcado como prioritario para traductores de MDN.
+
+ +

Mapa de Alfabetización Web

+ +

El proyecto WebMaker, a través de Web Literacy Map ha definido las habilidades necesarias para leer, escribir y participar en la Web de forma óptima. Utilizaremos etiquetas de "Web Literacy Map" en MDN para ayudar a nuestros usuarios a encontrar los recursos que mejor se adapten a sus necesidades:

+ +
+
{{Tag ("Navegacion")}}
+
Cómo navegar por la Web
+
{{Tag ("WebMecanicas")}}
+
Cómo está organizada y cómo funciona la web
+
{{Tag ("Buscar")}}
+
Cómo encontrar información, personas y recursos en la Web
+
{{Tag ("Credibilidad")}}
+
Cómo evaluar críticamente la información que encuentre en la Web
+
{{Tag ("Seguridad")}}
+
Cómo mantener sistemas, identidades y seguridad de los contenidos
+
{{Tag ("Composición")}}
+
Cómo crear y organizar contenido para la Web
+
{{Tag ("remezcla")}}
+
Cómo modificar recursos Web existentes para crear algo nuevo
+
{{Tag ("Diseno")}}
+
Cómo mejorar la estética visual y la experiencia del usuario
+
{{Tag ("Accesibilidad")}}
+
Cómo comunicarse de una manera universalmente reconocible a través de los recursos de la Web
+
{{Tag ("CodigoScript")}}
+
Cómo codificar y / o crear experiencias interactivas en la Web
+
{{Tag ("infraestructura")}}
+
Cómo funcionan los detalles técnicos de la Internet
+
{{Tag ("Compartir")}}
+
Cómo crear recursos con otras personas
+
{{Tag ("Colaborar")}}
+
Cómo trabajar con otras personas
+
{{Tag ("Comunidad")}}
+
Cómo participar en las comunidades Web y entender cómo funcionan
+
{{Tag ("Privacidad")}}
+
Cómo examinar las consecuencias de compartir datos en línea
+
{{Tag ("Abriendo")}}
+
Cómo ayudar a mantener la Web accesible a todo el mundo
+
+ +

Resumen

+ +

Para cada página debes asignar distintos tipos de etiquetas, por ejemplo:

+ +

Un tutorial sobre WebGL para principiantes: WebGL, Gráficos, Guía, Principiante

+ +

Página de referencia para {{HTMLElement ("Canvas")}}:  Canvas, HTML, elemento, gráficos

+ +

Una página de inicio de herramientas para desarrolladores de Firefox OS: Herramientas, Firefox OS, Inicio

+ +

Filtros de etiquetas y búsqueda

+ +

Los filtros de búsqueda no funcionarán adecuadamente a menos que etiquetamos correctamente las páginas MDN. A continuación hay una tabla de filtros de búsqueda y las etiquetas de búsqueda que funcionan para dichos filtros.

+ +
+

Nota: Si varias etiquetas se muestran bajo "Nombre de etiqueta", significa que una o más de las etiquetas deben estar presentes en el artículo.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
GrupoNombre filtroNombre de etiqueta
TemaOpen Web Apps{{Tag("Apps")}}
 HTML{{Tag("HTML")}}
 CSS{{Tag("CSS")}}
 JavaScript{{Tag("JavaScript")}}
 APIs and DOM{{Tag("API")}}
 Canvas{{Tag("Canvas")}}
 SVG{{Tag("SVG")}}
 MathML{{Tag("MathML")}}
 WebGL{{Tag("WebGL")}}
 XUL{{Tag("XUL")}}
 Marketplace{{Tag("Marketplace")}}
 Firefox{{Tag("Firefox")}}
 Firefox para Android{{Tag("Firefox Mobile")}}
 Firefox para Desktop{{Tag("Firefox Desktop")}}
 Firefox OS{{Tag("Firefox OS")}}
 Movil{{Tag("Movil")}}
 Web Development{{Tag("Web Development")}}
 Add-ons & Extensions{{Tag("Add-ons ")}}|| {{Tag("Extensions")}} || {{Tag("Plugins")}} || {{Tag("Themes")}}
 Juegos{{Tag("Juegos")}}
NivelSoy experto{{Tag("Experto")}}
 Intermedio{{Tag("Intermedio")}}
 Soy aprendiz{{Tag("Aprendiz")}}
Tipo DocumentoDocsRestringirá la búsqueda al contenido de los docs, dejando fuera otros contenidos MDN.
 DemostraciónIncluirá el contenido de demostración en los resultados de búsqueda.
 Herramientas{{Tag("Herramientas")}}
 Ejemplo Código{{Tag("Ejemplo")}}
 Como & Tutorial{{Tag("Guia")}}
 Perfiles DesarrolladorIncluirá perfiles de desarrolladores de MDN en los resultados de búsqueda.
 Recurso externoEs algo que el equipo de desarrollo todavía está descifrando...
+ +

Problemas de etiquetado que puedes solucionar

+ +

Hay varios tipos de problemas de etiquetado que puedes ayudar a solucionar:

+ +
+
Sin etiquetas
+
Generalmente los artículos deben tener por lo menos una etiqueta "categoría" y una etiqueta de "tema". Si puedes ayudar a asegurar que el mínino de etiquetas estén presentes, ¡te convertirás en nuestro héroe de documentación!
+
Etiquetas que no siguen nuestras normas de etiquetado
+
Por favor, corrija los documentos en los que las etiquetas no siguen las normas de esta página.
+
Etiquetas incorrectos
+
Si está buscando en un artículo acerca de "HTML" y esta etiquetado como "JavaScript", eso probablemente es incorrecto! Del mismo modo, si un artículo de discusión interna de Mozilla tiene una etiqueta "Web", probablemente sea incorrecto también. Remueva las etiquetas y añada las etiquetas correctas si aun no están. Por favor, corrija también los errores ortográficos (por ejemplo, "Javascript" coincide ya que las etiquetas no son sensibles a las mayúsculas, ¡pero no nos descuidemos!).
+
Etiquetas que faltan
+
Si un artículo tiene algunas pero no todas las etiquetas que necesita, no dude en añadir más. Por ejemplo, si una página en referencia a JavaScript está (correctamente) etiquetado como "JavaScript" pero nada más, ¡estás invitado a etiquetar la página como "Referencia"!
+
Etiqueta Spam
+
+

Es el mayor problema de etiquetado de la Web, la publicidad no deseada. ¡Tenemos que eliminar estas etiquetas de inmediato!, son desagradables y difíciles de manejar si permanecen mucho tiempo en la web. Además, son terribles para {{Glossary("SEO")}}.

+
+
+ +

Si ve uno (o más) de estos problemas, por favor acceda a MDN "log into MDN" y haz clic en Editar en la parte superior derecha de la ventana de MDN. Una vez que cargue el editor, desplácese hasta la parte inferior de la página, donde puedes encontrar el cuadro de etiquetas. Para más detalles sobre la interfaz de etiquetado, consulte el cuadro de etiquetas "The tags box" en la guía del editor de MDN.

diff --git "a/files/es/mdn/contribute/howto/usar_barras_laterales_de_navegaci\303\263n/index.html" "b/files/es/mdn/contribute/howto/usar_barras_laterales_de_navegaci\303\263n/index.html" new file mode 100644 index 0000000000..4ba8e4e4e4 --- /dev/null +++ "b/files/es/mdn/contribute/howto/usar_barras_laterales_de_navegaci\303\263n/index.html" @@ -0,0 +1,78 @@ +--- +title: Cómo usar las barras laterales de navegación +slug: MDN/Contribute/Howto/Usar_barras_laterales_de_navegación +translation_of: MDN/Contribute/Howto/Use_navigation_sidebars +--- +

{{MDNSidebar}}{{Draft}}

+ +

La navegación en MDN se realiza frecuentemente usando barras laterales que listan otros artículos en una serie así como contenido relacionado tanto en la misma suite de documentación como en otras áreas de MDN. Las barras laterales de MDN no se crean automáticamente; para incluirlas en la página, es necesario crear y utilizar una macro de algún tipo. En este artículo, revisaremos el proceso de creación de las macros de MDN en la barra lateral y cómo utilizarlas en un artículo.

+ +

Macros actuales de las barras laterales de MDN

+ +

MDN ya tiene varias macros para crear barras laterales. La mayoría son específicas para secciones particulares de MDN, mientras que otras tienen la intención de crear barras laterales genéricas para áreas de documentación que de otra manera no tendrían ninguna.

+ +
+
{{TemplateLink("AddonSidebar")}}
+
Inserts a sidebar for navigating the add-ons documentation; this is primarily content about creating browser extensions.
+
{{TemplateLink("APIRef")}}
+
Inserts a sidebar used within API interface reference pages and subpages.
+
{{TemplateLink("CanvasSidebar")}}
+
Inserts a sidebar used within the HTML/DOM Canvas documentation.
+
{{TemplateLink("DefaultAPISidebar")}}
+
Inserts a default sidebar that can be used on the API overview page of an API that doesn't have its own sidebar type.
+
{{TemplateLink("FirefoxSidebar")}}
+
Inserts a sidebar used on the documentation that's specific to Firefox.
+
{{TemplateLink("GamesSidebar")}}
+
Inserts a sidebar for navigating MDN's content about developing games using web technologies.
+
{{TemplateLink("HTMLSidebar")}}
+
Inserts the sidebar used within MDN's HTML documentation.
+
{{TemplateLink("HTTPSidebar")}}
+
Inserts a sidebar for use on pages within MDN's HTTP documentation.
+
{{TemplateLink("JSSidebar")}}
+
Inserts a sidebar for use within the JavaScript documentation.
+
{{TemplateLink("LearnSidebar")}}
+
Inserts the Learning Area sidebar.
+
{{TemplateLink("MDNSidebar")}}
+
Inserts a sidebar for navigating MDN's "meta-documentation;" that is, documentation about using and editing the MDN Web Docs site itself. You can actually see that macro in use on this page.
+
{{TemplateLink("ServiceWorkerSidebar")}}
+
Inserts a sidebar for use within documentation about Service Workers.
+
{{TemplateLink("SpiderMonkeySidebar")}}
+
Inserts a sidebar for use on pages documenting SpiderMonkey, Mozilla's JavaScript engine.
+
{{TemplateLink("ToolsSidebar")}}
+
Inserts a sidebar listing pages about Firefox developer tools.
+
{{TemplateLink("WebAssemblySidebar")}}
+
Inserts a sidebar containing links related to WebAssembly.
+
{{TemplateLink("WebExtAPISidebar")}}
+
Inserts a sidebar used to navigate the API reference documentation about browser e3dtensions (WebExtensions).
+
{{TemplateLink("WebGLSidebar")}}
+
Inserts a sidebar that provides navigation of WebGL-related content.
+
{{TemplateLink("WebRTCSidebar")}}
+
Inserts a sidebar whose contents provide navigation of WebRTC documentation on MDN.
+
{{TemplateLink("XSLTRef")}}
+
Inserts a sidebar with documentation for XSLT, EXSLT and XPath.
+
+ +

Using sidebars

+ +

To add a sidebar to a page, find the right macro, then, on the page on to which you want to insert the sidebar, click the "Edit" button. Add to the page a {{HTMLElement("p")}} block whose contents are simply the call to the macro. Once there, you can add the macro call. Typically, sidebar macros don't require any parameters, so you can just do, for example:

+ +
<p>\{{MDNSidebar}}</p>
+ +

Usually, you should do this as the first line of the document. In some documents, it's been done at the bottom instead. This works fine, but for the sake of consistency, try to place it at the top.

+ +

If there's already a {{HTMLElement("p")}} block with macro calls at the top of the page, such as those that create banners like \{{Non-standard_Header}}, you can put the sidebar macro inside the same {{HTMLElement("p")}}, like this:

+ +
<p>\{{HTTPSidebar}}\{{Non-standard_Header}}</p>
+ +

Creating sidebars

+ +

details coming

+ +

Talk about {{TemplateLink("SidebarUtilities")}}.

+ +

There are some macros that can be used to help build sidebars:

+ +
+
{{TemplateLink("ListSubpagesForSidebar")}}
+
Creates a tree of links structured for use in a sidebar, using the subpages of the specified page.
+
diff --git a/files/es/mdn/contribute/howto/write_a_new_entry_in_the_glossary/index.html b/files/es/mdn/contribute/howto/write_a_new_entry_in_the_glossary/index.html new file mode 100644 index 0000000000..a2ae723fb2 --- /dev/null +++ b/files/es/mdn/contribute/howto/write_a_new_entry_in_the_glossary/index.html @@ -0,0 +1,72 @@ +--- +title: Cómo escribir una nueva entrada en el Glosario +slug: MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary +tags: + - Glosario + - Guía + - Howto + - MDN Meta +translation_of: MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary +--- +
{{MDNSidebar}}
+ +

El glosario MDN es el sitio donde definimos toda la terminología, jerga, y abreviaciones usadas en la documentación y en la codificación. Contribuir al glosario es una manera simple de hacer la Web más fácil para que todo el mundo la entienda. No necesitas un nivel alto de conocimientos técnicos para escribir entradas en el glosario, porque éstas deberían ser simples y sencillas.

+ +

Este artículo describe como escribir una buena entrada al glosario acerca de un tema para el sitio web de MDN docs.

+ +

Comó escribir una entrada

+ +

Si estás buscando temas que necesitan una entrada al glosario, revisa la lista de temas indocumentados en el final de la página principal del Glosario; sigue cualquiera de esos enlaces para empezar una nueva página al Glosario para el item que has seguido;después digue los pasos más abajo.

+ +

Si tienes una idea para una nueva entrada al glosario, simplemente abre el siguiente botón en una nueva pestaña y sigue las instrucciones siguientes al botón:

+ +

Escribir una nueva entrada en el Glosario

+ +

Paso 1: Escribir un resumen

+ +

El primer párrafo de cualquiera de las páginas del glosario es una descripción simple y corta del término, preferentemente de no más de una o dos oraciones. Asegúrate de que cualquiera que esté leyendo el glosario debe de poder entender la definición del término inmediatamente.

+ +
+

Nota: Por favor no copies y pegues definiciones de cualquier otro sitio (especialmente no de la Wikipedia, ya que su rango de licencias es más pequeño, y lo hace incompatible con MDN). Es realmente importante que el contenido sea simple y fácil de entender. Merece la pena dedicarle algo de tiempo en lugar de robar contenido a ciegas. Este glosario debería ser contenido nuevo útil, no cosas repetidas de cualquier otro sitio.

+
+ +

Los enlaces a la entrada del glosario usarán esos resúmenes en sus tooltips, de tal forma que los lectores puedan ver las definiciones sin navegar fuera de la página donde se encuentran. (Ver más abajo como insertar enlaces a entradas del glosario con la macro \{{Glossary}} .)

+ +

Si debes, tu puedes añadir algún párrafo extra, pero es muy fácil verte escribiendo un artículo entero. Escribir un artículo completo está bien, pero por favor no lo pongas en el glosario. Si no estás seguro de dónde poner tu artículo, sienteté libre de discutirlo.

+ +

Paso 2: Extenderse con los enlaces

+ +

Finalmente, una entrada al glosario debería terminar siempre con una sección "Aprender más" . Esta sección debería contener enlaces para ayudar al lector a prograsar: descubrir nuevos detalles, aprender a usar la tecnología relevante, etc.

+ +

Recomendamos que ordenes los enlaces al menos en estos tres grupos:

+ +

 

+ +

Esta sección es donde se puede escribir una descripción más detallada. En esta sección no hay que dudar en explicar todos los detalles necesarios, proveer algún contexto o detalles históricos interesantes, etc. Depende de usted. Lo que hay que recordar es que debe de enfocarse en conocimiento general en lugar de en detalles técnicos. Si desea escribir en detalles técnicos, es mejor escribir un artículo regular en MDN. La intención del glosario es proveer información a la audiencia general, así que un principiante debe de poder comprender esta sección.

+ +

As an example, take a look at the "{{Glossary("JavaScript")}}" term definition.

+ + + +

Finally, a glossary entry should always end with a "Know more" section. This section should contain links to help the reader move forward: discovering more details, learning to use the relevant technology, and so on.

+ +

We recommend that you categorize the links in at least these three categories:

+ +
+
General knowledge
+
Links that provide more general information; for example, a link to Wikipedia is a good starting point.
+
Technical reference
+
Links to more in-depth technical information. These links can be to pages on MDN or elsewhere on the Internet.
+
Learn about it
+
Links to tutorials, exercises, or any other teaching materials that can directly help the reader learn to use the technology behind the term being defined.
+
+ +

Suggested terms

+ +

Do you want to contribute but you don't know which terms need to be defined? Here's a list of suggestions. Click one and get started!

+ +

{{GlossaryList({"terms":["ARIA","Array","ATAG","Asynchronous","BiDi","Blink","Block","CalDAV","Call stack","CardDAV","Constant","Constructor","Content type","Closure","CORS","CSRF","Control flow","Character","Crawler","DNS","Doctype","Domain","DTD","Dynamic typing","ECMA","Element","Entity","Exception","Adobe Flash","FTP","Host","HTTP","Hyperlink","Hypertext","I18N","Identifier","IDL","MS Internet Explorer","IETF","IIFE","Immutable","Internationalization","IndexedDB","Instance","Internet","IP address","IPv4","Keyword","Locale","Localization","ltr","MathML","Method","Microsoft Internet Explorer","MIME type","Mobile First","Mozilla Firefox","Netscape Navigator","NAT","Native","Null","OOP","Opera Browser","Operand","Operator","Parameter","Parser","PDF","Presto","property","Protocol","Prototype","Pseudo-class","Pseudo-element","RDF","Recursion","Reflow","Regular expression","Rendering engine","Responsive design","REST","rtl","Scope","CSS Selector","Server","SSL","Stacking context","State machine","Statement","STUN","Synchronous","Tag","TLS","Trident","TURN","Type","Value","Variable","Wrapper"], "filter":"notdefined", "css":"multiColumnList"})}}

+ +

 

+ +

 

diff --git a/files/es/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html b/files/es/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html new file mode 100644 index 0000000000..05d72dd7f7 --- /dev/null +++ b/files/es/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html @@ -0,0 +1,106 @@ +--- +title: Cómo escribir un artículo para ayudar a las personas a aprender sobre la Web. +slug: MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web +tags: + - Aprender + - Como + - Guía + - MDN Meta +translation_of: MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web +--- +
{{MDNSidebar}}
+ +

El área de aprendizaje de MDN es nuestro hogar para artículos que presentan conceptos web a nuevos desarrolladores. Debido a que su contenido está dirigido principalmente a principiantes, es un gran lugar para compartir tus conocimientos y ayudar a los recién llegados a conocer la web. Es importante asegurarse de que los nuevos desarrolladores puedan seguir este contenido, por lo que le prestamos especial atención.

+ +

Este artículo explica cómo escribir páginas para el Área de aprendizaje.

+ +

Cómo escribir un artículo en el Área de aprendizaje

+ +

Para comenzar a aportar tu conocimiento, simplemente haz clic en el botón verde grande, luego sigue los cinco pasos a continuación. Si estás buscando ideas, echa un vistazo al tablero de Trello de nuestro equipo.

+ +
Escribe un nuevo artículo
+ +

Este artículo podría no terminar exactamente en el lugar correcto, pero al menos está en MDN. Si necesitas hablar con alguien para que lo trasladen al lugar correcto, por favor contáctanos.

+ +

Paso 1: Escribe en dos líneas

+ +

La primera oración de tu artículo debe resumir qué tema vas a cubrir y la segunda debe entrar en algunos detalles más sobre los elementos que pondrías en el artículo. Por ejemplo:

+ +
+

Mientras {{glossary("HTML")}} los archivos contienen contenido estructurado, {{Glossary("CSS")}}, otra tecnología web, hace que el contenido se vea como tú quieres. En este artículo vamos a cubrir cómo funciona esta tecnología y cómo escribir tu propio ejemplo básico.

+
+ +

Observa cómo el ejemplo explica brevemente que CSS es una tecnología web central que se usa para diseñar páginas. Eso es suficiente para que el lector tenga una idea bastante buena de lo que cubre el artículo.

+ +

Debido a que los artículos del Área de aprendizaje se dirigen principalmente a los principiantes, cada artículo debe cubrir un tema directo para no abrumar al lector con demasiada información nueva. Si no puedes resumir el artículo en una oración, ¡podrías estar intentando hacer demasiado en un artículo!

+ +

Paso 2: Agregar un cuadro superior

+ +

Luego, agrega un cuadro superior para ayudar a los lectores a orientarse sobre dónde se encuentran en el proceso de aprendizaje. Aquí hay un ejemplo de un cuadro superior de "Entendiendo las URLs y su estructura". Puedes usar este artículo como modelo cuando escribas tu propio artículo.

+ + + + + + + + + + + + +
Requisitos previos:Primero necesitas saber cómo funciona Internet, qué es un servidor web  y los conceptos detras de los enlaces de la web.
Objetivo:Aprenderás qué es una URL y cómo funciona en la web.
+ +
+
Requisitos previos
+
¿Qué debe saber ya el lector para seguir el artículo? Cuando sea posible, haz de cada requisito previo un enlace a otro artículo del Área de aprendizaje que cubra el concepto (a menos que sea un artículo realmente básico que no requiere conocimiento previo).
+
Objetivos
+
Esta sección explica brevemente lo que el lector aprenderá a lo largo del artículo. Esto es un poco diferente al de una sola línea; (el one-liner resume el tema del artículo), mientras que la sección de objetivos establece específicamente lo que el lector puede esperar lograr en el transcurso del artículo.
+
+ +
+

Nota: Para crear esta tabla, puedes copiar y pegar la tabla del ejemplo anterior o usar la herramienta de tabla del editor de MDN. Si eliges usar la herramienta de tabla, tienes que agregar específicamente la clase CSS learn-box además de la clase predeterminada standard-table.Para hacer esto, cuando crees o edites las propiedades de la tabla, ve al panel "Avanzado" y configura el campo Stylesheet Classes a "standard-table learn-box".

+
+ +

Paso 3: Escribir una descripción completa

+ +

A continuación, escribe una descripción más larga que ofrezca una visión más completa del artículo, destacando los conceptos más importantes. ¡No olvides explicar por qué el lector debe tomarse el tiempo para aprender este tema y leer tu artículo!

+ +

Paso 4: Cavar más profundo

+ +

Cuando hayas terminado con todo eso, finalmente puedes sumergirte profundamente en el tema. Puedes estructurar esta parte de tu artículo como desees (aunque no dudes en consultar nuestra guía de estilo). ¡Esta es tu oportunidad para brillar! Entra en detalles explicando el tema sobre el que estás escribiendo. Proporciona enlaces a la documentación de referencia completa, explica cómo funciona la tecnología en detalle, brinda detalles de sintaxis y uso, etc. ¡Tú decides!

+ +

Como guía, aquí hay algunos consejos de escritura para principiantes:

+ + + +

Eche un vistazo a las primeras secciones de nuestras Funciones - Bloques de código reutilizables para algunas buenas secciones descriptivas.

+ +

Paso 5: Proporcionar material de "aprendizaje activo"

+ +

Para ilustrar el artículo y ayudar al lector a comprender mejor lo que están aprendiendo, asegúrese de proporcionar ejercicios, tutoriales y tareas que cumplir. Al hacer que utilicen y experimenten de forma activa y práctica con los conceptos que explica su artículo, puede ayudar a "bloquear" la información en sus cerebros.

+ +

Puede elegir incluir los ejemplos directamente en la página como muestras en vivo, o vincularlos si realmente no funcionan como una muestra en vivo. Si está interesado en ayudar a crear estos valiosos materiales, lea el artículo Cree un ejercicio interactivo para ayudar a aprender la web.

+ +

Si no puede proporcionar enlaces a materiales de aprendizaje activos existentes (no sabe de ninguno o no tiene tiempo para crearlos), debe agregar la etiqueta{{Tag("NeedsActiveLearning")}}  al artículo. De esa manera, otros colaboradores pueden encontrar artículos que necesitan materiales de aprendizaje activo y quizás ayudarlo a encontrarlos.

+ +

Eche un vistazo a Aprendizaje activo: seleccione diferentes elementos para un ejercicio de aprendizaje interactivo en vivo, o Aprendizaje activo juegue con posibilidades para un estilo diferente de ejercicio que les exija descargar una plantilla localmente y modificarla siguiendo los pasos proporcionados.

+ +

Paso 6: Obtenga el artículo revisado y póngalo en el menú de navegación del Área de aprendizaje

+ +

Después de que hayas escrito tu artículo, avísanos para que podamos echarle un vistazo, hacer una revisión y sugerir mejoras. Una vez más, consulte nuestra sección Contáctenos para conocer las mejores maneras de comunicarse.

+ +

En el menú de navegación principal del Área de aprendizaje. Este menú es generado por la macro Barra de aprendizaje, que necesita privilegios especiales para editar, así como una vez más, hable con uno de nuestro equipo sobre cómo agregarlo.

+ +

Al menos debe agregarlo a su página. Esto se hace agregando la llamada a la macro \{{LearnSidebar}} en un párrafo en la parte superior de su página.

+ +

Artículos sugeridos

+ +

¿Así es que quieres contribuir?

+ +

El equipo del Área de Aprendizaje Mantiene ONU Tablero de Trello las ideas Con de Artículos para Escribir. ¡Siéntete libre de elegir uno y ponte a trabajar!

diff --git a/files/es/mdn/contribute/index.html b/files/es/mdn/contribute/index.html new file mode 100644 index 0000000000..ce84773d87 --- /dev/null +++ b/files/es/mdn/contribute/index.html @@ -0,0 +1,70 @@ +--- +title: Contribuir al MDN +slug: MDN/Contribute +tags: + - Documentación + - Guía + - MDN + - NeedTranslate + - TopicStub +translation_of: MDN/Contribute +--- +
{{MDNSidebar}}
+ +

¡Bienvenido! Al visitar esta página, has dado el primer paso para convertirte en un colaborador de MDN. Las guías aquí cubren todos los aspectos de cómo contribuir al MDN, incluyendo las guías de estilo, guías para el uso de nuestro editor, herramientas y mucho más.

+ +
+
+

Guías de Colaborador

+ +
+
Primeros pasos
+
Una guía de inicio rápido para crear y hacer tu primera contribución.
+
Guía de contenido y estilo
+
La guía de contenido y estilo de MDN proporciona detalles sobre estilo de escritura, diseño de página y estilos de contenido para que el contenido que escribes encaje en el resto del contenido del MDN.
+
Guía de editor
+
Una guía completa para usar el editor del MDN.
+
Revisión de los artículos
+
Una guía para la realización de las revisiones técnicas y editoriales del contenido de los artículos, para ayudarnos a garantizar que todo el contenido de MDN es tan útil y fácil de leer como debe ser.
+
Terminología y convenciones
+
Nuestra guía de terminología y convenciones proporciona información que puedes utilizar para asegurarte de que utilizas la terminología correcta al describir las cosas.
+
Trabajar con la comunidad MDN
+
Una guía para trabajar con nuestra comunidad, la búsqueda de ayuda, la conexión con las personas y respuestas a las preguntas que surgen mientras contribuyes a MDN.
+
Preguntas frecuentes
+
Respuesta y consejos para las dudas más comunes acerca de contribuir al MDN.
+
+ +
+
Contribuir a Kuma
+
Una guía para contribuir al proyecto Kuma. Kuma es la plataforma que impulsa el sitio Web MDN
+
+
+ +
+

Cómo hacerlo

+ +

Nuestra guía cómo hacerlo proporciona instrucciones paso a paso para ayudarle a realizar tareas específicas cuando contribuye al MDN.

+ +
+
Modo de documentar una propiedad CSS
+
Una guía para escribir documentos con propiedades CSS. Todos los documentos de propiedad CSS deben coincidir con el estilo y el diseño descrito en este artículo.
+
Cómo etiquetar páginas correctamente
+
Esta guía de etiquetado de páginas proporciona información acerca de nuestras normas de etiquetado, incluyendo listas de las etiquetas que tienen un significado estándar en MDN. Siguiendo esta guía te asegurarás de que su contenido esté correctamente categorizado, con mayor facilidad de búsqueda y que nuestro mecanismo de filtrado de búsqueda funciona correctamente con sus artículos.
+
Cómo interpretar las especificaciones
+
Esta guía te ayudará a interpretar correctamente las especificaciones estándar de la Web. Ser capaz de leer éstos, pueden ser una forma de arte y saber cómo hacerlo te ayudará a producir una mejor documentación.
+
+ +

Localización

+ +
+
Localización visita guiada
+
Esta visita guiada te enseñará a localizar contenidos en MDN.
+
Guía de localización
+
Esta guía proporciona información sobre el proceso de localización de los contenidos MDN.
+
Proyectos de localización
+
Encuentra el proyecto de localización para tu idioma o si no hay uno, ¡Aprende cómo iniciar uno nuevo!
+
+
+
+ +

 

diff --git a/files/es/mdn/contribute/localize/index.html b/files/es/mdn/contribute/localize/index.html new file mode 100644 index 0000000000..49731d7387 --- /dev/null +++ b/files/es/mdn/contribute/localize/index.html @@ -0,0 +1,31 @@ +--- +title: Localización en MDN +slug: MDN/Contribute/Localize +tags: + - Documentación + - Localización + - MDN + - Necesita traducción + - Proyecto MDC +translation_of: MDN/Contribute/Localize +--- +
{{MDNSidebar}}

MDN es usado por personas de todo el mundo como referencia y guía de las tecnologias Web, como así tambien de los interiores de Firefox. Nuestras comunidades de localización son una parte clave del proyecto Mozilla; su trabajo de traducción y localizacion de nuestra documentación ayuda a personas de todo el mundo a desarrollar para la Web abierta. Si quieres aprender más acerca de nuestros equipos de localización, únete a uno de nuestros equipos, o quizas quieres comenzar una nueva localización, éste es el lugar para comenzar.

+ +

{{LandingPageListSubpages}}

+ +

Herramientas de localización

+ +

Se encuentran muchisimas herramientas útiles que usaras durante el trabajo de localización:

+ +
+
Verbatim
+
Utilízelo para relizar traducciones de frases a travez de multiples proyectos Mozilla, incluye una interface de de usuario para MSDN (como así también una interface de usuario para Firefox).
+
Transvision
+
Una utilidad proveida por Mozilla Francia, la cual te permite realizar búsquedas por ocurrencias de frases en una localización en Inglés, encontrando cualquier traducción a otro idioma en una localización de destino a lo largo de todo el código fuente de Mozilla. Es útil para encontrar la traducción preferida para palabras o frases.
+
+ +

Vea ademas

+ + diff --git a/files/es/mdn/contribute/localize/iniciar_una_localizacion/index.html b/files/es/mdn/contribute/localize/iniciar_una_localizacion/index.html new file mode 100644 index 0000000000..f0596fa409 --- /dev/null +++ b/files/es/mdn/contribute/localize/iniciar_una_localizacion/index.html @@ -0,0 +1,108 @@ +--- +title: Iniciar una nueva localización MDN +slug: MDN/Contribute/Localize/Iniciar_una_localizacion +tags: + - Documentación + - Guía + - I10n + - Localización + - MDN Meta +translation_of: MDN/Contribute/Localize/Starting_a_localization +--- +
{{MDNSidebar}}

Las localizaciones de contenido MDN ayudan a extender el alcance de MDN a muchos más desarrolladores web y potenciales desarrolladores web que simplemente aquellos que pueden leer inglés. Por lo tanto, las localizaciones son una parte vital de lograr la misión de MDN.

+ +

Las solicitudes de nuevas localizaciones en MDN se evalúan caso por caso y deben cumplir con algunos requisitos mínimos. Otros factores que se consideran incluyen el número de hablantes de la lengua, y la proporción de ese grupo que también leer Inglés. No tenemos reglas estrictas sobre estos números, pero se dará prioridad a los locales que amplíen significativamente el alcance de MDN. Un idioma con una gran población de hablantes que no leen inglés tendrá mayor prioridad que uno con una pequeña población de oradores, donde muchos de ellos hablan inglés.

+ +

Criterios minimos

+ +

Los criterios mínimos para agregar un entorno regional a MDN son:

+ + + +

Proceso para iniciar una localización

+ +

Iniciar una localización no es un evento único, sino un proceso con los siguientes pasos generales:
+  

+ +
    +
  1. Ser miembro de una Comunidad activa de localización Mozilla. Si la comunidad de Mozilla para su entorno regional no está activa, trabaje en la creación de esa comunidad antes de expandirla para incluir MDN.
    2. +
  2.  Comuníquese con la comunidad de MDN para compartir su intención de iniciar una nueva localización MDN. (Por ejemplo, únase a las Listas de correo relacionadas con MDN  y al canal IRC de #mdn en irc.mozilla.org.) Los miembros principales de la comunidad de MDN, incluyendo el personal de MDN, pueden aconsejarle si su localidad propuesta parece ser un buen ajuste para MDN.
    3. +
  3. Agregue una sección para su idioma a la lista de proyectos de localización,e incluya a cualquier otra persona que esté planeando trabajar en ella. .
    4. +
  4. Envíe un bug en Bugzilla para solicitar la activación de su entorno local para MDN en Pontoon. Este error debe estar en la categoría "Mozilla Developer Network"> "Localización". Un administrador de pontón debe realizar esta activación.
    5. +
  5. Trabaje con su comunidad de localización para traducir las cadenas de interfaz de usuario de MDN en Pontoon. No continúe con el siguiente paso hasta que haya traducido al menos el 50% de las cadenas. Mantenga la comunicación con la comunidad MDN sobre su progreso.
    6. +
  6. Envíe un bug en Bugzilla para solicitar que se agregue la configuración regional a la lista de configuraciones locales disponibles en MDN. (El mismo producto y categoría que el error en el Paso 4) Indique quién tomará el papel de líder de localización de MDN, para ser un punto de contacto entre el grupo de localización de MDN y el resto de la comunidad de MDN. Normalmente, esta es la persona que envía el error. Para que su solicitud sea aceptada, un miembro del equipo central de MDN debe estar dispuesto a ser el mentor del líder de localización, por lo que una buena comunicación hasta este punto será rentable si puede demostrar que: +
      +
    1. Su comunidad de localización de Mozilla está activa y tiene la organización y el interés necesarios para mantener el trabajo en MDN.
      2. +
    2. Su local es un buen ajuste para MDN.
      3. +
    3.  Como líder de localización, es fácil trabajar y responder a los comentarios.
      4. +
    +
    7. +
+ +

Organización de un proyecto de localización: Mecánica MDN

+ +

La estructura básica de la jerarquía de páginas en cada una de las localizaciones de MDN debe ser esencialmente la misma. En general, debe intentar mantener la misma jerarquía de páginas que la configuración regional en-US (inglés), de modo que cada página de cada idioma corresponda a una página similar en cada localidad.

+ +

Te invitamos a vincular a páginas locales externas, escribir tus propios artículos y traducir todo desde el wiki en inglés. Si decides escribir tus propios artículos, sería útil que pudieras proporcionar una traducción en inglés para el wiki en inglés para que luego pueda traducirse a todos los otros wikis localizados.

+ +

Al agregar recursos locales, debe mantener un punto de vista neutral; Es decir, no debes promover una perspectiva en particular y, en lugar de ello, debes simplemente proporcionar los hechos de la mejor manera posible (ver información sobre la regla NPOVen Wikipedia). No debe enlazar a sitios comerciales (como cursos pagados, empresas de diseño web, etc.). Debe promover estándares abiertos y compatibilidad entre navegadores por métodos cerrados o propietarios siempre que sea posible.

+ +
+

Se anima a los directores de equipo a que monitoreen el contenido de su localidad en busca de spam y otros materiales inapropiados y tomen medidas para eliminarlos o corregirlos.

+
+ +

 Hay muchos consejos de varios equipos de traducción existentes; Usted debe sentirse libre de adoptar cualquiera de estas ideas que usted elija. Además, no dude en añadir sus propias sugerencias. Vea esta plantilla en el wiki español para ver un ejemplo.

+ + + +

Para encontrar ayuda con su proyecto, asegúrese de preguntar por la lista de distribución de dev-mdc, el canal IRC #mdn , y otras áreas de discusión relacionadas con MDN. Consulte "Únase a la comunidad de MDN" para obtener sugerencias para los canales de debate de la comunidad que le ayudarán a encontrar otros interesados en unirse a su equipo de localización.

+ +

También puede encontrar otros interesados en ayudarle asistiendo a eventos de desarrollo Web locales, en su espacio de hackers local, y similares. ¡Séa creativo!

+ +

Organización de una comunidad de localización

+ +

Trabajar con cualquier comunidad de localización de Mozilla existente

+ +

La experiencia ha demostrado que las comunidades de localización más activas y exitosas en MDN son extensiones de comunidades de localización de Mozilla existentes. Si está interesado en iniciar una localización en MDN y ya no está en contacto con la comunidad de Mozilla para su entorno local, busque en ellas y póngase en contacto. Encontrarás algunas personas con experiencia para compartir sobre Mozilla y la localización.

+ +

Conseguir mucha gente involucrada

+ +

También hemos visto que cuanto más gente está involucrada en un esfuerzo de localización, más probable es que sea autosostenible. Las personas vienen y van en un esfuerzo de localización (como la mayoría de las cosas en la vida). Cuantas más personas estén involucradas, más probable es que el grupo sostenga a través de esos cambios. Los esfuerzos que son iniciados por una persona o un grupo pequeño por lo general no permanecen activos más tiempo que los miembros iniciales. Por lo tanto, una gran parte de iniciar un esfuerzo de localización es reclutar suficiente gente para que el grupo siga adelante incluso cuando algunas personas abandonan, como inevitablemente lo hacen.

+ +

Reunirse regularmente, en persona o en línea

+ +

Reunirse regularmente con otros localizadores puede ser una gran manera de construir un sentido de cohesión de grupo, para que la gente quiera seguir participando. Reunión cara a cara es grande si todo el mundo está situado muy cerca lo suficiente como para poder hacer eso. Puede reunirse prácticamente en línea si su grupo se extiende demasiado lejos para reunirse en persona. Reunirse en un horario regular, como una vez al mes, también es importante, para que los miembros del grupo pueden planear para asistir. Algunos localizers pueden contribuir solamente durante un meet-up, y no en otras veces.

+ +

Qué traducir primero

+ +

MDN tiene miles de artículos en muchas áreas temáticas diferentes. Tal vez usted es un apasionado de un tema en particular - por todos los medios, empezar allí! Pero si buscas puntos de partida, he aquí algunas sugerencias:

+ + + +

Para algunas localidades, los localizadores consideran que las guías y los tutoriales son una prioridad mayor que las páginas de referencia. Los desarrolladores web a menudo pueden descubrir la sintaxis del código de la versión inglesa de una página, incluso si no saben mucho inglés. Pero aprender nuevos conceptos es mucho más cómodo en la lengua materna. Por lo tanto, puede ser importante para traducir tutoriales primero.

+ +

Política

+ +

 
+ Todos los materiales creados y traducidos para el MDN deben seguir nuestras Políticas de Derechos de Autor y Licencias..

+ +

Si encuentra problemas de cualquier tipo,— técnicos, políticos u otros—, póngase en contacto con el Equipo de Administración MDN.

+ +

 

diff --git a/files/es/mdn/contribute/localize/project_colon_localization_projects/index.html b/files/es/mdn/contribute/localize/project_colon_localization_projects/index.html new file mode 100644 index 0000000000..829f196bba --- /dev/null +++ b/files/es/mdn/contribute/localize/project_colon_localization_projects/index.html @@ -0,0 +1,405 @@ +--- +title: Proyectos de localización +slug: 'MDN/Contribute/Localize/Project:Localization_Projects' +tags: + - Comunidad + - Localización + - MDN Meta + - Referencia + - l10n +translation_of: MDN/Contribute/Localize/Localization_projects +--- +
{{MDNSidebar}}
+ +

Este artículo describe nuestros proyectos de localización existentes, así como también lo que necesitas hacer si quieres iniciar un nuevo proyecto de localización en MDN.

+ +

Proyectos de localización MDN existentes

+ +

Todos los equipos de los proyectos de localización de MDN deben mantener su información actualizada en esta tabla, para que, de este modo, los contribuidores interesados puedan ponerse en contacto con ellos y ofrecer su ayuda.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
IdiomaLíderContribuidoresNotas
Francés( Jeremie )FredB, Alain Boquet, Fréderic Chateaux, Vincent N., Benoit Leseul, Shz, Thierry Régagnon (tregagnon), xaky, Goofy, sylzys, the prisoner, Julien STUBY, poum, sylvie(notas o URL al equipo de localización project team page)
Italiano?Federico, mck89, marcostudios, loris94, MrW0lf, Iacchi, camaleo, marcantonio, Grino, Nicola_D 
JaponésPotappoYoshino(ex.Mozilla Japan), Yuichiro, myakura(Masataka Yakura), yyss, ethertank, nobuoka, Marsf(Masahiko Imanaka), taguchi-ch, sii, saneyuki_s, Shimono(Atsushi Shimono), Taken(Takeshi Kurosawa), Electrolysis, dextra, MasayukiMDC Japan Project (-2009)
PolacoTomasz SokółMarcoos(Marek Stępień), Dapi 
Españolmaedca,francjpSuperruzafa, vhanla, maedca, inma_610, ccarruitero, artopal, StripTM, Jorge.villalobos, Scipion, Verruckt, Nathymig, Rkovac, ajimix, mhauptma73, deimidis, Joalar, Maharba, jessest, MPoli, Antiparticule, {{userlink("LeoHirsch")}}, {{userlink("gorrotowi")}}, {{userlink("AlePerez92")}}Necesitamos, de verdad, más traductores.
Portugués (Brasil)Jaydson GomesGalvão, Atila, francisco.hansen, francineemilia, battisti, jpalharini, LeonardoPacheco, Lehrerschuler, hsteffano, lfz, -pedrohenrique-, eduardodx, mateus.m.luna, josivansilva, TelaSocial, mazulo, vlopez5, robsonds, HenriqueSilverioCómo ayudar a MDN
Portugués (Portugal)Leandro Mercês XavierMatheus Smythe Svolenski, Luis Henrique Sousa, f.sanxz 
CoreanoChanny YunKorean ContributorsGoogle Groups
AlemánElchi3eminor, AlexPl, Sprottenwels, tessarakt3, jwlNecesitamos, de verdad, más traductores.
+

Griego

+ 		syssgxJasnaPaka, DJ.MacaNecesitamos más traductores.
Ruso?Cobalt747, Sky_Fox, Chernetsky, uleming, karasiov, Dionys, Megapotz, hazestalker, KwintoNecesitamos más traductores.
Chino (Tradicional)BobChaodwchiang, happysadman, petercpg, sailplaneTW, Kourge, Josesun, Sonrisa, Kennyluck, sycheng, naihsi, evelynhung¡Necesitamos más traductores! ¡Únete a nosotros en Google Groups!
+

Chino Simplificado

+ 		yanzehua(-2008?)ziyunfei, 宋晓光, Duwei, alzhu, Cnmahj, Andyyard, yinian1992, Chajn, c_king, iwo +

¡Necesitamos más traductores y buena organización!

+ +

¡Únete a nosotros en Google Groups!

+
HebreoZiv PerryInkbugNecesitamos más traductores.
RumanoRaul Malea Necesitamos más traductores.
TailandésHassadee Pimsuwan Necesitamos, de verdad, más traductores.
TurcoHakan Damar Necesitamos más traductores.
+ +

¿Cómo inicio un proyecto de localización?

+ +

Si estás interesado en iniciar un proyecto de localización para traducir MDN a tu idioma, aquí están los pasos que debes seguir para contribuir.

+ +
    +
  1. Primero, revisa que no exista ya un proyecto asociado a ese idioma.
    2. +
  2. Ponte en contacto con el Equipo de localización de Mozilla de tu idioma, y dales a conocer tus planes.
    3. +
  3. Inscríbete en nuestras Listas de Correo e ingresa al canal de IRC #devmo en irc.mozilla.org.
    4. +
  4. Contacta a sheppy, nuestro líder del equipo de Documentación para Desarrolladores, para informarle de que deseas iniciar una nueva localización. No es que necesites su permiso, pero le interesaría saber quién eres.
    5. +
  5. Añade una fila para tu idioma en la tabla de arriba e incluye a quienes tengan pensado trabajar en ello.
    6. +
  6. Crea un reporte en Bugzilla, solicitando que tu idioma sea añadido a la lista de idiomas compatibles con MDN. El reporte debe estar en la categoría "Mozilla Developer Network" > "Localización". Será asignado automáticamente a la persona indicada.
    7. +
  7. Espera mientras el equipo de MDN se encarga de tu solicitud. Si tu bug no se responde en tres o cuatro días, por favor, agrega un comentario al bug pidiendo un "ETA" para su conclusión.
    8. +
  8. Una vez que la localización haya sido añadida a MDN, podrás empezar a usar la herramienta Verbatim para traducir las cadenas de la interfaz de usuario de la página y también podrás empezar a traducir los artículos de la wiki.
    9. +
+ +

 

+ +

¿Cuál es la apariencia de un MDN localizado?

+ +

La estructura básica de cada uno de los wikis localizados debe ser, en esencia, la misma. En general, debes intentar mantener una igual jerarquía de las páginas, para que cada página de cada lenguaje se corresponda con una página similar en todas las localizaciones.

+ +
Eres bienvenido si deseas enlazar páginas locales externas, escribir tus propios artículos y traducir todo desde la wiki inglesa. Si decides escribir tus propios artículos, sería útil que proveyeses una traducción al inglés para que figurase en la wiki inglesa, de forma que ese artículo pudiese ser localizado en todas las otras wikis.
+ +

Al añadir fuentes locales se debe de mantener la regla PDVN (Punto de vista neutral), es decir, no incluir enlaces a sitios comerciales (como cursos de pago, compañías de diseño web, etc.) y, siempre que sea posible, debes promover los estándares abiertos y código web cross-browsing en lugar de métodos cerrados y propietarios.

+ +
+

Nota: Animamos a los líderes de equipo a que controlen su contenido localizado buscando spam y otros materiales inapropiados, para poder tomar las medidas necesarias para eliminarlos o corregirlos.

+
+ +

¿Cómo organizo un proyecto de localización?

+ +

Tienes a tu disposición una estupenda serie de consejos de varios equipos de traducción, así que siéntete libre para adoptar alguna de estas ideas. Además, por favor, anímate e incluye tus propias sugerencias. Echa un vistazo a esta plantilla en la wiki española, por ejemplo.

+ + + +

Fuentes RSS por lengua

+ +

Puedes seguir las fuentes RSS de cada lengua, de forma que recibirás alertas sobre los cambios en los contenidos de cualquiera de ellas:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TargetLocaleLanguageFeed URL
Arabianarعربيhttps://developer.mozilla.org/ar/docs/feeds/atom/all
Bengali (Bangladesh)bn-BDবাঙ্গালীhttps://developer.mozilla.org/bn-BD/docs/feeds/atom/all
Catalancacatalàhttps://developer.mozilla.org/ca/docs/feeds/atom/all
CzechcsČeštinahttps://developer.mozilla.org/cs/docs/feeds/atom/all
GermandeDeutschhttps://developer.mozilla.org/de/docs/feeds/atom/all
GreekelΕλληνικάhttps://developer.mozilla.org/el/docs/feeds/atom/all
Englishen-USEnglishhttps://developer.mozilla.org/en-US/docs/feeds/atom/all
SpanishesEspañolhttps://developer.mozilla.org/es/docs/feeds/atom/all
Persianfaفارسیhttps://developer.mozilla.org/fa/docs/feeds/atom/all
Finnishfisuomihttps://developer.mozilla.org/fi/docs/feeds/atom/all
FrenchfrFrançaishttps://developer.mozilla.org/fr/docs/feeds/atom/all
Frisianfy-NLFryskhttps://developer.mozilla.org/fy-NL/docs/feeds/atom/all
Georgian (Ireland)ga-IEGaeilge (Éire)https://developer.mozilla.org/ga-IE/docs/feeds/atom/all
Hebrewheעבריתhttps://developer.mozilla.org/he/docs/feeds/atom/all
CroatianhrHrvatskihttps://developer.mozilla.org/hr/docs/feeds/atom/all
HungarianhuMagyarhttps://developer.mozilla.org/hu/docs/feeds/atom/all
IndonesianidBahasa Indonesiahttps://developer.mozilla.org/id/docs/feeds/atom/all
ItalianitItalianohttps://developer.mozilla.org/it/docs/feeds/atom/all
Japaneseja日本語https://developer.mozilla.org/ja/docs/feeds/atom/all
Georgiankaქართულიhttps://developer.mozilla.org/ka/docs/feeds/atom/all
Koreanko한국어https://developer.mozilla.org/ko/docs/feeds/atom/all
DutchnlNederlandshttps://developer.mozilla.org/nl/docs/feeds/atom/all
PolishplPolskihttps://developer.mozilla.org/pl/docs/feeds/atom/all
Portuguese (Brazil)pt-BRPortuguês (do Brasil)https://developer.mozilla.org/pt-BR/docs/feeds/atom/all
Portuguese (Europe)pt-PTPortuguês (Europeu)https://developer.mozilla.org/pt-PT/docs/feeds/atom/all
Romanianroromânăhttps://developer.mozilla.org/ro/docs/feeds/atom/all
RussianruРусскийhttps://developer.mozilla.org/ru/docs/feeds/atom/all
AlbaniansqShqiphttps://developer.mozilla.org/sq/docs/feeds/atom/all
Thaithไทยhttps://developer.mozilla.org/th/docs/feeds/atom/all
TurkishtrTürkçehttps://developer.mozilla.org/tr/docs/feeds/atom/all
VietnameseviTiếng Việthttps://developer.mozilla.org/vi/docs/feeds/atom/all
Chinese (Simplified)zh-CN中文 (简体)https://developer.mozilla.org/zh-CN/docs/feeds/atom/all
Chinese (Traditional)zh-TW正體中文 (繁體)https://developer.mozilla.org/zh-TW/docs/feeds/atom/all
+ +

Si deseas tener una fuente personalizada, echa un vistazo a Feeds.

+ +

Política

+ +

Todos los materiales creados y traducidos para la MDN deben seguir nuestras políticas sobre Derechos de autor y licencias.

+ +

Si encuentras algún problema (técnico, sobre la política o de cualquier otra clase), por favor, ponte en contacto con Eric Shepherd utilizando la información de contacto de su página de usuario.

+ +

 

diff --git a/files/es/mdn/contribute/localize/project_colon_translating_mdn_pages/index.html b/files/es/mdn/contribute/localize/project_colon_translating_mdn_pages/index.html new file mode 100644 index 0000000000..2a6c51a563 --- /dev/null +++ b/files/es/mdn/contribute/localize/project_colon_translating_mdn_pages/index.html @@ -0,0 +1,57 @@ +--- +title: Traduciendo páginas de MDN +slug: 'MDN/Contribute/Localize/Project:Translating_MDN_pages' +tags: + - Guía + - MDN Meta + - l10n +translation_of: MDN/Contribute/Localize/Translating_pages +--- +
{{MDNSidebar}}
+ +

Este artículo es una guía básica para traducir contenido en MDN, incluyendo ambas mecánicas de traducir contenido y consejos de maneras apropiadas para encargarse de varios tipos de contenido.

+ +

Empezando la traducción de una página

+ +

Cuando te encuentres con una página que quieras traducir a tu idioma, sigue estos pasos:

+ +
    +
  1. Haz clic en el ícono de Lenguaje ({{FontAwesomeIcon ("icon-language")}}) para abrir el menú de Idiomas y haz clic en Add a Translation. Aparece la página Seleccionar Idiomas.
    2. +
  2. Haz clic en el idioma en el que deseas traducir la página. La vista Traducir Artículo se abre con el texto del idioma original en el lado izquierdo de la vista.
    3. +
  3. Debajo de Translate Description, puedes traducir el título y opcionalmente la link amigable (Slug) al Idioma deseado. El enlace amiglable es la última parte de un enlace (link) de una URL (por ejemplo, "Translating_Pages" De este artículo).  Algunas comunidades no traducen el Enlace (link), dejándolo en Inglés. compara con otros artículos en tu Idioma para determinar prácticas comunes. Puedes hacer clic en el símbolo (-) al lado de Translate Description para esconder esta información cuando termines, para hacer más espacio para la sección de Translate content.
    4. +
  4. Bajo Translate Content, traduce el cuerpo de la página.
    5. +
  5. Llena por lo menos una Etiqueta para la página recién traducida.
    6. +
  6. Haz clic en Guardar cambios cuando hayas terminado.
    7. +
+ +
+

Nota: Los elementos de la interfaz de usuario del visor de artículos que se está traduciendo se muestran inicialmente en inglés. En visitas posteriores para traducir un artículo en particular, la IU se muestra en el idioma apropiado, siempre que haya una configuración regional para ese idioma disponible en MDN. La MDN la interfaz de usuario se puede ubicar usando Verbatim. Consulte Ubicación con Verbatim para obtener detalles sobre cómo usar esta herramienta.
+ Editar una página traducida.

+
+ +

Editando una página traducida

+ + + +

Si la versión en inglés ha sido modificada desde la última traducción, la vista de traducción del artículo mostrará un nivel de fuente de diferencia (source-level "diff") de los cambios realizados en la versión Original en inglés. De esta forma, podrá ver que debe actualizarse en la traducción.
+ Traducir etiquetas.

+ +

Etiquetando traducciones

+ +

Es importante que cada página esté etiquetada con al menos una etiqueta. Incluso si esto es traducción. En general, usar las mismas etiquetas que el artículo original es una buena idea.

+ +

Algunas etiquetas se utilizan para filtros de búsqueda o como convenciones entre colaboradores. No deberían ser traducidos. Para leer estas etiquetas, lea los estándares de etiquetado. Puede crear etiquetas traducidas para contenido grupal si no está cubierto por una de las etiquetas estándar.

+ +

Consejo para los localizadores

+ +

Si recién comienza como un localizador para MDN, aquí hay algunas sugerencias:

+ + diff --git a/files/es/mdn/contribute/procesos/index.html b/files/es/mdn/contribute/procesos/index.html new file mode 100644 index 0000000000..a408f11fb7 --- /dev/null +++ b/files/es/mdn/contribute/procesos/index.html @@ -0,0 +1,14 @@ +--- +title: Procesos de documentación +slug: MDN/Contribute/Procesos +tags: + - Landing + - MDN Meta + - Procesos +translation_of: MDN/Contribute/Processes +--- +
{{MDNSidebar}}
{{IncludeSubnav("/es/docs/MDN")}}
+ +

El proyecto de Documentación MDN es enorme; hay un sinfín de teconologías que cubrimos a través de la asistencia de cientos de colaboradores de todo el mundo. Para ayudarnos a llevar orden al caos, tenemos procesos estandarizados para seguir cuando se trabaja en tareas específicas relacionadas con la documentación. Aquí encontrarás guías para estos procesos.

+ +

{{LandingPageListSubPages()}}

diff --git a/files/es/mdn/contribute/registro_persona/index.html b/files/es/mdn/contribute/registro_persona/index.html new file mode 100644 index 0000000000..37cad64b07 --- /dev/null +++ b/files/es/mdn/contribute/registro_persona/index.html @@ -0,0 +1,36 @@ +--- +title: Registro MDN y Persona +slug: MDN/Contribute/Registro_Persona +tags: + - Documentación + - MDN + - MDN Meta + - Mozilla + - Persona +translation_of: Archive/MDN/Persona_sign-ins +--- +
{{MDNSidebar}}
+

Por favor Enlaza tu cuenta GitHub a tu perfil  MDN ahora

+ +
, para que puedas continuar accediendo en MDN.
+ +

 

+
+ +

Actualmente, MDN permite a los colaboradores iniciar sesión proveiendo dos tipos diferentes de autenticación: Mozilla Persona y GitHub. A partir del 1 de noviembre del 2016, eliminaremos la opción Persona para iniciar sesión. Por lo tanto, deberás habilitar la autenticación de Github en tu perfil para evitar perder el acceso de inicio de sesión a MDN.

+ +

Reconocemos que esto es un inconveniente, y nos disculpamos por ello. Desafortunadamente, esto esta fuera de nuestro control.

+ +

¿Porqué Persona sera eliminado?

+ +

Mozilla ha cerrado el proyecto Persona, y sus servidores serán desactivados en Noviembre del 2016. Puedes obtener mas información sobre la decisión de Mozilla para retirar Persona de Mozilla wiki.

+ +

¿Cuándo será eliminado Persona?

+ +

Vamos a desactivar Persona como un proveedor de autenticación el 1 de Noviembre del 2016; en otras palabras, el ultimo dia que podrás tener acceso para iniciar sesión en MDN usando Persona sera el 31 de Octubre del 2016. Estaremos emitiendo notificaciones mas frecuentes y cada vez mas urgentes para agregar la cuenta de GitHub a tu perfil de MDN iniciando ahora. Por favor realiza esto tan pronto como sea posible, con la finalidad de evitar el riesgo de perder el acceso a tu cuenta de MDN.

+ +

¿MDN ofrecerá otro proveedor de autenticación?

+ +

Nos gustaría mucho hacerlo, pero en este momento no tenemos identificado otro proveedor de autenticación que cumpla con nuestros requisitos; además, actualmente no tenemos los recursos de desarrolladores para integrar otro proveedor. Por el momento, la única opción para mantener acceso como colaborador en MDN es Enlazando tu perfil MDN a tu cuenta GitHub.

+ +

Ten en cuenta, por supuesto, que no es necesario iniciar sesión en tu cuenta MDN para leer nuestro contenido. Pero si es necesario tener una cuenta para contribuir, y si deseas ser capaz de contribuir en cualquier momento en el futuro, asegurarte de agregar una cuenta de GitHub a tu perfil tan pronto como sea posible, antes del 31 de Octubre del 2016.

diff --git a/files/es/mdn/contribute/tareas/index.html b/files/es/mdn/contribute/tareas/index.html new file mode 100644 index 0000000000..b8614f38ee --- /dev/null +++ b/files/es/mdn/contribute/tareas/index.html @@ -0,0 +1,17 @@ +--- +title: Cosas para hacer en MDN +slug: MDN/Contribute/Tareas +translation_of: MDN/Contribute/Getting_started +--- +
{{MDNSidebar}}

¿Estás buscando formas de ayudar a mejorar MDN? Hay muchas formas de ayudar: desde corregir errores tipográficos hasta escribir nuevo contenido, o incluso ayudar a desarrollar la plataforma Kuma en la que se construye el sitio web. La guía para el contribuyente de MDN cubre todas las formas en las que puedes ayudar y cómo hacerlo. Más abajo, encontrarás listas de tareas más específicas que faltan hacer.

+

Hay un montón de cosas que puedes hacer para ayudar en MDN. Tenemos una guía para las tareas que puedes llevar a cabo como parte de nuestro artículo Comenzando en MDN. Entre las posibles formas de ayudar se encuentran:

+ +

Para más ideas acerca de cosas en las que puedes colaborar con MDN, vé nuestras Guías de cómo hacerlo. Puedes encontrar listas de páginas categorizadasque necesitan de tu ayuda en nuestra sección de  Estado de la Documentación.

diff --git a/files/es/mdn/contribute/team_status/index.html b/files/es/mdn/contribute/team_status/index.html new file mode 100644 index 0000000000..c8146f8566 --- /dev/null +++ b/files/es/mdn/contribute/team_status/index.html @@ -0,0 +1,93 @@ +--- +title: Tabla de estado del equipo +slug: MDN/Contribute/Team_status +translation_of: Archive/Meta_docs/Team_status_board +--- +
{{MDNSidebar}}

Esta tabla es una lista de contribuyentes MDN y lo que actualmente están trabajando. Siéntase libre de agregarse usted mismo y lo que estás haciendo a esta lista, pero ten en cuenta que vamos a purgar elementos fuera de fecha con regularidad; por lo que si decide añadirte a ti mismo, debe hacer su mejor esfuerzo para mantener actualizada la información (incluso si todo lo que hace es actualizar la "última actualización" que por lo que sabemos que está mantenerlo actualizado, a pesar de su trabajo toma mucho tiempo para terminar).

+
+

Nota:  No agregue una nueva fila para cada actualización de estado; simplemente actualizar el contenido existente. Esto no tiene la intención de realizar un seguimiento de lo que haces con el tiempo, sino simplemente dejar que las partes interesadas conozcan lo su trabajo actual es.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
UsernameLast UpdatedStatus
{{UserLink("Sheppy")}}June 19, 2013Ongoing work on MDN contributor guide. Gradually getting back into work on core B2G docs.
{{UserLink("jswisher")}}April 8, 2013Contribution pathway for writing volunteers; Mozilla Reps SIGs for Evangelism and Documentation.
{{UserLink("teoli")}}April 9, 2013Web Audio API; Maintaining CSS/HTML; Fx for devs
{{UserLink("wbamberg")}}  
{{UserLink("MarkGiffin")}}April 8, 2013App payments (in-app and paid apps); reference apps; packaged apps; managing your app.
{{UserLink("Domecraft")}}September 20, 2013Contributions to docs involving Web development
{{UserLink("Jeremie")}}August 8, 2013Keep going on WebAPI, now with a focus on various network APIs
{{UserLink("madarche")}}April 9, 2013Plan to work on IndexedDB again in the next weeks/months, especially on IDBCursor and IDBCursorWithValue.
{{UserLink("ScottMichaud")}}November 6, 2013 +

Doing what I can with the gaming documentation.

+
{{UserLink("Dbs")}}April 20, 2013Familiarizing myself with MDN tools, styles, and existing content
{{UserLink("tregagnon")}}June 25, 2013Fixing many broken links between French translations and English source articles. (Thanks to {{UserLink("SphinxKnight")}} crawl reports)
{{UserLink("justinpotts")}}December 9, 2013Adding tags to docs needing them
{{UserLink("kscarfone")}}July 25, 2013Knock out the editorial reviews on all the pending Web API documentation for Firefox OS
{{UserLink("Chandan1002")}}April 21,2014Contributing to docs and translating to Hindi from English source articles.
+

 

diff --git a/files/es/mdn/guidelines/content_blocks/index.html b/files/es/mdn/guidelines/content_blocks/index.html new file mode 100644 index 0000000000..dedccd3b10 --- /dev/null +++ b/files/es/mdn/guidelines/content_blocks/index.html @@ -0,0 +1,46 @@ +--- +title: Bloques de contenido +slug: MDN/Guidelines/Content_blocks +tags: + - MDN + - Meta +translation_of: MDN/Guidelines/CSS_style_guide +--- +
{{MDNSidebar}}
+

This pages lists reusable content blocks.

+
+

Grilla de tarjetas

+

Permite tener un par de tarjetas cercanas entre sí para llamar a contenidos específicos o para llamar a una acción. La clase CSS es: .card-grid (L 751 - 824 in CustomCSS).

+ +

Dos columnas

+

Dos columnas separadas con un borde gris. Normalmente usadas en páginas de destino. Clase de CSS: .topicpage-table (L 830 - 837 & 82-93 in CustomCSS).

+
+
+ Columna 1
+
+ Columna 2
+
+

 

+

Columnas con la misma altura

+

Se usa en la página de destino de Firefox OS para envolver las columnas que deberían tener el mismo alto. Clase de CSS: .equalColumnHeights (L 25 - 38 in CustomCSS).

+
+
+ Un Texo
+ y nueva linea
+  
+
+ Otro texto
+
+ aquí
+
+

 

diff --git a/files/es/mdn/guidelines/convenciones_y_definiciones/index.html b/files/es/mdn/guidelines/convenciones_y_definiciones/index.html new file mode 100644 index 0000000000..c96e4b7ab2 --- /dev/null +++ b/files/es/mdn/guidelines/convenciones_y_definiciones/index.html @@ -0,0 +1,201 @@ +--- +title: MDN convenciones y definiciones +slug: MDN/Guidelines/Convenciones_y_definiciones +tags: + - Directrices + - Documentación + - Guía + - MDN + - Meta MDN +translation_of: MDN/Guidelines/Conventions_definitions +--- +
{{MDNSidebar}}{{IncludeSubnav("/es/docs/MDN")}}
+ +

Este artículo define algunas convenciones y definiciones que se usan comúnmente en MDN, que pueden no ser obvias para algunas personas cuando las encuentran en la documentación.

+ +

Definiciones

+ +

Desaprobado y obsoleto

+ +

Desaprobado y obsoleto son términos comunes asociados con tecnologías y especificaciones, pero ¿qué significan?

+ +
+
Desaprobado
+
En MDN, el término desaprobado se usa para marcar una API o tecnología que ya no se recomienda, pero que aún está implementada y puede funcionar. Recientemente, la hemos actualizado a la definición utilizada en nuestro proyecto de datos de compatibilidad del navegador, que esa "característica ya no se recomienda. Es posible que se elimine en el futuro o que solo se conserve por motivos de compatibilidad. Evita el uso de esta funcionalidad."
+
Obsoleto
+
En MDN, el término obsoleto se utiliza para marcar una API o tecnología que no solo ya no se recomienda, sino que ya no se implementa en los navegadores. Sin embargo, esto fue confuso — es similar a desaprobado, y la distinción no es muy útil (aún no debes usarlo en un sitio de producción). Por lo tanto, ya no la usamos, y cualquier instancia con la que te encuentres se debe eliminar/reemplazar por desaprobada.
+
+ +

Experimental

+ +

Experimental puede significar diferentes cosas según el contexto en el que lo escuches o lo leas. Cuando una tecnología se describe como experimental en MDN, significa que la tecnología es incipiente e inmadura, y actualmente está en proceso de ser agregada a la plataforma web (o considerada para agregarla).

+ +

Uno o ambos de estos serán ciertos:

+ + + +

Si una o ambas de estas definiciones es cierta, entonces debes pensar detenidamente antes de comenzar a usar esa tecnología en cualquier tipo de proyecto de producción (es decir, no solo en una demostración o experimento). Consulta también la definición de experimental en nuestro proyecto de datos de compatibilidad del navegador.

+ +

Por el contrario, un elemento ya no es experimental cuando:

+ + + +

El or es importante aquí — por lo general, si una tecnología es compatible con varios navegadores importantes, la especificación será estable, pero no siempre es así. Y algunas tecnologías tendrán una especificación estable y se usarán bien, pero no tendrán soporte nativo en los navegadores (IMSC, por ejemplo).

+ +

Páginas archivadas

+ +

Las páginas archivadas son páginas que se almacenan en el Archivo de contenido obsoleto de MDN. Estas páginas contienen información lo suficientemente desactualizada como para que ya no sea directamente útil para nadie.

+ +

Por lo general, estas se refieren a proyectos de Mozilla que han sido descontinuados y ya no se debe confiar en ellos. Pero no las eliminamos simplemente porque forman un registro histórico útil, y algunos de los patrones o ideas contenidos en ellos podrían ser útiles para trabajos futuros. Un buen ejemplo es el proyecto B2G (Firefox OS).

+ +

¿Cuándo se debe archivar una página?

+ +

Una página se debe archivar si se ajusta a la descripción anterior. Para archivar una página, debes utilizar la "función Mover página" (Avanzado > Mover este artículo) para mover la página al árbol de páginas de archivo (/es/docs/Archive). Es posible que no tengas los permisos para usar esta función, y antes de comenzar a archivar páginas, primero debas discutirlo con la comunidad MDN; habla con nosotros en nuestro Foro de discusión.

+ +

Páginas eliminadas

+ +

Las páginas eliminadas son páginas que se eliminaron explícitamente de MDN — consulta, por ejemplo, la interfaz SharedKeyframeList y el constructor SharedKeyframeList(). Estas páginas contienen información que ya no es útil de ninguna manera y/o puede ser incorrecta hasta el punto en que mantenerla disponible puede ser confuso o malo para la gente.

+ +

Estas pueden ser:

+ + + +

¿Cuándo se debe eliminar una página?

+ +

Se debe eliminar una página si se ajusta a la descripción anterior. Para eliminar una página, debes utilizar la función "Eliminar esta página" (Avanzado> Eliminar esta página) para eliminar la página. Probablemente no tengas los permisos para usar esta función, y cuando pienses en eliminar páginas, primero debes discutirlo con la comunidad de MDN; habla con nosotros en nuestro Foro de discusión.

+ +

Cuando documentar nuevas tecnologías

+ +

En MDN, buscamos constantemente documentar nuevas tecnologías de estándares web según corresponda. Intentamos lograr un equilibrio entre publicar la documentación lo suficientemente temprano para que los desarrolladores puedan aprender sobre las nuevas funciones tan pronto como lo necesiten y publicarla lo suficientemente tarde para que la tecnología sea madura y estable para que los documentos no necesiten actualizaciones constantes o rápida eliminación.

+ +

En general, nuestra definición de lo más temprano que consideraremos para documentar una nueva tecnología es:

+ +

"Cuando la función está en una pista de estándares y se implementa en algún lugar."

+ +

Definitivamente deberías considerar documentar una nueva tecnología si:

+ + + +

Deberías tener más cuidado al documentar una nueva tecnología (pero deberías considerarla si tiene sentido) si:

+ + + +

No debes considerar documentar una nueva tecnología si:

+ + + +

Convenciones

+ +

Cuando se elimina algo de la especificación

+ +

A veces, durante el desarrollo de una nueva especificación, o en el transcurso de la evolución de los estándares como HTML, se agregan nuevos elementos, métodos, propiedades, etc. a la especificación, permanecen allí por un tiempo y luego se eliminan nuevamente. A veces, esto sucede muy rápido y, a veces, estos nuevos elementos permanecen en la especificación durante meses o incluso años antes de ser eliminados. Esto puede hacer que sea complicado decidir cómo manejar la eliminación del artículo de la especificación. Aquí hay algunas pautas que te ayudarán a decidir qué hacer.

+ +
+

Para los propósitos de esta discusión, la palabra "elemento" se usa para significar cualquier cosa que pueda ser parte de una especificación: un elemento o un atributo de un elemento, una interfaz o cualquier método individual, propiedad u otro miembro de una interfaz, etcétera.

+
+ + + +

Utiliza el sentido común con la redacción de los mensajes de advertencia y otros cambios en el texto sugeridos por las pautas anteriores. Los diferentes elementos requerirán una redacción y un manejo diferentes de la situación. En caso de duda, no dudes en pedir consejo en la sala del chat de Docs Web de MDN en Matrix, o en el foro de debate de Docs Web de MDN.

+ +

Copiar contenido dentro de MDN

+ +

A veces, necesitas reutilizar el mismo texto en varias páginas (o deseas usar el contenido de una página como plantilla para otra página). Tienes tres opciones:

+ + + +

Copiar contenido de otro lugar

+ +

A menudo, hay contenido útil sobre un tema en algún lugar de la web además de MDN. Sin embargo, copiar dicho contenido puede plantear dificultades, tanto legales como técnicas.

+ +

En el nivel técnico, los motores de búsqueda suelen penalizar a un sitio en su clasificación por reproducir contenido disponible en otros lugares. Por lo tanto, es preferible tener contenido original en MDN, para mejorar la clasificación del contenido de MDN en los motores de búsqueda. Puedes vincular al contenido existente de MDN.

+ +

A nivel legal, debes estar autorizado para contribuir con el contenido, y debes tener licencia y atribución de una manera que sea compatible con licencia de MDN.

+ + + +

Cómo comunicar un conflicto de especificaciones

+ +

Ten en cuenta que a veces (pero rara vez) hay un conflicto entre diferentes versiones de especificaciones (generalmente W3C versus WHATWG), p. ej. una versión puede tener una característica listada como obsoleta, mientras que la otra no. En tales casos, considera cuál es la realidad, es decir, qué están haciendo los navegadores, y escribe una nota "importante" para resumir ese último estado. Por ejemplo, a enero de 2019, el atributo global inputmode tiene un conflicto, que se resumió al igual que:

+ +
+

Conflicto de especificaciones: La lista de especificaciones de WHATWG inputmode, y los navegadores modernos están trabajando para admitirlo. Sin embargo, la especificación W3C HTML 5.2 ya no la incluye (es decir, la marca como desaprobada). Debes considerar que la definición del WHATWG es correcta, hasta que se logre un consenso.

+
diff --git a/files/es/mdn/guidelines/index.html b/files/es/mdn/guidelines/index.html new file mode 100644 index 0000000000..8105665f2f --- /dev/null +++ b/files/es/mdn/guidelines/index.html @@ -0,0 +1,10 @@ +--- +title: Guías de contenido y estilo de MDN +slug: MDN/Guidelines +tags: + - Estilo + - Guías +translation_of: MDN/Guidelines +--- +
{{MDNSidebar}}

Estas guías proveen detalles de cómo debería estar escrita y qué formato debería tener la documentación MDN, así como también cómo deberían ser presentados nuestros códigos de ejemplo y otro contenido. Siguiendo estas guías, puedes asegurarte de que el material que produces es limpio y fácil de usar.

+

{{LandingPageListSubpages}}

diff --git "a/files/es/mdn/guidelines/project_colon_gu\303\255a_de_estilo/index.html" "b/files/es/mdn/guidelines/project_colon_gu\303\255a_de_estilo/index.html" new file mode 100644 index 0000000000..40bffd16ca --- /dev/null +++ "b/files/es/mdn/guidelines/project_colon_gu\303\255a_de_estilo/index.html" @@ -0,0 +1,146 @@ +--- +title: Guía de estilo +slug: 'MDN/Guidelines/Project:Guía_de_estilo' +tags: + - Proyecto_MDC + - Todas_las_Categorías +translation_of: MDN/Guidelines/Writing_style_guide +--- +
{{MDNSidebar}}
+ +

Para mostrar la documentación de forma organizada, estandarizada y fácil de leer, la guía de estilos de MDN describe cómo debe organizarse, escribirse y formatearse el texto. Se trata de pautas más que de reglas estrictas. Interesa más el contenido que el formato, así que no te sientas obligado a aprenderte la guía de estilos antes de colaborar. No te enojes ni te sorprendas si después un voluntario edita tu trabajo para que quede de acuerdo con esta guía.

+ +

Los aspectos lingüísticos de esta guía se refieren principalmente a la documentación en idioma inglés.Se pueden (y se anima a) crear guías de estilo en otros idiomas. Estas deben publicarse como subpáginas de la página del equipo de localización.

+ +

Si buscas especificaciones de cómo debe estructurarse un determinado tipo de página, mira la guía de diseño de MDN.

+ +

Aquí se enumeran los usos y costumbres recomendados a la hora de editar los artículos de este wiki. Si ves que falta contenido o crees que deberíamos mejorar o corregir algo, por favor coméntalo en la página de discusión.

+ +

Uso de mayúsculas en el nombre de las páginas y los encabezados

+ + + +

Infinitivos y gerundios

+ + + +

Siglas y abreviaturas

+ +

Mayúsculas y espacios

+ + + +

Expansión

+ + + + + +

Plurales

+ + + +

Números

+ +

Fechas

+ + + +

Cantidades

+ + + +

Esta regla tiene una excepción: en un documento que trate del lenguaje 'X', las cantidades deben expresarse del modo definido por ese lenguaje.

+ +

Usted, tú y yo

+ +

El tuteo

+ +

Este es un problema complejo, puede que no exista la solución perfecta a gusto de todos. Pero sería interesante ponernos de acuerdo.

+ +

Por lo pronto, hemos decidido usar el tú y evitar regionalismos en nuestras traducciones. Te invitamos a comentar tus opiniones en nuestra lista de correo. 

+ +

La 1ª persona

+ +

Salvo rarísimas excepciones, nunca debe usarse.

+ + + +

Otras guías de estilo recomendadas

+ +

Si tienes dudas sobre usos y estilos que no sean tratados en este documento, te recomendamos consultar:

+ + + +

Los traductores también deberían consultar Writer's guide para conocer el estilo usado en la edición inglesa.

+ +

Diccionarios recomendados

+ +

Si tienes dudas sobre gramática y ortografía, puedes visitar:

+ + diff --git a/files/es/mdn/index.html b/files/es/mdn/index.html new file mode 100644 index 0000000000..c4c038e69c --- /dev/null +++ b/files/es/mdn/index.html @@ -0,0 +1,37 @@ +--- +title: El proyecto MDN +slug: MDN +tags: + - Comunidad + - Landing + - MDN Meta +translation_of: MDN +--- +
{{MDNSidebar}}
+ +

El proyecto de documentación de la web de MDN (MDN web docs) es un wiki en el que se documenta la web abierta (estándares web), las tecnologías de Mozilla y otros temas de desarrollo. Todos tienen permiso de añadir y editar contenido. No necesitas ser un programador o saber mucho de tecnología; hay muchas actividades que necesitan llevarse a cabo, tanto simples (por ejemplo: Corregir ortografía, puntuación, etc.) como complejas (documentar las API).

+ +
+

La misión de MDN web docs es darle a los desarrolladores la información que necesitan para realizar proyectos en la plataforma web fácilmente. ¡Te invitamos a ayudar!

+
+ +

¡Necesitamos de tu ayuda! Es fácil, no te preocupes por pedir permiso o por cometer errores. Además, visita y conoce a la comunidad MDN; ¡estamos aquí para ayudarte! Los artículos indicados a continuación te ayudarán a empezar.

+ + + +

Vea también

+ + diff --git a/files/es/mdn/kuma/contributing/getting_started/index.html b/files/es/mdn/kuma/contributing/getting_started/index.html new file mode 100644 index 0000000000..44bedc5bdb --- /dev/null +++ b/files/es/mdn/kuma/contributing/getting_started/index.html @@ -0,0 +1,15 @@ +--- +title: Primeros pasos +slug: MDN/Kuma/Contributing/Getting_started +translation_of: MDN/Kuma +--- +
{{MDNSidebar}}

Por favor, consulte los Documentos de Instalacion de Kuma en GitHub hasta que podamos redactar una mejor guía de "Primeros pasos".

+

Solución de problemas

+

A veces las cosas se ponen mal y la configuración de la prueba Kuma en el equipo deja de funcionar correctamente. Aquí ofrecemos algunas sugerencias sobre qué hacer para tratar de conseguir que funcione de nuevo.

+

Reprovision

+

La primera cosa a intentar es destruir y reconstruir su máquina virtual Kuma. Abra una terminal, pasar a la kuma directorio del proyecto y ejecute el siguiente comando:

+
vagrant destroy && vagrant provision
+

Si desea mantener la base de datos que ya tiene, asegúrese de hacer una copia de seguridad y restaurar después de reaprovisionamiento.

+

Vuelva a descargar la imagen de la VM

+

Si le preocupa que la imagen de VM es mala o no está actualizada, puede forzar el vagrant para descargar una nueva mediante el comando siguiente::

+
vagrant box remove kuma-ubuntu
diff --git a/files/es/mdn/kuma/contributing/index.html b/files/es/mdn/kuma/contributing/index.html new file mode 100644 index 0000000000..c920b5b5ab --- /dev/null +++ b/files/es/mdn/kuma/contributing/index.html @@ -0,0 +1,49 @@ +--- +title: Contribuir a Kuma +slug: MDN/Kuma/Contributing +translation_of: MDN/Kuma +--- +
{{MDNSidebar}}

Si desea contribuir al proyecto de Kuma para ayudarnos a construir una gran plataforma wiki y para hacer que el sitio de Mozilla Developer Network aun mejor, los documentos aquí deberían ayudarle a unirse en el esfuerzo.

+
+
+

Contribuir a Kuma

+
+
+ Cómo empezar con Kuma
+
+ Cómo bifurcar Kuma desde Github y configurar el entorno de desarrollo.
+
+ Se busca ayuda
+
+ Tenemos un montón de fallos registrados en Kuma. Este artículo se enumeran algunos, nos encantaría ver colaboradores que ayudan con.
+
+

Herramientas y tareas

+
+
+ Errores
+
+ Una lista de errores Kuma; siéntase libre de mirar a través de ellos y encontrar algo que te gustaría para arreglar. Este enlace le exige que inicie sesión en Bugzilla.
+
+ Notificar un error
+
+ Si usted ha tenido un problema con Kuma, o tiene alguna idea para una manera de hacerlo mejor; usted puede presentar un error
+
+ Cambio de registro
+
+ Una lista de reciente de modificaciones impulsadas; este es un gran lugar para buscar, para ver lo que ha pasado recientemente.
+
+

 

+
+
+

MDN comunidad de desarrolladores

+

 Si desea hablar con nuestros desarrolladores, o incluso mejor, para ayudar a construir y mejorar la plataforma de Kuma, !únase a nuestra comunidad de desarrolladores!

+
    +
  • Únase a la conversación en el IRC: #mdndev
    • +
  • Lea el foro de desarrolladores MDN: {{DiscussionList("dev-mdn", "mozilla.dev.mdn")}}
    • +
+

Don't forget about the netiquette...

+
+
+

Ver todos ...

+
+  
diff --git a/files/es/mdn/kuma/index.html b/files/es/mdn/kuma/index.html new file mode 100644 index 0000000000..b7b0de4fd9 --- /dev/null +++ b/files/es/mdn/kuma/index.html @@ -0,0 +1,55 @@ +--- +title: Kuma +slug: MDN/Kuma +translation_of: MDN/Kuma +--- +
{{MDNSidebar}}
+ +

Kuma es la plataforma wiki que impulsa Mozilla Developer Network. Es una plataforma open source escrita en Python usando el framework Django.

+ +
+
+

Documentación de Kuma

+ +
+
The Kuma API
+
Kuma provee una API simple que te permite acceder a la información sobre las páginas e incluso para poner nuevo contenido en las páginas.
+
Introducción a KumaScript:
+
...el lenguaje de plantillas de Kuma.
+
Usando KumaScript y las plantillas
+
Una guía de cómo usar las plantillas KumaScript en el contenido del artículo.
+
Referencia KumaScript
+
Una referencia a KumaScript.
+
Contribuyendo a Kuma
+
Una guía para forkear Kuma y contribuir al proyecto.
+
+ +

Artículos antiguos para clasificar:

+ + + +

Ver todos...

+
+ +
+

Herramientas y tareas

+ +
+
Bugs
+
Una lista de los bugs de Kuma. Sientase libre para buscar lo que quiera y lo que quieras arreglas! Este link requiere que entres en Bugzilla con su respectiva cuenta.
+
Reportar un bug
+
Si usted tiene un problema con Kuma, o tiene una idea para hacerlo mejor, ¡tú puedes reportar un bug!
+
Cambios
+
Una lista de los cambios recientes; este es un buen lugar para ver qué ha pasado recientemente.
+
¿Qué ha sido implementado?
+
Un tablero de estado de qué ha sido implementado al servidor de producción.
+
Kanban board
+
The Kanban board used for managing ongoing work on the Kuma project.
+
Server Monitoring
+
Some of our New Relic charts
+
+
+
diff --git a/files/es/mdn/structures/ejemplos_ejecutables/index.html b/files/es/mdn/structures/ejemplos_ejecutables/index.html new file mode 100644 index 0000000000..f5743b558e --- /dev/null +++ b/files/es/mdn/structures/ejemplos_ejecutables/index.html @@ -0,0 +1,243 @@ +--- +title: Ejemplos ejecutables +slug: MDN/Structures/Ejemplos_ejecutables +translation_of: MDN/Structures/Live_samples +--- +
{{MDNSidebar}}

MDN puede convertir ejemplos de código de los artículos a ejemplos ejecutables que el lector puede ver en acción. Estos ejemplos ejecutables pueden contener HTML, CSS, y JavaScript en cualquier combinación. Ten en cuenta que los ejemplos "ejecutables" no son interactivos; sin embargo, aseguran que el output coincida exactamente con el código de ejemplo, porque es generado por este.

+ +

Como funciona el sistema de ejemplos ejecutables

+ +

El sistema de ejemplos ejecutables agrupa el código, lo une en un archivo HTML, procesa el HTML y entonces despliega el output en un {{HTMLElement("iframe")}}. Por lo tanto un ejemplo ejecutable consiste de dos partes:

+ + + +

Un "grupo" de bloques de código, en este contexto, es identificado por el ID de un header o de un bloque de contenido (tal como un {{HTMLElement("div")}}).

+ + + +

La macro usa un URL especial para extraer el código de ejemplo: http://url-de-la-pagina$ejemplos/grupo-id, donde grupo-id es el ID del header o del bloque de contenido donde se localiza el código. El frame resultante (o página) es sandboxed (entorno de pruebas), seguro, y  técnicamente puede hacer cualquier cosa que funcione en la Web. Por supuesto, desde el punto de vista práctico, el código debe contribuir al tema de la página que lo contiene; cosas al azar ejecutándose en MDN serán removidas por la comunidad de editores.

+ +
+

Nota: Debes usar el macro para presentar el output del ejemplo ejecutable. El editor de MDN quitará cualquier uso directo del elemento <iframe> por motivos de seguridad.

+
+ +

Cada bloque {{HTMLElement("pre")}} que contiene código para el ejemplo tiene una clase que indica si es código HTML, CSS, o JavaScript; estas son "brush: html", "brush: css", y "brush: js". Las clases deben estar en los bloques de código correspondientes para que el wiki pueda usarlos correctamente; afortunadamente, son agregadas automáticamente cuando usas  la herramienta Syntax Highlighter de la barra de herramientas del editor.

+ +

El sistema de ejemplos ejecutables tiene muchas opciones disponibles, trataremos de ponerlas en terminos simples analizándolas de a poco.

+ +

Macro de ejemplos ejecutables

+ +

Hay dos macros que puedes usar para desplegar ejemplos ejecutables:

+ + + +

En muchos casos, tienes la posibilidad de agregar la macro EmbedLiveSample o la LiveSampleLink con ¡poco o nada de trabajo adicional! Mientras el ejemplo pueda ser identificado por un ID de un header o esté en un bloque de contenido con un ID que puedas usar, simplemente agregar la macro será suficiente.

+ +

Macro EmbedLiveSample

+ +
 \{{EmbedLiveSample(ID_del_bloque, longitud, altura, URL_de_captura_de_pantalla, pagina_slug)}}
+ +
+
ID_del_bloque
+
Requerido: El ID del header o del bloque de contenido de donde se tomará el código. La mejor forma de asegurarte que tienes el ID correcto es revisar el URL de la sección en la tabla de contenidos de la página.
+
longitud
+
La longitud del {{HTMLElement("iframe")}} que se creará, especificada en px. Esto es opcional; una longitud razonable se usará si omites esto. Ten en cuenta que si quieres usar una longitud específica, debes especificar el parámetro de altura también.
+
altura
+
La altura del {{HTMLElement("iframe")}} que se creará, especificada en px. Esto es opcional; una altura razonable se usará si omites esto. Ten en cuenta que si quieres usar una altura específica, debes especificar el parámetro de longitud también.
+
URL_de_captura_de_pantalla
+
La URL de una captura de pantalla que muestre como se debe ver el ejemplo ejecutable. Esto es opcional, pero puede ser útil para nuevas tecnologías que pueden no funcionar en el navegador del usuario, para que puedan ver como se vería el ejemplo si fuera soportado por su navegador. Si incluyes este parámetro, la captura de pantalla se muestra junto al ejemplo ejectutable, con encabezados apropiados.
+
pagina_slug
+
El slug (nombre con "_" reemplazando los espacios) de la página que contiene el ejemplo; esto es opcional, y si se omite, el ejemplo es extraido de la misma página donde se usa la macro.
+
+ +
    +
+ + + +
 \{{LiveSampleLink(ID_del_bloque, texto_del_enlace)}}
+ +
+
ID_del_bloque
+
Requerido: El ID del encabezado o del bloque de contenido de donde se tomará el código. La mejor forma de asegurarte que tienes el ID correcto es revisar el URL de la sección en la tabla de contenidos de la página.
+
texto_de_enlace
+
Una cadena de texto para mostrar en el enlace.
+
+ +

Usando el sistema de ejemplos ejecutables

+ +

La sección de abajo describe algunos de los casos de uso más comunes para el sistema de ejemplos ejecutables.

+ +

En todos estos casos, para ver los resultados del ejemplo ejecutable, debes hacer clic en Guardar Cambios en el editor (lo que te saca del modo edición). Debido a la reflexiba, naturaleza tipo Inception de los ejemplos ejecutables, la funcionalidad de Previsualizar Cambios no permite desplegar los ejemplos ejecutables.

+ +

Convirtiendo snippets (trozos de código) en ejemplos ejecutables

+ +

Un uso común es tomar snippets existentes que ya se muestran en MDN y convertirlos ejemplos ejecutables.

+ +

Preparar el código

+ +

El primer paso es agregar snippets o asegurarse que los existentes están listos para ser usados como ejemplos ejecutables, en términos de contenido y marcadores. Los snippets, juntos, deben comprender un ejemplo completo y ejecutable. Por ejemplo, si el snippet existente solo muestra CSS, debes agregar el snippet de HTML para que el CSS funcione.

+ +

Cada pieza de código debe estar en un bloque {{HTMLElement("pre")}}, con un bloque separado para cada lenguaje, propiamente marcado con el lenguaje correspondiente. La mayoría de las veces, esto ya se hizo, pero vale la pena volver revisar para asegurarse que cada pieza de código está estructurado con la sintaxis correcta. A la derecha del ícono PRE en la barra de tareas hay un menú desplegable (herramienta: Syntax Highlighter) con varios lenguajes para los que MDN hace distinción de sintaxis. Establecer el lenguaje para la distinción de sintaxis del bloque también lo correlaciona con un lenguaje para los propósitos del sistema de ejemplos ejecutables.

+ +
+

Nota: Puedes tener más de un bloque para cada lenguaje; todos son concatenados juntos. Esto te permite tener una parte de código, seguida de una explicación de como funciona, luego otra parte de código, etc. Esto hace aun más fácil producir tutoriales y utilizar ejemplo ejecutables intercalados con texto que los explique.

+
+ +

Así que asegurate que la distinción de sintaxis de los bloques {{HTMLElement("pre")}} para tu código HTML, CSS, y/o JavaScript estén cada uno configurado para el lenguaje correcto, y estarás bien.

+ +
+

Nota: Al pegar contenido en MDN, se conciente que si pegas contenido formateado (incluyendo, por ejemplo, distinción de sintaxis en código copeado de otro sitio) puedes estar trayendo formatos o clases que no quieres y no necesitas. Ten cuidado de no hacer esto; si es necesario, revisa tu edición en modo fuente y elimina estos formatos y clases innecesarios (o revísalo antes de pegarlo, o usa la opción "Pegar como texto plano").

+
+ +

Insertar la macro de ejemplo ejecutable

+ +

Una vez que el código está en su lugar y propiamente configurado para identificar cada bloque de lenguaje, necesitas insertar la macro que crea el frame.

+ +
    +
  1. Haz clic en el botón Insert Live Code Sample iFrame en la barra de herramientas; luce así: . Esto abre un cuadro de diálogo para configurar el frame de tu ejemplo ejecutable:                        
    2. +
  2. Bajo Document, ingresa el título del artículo que contiene el ejemplo que deseas desplegar. Por default, es el artículo que estás editando, pero puedes escoger un artículo en otra parte de MDN. Esto hace posible reusar ejemplos en múltiples páginas si es necesario. (Si escribes un texto nuevo en este campo, aparecerá un menú de coincidencias parciales; selecciona el título de la página que desees.)
    3. +
  3. En el menú Sections in Document, selecciona la sección en el artículo que contiene los bloques de código del ejemplo que quieres desplegar.
    4. +
  4. Haz clic en el botón OK para generar e insertar la macro que crea el frame del ejemplo. La macro luce algo así:
    + \{{ EmbedLiveSample('Live_sample_demo') }}
    5. +
+ +

Agregando un nuevo ejemplo ejecutable

+ +

Si estás escribiendo una página nueva, y quieres insertar código que deseas mostrar como ejemplo ejecutable, ¡aun más del trabajo puede ser realizado por el editor para ti!

+ +
    +
  1. Haz clic el botón Insert Code Sample Template en la barra de herramientas, luce así: . Esto presenta un simple cuadro de diálogo pidiéndote que nombres a tu ejemplo ejecutable:
    +
    2. +
  2. Ingresa el nombre del ejemplo; esto es usado como el header para el ejemplo. Asegúrate que tu título sea coherente con la pagína que escribes.
    3. +
  3. Haz clic en OK. Se creó un header nuevo con el título que elegiste, con sub-headers y bloques de código vacios para HTML, CSS y JavaScript.
    4. +
  4. Elimina cualquier sub-header y bloque de código que no necesites.
    5. +
  5. Ingresa el código que compone tu ejemplo en los bloques de código apropiados.
    6. +
  6. Revisar convenciones
    7. +
+ +

Usando el Buscador de Ejemplos

+ +

Como se mencionó arriba, el buscador de Ejemplos se activa haciendo clic en el ícono Insert Live Code Sample iFrame. Desafortunadamente el Buscador de Ejemplos puede producir un macro que NO es usable sin editarse antes. Hay dos áreas problemáticas que deben revisarse con cuidado y editarse si es necesario.

+ +
    +
  1. Campo Document. Este campo buscará mientras escribes y presentará una lista de documentos que encajan con tu búsqueda. Pero la lista presentada NO incluirá sub-páginas. Por ejemplo, digamos que estás trabajando en la sub-página Negative de la página principal @counter-style. El Buscador de Ejemplos no encontrará Negative pero si la página principal @counter-style. Cuando se selecciona @counter-style el fondo cambia a color verde. Lee debajo el problema que esto crea.
    2. +
  2. Sections in Document. El menú desplegable Sections in Document puede no mostrar la sección que necesitas. Selecciona cualquiera, digamos Examples, y puede arreglarse con una simple edición.
    3. +
+ +

Esto es lo que el Buscador de Ejemplos produce:

+ +
\{{ EmbedLiveSample('Examples', '', '', '', 'Web/CSS/@counter-style') }}
+ +

Esta macro no funcionará. El ID_de_bloque es Examples y debería ser Example en este caso (revisa la fuente del ID de esta sección para verificar cual ID_de_bloque necesitas usar). Igualmente pagina_slug es @counter-style y debería ser @counter-style/negative. Estas correcciones puede hacerse directamente en la página activando la edición.

+ +

Después de editar la macro ahora luce así:

+ +
\{{ EmbedLiveSample('Example', '', '', '', 'Web/CSS/@counter-style/negative') }}
+ +

Esta macro editada funcionará correctamente. Si la macro funciona correctamente verás el botón Open in CodePen. Una miniatura del ejemplo deberá aparecer encima del botón Open in CodePen. Si el botón está ahí pero no hay miniatura, espera unos minutos. Puede tormar un tiempo para que el servidor la genere.

+ +

Encontrando ejemplos que necesitan actualización

+ +

Al buscar ejemplos existentes que actualizar, hay tres tipos principales de actualización que deseas hacer:

+ + + +
+

Nota: Si encuentras artículos que necesitan ser actualizados para usar el sistema de ejemplos ejecutables, por favor agrega a la página la etiqueta "NeedsLiveSample".

+
+ +

Encontrando ejemplos que necesitan convertirse a ejemplos ejecutables

+ +

MDN tiene montontes de ejemplos viejos que aun no usan el sistema de ejemplos ejecutables. Nuestra meta es actualizar la mayoría o todos para que sean ejemplos ejecutables.Esto aumentará la consistencia y la usabilidad. Es casi seguro que te encontrarás muchos de estos mientras usas MDN en el día a día; sin embargo, ¿cómo puedes encontrarlos si los buscas específicamente para actualizarlos? Desafortunadamente, no hay un modo fácil de hacer eso. Pero hay algunos consejos que te ayudarán a rastrearlos:

+ + + +

Demo de ejemplo ejecutable

+ +

Esta sección es el resultado de usar la plantilla de ejemplo ejecutable no solo para crear el encabezado principal ("Live sample demo"), sino los sub-encabezador para nuestro contenido HTML, CSS y JavaScript. No estás limitado a un bloque para cada uno; además, no necesitan estar en algún orden partícular. ¡Mix and match!

+ +

Puedes eliminar cualquiera de estos que desees; si no necesitas scripts, elimina el encabezado y su bloque {{HTMLElement("pre")}}. También puedes eliminar el encabezado de un bloque de código ("HTML", "CSS", o "JavaScript"), ya que estos no son usados por la macro de ejemplo ejecutable.

+ +

Ahora que se ha insertado la plantilla, podemos agregar algo de código, e incluso algún texto explicativo.

+ +

HTML

+ +

Este HTML crea un parágrafo y algunos bloques para ayudarnos a posicionar y formatear un mensaje.

+ +
<p>Un simple ejemplo de sistema de ejemplo ejecutable en accion.</p>
+<div class="box">
+  <div id="item">¡Hola mundo!</div>
+</div>
+
+ +

CSS

+ +

El código CSS formatea el contenedor así como el mensaje.

+ +
.box {
+  width: 200px;
+  height: 100 px;
+  border-radius: 6px;
+  background-color: #ffaabb;
+}
+
+#item {
+  width: 100%;
+  font-weight: bold;
+  text-align: center;
+  font-size: 2em;
+}
+
+ +

JavaScript

+ +

Este código es muy simple. Todo lo que hace es agregar un manejador de evento al texto "¡Hola mundo!" que hace aparecer una alerta cuando se le hace clic.

+ +
var el = document.getElementById('item');
+el.onclick = function() {
+  alert('¡Owww, deja de picarme!');
+}
+
+ +

Resultado

+ +

Aquí el resultado de ejecutar los bloques de código de arriba vía \{{EmbedLiveSample('Live_sample_demo')}}:

+ +

{{EmbedLiveSample('Live_sample_demo')}}

+ +

Aquí un enlace que resulta de llamar los bloques de código vía \{{LiveSampleLink('Live_sample_demo', 'Live sample demo link')}}:

+ +

{{LiveSampleLink('Live_sample_demo', 'Live sample demo link')}}

+ +

Convenciones acerca de los ejemplos ejecutables

+ +
+

Nota: Esto es actual (Feb. 2016) en discusión en la lista de emails dev-mdc (ver this thread). Cualquier entrada es bienvenida. Si esta nota persiste después de unos meses (Apr. 2016), por favor contactar al autor del primer email en este hilo para actualizar esta página.

+
+ +
+
Orden de los bloques de código
+
Al agregar un ejemplo ejecutable, los bloques de código deben ser organizados para que el primero corresponda al lenguaje principal (si hay uno). Por ejemplo, al agregar un ejemplo ejecutable para una referencia HTML, el primer bloque debe ser HTML, al agregar un ejemplo ejecutable para una referencia CSS, debe ser el de CSS y así.
+
Nombrando los encabezados
+
Cuando no hay ambigüedad (p.ej. el ejemplo está bajo una sección "Ejemplos"), los encabezados deben ser directos con el único nombre del lenguaje correspondiente: HTML, CSS, JavaScript, SVG, etc. (ver arriba). No deben usarse encabezados como "contenido HTML" o "contenido JavaScript". Sin embargo si un encabezado tan corto hace que el contenido no sea claro, uno puede usar un título más elaborado.
+
Usando un bloque "Result"
+
Después de los diferentes bloques de código, favor de usar un último bloque "Result" antes de usar macro EmbedLiveSample (ver arriba). De este modo, se hace más clara la semántica del ejemplo tanto para el lector como para cualquier herramienta que analice la página (p.ej. screen reader, web crawler).
+
diff --git a/files/es/mdn/structures/index.html b/files/es/mdn/structures/index.html new file mode 100644 index 0000000000..b8df701dac --- /dev/null +++ b/files/es/mdn/structures/index.html @@ -0,0 +1,16 @@ +--- +title: Document structures +slug: MDN/Structures +tags: + - Landing + - MDN Meta + - NeedsTranslation + - Structures + - TopicStub +translation_of: MDN/Structures +--- +
{{MDNSidebar}}
{{IncludeSubnav("/en-US/docs/MDN")}}
+ +

Throughout MDN, there are various document structures that are used repeatedly, to provide consistent presentation of information in MDN articles. Here are articles describing these structures, so that, as an MDN author, you can recognize, apply, and modify them as appropriate for documents you write, edit, or translate.

+ +

{{LandingPageListSubPages()}}

diff --git a/files/es/mdn/structures/macros/commonly-used_macros/index.html b/files/es/mdn/structures/macros/commonly-used_macros/index.html new file mode 100644 index 0000000000..18ebaff2af --- /dev/null +++ b/files/es/mdn/structures/macros/commonly-used_macros/index.html @@ -0,0 +1,210 @@ +--- +title: Macros usadas comunmente +slug: MDN/Structures/Macros/Commonly-used_macros +tags: + - CSS + - Estructuras + - Macros + - Referencia +translation_of: MDN/Structures/Macros/Commonly-used_macros +--- +

{{MDNSidebar}}

+ +

Esta página enumera muchas de las macros de propósito general creadas para usarlas en MDN. Para obtener información sobre cómo usar estas macros, consulta {{web.link("/es/docs/MDN/Contribute/Structures/Macros", "Uso de macros")}} y {{web.link("/es/docs/MDN/Contribute/Editor/Links#Usar_macros_de_enlaces", "Usar macros de enlaces")}}. Consulta {{web.link("/es/docs/MDN/Contribute/Structures/Macros/Other", "Otras macros")}} para obtener información sobre las macros que se utilizan con poca frecuencia, que se utilizan solo en contextos especiales o, están en desuso. También hay una {{web.link("/es/dashboards/macros", "lista completa de todas las macros en MDN")}}.

+ +

Consulta también la {{web.link("/es/docs/MDN/Contribute/Guidelines/CSS_style_guide", "guía de estilo CSS")}} para conocer los estilos disponibles para usarlos.

+ +

Enlaces

+ +

Creando un solo hipervínculo

+ +

En general, no es necesario utilizar macros para crear enlaces arbitrarios. Utiliza el botón Enlace en la interfaz del editor para crear enlaces.

+ + + +

Enlace a páginas en referencias

+ +

Hay varias macros para vincular páginas en áreas de referencia específicas de MDN.

+ + + +

Enlazar a errores

+ + + +

Ayuda a la navegación para guías multipágina

+ +

{{TemplateLink("Previous")}}, {{TemplateLink("Next")}} y {{TemplateLink("PreviousNext")}} proporcionan controles de navegación para artículos que forman parte de secuencias. Para las plantillas unidireccionales, el único parámetro necesario es la ubicación wiki del artículo anterior o siguiente de la secuencia. Para {{TemplateLink("PreviousNext")}}, los dos parámetros necesarios son las ubicaciones wiki de los artículos correspondientes. El primer parámetro es para el artículo anterior y el segundo es para el artículo siguiente.

+ +

Ejemplos de código

+ +

Ejemplos en vivo

+ + + +

Generar la barra lateral

+ +

Hay plantillas para casi todas las grandes colecciones de páginas. Por lo general, enlazan a la página principal de reference/guide/tutorial (esto, a menudo es necesario porque nuestras rutas de navegación a veces no lo pueden hacer) y colocan el artículo en la categoría apropiada.

+ + + +

Formato de propósito general

+ +

Indicadores en línea para documentación de APIs

+ +

{{TemplateLink("optional_inline")}} y {{TemplateLink("ReadOnlyInline")}} se utilizan en la documentación de la API, normalmente cuando se describe la lista de propiedades de un objeto o parámetros de una función.

+ +

Uso: \{{Optional_Inline}} o \{{ReadOnlyInline}}. Ejemplo:

+ +
+
isCustomObject{{ReadOnlyInline}}
+
Indica, si es true, que el objeto es personalizado.
+
parameterX{{Optional_Inline}}
+
Blah blah blah...
+
+ +

Indicadores de estado y compatibilidad

+ +

Indicadores en línea sin parámetros adicionales

+ +

Non-standard

+ +

{{TemplateLink("Non-standard_Inline")}} inserta una marca en línea que indica que la API no se ha estandarizado y no está en un seguimiento de estándares.

+ +
Sintaxis
+ +

\{{Non-standard_Inline}}

+ +
Ejemplos
+ + + +

Experimental

+ +

{{TemplateLink("experimental_inline")}} inserta una marca en línea que indica que la API no está ampliamente implementada y puede cambiar en el futuro.

+ +
Sintaxis
+ +

\{{Experimental_Inline}}

+ +
Ejemplos
+ + + +

Indicadores en línea que apoyan la especificación de la tecnología

+ +

En estas macros, el parámetro (cuando se especifica) debe ser una de las cadenas "html", "js", "css" o "gecko", seguida del número de versión.

+ +

Desaprobado

+ +

{{TemplateLink("Deprecated_Inline")}} inserta una marca desaprobado en línea (Deprecated_Inline) para desalentar el uso de una API que oficialmente está en desuso. Nota: "Desaprobado" significa que el elemento ya no se debe utilizar, pero sigue funcionando. Si quieres decir que ya no funciona, utiliza el término "obsoleto".

+ +

No utilices el parámetro en ningún área independiente del navegador (HTML, API, JS, CSS, …).

+ +
Sintaxis
+ +

\{{Deprecated_Inline}} o \{{Deprecated_Inline("gecko5")}}

+ +
Ejemplos
+ + + +

Obsoleto

+ +

{{TemplateLink("Obsolete_Inline")}} inserta una marca de obsoleto en línea (Deprecated_Inline) para evitar el uso de, por ejemplo, una función, método o propiedad que oficialmente es obsoleto.

+ +

No utilices el parámetro en ningún área independiente del navegador (HTML, API, JS, CSS, …).

+ +
Sintaxis
+ +

\{{Obsolete_Inline}} u \{{Obsolete_Inline("js1.8.5")}}

+ +
Ejemplos
+ + + +

Plantilla de insignias

+ +

Estas macros se utilizan principalmente en la página {{web.link("/es/docs/Web/API", "WebAPI")}}. Consulta {{anch("Creación de nuevas insignias")}} para obtener información sobre cómo crear una nueva insignia (Badge).

+ +

Indicadores de encabezado de página o sección

+ +

Estas plantillas tienen la misma semántica que sus contrapartes en línea descritas anteriormente. Las plantillas se deben colocar directamente debajo del título de la página principal (o la ruta de navegación si está disponible) en la página de referencia. También se pueden utilizar para marcar una sección en una página.

+ + + +

Indica que una función está disponible en workers web

+ +

La macro {{TemplateLink("AvailableInWorkers")}} inserta un cuadro de nota localizado que indica que una función está disponible en el contexto de {{web.link("/es/docs/Web/API/Web_Workers_API", "workers web")}}.

+ +

{{AvailableInWorkers}}

diff --git a/files/es/mdn/structures/macros/index.html b/files/es/mdn/structures/macros/index.html new file mode 100644 index 0000000000..807059cfd9 --- /dev/null +++ b/files/es/mdn/structures/macros/index.html @@ -0,0 +1,53 @@ +--- +title: Macros +slug: MDN/Structures/Macros +tags: + - Estructuras + - Guide + - Guía + - Kuma + - KumaScript + - MDN Meta + - Structures + - TopicStub +translation_of: MDN/Structures/Macros +--- +
{{MDNSidebar}}
+ +

La plataforma {{web.link("/es/docs/Project:MDN/Kuma#Herramientas_y_tareas", "Kuma")}} en la que se ejecuta MDN proporciona un potente sistema de macros, {{web.link("/es/docs/MDN/Contribute/Tools/KumaScript", "KumaScript")}}, estas te permiten hacer una amplia variedad de cosas de forma automática. Este artículo proporciona información sobre cómo invocar macros de MDN dentro de los artículos.

+ + + +

La {{web.link("/es/docs/MDN/Contribute/Tools/KumaScript", "guía de KumaScript")}} profundiza en cómo usar macros en MDN, por lo que esta sección es más una breve descripción general.

+ +

Cómo se implementan las macros

+ +

Las macros en MDN se implementan usando código {{web.link("/es/docs/Web/JavaScript", "JavaScript")}} ejecutado por el servidor, interpretado usando Node.js. Además de eso, tenemos una serie de bibliotecas que hemos implementado que brindan servicios y funciones orientados a wiki para permitir que las macros interactúen con la plataforma wiki y su contenido. Si estás interesado en obtener más información, consulta {{web.link("/es/docs/MDN/Contribute/Tools/KumaScript", "Guía de KumaScript")}}.

+ +

Usar una macro en el contenido

+ +

Para usar realmente una macro, simplemente encierra la llamada a la macro entre un par de llaves dobles, con sus parámetros, si los hay, entre paréntesis; es decir:

+ +
\{{nombremacro(lista-de-parametros)}}
+ +

Algunas notas sobre las llamadas de macro:

+ + + +

Las macros están almacenadas en caché; para cualquier conjunto de valores de entrada (tanto parámetros como valores del entorno, tal como la URL para la que se ejecutó la macro), los resultados se almacenan y reutilizan. Esto significa que la macro solo se ejecuta realmente cuando cambian las entradas.

+ +
+

Nota: Puedes forzar la reevaluación de todas las macros de una página si fuerzas la actualización de la página en tu navegador (es decir, una recarga).

+
+ +

Las macros pueden ser tan simples como insertar un bloque de texto más grande o intercambiar contenido de otra parte de MDN, o tan complejas como crear un índice completo de contenido buscando en partes del sitio, estilizando el resultado y agregando enlaces.

+ +

Puedes leer sobre las macros más utilizadas en {{web.link("/es/docs/MDN/Contribute/Structures/Macros/Commonly-used_macros", "Página de macros usadas comúnmente")}}; también, hay una {{web.link("/es/docs/templates", "lista completa de todas las macros")}}. La mayoría de las macros tienen documentación incorporada, como comentarios en la parte superior.

+ +

{{EditorGuideQuickLinks}}

diff --git a/files/es/mdn/structures/macros/otras/index.html b/files/es/mdn/structures/macros/otras/index.html new file mode 100644 index 0000000000..532bc07fdc --- /dev/null +++ b/files/es/mdn/structures/macros/otras/index.html @@ -0,0 +1,181 @@ +--- +title: Otras macros +slug: MDN/Structures/Macros/Otras +tags: + - Macros + - Referencia +translation_of: MDN/Structures/Macros/Other +--- +
{{MDNSidebar}}
+ +

A diferencia de las macros enumeradas en {{web.link("/es/docs/MDN/Contribute/Structures/Macros/Commonly-used_macros", "Macros usadas comúnmente")}}, las macros documentadas en este artículo se usan con poca frecuencia o solo en contextos específicos, o están en desuso.

+ +

Contextos especiales

+ +

Estas macros se utilizan solo con contextos particulares, como una referencia de API específica.

+ + + +

Componentes de la página destino

+ +

Tenemos una variedad de macros que se pueden utilizar para generar automáticamente el contenido de las páginas destino. Aquí están.

+ +

Listas de subpáginas

+ + + +

Enlaces rápidos

+ +

Tenemos algunas macros diseñadas específicamente para crear {{web.link("/es/docs/MDN/Contribute/Style_guide/Quicklinks", "enlaces rápidos")}}:

+ + + +

Usadas con poca frecuencia

+ + + +

Transclusión

+ +

La transclusión es la incorporación de parte o la totalidad de una página en otra. Ten cuidado al utilizar esta macro, para asegurarte de que el contenido transcluido tenga sentido en el contexto de la página en la que está incorporado.

+ +

{{TemplateLink("page")}} te permite incrustar parte o la totalidad de una página específica en un documento. Acepta cinco parámetros:

+ +
    +
  1. La URI de la página que se va a transcluir. Por ejemplo, "/es/docs/Project:MDN/About".
    2. +
  2. El nombre de la sección dentro de la página que se va a incluir. Esto se puede especificar como la cadena de título o como el ID de un bloque a copiar. Si no se especifica, se transcluye todo el artículo. {{optional_inline}}
    3. +
  3. El número de revisión de la versión de la página que se va a incluir. Esta función no está implementada actualmente, pero permitiría incluir texto de versiones específicas de un artículo. {{unimplemented_inline}}
    4. +
  4. Un valor booleano que indica si se muestra o no el encabezado de la sección de nivel superior que se está transcluyendo. Esto es útil si deseas especificar tu propio título. El valor predeterminado es falso, lo cual significa que el encabezado no se incluye de forma predeterminada. {{optional_inline}}
    5. +
  5. El nivel de título que se utilizará como nivel de título superior. Esto ajusta el primer nivel descubierto más externo del contenido transcluido al número especificado, y todos los demás encabezados correspondientemente. Esto te permite incluir contenido que tiene sus propios títulos, pero ajustarlos para que coincidan con el nivel de título en el que los estás incluyendo. Si no especificas este valor, los títulos no se ajustan. {{unimplemented_inline}}
    6. +
+ +

Ejemplo sin título

+ +

\{{Page("/es/docs/MDN/About", "Acerca de Mozilla")}}

+ +

Resultado:

+ +

{{Page("/es/docs/MDN/About", "Acerca de Mozilla")}}

+ +

Ejemplo con encabezado

+ +

\{{Page("/es/docs/MDN/About", "Acerca de Mozilla", 0, 1)}}

+ +

Resultado:

+ +

{{Page("/es/docs/MDN/About", "Acerca de Mozilla", 0, 1)}}

+ +

Creando nuevas insignias

+ +

También tenemos insignias que no tienen iconos con burbujas. La plantilla genérica para esto es {{TemplateLink("SimpleBadge")}}, que acepta tres parámetros:

+ +
    +
  1. Texto para mostrar en la insignia.
    2. +
  2. Nombre de una clase CSS que se utilizará como fondo de la insignia.
    3. +
  3. (Opcional) Texto para mostrar en una información sobre herramientas al pasar el cursor sobre la insignia.
    4. +
+ +

Desaprobado

+ +

Estas macros han sido reemplazadas por otras formas de hacer lo mismo y ya no se deberían usar. Si los encuentras en artículos existentes, reemplázalos.

+ +

Enlaces

+ + + +

Ejemplos de código

+ +

Las siguientes macros se usaron antes de la implementación del {{web.link("/es/docs/MDN/Contribute/Structures/Live_samples", "sistema de ejemplo en vivo")}} integrado en Kuma, y se deben reemplazar por usos de {{TemplateLink("EmbedLiveSample")}} o {{TemplateLink("LiveSampleLink")}}.

+ + + +

Organizacional

+ + + +

Formateo

+ + + +

Indicadores de versión

+ +

Las siguientes macros están en desuso porque esta información debería estar contenida en el artículo de la tabla de compatibilidad de navegadores.

+ + diff --git a/files/es/mdn/structures/tablas_de_compatibilidad/index.html b/files/es/mdn/structures/tablas_de_compatibilidad/index.html new file mode 100644 index 0000000000..cd9a5097d2 --- /dev/null +++ b/files/es/mdn/structures/tablas_de_compatibilidad/index.html @@ -0,0 +1,476 @@ +--- +title: >- + Tablas de compatibilidad y repositorio de datos de compatibilidad del + navegador (DCN) +slug: MDN/Structures/Tablas_de_compatibilidad +tags: + - Estructuras + - Guía + - Meta MDN + - compatibilidad con el navegador + - tablas de compatibilidad +translation_of: MDN/Structures/Compatibility_tables +--- +
{{MDNSidebar}}
+ +

MDN tiene un formato estándar para tablas de compatibilidad para nuestra documentación web abierta; es decir, documentación de tecnologías como DOM, HTML, CSS, JavaScript, SVG, etc., que se comparte en todos los navegadores. Este artículo es una guía de "introducción" sobre cómo agregar y mantener la base de datos a partir de la cual se generan las tablas de compatibilidad, además de cómo integrar las tablas en artículos.

+ +

Para obtener documentación más avanzada, así como los últimos cambios en los procesos y los esquemas JSON utilizados para representar los datos, échale un vistazo al repositorio de datos de la guía para colaboradores, así como a la guía de directrices de datos.

+ +

Si tienes preguntas o descubres problemas, compártelos con nosotros en el foro de discusión de MDN.

+ +

Cómo acceder al repositorio de datos

+ +

Los datos se almacenan en un repositorio de GitHub; consulta https://github.com/mdn/browser-compat-data. Para acceder a él, necesitas tener una cuenta de GitHub, bifurcar el repositorio de compatibilidad de datos del navegador en tu propia cuenta y luego clonar tu bifurcación en tu máquina local.

+ +

Preparándose para agregar los datos

+ +

Antes de agregar algunos datos nuevos, te debes asegurar de que tu bifurcación esté actualizada con el repositorio principal (contiene el mismo contenido), crea una nueva rama dentro de tu bifurcación para contener tus adiciones, luego ingresa esa rama en tu clon local para que puedas empezar a trabajar dentro de ella:

+ +

Veamos la siguiente sencilla forma de asegurarte de que tu bifurcación esté actualizada:

+ +

Agregar el repositorio principal de datos de compatibilidad del navegador como remoto

+ +

Ve al clon local de tu bifurcación en tu terminal/línea de comandos, y agrega un control remoto que apunte al repositorio principal (upstream) de esa manera (solo necesitas hacer esto una vez):

+ +
git remote add upstream https://github.com/mdn/browser-compat-data.git
+ +

Si no estás seguro de haber hecho esto, puedes verificar qué controles remotos tiene tu repositorio usando

+ +
git remote -v
+ +

Actualiza tu bifurcación con el contenido del remoto

+ +

Ahora, siempre que desees actualizar tu bifurcación, lo puedes hacer mediante:

+ +
    +
  1. +

    Asegúrate de que estas en la rama master:

    + + 
    git checkout master
    +
    2. +
  2. +

    obtén el contenido actualizado del repositorio utilizando lo siguiente:

    + + 
    git fetch upstream
    +
    3. +
  3. +

    rebasa el contenido de tu master con el contenido del repositorio principal:

    + + 
    git rebase upstream/master
    +
    4. +
  4. +

    empuja estas actualizaciones a tu bifurcación remota usando lo siguiente:

    + + 
    git push
    +
    5. +
+ +

Crea una nueva rama para hacer tu trabajo

+ +

A continuación, ve a tu bifurcación remota (estará en https://github.com/tu-nombre-de-usuario/browser-compat-data) y crea una nueva rama para almacenar tus cambios para esta adición de datos. Esto lo puedes hacer mediante:

+ +
    +
  1. Un clic en el botón "Rama: Master".
    2. +
  2. Ingresa un nuevo nombre para la rama en el campo de texto "Buscar o crear una rama...".
    3. +
  3. Presiona el botón resultante "Crear rama nombre-de-rama desde Master".
    4. +
+ +

Por ejemplo, si quisieras agregar datos para la API WebVR, crearías una rama llamada algo así como "webvr".

+ +

Cambia a la nueva rama

+ +

En este punto, regresa a tu terminal/línea de comando y actualiza el clon local de tu bifurcación para incluir tu nueva rama usando el siguiente comando:

+ +
git pull
+ +

Ahora cambia a tu nueva rama usando esto:

+ +
git checkout nombre-de-rama
+ +

¡Ahora debería estar listo para comenzar a agregar tus datos!

+ +

Añadir los datos

+ +

Para agregar los datos, debes crear un nuevo archivo o archivos para almacenar tus datos de compatibilidad. Los archivos que necesitas crear difieren, según la tecnología en la que estés trabajando:

+ + + +

Cada archivo que crees debe seguir el patrón definido en el esquema contenido en nuestro repositorio; puedes ver la descripción detallada del esquema aquí.

+ +

Estructura básica de datos de compatibilidad

+ +

Veamos un ejemplo. Los archivos JSON de propiedades CSS, por ejemplo, necesitan la siguiente estructura básica:

+ +
{
+  "css": {
+    "properties": {
+      "border-width": {
+        "__compat": {
+          ...
+        }
+      }
+    }
+  }
+}
+ +

Tienes el objeto css, dentro del cual hay un objeto properties. Dentro del objeto properties, necesitas un miembro para cada una de las características específicas para las que deseas definir los datos de compatibilidad. Cada uno de estos miembros tiene un miembro __compat, dentro del cual van los datos reales.

+ +

Los datos anteriores se encuentran en el archivo: border-width.json compáralo con la tabla de soporte de border-width representada en MDN.

+ +

Otros tipos de características funcionan de la misma manera, pero con diferentes nombres de objeto:

+ + + +
+

En páginas HTML, CSS y JS, normalmente solo necesitarás una función. Las interfaces de API funcionan de forma ligeramente diferente — siempre tienen varias subcaracterísticas (consulta {{anch("Sub-features", "Subcaracterísticas")}}, a continuación).

+ +

Estructura básica dentro de una característica

+ +

Dentro de un miembro de función __compat, debes incluir los siguientes miembros:

+ + + +

Los nombres de los miembros del navegador se definen en el esquema (consulta identificadores del navegador). Debes utilizar la lista completa de identificadores definidos actualmente. Si deseas agregar otro navegador, habla con nosotros primero, ya que esto podría tener un impacto de gran alcance y no se debe hacer sin pensarlo detenidamente.

+ +

En un archivo de datos de compatibilidad del navegador básico, solo necesitarás incluir "version_added" dentro de los miembros del identificador del navegador (cubriremos {{anch("Advanced cases", "Casos avanzados")}} más adelante). Los diferentes valores que posiblemente quieras incluir son los siguientes:

+ + + +

Dentro del miembro status, incluirás tres submiembros:

+ + + +

Los datos de características de border-width (consulta también border-width.json) se muestra a continuación como ejemplo:

+ +
"__compat": {
+  "mdn_url": "https://developer.mozilla.org/docs/Web/CSS/border-width",
+  "support": {
+    "chrome": {
+      "version_added": "1"
+    },
+    "webview_android": {
+      "version_added": "2"
+    },
+    "edge": {
+      "version_added": true
+    },
+    "edge_mobile": {
+      "version_added": true
+    },
+    "firefox": {
+      "version_added": "1"
+    },
+    "firefox_android": {
+      "version_added": "1"
+    },
+    "ie": {
+      "version_added": "4"
+    },
+    "ie_mobile": {
+      "version_added": "6"
+    },
+    "opera": {
+      "version_added": "3.5"
+    },
+    "opera_android": {
+      "version_added": "11"
+    },
+    "safari": {
+      "version_added": "1"
+    },
+    "safari_ios": {
+      "version_added": "3"
+    }
+  },
+  "status": {
+    "experimental": false,
+    "standard_track": true,
+    "deprecated": false
+  }
+}
+ +

Agrega una descripción

+ +

Hay un cuarto miembro, opcional, que puede ir dentro del miembro __compat — description. Este se puede utilizar para incluir una descripción legible por humanos de la característica. Únicamente lo debes incluir si es difícil ver cuál es la característica al mirar los datos. Por ejemplo, puede que no sea tan obvio lo que es un constructor al mirar la estructura de datos, por lo que puedes incluir una descripción como esta:

+ +
{
+  "api": {
+    "AbortController": {
+      "__compat": {
+        ...
+      },
+      "AbortController": {
+        "__compat": {
+          "mdn_url": "https://developer.mozilla.org/docs/Web/API/AbortController/AbortController",
+          "description": "<code>AbortController()</code> constructor",
+          "support": {
+            ...
+          }
+        }
+      }
+
+      ... etc.
+    }
+  }
+}
+ +

Subcaracterísticas

+ +

En una página donde la tabla de compatibilidad tiene más de una fila, necesitarás varias subcaracterísticas dentro de cada característica para definir la información de cada fila. Esto puede suceder, por ejemplo, cuando tienes el soporte básico para una característica almacenada en una fila, pero luego la característica también tiene una nueva propiedad o tipo de valor que se agregó mucho más tarde en la vida de la especificación y solo se admite en una par de navegadores.

+ +

Como ejemplo, consulta los datos de compatibilidad y la página MDN correspondiente para la propiedad background-color. El soporte básico existe dentro del objeto __compat como se explicó anteriormente, luego tienes una fila adicional para el soporte de los navegadores para "canal alfa para valores hexadecimales", que contiene tu propio objeto __compat.

+ +
{
+  "css": {
+    "properties": {
+      "background-color": {
+        "__compat": {
+          ...
+        },
+        "alpha_ch_for_hex": {
+          "__compat": {
+            ...
+          },
+        }
+      }
+    }
+  }
+}
+ +

Para una API, tienes los dos niveles superiores definidos como api.nombre-de-la-interfaz, luego un __compat de nivel superior para definir la compatibilidad general del navegador de la interfaz, luego una subfunción para cada uno de los métodos, propiedades y constructores contenidos dentro de la interfaz. La estructura básica se ve así:

+ +
{
+  "api": {
+    "VRDisplay": {
+      "__compat": {
+        ...
+      },
+      "cancelAnimationFrame": {
+        "__compat": {
+          ...
+        }
+      },
+      "capabilities": {
+        "__compat": {
+          ...
+        }
+      },
+
+      ... etc.
+
+    }
+  }
+}
+ +

Consulta VRDisplay.json para ver un ejemplo completo.

+
+ +

Agregar datos: casos avanzados

+ +

Hay algunas características avanzadas que querrás incluir en los datos de compatibilidad del navegador. El objetivo de esta sección es enumerar los más comunes, proporcionando un ejemplo de cada uno para mostrar cómo los puedes implementar en tus propios datos de compatibilidad.

+ +

Incluyendo una nota a pie de página

+ +

A menudo, las tablas de compatibilidad incluirán notas a pie de página relacionadas con ciertas entradas que explican detalles útiles o comportamientos extraños que los desarrolladores encontrarán útiles. Como ejemplo, la entrada de Chrome para Android para {{domxref("VRDisplay.capabilities")}} (consulta también VRDisplay.json) (en el momento de escribir este artículo) tenía una nota al pie de página "Actualmente solo es compatible con Google Daydream". Para incluir esto en los datos de capacidades, agregamos un submiembro "notes" dentro del submiembro "chrome_android" relevante; se vería así:

+ +
"chrome_android": {
+  "version_added": true,
+  "notes": "Currently supported only by Google Daydream."
+}
+ +

Incluyendo un prefijo de proveedor

+ +

Si una característica es compatible con un prefijo de proveedor en uno o más navegadores, querrás dejarlo en claro en los datos de compatibilidad del navegador. imagina que tienes una característica que es compatible con un prefijo -moz- en Firefox. Para especificar esto en los datos de compatibilidad, debes agregar un submiembro "prefix" dentro del submiembro "firefox" relevante. Y se vería así:

+ +
"firefox": {
+  "version_added": true,
+  "prefix": "-moz-"
+}
+ +

Incluyendo preferencias o banderas del navegador

+ +

Algunas características pueden ser compatibles con un navegador, pero son experimentales y están desactivadas de forma predeterminada. Si un usuario quiere jugar con esta característica, debe activarla usando una preferencia/bandera.

+ +

Para representar esto en los datos de compatibilidad, debes agregar el submiembro "flags" dentro del submiembro del identificador del navegador relevante. El valor de "flags" es un arreglo de objetos, cada uno de los cuales contiene tres miembros:

+ + + +

Entonces, para agregar una preferencia/bandera al soporte de Chrome para una característica, harías algo como esto:

+ +
"chrome": {
+  "version_added": "50",
+  "flags": [
+    {
+      "type": "preference",
+      "name": "Enable Experimental Web Platform Features",
+      "value_to_set": "true"
+    }
+  ]
+},
+ +

Si una característica está detrás de dos o más banderas, puedes agregar objetos adicionales al arreglo "flags", como en este caso, por ejemplo:

+ +
"firefox": {
+  "version_added": "57",
+  "flags": [
+    {
+      "type": "preference",
+      "name": "dom.streams.enabled",
+      "value_to_set": "true"
+    },
+    {
+      "type": "preference",
+      "name": "javascript.options.streams",
+      "value_to_set": "true"
+    }
+  ]
+},
+ +

Incluyendo una versión donde se eliminó el soporte

+ +

A veces, una característica se agregará en una determinada versión del navegador, pero luego se eliminará nuevamente cuando la característica esté obsoleta. Esto se puede representar fácilmente usando el submiembro "version_removed", que toma como valor una cadena que representa el número de versión en el que se eliminó. Por ejemplo:

+ +
"firefox": {
+  "version_added": "35",
+  "version_removed": "47",
+},
+ +

Incluyendo múltiples puntos de soporte para la misma entrada del navegador

+ +

A veces, querrás agregar varios puntos de datos de soporte para el mismo navegador dentro de la misma característica.

+ +

Como ejemplo, la propiedad {{cssxref("text-align-last")}} (ve también text-align-last.json) se agregó a Chrome en la versión 35, compatible con una pref.

+ +

El soporte mencionado anteriormente se eliminó en la versión 47; también en la versión 47, se agregó soporte para text-align-last habilitado de manera predeterminada.

+ +

Para incluir estos dos puntos de datos, puedes hacer que el valor del submiembro "chrome" sea un arreglo que contenga dos objetos de información de soporte, en lugar de un solo objeto de información de soporte:

+ +
"chrome": [
+  {
+    "version_added": "47"
+  },
+  {
+    "version_added": "35",
+    "version_removed": "47",
+    "flags": [
+      {
+        "type": "preference",
+        "name": "Enable Experimental Web Platform Features",
+        "value_to_set": "true"
+      }
+    ]
+  }
+],
+ +
+

Nota Debes colocar el punto de soporte más actual o importante primero en el arreglo — esto hace que los datos sean más fáciles de leer para las personas que solo desean escanearlos para obtener la información más reciente.

+
+ +

Incluyendo un nombre alternativo

+ +

Ocasionalmente, los navegadores admitirán una característica con un nombre diferente al definido en su especificación. Esto se podría deber, por ejemplo, a que un navegador agregó soporte experimental para una característica antes, y luego el nombre cambió antes de que se estabilizara la especificación.

+ +

Para incluir un caso de este tipo en los datos de compatibilidad del navegador, puedes incluir un punto de información de soporte que especifique el nombre alternativo dentro de un miembro "alternative_name".

+ +
+

Nota Es posible que el nombre alternativo no sea un alias exacto — posiblemente tenga un comportamiento diferente al de la versión estándar.

+
+ +

Veamos un ejemplo. La propiedad {{cssxref("border-top-right-radius")}} (consulta también border-top-right-radius.json) era compatible con Firefox:

+ + + +

Para representar esto en los datos, usamos el siguiente JSON:

+ +
"firefox": [
+  {
+    "version_added": "4",
+    "notes": "Antes de Firefox 50.0, los estilos de borde de las esquinas redondeadas siempre se representaban como si border-style fuera sólido. Esto se ha solucionado en Firefox 50.0."
+  },
+  {
+    "prefix": "-webkit-",
+    "version_added": "49",
+    "notes": "De Firefox 44 a 48, el prefijo -webkit- estaba disponible con la preferencia layout.css.prefixes.webkit. A partir de Firefox 49, la preferencia predeterminada es <code>true</code>."
+  },
+  {
+    "alternative_name": "-moz-border-radius-topright",
+    "version_added": "1",
+    "version_removed": "12"
+  }
+],
+ +

Empujar un cambio de nuevo al repositorio principal

+ +

Una vez que hayas terminado de agregar tus datos de compatibilidad, primero debes probarlos usando los siguientes comandos:

+ + + +

Si se ve bien, debes confirmarlo y volver a colocarlo en tu bifurcación remota en GitHub. Lo puedes hacer fácilmente en tu terminal con comandos como estos:

+ +
git add .
+git commit -m 'adding compat data for nombre-de-la-característica'
+git push
+ +

Ahora ve a tu bifurcación remota (es decir, https://github.com/tu-nombre-de-usuario/browser-compat-data) y deberías ver información sobre tu inserción en la parte superior de la lista de archivos (debajo de "Tus ramas enviadas recientemente"). Puedes crear una solicitud de extracción (iniciando el proceso de enviarla al repositorio principal) presionando el botón "Comparar y solicitud de extracción" y luego siguiendo las sencillas instrucciones en la siguiente pantalla.

+ +

En este punto, solo tienes que esperar. Un revisor examinará tu solicitud de extracción y la fusionará con el repositorio principal, O solicitará que realices cambios. Si se necesitan cambios, realiza los cambios y envíalos nuevamente hasta que se acepte la SE.

+ +

Insertar los datos en páginas MDN

+ +

Una vez que tus nuevos datos se hayan incluido en el repositorio principal, puedes comenzar a generar dinámicamente tablas de compatibilidad del navegador basadas en esos datos en las páginas MDN usando la macro {{TemplateLink("Compat")}}. Esta toma un solo parámetro, la notación de puntos requerida para recorrer los datos JSON y encontrar el objeto que representa la característica para la que deseas generar la tabla de compatibilidad.

+ +

Por encima de la llamada a la macro, para ayudar a otros colaboradores a encontrar su camino, debes agregar un texto oculto que solo sea visible a los colaboradores de MDN en el modo de edición:

+ +
<div class="hidden">
+La tabla de compatibilidad de esta página se genera a partir de datos estructurados.
+Si deseas contribuir con los datos, consulta
+<a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>
+y envíanos una solicitud de extracción.
+</div>
+ +

Por ejemplo, en la página de encabezado HTTP {{HTTPHeader("Accept-Charset")}}, la llamada a la macro se ve así: \{{Compat("http.headers.Accept-Charset")}}. Si observas el accept-charset.json en el repositorio, verás cómo esto se refleja en los datos JSON.

+ +

Otro ejemplo, la tabla de compatibilidad para la propiedad {{domxref("VRDisplay.capabilities")}} se genera usando \{{Compat("api.VRDisplay.capabilities")}}. La llamada a la macro genera la siguiente tabla (y el correspondiente conjunto de notas):

+ +
+ + +

{{Compat("api.VRDisplay.capabilities")}}

+ +
+

Nota Los nombres de archivo a menudo coinciden con las etiquetas dadas a las interfaces dentro de las estructuras JSON, pero no siempre es así. Cuando las llamadas a macro generan las tablas, recorren todos los archivos hasta encontrar el JSON relevante para usar, por lo que los nombres de archivo no son críticos. Dicho esto, siempre debes nombrarlos de la manera más intuitiva posible.

+
diff --git a/files/es/mdn/tools/index.html b/files/es/mdn/tools/index.html new file mode 100644 index 0000000000..eff61261b7 --- /dev/null +++ b/files/es/mdn/tools/index.html @@ -0,0 +1,45 @@ +--- +title: Herramientas de MDN y Utilidades +slug: MDN/Tools +tags: + - Documentacion(2) + - Documentación + - MDN + - Proyecto MDC +translation_of: MDN/Tools +--- +
{{MDNSidebar}}

MDN ofrece un número de características que hacen fácil seguir el progreso, gestionar el contenido y mantenerte al tanto de los últimos cambios al sitio.

+
+
+

Documentación sobre las herramientas de MDN

+
+
+ Panel de Revisiones
+
+ El Panel de Revisión te permite opinar sobre los artículos recientemente cambiados en MDN; el panel también ofrece un número de herramientas de filtrado útlies que te dejan personalizar la pantalla para satisfacer tus necesidades como revisor de contenido.
+
+ Panel de Localización
+
+ El Panel de Localización permite a los equipos de localización coordinar, gestionar su proyecto de localización, y traducir documentación eficientemente. Su función principal es la de ayudar a los equipos de localización a averiguar qué contenido necesita traducirse y qué artículos necesitan atención lo más pronto posible. Esta característica no está terminada aún, pero puedes seguir el desarrollo en {{bug(834317)}}.
+
+ Fuentes RSS
+
+ MDN proporciona un número de fuentes RSS que puedes seguir para estar al día de los cambios hechos en la página, ver listas de artículos que necesitan revisión y así sucesivamente.
+
+ La API Kuma
+
+ Kuma, la plataforma wiki que fortalece MDN, ofrece una API fácil de usar que te permite automatizar tareas de recopilación de información sobre artículos para publicar otros nuevos en la wiki. Aprende más sobre esta API en este artículo.
+
+

Ver todo...

+
+
+

Herramientas MDN

+

Estos son enlaces directos a herramientas útiles MDN.

+ +
+
+

 

diff --git a/files/es/mdn/tools/introduction_to_kumascript/index.html b/files/es/mdn/tools/introduction_to_kumascript/index.html new file mode 100644 index 0000000000..ed060eecd8 --- /dev/null +++ b/files/es/mdn/tools/introduction_to_kumascript/index.html @@ -0,0 +1,683 @@ +--- +title: Introducción a KumaScript +slug: MDN/Tools/Introduction_to_KumaScript +translation_of: MDN/Tools/KumaScript +--- +
{{MDNSidebar}}
+ +
{{draft}}
+ +

Vistazo general

+ +

En el verano de 2012, MDN  cambió a una nueva plataforma wiki llamada Kuma. Esta reemplaza el lenguaje de plantilla DekiScript con un nuevo sistema llamado KumaScript. KumaScript se alimenta de JavaScript del lado del servidor, usando Node.js. Este artículo provee informaciónde cómo usar KumaScript y cómo actualizar scripts migrados parcialmente desde MindTouch.

+ +

Para detalles y preguntas frecuentes sobre KumaScript, mira el KumaScript Fireside Chat del equipo de desarrolladores MDN.

+ +

¿Qué es KumaScript?

+ + + +

¿Qué no es KumaScript?

+ + + +

Aspectos básicos

+ +

KumaScript funciona permitiendo a wiki de confianza escribir plantillas JavaScript ensambladas. Estas plantillas pueden ser invocadas en el contenido del documento por cualquier editor wiki mediante el uso de macros.

+ + + + + + + + + + + + + + +
+

Una plantilla se vé así:

+ 		+

Una macro se vé así:

+ 		+

El resultado de una macro sale así:

+
+ 
+<% for (var i = 0; i < $0; i++) { %>
+Hello #<%= i %>
+<% } %>
+ 		+ 
+\{{ hello("3") }}
+
+ 		+ 
+Hello #0
+Hello #1
+Hello #2
+
+ +

Sintaxis de una macro

+ +

Las plantillas KumaScript se invocan en el contenido del documento con macros, como esta:

+ +
\{{ templateName("arg0", "arg1", ..., "argN") }}
+
+ +

La sintaxis de una Macro se compone de estas reglas:

+ + + +

Usando JSON parámetro de macro

+ +

Hay una característica semi-experimental disponible para las macros. Puedes proveerlas de un objeto JSON como primero y único parámetro, así:

+ +
\{{ templateName({ "Alpha":"one", "Beta":["a","b","c"], "Foo":"http:\/\/mozilla.org\/" }) }}
+
+ +

Los datos de esta macro estarán disponibles en un código de plantilla como un objeto en el argumento $0 (por ejemplo, $0.Alpha, $0.Beta, $0.Foo). Esto también te permite expresar estructuras de datos complejos en los parámetros de macro que son difíciles o imposibles de hacer con una simple lista de parámetros.

+ +

Nota que el estilo de este parámetro es muy complejo. Se debe adherir exactamente a la sintaxis JSON, que tiene algunas exigencias escurridizas que son fáciles de pasar por alto (por ejemplo, todas las barras (/) llevan escapes). Cuando haya dudas, intenta ejecutar tu JSON con un validador.

+ +

Cómo escribir "\{{"

+ +

Como la secuencia de caracteres "\{{" se usa para indicar el comienzo de una macro, puede ser un problema si justo quieres usar "\{{" and "}}" como texto de una página. Probablemente dará un mensaje de error DocumentParsingError.

+ +

En este caso, puedes escapar la primer llave con una barra invertida, así: \\{

+ +

Sintaxis de la plantilla

+ +

Las plantillas KumaScript son procesadas por un motor de plantillas JavaScript ensamblado con estas simples reglas:

+ + + +

Características avanzadas

+ +

Más allá de los aspectos básicos, el sistema KumaScript ofrece algunas características avanzadas.

+ +

Variables de entorno

+ +

Cuando la wiki hace una llamada al servicio KumaScript, pasa por una part del contexto del documento actual que KumaScript pone a disposición de las plantillas como variables:

+ +
+
env.path
+
La ruta del documento wiki actual
+
env.url
+
La URL completa del documento wiki actual
+
env.id
+
Un ID único corto para el documento wiki actual
+
env.files
+
Un arreglo de archivos adjuntos para el documento wiki actual. Cada objeto en el arreglo se describe como {{ anch("File objects") }} debajo
+
env.review_tags
+
Un arreglo con las etiquetas de revisión del artículo ("technical", "editorial", etc.)
+
env.locale
+
El sitio del documento wiki actual
+
env.title
+
El título del documento wiki actual
+
env.slug
+
Una URL amigable del documento wiki actual
+
env.tags
+
Una lista de nombers de etiquetas para el documento wiki actual
+
env.modified
+
El último timestamp modificado para el documento wiki actual
+
env.cache_control
+
El encabezado Cache-Control henviado en la solicitud para el documento wiki actual, útil para decidir si invalidar los caches
+
+ +

Objetos de archivos

+ +

Cada objeto de archivo tiene los siguientes campos:

+ +
+
title
+
El título del archivo adjunto
+
description
+
Una descripción textual de la revisión actual del archivo
+
filename
+
El nombre del archivo
+
size
+
El tamaños del archivo en bytes
+
author
+
El nombre de usuario de la persona que subió el archivo
+
mime
+
El tipo MIME del archivo
+
url
+
La URL en la que se puede encontrar el archivo
+
+ +

Trabajando con listas

+ +

Las variables env.tags y env.review_tags devuelven colecciones de etiqutas. Puedes trabajar con estas de varias maneras, por supuesto, pero aquí se dan un par de sugerencias.

+ +
Buscar si se colocó una etiqueta específica
+ +

Se puede buscar si una etiqueta específica existe en una página, así:

+ +
if (env.tags.indexOf("tag") != −1) {
+  // The page has the tag "tag"
+}
+
+ +
Iterar (recorrer) todas las etiquetas de la página
+ +

Se pueden recorrer todas las etiquetas de la página, así:

+ +
env.tag.forEach(function(tag) {
+  // haz cualquier cosa que necesites, tal como:
+  if (tag.indexOf("a") == 0) {
+    // esta etiqueta empieza con "a" - woohoo!
+  }
+});
+ +

APIs y Módulos

+ +

KumaScript ofrece algunas APIs de utilidad incorporadas, como también la capacidad para definir nuevas APIs en módulos editables como documentos wiki.

+ +

Métodos incorporados

+ +

Es probable que esta documentación mantenida manualmente quede desactualizada con respecto al código. Teniendo en cuanta eso, siempre puedes verificar el último estado de las APIs incorporadas en la fuente de KumaScript. Pero hay una selección de métodos útiles expuestos a plantillas:

+ +
+
md5(string)
+
Devuelve un resumen de hexadecimal MD5 de determinada cadena.
+
template("name", ["arg0", "arg1", ..., "argN"])
+
Ejecuta y devuelve el resultado de las plantillas mencionadas con la lista de parámetros provistos.
+
Utilizado en plantillas así: <%- template("warning", ["foo", "bar", "baz"]) %>.
+
Esta es una función JavaScript. Así que, si uno de los parámetroses una variable arg como $2, no lo pongas entre comillas. Así: <%- template("warning", [$1, $2, "baz"]) %>. Si necesitas llamar otra plantilla desde el interior de un bloque e código, no uses <% ... %>. Ejemplo: myvar = "<li>" + template("LXRSearch", ["ident", "i", $1]) + "</li>";
+
require(name)
+
Carga otra plantilla como un módulo. Cualquier resultadu es ignorado. Devuelce cualquier cosa asignada a module.exports en la plantilla.
+
Utilizado en plantillas así: <% var my_module = require('MyModule'); %>.
+
cacheFn(key, timeout, function_to_cache)
+
Usando la key y duración de entrada de caché proporcionadas, cachea los resultados de la función proporcionada. Prioriza el valor de env.cache_control para invalidar el cache en no-cache, que puede ser enviado por un usuario logueado  que tipee shift-refresh.
+
request
+
Acceso al mikeal/request, una librería para hacer consultas HTTP. Usar este módulo en las plantillas KumaScriptno es muy amigable, así que quizá desees envolver uso en APIs de módulo que simplifiquen las cosas.
+
+ +

Módulos de API incorporados

+ +

Sólo hay una API incorporada por el momento, en el espacio de nombres kuma:

+ +
+
kuma.htmlEscape(string)
+
Escapa los caracteres &, <, >, " a &amp, &lt;, &gt;, &quot;, respectivamente.
+
 
+
kuma.include(path)
+
Incluye contenido de la página en la ruta proporcionada. Cacheo pesado.
+
+ +
+
kuma.pageExists(path)
+
Indica si existe la página en la ruta proporcionada. Cacheo pesado.
+
+ +

Creando módulos

+ +

Usando el mátodo incorporado require(), puedes cargar una plantilla como módulo para compartir variables y métodos comunes entre plantillas. Un módulo puede definirse como una plantilla de la siguiente manera:

+ +
<%
+module.exports = {
+    add: function (a, b) {
+        return a + b;
+    }
+}
+%>
+
+ +

Asumiendo que esta plantilla está guardada como /en-US/docs/Template:MathLib, puedes utilizarla en otra plantilla, así:

+ +
<%
+var math_lib = require("MathLib");
+%>
+El resultado de 2 + 2 = <%= math_lib.add(2, 2) %>
+
+ +

Y, el resultado de esta plantilla será:

+ +
el resultado de 2 + 2 = 4
+
+ +

Módulos cargados automáticamente

+ +

Hay un grupo de módulos editables como plantillas wiki que se cargan automáticamente y quedan disponibles para cada plantilla. Este grupo está definido en el archivo de configuración para el servicio KumaScript. Cualquier cambio a este requiere un bug IT para editar la configuración y el reinicio del servicio.

+ +

Para la mayor parte, estos intentos de proveer sustitutos para stand-ins for legacy DekiScript features to ease template migration. But, going forward, these can be used to share common variables and methods between templates:

+ + + +

The best way to see the current state and offerings of these modules is to take a look at their source directly.

+ +

Note: You might notice that the DekiScript modules use a built-in method named buildAPI(), like so:

+ +
<% module.exports = buildAPI({
+    StartsWith: function (str, sub_str) {
+        return (''+str).indexOf(sub_str) === 0;
+    }
+}); %>
+
+ +

The reason for this is because DekiScript is case-insensitive when it comes to references to API methods, whereas JavaScript is strict about uppercase and lowercase in references. So, buildAPI() is a hack to try to cover common case variations in DekiScript calls found in legacy templates.

+ +

With that in mind, please do not use buildAPI() in new modules.

+ +

Tips and caveats

+ +

Debugging

+ +

A useful tip when debugging. You can use the log.debug() method to output text to the scripting messages area at the top of the page that's running your template. Note that you need to be really sure to remove these when you're done debugging, as they're visible to all users! To use it, just do something like this:

+ +
<%- log.debug("Some text goes here"); %>
+
+ +

You can, of course, create more complex output using script code if it's helpful.

+ +

Limitations of content migration from MindTouch

+ +

When we make the move to Kuma, we will migrate content from the old MindTouch-based wiki to the new Kuma-based one. This script will do some basic work to attempt to convert scripts. But, there are many common code patterns that migration can't fix.

+ +

So, this means that we'll need human intervention to carry template scripts over the rest of the way to being functional.

+ +

To find templates in need of review and repair, check here: /en...eview/template.

+ +

To find examples of templates that have already been repaired, check here: /en...s/tag/ks-fixed.

+ +

Check the template usage stats bug file attachments to help prioritize templates to fix. If you know your way around gzip and grep, this attachment (a 1.5MB tab-delimited file listing template/document pairs) can help tell you what templates are used on which pages.

+ +

As you repair templates, please uncheck the "Template" review checkbox and add the tag "ks-fixed", which will keep the above lists accurate.

+ +

You can also find templates in need of repair by simply browsing through wiki content and spotting where content looks garbled with code or otherwise incorrect. Editing the page should show you the name of a macro that's in need of help. You may also see scripting errors on pages, which should offer editing links to the templates causing issues.

+ +

Keyword Shortcut for quick template editing

+ +

If you spend time editing a lot of KumaScript templates (e.g., to fix partly-migrated legacy DekiScript templates), you may find this keyword shortcut bookmark handy:

+ + + + + + + + + + + + + + + + +
Nameedit mdn template
Location/en...mplate:%s$edit
Keywordte
+ +

Armed with this bookmarklet, you can copy the name of a template, open a new tab, and type "te [Ctrl-V][Return]" to start editing the template. This helps when a template is misbehaving, yet not badly enough to cause a scripting error message.

+ +

Changing Locale Identifiers

+ +

The identifiers for various locales have changed from MindTouch to Kuma:

+ + + +

This list should not change in the future, assuming we've not missed any. These locale identifier changes become significant in legacy DekiWIki templates.

+ +

URL pattern changes

+ +

The URL pattern for all wiki documents has changed:

+ + + +

So, for example:

+ + + +

To avoid breaking links, there is an attempt to automatically redirect requests to the legacy-style URLs to new-style URLs. But, efforts should be made to change links to the new-style URLs whenever possible.

+ +

Differences from DekiScript

+ +

It's useful to note a few changes from templates in DekiScript, in case you encounter these in migrated content:

+ + + +

Caching

+ +

KumaScript templates are heavily cached to improve performance. For the most part, this works great to serve up content that doesn't change very often. But, as a logged in user, you have two options to force a page to be regenerated, in case you notice issues with scripting:

+ + + +

Cookbook

+ +

This section will list examples of common patterns for templates used on MDN, including samples of legacy DekiScript templates and their new KumaScript equivalents.

+ +

Force templates used on a page to be reloaded

+ +

It bears repeating: To force templates used on a page to be reloaded after editing, hit Shift-Reload. Just using Reload by itself will cause the page contents to be regenerated, but using cached templates and included content. A Shift-Reload is necessary to invalidate caches beyond just the content of the page itself.

+ +

Recovering from "Unknown Error"

+ +

Sometimes, you'll see a scripting message like this when you load a page:

+ +
Kumascript service failed unexpectedly: <class 'httplib.BadStatusLine'>
+ +

This is probably a temporary failure of the KumaScript service. If you Refresh the page, the error may disappear. If that doesn't work, try a Shift-Refresh. If, after a few tries, the error persists - file an IT bug for Mozilla Developer Network to ask for an investigation.

+ +

Broken wiki.languages() macros

+ +

On some pages, you'll see a scripting error like this:

+ +
Syntax error at line 436, column 461: Expected valid JSON object as the parameter of the preceding macro but...
+
+ +

If you edit the page, you'll probably see a macro like this at the bottom of the page:

+ +
\{{ wiki.languages({ "zh-tw": "zh_tw/Core_JavaScript_1.5_教學/JavaScript_概要", ... }) }}
+
+ +

To fix the problem, just delete the macro. Or, replace the curly braces on either side with HTML comments <!-- --> to preserve the information, like so:

+ +
<!-- wiki.languages({ "zh-tw": "zh_tw/Core_JavaScript_1.5_教學/JavaScript_概要", ... }) -->
+
+ +

Because Kuma supports localization differently, these macros aren't actually needed any more. But, they've been left intact in case we need to revisit the relationships between localized pages. Unfortunately, it seems like migration has failed to convert some of them properly.

+ +

Unconverted inline script blocks

+ +

Occasionally, you'll find some text like this at the bottom of a page, or even somewhere in the middle:

+ +
ottoPreviousNext("JSGChapters");
+wiki.languages({
+  "fr": "fr/Guide_JavaScript_1.5/Expressions_rationnelles",
+  "ja": "ja/Core_JavaScript_1.5_Guide/Regular_Expressions"
+});
+
+ +

This is a script block that didn't get converted to a KumaScript macro during migration. It happens, unfortunately. If you switch to HTML source editing mode, you'll see this, a <pre class="script"> element:

+ +
<pre class="script" style="font-size: 16px;">
+ottoPreviousNext(&quot;JSGChapters&quot;);
+wiki.languages({
+  &quot;fr&quot;: &quot;fr/Guide_JavaScript_1.5/Expressions_rationnelles&quot;,
+ &nbsp;&quot;ja&quot;: &quot;ja/Core_JavaScript_1.5_Guide/Regular_Expressions&quot;
+});
+</pre>
+
+ +

This is an inline script - previously allowed by DekiScript, no longer supported by KumaScript.

+ +

For this particular example, common to the JavaScript Guide, you can fix it by removing the wiki.languages part (see previous section) and change the ottoPreviousNext() into a macro like so:

+ +
\{{ ottoPreviousNext("JSGChapters") }}
+
+ +

If you see a block of code that's more complex than the above, you will need to create a new template, move the code there, and replace the code in its previous spot with a macro calling the new template.

+ +

Finding the Current Page's Language

+ +

In KumaScript, the locale of the current document is exposed as an environment variable:

+ +
var lang = env.locale;
+
+ +

In legacy DekiScript templates, coming up with the locale was a bit harder. You'll see chunks of code like this:

+ +
/* accepts as input one required parameter: MathML element to create an xref to */
+var u = uri.parts(Page.uri);
+var lang = string.tolower(u.path[0]);
+if (string.contains(lang, "project") || string.contains(lang, "Project")) {
+  lang = string.substr(lang, 8);
+}
+/* fall back to page.language on a user page */
+else if (string.StartsWith(lang, "user:")) {
+  lang = page.language;
+}
+
+ +

Please replace code like the above with the new KumaScript example. The env.locale variable should be reliable and defined for every document.

+ +

Reading the contents of a page attachment

+ +

You can read the contents of an attached file by using the mdn.getFileContent() function, like this:

+ +
<%
+  var contents = mdn.getFileContent(fileUrl);
+  ... do stuff with the contents ...
+%>
+
+ +

or

+ +
<%-mdn.getFileContent(fileObject)%>
+
+ +

In other words, you may specify either the URL of the file to read or as a file object. The file objects for a page can be accessed through the array env.files. So, for example, to embed the contents of the first file attached to the article, you can do this:

+ +
<%-mdn.getFileContent(env.files[0])%>
+
+ +
Note: You probably don't want to try to embed the contents of a non-text file this way, as the raw contents would be injected as text. This is meant to let you access the contents of text attachments.
+ +

If the file isn't found, an empty string is returned. There is currently no way to tell the difference between an empty file and a nonexistent one. But if you're putting empty files on the wiki, you're doing it wrong.

+ +

Localizing template content

+ +

Templates cannot be translated like other wiki pages. KumaScript only looks for templates in the en-US locale (i.e., /en-US/docs/Template:{name}), and does not look for templates that have been translated to another locale (i.e., /fr/docs/Template:{name}).

+ +

So the main way to output content tailored to the current document locale is to pivot on the value of env.locale. There are many ways to do this, but a few patterns are common in the conversion of legacy DekiScript templates:

+ +

If/else blocks in KumaScript

+ +

The KumaScript equivalent of this can be achieved with simple if/else blocks, like so:

+ +
<% if ("fr" == env.locale) { %>
+<%- template("CSSRef") %> « <a title="Référence_CSS/Extensions_Mozilla" href="/fr/docs/Référence_CSS/Extensions_Mozilla">Référence CSS:Extensions Mozilla</a>
+<% } else if ("ja" == env.locale) { %>
+<%- template("CSSRef") %> « <a title="CSS_Reference/Mozilla_Extensions" href="/ja/docs/CSS_Reference/Mozilla_Extensions">CSS リファレンス:Mozilla 拡張仕様</a>
+<% } else if ("pl" == env.locale) { %>
+<%- template("CSSRef") %> « <a title="Dokumentacja_CSS/Rozszerzenia_Mozilli" href="/pl/docs/Dokumentacja_CSS/Rozszerzenia_Mozilli">Dokumentacja CSS:Rozszerzenia Mozilli</a>
+<% } else if ("de" == env.locale) { %>
+<%- template("CSSRef") %> « <a title="CSS_Referenz/Mozilla_CSS_Erweiterungen" href="/de/docs/CSS_Referenz/Mozilla_CSS_Erweiterungen">CSS Referenz: Mozilla Erweiterungen</a>
+<% } else { %>
+<%- template("CSSRef") %> « <a title="CSS_Reference/Mozilla_Extensions" href="/en-US/docs/CSS_Reference/Mozilla_Extensions">CSS Reference:Mozilla Extensions</a>
+<% } %>
+
+ +
Legacy DekiScript
+ +

A similar way this was done in DekiScript was using <span>'s with lang="{locale}" attributes, like so:

+ +
<p><span lang="*" class="lang lang-*"><span class="script">CSSRef()</span> « <a title="en/CSS_Reference/Mozilla_Extensions" href="/en/CSS_Reference/Mozilla_Extensions">CSS Reference:Mozilla Extensions</a></span>
+<span lang="en" class="lang lang-en"><span class="script">CSSRef()</span> « <a title="en/CSS_Reference/Mozilla_Extensions" href="/en/CSS_Reference/Mozilla_Extensions">CSS Reference:Mozilla Extensions</a>
+<span lang="fr" class="lang lang-fr"><span class="script">CSSRef()</span> « <a title="fr/Référence_CSS/Extensions_Mozilla" href="/fr/Référence_CSS/Extensions_Mozilla">Référence CSS:Extensions Mozilla</a></span>
+<span lang="ja" class="lang lang-ja"><span class="script">CSSRef()</span> « <a title="ja/CSS_Reference/Mozilla_Extensions" href="/ja/CSS_Reference/Mozilla_Extensions">CSS リファレンス:Mozilla 拡張仕様</a></span>
+<span lang="pl" class="lang lang-pl"> <span class="script">CSSRef()</span> « <a title="pl/Dokumentacja_CSS/Rozszerzenia_Mozilli" href="/pl/Dokumentacja_CSS/Rozszerzenia_Mozilli">Dokumentacja CSS:Rozszerzenia Mozilli</a></span>
+<span lang="de" class="lang lang-de"><span class="script">CSSRef()</span> « <a title="de/CSS_Referenz/Mozilla_CSS_Erweiterungen" href="/de/CSS_Referenz/Mozilla_CSS_Erweiterungen">CSS Referenz: Mozilla Erweiterungen</a></span></span></p>
+
+ +

This is no longer supported. If you encounter templates built using the legacy DekiScript approach, revise them to use the new KumaScript pattern.

+ +

Depending on what text editor is your favorite, you may be able to copy & paste from the browser-based editor and attack this pattern with a series of search/replace regexes to get you most of the way there.

+ +

My favorite editor is MacVim, and a series of regexes like this does the bulk of the work with just a little manual clean up following:

+ +
%s#<span#^M<span#g
+%s#<span lang="\(.*\)" .*>#<% } else if ("\1" == env.locale) { %>#g
+%s#<span class="script">template.Cssxref(#<%- template("Cssxref", [#
+%s#)</span> </span>#]) %>
+
+ +

Your mileage may vary, and patterns change slightly from template to template. That's why the migration script was unable to just handle this automatically, after all.

+ +

String variables and switch

+ +

Rather than switch between full chunks of markup, you can define a set of strings, switch them based on locale, and then use them to fill in placeholders in a single chunk of markup:

+ +
<%
+var s_title = 'Firefox for Developers';
+switch (env.locale) {
+    case 'de':
+        s_title = "Firefox für Entwickler";
+        break;
+    case 'fr':
+        s_title = "Firefox pour les développeurs";
+        break;
+    case 'es':
+        s_title = "Firefox para desarrolladores";
+        break;
+};
+%>
+<span class="title"><%= s_title %></span>
+
+ +

You'll see examples of this in legacy DekiScript templates. For the most part, this pattern should work as-is, but you may need to adjust the expected values of locales (e.g., en, cn, pt become en-US, zh-CN, pt-PT respectively).

+ +

Use mdn.localString()

+ +

A recent addition to the Template:MDN:Common module is mdn.localString(), used like this:

+ +
<%
+var s_title = mdn.localString({
+  "en-US": "Firefox for Developers",
+  "de": "Firefox für Entwickler",
+  "es": "Firefox para desarrolladores"
+});
+%>
+<span class="title"><%= s_title %></span>
+
+ +

This is more concise than the switch statement, and may be a better choice where a single string is concerned. However, if many strings need to be translated (e.g., as in CSSRef), a switch statement might help keep all the strings grouped by locale and more easily translated that way.

+ +

When the object does not have the appropriate locale, the value of "en-US" is used as the initial value.

+ +

Before and after examples

+ +

Carriage returns added here and there for clarity.

+ +
// Before: DOM0() template Dekiscript
+<p><span class="lang lang-en" lang="en">DOM Level 0. Not part of any standard. </span>
+<span class="lang lang-es" lang="es">DOM Nivel 0. No es parte de ninguna norma. </span>
+<span class="lang lang-*" lang="*">DOM Level 0. Not part of any standard. </span>
+<span class="lang lang-fr" lang="fr">DOM Level 0. Ne fait partie d'aucune spécification. </span>
+<span class="lang lang-ja" lang="ja">DOM Level 0。どの標準にも属しません。 </span>
+<span class="lang lang-pl" lang="pl">DOM Level 0. Nie jest częścią żadnego standardu. </span>
+<span class="lang lang-zh-cn" lang="zh-cn">DOM Level 0 不属于任何标准.</span></p>
+
+// After: Kumascript version
+<% if ("fr" == env.locale) { %>
+<p>DOM Level 0. Ne fait partie d'aucune spécification.</p>
+<% } else if ("ja" == env.locale) { %>
+<p>DOM Level 0。どの標準にも属しません。 </p>
+<% } else if ("pl" == env.locale) { %>
+<p>DOM Level 0. Nie jest częścią żadnego standardu.</p>
+<% } else if ("es" == env.locale) { %>
+<p>DOM Nivel 0. No es parte de ninguna norma.</p>
+<% } else if ("zh-CN" == env.locale) { %>
+<p>DOM Level 0 不属于任何标准.</p>
+<% } else { %>
+<p>DOM Level 0. Not part of any standard.</p>
+<% } %>
+ +
// From ReleaseChannelInfo() template
+// Before:
+web.html("<p>Firefox " + $0 + ", based on Gecko " + $1 + ", will ship in " + $2 + ".
+ This article provides information about the changes in this release that will
+ affect developers. Nightly builds of what will become Firefox " + $0 + " are "
+  + web.link(url, "currently available") + " on the " + string.ToUpperFirst($3)
+  + " channel.</p>");
+
+// After:
+<p>Firefox <%= $0 %>, based on Gecko <%= $1 %>, will ship in <%= $2 %>. This
+ article provides information about the changes in this release that will
+ affect developers. Nightly builds of what will become Firefox <%= $0 %>
+ are <%- web.link(url, "currently available")%>  on the
+ <%= string.ToUpperFirst($3) %> channel.</p>
+ +
// Before: old Dekiscript snippet
+if ($1 && string.length($1)) {
+  optionsText = optionsText + "<li>" + LXRSearch("ident", "i", $1) + "</li>";
+}
+
+// After: new Kumascript. Quote parameters to template() unless it is an arg variable (like $1).
+if ($1 && string.length($1)) {
+    optionsText = optionsText + "<li>" + template("LXRSearch", ["ident", "i", $1]) + "</li>";
+}
+
+// Note that template() within <% ... %> outputs nothing directly. If you want to call another
+// template and display its output, use <%= %> or <%- %> like this:
+<%- template("LXRSearch", ["ident", "i", $1]) %>
+ +

See also

+ + diff --git a/files/es/mdn/tools/page_regeneration/index.html b/files/es/mdn/tools/page_regeneration/index.html new file mode 100644 index 0000000000..cdc6fbd699 --- /dev/null +++ b/files/es/mdn/tools/page_regeneration/index.html @@ -0,0 +1,32 @@ +--- +title: Renderizado de páginas en MDN +slug: MDN/Tools/Page_regeneration +translation_of: MDN/Tools/Page_regeneration +--- +
{{MDNSidebar}}
+ +

El sitio MDN almacena en caché las páginas para que el usuario obtenga un mejor rendimiento. Como resultado, los cambios que guarde en una página podrían no aparecer la próxima vez que vuelva a cargar la página. A menudo, pero no siempre, aparece un banner en la página que indica que hay una actualización de la página en proceso. Puede hacer una "recarga forzada" (Shift + F5) en su navegador para volver a cargar la página desde el servidor, pero esto puede no tener efecto si la actualización en el servidor no se ha completado.

+ +

Algunas páginas (especialmente las páginas de destino) usan macros para generar y actualizar automáticamente su contenido. Para las páginas de destino, esto asegura que los nuevos artículos se enumeren automáticamente en la página, sin que un escritor tenga que agregarlos manualmente. Esta es útil para los contribuyentes de mucho tiempo, y ayuda a los recién llegados a evitar que su trabajo se pierda en la confusión porque no sabían cómo vincular sus artículos en la jerarquía del sitio.

+ +

Esto también se puede usar cuando se transmite contenido de una página a otras páginas (usando, por ejemplo, la macro {{TemplateLink ("Página")}}).

+ +

Debido a que el caché de MDN almacena el contenido renderizado para mejorar el rendimiento, los cambios realizados en el material de origen (como salida de macro o páginas transcluidas) no se reflejan automáticamente en la página. Si espera cambios frecuentes en dichos materiales de origen, puede considerar habilitar la regeneración automática de su página.

+ +

Siga los siguientes pasos para habilitar la regeneración automática:

+ +
    +
  1. Cambia el idioma del editor a inglés.
    2. +
  2. Haga clic en el botón Edit en la página para ingresar al modo de edición.
    3. +
  3. Debajo del título de la página, haga clic en Edit page title and properties ubicados cerca del título de la página. Aparecen los campos de metadatos de la página.
    4. +
  4. Establezca un valor para Rendering max age . Este valor determina la cada cuánto tiempo se reconstruye la página en caché, incluida la ejecución de sus macros. Por lo general, usamos 4 u 8 por defecto. Para una tecnología cuya documentación está cambiando rápidamente, puede elegir un número más bajo.
    5. +
  5. Guarda tus cambios en la página. Es una buena práctica hacer un comentario de revisión que describa lo que hiciste, como "Establecer la Rendering max age en 4 horas".
    6. +
+ +

La página se regenerará automáticamente en el horario que especificó.

+ +
+

Nota: La opción Edit page title and properties no está disponible al crear una nueva página; tendrás que volver a abrir el editor después de tu primer guardado.

+ +

La opción Edit page title and properties no está disponible de momento en otros idiomas que no sean inglés.

+
diff --git a/files/es/mdn/tools/template_editing/index.html b/files/es/mdn/tools/template_editing/index.html new file mode 100644 index 0000000000..0edab22e95 --- /dev/null +++ b/files/es/mdn/tools/template_editing/index.html @@ -0,0 +1,14 @@ +--- +title: Edición de plantillas +slug: MDN/Tools/Template_editing +tags: + - Guía + - Herramientas + - MDN Meta + - Privilegios + - Roles(2) +translation_of: MDN/Tools/Template_editing +--- +
{{MDNSidebar}}

En MDN, las plantillas escritas en KumaScript son usadas para automatizar la generación de contenido y la personalización de las páginas. Cada plantilla es un archivo separado del directorio de macros del repositorio GitHub KumaScript.

+ +

Cualquiera que edite páginas wiki de MDN puede invocar plantillas utilizando macros en los artículos MDN.  Cuaquiera puede crear y editar plantillas vía el repositorio GitHub KumaScript GitHub usando prácticas open-source estándar (bifurcando el repositorio, creando una rama, haciendo tus cambios, y enviando una petición de incorporación de cambios para revisión). Ten en cuenta que enviar una petición de incorporación de cambios es actualmente la única forma de actualizar cadenas traducidas en las plantillas que las contienen.

diff --git a/files/es/mdn/user_guide/index.html b/files/es/mdn/user_guide/index.html new file mode 100644 index 0000000000..b2e20cd131 --- /dev/null +++ b/files/es/mdn/user_guide/index.html @@ -0,0 +1,13 @@ +--- +title: MDN user guide +slug: MDN/User_guide +tags: + - Documentation + - Landing + - MDN + - NeedsTranslation + - TopicStub +translation_of: MDN/Tools +--- +
{{MDNSidebar}}

The Mozilla Developer Network site is an advanced system for finding, reading, and contributing to documentation and sample code for Web developers (as well as for Firefox and Firefox OS developers). The MDN user guide provides articles detailing how to use MDN to find the documentation you need, and, if you wish, how to help make the material better, more expansive, and more complete.

+

{{SubpagesWithSummaries}}

diff --git a/files/es/mdn/user_guide/writing/index.html b/files/es/mdn/user_guide/writing/index.html new file mode 100644 index 0000000000..f90a45bfdf --- /dev/null +++ b/files/es/mdn/user_guide/writing/index.html @@ -0,0 +1,67 @@ +--- +title: Escribir contenido +slug: MDN/User_guide/Writing +tags: + - Agregar + - Content + - Crear + - Create + - MDN + - Nueva + - Page + - Writing +translation_of: Archive/Meta_docs/Writing_content +--- +
{{MDNSidebar}}

Siempre hay cosas que se pueden agregar o actualizar en MDN. Ya sea una documentación completamente nueva y brillante API o una revisión de una vieja API que ha cambiado sutilmente, encontrarás muchas oportunidades para ayudar.

+

Editar una página existente

+

Si has encontrado una página que te gustaría revisar, simplemente haz click en el botón "editar" en la parte superior derecha de la página. Esto abrirá el editor WYSIWYG para trabajar en los contenidos de la página. Mira la guía del editor MDN para tener detalles de cómo trabajar con el editor, como así también cómo trabajar con el sistema macro que usamos para ayudar a automatizar la construcción y dar formato al contenido.

+

Hay muchas muchas razones por las que podrías editar una página existente:

+ +

Agregar una nueva página

+

¡Esto es grandioso! Agregar una nueva página a MDN hace que la Web te quiera y que quiera abrazarte. Hay muchas razones obvias para crear una nueva página, incluyendo documentar una API que todavía no lo está o agregar un nuevo tutorial o guía de un tema.

+

Hay unos pasos a seguir para crear una nueva página enMDN, una vez que te hayas logueado:

+
+
+ Haz click en el enlace "falta una página" ("missing page")
+
+ Cuando navegas en MDN, ocasionalmente puedes encontrar enlaces a páginas que todavía no existen. A menudo, cuando creamos artículos, incluimos enlaces a páginas que hay que crear, incluso si no han sido construidas todavía. Esto nos ayuda a realizar un seguimiento de las cosas que se necesitan hacer, aunque algunas veces lleva algo de tiempo retomarlas. ¡Siéntete libre para hacerlo! Sólo haz click en estos enlaces y te llevarán derecho al editor para una nueva página.
+
+ Crear una sub-página
+
+ Cerca de la esquina superior derecha de cada artículo hay un menu desplegable llamado "Esta página" ("This page"). En ese menú, hay una opción "Nueva sup-página" ("New sub-page"). Haciendo click en esa opción se abre el editor de página para una nueva página, cuya página ascendente en la jerarquía del sitio, es la que elegiste "Nueva sup-página" ("New sub-page"). Simplemente completa el título y el enlace amigable, y comienza a escribir el contenido del artículo.
+
+ Clonar una página
+
+ También puedes clonar una página existente usando la opción "Clonar esta página" en el menú desplegable "Esta página". Haciendo click se crea una copia de la página actual, cuya página contenedora es la miama que la página actual, y abre el editor en esa página donde puedes colocar el título de la página y el enlace amigable y también, editar su contenido. Esta, normalmente, es una buena manera de agregar una nueva página a un área de referencia existente en el sitio porque, por ejemplo, te provee de un diseño de muestra para el contenido.
+
+ Crear un enlace a una página que no existe, luego hacer click en él
+
+ Este es un método un poco híbrido. Como cada debería ser enlazada de alguna parte podrías empezar creando un enlace al nuevo artículo agregándolo a una página existente y, luego de guardar la página, puedes hacer click en el lick que acabas de insertar para abrir un editor para el nuevo article.
+
+
+

Nota: si no ingresaste con tu nombre usuario, te va a aparecer el error 404 cuando trates de visitar un artículo que no existe en vez del editor de páginas.

+
+

Buscar información

+

Hay un montón de información allí afuera y puede ser difícil dar con la ayuda exacta que necesites. Aquí hay unos consejos para que comiences.

+
+
+ Listas de propietarios de módulos
+
+ Los proyectos Mozilla funcionan con una base de "propietario de módulo" . Cada componente mayor tiene un propietario o propietarios responsables de lo que pasa allí. Estos propietarios son muy frecuentemente tu mejor fuente de información o, por lo menos, un muy buena manera de encontrar a la persona correcta con la cual comunicarse.
+
+ Referencia cruzada de la fuente de Mozilla
+
+ RCM (ó en ingles, MXR), la referencia cruzada de Mozilla, te permite acceder a todo el código fuente del proyecto Mozilla (a excepción de algunas cosas, como gran parte del Sistema operativo Firefox, que se encuentra en GitHub). El código y sus comentarios son, amenudo. un gran resurso para la información.
+
+ La wiki de Mozilla wiki
+
+ La wiki de Mozilla, frecuentemente referenciada como "wikimo", es un depósito de notas de procesos y diseños, borradores, planes y especificaciones preliminares. A pesar de ser muchas veces un caos, es un tesoro con información invaluable.
+
-- cgit v1.2.3-54-g00ecf