admin2/template
1
0
Fork 0
mirror of https://github.com/TeachBooks/template.git synced 2026-11-12 22:25:52 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Use this template to quickly start with your own interactive textbook that includes our "standard" selection of features and workflow to host your book on ....github.io/... https://teachbooks.github.io/template/
34 commits 2 branches 0 tags 44 MiB
Find a file
Tom van Woudenberg 70819bfbad
Update README.md
2024-03-03 11:02:16 +01:00
.github/workflows build: Deploy from main to pages 2024-02-28 07:15:55 +01:00
book Update _config.yml 2024-02-28 11:32:46 +01:00
.gitignore started stripping down risk-and-reliability to create template 2024-02-23 18:02:52 +02:00
LICENSE.md started stripping down risk-and-reliability to create template 2024-02-23 18:02:52 +02:00
README.md Update README.md 2024-03-03 11:02:16 +01:00
requirements.txt Reduced requirements 2024-03-03 10:44:11 +01:00

README.md

Template

This is the template book. You can fork this to create a book in as easy-as-possible a way. Focus is mostly on providing a clean and simple view to the key setup of our book repo.

How to deploy a fork of this book on GitHub Pages

  1. Click Fork, and set a name for your new book.
  2. To enable deploying via GitHub Actions, go to ⚙ Settings, then to Pages, and under Build and Deployment set Source to GitHub Actions.
  3. To trigger a deployment for the first time, you can go to Actions (top panel), then click deploy-book on the left, then Run workflow on the right. The book is also automatically deployed whenever commits are pushed onto the main branch of the repository (in absence of errors).

Voila! You can now access the copy of the template at https://<username>.github.io/<bookname> (e.g. https://teachbooks.github.io/template).

To learn more about how we do this, please see the GitHub Actions documentation and our deployment pipeline configuration file .github/workflows/deploy-book-ghpages.yml.