PAPIS-OPEN(1)

NAME
papis-open - open command

The open command is a very important command in the papis workflow. With it you can open documents, folders or marks.

MARKS

One of special things about this command is the possibility of creating marks for documents. As you would imagine, it is in general difficult to create marks for any kind of data. For instance, if our library consists of pdf files and epub files for instance, we would like to define bookmarks in order to go back to them at some later point.

How you define marks can be customized through the marks configuration settings here. The default way of doing it is just by defining a marks list in a document. Let us look at a concrete example:

author: Isaiah Shavitt, Rodney J. Bartlett
edition: '1'
files: [book.pdf]
isbn: 052181832X,9780521818322
marks:
- {name: Intermediates definition, value: 344}
- {name: EOM equations, value: 455}
publisher: Cambridge University Press
ref: book:293288
series: Cambridge Molecular Science
title: 'Many-Body Methods in Chemistry and Physics'
type: book
year: '2009'

This book has defined two marks. Each mark has a name and a value. If you tell the open command to open marks, then it will look for the marks and open the value (page number). This is the default behaviour, however if you go to the configuration you'll see that you can change the convention to what it suits you.

EXAMPLES

•   Open a pdf file linked to a document matching the string bohm

    papis open bohm

•   Open the folder where this last document is stored

    papis open -d bohm

    Please notice that the file browser used will be also related to the file-browser setting.

•   Open a mark defined in the info file

    papis open --mark bohm

CLI

  papis open

Open document from a given library

papis open [OPTIONS] [QUERY]

Options

-h, --help
    Show this message and exit.

--doc-folder <doc_folder>
    Apply action to a document path

--tool <tool>
    Tool for opening the file (opentool)

-d, --dir
    Open directory

--all
    Open all matching documents

-m, --mark, --no-mark
    Open mark

    Arguments

QUERY
    Optional argument

AUTHOR
Alejandro Gallo

COPYRIGHT
2017, Alejandro Gallo