cgit: retoques que mejoran su encanto

25 Nov

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

 

Enlaces y referencias