Saltar al contenido principal

Flujo de trabajo de Microsoft Word a GitHub Wiki con Writage

Introducción​

Esta es una guía sobre cómo utilizar el complemento Writage para Microsoft Word para escribir y editar páginas wiki de GitHub directamente desde Word.

Esto podría ser beneficioso para los escritores que prefieren la interfaz y las características familiares de Word, sin dejar de ser capaz de aprovechar el control de versiones de GitHub y las capacidades de colaboración.

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

Un documento Markdown enviado al repositorio wiki aparecerá como una nueva página en el 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, puedes escribir y editar un documento Markdown como si fuera un documento Word normal. Con Writage, puedes abrir archivos Markdown existentes directamente en Word y guardar documentos Word como archivos Markdown.Un gráfico que muestra la interfaz de Writage en Microsoft Word

Convertir un documento Markdown en un archivo PDF​

  1. Abra el documento Markdown en Word.
  2. Haga clic en Archivo > Guardar como..
  3. Seleccione PDF en el menú desplegable de tipo de archivo.
  4. Guarde el archivo en la ubicación elegida.

Clonación de un Wiki de GitHub a GitHub Desktop​

GitHub Desktop no clona automáticamente un GitHub Wiki. Tendrás que clonarlo manualmente.

  1. Abre el wiki y copia la URL que aparece en la esquina inferior derecha de la página.

    Una captura de pantalla de la página de inicio de este wiki

  2. En GitHub Desktop, pulsa CTRL+MAYÚS+O para abrir el diálogo "Clonar un repositorio".

  3. Haz clic en la pestaña URL.

  4. Pega la URL del wiki y pulsa Clonar..

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

Enviar un documento Markdown a un Wiki de GitHub​

Una vez que has escrito un documento Markdown en Word, puedes enviarlo a la wiki del repositorio GitHub sin necesidad de copiarlo y pegarlo en el editor Markdown de GitHub y formatearlo allí.

  1. Guarda el documento Markdown en la carpeta wiki configurada al instalar GitHub Desktop.
  2. Abre la aplicación GitHub Desktop.
  3. Selecciona el repositorio wiki.
  4. Confirma los cambios (añade un resumen).
  5. Pulsa CTRL+P para enviar los cambios a la wiki.
nota

Añade un resumen al archivo antes de enviarlo a la wiki. El resumen describe brevemente los cambios realizados en el documento, lo que ayuda a otros colaboradores a entender las actualizaciones sin leer todo el documento.

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

  1. Abre la wiki en un navegador para comprobar que está actualizada.

Repite los pasos para enviar el documento a GitHub cuando crees un nuevo documento o edites uno existente.