Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Teach web publishing with static sites

A lesson plan and exercise for a half-day class - learners edit content in Exponential, build a static copy, review what changes and publish it free to GitHub Pages, then roll it back.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/trainers/teach-web-publishing-with-static-sites.md

On this page

Teach web publishing with static sites

Static publishing makes the whole path from content to a public website visible in one session: edit, build, check, publish, go back. Each learner ends with a live site, and nobody has to pay for hosting.

What you'll have at the end

  • A lesson plan for about four hours.
  • An exercise with a clear result: each learner's site on GitHub Pages, with two publishes in its history.

Before the class

  • One Exponential installation per learner or per pair (a lab server with several sites works too), with static publishing switched on.
  • Each learner has a GitHub account and a fine-grained token, or you hand out deploy keys made with exp:static:keys. See Connect to GitHub.
  • Give each learner a role with the staticpublish/* policies limited to their own target. See Who may publish.

Lesson plan

TimeTopicActivity
20 minWhat a static site isDiscuss What static publishing is; open the demo site (coming soon)
30 minFit checkLearners sort example sites with Is static right for my site?
40 minSet upThe setup wizard: siteaccess, repository, credential, links
40 minBuild and reviewBuild, read the diff and the report, open the preview
30 minPublishPublish, open the github.io address, find the commit and tag on GitHub
30 minChange and roll backEdit a page, publish again, then roll back to publish 1
20 minWrap-upWhat changes for forms and search; questions

The exercise

  1. Change the front page title of your site and add one article.
  2. Build your target and write down how many pages are new and changed.
  3. Publish. Paste your public address into the course chat.
  4. Change the article again and publish. Then roll back to publish 1 and check that the article's first version is back online.
  5. Bonus: explain why /<repository>/ is in your address. See Links and base path.

Assessing it

  • The site is reachable and the links work below /<repository>/.
  • The repository has at least three tags static/<target>/<n>.
  • The learner can say which parts of a site need a server.

When something goes wrong in class: When a publish fails.

Make yours now

Try the exercise yourself first: Make a free website in 15 minutes.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x