Installing and configuring Perl

Tue, 16 May 2017 23:59:39 +0000

Installing and configuring Perl using perlbrew on macOS or Linux

Installing Perl using Perlbrew. It will be a Perl installation separate from macOS's system Perl (/usr/bin/perl).
```
  curl -L http://install.perlbrew.pl | bash
```

Put the appropriate initialization command into ~/.bashrc:

if <span class="createlink">bashrc </span>; then
    source ~/perl5/perlbrew/etc/bashrc
fi

Open a new terminal.

Upgrade perlbrew
```
  perlbrew self-upgrade
```
Install or upgrade perl

Replace with X.Y.Z with the latest stable version found on https://www.perl.org/get.html:

perlbrew install perl-X.Y.Z

Tell perlbrew which version of Perl to use:

perlbrew use X.Y.Z

Upgrade Perl:

perlbrew upgrade-perl

It can be a slow process, monitor the log:

tail -f ~/perl5/perlbrew/build.perl-X.Y.Z.log

Verify perl installed correctly:
```
  perlbrew use X.Y.Z
  perl -V
```

Verify that $HOME/perl5/lib/perl5 is in @INC.

Install cpanm
```
  perlbrew install-cpanm
```
Install Perl modules using cpanm

Markdown::Foswiki, a Perl module for Markdown-to-TWiki conversion:

cpanm Markdown::Foswiki

experimental module:

cpanm experimental

Installing and configuring Ikiwiki

Tue, 16 May 2017 23:59:39 +0000

Misc

Bug related to `decode` call

Modify /usr/lib/x86_64-linux-gnu/perl/5.20/Encode.pm

sub decode($$;$) {
    my ( $name, $octets, $check ) = @_;
    return undef unless defined $octets;
    $octets .= '';
    $check ||= 0;
    my $enc = find_encoding($name);
    unless ( defined $enc ) {
        require Carp;
        Carp::croak("Unknown encoding '$name'");
    }
    return $octets if Encode::is_utf8($octets); # Fix bug: do not decode already-decoded string 
    my $string = $enc->decode( $octets, $check );
    $_[1] = $octets if $check and !ref $check and !( $check & LEAVE_SRC() );
    return $string;
}

Templates

Default templates

Linux

On Linux, it's typically in /usr/share/ikiwiki/templates/.

macOS

If installing ikiwiki on macOS using 'pkgsrc', share/ikiwiki/templates/ should be relative to the root directory where all 'pkgsrc' files are installed, which is by default /opt/pkg/.

Computer-wide templates (applied to all Ikiwiki websites built on a computer)

Specify an additional directory for ikiwiki to look for templates:

$ ikiwiki --setup setupfile --templatedir '/Users/meng/my-config-files/Ikiwiki/templatedir' [more options]

or specify it in the setupfile:

use IkiWiki::Setup::Standard {
  ...,
    templatedir => '/Users/meng/my-config-files/Ikiwiki/templatedir',
  ...
}

I intend to keep tempaltes applicable to all Ikiwiki websites in '/Users/lumeng/my-config-files/Ikiwiki/templatedir'.

Website-specific templates applied to only the current Ikiwiki website

In addition to the default templates and the user-configured templates applicable to all Ikiwiki websites, keep templates only applicable to the current Ikiwiki website in its own source directory 'sourcedir/templates/'.

References

https://ikiwiki.info/templates/
https://ikiwiki.info/forum/How_to_use_multiple_template_files_directories63/

pages tagged Perl

Installing and configuring Perl