Saltar al contenido principal

Flujo de trabajo de Microsoft Word a GitHub Wiki con Writage

Introducción​

Esta guía explica cómo escribir y editar páginas wiki de GitHub directamente en Microsoft Word mediante el complemento Writage.

Este flujo de trabajo beneficia a los redactores que prefieren la interfaz y las funciones familiares de Word mientras utilizan GitHub para el control de versiones y la colaboración.

Writage es un complemento editor de Markdown para Microsoft Word. Permite escribir y editar documentos Markdown directamente en Word, lo que facilita la creación y el formateo de contenido para las wikis de GitHub.

Un documento Markdown insertado en el repositorio de la wiki aparece como una nueva página en la wiki.

Requisitos previos​

Instrucciones​

Configuración de Writage​

  1. Siga las instrucciones de instalación para configurar el complemento Writage.

Gráfico que muestra el proceso de instalación de Writage

Writage en Microsoft Word​

Una vez instalado el complemento Writage, puede escribir y editar un documento Markdown como un documento normal de Word. Con Writage, puede abrir archivos Markdown existentes directamente en Word y guardar documentos de Word como archivos Markdown.

Gráfico que muestra la interfaz de Writage en Microsoft Word

Clonación de una wiki de GitHub en GitHub Desktop​

GitHub Desktop no clona automáticamente la wiki de un repositorio. Debe clonar el repositorio de la wiki manualmente.

  1. Abra la wiki en GitHub y copie la URL de clonación desde la esquina inferior derecha de la página.

    Captura de pantalla de la página de inicio de esta wiki

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

  3. Haga clic en la pestaña URL.

  4. Pegue la URL de la wiki y haga clic en Clonar.

    Captura de pantalla del cuadro de diálogo de clonación en GitHub Desktop

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

Después de escribir un documento Markdown en Word, puede enviarlo directamente a su repositorio de wiki de GitHub. Esto elimina la necesidad de copiar, pegar y formatear contenido en el editor web de GitHub.

  1. Guarde el documento Markdown en el directorio local donde clonó el repositorio de la wiki.

  2. Abra la aplicación GitHub Desktop.

  3. Seleccione el repositorio de la wiki.

  4. Escriba un resumen de confirmación conciso y haga clic en Commit to main o Commit to master.

    nota

    El resumen describe las actualizaciones del documento, lo que ayuda a otros colaboradores a comprender las revisiones sin leer todo el archivo.

    Captura de pantalla del cuadro de diálogo de confirmación en GitHub Desktop

  5. Presione Ctrl+P o haga clic en Push origin para enviar los cambios a la wiki.

  6. Abra la wiki en un navegador web para verificar la página publicada.

Repita estos pasos cada vez que cree un nuevo documento o edite una página wiki existente.

Conversión de un documento Markdown a formato PDF​

  1. Abra el documento Markdown en Word.
  2. Haga clic en Archivo > Guardar como.
  3. Seleccione PDF en el menú desplegable de formato de archivo.
  4. Elija una carpeta de destino y haga clic en Guardar.