Add README

README.rst

@@ -0,0 +1,33 @@
+Admin foo howto
+===============
+
+Ansible
+-------
+
+Selectively run ansible playbooks for the git service and webserver setup:
+
+.. code-block::
+
+   ansible-playbook -i inventory.yml -t git,www playbook.yml
+
+Gitolite/CGIT
+-------------
+
+Remove ad-hoc repo from command line:
+
+.. code-block::
+
+   ssh git@git.jaseg.de unlock sjandrakei/pub/usb-remote
+   ssh git@git.jaseg.de D unlock sjandrakei/pub/usb-remote
+
+Set ad-hoc repo description from command line:
+
+.. code-block::
+
+   ssh git@git.jaseg.de desc sjandrakei/pub/kochbuch Bringing analog recipe books into the interwebs
+
+Create ad-hoc repo from command line:
+
+.. code-block::
+   
+   git clone git@git.jaseg.de:sjandrakei/pub/repo-to-be-created.git

cgitrc

@@ -1,5 +1,12 @@
 css=/cgit.css
 logo=/cgit.png
+favicon=/favicon.png
+
+root-title=git.jaseg.de
+root-desc=jaseg's git repositories
+snapshots=tar.gz tar.bz2 zip
+
+clone-url=git@git.jaseg.de:$CGIT_REPO_URL https://git.jaseg.de/$CGIT_REPO_URL
 
 enable-http-clone=1
 robots=noindex, nofollow

nginx.conf

@@ -396,6 +396,10 @@ http {
             alias /var/www/git.jaseg.de/cgit.png;
         }
 
+        location ~ ^/favicon.ico {
+            alias /var/www/git.jaseg.de/favicon.ico;
+        }
+
         location / {
             include uwsgi_params;
             uwsgi_modifier1 9;

setup_git.yml

@@ -1,13 +1,18 @@
 - name: Install host requisites
   dnf:
-      name: cgit,gitolite3,python3-pygments,python3-docutils,nodejs-markdown
+      name: cgit,gitolite3,python3-pygments,python3-docutils,nodejs-markdown,python3-markdown
       state: latest
 
-- name: Copy cgit favicon
+- name: Copy cgit logo
   copy:
       src: cgit-logo.png
       dest: /var/www/git.jaseg.de/cgit.png
 
+- name: Copy cgit favicon
+  copy:
+      src: cgit-favicon.ico
+      dest: /var/www/git.jaseg.de/favicon.ico
+
 - name: Create cgit instance config dir
   file:
     path: /var/lib/cgit