Configure el repositorio de Git localmente para la documentación
Este artículo describe los pasos para configurar un repositorio de Git en el equipo local, con la intención de contribuir a la documentación de Adobe. Los colaboradores pueden utilizar un repositorio clonado localmente para agregar nuevos artículos, realizar ediciones importantes en artículos existentes o cambiar ilustraciones.
Información general
Para contribuir a la documentación de Adobe, puede ramificar el repositorio apropiado en su cuenta de GitHub para obtener permisos de lectura y escritura. A continuación, puede crear y editar archivos Markdown localmente mediante la clonación del repositorio de documentación correspondiente. A continuación, utilice solicitudes de extracción para fusionar (enviar) los cambios en el repositorio compartido central de solo lectura.
- Determinar el repositorio adecuado
- Ramificar el repositorio a su cuenta de GitHub
- Seleccione una carpeta local para los archivos clonados
- Clone el repositorio en el equipo local
- Configure el valor remoto del flujo ascendente
Determine el repositorio
El repositorio adecuado se ramifica a su cuenta de GitHub para obtener permisos de lectura y escritura con el fin de almacenar los cambios propuestos. La documentación de Adobe Experience Cloud reside en varios repositorios diferentes en github.com.
- Si no está seguro del repositorio que debe utilizar, visite el artículo con su explorador Web. Seleccione el vínculo Editar (icono de lápiz) en la esquina superior derecha del artículo. (Si no ve un vínculo Editar, significa que ese contenido aún no está disponible en GitHub.)
Para contribuir a la documentación de Adobe, puede crear y editar archivos Markdown localmente mediante la clonación del repositorio de documentación correspondiente. A continuación, utilice solicitudes de extracción para fusionar cambios en el repositorio compartido central de solo lectura.
Ramificar el repositorio
Utilizando el repositorio adecuado, cree una ramificación del repositorio en su cuenta de GitHub en el sitio web de GitHub.
Se requiere una ramificación personal, ya que todos los repositorios de documentación principales proporcionan acceso de solo lectura, lo que significa que no puede realizar cambios directamente en el contenido de los repositorios. Para realizar cambios, debe enviar una solicitud de extracción (PR) desde la ramificación al repositorio principal. Para facilitar este proceso, primero necesita su propia copia del repositorio, en la que tiene acceso de escritura. Una ramificación de GitHub sirve para ese propósito.
-
Vaya a la página del repositorio principal de GitHub y haga clic en el botón Fork en la esquina superior derecha.
-
Si se le solicita, seleccione el mosaico de su cuenta de GitHub como destino donde se debe crear la ramificación. Este mensaje crea una copia del repositorio en su cuenta de GitHub, conocida como una ramificación.
-
Elija un nombre de carpeta fácil de recordar y escribir.
Algunos de los repositorios pueden ser grandes. Elija una ubicación con espacio disponible en el disco.
note note NOTE Evite seleccionar una ruta de carpeta local anidada dentro de otra ubicación de carpeta del repositorio de Git. Aunque es aceptable almacenar las carpetas clonadas de Git contiguas, anidar carpetas de Git dentro de otras causa errores para el seguimiento de archivos.
Crear un clon local del repositorio
Al crear un clon del repositorio ramificado, se descarga una copia de los archivos en su ordenador. Cuando esté listo, puede enviar ediciones desde la unidad local al repositorio ramificado en el servidor. A continuación, puede enviar una solicitud de extracción para fusionar las ediciones en la rama ascendente al repositorio principal.
Estos pasos dan por sentado que está utilizando GitHub Desktop. Si utiliza otro cliente, realice los ajustes correspondientes.
-
Haga clic en Clone or download y, a continuación, elija Open in Desktop para extraer una copia del repositorio (su ramificación) en su ordenador, en el directorio actual.
-
Utilice GitHub Desktop para mantener los archivos locales sincronizados con el repositorio ramificado.
Para obtener más información, consulte Documentación de GitHub Desktop.