CaseLeaf

Handbook / The `group` command

The group command

Six marks belong to the same exhibit and should move, and be picked, as one thing from now on.

Puts marks in a new group together, the same way gathering several on the page and choosing Group does. Clicking any member afterwards takes the whole group, and lining marks up moves it as a whole. Naming marks that already share an outer group nests a level rather than doing nothing, the same as the window; naming a set that is already exactly one group refuses, since grouping it again would add a level nothing on the page could show.

How you run it

caseleaf group report.pdf --marks A7854269-5A2E-44CF-A182-04F26A809A38,E3BD69F4-A136-445D-AA71-BB468A3C9E1B

What each part means

In full, every part it will take:

caseleaf group <file> --marks <id>,<id>,…
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.
--marks The marks to group, by the identifiers marks prints for them, two or more, separated by commas such as --marks m-1,m-2,m-3. All must sit on the same page.

Some of a group become a group inside it, the same way the window does it: naming marks that already share an outer group nests a level rather than doing nothing. Naming a set that is already exactly one group refuses, since grouping it again would add a level nothing on the page could show.

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.

{
  "grouped" : "47B2-B12F-69E0E32DFE89",
  "marks" : [
    "8C7A21E0-0000-4000-8000-000000000000",
    "8C7A21E0-0000-4000-8000-000000000000"
  ]
}

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 "group" on "/path/to/report.pdf" ¬
        options "--marks A7854269-5A2E-44CF-A182-04F26A809A38,E3BD69F4-A136-445D-AA71-BB468A3C9E1B"
end tell

All the commands · Asking from a script · Contents