tlwiki/Cgit.wiki

=CGit=

Current configuration can always be found at https://git.thurstylark.com/cgit.git/tree

===Push To Deploy===

The remote repo is set up to deploy the entire contents of the repo to `/srv/cgit` by using the `post-receive` hook in the git repo. 

{{{class="prettyprint"
#!/bin/bash
GIT_WORK_TREE=/srv/cgit git checkout -f
}}}

This allows configuration changes to be edited on a local repo, committed, then pushed to the remote to apply changes.

===About Page===

Had a problem with the about page not showing when the appropriate file names are definied as readme files. Here was the problematic config:

{{{class="prettyprint linenums"

#css=/cgit-css/cgit.css
#logo=/cgit-css/cgit.png

root-title=Thurstylark
root-desc=Projects and Dotfiles

source-filter=/srv/cgit/syntax-highlighting.py
about-filter=/usr/lib/cgit/filters/about-formatting.sh

enable-git-config=1
scan-path=/srv/git

enable-http-clone=1
clone-url=https://git.thurstylark.com/$CGIT_REPO_URL


#
# Search for these files in the root of the default branch of repositories
# for coming up with the about page:
#
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
}}}

The solution was to move the `scan-path` directive to the end of my cgitrc. See the [[https://git.zx2c4.com/cgit/tree/cgitrc.5.txt#n392|cgitrc manpage]] for details.