From: Donald B Guy <fawkes@mit.edu>
Date: Thu, 15 Jan 2009 11:38:36 +0000 (-0500)
Subject: Added a skeleton + some meat of workings. Please fix if broken
X-Git-Tag: trac-import~18
X-Git-Url: https://sipb.mit.edu/gitweb.cgi/wiki.git/commitdiff_plain/762d0f8bd1607c6c6f7021c3c2f07acd1ff80e98

Added a skeleton + some meat of workings. Please fix if broken
---

diff --git a/projects/www.mdwn b/projects/www.mdwn
index c43cee7..17dad14 100644
--- a/projects/www.mdwn
+++ b/projects/www.mdwn
@@ -24,3 +24,61 @@
 * other widgets
 * migrate sipb.mit.edu/doc
 * usability tests
+
+## How Things Work
+
+(this is by fawkes's understanding, it may be wrong)
+
+###When a request comes in:
+ a connection comes in for sipb.mit.edu which via a hack in MIT DNS gets directed instead to PENGUIN-LUST.MIT.EDU. If its on ports 80, (443?), or 444 it gets passed off to scripts (where its handled by b-m or b-k, whichever).
+
+vhost configuration on scripts looks in ~~sipb-ww/web_scripts and checks the .htaccess file:
+
+if request is for /rtfm.html, pass through
+if request is for /iap pass of to stuff/iap (lives in  /afs/athena.mit.edu/activity/s/sipb-iap/www/ of all place) 
+if request if for /cgit, or /wiki pass through
+else pass request for foo to wiki/foo, served from there
+
+
+###For developments sake:
+
+####How Do I make edits?
+If you want to just edit contents, use the web interface (edit links at bottom of page) or "git clone git+ssh://sipb-www@scripts.mit.edu/mit/sipb-www/wiki.git", make your edits in the mdwn, etc.
+
+When you commit, ikiwiki should get automatically republished as HTML
+
+
+####Detailed Locker Layout
+
+.
+|-- Scripts: was being used for scripts.git, currently unused
+|-- arch
+|   \-- amd64_fedora9_scripts: binaries related to publishing ikiwiki
+|-- bin, lib, sbin: links into arch
+|-- ikiwiki
+|-- man: a link into arch, ikiwiki manpages. add sipb-www to get them into MANPATH
+|-- share -> arch/amd64_fedora9_scripts/share
+|   |-- ikiwiki: where some basic things are pulled from during build
+|   |-- locale: i18n things we aren't using
+|   `-- man: where the manpages really live
+|-- ikiwiki: thing of it as like a mix of etc and build
+|   |-- cgitrc : configuration for cgit
+|   |-- ikiwiki.setup: configuration for ikiwiki
+|   `-- src: where the git repo (wiki.git) is staged for building
+|-- src
+|   |-- cgit: where cgit was built from (not actively changed)
+|   |-- ikiwiki.git: the git repository representing the SIPB variation on ikiwiki. 
+|   `-- old.ikiwiki: irrelevant
+|-- web_scripts
+|   |-- RCS: .htaccess mus be versioned
+|   |-- cgit: what you look at when you click on "History"
+|   |-- doc: the old Trac Wiki
+|   |-- iap -> /mit/sipb-iap/www
+|   |-- radiant: old and irrelevant
+|   |-- rtfm: contains an index.html identical to rtfm.html below
+|   |-- rtfm.html: served for rtfm.mit.edu:80
+|   `-- wiki: the published HTML that you are being served right now
+|-- web_scripts_tmp: old directory around to keep trac up-to-date. Should vanish sooner or later
+`-- wiki.git: this is where all the content lives as markdown. Clone this if you hate web interfaces
+
+