About this project

Readteractive is an open-source tool for authors creating interactive books, also known as gamebooks. A book is organized as a folder containing chapter subfolders; metadata lives in YAML files and chapter text is written in Markdown. Choices between chapters use a custom link syntax such as (Go to after -> [after]), and the build process checks for broken links. Running make BOOK=book-name produces HTML, PDF, and EPUB output, with optional MOBI generation when KindleGen or Kindle Previewer is available. The HTML version presents the current chapter interactively, while SCROLL=yes keeps visited chapters visible and PRINTED=yes adds chapter references for print. Styling supports Markdown and HTML, CSS for HTML and e-book output, PDF margin variables and LaTeX page breaks, and MathML equations in HTML and PDF. A companion Yeoman CLI can scaffold projects and visualize chapter link graphs.