hakyll/web/tutorials/faq.markdown

title
FAQ

Does Hakyll support syntax highlighting?

Syntax highlighting is enabled by default in Hakyll. However, you also need to enable it in pandoc. If no syntax highlighting shows up, try

[jasper@phoenix] cabal install --reinstall -fhighlighting pandoc

When should I rebuild and when should I build?

If you execute a ./hakyll build, Hakyll will build your site incrementally. This means it will be very fast, but it will not pick up all changes.

• In case you edited hakyll.hs, you first want to compile it again.
• It is generally recommended to do a ./hakyll rebuild before you deploy your site.

After rebuilding your site, all files will look as "modified" to the filesystem. This means that when you upload your site, it will usually transfer all files -- this can generate more traffic than necessary, since it is possible that some files were not actually modified. If you use rsync, you can counter this using the --checksum option.

Problem with regex-pcre dependency on Mac OS

Hakyll requires regex-pcre, which might fail to build on Mac OS. To solve this problem, make sure the pcre C library is installed (via homebrew or macports). Then install regex-pcre using:

cabal install --extra-include-dirs=/usr/local/include regex-pcre

or

cabal install --extra-include-dirs=/opt/local/include regex-pcre

...and proceed to install Hakyll the regular way.

"File name does not match module name" on Mac OS

Hakyll.hs:1:1:
    File name does not match module name:
    Saw: `Main'
    Expected: `Hakyll'

Is an error encountered on Mac OS when hakyll.hs is located on a case-insensitive filesystem. A workaround is to rename it to something that isn't the name of the module, for example, site.hs.