Managing Chapters

The list down the left of the editor is your project's structure. Click any entry to open it. If the list is hidden, bring it back with the Chapters button on the left rail:

If you are working on an article rather than a book, the same list shows sections instead of chapters. The rest of this tutorial says "chapter"; read "section" for articles.

The list is divided into Front Matter, Body, Appendices, and Back Matter, with the details page (and the template page, when that is switched on) pinned at the top. The Appendices heading appears once the project has an appendix in it.

Inserting a chapter

Click Insert at the bottom of the list.

The menu is in three groups.

New content

• Blank Chapter — an empty chapter.
• New Part — a part divider, for grouping chapters into Part I, Part II, and so on. See Chapter Titles, Parts, and Section Headings.
• New Page — a standalone page, for front matter such as a dedication.
• New Appendix — an appendix, added to the Appendices section after the body. See Chapter Titles, Parts, and Section Headings.

New content lands directly after the chapter you have open, so you add a chapter where you are working rather than at the far end of the list. If what you have open belongs somewhere else — you ask for an appendix while reading a body chapter, or have a generated section such as the table of contents open — the new chapter goes to the end of its own section instead.

Import

• Upload File — bring in a Word, LaTeX, Markdown, ODT, ePub, RTF, or plain-text file.
• Import from Google Docs — pick a document straight from Google Drive.
• Import from Inkwell — pull a chapter out of an .inkwell backup file.
• Import from Template — copy a chapter out of one of the templates.

Generated sections. These build themselves from the rest of the book, so you add them once and Inkwell keeps them up to date:

• Index — see Index.
• Bibliography — every work you have cited.
• Notes — the endnotes section.
• Annotations — the second, independent family of notes; see Annotations.
• Table of Contents — see Table of Contents.
• List of Figures — every captioned figure, with its page number.

At the bottom of the menu, Restore Chapter brings back a chapter you deleted earlier.

The chapter menu

Point at a chapter in the list and a ⋯ button appears at the right of its row (on a touchscreen it is always there):

Click it for that chapter's menu. Right-clicking the row opens the same menu where you clicked, and so does the context-menu key (or Shift+F10) on a row you have tabbed to:

• Duplicate — makes a copy titled "Copy of …", directly after the original, and opens it.
• Move Up / Move Down and Move to — see Reordering.
• Scratch — a tick here keeps the chapter out of the built book; click again to put it back. It is the same setting as Scratch in Local Settings, so the two always agree.
• Remove… — asks first, then takes the chapter out of the project. Undo on the message that follows puts it straight back; later, Insert → Restore Chapter does the same.

Generated sections such as the table of contents or the index offer only the moves and Remove…: they build themselves from the rest of the book, so there is nothing to copy and nothing to leave out. None of the menu is offered to collaborators who can only read or comment.

Duplicating

A copy is a new chapter with the same text, and starts out marked not started. It keeps:

• its footnotes and annotations;
• its index entries, so until you change or remove one of the two chapters the index lists both;
• its citations and figures;
• its Local Settings, including whether it is in the scratchpad, except two: a Custom Number is cleared, so the number is not printed twice, and Boilerplate is switched off, since the copy is your own text rather than the template's. A Navigation Label gets the same "Copy of" in front as the title.

Cross-references are kept working: a reference in the copy to a heading, figure, table, note or callout in the same chapter points at the copy's own one, while references from the rest of the book carry on pointing at the original.

A copy does not take the original's comments or its tracked-change history with it. Any changes still waiting for review are copied as they stand — insertions kept, deletions gone — and the copy arrives as a brand-new chapter of yours, the way an imported one does.

Reordering

Drag a chapter up or down to reorder it, including across the Front Matter / Body / Appendices / Back Matter boundaries — dropping a chapter under Back Matter moves it there, and dropping one under Appendices turns it into an appendix, lettered with the rest.

While you drag, the chapter follows the pointer up and down the list, and a gap opens where it will land. Press Escape (or let go outside the list) to cancel the move.

The chapter menu does the same without dragging:

• Move Up and Move Down swap the chapter with its neighbour. They stop at the edge of its section, so they are greyed out on the first and last chapter there.
• Move to sends it to the end of another section — Front Matter, Body, Appendices or Back Matter (for an article, Content, Appendices or Back Matter). Moving a chapter to Appendices turns it into an appendix, just as dropping it there does, and adds the Appendices heading if the project has none yet.

Chapter markers

Chapters carry small icons that tell you something about them at a glance:

• Status — a button on the right that cycles through three states as you click it: not started, done, and needs attention. Use them however suits your process — drafting progress, proofreading passes, or flagging problems.
• Reviewing — replaces the status button while a chapter is under review.
• Boilerplate — marks a chapter that came from the template and is managed by it.
• Scratchpad — marks a chapter excluded from the built book, useful for notes and offcuts you want to keep but not publish.
• Unavailable — marks a chapter Inkwell cannot find, shown greyed out and in italics.

Both Boilerplate and Scratchpad are switched on per chapter in Local Settings (see Local Settings); Scratchpad can also be toggled with Scratch in the chapter's menu.

Unavailable chapters

Very occasionally a chapter appears in the list as Unavailable, greyed out and marked with a question mark. This means the entry exists but the chapter behind it does not, which almost always comes from a new chapter that was interrupted — the page reloaded, or the browser was closed, in the moment between clicking Insert and the new chapter reaching Inkwell's servers. A chapter is created the first time something is written to it, so one that was cut off that early was never created at all.

An unavailable chapter is empty and read-only, and nothing further can be recovered from it. The rest of the project is unaffected: open it and the entry is simply blank. Remove it with Remove… from the ⋯ menu on its row (see The chapter menu) and add the chapter again.

If a collaborator created the chapter and their browser still holds it, it can also reappear on its own once their copy of Inkwell finishes sending it — so if you know someone else added it moments ago, it is worth waiting before deleting the entry.