Comunidad hispanohablante de NVDA

Celebramos el día del amor por el software libre 2021 ((#ilovefs), ) con un post para agradecer el trabajo de quienes quieren publicar información útil en esta web, como comentamos en este hilo sobre el tutorial de WhatsApp.

Git y GitHub

Aparte de enviar información a la lista o en privado y pedir su publicación, se puede publicar directamente desde una cuenta de GitHub.

Para ello puedes seguir los siguientes procedimientos:

Crear una incidencia sin pedir una invitación al repositorio

En este caso no dispondrás de perfil propio para esta web (el enlace que se muestra al final de cada artículo), y recibiré una petición para revisar tu post antes de que pueda ser publicado. Tendré que editarlo un poco para que el título, el enlace permanente y el enlace para crear comentarios se muestren correctamente. También podríamos poner entre paréntesis tu nombre de autor al lado del título o hacer pequeños cambios sin afectar al contenido principal. Al crear la incidencia, rellena los campos etiquetados como “Título” y “Texto del post”. No cambies el texto del campo llamado “Title”, ya que su contenido preestablecido sirve para que GitHub pueda crear una solicitud de cambios, en la que el texto del post que envíes se incluirá automáticamente dentro de la carpeta “_posts”, en un fichero que se llamará como el título que indiques y con la extensión “.md”. Por ejemplo, la ruta podría ser: “_posts/Nuevo post.md”.

Después de editarlo tendré que subir estos cambios a la rama principal del repositorio para que queden publicados.

Crea una incidencia para publicar un nuevo post

Publicar con acceso al repositorio

Instalar Git

Con NVDA, recomiendo utilizar git desde la línea de comandos de windows (cmd).

Aquí hay Ayuda para descargar, instalar y configurar Git.

Clonar el repositorio de la web

Clonar un repositorio significa descargar un conjunto de archivos con Git para trabajar cómodamente desde el PC o un dispositivo local.

Antes de clonar repositorios, puede ser útil crear una carpeta para almacenarlos en un lugar conocido. Mi carpeta de repositorios, por ejemplo, se llama “repos”.

Para clonar el repositorio de esta web:

1. Vamos al símbolo del sistema: Windos+r, cmd
2. Nos situamos en la carpeta de repositorios: cd c:\repos
3. Desde el símbolo del sistema escribimos: git clone --recursive https://github.com/nvdaes/nvdaes.github.io

NVDA irá informando sobre el progreso de la descarga.

La opción --recursive sirve para que se descargue el submódulo (o subcarpeta) ableplayer. Able Player es un reproductor compatible con navegadores HTML5 que permite, entre otras cosas, leer la transcripción de un vídeo generada a partir de su pista de subtítulos y sincronizar el audio con el fragmento de la transcripción que se active mediante el teclado.

Si hemos clonado el repositorio de la web sin la opción --recursive, podemos ejecutar el comando: git submodule update --init

Para actualizar el repositorio local descargando solo los últimos cambios publicados por otras personas, podemos escribir: git pull

Para descargar los últimos cambios del repositorio Able Player: git submodule update

Crear un archivo de perfil

Al final de los posts aparece un enlace con el nombre de la persona que los publica para acceder a su perfil en esta web. Como ejemplo, puedes abrir mi perfil activando el enlace de mi nombre al final de este post.

Los perfiles son archivos con extensión .md situados en la raíz del repositorio.

Una vez clonado, ve a la carpeta nvdaes.github.io, dentro del directorio de repositorios, y busca ejemplos de archivos de perfil como el llamado noelia.md.

Los archivos .md pueden editarse con programas sencillos como el bloc de notas o Notepad++.

Son ficheros de texto en los que se usa el formato Markdown, que permite escribir párrafos, encabezados, listas, enlaces, etc., de forma rápida y sencilla. GitHub y otras plataformas pueden transformar el formato markdown en HTML, y por eso, por ejemplo en esta web, podemos usar el modo exploración de NVDA para ir al siguiente encabezado pulsando la h, la i para desplazarnos al siguiente ítem de una lista o la k para enlaces, entre otras posibilidades. Abre uno de los perfiles disponibles mediante un editor de texto y, a partir de él, crea tu propio perfil con tus datos de contacto y la información que quieras mostrar.

Añadir cambios

Para añadir los archivos nuevos o los que hayas modificado, desde el símbolo del sistema:

1. Abre la carpeta de la web: cd c:\repos\nvdaes.github.io
2. (Opcional) Consulta el estado de los archivos: git status
3. Añade el archivo modificado para que Git pueda observarlo: git add perfil.md
4. Registra el archivo en el historial de Git para poder subirlo a GitHub: git commit -m "Add my profile”

Publicar cambios

Una vez que tu cuenta de GitHub haya sido autorizada a colaborar con el repositorio de la web, desde la subcarpeta nvdaes.github.io, puedes escribir: git push

Al cabo de unos minutos, tus cambios quedarán publicados en la web.

Seguir aprendiendo

La información anterior puede ser útil para empezar. Se puede seguir explorando la subcarpeta _posts y algunos de sus archivos para publicar un post. En otras carpetas hay archivos responsables de otros componentes de la web.

Además, recomiendo este libro sobre Git, especialmente, la introducción y los capítulos sobre fundamentos de Git y ramificación.

También puede ser interesante esta guía sobre Markdown (en inglés).

Para Ver cómo funciona y la forma de incluir archivos multimedia con Able Player, puedes consultar el post sobre NVDA 2019.2.

Para cualquier duda o aclaración, nos vemos en nuestra lista de correo.