Skip to content

lfe/lfe.github.io

Repository files navigation

lfe.io

Repository for the main LFE (Lisp Flavoured Erlang) Language site

Visit lfe.io!

Contributing

Feel free to open a ticket or fork the site and submit a pull request.

Note that the entire site content is driven with Markdown files -- including the metadata sections of those files!

The front page's content is in TOML variables between the +++ metadata markers in ./content/_index.md.

More about the static site generator software:

The templating language used by zola and which drives the layout/design of the LFE site:

If you're intersted in updating the CSS, we use TailwindCSS + Preline, and everything you need to tweak should be in ./styles/* (and mostly site.css).

Before submitting a PR we recommend running the spell checker:

make spell-check

(requires aspell).

Dev Server

If you would like to run the site locally, you may do so with this command:

zola serve

This will start the site on a local dev server running on port 1111.

If you want to run on a different port, simply set the zola port option to your liking:

zola serve -p 5099

Publishing

The Github Actions for this repo now regenerates content and CSS as part of the CI/CD workflows, automatically re-publishing the site for all successful merges to main.

Publishing to Staging

The staging site is hosted in another LFE repo, and thus requires a custom remote URL to be added to your local git clone:

git remote add staging git@github.com:lfe/site-staging.git

With that in place, you can push your branch to that repo with:

git push staging <your branch name>

If you are pushing to a branch that is not the current default in staging, you'll want to change the default to your branch here:

The Github Actions for deploying the site is set to only trigger on the main branch, so you'll want to manually kick off a deploy, when you're ready (the "Run workflow" drop-down at the top):