The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

Coverage Status CPAN version

Perl bindings for the CommonMark C library

This module is a wrapper around libcmark, the official CommonMark C library.

Installation of libcmark

Please note that the libcmark API isn't stable yet. This version of the Perl bindings is targeted at libcmark version 0.23.0. It's known to work with 0.21.0, but there's no guarantee that it can be compiled with versions higher than 0.23.0. Also note that upgrading libcmark may require recompilation of the Perl module.

    curl -LJO https://github.com/jgm/cmark/archive/0.23.0.tar.gz
    tar xzf cmark-0.23.0.tar.gz
    cd cmark-0.23.0
    make [INSTALL_PREFIX=/prefix]
    make test
    make install

See the libcmark README for details.

Installation from a CPAN tarball

If libcmark is in a standard location:

    perl Makefile.PL
    make
    make test
    make install

Otherwise:

    perl Makefile.PL \
        INC="-I/prefix/include" \
        LIBS="-L/prefix/lib -lcmark"
    make
    make test
    make install

See the documentation of ExtUtils::MakeMaker for additional options. The PERL_MM_OPT environment variable is especially useful.

    export PERL_MM_OPT='INC="-I..." LIBS="-L... -lcmark"'

Build from a repository checkout

You need Dist::Zilla with the external plugin MakeMaker::Awesome. Then you can build and test with dzil:

    dzil test
    dzil build

This software is copyright (C) by Nick Wellnhofer.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.