GNHLUG> Main Web>LocalTWikiDocs>TWikiFiles (revision 4)EditAttach

TWiki Files and Directories

This page documents the file and directory structure for the TWiki installation on this server. Relevant only to those ServerPeople with SSH access.

See also: TWikiMods, TWikiPerms

Flags

This page uses the following flags.

Letter flags indicate permissions needed by the web server processes:

Flag Meaning
N None needed (probably should have none)
R Read-only (plus execute of directories)
X Executable as CGI scripts, but not writable
W Writable normally
C Read-only normally, writable during configure
Z Read-only executable CGI during configure, denied normally

Other flags:

Flag Meaning
* Directory/file is new/removed (vs stock TWiki distribution)
@ File is edited to configure the local installation

Directory Structure

Directory Flags Description
doc N* basic admin docs and sample files (moved here from stock)
bin X Perl CGI scripts
lib R TWiki libraries + site config
locale R message catalogs for multiple languages
templates R used by TWiki CGI scripts to generate HTML web pages
data W TWiki pages (served by CGI scripts)
pub W TWiki file attachments (served by web server)
log W* files written by TWiki, set in LocalSite.cfg
log/old W* archived log files, done by logrotate and gnhlug_maint
working W TWiki internal temporary files
tools N non-web maintenance scripts
webroot R* Apache DocumentRoot, contains single "something is wrong" page
static R* static files, maintained outside of TWiki, aliased in Apache
etc R* FIXME
fcgid FIXME FIXME
misc N* sample files, merged to "doc"; directory removed

Notable Files

Directory File Flag Description
bin LocalLib.cfg R@ path to lib (directory with TWiki.pm)
bin setlib.cfg R derives default TWiki paths (normally no edits needed)
bin configure Z CGI script that presents an interactive configuration mechanism
fcgi fcgi.socket FIXME FIXME
lib LocalSite.cfg C@ site configuration, initially written by configure
lib TWiki.pm R main module for TWiki; the CGI scripts are just entry points to this
lib TWiki.spec R documentation and defaults for common LocalSite.cfg options
etc reg_htpasswd R* FIXME
log access W log of every request the TWiki CGI scripts answer
log warn W log of warnings and errors from TWiki CGI scripts
log config W log of actions taken by configure script
static favicon.ico R* "favorite icon" that appears in browser tabs
static gnhlug.css R*@ a small handful of CustomCSS
static robots.txt R@ guidance to crawler software about what to do (or not do) on this site
tools fakecgi N* runs a TWiki script in a simulated CGI environment, for debugging
tools gnhlug_maint N* nightly maintenance wrapper script, run by crontab
webroot index.html R HTML page that says if you can see it, things are broken
Edit | Attach | Watch | Print version | History: r5 < r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r4 - 2023-12-28 - BenScott
 

All content is Copyright © 1999-2025 by, and the property of, the contributing authors.
Questions, comments, or concerns? Contact GNHLUG.
All use of this site subject to our Legal Notice (includes Terms of Service).