sanadora / nahual.github.com Goto Github PK

Buenas! Somos Nahual, un proyecto social que se dedica, entre otras cosas, a enseñar testing manual con el objetivo de generar una salida laboral.

Acá guardamos gran parte del material que usamos para dar las clases. Si querés darnos una mano, estás más que invitada. Hacenos PRs o ponete en contacto con cualquier miembro.

Este es el repositorio de la página web. Es decir, donde vive todo el contenido a partir del cual se genera. Si querés participar de su edición, abajo hay algunas pautas. Si lo lees y no queda claro, avisanos así nos ayudás a que quien quiera contribuir pueda hacerlo con las menores barreras.

A grandes rasgos es maaasomenos así:

• tenemos todo nuestro material en repositorios de Github. Por ejemplo, el de "El Provinciano" está acá
• un repositorio especial es este, porque lo habilitamos para que funcione como "Gihub Page"
• cada vez que se hace un cambio en el repositorio (cambiar texto, subir un archivo, etc), Github agarra todo el material, lo pasa por "Jekyll", y lo publica (todo esto funciona de manera automágica).
  • Jekyll es básicamente un programa que transforma texto. Vos le pasás un archivo escrito en formato HTML o Markdown y Jekyll lo transforma a HTML agregándole un montón de cosas que lo hacen ver como un sitio web.

• abrilo desde el navegador de archivos de Github y hacé click en el botón de "editar":
• escribi lo que quieras en el formato del archivo. Por ahora son Markdown, porque es muy fácil de escribir. (abajo hay info de Markdown)
• acá hay una ayuda de Github: editando archivos

Si creas un nuevo archivo, desde la página generada se va a generar un link automáticamente (de eso se encarga Jekyll).

• usando el navegador de Github, andá hasta donde quieras que esté el nuevo archivo (en general debería ser en la raíz del repositorio)
• hacé click en "crear nuevo archivo":
• como en la sección anterior, ponele el texto que quieras (preferiblemente en markdown), pero obligatoriamente ponele lo que se conoce como "front matter" para Jekyll. Eso va a hacer que el archivo "participe" del proceso que hace Jekyll.

---
layout: page
title: Nahual FAQ
permalink: /faq/
---

• si no queda claro, fijate cómo están hechos los demás archivos del sitio. Por ejemplo, la página de "acerca de".
• acá también hay una ayuda de Github: creando-nuevos-archivos

Markdown es una forma de escribir texto. Sirve para indicar de manera sencilla qué partes de tu texto son títulos, listas, énfasis, citas, etc. Ese formato está muy aprovechado en otras herramientas que toman texto en formato Markdown y lo convierten a HTML, PDF, etc. Referencia - Probalo