X-Git-Url: https://sipb.mit.edu/gitweb.cgi/wiki.git/blobdiff_plain/762d0f8bd1607c6c6f7021c3c2f07acd1ff80e98..0f8cf12a34a77dc6c826f49f3a49f139f17c40aa:/projects/www.mdwn diff --git a/projects/www.mdwn b/projects/www.mdwn index 17dad14..421c865 100644 --- a/projects/www.mdwn +++ b/projects/www.mdwn @@ -1,84 +1,104 @@ [[!meta title="The SIPB Website"]] +[[!toc ]] ## 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 +* editing pages adds lots of extra slashes to the path + +### 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... ## 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). + 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). -vhost configuration on scripts looks in ~~sipb-ww/web_scripts and checks the .htaccess file: +scripts has a special vhost config (/etc/httpd/vhost.d/sipb.conf) for +sipb.mit.edu: -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 + 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. -###For developments sake: +###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: -When you commit, ikiwiki should get automatically republished as HTML + $ 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: 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 + . + |-- Scripts + | \-- writable: directory containing files writable by scripts + | dotfiles such as .bash_history are symlinked here + |-- arch + | \-- amd64_fedora9_scripts: binaries related to publishing ikiwiki + |-- bin, lib, sbin: links into arch + |-- 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: think of it as like a mix of etc and build + | |-- cgitrc : configuration for cgit + | |-- 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 + |-- web_scripts + | |-- 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 + |-- 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.