Chapter 12
Research
Every book, screenplay and brief comes with material: sources, rulings, scans, photographs, interviews, notes. In Goethe Write it lives in the Research section of your project, next to the manuscript, and you work with it right beside your text. In this chapter you learn how to bring files into Research, how to read, highlight and quote PDFs, how scanned pages become searchable, and how to lay research and text side by side.
Good to know: Research is material, not manuscript. You write in the Manuscript section (Chapter 4). Research sits beside it as a section of its own and is always one click away.
Adding files
A file in Research is an entry in the sidebar, like a text. You can rename it, move it, give it a label and a status, and add notes (see Chapter 6). The file itself is copied into the project when you add it. Your original on the hard disk is left untouched. In return, the project grows with every file you put in.
Through the menu
- Choose File ▸ Add Files to Research…
- In the dialog (“Add files as research material: PDFs, images, documents”) pick one or more files.
- Click Open.
The files appear in the sidebar in the Research section, at the end of the folder. The first one is selected, and you see it in the middle at once. One step of ⌘Z (“Add File” or “Add Files”) takes them out again.
This route always puts files into Research, even Word or text files. If you want to bring Word texts into the manuscript as texts, use File ▸ Import (see Chapter 6); a whole Word file with headings, notes and comments comes in with Import ▸ Word File… (see Chapter 14). Import ▸ Import Work… puts the original file into the new project's Research.
Through the sidebar
- Right-click a folder or a file in Research and choose New ▸ Add Files… The command puts the files into that folder. It appears only in the Research section.
- Or drag files from the Finder into the sidebar. If you drop them on a folder in Research, they land there. The place decides what happens: in the Manuscript, with Characters and with Places, text files (txt, text, md, markdown, rtf, docx, odt, html, htm) become texts, and all other files move to Research. In Research, all files stay files.
The menu of a card or a table row in a Research folder also has New ▸ Add Files… (see Chapter 4).
What you then see
The middle shows the file according to its kind:
| Kind of file | Display |
|---|---|
| Goethe Write’s reader with search, highlighting and quoting (see below) | |
| Images, Word, Pages, audio, video and other files | The Mac’s preview (Quick Look) |
| Web page (link) | The link, which opens in the browser; notes on the page are in the inspector on the right |
Below the file there is a bar with the file name, the size, for images the button Recognize Text, and on the right the command Open with Another App… If a file cannot be shown here, Goethe Write says “No Preview: This file can’t be shown here.” If a file is missing from the project, it says “File Missing”.
You write notes on a file in the Inspector (⌥⌘I), tab Notes. They stay your own words about the file. The recognised text of a scan deliberately does not land there but in a text of its own (see below).
Note: Goethe Write today creates a link to a web page when you import a Scrivener project that contains web archives. There is no command in this version to put an address directly into Research as an entry. An address you need in your text you insert as a link (see Chapter 4).
Example: You are writing a historical novel and collecting sources: an essay as a PDF, scanned newspaper pages, photographs of a harbour. You drag everything into the “Research” folder. Each file is now an entry with notes that you can open beside your scene.
PDFs and text recognition
Reading the PDF
If you open a PDF in Research, you see a bar with search and tools at the top and below it the pages, scrolled continuously.
| Element | Effect |
|---|---|
| Field Search in PDF | Searches the PDF. While you type, the number of matches appears (“3 by 12”) or “No Match”. |
| ↑ ↓ | Previous match (⇧⌘G), next match (⌘G). ↩ in the field goes to the next one, ⇧↩ to the previous one. |
| Page 4 of 120 | Shows where you are. |
| Mark | Highlights the selection with a marker. |
| Use Quote | Takes the selection into your text (see below). |
⌘F in the PDF puts the cursor in the reader’s search field. Esc in the field clears the search. So does the cross in the field.
The search in the PDF searches this file only. The search Search Project (⇧⌘F, see Chapter 4) also searches all research PDFs. A match there opens the PDF at the right page.
Highlighting
- In the PDF, select a word or a passage with the mouse.
- Click Mark. The passage is shaded yellow. With the arrow next to Mark you choose another colour: Yellow, Green, Blue, Pink or Purple.
- A short note above the PDF says “Highlighted”.
The highlight is saved in the PDF inside your project, one step for ⌘Z. Your original on the hard disk stays as it was. Highlighting runs line by line, as the Mac’s Preview does it.
You remove a highlight by right-clicking it and choosing Remove Highlight (“Highlight removed”).
Tip: Without a selection, Mark and Use Quote are grey. If you choose the command from the right-click menu without a selection, the reader says “Select a passage in the PDF first”.
Taking a quote into the text
The button Use Quote (and the entry in the PDF’s right-click menu) turns a highlighted passage into a quote with a page reference. There are four ways, in the menu next to the button:
| Command | What happens |
|---|---|
| Insert as Quote with Footnote at Cursor | Puts the passage into your text, in quotation marks „…“, with a footnote naming the document and the page, for example “Purchase Agreement, S. 2.” The quote is at the same time linked to its source: with the document, the page and the wording. |
| As Evidence for the Selection in the Text… | You have selected a statement in your text. The command opens the Evidence sheet with document, citation and original passage already filled in. That is how you link the statement with its source. |
| Save as Note | Files the passage as a text of its own, “Excerpt: …, S. 2”, right after the file in Research: the quote, below it the source and “added on” with the date. It is linked to the file. |
| Copy with Citation | Puts the passage with its citation on the clipboard: „…“ (Purchase Agreement, S. 2). |
The button itself (“Use Quote”, without the arrow) chooses for you: if something is selected in your text, it links the selection with the citation (evidence). Otherwise it inserts the quote with a footnote at the cursor.
Goethe Write tidies the passage as it goes: line breaks and double spaces become one space, words hyphenated at the end of a line are joined again. If the source is in the folder “Anlagen” (type of work Law), the footnote also gives the number, for example “(Anlage K 1)”. Pages are written “S. 2”, “S. 2 f.” or “S. 2–4”. The abbreviation “S.” (for Seite, page) is German in every interface language.
The quote lands in the editor you last wrote in: the main text or, if you have a second text open beside it, there. If no text is open, Goethe Write copies the quote with its citation to the clipboard and says “No text open: quote copied with citation”.
Short notes above the PDF confirm every step: “Inserted as a quote in “Chapter 3””, “Saved as note “Excerpt: …””, “Copied with citation”, “First select the passage in the text that should be supported” or “The passage couldn’t be applied”.
Why evidence? Linked evidence knows its document, its page and its wording. With Check Paragraph (⌃⌘P, see Chapter 4) Goethe Write later checks whether the passage really stands in the document. A mistake shows up before someone else finds it. How evidence and sources work otherwise is described in Chapter 10 and Chapter 11.
Example: You are writing a nonfiction book about the Hanseatic League. In the essay PDF you highlight a sentence about the cog and click Use Quote. It appears in your chapter with the footnote “Schmidt, S. 114.” Later you check the paragraph, and Goethe Write confirms that the sentence stands on page 114.
Scanned pages: text recognition
A scanned PDF consists of pictures of pages, not of text. You can read it, but you cannot search it, highlight it or quote it. Text recognition reads the text in the pictures and makes it usable.
A page counts as scanned if it has fewer than about twenty characters of text of its own. A stamp or a page number does not make a page searchable. As soon as a PDF has such pages, the reader shows a line below its bar, for example “Scanned PDF without text: it can be searched and cited only after text recognition.” or “3 pages without text: searchable only after text recognition.”
How to recognise the text:
- Open the PDF.
- In the line below the bar, click Recognize Text.
- A progress bar shows where the recognition stands (“Recognizing page 3 of 12…”). You can keep working. With Cancel you stop the recognition (“Text recognition was canceled.”).
- At the end Goethe Write reports, for example, “12 pages recognized, 3,400 words. The PDF is now searchable.”
For this Goethe Write uses the Mac’s own text recognition (Vision), first with German, then with English. It is not a function of the writing assistant Goethe and needs no key. A page takes about a second.
The recognition does two things:
- It lays the recognised text invisibly into the scanned pages of the PDF. The pages look as before, but you can now search, select, highlight and quote, with page numbers. Highlights you have already made stay.
- It puts the text as a text of its own next to the file: “… (erkannter Text)”, with a heading “Seite n” before each page. The suffix and the headings are German in every interface language. The text is linked to the file. You find it in the sidebar right behind the file.
The button Recognized Text below the PDF opens this text beside it in the second pane so that you can compare it with the scan. Machines do not read without errors. Read the recognised text against the scan and correct mistakes in the text. The project search finds it, you can quote it like any text, and it counts as a source when you check evidence.
If you recognise again later, Goethe Write replaces the earlier recognised text but first keeps its wording as a snapshot (“Before New Text Recognition”). You lose no correction. For a PDF, the recognition reads only the pages that still have no text.
If all pages are already searchable, Goethe Write says “All pages already have searchable text.” If it finds nothing on the pages, it reports “No text was found on the pages.”
Recognising images
An image (for example a photograph of a book page or of a letter) can be recognised too. The bar below the image has Recognize Text for it. Images of these kinds are recognised: png, jpg, jpeg, heic, heif, tif, tiff, gif, bmp and webp. Multi-page TIFFs are read page by page.
- Open the image in Research.
- Click Recognize Text below the image. (“Recognizing text…” or, with several pages, “Recognizing page 2 of 5…”.)
- Afterwards the text stands as “… (erkannter Text)” next to the image. Recognized Text opens it alongside. Recognize Again reads the image once more and keeps the earlier wording as a snapshot.
For images there is no invisible layer, since an image has no pages to put one in. You work with the recognised text.
If Goethe Write cannot read the file as an image or a PDF, it reports “The file can’t be read as an image or PDF.”
Example: You are researching for a screenplay and have photographs of pages from an archive. You recognise the text of each page and afterwards search the project for the witness’s name. The match opens the page.
Tip: The recognition is good but not perfect. Names, numbers and marginal notes it misreads most often. Check it before you quote it.
Research beside the text
Material helps most when you see it beside your text. That is what the second pane is for.
The second pane
The second pane is a second area beside your text. It holds another text, a PDF, an image or another file. It takes the place of the Inspector so that the window never has four columns: as long as it is open, the Inspector is closed. If you call up the Inspector, the second pane closes.
How to open it:
- Choose View ▸ Second Pane or press ⌥⌘↩.
- The pane opens with whatever fits beside your text: if a text is open on the left, it shows the document you used last here, otherwise the first PDF of Research. If a document is open on the left, it shows the text you worked on last.
- The same command closes it again. The × at the top right of the pane does the same.
Other ways in:
- Entry ▸ Open Alongside: Shows the selected entry in the second pane.
- Open Source Alongside: In the right-click menu on a source in the text and in the results of “Check Paragraph”. The PDF opens at the page of the citation, and the text you are checking stays in view.
- Open Document on evidence in Case File, Arguments and Chronology (see Chapter 10).
The pane shows files with their readers: PDFs in the reader with search, highlighting and quoting as described above, other files with the Mac’s preview. You can write texts there as in the main text. The ribbon acts on the text where the cursor stands, in the main text or in the second pane.
Important: The second pane does not open in focus mode. While Focus is on, the page stands alone (see Chapter 5).
The head of the second pane
The head line of the pane has, from left to right:
| Element | Effect |
|---|---|
| ‹ › | Back in the Second Pane and Forward in the Second Pane: the pane has its own history. |
| Title menu ▾ | Shows what is here; a click chooses something else. The field “Text, character, place, or document” searches by title; under “Recent” stand the up to five entries shown last. You can also use “Choose Text or Document” when the pane is still empty. |
| Put Below the Text / Put Right of the Text | Switches the arrangement. |
| Sync | Only with two texts: both texts scroll along proportionally when you scroll. |
| ⋯ | Swap Sides, Open on the Left and, for files, Open with Another App… |
| × | Closes the pane (⌥⌘↩). |
Swap Sides exchanges the two areas: on the left now stands what was on the right, and the other way round. Open on the Left shows the entry of the second pane in the main area.
Beside or below the text
The default is beside the text, on the right. With the button Put Below the Text in the head of the pane you put it under the text. The button then reads Put Right of the Text. Your last choice holds for the next window.
- Beside the text, the pane has half the width of the middle, never less than 360 points, and at least 360 points stay beside it for the text.
- Below the text it has half the height, never less than 200 points, and at least 200 points stay above it.
- You drag the line between the areas with the mouse to make the pane wider or narrower.
Scroll in Sync
If you have two texts side by side (for example an old and a new version), Scroll in Sync lets both run together: if you scroll one by a certain share of its text, the other follows by the same share. You turn it on in the View tab, group Window, or in the View menu, or with the button in the head of the pane. It applies as soon as two texts are open. Otherwise Goethe Write says: “Applies as soon as a second pane is open.”
The arrangement “Research”
If you work a lot with material, you put it beside the text with one command: View ▸ Arrangement ▸ Research (⌃⌘2). The arrangement “Research” does three things:
- It opens the second pane with the Research entry you used last here. If there is none, it takes the first PDF, otherwise the first file, otherwise the first entry of Research.
- It shows the sidebar.
- It sets the text to Draft.
There are three arrangements:
| Arrangement | Shortcut | What it does |
|---|---|---|
| Writing | ⌃⌘1 | Closes the Inspector, shows the sidebar, sets the text to Draft and switches to the Text view. |
| Research | ⌃⌘2 | Opens the second pane with Research, shows the sidebar and sets the text to Draft. |
| Correction | ⌃⌘3 | Shows the Inspector with the tab Notes, hides the sidebar and shows the text as pages. |
You find the arrangements in the View tab, group Window, command Arrangement, and in the View menu.
Example: You are writing a brief. With ⌃⌘2 the case file opens beside the reply, the PDF you used last. You highlight a sentence in the contract, click Use Quote, and the footnote stands in the brief. With ⌃⌘1 you return to quiet writing.
A text in a new window
If you want a whole further window instead of the second pane, choose Entry ▸ Open in New Window or, in the View tab, group Window, Open in New Window. That is handy when you work on a second screen. The command is grey as long as nothing is selected on the left (“Choose on the left what should appear in a new window”).
Next comes the structure of the project in Chapter 6, evidence and sources in Chapter 10 and checking in Chapter 11.