Flujo de trabajo de Microsoft Word a una wiki de GitHub con Writage

Introducción

Esta guía explica cómo escribir y editar páginas wiki de GitHub en Microsoft Word con el complemento Writage. Use este flujo de trabajo si prefiere las herramientas de edición de Word y quiere que GitHub registre cada revisión de una página.

Writage agrega compatibilidad con Markdown a Microsoft Word. Puede abrir, editar y guardar archivos Markdown dentro de Word. Cada archivo Markdown que envíe al repositorio de la wiki se convierte en una página. El nombre del archivo define el nombre de la página.

Requisitos previos

• El complemento Writage para Microsoft Word

  nota

  Writage incluye una prueba gratuita de 14 días. Después de ese plazo, debe comprar una licencia.

• Aplicación de escritorio de Microsoft Word versión 2010 o posterior

• GitHub Desktop

• Un repositorio de GitHub con una wiki inicializada

Instrucciones

nota

Los pasos usan atajos de Windows. En macOS, presione Cmd donde los pasos indican Ctrl.

Configuración de Writage

1. Ejecute el instalador de Writage y siga las instrucciones.

   

2. Abra Microsoft Word y confirme que la pestaña Writage aparece en la cinta de opciones.

Writage en Microsoft Word

Una vez instalado el complemento, Word trata los archivos Markdown como cualquier otro documento. Puede abrir un archivo Markdown existente o crear uno nuevo.

1. Seleccione Archivo > Guardar como.
2. Seleccione Markdown en la lista de formatos de archivo.
3. Asigne al archivo el nombre de la página wiki que desea crear.

Clonación de una wiki de GitHub en GitHub Desktop

GitHub Desktop no clona wikis junto con el repositorio. Clone la wiki usted mismo.

1. Abra la wiki en el navegador y copie la dirección de la sección Clonar esta wiki localmente.

   

2. En GitHub Desktop, presione Ctrl+Mayús+O para abrir el cuadro de diálogo Clonar un repositorio.

3. Pegue la dirección de la wiki y seleccione Clonar.

   

Publicación de un documento Markdown en una wiki de GitHub

Envíe el archivo al repositorio de la wiki. Así evita el editor web de GitHub y no vuelve a copiar ni a dar formato a la página.

1. Guarde el archivo Markdown en la carpeta local donde clonó el repositorio de la wiki.

2. Abra GitHub Desktop y seleccione el repositorio de la wiki.

3. Escriba un resumen de confirmación conciso y seleccione Commit to main. Si la wiki usa otra rama predeterminada, el botón muestra el nombre de esa rama.

   nota

   Escriba un resumen que explique el cambio, para que los demás no tengan que abrir el archivo.

   

4. Presione Ctrl+P, o seleccione Push origin, para enviar los cambios.

5. Abra la wiki en el navegador para verificar la página nueva.

Repita estos pasos para cada documento nuevo o cada edición de una página existente.

Conversión de un documento Markdown a un archivo PDF

1. Abra el documento Markdown en Word.
2. Seleccione Archivo > Guardar como.
3. Seleccione PDF en la lista de formatos de archivo.
4. Elija una carpeta de destino y seleccione Guardar.