Una vez que lo tengo en marcha, que puedo visualizar mis programas y otras cosas sin sufrir, voy a darle un toquecito para mejorarlo.
Antes de nada añadir que el programa cgit es un poco peculiar con la configuración; casi todas las directivas deben indicarse antes de la que determina dónde están los repositorios (scan-path en mi caso) porque si no carecen de efecto.
Resaltado de síntaxis
Muy importante porque casi todo termina siendo código de una manera u otra.
Es necesario instalar el paquete python-pygments y añadir la siguiente estrofa a la configuración:
# Resaltado de síntaxis source-filter=/usr/lib/cgit/filters/syntax-highlighting.py
Y el resultado tiene buen aspecto:
Páginas de presentación
En estos tiempos de github y demás lo habitual para presentar un repositorio es añadir un archivo en la raíz hablando de él.
Se suele emplear el lenguaje de marcas markdown porque es muy sencillo de escribir y tiene un ratio de conversión muy interesante (son casi páginas web las que resultan) y los antiguos archivos README han pasado a ser README.md.
Para mostrarlos como página especial cgit tiene que ser configurado de la siguiente forma:
# Página sobre el repositorio about-filter=/usr/lib/cgit/filters/about-formatting.sh readme=:README.md readme=:readme.md readme=:README.mkd readme=:readme.mkd readme=:README.rst readme=:readme.rst readme=:README.html readme=:readme.html readme=:README.htm readme=:readme.htm readme=:README.txt readme=:readme.txt readme=:README readme=:readme readme=:INSTALL.md readme=:install.md readme=:INSTALL.mkd readme=:install.mkd readme=:INSTALL.rst readme=:install.rst readme=:INSTALL.html readme=:install.html readme=:INSTALL.htm readme=:install.htm readme=:INSTALL.txt readme=:install.txt readme=:INSTALL readme=:install
Y el resultado también es bastante bueno:
Enlaces auxiliares
cgit puede crear algunos enlaces útiles cuando se revisa un proyecto si se le indica cuáles y cómo:
# Enlaces para descargar en varios formatos # snapshots=tar.gz tar.bz2 zip # # Enlaces de clonado del repositorio adaptados # en la vista de envíos (commit) clone-url=https://git.astillas.net/$CGIT_REPO_URL.git
