X-Git-Url: https://sipb.mit.edu/gitweb.cgi/wiki.git/blobdiff_plain/630011badb2935392ff4188fe8b84ef3f43b2aed..2365a91330732e427c440de93cc398a7c4a4cc1c:/projects/www.mdwn

diff --git a/projects/www.mdwn b/projects/www.mdwn
index 2476615..a4cf452 100644
--- a/projects/www.mdwn
+++ b/projects/www.mdwn
@@ -4,29 +4,25 @@
 ## Design
 
 * The design is equivalent to the old design, just with the design trends of the current time (alternatively, built in the 21st century, but without sufficient design clue)
-* Too much wasted space on the left side
-* Too much wasted space on the top
-* Too grey
-* Blocks of color are gratuitous and jarring
-* Gradients are gratuitous
-* A design that could be reused for other websites with minor color tweaking would be nice (like the Debathena stylesheet)
+* What do we put on the right side?
 * Rectangles and straight lines make it look angular and stark
-* The design is too generic; needs more SIPB personality, so that another website couldn't just be swapped in
+* The design is too generic; needs more SIPB personality, so that another website couldn't just be swapped in (Define SIPB personality)
 * Consider rebranding possibilities (e.g. making fuzzball more "internal" like octocat on github, developing new logos, etc.) (publicity opportunities)
 
 ## Todo
 
 * git push (scripts-git, or gitosis on an XVM)
-* commit zephyrs for git (wiki.git and ikiwiki.git)
-* breadcrumbs style
 * make style usable for other SIPB sites?
 * make title == alt on images
 * sipb-door widgets
 * other widgets
 * migrate sipb.mit.edu/doc
 * usability tests
+* table of contents doesn't work
 
 ### Done
+* commit zephyrs for git (ikiwiki.git)
+* breadcrumbs style
 * add a grumpy fuzzball favicon to replace the ikiwiki one.
   * feel free to make a better one if you like ~fawkes
 * all those other things we did before putting our todo here...
@@ -38,32 +34,28 @@
 ###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).
 
-scripts has a special vhost config (/etc/httpd/vhost.d/sipb.conf) for
-sipb.mit.edu:
-
-        DocumentRoot /afs/sipb.mit.edu/project/sipb-www/web_scripts/wiki
-        Alias /doc /afs/sipb.mit.edu/project/sipb-www/web_scripts/doc
-        Alias /iap /afs/sipb.mit.edu/project/sipb-www/web_scripts/iap
-        Alias /cgit /afs/sipb.mit.edu/project/sipb-www/web_scripts/cgit
-        Alias /~sipb-www /afs/sipb.mit.edu/project/sipb-www/web_scripts
-
-For our purposes the key line is the first, meaning that URIs not
-falling into an exception are served straight out of
-web_scripts/wiki/.  This directory's contents are generated by ikiwiki
-after each edit, consisting of HTML files and a program ikiwiki.cgi.
+The DocumentRoot for sipb.mit.edu is `/afs/sipb.mit.edu/project/sipb-www/web_scripts/sipb`.  This directory contains a `.htaccess` file that causes most URIs to be served out of `web_scripts/sipb/_wiki`, a symlink to `../../Scripts/wiki`.  This directory's contents are static files generated by ikiwiki
+after each edit.
 
 ###For development's 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.
+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.
 
+To work on the code surrounding the wiki in addition to the wikitext, clone the superrepo:
+
+    $ git clone git+ssh://sipb-www@scripts.mit.edu/mit/sipb-www/git/sipb-www
+    $ cd sipb-www
+    $ git submodule update --init
+
 
 ####Detailed Locker Layout
 
     .
     |-- Scripts
+    |   |-- wiki: the published HTML that you are being served right now
     |   \-- writable: directory containing files writable by scripts
     |                 dotfiles such as .bash_history are symlinked here
     |-- arch
@@ -88,11 +80,10 @@ When you commit, ikiwiki should get automatically republished as HTML.
     |   |-- RCS: .htaccess must 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
+    |   `-- 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.