Lem/Docs

figures

List the figures found in one paper's sources.

Invocation#

Shell
lem-cli figures <id-or-title>

Inputs and options#

  • id-or-title is required and uses the shared exact-id or title-substring lookup.
  • Words after figures are joined with spaces, so an unquoted multiword title is accepted.

Output and state#

Prints the encoded LemFigureTools manifest for the selected paper. It inspects the paper's figure sources and does not generate or write a figure.

The sources are the main manuscript and every file it includes; an inclusion is any command whose brace argument names a `.tex` file that exists beside the source, read by the file it names rather than by the command's word. The same manifest serves the backend's figures route, figure generation, TikZ figures and the library's generated tasks.

Refusals#

  • An empty selector refuses with “this command requires a paper id or title”.
  • An unmatched selector refuses and names both the query and registry path.
  • A main manuscript or an included file that cannot be read refuses with “manuscript source <path> cannot be read: <cause>”; it is never listed as a file without figures. The backend's figures route, figure generation and TikZ figures answer the same sentence, and a library load that generates tasks fails with it instead of generating over a short figure list.