CaseLeaf

Handbook / The `talk` command

The talk command

Half your marks are working notes and half are questions for the client, and only the second kind should leave the building.

Puts a mark up for discussion, or takes it back down. A review has two kinds of mark: the ones you are still thinking about and the ones you are asking somebody about, and this is the switch between them. What is up for discussion is what share sends, so this is also how you decide what leaves the building.

How you run it

caseleaf talk report.pdf --page 1 --index 2

caseleaf talk report.pdf --page 1 --index 2 --off

What each part means

In full, every part it will take:

caseleaf talk <file> --page <n> --index <n> [--off]
part what it is for
<file> The PDF to work on, as a path, such as report.pdf beside you, or the full path to it. This command writes to it, so keep a copy if the original matters.
--page Which sheet, counting from 1, so --page 4 is the fourth sheet as it sits in the file, whatever number is printed on it. This command needs it, together with --index: the two name one mark between them.
--index Which mark on that page, counting from 0.
--off Take the mark back down from discussion, so it stops being one of the marks share sends. Without it the mark is put up.

What comes back

Asked of a short sample document, it answers as below. The sample has eight sheets, a highlight and a note left by a reviewer, a web link, a small table, two pictures and one form field already filled in.

{
  "shared" : true
}

The same thing from AppleScript

Everything above can be asked for from a script instead. There is one AppleScript command, perform: on names the document, and options takes the rest exactly as you would type it.

tell application "CaseLeaf"
    perform "talk" on "/path/to/report.pdf" ¬
        options "--page 1 --index 2"
end tell

tell application "CaseLeaf"
    perform "talk" on "/path/to/report.pdf" ¬
        options "--page 1 --index 2 --off"
end tell

All the commands · Asking from a script · Contents