The Reading List
When it matters. A friend names a book, a review makes you want one, a reference list is full of titles you mean to get to. You want a place for them that is not a scrap of paper: one shelf for the books you want to read, the ones you are reading and the ones you have read, with their covers, where each book is a page you can link to and keep notes in.
Where it is. Reading list is the first row of the Pages panel, in every wiki, from the first launch. It is on to begin
with, and Settings ▸ Sources has Show Reading list if you would rather not have it. There is no Database View to make and no kind to build: the first time you add a book, MojoPad makes the Book kind and its
details for you. You can also open it from View ▸ Reading List, or by typing Reading list in the command list (⇧⌘P).
The Pages panel stays beside it. Each wiki has its own Reading list.
Turning it off. Open Settings ▸ Sources and turn off Show Reading list. The list is hidden from the Pages panel, the View menu, All Commands and Add a book, and books are no longer looked up in the background. Your book pages stay in the wiki as ordinary pages, untouched. Turn it back on and the shelf returns with the same books, covers and details.
The shelf and its three tabs
What you see. A wall of covers with three tabs across the top: Want to read, Reading and Read, each with a count of its books. Under every cover is the title, the author and, if you wrote one, your one-line note. The last tile on the shelf is Add a book. Find a book, at the top right, narrows the shelf as you type: a word from the title, the author or your note, and each tab's count shows how many books in it match.
Open a book. Click its cover or its title. The book's own page opens.
Move a book between tabs. Rest the pointer on a card and a small status menu appears under it: choose Want to read, Reading or Read, and the book moves to that tab. The same choice is at the top of the book's own page (see below) and in its Status detail.
Add a book
When it matters. You have a link from a bookstore or a library, an ISBN off a back cover, or only a title in your head.
- Press Add a book (the button at the top right, or the tile at the end of the shelf).
- Paste a link, an ISBN or an item number, or type a title and press Return. MojoPad reads which it is: for a link it takes the ISBN or item number out of the address and looks that up; a link with neither is searched by the title in its address. The sheet says Looking it up… and then Found it.
- Check what was found: the cover, the author, the year, the pages and the publisher, and About this book marked from the publisher. The line under it names the sources that answered, for example Found with Open Library and Google Books.
- If more than one edition matches (a hardcover and an ebook, say), an Edition picker appears. It starts on the edition your link or ISBN names; choose another if you meant it.
- If you like, write Why I want it. It shows under the cover on the shelf.
- Press Add to Want to read. Cancel (or Escape) closes the sheet and adds nothing.
Typing works too. Type a link, an ISBN or a title and press Return, or pause a moment: after a short pause MojoPad looks up what you typed, so half-words are not sent. Typing more starts the pause again. Pasting is looked up right away.
Enter details yourself. When you would rather give the details than look them up (a book no catalog has, a cover you photographed, no network), press Enter details yourself, just under the field. It is always there, and it is the one to reach for when the sheet says Nothing found, The catalogs are busy or Offline. A short form opens on the same sheet: Title (required), Author, Year (four digits), an optional Book Link (a web address, filled in for you when you pasted a link; clear it if you do not want one) and a cover you pick or drop: press Pick a cover picture, or drop a JPEG, PNG, GIF or WebP file (up to 3 MB) onto the box. A file that is not a picture is turned away and says so. Add Why I want it if you like, then press Add to Want to read. You get the same kind of book page as a lookup makes, with the cover saved in your wiki; nothing is looked up or sent, and nothing is left to fill in later. If you pasted a store link first, it stays on the page. You can paste a picture there too, while the box has the focus or anywhere on the sheet.
When the sheet says Nothing found. The catalogs answered, and they have no record of it. You can still press Add to Want to read anyway: the book is added with the title you gave (or the title from your link) and a plain cover, and it is not left waiting for a later lookup, because there is nothing left to find. Enter details yourself is still the way to give an author, a year and a cover at the moment you add it.
A different cover before you add. When the sheet has found the book, Change cover… sits under its picture: pick a file, drop an image onto the cover, or paste one, and your picture is the one that is added. The catalog's own picture is still saved in the wiki, so Use catalog cover can bring it back later.
Which catalog. MojoPad asks Open Library first. If Open Library has nothing, it asks Google Books; and if the first answer has no description or no cover, the second is asked only to fill those in. If neither has a record, MojoPad asks the Library of Congress, and then Crossref (books and monographs only; a chapter or an article that shares the book’s ISBN is never taken for the book). Only the ISBN or title is sent. These two rarely have a cover: when the book has an ISBN, the Open Library cover is still used if there is one. A book already on your Reading list is not added twice: the sheet says so and offers Open it.
A link with an item number. A ten-digit item number in a store link that is an ISBN is looked up as an ISBN. If the item number is not an ISBN, MojoPad searches by the title in the address (the words in the path before the item), not by fetching the store’s page. Only that ISBN, item number or title is sent, never the address itself.
A title with a subtitle. A title you type may include a subtitle after a colon. MojoPad looks it up by those words, and by the part before the colon, and shows only editions whose title matches. If a pasted link has no title in it, the sheet says This link doesn’t include the book’s title. Type the title instead. Enter details yourself is there too.
When a catalog is slow or busy. If Open Library takes too long to answer, MojoPad tries that request once more; a search by title is given a little more time than the others. If a catalog answers that it has had too many requests, the sheet says The catalogs are busy · try again shortly, and you can add the book anyway: it is added with the title you gave, and its details fill in later. While it waits, its line says Details will be filled in when the catalogs answer. Offline appears only when nothing can be reached, and then the line says Details will be filled in when you’re online.
An empty shelf starts you off with one box: Paste a book link, an ISBN or a title.
What a book's page holds
A book is an ordinary page of the Book kind, so you can link to it by name from any page, tag it, search it, export it and see what links to it, like any other. Its details, across the top, are Author, Status, Pages, Added, Recommended by, Book Link and ISBN: change any of them where they are; Recommended by, Book Link and ISBN are yours to fill in. Below are the cover, About this book (the publisher's own words, labeled so — it is an ordinary paragraph, so select it and delete it if you would rather not keep it), My note, Reading notes for whatever you write while you read, and, when you pasted a store link, a Store page link back to it, labeled with the address's own name. The cover is saved inside your wiki: it shows with no network, and it travels in an export.
Book Link. Just under Recommended by, Book Link holds a web address you paste, from a bookstore or a library, say. It shows as the site's name (the part before the first slash, such as shop.example.com), and it is a link: press it and the page opens in your browser, not inside your wiki. Rest the pointer on it to see the full address. Press ✎ to change the address, or ✕ to clear it; the field stays, so you can paste another. Only an address that starts with http:// or https:// is kept; anything else is not saved, and a short message says so. When you add a book from a pasted link, Book Link is filled in for you. A book you added earlier with a store link gains its Book Link from that link the next time you open your Reading list.
ISBN. Just under Book Link, ISBN holds the book’s number. When a lookup finds the book and the record has an ISBN, it is filled in for you (the 13-digit form when both are known), and Enter details yourself has the same field, just under Book Link. You can also type or paste one, with or without hyphens or spaces, ISBN-10 or ISBN-13. A number that is not quite right still stays, and a short note beside it says the check digit does not match; nothing stops you saving it. A book still waiting for its details is looked up by an ISBN you enter, when the number is right, even if you first added it by a title or a link. Books you added earlier gain their ISBN from what the lookup already found.
Back to the shelf
When you opened the book from the shelf, a bar at the top of its page reads ‹ Reading list. Press it to go back to the shelf on the same tab, with your search and your place in the wall as you left them. The bar also holds Want to read | Reading | Read: press one to change the book's status without leaving the page.
Your own cover
When it matters. The catalog's picture is the wrong edition, or blurry, or you would rather see the copy on your own shelf. You can use your own cover on any book. On the book's page, the bar at the top has Change cover…; on the shelf, right-click a card (or press the menu key on it) and choose Change cover… there. Then pick a file, drop an image onto the cover, or paste one: a JPEG, PNG, GIF or WebP picture, up to 3 MB. Dropping or pasting works right on the cover, on the page or on the shelf. Something that is not a picture is turned away, and the sentence says so; nothing is changed. The picture is saved in your wiki, with the book, so it shows with no network and travels in an export.
Going back. When MojoPad has the catalog's picture too, Use catalog cover appears beside Change cover… (and in the card's menu) while your own cover is showing. Press it and the catalog's picture is back. A cover you chose is never replaced when details fill in later: if a book was added with no connection and you give it your own cover before its details arrive, it stops waiting, and yours stays.
Paste a book link into any page
When it matters. You are writing a note and paste the link to a book. A small card appears at the corner of the window: Add it to your Reading list? with That link is a book above it. Add to Reading list makes a page under Want to read; the link on your page stays exactly as you pasted it. No thanks puts the card away. It is offered once for each paste, and it goes away by itself if you ignore it. After you have said No thanks twice, the card also offers Don't ask again, which turns the offer off.
With no network, or with lookups turned off
A book is still added. It gets the title from your link, or the one you typed; a plain cover that shows the title; and a quiet line that says Details will be filled in when you’re online. The next time MojoPad has a connection (and when you open the Reading list), it looks the book up and fills in the author, pages, description and cover — and nothing you wrote changes: your note, the status, the date added, and any title you changed stay as you left them. With lookups turned off, nothing is sent and nothing is filled in later; the book keeps what you gave it. If the catalogs were busy instead, the line says Details will be filled in when the catalogs answer. and the book fills in the same way when they do.
A waiting line you no longer need. If a book still says it is waiting and you have already added your own cover, an author, or words of your own on its page, the waiting mark is cleared the next time you open the Reading list, and your cover, author and words are never overwritten. Nothing is looked up for it. You can also end the wait yourself: right-click the book’s card and choose Stop looking, or choose Stop looking in the bar at the top of the book’s page. The book keeps what you gave it, and the waiting line goes away. A book that is not waiting does not offer it.
What is sent, and how to turn it off
To find covers and details, MojoPad looks the book up on Open Library, Google Books, the Library of Congress and Crossref. Only the link, ISBN or title you give is sent. Your notes never leave your Mac, and no page is ever read to look a book up. From a link, what is sent is the ISBN or item number found in it or, failing that, the words of its title — not the address itself. To stop all of it, open Settings ▸ Sources and turn off Look books up when I add them. It is on unless you do.