This package allows to use shortcut-links package in websites generated by hakyll.

The flexible interface allows to use the supported huge collection of shortcuts along with using custom ones.

Functions to transform Pandoc documents. These functions modify markdown links to the extended links.

These are the most generic functions. They work inside the monad m that has MonadError [String] instance. You can use the pure version of these function because there's MonadError instance for Either:

applyShorcuts :: [([Text], Shortcut)] -> Pandoc -> Either [String] Pandoc
applyAllShorcuts :: Pandoc -> Either [String] Pandoc

If you have your own hakyll options for your custom pandoc compiler, you can use this function like this:

pandocCompilerWithTransformM
    myHakyllReaderOptions
    myHakyllWriterOptions
    (applyShortcuts myShortcuts)

Functions to integrate shortcut links to hakyll.

hakyll-shortcut-links provides out-of-the-box Compilers that translate markdown documents with shortcut links into the documents with extended links.

Usually you would want to use this feature on your blog post markdown files. Assuming that you already have similar code for it:

match "blog/*" $ do
    route $ setExtension "html"
    compile $
        pandocCompiler
            >>= loadAndApplyTemplate "templates/post.html" defaultContext
            >>= relativizeUrls

All that you would need to do is to replace pandocCompiler with shortcutLinksCompiler or allShortcutLinksCompiler:

match "blog/*" $ do
    route $ setExtension "html"
    compile $
        allShortcutLinksCompiler
            >>= loadAndApplyTemplate "templates/post.html" defaultContext
            >>= relativizeUrls

This is the module from shortcut-links library that introduces the functions that by given shortcuts creates the Resulting URL (if possible).

This module stores a large number of supported Shortcuts. It also reexports a useful function allShortcuts that is a list of all shortcuts, together with suggested names for them.

In hakyll-shortcut-links we are exporting both functions that work with the standard list of allShortcuts, but also we provide the option to use your own lists of shortcuts (including self-created ones).

For example, if you want to use just github and hackage shortcuts you can create the following list:

(["github"], github) : (["hackage"], hackage) : []

If you want to create your own shortcut that is not included in ShortcutLinks.All module you can achieve that implementing the following function:

kowainik :: Shortcut
kowainik _ text = pure $ "https://kowainik.github.io/posts/" <> text

myShortcuts :: [([Text], Shortcut)]
myShortcuts = [(["kowainik"], kowainik)]

And it would work like this:

[blog post](@kowainik:2019-02-06-style-guide)

=>

[blog post](https://kowainik.github.io/posts/2019-02-06-style-guide)