`elm-pages`

A statically typed site generator, written with pure Elm.

Why a fork?

We want to add in the metaRedirect function:

metaRedirect : AttributeValue -> Tag
metaRedirect content =
    node "meta"
        [ ( "http-equiv", Raw "refresh" )
        , ( "content", content )
        ]

The work being done to create this fork is:

We are starting at 46853ca6176071f01061366e5e1fbaf78a65aeb4, which is tagged as v2.1.9.

We need to remove all of the tags on both remote and local:

git tag -l | xargs -n 1 git push --delete origin
git tag | xargs git tag -d

The published versions are: https://package.elm-lang.org/packages/canceraiddev/elm-pages/
Checkout commit 46853ca6176071f01061366e5e1fbaf78a65aeb4, on the dev branch.
We need to update the following files:
1. DONE src/Head.elm Add in the new function, and associated documentation
2. DONE package.json Update the version to 1.2.1-fork
3. DONE elm.json Update version to 1.2.1.
Test compile with elm-make
Make new commit

Getting Started Resources

elm-pages Docs Site
elm-pages Elm API Docs
Quick start repo (live site hosted here)
Introducing elm-pages blog post
examples folder (includes https://elm-pages.com site source)

Key features

SEO made easy

With elm-pages, SEO is as easy as calling a type-safe, high-level Elm API and passing in data from your content's metadata.

The metadata is just Elm data that you define however you want, using a Json Decoder to grab data out of your markdown frontmatter.

import MyMetadata exposing (MyMetadata)

head : BlogMetadata -> List (Head.Tag Pages.PathKey)
head meta =
  Seo.summaryLarge
    { canonicalUrlOverride = Nothing
    , siteName = "elm-pages"
    , image =
      { url = PagesNew.images.icon
      , alt = meta.description
      , dimensions = Nothing
      , mimeType = Nothing
      }
    , description = meta.description
    , locale = Nothing
    , title = meta.title
    }
    |> Seo.article
      { tags = []
      , section = Nothing
      , publishedTime = Just (Date.toIsoString meta.published)
      , modifiedTime = Nothing
      , expirationTime = Nothing
      }

Optimized for performance

elm-pages has a set of features built-in to make sure your page is blazing fast on any device.

Automatic page pre-rendering
Page content is split up per-page so page content downloads and parses just-in-time
Page pre-fetching on link hover

Try out elm-pages, open up Lighthouse, and see for yourself! Or check out https://elm-pages.com (find the source code in the examples/docs/ folder).