summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAmin Bandali <bandali@gnu.org>2020-05-13 23:37:54 -0400
committerAmin Bandali <bandali@gnu.org>2020-05-13 23:37:54 -0400
commite88a791ce3786d0a96944266e5db6d4d164e23e0 (patch)
treecb46cb5eb3fd82cb6dd2fedce05c9edf3c6ab9e5
parent253d80c710f44d6068c9854586c32808c428919c (diff)
downloademacsconf-wiki-e88a791ce3786d0a96944266e5db6d4d164e23e0.tar.xz
emacsconf-wiki-e88a791ce3786d0a96944266e5db6d4d164e23e0.zip
add info and config for old oddmuse wiki to colophon
-rw-r--r--colophon.md4
-rw-r--r--colophon/oddmuse-config.md232
-rw-r--r--colophon/oddmuse-version.md52
3 files changed, 288 insertions, 0 deletions
diff --git a/colophon.md b/colophon.md
index c4c71a21..b4bbc0f8 100644
--- a/colophon.md
+++ b/colophon.md
@@ -17,6 +17,10 @@ additional useful features. Most notably, we used the
[Namespaces](//oddmuse.org/wiki/Namespaces_Extension) module to allow
creation of what are in effect sub-wikis for each conference year.
+You can see the list of extensions we used to use, along with their
+versions, at [[oddmuse-version]]; and a copy of the latest config file
+we used along with other related files at [[oddmuse-config]].
+
As nice as Oddmuse is, we found the lack of proper nested pages rather
limiting for our use-case, and have since switched to using ikiwiki
for this wiki.
diff --git a/colophon/oddmuse-config.md b/colophon/oddmuse-config.md
new file mode 100644
index 00000000..49bb03a1
--- /dev/null
+++ b/colophon/oddmuse-config.md
@@ -0,0 +1,232 @@
+## config
+
+```
+# -*- mode: perl -*-
+use utf8; # this file contains utf8 strings.
+do "$ENV{OMHOME}/omecp.pl";
+
+$CookieName = 'ECwiki';
+$SiteName = 'EmacsConf';
+$HomePage = 'main';
+$RCName = "recent_changes";
+$FullUrl = 'https://emacsconf.org';
+$ScriptName = "$FullUrl";
+# $LogoUrl = '/s/emacsconf-logo1-64.png';
+$StyleSheet = '/s/ecom.css';
+$UploadAllowed = 1;
+
+#$SurgeProtectionTime = 10;
+#$SurgeProtectionViews = 50;
+
+# As we're now behind a caching proxy, the environment variable
+# REMOTE_ADDR is no longer what we want. We now want
+# HTTP_X_FORWARDED_FOR.
+$ENV{REMOTE_ADDR} = $ENV{HTTP_X_FORWARDED_FOR};
+
+$HtmlHeaders .= '<link rel="icon" href="/s/emacsconf-logo1-256.png" type="image/png"/>'
+ . '<meta name=viewport content="width=device-width, initial-scale=0.86, maximum-scale=3.0, minimum-scale=0.86"/>';
+
+$SmartTitlesBrowserTitle = '%s - %s - %s';
+$SmartTitlesBrowserTitleWithoutSubtitle = '%s - %s';
+
+$FooterNote = '<p>Permission is granted to copy, distribute and/or
+modify this document under the terms of the
+<a href="https://www.gnu.org/licenses/fdl-1.3-standalone.html">GNU Free Documentation License</a>,
+Version 1.3 or any later version published by the
+<a href="https://www.fsf.org/">Free Software Foundation</a>.</p>
+<p style="font-size:70%"><a href="https://emacsconf.org/colophon">Colophon</a></p>';
+
+$UrlProtocols .= "|data|xmpp";
+
+@UserGotoBarPages = ($RCName);
+# $UserGotoBar = '<a class="local" href="https://emacsconf.org/2019/">2019</a>';
+
+$UserGotoBarPrev = '<a class="local" href="https://emacsconf.org">EmacsConf</a>';
+sub GetGotoBar {
+ my $id = shift;
+ return $q->span({-class=>'gotobar bar'},
+ $UserGotoBarPrev,
+ (map { GetPageLink($_) } @UserGotoBarPages),
+ $UserGotoBar);
+}
+
+# Allow namespaces starting with a digit
+# From https://github.com/kensanata/oddmuse/issues/19#issuecomment-503984930
+$InterSitePattern = '[\p{Uppercase}\d][\w_ ]*';
+# Redefine these as well if you change $InterSitePattern since InitLinkPatterns is called before InitConfig!
+$InterLinkPattern = "($InterSitePattern:[-a-zA-Z0-9\x{0080}-\x{fffd}_=!?#\$\@~`\%&*+\\/:;.,]*[-a-zA-Z0-9\x{0080}-\x{fffd}_=#\$\@~`\%&*+\\/])$QDelim";
+$FreeInterLinkPattern = "($InterSitePattern:[-a-zA-Z0-9\x{0080}-\x{fffd}_=!?#\$\@~`\%&*+\\/:;.,()' ]+)";
+
+# Link to author page at the root namespace
+# From https://github.com/kensanata/oddmuse/issues/20#issuecomment-500402339
+sub GetAuthorLink {
+ my ($username, $host) = @_;
+ $username = FreeToNormal($username);
+ $username =~ s/^(?:$InterSitePattern:)?$FreeLinkPattern/$1/;
+ my $name = NormalToFree($username);
+ if (ValidId($username) ne '') { # ValidId() returns error string
+ $username = ''; # Just pretend it isn't there.
+ }
+ if ($username) {
+ local $ScriptName = $NamespacesRoot;
+ return ScriptLink(UrlEncode($username), $name, 'author');
+ }
+ return T('Anonymous') if $host eq 'Anonymous';
+ return ColorCode($host);
+}
+
+# Fix visiting Main:X if the page doesn't exist but namespace X does.
+# Redirect!
+# From https://github.com/kensanata/oddmuse/issues/19#issuecomment-513640039
+push(@MyInitVariables, \&MyNamespacesFix);
+sub MyNamespacesFix {
+ if (not GetParam('title', '')
+ and GetParam('action', 'browse') eq 'browse') {
+ my $id = FreeToNormal(GetId());
+ if (not $NamespaceCurrent
+ and (not $IndexHash{$id}
+ or OpenPage($id) and PageMarkedForDeletion())
+ and $Namespaces{$id}) {
+ print GetRedirectPage("$id/", NormalToFree($id));
+ exit;
+ }
+ }
+};
+
+@QuestionaskerQuestions =
+ (['Please say HELLO.' => sub {
+ shift =~ /^\s*(hello*|hewo*|hi*|h(i|e)ya*)!*\s*$/i }],
+ );
+
+# If enabling Markdown, to allow users to switch between Creole and Markdown
+# see https://oddmuse.org/wiki/Creole_or_Markdown
+
+$CommentsPrefix = 'comments_on_';
+
+# Add 'Back to ' prefix to the link back to the article
+# with adaptation from https://oddmuse.org/wiki/Comments_on_Comment_Pages
+*MyOldGetFooterLinks = *GetFooterLinks;
+*GetFooterLinks = *MyNewGetFooterLinks;
+
+sub MyNewGetFooterLinks {
+ my $html = MyOldGetFooterLinks(@_);
+ my ($id, $rev) = @_;
+ if ($id and $rev ne 'history' and $rev ne 'edit'
+ and $CommentsPrefix) {
+ if ($id =~ /^$CommentsPrefix(.*)/o) {
+ my $from = NormalToFree($1);
+ my $to = T('Back to ') . $from;
+ $html =~ s/>$from</ accesskey="a">$to</;
+ } else {
+ my $from = NormalToFree($CommentsPrefix);
+ my $to = T('Comments on ');
+ $html =~ s/$from/$to/;
+ }
+ }
+ # $html =~ s!</div>! <a class="local" href="https://emacsconf.org/colophon">Colophon</a></div>!;
+ return $html;
+}
+
+# [[vid:addr]] rule for embedding videos
+push(@MyRules, \&VidRule);
+
+sub VidRule{
+ if (/\G\[\[vid:(\d+\/[a-z0-9-_\.]*)\]\]/cgi) {
+ my $vid = $1;
+ return qq{
+<video controls preload="metadata">
+ <source src="/videos/$vid" type="video/mp4">
+</video><br/>
+<a href="/videos/$vid" download>Download</a>};
+ }
+ return;
+}
+
+# [[vidlink:addr]] rule for linking to videos
+push(@MyRules, \&VidLinkRule);
+
+sub VidLinkRule{
+ if (/\G\[\[vidlink:(\d+\/[a-z0-9-_\.]*)\|(.*)\]\]/cgi) {
+ my ($vid, $cap) = ($1, $2);
+ return qq{<a href="/videos/$vid">$cap</a>};
+ }
+ return;
+}
+```
+
+## server.conf
+
+```conf
+{
+ hypnotoad => {
+ listen => ['http://127.0.0.1:11937'],
+ workers => 10
+ }
+};
+```
+
+## server.pl
+
+```perl
+#!/usr/bin/env perl
+
+# Copyright (C) 2015-2016 Alex Schroeder <alex@gnu.org>
+
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free Software
+# Foundation, either version 3 of the License, or (at your option) any later
+# version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along with
+# this program. If not, see <http://www.gnu.org/licenses/>.
+
+use Mojolicious::Lite;
+
+# This needs to be in a different section, sometimes?
+plugin CGI => {
+ support_semicolon_in_query_string => 1,
+};
+
+plugin CGI => {
+ # route => '/wiki',
+ route => '/',
+ # We need this for older versions of Mojolicious::Plugin::CGI
+ script => 'wiki.pl',
+ run => \&OddMuse::DoWikiRequest,
+ before => sub {
+ no warnings;
+ $OddMuse::RunCGI = 0;
+ # The default data directory is determined by the environment variable
+ # WikiDataDir and falls back to the following
+ # $OddMuse::DataDir = '/tmp/oddmuse';
+ use warnings;
+ require './build/wiki.pl' unless defined &OddMuse::DoWikiRequest;
+ },
+ env => {
+ "OMHOME" => "/home/omec"
+ },
+ # path to where STDERR from cgi script goes
+ errlog => ($ENV{WikiDataDir} || '/tmp/oddmuse')
+ . "/wiki.log",
+};
+
+#plugin SetUserGroup => {user => "omec", group => "omec"};
+
+#get '/' => sub {
+# my $self = shift;
+# $self->redirect_to('/wiki');
+#};
+
+app->plugin('Config');
+app->start;
+```
+
+## ~/omecp.pl
+
+```perl
+$AdminPass = 'redacted';
+```
diff --git a/colophon/oddmuse-version.md b/colophon/oddmuse-version.md
new file mode 100644
index 00000000..35148145
--- /dev/null
+++ b/colophon/oddmuse-version.md
@@ -0,0 +1,52 @@
+<pre>
+<a href="https://alexschroeder.ch/cgit/oddmuse/tag/?id=2.3.14-25-g2cba2d30">wiki.pl</a> (2.3.14-25-g2cba2d30), see <a href="https://www.oddmuse.org">Oddmuse</a>
+
+<a href="https://alexschroeder.ch/cgit/oddmuse/tree/modules/anchors.pl?2.3.14-25-g2cba2d30">anchors.pl</a> (2.3.14-25-g2cba2d30), see <a href="https://www.oddmuse.org/wiki/Local_Anchor_Extension">Local Anchor Extension</a>
+
+<a href="https://alexschroeder.ch/cgit/oddmuse/tree/modules/creole.pl?2.3.14-25-g2cba2d30">creole.pl</a> (2.3.14-25-g2cba2d30), see <a href="https://www.oddmuse.org/wiki/Creole_Markup_Extension">Creole Markup Extension</a>
+
+<a href="https://alexschroeder.ch/cgit/oddmuse/tree/modules/div-foo.pl?2.3.14-25-g2cba2d30">div-foo.pl</a> (2.3.14-25-g2cba2d30), see <a href="https://www.oddmuse.org/wiki/Div_Foo_Extension">Div Foo Extension</a>
+
+<a href="https://alexschroeder.ch/cgit/oddmuse/tree/modules/image.pl?2.3.14-25-g2cba2d30">image.pl</a> (2.3.14-25-g2cba2d30), see <a href="https://www.oddmuse.org/wiki/Image_Extension">Image Extension</a>
+
+<a href="https://alexschroeder.ch/cgit/oddmuse/tree/modules/markup.pl?2.3.14-25-g2cba2d30">markup.pl</a> (2.3.14-25-g2cba2d30), see <a href="https://www.oddmuse.org/wiki/Markup_Extension">Markup Extension</a>
+
+<a href="https://alexschroeder.ch/cgit/oddmuse/tree/modules/namespaces.pl?2.3.14-25-g2cba2d30">namespaces.pl</a> (2.3.14-25-g2cba2d30), see <a href="https://www.oddmuse.org/wiki/Namespaces_Extension">Namespaces Extension</a>
+
+<a href="https://alexschroeder.ch/cgit/oddmuse/tree/modules/questionasker.pl?2.3.14-25-g2cba2d30">questionasker.pl</a> (2.3.14-25-g2cba2d30), see <a href="https://www.oddmuse.org/wiki/QuestionAsker_Extension">QuestionAsker Extension</a>
+
+<a href="https://alexschroeder.ch/cgit/oddmuse/tree/modules/smarttitles.pl?2.3.14-25-g2cba2d30">smarttitles.pl</a> (2.3.14-25-g2cba2d30), see <a href="https://www.oddmuse.org/wiki/Smarttitles_Extension">Smarttitles Extension</a>
+
+<a href="https://alexschroeder.ch/cgit/oddmuse/tree/modules/tables.pl?2.3.14-25-g2cba2d30">tables.pl</a> (2.3.14-25-g2cba2d30), see <a href="https://www.oddmuse.org/wiki/Table_Markup_Extension">Table Markup Extension</a>
+
+Mojolicious::Plugin::CGI
+
+Perl v5.28.1
+
+no mod_perl
+
+CGI: 4.40
+
+LWP::UserAgent 6.36
+
+XML::RSS: 1.59
+
+XML::Parser: 2.44
+
+diff (GNU diffutils) 3.7
+Copyright (C) 2018 Free Software Foundation, Inc.
+License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+
+Written by Paul Eggert, Mike Haertel, David Hayes,
+Richard Stallman, and Len Tower.
+
+diff3 (GNU diffutils) 3.7
+Copyright (C) 2018 Free Software Foundation, Inc.
+License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+
+Written by Randy Smith.
+</pre>