> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/es/base-de-conocimientos/044-github-synchronization.md). # Sincronización con GitHub **Sincronización de GitHub** es una [función premium](/latex/es/base-de-conocimientos/120-overleaf-premium-features.md). Las funciones premium de Overleaf están disponibles para los participantes en [Overleaf Commons](https://www.overleaf.com/for/universities), los miembros de grupos [suscripciones](https://www.overleaf.com/for/groups), y los propietarios de suscripciones individuales [suscripciones](https://www.overleaf.com/user/subscription/plans). Resumen La función de sincronización de GitHub te permite vincular tus proyectos de Overleaf directamente a un repositorio de GitHub que actúa como repositorio remoto de tu proyecto de Overleaf, y proporciona una forma de enviar y recibir cambios entre ambos. La sincronización de GitHub solo puede utilizarse en [GitHub.com](https://www.github.com) y no puede usarse para conectarse a otras instalaciones empresariales de GitHub. Puedes sincronizar un proyecto de Overleaf con un repositorio de GitHub ya sea creando un nuevo proyecto de Overleaf a partir de un repositorio de GitHub existente o creando un nuevo repositorio de GitHub a partir de un proyecto de Overleaf existente. No es posible sincronizar un proyecto de Overleaf existente con un repositorio de GitHub existente. * La sincronización de GitHub se habilita vinculando tu cuenta de GitHub con tu cuenta de Overleaf * Se pueden crear nuevos proyectos a partir de repositorios de GitHub existentes * Se pueden crear repositorios en GitHub basados en proyectos de Overleaf existentes * Los proyectos y repositorios vinculados se mantienen sincronizados usando la **GitHub** opción en el **Menú** ### Vincular tu cuenta de Overleaf con tu cuenta de GitHub Para usar la función de sincronización de GitHub, debes vincular tu cuenta de Overleaf con tu cuenta de GitHub. Puedes hacerlo en tu [Configuración de la cuenta](https://www.overleaf.com/user/settings)de Overleaf. Ten en cuenta que la capacidad de Overleaf para conectarse a ciertos repositorios u organizaciones asociados con tu cuenta puede depender de la configuración de permisos que se haya establecido en GitHub. ### Crear un nuevo proyecto de Overleaf a partir de un repositorio de GitHub Desde el menú Nuevo proyecto, puedes seleccionar la opción de GitHub. Esto te mostrará una lista de repositorios visibles para Overleaf a través de tu cuenta de GitHub, según la configuración de permisos de GitHub. ![Crear nuevo github.png](/files/6f8be85ae995e01e1b5e0ce4e85e24676a032b39) Algunas cosas a tener en cuenta al crear un nuevo proyecto de Overleaf a partir de un repositorio de GitHub existente. * Se aplican restricciones de tamaño a los proyectos de Overleaf que pueden impedir que repositorios de GitHub más grandes se utilicen para crear un proyecto. Consulta [esta página](/latex/es/base-de-conocimientos/119-overleaf-plan-limits.md) para obtener una descripción general de las limitaciones aplicadas al tamaño y al número de archivos en un proyecto de Overleaf. * Los proyectos de Overleaf no admiten submódulos de Git ni Git LFS. ### Crear un nuevo repositorio de GitHub a partir de un proyecto de Overleaf Desde el menú del proyecto de Overleaf, puedes seleccionar GitHub como una de las opciones de sincronización. Esto te mostrará un cuadro de diálogo en el que podrás proporcionar el nombre de un nuevo repositorio de GitHub para sincronizarlo con tu proyecto de Overleaf. ![Menú del proyecto github.png](/files/6b09d9e81dd7ef248ae638066c8fe8e21f18e922) ### Sincronización con GitHub La sincronización entre GitHub y Overleaf no ocurre automáticamente; las opciones de sincronización se muestran al hacer clic en **GitHub** opción en el **Menú**. En ese momento, el modal de GitHub indicará si hay nuevos cambios que recibir desde GitHub. Siempre se te mostrará la opción de enviar cambios a GitHub (nota: esta opción se mostrará incluso si Overleaf y GitHub están actualizados). ![imagen del modal de GitHub](/files/e64cf2f2eb121946939cd92dd3b7a2d10e16e0a5) Los commits a GitHub se crean cuando se hace clic en el botón Enviar cambios de Overleaf a GitHub. En ese momento se puede proporcionar un mensaje de commit opcional. * Los cambios en el historial de Overleaf provenientes de GitHub se mostrarán como realizados por anónimo. * Los cambios en el historial de GitHub provenientes de Overleaf se mostrarán como realizados por el propietario de la cuenta de GitHub conectada. ### Resolución de conflictos de fusión Puede ocurrir que, cuando se hacen cambios tanto en Overleaf como en GitHub, Git no pueda determinar cómo fusionarlos automáticamente. Por ejemplo, si tu colaborador cambió una línea en Overleaf y tú cambiaste la misma línea en el repositorio de GitHub, es posible que Overleaf no pueda elegir qué versión conservar. Cuando eso ocurre, en lugar de fusionar en tu rama principal, enviamos una nueva rama a tu repositorio. Esta rama tendrá un nombre descriptivo (incluyendo la fecha y la hora de creación de la rama) y contiene la versión del documento en Overleaf. Cuando intentes sincronizar con GitHub, se mostrará un mensaje indicando que hay que resolver un conflicto de fusión. ![Diálogo de conflicto de fusión de GitHub](/files/77438fce6ae48fdc2a98c8be3df0103736af48b5) Para volver a sincronizarte, necesitas fusionar la rama de Overleaf en tu rama principal (predeterminada). Puedes hacerlo en tu ordenador descargando ambas ramas y fusionándolas con git o con cualquier otra herramienta, y luego volviendo a enviar el resultado a GitHub. Como alternativa, puedes hacer la fusión directamente en GitHub creando una solicitud de extracción desde la rama de Overleaf y usando su función de resolución de conflictos. Ambos enfoques se explican en la [documentación de GitHub](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts). ### Acceso a repositorios en tus organizaciones de GitHub Puedes sincronizar proyectos de Overleaf con repositorios asociados a tu cuenta de GitHub conectada, y también puedes sincronizar con proyectos en organizaciones de GitHub de las que seas miembro. Para sincronizar con repositorios en tus organizaciones de GitHub asociadas, esas organizaciones deben otorgar permiso para ser accedidas por la aplicación OAuth de Overleaf. * Si eres miembro de una organización, puedes seguir los pasos descritos [aquí](https://help.github.com/articles/requesting-organization-approval-for-oauth-apps/) para solicitar acceso para que la aplicación de Overleaf acceda a tu organización. * Si eres el propietario de la organización, puedes seguir los pasos descritos [aquí](https://help.github.com/articles/approving-oauth-apps-for-your-organization/) para aprobar la aplicación de Overleaf para la organización. ### Límites de archivos de la sincronización de GitHub Los proyectos de Overleaf están sujetos a limitaciones de tamaño individuales, así como a límites en el número total de archivos de un proyecto, como se indica [aquí](/latex/es/base-de-conocimientos/119-overleaf-plan-limits.md). Aunque Git en sí puede manejar un solo commit que cambie miles de archivos, la API de GitHub que utiliza la función de sincronización de GitHub de Overleaf también impone límites en el número de archivos que se pueden enviar o recibir. Se recomienda limitar el número de archivos en un commit individual a menos de 100 archivos, y el tamaño total del proyecto a menos de 100 MB si se usa la sincronización con GitHub. Los proyectos por encima de estos tamaños pueden funcionar, pero recomendamos mantenerse dentro de estos límites para evitar posibles problemas de sincronización. ### Desvincular un proyecto de un repositorio Aunque es posible crear varios proyectos a partir de un único repositorio de GitHub existente, **no es posible cambiar el repositorio asociado a un proyecto determinado**. Una vez que un proyecto está vinculado a un repositorio, no se puede desvincular y usar para crear un nuevo repositorio. Si necesitas crear un nuevo repositorio a partir de un proyecto concreto, debes hacer una nueva copia del proyecto y luego crear el nuevo repositorio a partir de esa copia. ### Limitaciones conocidas **Ramas**: El sistema Git de Overleaf no admite la creación de ramas. **Enlaces simbólicos**: El sistema Git de Overleaf no maneja enlaces simbólicos. Se puede enviar un enlace simbólico a un proyecto de Overleaf, pero se convertirá en un archivo normal y sobrescribirá el enlace simbólico local la próxima vez que se descargue el proyecto. **Permisos de archivo**: El sistema Git de Overleaf no conserva los permisos de ejecución. Al trabajar con la sincronización de GitHub, si algún archivo con el bit de ejecución en GitHub se sincroniza con Overleaf, Overleaf activará un commit automático para restablecer los permisos del archivo. **Git LFS**: Los proyectos de Overleaf no admiten Git Large File Storage. **Submódulos de Git**: Los proyectos de Overleaf pueden actuar como submódulos de Git dentro de otros repositorios, pero no pueden contener otros submódulos de Git. Para referenciar archivos de otros proyectos, se sugiere usar la función de añadir desde otro proyecto. **Control de cambios y comentarios**: Lamentablemente, las descargas desde GitHub a Overleaf pueden provocar la pérdida o el desplazamiento de los cambios rastreados y los comentarios; por lo tanto, no recomendamos mezclar trabajo activo en GitHub con el uso de cambios rastreados y/o comentarios. **Sincronización directa con GitHub Enterprise o GitLab:** La API de GitHub utilizada por Overleaf solo puede conectarse a repositorios alojados en github.com. Puedes sincronizar indirectamente con proyectos alojados en otros proveedores usando la [integración Git de Overleaf](/latex/es/base-de-conocimientos/040-git-integration.md) función. **Conectar un proyecto existente a un repositorio existente**: No es posible sincronizar un proyecto de Overleaf existente con un repositorio de GitHub existente. **Autoría de los envíos a GitHub**: El único usuario de GitHub del que Overleaf tiene conocimiento es el usuario cuya cuenta de GitHub está vinculada a la cuenta de Overleaf y es propietaria de ese proyecto. Todos los commits se realizan mediante una API de GitHub que explícitamente los hace usando la identidad de ese usuario. Por lo tanto, todos los commits aparecerán en el historial de Git de GitHub como procedentes del usuario vinculado. En el historial de Overleaf, los cambios se muestran como "Anónimo (vía GitHub)". **Historial de Git e historial de Overleaf:** Los cambios en el lado de Overleaf no tienen una correspondencia uno a uno con los commits de GitHub. Varios usuarios pueden hacer cambios en el lado de Overleaf, pero estos cambios se agruparán como un único commit bajo el usuario conectado a GitHub cuando se active la sincronización. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/es/base-de-conocimientos/044-github-synchronization.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.