This repository contains the source for aj-foster.com, a static
personal website built with Elixir and Tableau.
GitHub Actions builds the site on pushes to main and deploys the site/ directory to
GitHub Pages.
After installing the Erlang and Elixir versions in .tool-versions:
mix site.gencopies the assets and generates the complete site insite/.mix site.watchstarts Tableau's local development server and watches assets. CSS edits are copied into the served site immediately without restarting the server.
Pushing to main is still the publishing step; the existing GitHub Actions workflow runs
mix site.gen and deploys the generated output.
- Pages live in
pages/; posts live inposts/. - Both use Markdown with YAML front matter. Give each post a
date,preview, and explicitpermalinkso old links remain stable if its title changes. - Keep post permalinks in the existing
/year/slug/format. - Static files in
files/and source assets inassets/are copied into the generated site. mix site.gencreates an RSS 2.0 feed at/feed.xmland a sitemap at/sitemap.xml.
The site uses Tableau's MDEx converter and Makeup for syntax highlighting. Styles are plain CSS
in assets/css/app.css; this is also the stylesheet served at /assets/css/app.css.