add link to bare display
[wiki.git] / ikiwiki.mdwn
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.
2
3 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
4
5 After installing the RPMs, I ran `ikiwiki --setup wiki.setup` on [[/wiki.setup]].
6
7 The source of this wiki ([[markdown]], mostly) is available at http://git.greptilian.com/?p=wiki.git
8
9 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
10
11 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`:
12
13     [pdurbin@server1 Text-Markdown-Discount-0.02]$ diff -u Discount.xs.orig Discount.xs
14     --- Discount.xs.orig    2012-01-01 20:51:51.000000000 -0500
15     +++ Discount.xs 2012-04-21 23:12:45.376580002 -0400
16     @@ -46,7 +46,7 @@
17              char *text;
18          PREINIT:
19              SV* r = &PL_sv_undef;
20     -        int flags = MKD_NOHEADER|MKD_NOPANTS;
21     +        int flags = MKD_NOHEADER|MKD_NOPANTS|MKD_AUTOLINK;
22              char *html = NULL;
23              int szhtml;
24              Document *doc;
25     [pdurbin@server1 Text-Markdown-Discount-0.02]$ 
26
27 As http://ikiwiki.info/plugins/mdwn/ says, ikiwiki prefers to use Text::Markdown::Discount, if it's available.
28
29 You can subscribe to a feed of updates to this wiki at http://git.greptilian.com/?p=wiki.git;a=atom
30
31 ## Installing ikiwiki on Mac OS X with local::lib
32
33 I'm using `perl Makefile.PL INSTALL_BASE= PREFIX=$HOME/perl5` as suggested at http://ikiwiki.info/install/discussion/
34
35 I installed dependencies with `cpanm`.
36
37 `make` worked fine but `make install` showed...
38
39     /bin/sh: msgmerge: command not found
40     unable to run msgmerge
41     /bin/sh: msgfmt: command not found
42     unable to run msgfmt
43
44 ... so I ran `brew link gettext` per https://github.com/mxcl/homebrew/issues/7621
45
46 ## Previewing changes to this wiki locally before a git push
47
48     vim path/to/page.mdwn
49     ikiwiki --setup local.setup
50     cd _site
51     python -m SimpleHTTPServer
52
53 Browse to http://localhost:8000
54
55 ## Hack on table plugin
56
57 TODO: start discussion at http://ikiwiki.info/plugins/table/ about how having data that starts with "#" such as an IRC channel or hashtag gets turned into h1 tags. :(
58
59     root@server2:~# diff -u /usr/share/perl5/IkiWiki/Plugin/table.pm.orig /usr/share/perl5/IkiWiki/Plugin/table.pm
60     --- /usr/share/perl5/IkiWiki/Plugin/table.pm.orig       2013-09-04 18:11:12.000000000 -0400
61     +++ /usr/share/perl5/IkiWiki/Plugin/table.pm    2016-05-29 14:00:50.218858999 -0400
62     @@ -179,8 +179,12 @@
63             my @ret;
64             push @ret, "\t\t<tr>";
65             for (my $x=0; $x < @data; $x++) {
66     +               # hack by pdurbin to avoid #sourcefu becoming <h1>sourcefu</h1>
67     +               my $hack = $data[$x];
68     +               $hack =~ s/#/&#x23;/g;
69                     my $cell=IkiWiki::htmlize($page, $destpage, $type,
70     -                        IkiWiki::preprocess($page, $destpage, $data[$x]));
71     +                        IkiWiki::preprocess($page, $destpage, $hack));
72     +                        #IkiWiki::preprocess($page, $destpage, $data[$x]));
73      
74                     # automatic colspan for empty cells
75                     my $colspan=1;
76     root@server2:~# 
77