Manual de usuario de calibre, Publicación 2.73.0
1.12.2 Obtener el código
Puede obtener el código fuente de calibre de dos maneras, usando un sistema de control de versiones o descargando directamente un tarball 100.
calibre utiliza Git 101, un sistema de control de versiones distribuido. Git está disponible en todas las plataformas que soporta calibre. Una vez instalado Git, puede obtener el código fuente de calibre con la orden:
git clone git:// github. com / kovidgoyal / calibre. git
En Windows necesitará la ruta completa, que será algo así como C:\ Archivos de programa \ Git \ git. exe.
calibre es un gran proyecto con un extenso historial de control de código fuente, asi que esto puede tomar un tiempo( de 10 minutos a una hora, dependiendo de la velocidad de la conexión a Internet).
Si quiere obtener el código más rápidamente, el código fuente de la última versión está siempre disponible como un archivo 102.
Para actualizar el código de una rama a su versión más reciente, use la orden: git pull--no-edit
Enviar cambios para que se incluyan
Si sólo va a hacer algunos pequeños cambios, puede hacer los cambios y crear una « directiva de fusión » que luego puede adjuntar a un informe en el registro de errores 103. Para ello, realice los cambios y después ejecute:
git commit-am " Comment describing your changes " git format-patch origin / master--stdout > my-changes
Esto creará un archivo my-changes en el directorio actual, simplemente adjúntelo a un informe en el registro de errores 104. Tenga en cuenta que esto incluirá todos los cambios que haya realizado. Si sólo desea enviar algunos cambios, tendrá que sustituir el origin / master anterior. Para enviar sólo el último cambio, use:
git format-patch HEAD ~ 1--stdout > my-changes
Para enviar los últimos n cambios, sustituya 1 por n, por ejemplo, para los últimos 3 cambios: git format-patch HEAD ~ 3--stdout > my-changes
Tenga cuidado de no incluir uniones cuando use HEAD ~ n.
Si planea realizar mucho desarrollo en calibre, el mejor método es crear una cuenta en GitHub 105. A continuación se muestra una guía básica para la creación de su propia derivación de calibre, de manera que le permitirá presentar una solicitud de colaboración para que se incluya en el repositorio principal de calibre:
Configure git en el equipo como se describe en este artículo: Setup Git 106( en inglés)
Configure las claves SSH para la autenticación con GitHub, como se describe aquí: Generating SSH keys 107( en inglés)
100 https:// calibre-ebook. com / dist / src 101 http:// www. git-scm. com / 102 https:// calibre-ebook. com / dist / src 103 https:// bugs. launchpad. net / calibre 104 https:// bugs. launchpad. net / calibre 105 https:// github. com 106 https:// help. github. com / articles / set-up-git 107 https:// help. github. com / articles / generating-ssh-keys
282 Capítulo 1. Secciones