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
This page uses the following flags.
Letter flags indicate permissions needed by the web server processes:
Flag | Meaning |
---|---|
P | Published as static files by the web server |
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 | 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 |
WP | 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 |
RP* | Apache DocumentRoot, contains single "something is wrong" page |
static |
RP* | static files, maintained outside of TWiki, aliased in Apache |
etc |
R* | misc config files |
misc |
N* | sample files, merged to "doc"; directory removed |
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 |
etc |
reg_htpasswd |
R* | Apache AuthUserFile for registration password |
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 |
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 |