File: commandline.page

package info (click to toggle)
papers 48.3-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 23,096 kB
  • sloc: ansic: 38,478; sh: 195; xml: 127; makefile: 117
file content (63 lines) | stat: -rw-r--r-- 2,310 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="commandline">

  <info>
    <link type="guide" xref="index#advanced"/>
    <title type="sort">Command line</title>
    <desc>The <cmd>papers</cmd> command can open any number of files, at specific pages and in various modes.</desc>
    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
    <revision pkgversion="3.24" version="0.2" date="2017-09-17" status="final"/>
    <credit type="author">
      <name>Phil Bull</name>
      <email>philbull@gmail.com</email>
    </credit>
    <credit type="editor">
    <name>Tiffany Antopolski</name>
    <email>tiffany@antopolski.com</email>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
  </info>

<title>The command line</title>
<p>
To start <app>Papers</app> from the command line, type <cmd>papers</cmd>. You
can open a specific file by typing the filename after the papers command:
</p>

<screen>papers file.pdf</screen>
<p>
You can open multiple files by typing the filenames after the papers command, separating the filenames by a space:
</p>
<screen>papers file1.pdf file2.pdf</screen>
<p>
<app>Papers</app> also supports the handling of files on the web.  For example, after the papers command you can give the location of a file on the web:
</p>
<screen>papers http://www.claymath.org/millennium/P_vs_NP/pvsnp.pdf</screen>
<section id="open">
    <title>Opening a document at a specific page</title>
    <p>
    You can use the <cmd>--page-label</cmd> switch to open a document at a
    specific page. For example, to open a document to page 3, you would type:
    </p>
    <screen>papers --page-label=3 file.pdf</screen>
    <p>
    The page label should be in the same format as the page number displayed in
    the <app>Papers</app> header bar.
    </p>
</section>
<section id="fullsreen">
    <title>Opening a document in fullscreen mode</title>
    <screen>papers --fullscreen file.pdf</screen>
</section>
<section id="presentation">
    <title>Opening a document in presentation mode</title>
    <screen>papers --presentation file.pdf</screen>
</section>
<section id="preview">
    <title>Opening a document in preview mode</title>
    <screen>papers --preview file.pdf</screen>
</section>
</page>