summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Schwinge <thomas@codesourcery.com>2013-04-13 11:30:04 +0200
committerThomas Schwinge <thomas@codesourcery.com>2013-04-13 11:30:04 +0200
commit7e73314d273969ea29cb35bf1b75b6a84d599beb (patch)
treeecece6d5c69fad2eddfe9d02dc360ffec0b0d7c9
parentbbfdc0018e51ad03f2948c6ad41bf0265d582741 (diff)
Document the move from flubber, snubber to darnassus some more.
-rw-r--r--colophon.mdwn26
-rw-r--r--public_hurd_boxen/installation.mdwn14
-rw-r--r--public_hurd_boxen/installation/darnassus.mdwn74
3 files changed, 103 insertions, 11 deletions
diff --git a/colophon.mdwn b/colophon.mdwn
index a9a2952e..2a0dd119 100644
--- a/colophon.mdwn
+++ b/colophon.mdwn
@@ -1,4 +1,4 @@
-[[!meta copyright="Copyright © 2003, 2004, 2007, 2008, 2009 Free Software
+[[!meta copyright="Copyright © 2003, 2004, 2007, 2008, 2009, 2013 Free Software
Foundation, Inc."]]
[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
@@ -6,16 +6,17 @@ id="license" text="Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no Invariant
Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
-is included in the section entitled
-[[GNU Free Documentation License|/fdl]]."]]"""]]
+is included in the section entitled [[GNU Free Documentation
+License|/fdl]]."]]"""]]
-Just like a book, this topic is designed to help describe the tools used to
+Just as in a book, this page is designed to help describe the tools used to
create this website and what methods were used to give it its look and feel.
What we see today is the junction of two different branches: the original
static HTML pages and the wiki pages.
+
# Static HTML Pages
In November 2008, the Hurd's old static web pages were merged into the wiki
@@ -23,6 +24,7 @@ pages' repository. After a lot of cleansing work, on 2008-11-22 the joined set
of pages was made available for serving the official GNU Hurd web appearance at
<http://www.gnu.org/software/hurd/>.
+
# Wiki Pages
## Rev. I
@@ -52,6 +54,7 @@ timely fashion anymore. In July 2006, the [slow burial of the Hurd
Wiki](http://lists.gnu.org/archive/html/bug-hurd/2006-07/msg00014.html) was
announced.
+
## Rev. II
Considering this [from April 2006 on
@@ -60,5 +63,16 @@ already](http://lists.gnu.org/archive/html/web-hurd/2006-04/msg00000.html), on
[ikiwiki](http://ikiwiki.info) was finally finished. Read
[[about_the_twiki_to_ikiwiki_conversion]].
-This wiki instance is now running distributed over two GNU/Hurd machines, and
-is also providing the content of the official GNU Hurd pages.
+This wiki instance was running distributed over two GNU/Hurd machines,
+[[flubber|public_hurd_boxen]] (Git repository) and
+[[snubber|public_hurd_boxen]] (web server), both hosted by Barry deFreese.
+
+The wiki's content also provides that of the official GNU Hurd pages,
+<http://www.gnu.org/software/hurd/>.
+
+
+## Rev. III
+
+As of early 2013, both flubber and snubber's duties are [[!message-id
+"87vc9417dc.fsf@kepler.schwinge.homeip.net" desc="taken over"]] by Richard
+Braun's [[darnassus|public_hurd_boxen]].
diff --git a/public_hurd_boxen/installation.mdwn b/public_hurd_boxen/installation.mdwn
index 4f612a83..04ab5cd8 100644
--- a/public_hurd_boxen/installation.mdwn
+++ b/public_hurd_boxen/installation.mdwn
@@ -1,4 +1,5 @@
-[[!meta copyright="Copyright © 2009, 2010 Free Software Foundation, Inc."]]
+[[!meta copyright="Copyright © 2009, 2010, 2013 Free Software Foundation,
+Inc."]]
[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
id="license" text="Permission is granted to copy, distribute and/or modify this
@@ -8,10 +9,12 @@ Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
is included in the section entitled [[GNU Free Documentation
License|/fdl]]."]]"""]]
-This page documents how installation of a new machine is being done on
-[[zenhost]].
+This page documents how installation of some new machines is being done.
-This method uses
+
+# [[zenhost]]
+
+For those on [[zenhost]], we use
*[install_crosshurd](http://git.savannah.gnu.org/cgit/hurd/incubator.git/log/?h=install_crosshurd)*.
Another option might be switching to <http://www.informatik.uni-koeln.de/fai/>
@@ -126,3 +129,6 @@ Steps for *install_crosshurd*:
* [[flubber]]
* [[snubber]]
+
+
+# [[darnassus]]
diff --git a/public_hurd_boxen/installation/darnassus.mdwn b/public_hurd_boxen/installation/darnassus.mdwn
index 156e40c2..3beb2c87 100644
--- a/public_hurd_boxen/installation/darnassus.mdwn
+++ b/public_hurd_boxen/installation/darnassus.mdwn
@@ -8,6 +8,76 @@ Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
is included in the section entitled [[GNU Free Documentation
License|/fdl]]."]]"""]]
+/!\ Incomplete, but hopefully helpful for future reference.
+
+
+# Packages
+
+ * apache2-mpm-worker
+
+ * ikiwiki libcgi-session-perl libtext-csv-perl libcgi-formbuilder-perl
+ libauthen-passphrase-perl libnet-openid-consumer-perl
+ liblwpx-paranoidagent-perl libterm-readline-gnu-perl libgravatar-url-perl
+ librpc-xml-perl libtext-wikiformat-perl libhighlight-perl perlmagick
+ graphviz texinfo
+
+ * libemail-send-perl (for my *sendmail vs. ikiwiki* patch)
+
+ * libsearch-xapian-perl xapian-omega (for ikiwiki's search plugin)
+
+ * libyaml-perl libyaml-syck-perl (for ikiwiki's YAML field plugins)
+
+ * gitweb
+
+ sudo ln -s ~hurd-web/hurd-web.git /var/cache/git/
+
+ * git-daemon-sysvinit
+
+ Enable as per `/usr/share/doc/git-daemon-sysvinit/README.Debian`. Also set
+ `GIT_DAEMON_OPTIONS=--user-path`, and `GIT_DAEMON_DIRECTORY='/var/cache/git
+ /home'`. TODO: does not work if `ok_paths` is set, which it is by default.
+
+
+# `~hurd-web/`
+
+ $ mkdir hurd-web.git && GIT_DIR=hurd-web.git git init
+
+
+# `~tschwinge/`
+
+/!\ TODO.
+
+ $ mkdir tmp/backup && chmod 0733 tmp/backup
+
+
+# `/var/www/robots.txt`
+
+/!\ TODO.
+
+This file used to contain:
+
+ User-agent: *
+ Disallow: /gitweb/
+ Disallow: /cgi-bin/
+
+... which I've now changed to:
+
+ User-agent: *
+ Disallow: /
+
+The goal is that robots rather index the official pages,
+<http://www.gnu.org/software/hurd/>, instead of the staging area on
+<http://darnassus.sceen.net/~hurd-web/>.
+
+
+# Restore Backup
+
+/!\ TODO.
+
+## `/etc/apache2/mods-enabled/`
+
+`rewrite.load`, `userdir.conf`, `userdir.load`
+
# IRC, freenode, #hurd, 2013-02-09
@@ -167,4 +237,6 @@ License|/fdl]]."]]"""]]
<braunr> history for example
<braunr> just fyi, we can look at this tomorrow
<tschwinge> braunr: Yes, that'S what I need gitweb for.
- <tschwinge> braunr: gitweb installed, hurd-web URLs fixed (s%bddebian%darnassus), also some more ikiwiki-related Perl pacakges installed (openID login, for example).
+ <tschwinge> braunr: gitweb installed, hurd-web URLs fixed
+ (s%bddebian%darnassus), also some more ikiwiki-related Perl pacakges
+ installed (openID login, for example).