Describe -c 3down

[wiki.git] / projects / www.mdwn

diff --git a/projects/www.mdwn b/projects/www.mdwn
index 5d35a2f24b8ec4cfb686772662c22aaf3bfcf574..2d8c2a78783d990766ebd119a0c363a2ebde2db5 100644 (file)
--- a/projects/www.mdwn
+++ b/projects/www.mdwn
@@ -18,7 +18,8 @@
 * other widgets
 * migrate sipb.mit.edu/doc
 * usability tests
 * other widgets
 * migrate sipb.mit.edu/doc
 * usability tests

-* table of contents doesn't work
+* table of contents doesn't work. Likely to do with the co-opting of h1 
+exclusively for breadcrumbs ... 

 
 ### Done
 * commit zephyrs for git (ikiwiki.git)
 
 ### Done
 * commit zephyrs for git (ikiwiki.git)


@@ -29,7 +30,6 @@
 
 ## How Things Work
 
 
 ## 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 it's handled by b-m or b-k, whichever).
 
 ###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 it's handled by b-m or b-k, whichever).


@@ -39,7 +39,7 @@ after each edit.
 
 ###For development's sake:
 
 
 ###For development's sake:
 

-####How Do I make edits?
+####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/git/wiki", make your edits in the mdwn, etc.
 
 When you commit, ikiwiki should get automatically republished as HTML.
 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/git/wiki", make your edits in the mdwn, etc.
 
 When you commit, ikiwiki should get automatically republished as HTML.


@@ -56,8 +56,14 @@ To work on the code surrounding the wiki in addition to the wikitext, clone the
     .
     |-- Scripts
     |   |-- wiki: the published HTML that you are being served right now
     .
     |-- Scripts
     |   |-- wiki: the published HTML that you are being served right now

+    |   |-- wiki-cgi: CGI scripts for the wiki

     |   \-- writable: directory containing files writable by scripts
     |                 dotfiles such as .bash_history are symlinked here
     |   \-- writable: directory containing files writable by scripts
     |                 dotfiles such as .bash_history are symlinked here

+    |-- git
+    |   |-- sipb-www.git: the master repo; other repos are submodules
+    |   |-- wiki.git: home of the wiki content as markdown, etc
+    |   \-- ikiwiki.git: the repo for SIPB's local variation on ikiwiki
+    |-- checkout: automatically updated checkout of sipb-www.git

     |-- arch
     |   \-- amd64_fedora9_scripts: binaries related to publishing ikiwiki
     |-- bin, lib, sbin: links into arch
     |-- arch
     |   \-- amd64_fedora9_scripts: binaries related to publishing ikiwiki
     |-- bin, lib, sbin: links into arch


@@ -72,20 +78,15 @@ To work on the code surrounding the wiki in addition to the wikitext, clone the
     |   |-- ikiwiki.setup: configuration for ikiwiki
     |   `-- src: where ikiwiki checks out wiki.git for building
     |-- src
     |   |-- ikiwiki.setup: configuration for ikiwiki
     |   `-- src: where ikiwiki checks out wiki.git 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
+    |   \-- cgit: where cgit was built from (not actively changed)

     |-- web_scripts
     |   |-- cgit: what you look at when you click on "History"
     |   |-- doc: the old Trac wiki
     |   |-- radiant: old and irrelevant
     |   |-- rtfm: contains an index.html identical to rtfm.html below
     |   `-- sipb: the document root for sipb.mit.edu
     |-- web_scripts
     |   |-- cgit: what you look at when you click on "History"
     |   |-- doc: the old Trac wiki
     |   |-- radiant: old and irrelevant
     |   |-- rtfm: contains an index.html identical to rtfm.html below
     |   `-- sipb: the document root for sipb.mit.edu

-    |       `-- _wiki -> ../../Scripts/wiki
-    |-- 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.
-
+    |       |-- _wiki -> ../../Scripts/wiki
+    |       `-- _wiki-cgi -> ../../Scripts/wiki-cgi
+    \-- web_scripts_tmp: old directory around to keep trac up-to-date. Should
+                         vanish sooner or later