Skip to content

Create chapter headings and bookmarks for books you read on the Canute.

pachpict edited this page Dec 19, 2023 · 7 revisions

When opening a BRF file ("FILENAME.BRF") the Canute looks for another file in the same directory called "canute.FILENAME.BRF.txt".

This is where the current page and bookmarks are stored.

You can take the SD card or USB stick out, put it in a PC and open the second file in any text editor to manually change it.

If you are distributing BRF files for Canutes you can create that file yourself too. Just create a blank plain text file in the same directory as the BRF it relates, for example, "The Return of The Kind.brf" and "canute.The Return of the King.brf.txt". Once created you then add these lines into the blank file and save it:

current_page = 1
bookmarks = []

What can you use this for? Firstly, for skipping over preambles by setting the current page. For example if you know the book starts with a long copyright notice or transcribers note which must stay in but is distracting to readers then you find which page[^1] that is on and change the page number appropriately.

Secondly, you can use add in bookmarks if, for example, you want to share a particular point you want a class to start reading from on day one, day 2 etc, if everyone is reading from their own Canute, or as reference points on a document you are sharing with a colleague whom you want to review at point A, point B, and so on.

Thirdly, because the BRF format doesn't have any semantic information you can use the bookmark feature to add in chapter or section headings. Then when a reader visits the bookmark menu they will see a series of headings for those chapters. Once populated a file might look like the following:

current_page = 112
bookmarks = [4,60,89,130]

[^1]: How do I compare Canute page numbers with BRF page numbers?