@@ -7,9 +7,11 @@ Installs [gitolite][], creates a [dedicated user][] to run it (defaults to

 (explicit) [user created repos][] with [multiple `OWNERS`][] and `user/USER/*`

 [personal branches][] for `USERS`, allows users to run [`symbolic-ref`][] (e.g.

 to change `HEAD`, the default branch), prepares for [integration with a

-webserver][] (including acting as a [`git-http-backend`][] replacement, and

-serving repos without the `.git` suffix), allows [custom local code][], and

-prepares for [easy usage][`git-multihook`] of [custom local hooks][].

+webserver][] (including acting as a [`git-http-backend`][] replacement, serving

+repos without the `.git` suffix, and generating

+[`$GIT_DIR`][]`/`[`README.html`][] if [pandoc][] is available), allows [custom

+local code][], and prepares for [easy usage][`git-multihook`] of [custom local

+hooks][].

 [`ansible-role-gitolite`]: https://git.rcrnstn.net/rcrnstn/ansible-role-gitolite

 [Ansible]: https://docs.ansible.com/ansible

@@ -24,6 +26,9 @@ prepares for [easy usage][`git-multihook`] of [custom local hooks][].

 [`symbolic-ref`]: https://git-scm.com/docs/git-symbolic-ref

 [integration with a webserver]: https://gitolite.com/gitolite/gitweb-daemon.html

 [`git-http-backend`]: https://git-scm.com/docs/git-http-backend

+[`$GIT_DIR`]: https://www.git-scm.com/docs/git#Documentation/git.txt-codeGITDIRcode

+[`README.html`]: https://git-scm.com/docs/gitweb#Documentation/gitweb.txt-READMEhtml

+[pandoc]: https://pandoc.org

 [custom local code]: https://gitolite.com/gitolite/non-core.html#using-the-gitolite-admin-repo-to-manage-non-core-code

 [`git-multihook`]: https://git.rcrnstn.net/rcrnstn/git-multihook

 [custom local hooks]: https://gitolite.com/gitolite/cookbook#adding-other-non-update-hooks

@@ -7,6 +7,9 @@ gitolite_webserver_user_name: "www-data"

 gitolite_deps_dir: "{{ gitolite_user_home }}"

 gitolite_deps_git_multihook:

   - "https://git.rcrnstn.net/rcrnstn/git-multihook"

+gitolite_deps_post_receive:

+  - "https://git.rcrnstn.net/rcrnstn/git-hook-pandoc-readme"

 gitolite_deps: "{{

-  gitolite_deps_git_multihook

+  gitolite_deps_git_multihook +

+  gitolite_deps_post_receive

 }}"

@@ -150,3 +150,10 @@

       command: "{{ gitolite_hooks_dir | quote }}/git-multihook update"

       register: result

       changed_when: result.stdout != ""

+

+    - name: "Symlink post-receive hooks"

+      file:

+        src: "{{ gitolite_deps_dir }}/{{ item | basename }}/{{ item | basename }}"

+        dest: "{{ gitolite_hooks_dir }}/post-receive.d/{{ item | basename }}"

+        state: 'link'

+      loop: "{{ gitolite_deps_post_receive }}"