FileTags/FileTags.Eng.hlf at master · iyudincev/FileTags · GitHub

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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
.Language=English,English
.PluginContents=FileTags

@Contents
$   #FileTags 1.7 for FAR Manager 3#

   The plugin implements file tags management within a single directory.
File tags are stored in file descriptions; the plugin takes the description of
a file as a set of comma-separated tags.

   Features:

   - browsing the ~plugin panel~@Panel@ with filtering the directory contents
by tags;
   - calling the plugin from the ~command line~@CommandLine@;
   - copying files to the ~plugin panel~@Panel@ applies current tags;
   - ~editing the tags~@Description@ of selected files;
   - ~creating~@CreateTag@ and removing tags in the ~plugin panel~@Panel@.


 ~Plugin settings~@Config@

   _____________________________

   (c) Igor Yudincev, 2014
   Email: igor.yudincev@@gmail.com

@Panel
$   #Plugin panel#

   The plugin panel contains the directory files (no subdirectories) filtered
by chosen tags. The filter is displayed in the caption of the panel. The tags
that can be used for further filtering are shown as virtual folders; entering
such a folder adds the tag to the filter.

   Common file actions are available in the panel. Copying files to the panel
means copying them to the current directory, then the files are assigned the
tags from the working plugin panel filter.

   Press #F7# to ~create~@CreateTag@ a new tag.

   #F8# on a tag removes it from all files shown on panel at the moment.

   Tags cannot be renamed with F6; use the ~tags editing dialog~@Description@ (#CtrlZ#)
for these operations.

@CommandLine
$   #Calling plugin from command line#

   The following line opens the ~plugin panel~@Panel@ and sets tag1 and tag2 as the
working tag filter for files:

   tags:tag1,tag2


 ~Features~@Contents@

@CreateTag
$   #Tag creation dialog#

   The dialog is invoked from the ~plugin panel~@Panel@ with #F7#. Entered tags
are added to the panel filter. Multiple tags can be entered, separated with commas.


 ~Features~@Contents@

@Description
$   #Tags editing dialog#

   The dialog is invoked from the ~plugin panel~@Panel@ with #CtrlZ#. Two tag lists,
tags to add and tags to remove, are available for editing; the former one gets
the list of tags, which are common for all selected files, as the default text.
Checked option #Replace existing tags# means that the tags of each selected file
will be replaced with the list from #Add tags:# text field.

   If plugin panel selection includes virtual "subfolders" (i.e. tags) then the
dialog action is applied to all selected files and also files which belong to
those "subfolders".

   #Select...# button invokes the ~tags selection menu~@DescriptionMenu@.

   #Description# field allows to enter a text description for the selected file.
The field is disabled for multiple files selected, or if ~Tag list marker~@Config@ option
is not specified.


 ~Features~@Contents@

@DescriptionMenu
$   #Tags selection menu#

   The menu allows selection of tags for the ~tags editing dialog~@Description@. It
shows all tags in the directory. The tags found in #Add tags:# and #Remove tags:#
fields are marked with #+# and #-# symbols respectively.

   +, - and Space keys control menu items selection.

   Enter key closes the menu and copies selected tags to the corresponding fields
of the ~tags editing~@Description@ dialog; if the chosen tag has no symbol mark,
it is also copied to #Add tags:# text field.


 ~Features~@Contents@

@Config
$   #Plugin settings#

  #Show file in panel if its tag list:# - this option defines how the panel filter works.
                        The current mode is displayed in the panel caption
                        (square brackets around the caption denote filter by exact tag match).

  #Tag list marker#     - sequence of characters in file description string which
                        indicates the presence of a tag list for the file. The part
                        of the string before the marker is considered as description text,
                        the part after is treated as comma-separated list of file tags.
                        If the marker is not specified then the whole description string
                        is treated as list of tags, so the description text is unavailable.

  #Remember panel mode# - store the user-selected panel mode and restore it
                        next time the plugin is opened. When the option is off,
                        the current file panel mode is used.


 ~Features~@Contents@