Skip to main content

The PreTeXt Guide

Section 32.3 The Author Interface

The author interface is available at author.runestone.academy. You can log in with your Runestone account. Once you have logged in you will see a list of your books. You can click on the book title to to edit metadata about your book. The author interface is also where you can build a new version of your book, see some analytics about your book, and publish your book to the Runestone Academy servers. You can even get an anonymized data set from a large sample of the classes using your book.
The author interface lets you pull changes from github and rebuild your book.
Figure 32.3.1. The author interface main page
The main page of the author interface gives you access to all of the different functions. Clicking on the build button pulls the latest source from github and builds your book. If you have a large book this can take a few minutes. When the build is complete you deploy your book to the runestone servers. You will see the build status change at the bottom of the page. If there is a failure for any reason you can usually see the cause by clicking the button to view the latest log.
Another feature of the author interface is to provide you with some analytics. This page shows you the number of students that have enrolled in a course using your book year to date. It also shows you usage patterns for the book by the week of the course. You can click on any of the shaded cells to drill down and see how students are viewing the sections of each chapter.
An impact report for Foundations of Python Programming
Figure 32.3.2. Some example analytics for your book
The Analytics are in their early stages so we encourage you to contact us with ideas for what kinds of data you would find useful.
If you click on the book’s identifier you will be able to edit metadata about the book. This is reflected in our library page so you can change the shelf section or update the blurb that describes your book to an audience. The Available for courses and Visible to Everyone in the Library checkboxes allow you to control the visibility of your book. If you are in the early stages of development you probably do not want others to see the book, but you can always view it via a direct link. When you are ready to make your book available to the world you can check the Visible to Everyone box and your book will appear in the Runestone Library. When you are ready to let others create a course around your book you can check the Available for Courses box. This will allow others to create a course using your book as the textbook. You can always change these settings later.
Editing metatdata about a book
Figure 32.3.3. Editing a book’s metadata