greenhousegreenhouse / herbarium / README39 lines · 1118B · raw
1herbarium - mailing list archive web interface 2============================================== 3herbarium is a CGI program that shows the archives kept by pollen as 4threads, with raw messages and thread mboxes for b4 and git am. 5 6 7Requirements 8------------ 9In order to build herbarium you need a C library with iconv. 10 11 12Installation 13------------ 14Edit config.mk to match your local setup (herbarium is installed into 15the /usr/local namespace by default). 16 17Afterwards enter the following command to build and install herbarium 18(if necessary as root): 19 20 make clean install 21 22 23Running herbarium 24----------------- 25Run herbarium as a CGI program, for example with nginx and fcgiwrap, 26as a user that can read the list archives, and serve style.css and 27icon.svg from share/herbarium. Only lists that contain a public file 28are shown. See herbarium(1) for an example configuration. 29 30To fetch a thread with b4: 31 32 git config b4.midmask https://lists.example.org/list/%s 33 b4 am <message-id> 34 35 36Configuration 37------------- 38The configuration of herbarium is done by creating a custom config.h 39and (re)compiling the source code.