1 Note: The information below about running this wiki on CentOS is out of date. It's now running on Ubuntu using the standard package.
3 To get autolink working using ikiwiki 3.20180228-1 on Ubuntu 18.04:
5 - add `$flags |= Text::Markdown::Discount::MKD_AUTOLINK();` to /usr/share/perl5/IkiWiki/Plugin/mdwn.pm
6 - `cd /srv/wiki-srcdir && ikiwiki --setup wiki.setup`
8 This wiki is running [ikiwiki](http://ikiwiki.info) on CentOS 6 with an [RPM](http://yum.greptilian.com/RPMS/noarch/ikiwiki-3.20120202-1.el6.noarch.rpm) I rebuild from a [ikiwiki Fedora spec file](https://admin.fedoraproject.org/pkgdb/acls/name/ikiwiki). I also had to rebuild a number of dependencies, which you can find at http://yum.greptilian.com
10 After installing the RPMs, I ran `ikiwiki --setup wiki.setup` on [[/wiki.setup]].
12 The source of this wiki ([[markdown]], mostly) is available at http://git.greptilian.com/?p=wiki.git
14 That's where you can find my tweaks to the default page template, for example: http://git.greptilian.com/?p=wiki.git;a=history;f=templates/page.tmpl
16 In order to get autolinking working (MKD_AUTOLINK per http://www.pell.portland.or.us/~orc/Code/discount/ ), I made this change to http://cpansearch.perl.org/src/SEKIMURA/Text-Markdown-Discount-0.02/Discount.xs before running `make`:
18 [pdurbin@server1 Text-Markdown-Discount-0.02]$ diff -u Discount.xs.orig Discount.xs
19 --- Discount.xs.orig 2012-01-01 20:51:51.000000000 -0500
20 +++ Discount.xs 2012-04-21 23:12:45.376580002 -0400
25 - int flags = MKD_NOHEADER|MKD_NOPANTS;
26 + int flags = MKD_NOHEADER|MKD_NOPANTS|MKD_AUTOLINK;
30 [pdurbin@server1 Text-Markdown-Discount-0.02]$
32 As http://ikiwiki.info/plugins/mdwn/ says, ikiwiki prefers to use Text::Markdown::Discount, if it's available.
34 You can subscribe to a feed of updates to this wiki at http://git.greptilian.com/?p=wiki.git;a=atom
36 ## Installing ikiwiki on Mac OS X with local::lib
38 I'm using `perl Makefile.PL INSTALL_BASE= PREFIX=$HOME/perl5` as suggested at http://ikiwiki.info/install/discussion/
40 I installed dependencies with `cpanm`.
42 `make` worked fine but `make install` showed...
44 /bin/sh: msgmerge: command not found
45 unable to run msgmerge
46 /bin/sh: msgfmt: command not found
49 ... so I ran `brew link gettext` per https://github.com/mxcl/homebrew/issues/7621
51 ## Previewing changes to this wiki locally before a git push
54 ikiwiki --setup local.setup
56 python -m SimpleHTTPServer
58 Browse to http://localhost:8000
60 ## Hack on table plugin
62 The following hack is for ikiwiki 3.20130904.1ubuntu1 on Ubuntu 14.04 for when the first column of CSV data starts with a "#" or "##" (such as IRC channels or hashtags) and you don't want h1 or h2 tags. Discuss at http://ikiwiki.info/forum/table_plugin_and_Markdown_side_effects_on_data/
64 root@server2:~# diff -u /usr/share/perl5/IkiWiki/Plugin/table.pm.orig /usr/share/perl5/IkiWiki/Plugin/table.pm
65 --- /usr/share/perl5/IkiWiki/Plugin/table.pm.orig 2013-09-04 18:11:12.000000000 -0400
66 +++ /usr/share/perl5/IkiWiki/Plugin/table.pm 2016-05-29 14:00:50.218858999 -0400
69 push @ret, "\t\t<tr>";
70 for (my $x=0; $x < @data; $x++) {
71 + # hack by pdurbin to avoid #sourcefu becoming <h1>sourcefu</h1>
72 + my $hack = $data[$x];
73 + $hack =~ s/#/#/g;
74 my $cell=IkiWiki::htmlize($page, $destpage, $type,
75 - IkiWiki::preprocess($page, $destpage, $data[$x]));
76 + IkiWiki::preprocess($page, $destpage, $hack));
77 + #IkiWiki::preprocess($page, $destpage, $data[$x]));
79 # automatic colspan for empty cells