File: tabs-and-items.rst

package info (click to toggle)
copyq 3.7.3-1~bpo9+1
  • links: PTS, VCS
  • area: main
  • in suites: stretch-backports
  • size: 10,480 kB
  • sloc: cpp: 51,894; sh: 734; python: 211; xml: 57; makefile: 34
file content (62 lines) | stat: -rw-r--r-- 1,781 bytes parent folder | download | duplicates (3)
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
Tabs and Items
==============

.. _tabs:

Tabs
----

Tabs are means to organize texts, images and other data.

Initially there is only one tab which is used for storing clipboard and
the tab bar is hidden.

User can create new tabs from "Tabs" menu or using ``Ctrl+T``. The tab
bar will appear if there is more than one tab. Using mouse, user can
reorder tabs and drop items and other data into tabs.

If tab name contains ``&``, the following letter is used for quick
access to the tab (the letter is underlined in tab bar or tab tree and
``&`` is hidden). For example, tab named "&Clipboard" can be opened
using ``Alt+C`` shortcut.

Option "Tab Tree" enables user to organize tabs into groups. Tabs with
names "Job/Tasks/1" and "Job/Tasks/2" will create following structure in
tab tree.

::

    > Job
        > Tasks
            > 1
            > 2

Storing Clipboard
-----------------

If "Store Clipboard" option is enabled (under "General" tab in config
dialog) and "Tab for storing clipboard" is set (under "History" tab in
config dialog), every time user copies something to clipboard a new item
will be created in that particular tab. The item will contain only text
and data that are needed by plugins (e.g. plugin "Images" requires
``image/svg``, ``image/png`` or similar).

Organizing Items
----------------

Any data or item can be moved or copied to other tab by dragging it
using mouse or by pasting it in item list.

Commands can automatically organize items into tabs. For example,
following command will put copied images to "Images" tab (to use the
command, copy it to the command list in configuration).

.. code-block:: ini

    [Command]
    Name=Move Images to Other Tab
    Input=image/png
    Automatic=true
    Remove=true
    Icon=\xf03e
    Tab=&Images