Avoid possible confusion
[llpp.git] / KEYS
blobc2dbc2d95098e0858b287ea4bce5155546061656
1 -----Quitting-----
2 escape/q                - quit
3 Q                       - quit without saving the configuration
5 -----Movement-----
6 up/down arrow           - scroll up/down
7 j/k                     - scroll up/down
8 left/right arrow        - pan left/right (when zoomed in)
9 control + arrows        - scroll up/down, pan left/right (by half a screen widht/height)
10 space                   - go to the next page
11 delete                  - go to the previous page
12 pageup/pagedown         - go forward/backward one screen-full
13 g, G                    - go to first/last page
14 home/end                - go to first/last page
16 -----Advanced Movement / History-----
17 backspace               - go back after jumping (clicking link and suchlike) [1]
18 Alt-left/right arrow    - go backward/forward in history
19 0..9                    - enter page number to jump to
20 t                       - align top of the screen with the top of the page
21 <,>                     - rotate
22 Ctrl pageup/pagedown    - align top of the screen with first/last visible page
23 F                       - go to hinted link
24 a                       - autoscroll
25 if auto scrolling is active:
26     up/down arrows and mouse buttons 3/4 will make scrolling go faster/slower
28 -----Mouse-----
29 primary mouse button[2] - click on link or select text[3]
30   when shift is held    - execute "synctex command" with coordinates of the point [4]
31   when control is held  - pan
32   zoom to block         - when in block zoom mode
33   otherwise             - pan if there's no text/link under the cursor
34 mouse buttons 3/4       - scroll up/down (aka mouse wheel)
35   when control is held  - zoom
36 mouse buttons 5/6       - pan left/right (aka horizontal mouse wheel)
37 other mouse button[2]   - select rectangle to zoom to
39 Note:
40 (moving mouse while holding primary mouse button will pan the page,
41  if the mouse is over selectable element (text/link) holding control
42  will make the page pan instead of the default action (selecting text/
43  clicking link))
45 -----Bookmarks-----
46 m                       - create named bookmark
47 ~                       - create quick bookmark
49 -----Zoom-----
50 control + shift up/down - set previous zoom level
51 B                       - toggle zoom block mode
52 w                       - change height of the window to encompass all of the page
53 Alt-c                   - center view
54 Ctrl-+/Ctrl-=           - zoom in
55 Ctrl--                  - zoom out
56 Ctrl-0                  - reset zoom and panning
57 Ctrl-1                  - fit tallest page
58 Ctrl-2                  - fit tallest page height exactly
59 Ctrl-3                  - cycle fit models
60 Ctrl-9/F9               - enter bird's eye view
62 -----Actions-----
63 u                       - dehighlight
64 r                       - reload document [5]
65 y                       - select link and paste its description to the clipboard
66 |                       - pipe selection through specified command
67 x                       - run pax command on selected region
68 Ctrl-p                  - launch a command with the document path as an argument
69 return                  - (in link navigation mode) follow link
70 =                       - show current position
71 e                       - view error log
72 z                       - crop
74 -----Search-----
75 /,?                     - enter text to search for (/ - forward, ? - backward)
76 n                       - repeat last search (forward)
77 p, N                    - repeat last search (backward)
78 Ctrl-g                  - interrupt search
79 u                       - dehighlight
81 -----Settings / Modes-----
82 [,]                     - decrease/increase page brightness
83 +                       - set page bias
84 -                       - toggle/set tunable
85 b                       - toggle scroll bar
86 l                       - toggle highlighting of the links
87 f                       - toggle fullscreen
88 insert                  - toggle link navigation mode
89 B                       - toggle zoom block mode
90 o                       - switch to outline mode
91 '                       - switch to bookmark mode
92 h,F1                    - switch to help mode
93 i                       - switch to info mode
94 P                       - switch to "presentation" mode
95 c                       - switch to previous column layout
97 -----Tunables-----
98 -i                      - toggle case sensitivity of searches
99 -s<number>              - set scroll step (pixels)
100 -S<number>              - set space between pages (pixels)
101 -c                      - toggle crop hack
102 -a                      - toggle throttled scrolling
103 -R<number>              - rotate
104 -p                      - toggle preloading
105 -v                      - toggle verbosity
106 -P                      - toggle persistent bookmarks
107 -h                      - toggle maxfit
108 -l                      - toggle proportional display
109 -Z<number>              - set zoom (percent)
110 -A<number>              - set auto scroll step (pixels)
111 -t<number>              - set thumbnail width (pixels)
112 -T                      - toggle trimming of margins
113 -I                      - invert colors
114 -M                      - toggle pax mode
115 -C<number>              - set column count
116 -x<string>              - set command to run on selection
117 -f                      - toggle "what's under cursor" identification
118                         - (or "what's currently selected" in link navigation mode)
119                         -     (font name of the text under cursor or link target)
121 -----Bird's eye mode-----
122 Ctrl-9,F9,esc           - leave bird's eye view
123 Ctrl-l                  - center the view on the currently selected page
124 (page)up/(page)down     - navigate
125 home/end                - go to first/last page
126 enter                   - select the page and leave bird's eye mode
127 1st mouse button        - select the page under cursor and leave bird's eye mode
129 -----Outline/bookmark/help/info mode-----
130 esc                     - leave outline/bookmark mode
131 up/down                 - select previous/next item
132 alpha-numeric           - quick search
133 Ctrl-s                  - repeat search (forward)
134 Ctrl-r                  - repeat search (backward)
135 Ctrl-l                  - center on current item
136 Ctrl-left/right         - pan text left/right
137 Ctrl-up/down            - scroll view up/down
138 Ctrl-insert             - copy active item's text to clipboard
140 -----Outline mode-----
141 left/right              - go up/down a level
142 Ctrl-a                  - toggle auto narrowing
143 /                       - enter auto narrowing
144 tab                     - begin nested narrowing
145 Ctrl-n                  - narrow to search pattern
146 Ctrl-u                  - undo narrowing
147 Ctrl-S                  - synchronize
149 -----Info mode-----
150 enter                   - toggle/enter new value for selected parameter
152 -----When entering search pattern/page number-----
153 up/down arrow           - previous/next entered text
154 enter                   - confirm
155 Ctrl-g,esc              - cancel
157 double/triple/quadruple/... clicks in view mode will pipe the
158 word/line/block/page through pax command when control is held
159 and selection command otherwise
161 [1] if the document was previously visited initial backspace will
162     jump to the last visited place
164 [2] i'm somewhat mouse button confused, since i use "left handed" mouse
165     while not being left handed
167 [3] text selection requires
168     xsel on X11         - http://www.vergenet.net/~conrad/software/xsel/
169     wsel under Windows  - http://repo.or.cz/w/llpp.git/blob/master:/wsel.c
170     pbcopy under OSX    - ships with the system
172 [4] arguments to the command are:
173     1 = path to the document
174     2 = zero based page number
175     3 = X coordinate within the page
176     4 = Y ..........................
178 [5] document will also be reloaded upon reception of the HUP signal
180 -----Caveat emptor-----
181 o Selection can not cross page boundaries
182 o Text searching is very naive