Private repos and
Archiving strategy

June 17th 2024:

Severin Bratus added two new exciting features to our GitHub pages action which builds your TeachBook on the GitHub server and publishes it online:

• It now allows for publishing private repositories too! Although I think all your TeachBook repositories should be open because of our open source and open education ambitions, there might be a use-case in which this is actually useful.
• It includes an archiving strategy which make sure that if you create a new version of the book, the old version is still available under the same URL. This is particularly useful if you create a new TeachBook every year for your students! To make this possible you have the option to redirect from your root TeachBook webpage to a specific branch/version.

The documentation in the readme (for both the workflow and template) and in our manual (both workflow and template too) has been updated.

TeachBooks Lunch
Club

May 29th 2024:

Thank you for those of you that came to our lunch pitch on Wednesday, we were encouraged by the interest in our education projects, and look forward to seeing how you incorporate it in your own teaching practice! For those who could not make it, you can find the slides and a recording of the presentation using the links provided below. Please also consider filling out a survey about open education materials (online books in particular); this is part of a collaboration with colleagues from the Faculty of Applied Sciences, and your input will help us continue to develop software and obtain resources (e.g., more TA’s!) to help you use these tools in the future.

• Slides and additional resources available at: doi.org/10.5281/zenodo.11378196
• Recording of the presentation: youtu.be/MJT_EuWKjY0
• Survey about online textbooks (if you are thinking of using a TeachBook in the future, please take the time to fill this out!)

GitHub
Workflow

April 16th, 2024:

Hi TeachBooks-enthusiasts! One of our TA's (Severin Bratus 🙌) developed a workflow which allows you to publish your TeachBook online. And even better, it allows you to deploy all branches, so that you don't have to deal with local jupyter book build book command-line headaches 🤕! Our template TeachBook makes use of this, but you can use this features yourself in around 20 clicks 🖱. We've updated our documentation in our manual ! I'm curious about your thoughts on this! Kind regards, Tom van Woudenberg Ps. did I mention that all of this is not possible without our BSc-computer-science-TAs 🤓 💪

April 26th, 2024: New updates! With: A nice summary of all the branches that are deployed A clear list of errors in TeachBook building process Option to select which branch should remove chapter you don't want students to see

Share content
between books

April 18th 2024:

Hi Open Interactive Textbooks Community, Here I am again 😀 presenting our newest feature: share content between TeachBooks 📘↔️📕! With our growing stock of TeachBooks we got the question from Oriol Colomes Gene on how to share content between books, which boils down to sharing source code in between Git repositories (but specifically for books). Caspar Jungbacker implemented this using git submodules and we developed an example and documentation for it in our manual . Actually, this TeachBook in the manual is actually the readme of the example git repository which is included into the TeachBook using the exact same workflow it describes🤯! We think this feature is very valuable and are using it in other TeachBooks now already! It's an elegant feature, but requires a bit more experience with Git 🤓 (user type 4-5 for those familiar with our manual). However, for those of you who hate using the command line (like me 🤝), GitHub desktop is remarkably helpful with these submodules. Looking forward to your thoughts again! Kind regards, Tom van Woudenberg

PS. Actually our TA Caspar Jungbacker 💪 created this a few months ago but we were to busy doing other stuff that we never properly tested it on both GitHub and GitLab and didn't write extensive documentation on it 🙈. One of our other colleagues Iuri Barcelos Carneiro M Da R was already using it quite extensively but was too busy too share his finding 😒😉.... But it's exam period, so there was time enough to throw some attention at it 🤭.

HTML/Javascript
in manual

27th March 2024:

Hi Collaboration Corner, Look what Max Ramgraber made! A tutorial on how to embed existing or custom HTML/javascript elements for the smoothest interactive element you've ever seen in a TeachBook!