+----------------------------------------------------------------------------+
|                   #####\    ######\     #####\    #######\                 |
|                  ##\\\##\   ##\\\##\   ##\\\##\   ##\\\\\\                 |
|                  ##\  \\\   ##\  ##\   ##\  \\\   ##\                      |
|                  ##\        ##\  ##\   ##\        ##\                      |
|                  \#####\    ######\\   ##\        ######\                  |
|                   \\\\##\   ##\\\##\   ##\        ##\\\\\                  |
|                       ##\   ##\  ##\   ##\        ##\                      |
|                  ##\  ##\   ##\  ##\   ##\  ##\   ##\                      |
|                  \#####\\   ##\  ##\   \#####\\   ##\                      |
|                   \\\\\\    \\\  \\\    \\\\\\    \\\                      |
+----------------------------------------------------------------------------+
|                       Student-Run Computing Facility                       |
|                               Gopher service                               |
+----------------------------------------------------------------------------+


PUBLISHING YOUR GOPHER SITE -- a simple how-to guide

- Create a subdirectory of your home directory called 'public_gopher'
     For example:         /public/home/spqr2/public_gopher
     Or, for a society:   /public/societies/foosoc/public_gopher

- Files placed in this directory will be served via Gopher at
     (user accounts:)     gopher://gopher.srcf.net/1/users/spqr2
     (society accounts:)  gopher://gopher.srcf.net/1/societies/foosoc

- It's as easy as that!


CUSTOMISING THE DIRECTORY LISTING

- To attach a description (or "abstract") to a file, say 'myfile.txt', create
  another file called 'myfile.txt.abstract' with a line or two of descriptive
  text.  This will be displayed with any links to that file.
- If you put a file called .absract in a directory then the descriptive text in
  it will be displayed on links to that file. i.e. if you put a file called
  .abstract in your public_gopher direcotry then the descriptive text in it
  will appear on the listing of users/societies.


ADVANCED CUSTOMISATION

- It is possible to replace the automatic directory listing with a custom
  menu or "gophermap".

- For a brief introduction, see
  gopher://gopher.srcf.net/0/gophermap-info.txt

USEFUL COMMANDS

- Converting from a html site to a gopher site
     html2text -nobs -style pretty -o <outputfile>.txt <inputfile>
     The -exec section of the find runes that convert .html files to .txt ones
     Only run this on the .html files, it does NOT work for .pdf, .jpg etc.
         -exec html2text -o <outputfolder>'{}'.txt -nobs -style pretty '{}' \;

QUESTIONS?

- If you require any help with this new, state-of-the-art service please
  contact the support team: [email protected]