website/news/website-launched.mdwn

   1 # The monkeysphere web site is launched! #
   2
   3 dkg registered monkeysphere.info and monkesphereproject.net (due to the
   4 failure of Chase to implement the monkeysphere, they were not able to properly
   5 verify my credit card number).
   6
   7 And ... they are both now resolving to an actual real web site.
   8
   9 I just took the following steps to put the web site in place (skip to the
  10 bottom to see what this all means if you want to modify the web site):
  11
  12  * Created a new subdirectory of my git repo: website
  13
  14  * Copied the default files for setting up an ikiwiki software project into
  15  this repository.
  16
  17  * I deleted the contact page, Makefile (for generating a html
  18  doc directory for the project), and documentation page. I'm not opposed to
  19  these pages, I was just in a hurry to get something published and wasn't sure
  20  what to do with these files. We can always add them later.
  21
  22  * I edited the remaining files to reflect the project (as best I could).
  23
  24  * I created a user and web directory on the same server as my published
  25  monkeysphere git repository.
  26
  27  * I created a clone of my monkeysphere git repository owned by this new user.
  28
  29  * I created an ikiwiki setup file that:
  30   * Specifies the clone as the "srcdir"
  31
  32   * Specifies my new web directory as the web directory
  33
  34   * Generates a setuid binary, owned by the web directory owner, that will
  35                 update the src repo and re-generate the web pages.
  36
  37  * In my published git repo, I added this setuid binary file to my
  38  post-update script so that when I push to my git repo, it will trigger
  39  ikiwiki to auto-generate the html
  40
  41 What does this all means if you want to edit the web site?
  42
  43 At the moment, we're betraying our all-distributed, all-the-time mode of
  44 operations. I'm acting as the web manager (kinda like a release manager).
  45
  46 That means that if you want a web site change, you should publish it to your
  47 git repo and then let me know. Then, I pull in your change and push it to my
  48 published repo which in turn pushes it to the web site.
  49
  50 Also - of note - web edits are not allowed, although that's technically
  51 possible with ikiwiki.
  52
  53 In general, I'm going with simplicity first - we can get more fancy later.
  54
  55 Oh... the files are written in the markdown language, which is ikiwiki default
  56 (http://daringfireball.net/projects/markdown/syntax).
  57