Added a skeleton + some meat of workings. Please fix if broken
[wiki.git] / projects / www.mdwn
1 [[!meta title="The SIPB Website"]]
2
3 ## Design
4
5 * 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)
6 * Too much wasted space on the left side
7 * Too much wasted space on the top
8 * Too grey
9 * Blocks of color are gratuitous and jarring
10 * Gradients are gratuitous
11 * A design that could be reused for other websites with minor color tweaking would be nice (like the Debathena stylesheet)
12 * Rectangles and straight lines make it look angular and stark
13 * The design is too generic; needs more SIPB personality, so that another website couldn't just be swapped in
14 * Consider rebranding possibilities (e.g. making fuzzball more "internal" like octocat on github, developing new logos, etc.) (publicity opportunities)
15
16 ## Todo
17
18 * git push (scripts-git, or gitosis on an XVM)
19 * commit zephyrs for git (wiki.git and ikiwiki.git)
20 * breadcrumbs style
21 * make style usable for other SIPB sites?
22 * make title == alt on images
23 * sipb-door widgets
24 * other widgets
25 * migrate sipb.mit.edu/doc
26 * usability tests
27
28 ## How Things Work
29
30 (this is by fawkes's understanding, it may be wrong)
31
32 ###When a request comes in:
33  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).
34
35 vhost configuration on scripts looks in ~~sipb-ww/web_scripts and checks the .htaccess file:
36
37 if request is for /rtfm.html, pass through
38 if request is for /iap pass of to stuff/iap (lives in  /afs/athena.mit.edu/activity/s/sipb-iap/www/ of all place) 
39 if request if for /cgit, or /wiki pass through
40 else pass request for foo to wiki/foo, served from there
41
42
43 ###For developments sake:
44
45 ####How Do I make edits?
46 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.
47
48 When you commit, ikiwiki should get automatically republished as HTML
49
50
51 ####Detailed Locker Layout
52
53 .
54 |-- Scripts: was being used for scripts.git, currently unused
55 |-- arch
56 |   \-- amd64_fedora9_scripts: binaries related to publishing ikiwiki
57 |-- bin, lib, sbin: links into arch
58 |-- ikiwiki
59 |-- man: a link into arch, ikiwiki manpages. add sipb-www to get them into MANPATH
60 |-- share -> arch/amd64_fedora9_scripts/share
61 |   |-- ikiwiki: where some basic things are pulled from during build
62 |   |-- locale: i18n things we aren't using
63 |   `-- man: where the manpages really live
64 |-- ikiwiki: thing of it as like a mix of etc and build
65 |   |-- cgitrc : configuration for cgit
66 |   |-- ikiwiki.setup: configuration for ikiwiki
67 |   `-- src: where the git repo (wiki.git) is staged for building
68 |-- src
69 |   |-- cgit: where cgit was built from (not actively changed)
70 |   |-- ikiwiki.git: the git repository representing the SIPB variation on ikiwiki. 
71 |   `-- old.ikiwiki: irrelevant
72 |-- web_scripts
73 |   |-- RCS: .htaccess mus be versioned
74 |   |-- cgit: what you look at when you click on "History"
75 |   |-- doc: the old Trac Wiki
76 |   |-- iap -> /mit/sipb-iap/www
77 |   |-- radiant: old and irrelevant
78 |   |-- rtfm: contains an index.html identical to rtfm.html below
79 |   |-- rtfm.html: served for rtfm.mit.edu:80
80 |   `-- wiki: the published HTML that you are being served right now
81 |-- web_scripts_tmp: old directory around to keep trac up-to-date. Should vanish sooner or later
82 `-- wiki.git: this is where all the content lives as markdown. Clone this if you hate web interfaces
83
84