This repository contains the source for the Tomorrow's Bread Today website. It is a lightweight static site generated with Eleventy so content can be maintained in Markdown while sharing a consistent layout and footer across every page.
pages/ # Markdown and Nunjucks content for each page
blog/ # Blog index and posts
assets/
images/ # Place shared site imagery here
documents/ # Upload downloadable PDFs and reference files
layouts/ # Shared layouts and partials for the site
data/ # Global Eleventy data files
docs/ # Generated site output served by GitHub Pages
- Browse to the file inside
pages/
(for examplesurvice-providers.md
). - Click the Edit (pencil icon).
- Edit the page.
- Click "Commit Changes" and add a comment on what changed.
-
Create a new "branch" to hold your changes.
-
Create a Markdown file inside
pages/
(for examplepages/your-page.md
). Include front matter so Eleventy can set the title and layout:--- title: Your Page Title layout: base.njk --- Your page content written in Markdown.
-
Update the navigation menu in
layouts/base.njk
. The header template contains a hard-coded<ul>
list—add a new<li>
with the link to your page (Eleventy will output/your-page/
). -
Create a Pull Request for review to be merged into the main site.
-
Install dependencies:
npm install
-
Run the local development server with live reload:
npm run serve
The site will be available at http://localhost:8080/.
-
Build the production-ready site into the
docs/
folder:set ELEVENTY_PATH_PREFIX=/tbt-org/ npm run build
GitHub Pages can publish the contents of the docs/
directory. To deploy:
- Run
npm run build
to regeneratedocs/
after editing Markdown files. - Commit the updated source files and the
docs/
output directory. - Push to the
main
branch and enable GitHub Pages in the repository settings, choosing Deploy from a branch →main
branch →/docs
folder.
Every time you update content and rebuild, push the new commit and GitHub Pages will serve the refreshed site automatically.
Base URL: https://github.com/tmccormi/tbt-org