@@ -697,25 +693,7 @@ 2.4. File Operations
F2, Shift+F6
-
-
| Parameter | -Value | -Description | -
|---|---|---|
| extension | -1/true/on/yes | -show extension (default) | -
| 0/false/off/no | -hide extension | -
@@ -697,25 +693,7 @@
| Parameter | -Value | -Description | -
|---|---|---|
| extension | -1/true/on/yes | -show extension (default) | -
| 0/false/off/no | -hide extension | -
@@ -1132,6 +1110,18 @@ 
+
+ 
+ 
+ 
diff --git a/doc/en/configuration.html b/doc/en/configuration.html
index e85e51ae..e07cb8e5 100644
--- a/doc/en/configuration.html
+++ b/doc/en/configuration.html
@@ -110,20 +110,21 @@ extassoc.xml – file extension association configuration;
favoritetabs.xml – favorite tabs;
history.xml – command line and directory history, search and replace, etc.;
localconfig.xml – directory hotlist;
multiarc.ini – external archivers;
pixmaps.txt – maps file extensions to MIME-types icon names;
session.ini – size, position and state of child program windows (these settings are saved separately for each screen resolution);
You can select fonts for the editor (F4), viewer (F3), file panels (Main Font) and other elements of the Double Commander interface, and also their size. The bottom line for each allows you to see how the display of the selected font looks. One important note: the fonts for the editor and viewer must be MONOSPACE. The figure below illustrates a proportionally spaced font in the window above (notice the strange spacing) and a monospace font in the window below which appears correctly spaced. Also, with some proportional fonts the characters may overwrite each other and look quite strange.
Normal (proportional) font above, monospaced below.
-Also you can use Ctrl+mouse wheel to change the font size, this function works for the following interface elements or part of Double Commander:
-file list in left and right panels;
current directory (address) bar;
function key buttons bar;
TreeView menu;
search results in find files dialog;
internal editor;
internal viewer (if viewer shows text then this action will change font size, if image then action will work as zoom in/zoom out commands).
Also you can use Ctrl+mouse wheel to change the font size, see the Mouse section for details.
Also you can choose the type of font rasterization (regardless of the system settings), see description of <Quality>.
Left: – files selected for copying or deleting on the left.
Right: – files selected for copying or deleting on the right.
Unknown: – files with the same names, but not identical.
Selection: – background color for the file under the cursor or selected files.
6. Drive Free Space Indicator – here you can change the appearance of the drive free space indicator:
The second part of the Unix/Linux template displays permissions: read (r), write (w), execute (x). The values are grouped in groups of three in the following order: user (owner), user's group, all others.
If attribute should not be set, it must be replaced with the "-" symbol, unnecessary attributes should be hidden: symbol "*" means match any number of characters, symbol "?" means any one character. For example, ?r* (Windows) or ?r-* (Linux) will find all read-only files and folders.
You can use a color from the list or specify yours using the ".." button.
-Do not forget to click "Apply" button after customization.
Double Commander checks the list from top to bottom until the first match: a rule higher in the list will overlap any rule below.
The first group of parameters is Selection:
Selection by mouse – enables the ability to select and unselect files and folders with the mouse.
Line by line – the cursor remains on the file and scrolling takes place immediately. Also you can specify the number of lines.
Page by page – the same as previous, but scrolling is by pages rather than by lines (much faster scrolling).
Zoom – Double Commander allows to use Ctrl+mouse wheel to change font sizes. It works for the following interface elements or part of the program:
+file list in left and right panels;
current directory (address) bar;
function key buttons bar;
TreeView menu;
search results in find files dialog;
internal viewer (if viewer shows text);
internal editor.
Zoom with Ctrl + Scroll Wheel – enables or disables this feature.
Open with – will determine what will launch the action when you are using the mouse button on an element from the displayed file list in a panel:
A double click is necessary to launch the action (default).
GETFILEOWNER – displays the owner of the file.
GETFILELINKTO – displays the path and file, that is, what is linked with this symlink.
GETFILETYPE – file type (as in Windows Explorer or MIME-type).
GETFILECOMMENT – file or directory description (comment) from descript.ion (see details here).
GETFILECOMMENT – file or directory description (comment) from descript.ion (see details here). This field can also be used inside archives (if the archive format supports saving file descriptions and the corresponding external archiver is configured to receive them).
GETFILECOMPRESSEDSIZE – compressed file size (real size if using NTFS compression).
By default, fields with timestamps use the date and time format that was choosen in the Files views settings section. You can also specify your preferred format directly in the column inside the curly brackets, using the same date and time formatting characters.
@@ -697,14 +701,18 @@Configure – opens the plugin's own settings window (if selected plugin supports this feature).
Double Commander supports the use of a master password to protect passwords in WCX and WFX plugins (if the plugin developer has provided for the use of this feature). This is convenient because your passwords will be protected by encryption and you need to remember only one password. Passwords are encrypted twice, first using Blowfish (448 bits) and then using AES (256 bits).
-Note: At the moment, Double Commander does not support changing the master password: if necessary, you will need to disable the use of the master password in the plugin settings, close the program, open the directory with the configuration files, delete the pwd.ini file, run the program again and enable the master password in the plugin settings. To delete outdated or unnecessary saved passwords, you will need to close the program and manually edit the pwd.ini file.
+Double Commander supports the use of a main password to protect passwords in WCX and WFX plugins (if the plugin developer has provided for the use of this feature). This is convenient because your passwords will be protected by encryption and you need to remember only one password. Passwords are encrypted twice, first using Blowfish (448 bits) and then using AES (256 bits), the Argon2 function is used to derive a key from the main password.
+Double Commander supports two versions of the Argon2 algorithm (Argon2d and Argon2id) and allows to specify three parameters: number of iterations, memory required, degree of parallelism. RFC 9106 recommends using Argon2id if you does not know the difference between the versions or if side-channel attacks are considered to be a real threat. Increasing the number of iterations and/or memory size will increase the function's execution time and make it more difficult to crack the password; increasing the degree of parallelism (but without exceeding the number of logical cores of your processor) allows the function to work faster. It is also recommended to choose the parameters so that the function takes about 0.5-1 seconds (the more, the better, but if the values are too large, it may be inconvenient to use the main password).
+Note: If you actively use the portable version of Double Commander on a USB flash drive on several computers or use a centralized installation of the application with configuration files, then it may be practical to choose the settings suitable for the least performance computer.
+Note: At the moment, Double Commander does not support changing the main password: if necessary, you will need to disable the use of the main password in the plugin settings, close the program, open the directory with the configuration files, delete the pwd.ini file, run the program again and enable the main password in the plugin settings. To delete outdated or unnecessary saved passwords, you will need to close the program and manually edit the pwd.ini file.
You can change the layout of the main window here. I suppose, all the available options are explained on the screenshot above (Layout). The screenshot below illustrates what DC looks like with all the layout options unselected.
There are also several parameters available that can only be changed manually in the doublecmd.xml configuration file.
+Starting from macOS 11, Double Commanderhe has a toolbar in the window header by default, in addition to the main toolbar. You can disable this UI element manually: close Double Commander, go to the configuration files directory (see details here), open the doublecmd.cfg file, find the ModernUI parameter, change its value from True to False and run the application again.
2.10.1. Layout > Drives list button
@@ -767,10 +775,12 @@The Buffer size for file operations (in KB) and Buffer size for hash calculation (in KB) parameters set the size of the allocated memory for operations such as copying, moving, splitting or combining files, searching for files by content and calculating checksums. You should keep in mind that there is no universal value, but you can try to find a more suitable size.
Note: The first parameter is not used in the copy function in Windows, since the system function is used for copying.
Number of wipe passes – Here you can specify the number of rewrites to secure delete files.
-Process comments with files/folders – If enabled and you have a file/folder with a comment attached and you copy or move it to another folder the comment will be copied or moved to the destination along with the file/folder.
+Process comments with files/folders – If enabled and you have a file/folder with a comment attached and you copy or move it to another folder the comment will be copied or moved to the destination along with the file/folder. If you delete or erase a file, its comment will also be deleted. If you rename a file, its name will also be changed in the descript.ion file.
+ Otherwise, the descript.ion file will be processed as a regular file.
Skip file operations errors and write them to log window – If a file operation error should occur the error message will appear in the log window below the panels rather than appearing in a popup dialog. This can be useful because the error window will suspend the operation. In the Log settings section, you can limit the total number of messages, allowing only messages with the "Error" status.
The parameter is taken into account in most file operations: copying, moving, deleting, erasing, combining and splitting files, setting file properties (timestamps, owner, attributes), calculating checksum, as well as file operations when working with archives, WFX plugins and GVfs.
Duplicated name auto-rename style – sets the file auto-renaming template if a file with the same name already exists in the target directory (i.e. when you choose Auto-rename source files or Auto-rename target files in the copy/move dialog): "Copy (x) filename.ext", "filename (x).ext" or "filename(x).ext", where "x" is a counter (2, 3, 4 and so on).
+There are also several parameters available that can only be changed manually in the doublecmd.xml configuration file.
2.12.1. File operations > File search
@@ -870,8 +880,8 @@Command line history – Commands that were used at the command line.
File mask history – Double Commander saves a general history of used file masks for several tools: find files, filters in directory synchronization and archive unpacking, commands for selecting and deselecting a group of files.
The maximum number of entries in history is limited to 50.
-Note about the history of visited directories: During the session, Double Commander stores up to 255 visited directories in memory (however, when the program is closed, only the last 50 entries will be saved). You can change the number of history entries in the popup menu when calling the cm_DirHistory command (default value is 30, see the Count attribute in the <DirHistory> tag), but when using the Tree View Menu, all available history will be shown.
The maximum number of entries in history is limited to 50 by default (see the MaxStringItems attribute in the <History> tag).
Note about the history of visited directories: During the session, Double Commander stores up to 255 visited directories in memory, however, when the program is closed, the number of saved entries will be limited to the MaxStringItems value. You can change the number of history entries in the popup menu when calling the cm_DirHistory command (default value is 30, see the Count attribute in the <DirHistory> tag), but when using the Tree View Menu, all available history will be shown.
Note: Search templates are not related to the history and are saved separately (in the doublecmd.xml configuration file). To manage the list of templates, you can use the file search tool.
You can choose how the list of settings sections will look:
This section contains the settings of the quick search/filter tool. Quick search is used in searching for filenames in the panel, quick filter will hide all filenames that do not match the conditions.
-
Exact name match:
Beginning (name must start with first typed character) – means that the typed text will match the "text*" mask, where "*" is any number of any characters.
These options can be changed on the fly directly in the quick search/filter bar. Also you can toggle between search and filter.
Options:
Ignore diacritics and ligatures – allows to simplify the use of quick search/filter: when searching, Double Commander will replace letters with diacritics and ligatures with letters of the Latin alphabet (the table of common symbols is contained in the source code of the program).
Hide filter panel when not focused – The quick search/filter panel will hide automatically as soon as you move the focus to the file panel. In brief view hiding the panel does not work correctly, so the option is ignored until a suitable solution is found.
Keep saving setting modifications for next session – By default, all parameters that have been changed in the quick search panel will be kept in memory only until the program is closed, the option allows to change this behavior.
macOS only. This section of the settings lists installed applications that automatically create folders in iCloud Drive: you can choose the application folders that will be available in the iCloud virtual folder.
+
The first option enables the display of the file type icons to the left of the name:
Only standard icons – Only the icons listed in the pixmaps.txt file and the icons from the file association settings will be displayed. In this case, you can use icons only from the Double Commander icon theme (see directories pixmaps/dctheme/XxX/mimetypes in the program folder) or specify the full (with path) file name. Creating an icon theme is described in the FAQ.
No icons.
Show overlay icons, e.g. for links – If enabled, Double Commander will show overlay icons such as arrows for .lnk files and links.
+Show overlay icons, e.g. for links – If enabled, Double Commander will show overlay icons such as arrows for .lnk files and other overlay emblems and marks:
+Windows: Emblems from the operating system settings and third-party applications (for example, version control systems or local cloud storage directories).
Linux and other Unix-like systems (except macOS and Haiku): RabbitVCS emblems (if available) and emblems from the GIO/GVfs metadata subsystem (as in Nautilus, Caja, Thunar, PCManFM and other supporting it).
The symbolic link emblem and the additional broken/dangling link emblem will be displayed in any case.
Dimmed hidden files (slower) – If enabled, Double Commander will show icons for hidden files with 50% transparency.
Disable special icons – You can disable the loading of special icons (overlay icons, icons from .exe/.lnk files) for the specified directories and their subdirectories, just list them separated by semicolons ";" without spaces.
Icon size – You can choose from the following sizes:
@@ -963,7 +983,7 @@Note: In Unix-like systems, Double Commander will primarily use the system icon theme, if some icons does not exist, it will use its own.
Ignore specific files and folders (one per line): they will not be displayed in panels.
You can use the internal command cm_SwitchIgnoreList to turn this option on and off, add a button on toolbar or hotkey.
Please see the dedicated Archive handling help page about how to use and configure it.
This section contains the settings for tooltips when the mouse cursor is hovering over a file.
Show tooltip for files in the file panel – enables the ability to use tooltips.
@@ -1023,7 +1043,7 @@In the screenshot at the beginning of the section description, you can see an example of a tooltip with the textline.wdx plugin that shows the contents of the selected lines of a text file (in this case, the first, second and third lines), the Combine DC and system tooltip, system first mode is selected.
This item opens the configuration file associations. All association sets are contained in the file extassoc.xml.
Here you can customize file associations and set commands or scripts for chosen file types. Commands will be added to the context menu of files. Double Commander also allows to simply set (or replace) icons for file types, without adding any actions.
file – any file;
folder – any directory;
default – used when extension specific association does not exists.
default – used when extension specific internal association does not exists (only for the "Open", "View" and "Edit" actions, see below).
Insert – adds a new extension to the current position in the list.
Add – adds a new extension to the end of the list.
@@ -1081,12 +1101,12 @@<?command?> – runs "command" in the system shell and feeds the output to the command above.
At a minimum, you must specify a file name, usually %p or %p0 for the file under cursor.
Start path – command start directory. This directory will become the working directory of the program being launched, and if you do not need to explicitly specify it, then just leave this field empty: in this case, the working directory will be the current directory of the active file panel (regular files) or the system directory for the temporary files (files from archives and WFX plugins). Here we can use the variable %D, %d or environment variables.
+Start path – command start directory. This directory will become the working directory of the program being launched, and if you do not need to explicitly specify it, then just leave this field empty: in this case, the working directory will be the current directory of the active file panel (regular files) or the system directory for the temporary files (files from archives and WFX plugins). Here you can use the variable %D, %d or environment variables.
All available actions will be displayed in the "Actions" submenu in the context menu:
2.23.1. File associations > File associations extra
+2.24.1. File associations > File associations extra
Offer to add selection to file association when not included already – When accessing file association, offer to add current selected file if not already included in a configured file type. This is a quick way to add an "Open with" action: Double Commander will prompt you to specify a type name and an executable file, everything else will be done automatically.
Extended context menu – allows to add some items to the "Actions" submenu:
@@ -1110,11 +1130,11 @@Also you can apply the chosen way to the already added paths.
Please see the dedicated Directory Hotlist help page about how to use and configure it.
2.24.1. Directory Hotlist > Directory Hotlist Extra
+2.25.1. Directory Hotlist > Directory Hotlist Extra
In this section you can choose how the path will be set the path and target path:
The location of this doublecmd.xml file may be in different places:
We follow this link if we want to specify it by with the command line paramter --config-dir.
Other than that, we do Configuration > Options... > select in the tree 
> set the option Location of configuration files.
Another way to quickly find out where is located the doublecmd.xml the current instance of Double Commander is using is by accessing the Directory Hotlist. At the end of it there is a sub section called "Special Dirs". Then we select "Go to Double Commander special path" and then "%DC_CONFIG_PATH%". We will find there the doublecmd.xml that application is currently using.
@@ -152,10 +152,42 @@True) or text from the search history (False). True by default.| Value | +Description | +
|---|---|
| 1 | +Space characters will be displayed as a middle dot characters ("·", U+00B7). | +
| 2 | +Tab characters will be displayed as a long space (see Tab width) with a right-pointing double angle quotation mark ("»", U+00BB) at the beginning. | +
| 4 | +Tab characters will be displayed as a long space (see Tab width) with a right-pointing double angle quotation mark ("»", U+00BB) at the end. | +
False) or copy it back automatically (True). True by default.ExtraLineSpan can be set in Options > Files views extra ***<ExtraLineSpan>2</ExtraLineSpan>
@@ -279,7 +309,7 @@ True, the mouse click outside the name edit field will confirm renaming the file (as in Windows Explorer), otherwise, the mouse click will work the same as the Esc key.True, the mouse click outside the name edit field will confirm renaming the file (as in Windows Explorer), otherwise, the mouse click will work the same as the Esc key.False by default.MaxStringItems attribute allows to specify the maximum number of entries in the saved history. Default value is 50.False), when we disable the drives list button, its panel and free space label remain in the same place; otherwise (True), the panel will be hidden, and the free space label will be moved up to the drive buttons panel, adding space for the file list.False by default.ImageExifRotate tag configures Double Commander to indicate if we want the viewer to display the image using that information or not.| Value | -Description | -
|---|---|
| True | -Use the orientation flag embedded into the image file (default). | -
| False | -Ignore the orientation flag. | -
<ImageExifRotate>True</ImageExifRotate>
+ The ImageExifRotate tag configures Double Commander to indicate if we want the viewer to display the image using that information (True) or not (False). True by default.
Attribute Count (<DirHistory>)
+ Attribute MaxStringItems (<History>)
Attribute Save (<Asymmetric>)
Attribute Save (<FileMask>)
ActiveRight
AutoCopy
+ AutoCopyBackward
AutoExtractOpenMask
AutoSaveWidth
ConfirmQuit
@@ -659,6 +686,7 @@
- MaxCodeSize
MaxTextWidth
Mode
NtfsHourTimeDelay
@@ -682,6 +710,7 @@
The list of the following parameters will vary depending on the type of file operation and operating system family.
Verify – If enabled, Double Commander will compare the source file and the copied file in the target directory: a byte-by-byte comparison (Windows) or BLAKE2 checksums (Linux and others). Double Commander will try to minimize the disk cache effects (if the file system does not support direct input/output, the program will report the verification failure). Keep in mind, this function significantly reduces the speed of the operation. Please note that each file will be read twice, so the total size of files in the progress bar will be doubled. Not available in macOS.
Verify – If enabled, Double Commander will compare the source file and the copied file in the target directory: a byte-by-byte comparison (Windows) or checksums (Linux and others: BLAKE3 (x86-64), BLAKE2b (other 64-bit processors) or BLAKE2s). Double Commander will try to minimize the disk cache effects (if the file system does not support direct input/output, the program will report the verification failure). Keep in mind, this function significantly reduces the speed of the operation. Please note that each file will be read twice, so the total size of files in the progress bar will be doubled. In macOS, this feature is available experimentally.
Check free space – Before copying the file, Double Commander will check if there is enough free disk space in the target directory.
Reserve space – If enabled, Double Commander will use pre-allocation of disk space, this will reduce the chances of file fragmentation. Also this is a faster way to create files. In Windows, Double Commander always reserves space. Does not work in Linux on partitions with FAT32 file system.
Follow links – If enabled, Double Commander will consider symbolic links to folders as regular folders and copy their contents; instead of file links, the target files of this links will be copied. The indeterminate checkbox state (three-state): the program will ask each time what it should do.
First, packages gvfs, gvfs-backends and gvfs-fuse should be installed. Keep in mind that some distributions have not packages gvfs-backends and gvfs-fuse, because they are part of package gvfs, or it can be several packages with names gvfs-backends-* or gvfs-*.
-Now insert GVfs path in the address bar: click by right mouse button at address bar to edit it (or call internal command cm_EditPath).
+Now insert GVfs path in the address bar: click by right mouse button at address bar to edit it (or call internal command cm_EditPath). Alternatively, you can use the internal command cm_MapNetworkDrive.
For example, access to
ftp://ftpuser@ftpserverQ: How to make function keys and address bar bigger?
-A: The size depends on the font size, three ways exists:
-1. Simple and fast: you can use Ctrl+mouse wheel, it works for the following interface elements or part of DC:
- - file list in left and right panels;
- - current directory (address) bar;
- - function key buttons bar;
- - TreeView menu;
- - search results in find files dialog;
- - internal editor;
- - internal viewer (if viewer shows text then this action will change font size, if image then action will work as zoom in/zoom out commands).
Q: How to make function keys, address bar and other interface elements bigger?
+A: The size depends on the font size, several ways exists:
+1. Simple and fast: you can use Ctrl+mouse wheel, see Zoom.
2. Go to "Configuration" in the main menu > Options... > Fonts.
Note: All possible are available in version 1.0.0+ only, for 0.9.x and below additionally see the third item.
3. Close DC > open doublecmd.xml > find tag <Fonts></Fonts> and change <Size> of the interface element manually.
3. For file panels, you can use the internal commands cm_MainFontZoomOut and cm_MainFontZoomIn. Similar commands are available in the built-in viewer and editor.
+4. Close DC > open doublecmd.xml > find tag <Fonts></Fonts> and change <Size> of the interface element manually.
Q: File panels: how to change the height of elements (strings) and the intervals between them?
A: The view depends on the following parameters:
<FilesViews>)A: When assigning a hot key, Double Commander allows to limit the scope of the keyboard shortcut, see Only for these controls.
In this case, you need to enable the "Files Panel".
Q: Is there a way to add sound notifications when operations are completed?
+A: See description of <Sounds>.
diff --git a/doc/en/findfiles.html b/doc/en/findfiles.html index e7b3546f..962185f0 100644 --- a/doc/en/findfiles.html +++ b/doc/en/findfiles.html @@ -69,6 +69,7 @@This setting controls the depth of the search in the filesystem tree. If set to "current dir only", the search will only be conducted in the directory specified in the "Start in directory" field (not in any subdirectories).
The File mask field sets the mask for the search. Or we can just specify the file name or part of it.
+Note: Keep in mind that Double Commander saves a general history of file masks for several tools: find files, directory synchronization, archive unpacking, commands for selecting a group of files.
Additional options:
Search in archives – if enabled, Double Commander will try to additionally read the contents of all archives in the search directory(ies). The list of supported formats depends on the added packer plugins.
compare file names;
compare file sizes;
compare file hashes: BLAKE2b (x64) or BLAKE2s checksum will be used;
compare file hashes: BLAKE3 (x86-64), BLAKE2b (other 64-bit processors) or BLAKE2s checksum will be used;
compare file content (byte-by-byte comparison).
In the result will be shown file names, group number of matching files and file locations. Also after feed to listbox we can use special selection mode, where we can select only duplicates: @@ -293,6 +294,7 @@
Depending on the type of data returned by the plugin field, a value input assistant will be available: calculator (number) or calendar (date and/or time).
@@ -310,7 +312,8 @@View – opens selected file in the viewer (F3).
Edit – opens selected file in the editor (F4).
Go to file – closes search window, opens the directory of the selected file in the active file panel and places the cursor on this file (Enter or double click).
Go to file – closes search window, opens the directory of the selected file in the active file panel and places the cursor on this file (Enter or double click).
+ To keep the search window open, we can use the Space key or assign any other hotkey for the cm_GotoFile command and add close=0 in the parameters.
Feed to listbox – transfers a list of the found files in the active file panel.
The context menu is also available:
@@ -323,6 +326,7 @@To select several files, we can use the mouse and the Ctrl and Shift keys or Shift and arrows.
The left arrow and right arrow keys switch the focus between the list of search result and the New search button.
+The list of found files will be cleared when we start a new search or close the application, this means we can open the search dialog again and view the result of the previous search.
diff --git a/doc/en/help.html b/doc/en/help.html index addffaf5..cb43f95b 100644 --- a/doc/en/help.html +++ b/doc/en/help.html @@ -121,7 +121,7 @@This menu contains almost all the actions that can be made on files. Please consider all the items:
Create Symbolic Link... (internal command cm_SymLink). With this item, Double Commander creates a symbolic link to the file under the cursor and places it in the folder opened in the opposite panel.
-
Link name – here is the path to the link and its name. The name is the last word after the last directory separator character in the line.
Destination that the link will point to – the object, on which the link is created.
Use relative path when possible – if possible, Double Commander will use the relative path to the object directory.
@@ -129,7 +129,7 @@Create Hard Link... (internal command cm_HardLink). Like the symbolic link above, but link is hard and using a relative path will not be available.
Create Directory (internal command cm_MakeDir) – creates a new subdirectory in the current directory. The file name (without extension) or directory name under the cursor will be offered, this is useful for creating multiple directories with similar names. You can also create several subdirectories in one operation, just separate the subdrectories with the directory separator (in Unix/Linux system it will be "/" and in Windows it will be "\").
-
The button with an arrow opens the history of the entered names. The button to the right of the input field allows to enable or disable auto-completion from the directory creation history.
If Extended syntax is enabled, the <[] template can be used to insert the current date/time: inside square brackets you can use date and time formatting characters and any characters allowed for filenames.
which indicates the file or folder name, MIME type, size, write and last access time. For links, Double Commander will additionally show the link object (symbolic link) or their total number (hard link). On the "Attributes" tab you can change the access rights to the file and its owner (if you have the rights to do so). The "Plugins" tab is optional and is only available if you have a suitable content plugin (in this case it was DEB). Also see description of <SystemItemProperties>.
-Using item Edit comment... (internal command cm_EditComment) you can create or change file comments, which stored in a file descript.ion. Supports UTF, ISO, KOI and ANSI encodings. In the Miscellaneous settings section you can set the default text encoding.
-Comments only work with normal files on the local file system, but not on remote or virtual file systems (e.g. on FTP server, in archive, etc.). In order for Double Commander to take into account the contents of descript.ion when copying or moving files, make sure that Process comments with files/folders is enabled in the File operations settings section.
+Using item Edit comment... (internal command cm_EditComment) you can create or change file comments, which stored in a file descript.ion (to delete a comment, open the dialog window and clear the edit field). Supports UTF, ISO, KOI and ANSI encodings. In the Miscellaneous settings section you can set the default text encoding.
+Comments only work with normal files on the local file system, but not on remote or virtual file systems (e.g. on FTP server, in archive, etc.). In order for Double Commander to take into account the contents of descript.ion when performing file operations, make sure that Process comments with files/folders is enabled in the File operations settings section.
Calculate Occupied Space (internal command cm_CalculateSpace) item calculates the size of selected objects in rounded units and in bytes.
The action of the Configure button depends on the selected archiver:
packer plugins (WCX): opens the plugin's own settings window (if selected plugin supports this feature);
external archivers: opens a window with an input field for additional archiver parameters (when using the %S variable).
external archivers: opens a window with an input field for additional archiver parameters (when using the %S variable). Double Commander automatically saves the entered parameter string, the button with an arrow will open the list of previously saved ones (see description of AskHistory).
Also we can unpack files via Extract Files (internal command cm_ExtractFiles). The same dialog is called when you copy files from the archive.
In the Extract files matching file mask line, you can specify a mask, determining which files will be unpacked. The history of masks can be found in the drop-down list. - The next line specifies the destination directory (where the archive will be unpacked). It can be changed manually or by clicking on the browse button at the far right.
+In the Extract files matching file mask line, you can specify a mask, determining which files will be unpacked. The history of masks can be found in the drop-down list.
+Note: Keep in mind that Double Commander saves a general history of file masks for several tools: find files, directory synchronization, archive unpacking, commands for selecting a group of files.
+The next line specifies the destination directory (where the archive will be unpacked). It can be changed manually or by clicking on the browse button at the far right.
Unpack each archive to a separate subdir (name of the archive) – If checked, Double Commander will create a folder with the same name as the archive in the destination directory and extract the files into this folder. You can extract several archives at once with this option and each will be extracted into its own folder in the target directory. The indeterminate checkbox state (three-state) enables the smart extract: if there are several objects in the root of the archive, then the contents of the archive will be unpacked into a folder with the name of the archive, but if there is one object, then the contents will be unpacked as is. By default it is unchecked and its state is not saved for the next call of the extract command.
Unpack path names if stored with files – If checked, the directory structure in the archive will be kept. Otherwise, all files will be extracted without re-creating the directory structure.
Checkbox Overwrite existing files disables confirmation of overwriting existing files.
@@ -214,10 +215,12 @@Item Calculate check sum... (internal command cm_CheckSumCalc) is used to calculate the checksum to check files integrity. The following checksums are available: BLAKE2 (BLAKE2s, BLAKE2sp, BLAKE2b, BLAKE2bp), BLAKE3, CRC32, HAVAL, MD4, MD5, RIPEMD128, RIPEMD160, SFV, SHA, - SHA2 (digest sizes 224, 256, 384 or 512 bits), SHA3 (digest sizes 224, 256, 384 or 512 bits), Tiger/192.
-
Save checksum file(s) to: – line specifies name and path to the calculated checksum.
Create separate checksum files for each file – if checksum calculates for multiple files, this option allows to create separate checksum files for each target file.
+Create separate checksum file for each directory – Double Commander will scan the selected folders or the folder under the cursor and create separate checksum files in each subdirectory. The program will not take into account the ignore list and the status of the Show system and hidden files option.
Open checksum file after job is completed – after the operation is completed, the checksum file will be opened in the file viewer.
File format – allows to specify the line ending type and directory separator instead of the commonly used values in Windows (CRLF and "\") and Unix-like systems (LF and "/").
@@ -238,7 +241,9 @@There are some commands in this group with which you can select files in different ways.
-First and second items Select a Group and Unselect a Group (internal commands cm_MarkPlus and cm_MarkMinus). These commands select groups of files by a mask. With this mask you can specify file names or extensions (you can specify several values separated by semicolons ";" without spaces). Also there is a drop-down list with masks history. For example, select all files that have the .txt extension:
+First and second items Select a Group and Unselect a Group (internal commands cm_MarkPlus and cm_MarkMinus). These commands select groups of files by a mask. With this mask you can specify file names or extensions (you can specify several values separated by semicolons ";" without spaces). Also there is a drop-down list with masks history.
+Note: Keep in mind that Double Commander saves a general history of file masks for several tools: find files, directory synchronization, archive unpacking, commands for selecting a group of files.
+For example, select all files that have the txt extension:
The Define... button allows to create a new search template.
If the duplicate search result is open in the active panel, these commands will work in a special mode:
@@ -282,6 +287,7 @@Open VFS List (internal command cm_OpenVirtualFileSystemList) will open a list of added file system plugins (WFX plugins) that use their own file systems or provide access to other file systems and devices (local or remote). As well as virtual folders:
Computer – contains a list of normal disks with a drive letter and devices that do not have a drive letter (for example, USB devices that are connected via the MTP protocol, i.e. smartphones, tablets or players). Windows only.
iCloud – access to iCloud Drive contents. Additionally, you can choose the application folders that will be available in this virtual folder. macOS only.
Linux – list of all Linux distributions that you added to WSL and their root file systems (Windows 10 and newer).
Network – access to shared network resources (Windows) or to network resources using Gio (Linux).
Recycle Bin – access to files deleted to the trash.
Double Commander allows to rename files directly in the file panel. There are several ways to call this operation: the internal command cm_RenameOnly (F2 or Shift+F6 by default), the left mouse click or the corresponding item in the right mouse button menu.
By default, Double Commander will select the file name completely, but you can enable file name selecting without an extension. Also, repeated hotkey presses allow to select the file name in parts, the following characters are used as a separator: space, hyphen underscore and period. Folder names are always selected completely.
To confirm the change in the name, use the Enter key or the rename confirmation button to the right of the edit field. To cancel unconfirmed changes (to exit editing mode), use the Esc key or the mouse click outside the edit field. You can use a mouse click outside the edit field to confirm the renaming (as in Windows Explorer), see the description of <RenameConfirmMouse>.
+Using the up and down arrows, you can rename several files sequentially: the new file name will be automatically saved when you go to edit the name of the next or previous file. To exit this mode, use the methods described above to confirm or cancel the operation.
For group renaming files, the appropriate tool is available.
When using the quick search/filter tool, its panel is displayed at the bottom of the file panel. Quick search is used to search through the current contents of the file panel: the cursor will be moved to the nearest matching file and when using the up arrow and down arrow keys, the program will move the cursor in a circle only over files whose names match the conditions. Quick filter will hide all file names that do not match the conditions (to reset the filter, use the Esc key or the "X" button).
-
Filter – search/filter switch;
{ – name must start with first typed characters;
} – last characters before a typed dot "." must match;
Aa – case sensitive;
Ďï – diacritics and ligatures;
F – filter files;
D – filter directories;
X – disable quick search and close the panel.
In order to interpret Lua script file, we need to have a Lua DLL file, Double Commander supports versions 5.1 - 5.4.
+In order to interpret Lua script file, we need to have a Lua DLL file, Double Commander supports versions 5.1 - 5.5.
We can use DLL file from LuaJIT project. LuaJIT combines a high-speed interpreter, written in assembler, with a state-of-the-art JIT compiler. Also we get FFI library, which allows calling external C functions and using C data structures from pure Lua code.
DC distributives for Windows have Lua DLL by default (in DC 0.9.7 and newer from LuaJIT project), in other cases we may find and install it through our packages manager or compile it. If we're using a 64-bits version of DC, the DLL must be the 64-bits version as well.
By default DC looks for a file with name lua5.1.dll (Windows), liblua5.1.so.0 (Unix or GNU/Linux) or liblua5.1.dylib (macOS) in its directory and in the system directory. We can change the file name (and path) in the Lua library file to use parameter.
@@ -160,9 +160,9 @@Write a message to the log window:
true by defaultfalse by defaultThe internal function of Double Commander for writing to the protocol works asynchronously (see notes in the introduction), so messages from DC.LogWrite will not be written to the protocol immediately, but after the script is completed. If it is necessary to write the text immediately, we can try to add the call DC.ExecuteCommand("") after DC.LogWrite.
Once "inside" the compressed file, we may do some minimal basic functions like viewing the file, copy it to the other panel and some limited function like that.
The next following image shows us an example where we selected the compressed file "help.rar" and we simply press Enter in it just like it would be a directory:
After calling the view (F3) or edit (F4) command, Double Commander will extract the file under the cursor to the system directory for the temporary files and open it. After closing the viewer, the temporary file will be deleted. If the file opened in the editor is changed, Double Commander will offer to pack it back (if the compressed file format and the packer plugin or external archiver support this feature).
+After calling the view (F3) or edit (F4) command, Double Commander will extract the file under the cursor to the system directory for the temporary files and open it. After closing the viewer, the temporary file will be deleted. If the file opened in the editor is changed, Double Commander can pack it back (if the compressed file format and the packer plugin or external archiver support this feature), see <AutoCopyBackward>.
When using a double-click or pressing Enter, Double Commander will show the properties window of the packed file:
The Packer line displays the name of the packer plugin used or the name of the external archiver.
@@ -115,7 +116,7 @@This will be done by doing Configuration Options Archiver as illustrated below:
-
All settings are stored in the multiarc.ini file.
Let's see in the following sections the versatile possibilities Double Commander offers us to properly integrate the usage of an external packer.
@@ -135,7 +136,7 @@We then need to indicate us a significant description for the archiver, the exact location where is the executable of the archiver and then associated file extension, without the period, to that archiver.
If we have more than one possible, just add them with a single comma between each one, no space.
-
Note: Double Commander supports double extensions (for example, "tar.gz", "tar.xz" and so on), they must be placed in the beginning of the list of extensions (i.e. "tar.gz" before "gz").
@@ -507,7 +508,33 @@Several parameters that can be added or changed manually in the multiarc.ini configuration file directly or by exporting/importing archiver settings.
+AskHistory0 ... AskHistory50
+The values store additional archiver parameters that we have added in the file packaging dialog. We can manually change them, add new ones or delete unnecessary ones.
+This is a convenient way to store several sets of parameters that are more suitable for different groups of files and tasks.
+FallBackArchivers
+Allows to specify several executable files of archivers separated by commas (full file names or names without path). If the executable file from the "Archiver" field is not found, the application will use the first one found from the FallBackArchivers value.
+
For an example, see using 7-Zip in multiarc.ini in the "default" folder.
+IgnoreString0 ... IgnoreString50
+This is a way to specify lines that Double Commander should ignore when parsing the archiver output.
+If the value starts with the caret symbol ("^"), the text must be in the beginning of the ignored lines. Otherwise, the text can be located anywhere in the line.
+SizeStripChars
+It's rare, but the archiver can display file sizes with digit grouping (for example, "12,345" or "12 345" instead of "12345"). SizeStripChars allows to specify the character that should be removed.
If we need to specify several characters (for example, the value may depend on the regional settings of the operating system), they must be listed without a separator.
+ +This menu contains several additional functions:
Auto Configure – Double Commander will check all executable files of archivers: if a file is found, the program will automatically add its full path and enable the archiver, otherwise the archiver will be disabled.
We can just remove the extension from the settings, but in this case the commands cm_OpenArchive and cm_ExtractFiles will become unavailable. Another way:
If a WCX plugin is used, then we can open the plugin settings, select the extension and enable the "Show as normal files (hide packer icon)" flag.
If an external archiver is used to unpack files, then we can fill in the fields for using ID and not specify the file extension.
If an external archiver is used to unpack files, then we can use the "Show as normal files" option or we can fill in the fields for using ID and not specify the file extension. The first method also allows to create new archives.
For such files, Double Commander will use the associated icon instead of the generic archive icon.
diff --git a/doc/en/multirename.html b/doc/en/multirename.html index ec3309ce..a99a7dfe 100644 --- a/doc/en/multirename.html +++ b/doc/en/multirename.html @@ -109,7 +109,7 @@This will get us to the Multi-Rename Tool dialog window like the following:
-
On top we see a table with the files we've selected from source panel, one file per row, and about to be renamed. We can reorder the list of files using drag & drop or Shift+arrows. To remove a file from the list, we can use the Del key (after deleting all files, Double Commander will close the Multi-Rename Tool).
The table has three columns:
\n |
- newline (NL/LF), same as \x0a |
+ newline (NL/LF), same as \x0A |
\r |
- carriage return (CR), same as \x0d |
+ carriage return (CR), same as \x0D |
\f |
- form feed (FF), same as \x0c |
+ form feed (FF), same as \x0C |
\a |
@@ -122,7 +125,7 @@ ||
\e |
- escape (ESC), same as \x1b |
+ escape (ESC), same as \x1B |
Here are some examples:
@@ -169,7 +172,7 @@
\x10, \x11, \x12, \x13\x0A, \x0B, \x0C, \x0DSome expressions help to detect line separation.
-| Line separators | |
|---|---|
| Expression | Result |
^ |
- start of line | -
$ |
- end of line | -
\A |
- start of text | -
\Z |
- end of text | -
. |
- any character in line | -
Here are some examples:
-| Example with line separators | |
|---|---|
| Expression | Result |
^foobar |
- matches string foobar only if it's at the beginning of line |
-
foobar$ |
- matches string foobar only if it's at the end of line |
-
^foobar$ |
- matches string foobar only if it's the only string in line |
-
foob.r |
- matches strings like foobar, foobbr, foob1r and so on |
-
The ^ metacharacter by default is only guaranteed to match at the beginning of the input string/text, the $ metacharacter only at the end. Embedded line separators will not be matched by ^ or $.
You may, however, wish to treat a string as a multi-line buffer, such that the ^ will match after any line separator within the string, and $ will match before any line separator. You can do this by switching On the modifier m.
The \A and \Z are just like ^ and $, except that they won't match multiple times when the modifier m is used, while ^ and $ will match at every internal line separator.
The . metacharacter by default matches any character, but if you switch Off the modifier s, then . won't match embedded line separators.
TRegExpr works with line separators as recommended at Unicode technical standards (Technical Standard #18):
-^ is at the beginning of a input string, and, if modifier m is On, also immediately following any occurrence of \x0D\x0A or \x0A or \x0D (with Unicode support: also \x2028 or \x2029 or \x0B or \x0C or \x85). Note that there is no empty line within the sequence \x0D\x0A.
$ is at the end of a input string, and, if modifier m is On, also immediately preceding any occurrence of \x0D\x0A or \x0A or \x0D (with Unicode support: also \x2028 or \x2029 or \x0B or \x0C or \x85). Note that there is no empty line within the sequence \x0D\x0A.
. matches any character, but if you switch Off modifier s then . doesn't match \x0D\x0A and \x0A and \x0D (with Unicode support: also \x2028 and \x2029 and \x0B and \x0C and \x85).
Note that ^.*$ (an empty line pattern) does not match the empty string within the sequence \x0D\x0A, but matches the empty string within the sequence \x0A\x0D.
The . metacharacter matches any character, but if you switch Off modifier s then . doesn't match \x0D\x0A and \x0A and \x0D (with Unicode support: also \x{2028} and \x{2029} and \x0B and \x0C and \x85).
The . character does not act as metacharacter inside user character classes: [.] means a literal dot.
\x0D\x0A, \x0A, \x0D, \x0B, \x0C (with Unicode support: also \x{2028}, \x{2029} and \x85)You may use \w, \d and \s within custom character classes.
Here are some examples:
@@ -315,7 +266,64 @@Some expressions help to detect line separation.
+| Line separators | |
|---|---|
| Expression | Result |
^ |
+ start of line | +
$ |
+ end of line | +
\A |
+ start of text | +
\Z |
+ end of text | +
\G |
+ zero-length match at the end position of the previous match or if there was no previous match, the start of the line (^) |
+
Here are some examples:
+| Example with line separators | |
|---|---|
| Expression | Result |
^foobar |
+ matches string foobar only if it's at the beginning of line |
+
foobar$ |
+ matches string foobar only if it's at the end of line |
+
^foobar$ |
+ matches string foobar only if it's the only string in line |
+
The ^ metacharacter by default is only guaranteed to match at the beginning of the input string/text, the $ metacharacter only at the end. Embedded line separators will not be matched by ^ or $.
You may, however, wish to treat a string as a multi-line buffer, such that the ^ will match after any line separator within the string, and $ will match before any line separator. You can do this by switching On the modifier m.
The \A and \Z are just like ^ and $, except that they won't match multiple times when the modifier m is used, while ^ and $ will match at every internal line separator.
The . metacharacter by default matches any character, but if you switch Off the modifier s, then . won't match embedded line separators.
TRegExpr works with line separators as recommended at Unicode technical standards (Technical Standard #18):
+^ is at the beginning of a input string, and, if modifier m is On, also immediately following any occurrence of \x0D\x0A or \x0A or \x0D (with Unicode support: also \x{2028} or \x{2029} or \x0B or \x0C or \x85). Note that there is no empty line within the sequence \x0D\x0A.
$ is at the end of a input string, and, if modifier m is On, also immediately preceding any occurrence of \x0D\x0A or \x0A or \x0D (with Unicode support: also \x{2028} or \x{2029} or \x0B or \x0C or \x85). Note that there is no empty line within the sequence \x0D\x0A.
Note that ^.*$ (an empty line pattern) does not match the empty string within the sequence \x0D\x0A, because this is unbreakable line separator. But matches the empty string within the sequence \x0A\x0D, because this is 2 line-breaks in the wrong order.
A word boundary (\b) is a spot between two characters that has a \w on one side of it and a \W on the other side of it (in either order), counting the imaginary characters off the beginning and end of the string as matching a \W.
| Word boundaries | |||
|---|---|---|---|
| Unicode categories | |
|---|---|
Co | Private Use |
Cn | Unassigned |
Meta-character \p denotes one Unicode char of specified category. Syntaxes: \pL and \p{L} for 1-letter name, \p{Lu} for 2-letter names.
Meta-character \P is inverted, it denotes one Unicode char not in the specified category.
These meta-characters are supported withing character classes too.
+Metacharacter \p denotes one Unicode char of specified category. Syntaxes: \pL and \p{L} for 1-letter name, \p{Lu} for 2-letter names.
Metacharacter \P is inverted, it denotes one Unicode char not in the specified category.
These metacharacters are supported withing character classes too.
Syntax for one modifier: (?i) to turn on, and (?-i) to turn off. Many modifiers are allowed like this: (?msgxr-imsgxr).
Modifiers are for changing behaviour of regular expressions. Modifier affects only that part of regular expression that follows (?imsgxr-imsgxr) operator.
Any of these modifiers may be embedded within the regular expression itself. If modifier is inlined into subexpression, then it effects only into this subexpression.
+Any of these modifiers may be embedded within the regular expression itself. If modifier is inlined into subexpression, then it effects only into this subexpression. Modifiers can also be given as part of a non-capturing group: (?i:expr).
This also means that if you want real whitespace or # characters in the pattern (outside a character class, where they are unaffected by x), that you'll either have to escape them or encode them using octal or hex escapes.
This also means that if you want real whitespace or # characters in the pattern (outside a character class, where they are unaffected by x), that you'll either have to escape them or encode them using hex escapes.
Taken together, these features go a long way towards making regular expressions text more readable.
Between them there is a field for filtering files by mask (symbol "*" means match any number of characters, symbol "?" means any one character). Files that do not match the mask will be ignored. We may put multiple file types here using a semicolon ";" without spaces between them. Also we can use search templates (
), including search with content plugins. The default value is "*" (all files).
The button with an arrow opens the list of the used file masks (keep in mind that Double Commander saves a general history of file masks for several tools: find files, directory synchronization, archive unpacking, commands for selecting a group of files). By default, Double Commander saves (regardless of the state of the File mask history option) the last used file mask as the default mask for the next run of the synchronization tool (if it is not a search template), see Additional settings.
To exclude directories and symbolic links to directories, we can use the search template and the Exclude subdirectories field.
-Compare – starts comparing the chosen directories. The progress of the compare operation is displayed in the status bar. If necessary, the operation can be interrupted with the Esc key.
+Compare – starts comparing the chosen directories. If necessary, the operation can be interrupted with the Esc key.
Parameters:
only selected (in main window) – If enabled, only files and directories that have been selected in the file panel will be compared. It is enough to select files and directories only in one file panel.
Separator – is simply a vertical bar (horizontal in the middle toolbar).
Space – adds an empty space, its width corresponds to the size of the button.
Line break – all subsequent buttons will be located on a new line of the toolbar.
The menu will use the first one regardless of the style selected.
In the following example, the person used separator to isolate together functions related with comparisons, then the ones related with clipboard, etc.
diff --git a/doc/en/variables.html b/doc/en/variables.html index 9b13e91a..831b197d 100644 --- a/doc/en/variables.html +++ b/doc/en/variables.html @@ -88,7 +88,7 @@If we've done a flat view from directory "C:\Users\UserName", the %v will result in "Desktop\comment.png""C:\Users\UserName", the %v will result in "Desktop\comment.png"The %a variable is available for the virtual file system (an open archive or a file system plugin): the string includes the path to the virtual file system (the full name of the archive or the name of the WFX plugin with "wfx://") and the full file name relative to the root of the virtual file system.
By default, the above mentioned file names inside the file list are unquoted. But there is a suffix you may add to change that if required.
-Also, there are suffixes to specify if you want this file list to be coded in UT8 or UTF16.
+Also, there are suffixes to specify if you want this file list to be coded in UTF-8 or UTF-16.
| Suffix to list of files variable | ||
|---|---|---|
| Expression | Description | |
U |
- List will be coded in UTF8 format | +List will be coded in UTF-8 format |
W |
- List will be coded in UTF16 format | +List will be coded in UTF-16 format |
Supported image formats: BMP, CUR, GIF, ICNS, ICO, JPEG, PNG, PNM (PBM, PGM and PPM), PSD, SVG/SVGZ, TIFF, XPM. In addition, if the required libraries are available:
HEIF/HEIC and AVIF: libheif.dll (Windows) or libheif.so.1 (Linux and other Unix-like systems).
JPEG XL: libjxl.dll and libjxl_threads.dll (Windows) or libjxl.so.0.n and libjxl_threads.so.0.N (Linux, "N" is a version number).
SVG/SVGZ: librsvg-2-2.dll, libcairo-2.dll and libgobject-2.0-0.dll (Windows) or librsvg-2.so.2, libcairo.so.2 and libgobject-2.0.so.0 (Linux and other Unix-like systems). If these files are available, Double Commander will use the librsvg library instead of the built-in Image32 graphics library.
WebP: libwebp.so.N, where "N" is 7, 6 or 5 (Linux and other Unix-like systems).
Double Commander supports the TurboJPEG library, it is a JPEG codec that uses SIMD instructions to accelerate the decoding and encoding of images: libturbojpeg.dll (Windows), libturbojpeg.so.0 (Linux and other Unix-like systems) or libturbojpeg.dylib (macOS).
In Windows, Double Commander can use the built-in HEIC decoder (Windows 11 24H2 and newer).
The built-in viewer supports saving to the following image formats: BMP, ICO, JPEG (we can choose the quality from 1 to 100; 80 by default, see <JpegQuality>), PNG (Double Commander will use the same color depth as in the original image) and PNM (Double Commander will use binary formats, the color depth will be set automatically: 1, 8 or 24 bits per pixel).
Note: When modifying an image, we must save all changes with the Save or Save As commands: Double Commander does not check the status of the file (changed or not) when closing the viewer window or when switching to another file.
+For folders, the viewer will display (if a suitable plugin is not found) the full name of the directory under the cursor, the number of subdirectories, files, and their total size (the result is similar to the action of the Calculate Occupied Space command).
We can assign or change hotkeys for commands available in the viewer in the Keys > Hot Keys settings section (switch to the Viewer category). Hotkeys can be set separately for text mode and image viewing mode.
Search options:
Case sensitive – indicates that uppercase should be distinguished from lowercase, e.g. "Fallout" and "fallout" would be different.
Hexadecimal – searches for hexadecimal characters (case insensitive, with or without spaces between characters, for example, "C0 C1 C2" or "c0c1c2").
Hexadecimal – searches for hexadecimal characters (case insensitive, with or without spaces between characters, for example, "C0 C1 C2" or "c0c1c2").
Regular expressions – if enabled we can use regular expressions.
Backwards – switches the search direction: search from the end of the file instead of searching from the beginning.
Mirror Horizontally – reverses the image horizontally, that is, from left to right.
Mirror Vertically – reverses the image vertically, that is, from top to bottom.
Zoom In and Zoom Out – commands to change the image scale.
+Zoom In and Zoom Out – commands to change the image scale (or we can use Ctrl+mouse wheel).
Full Screen – switches the window to full-screen mode (the contents of the window without the operating system's typical window-framing interface). This mode is available not only when viewing images, just use hotkeys (Alt+Enter by default).
The Screenshot submenu – creating a screenshot of the desktop, immediately or with a delay (3 or 5 seconds).
When using plugins, this menu includes only three items: Stretch, Stretch only large and Center.
@@ -173,14 +175,14 @@Copy File – see Copying/moving files.
Move File – see Copying/moving files.
Delete File – will delete the file being viewed with a confirmation request.
-Zoom In and Zoom Out – commands to change the image scale.
+Zoom In and Zoom Out – commands to change the image scale (or we can use Ctrl+mouse wheel).
Rotate -90 degrees – rotates the image by 90 degrees to the left around its center.
Rotate +90 degrees – rotates the image by 90 degrees to the right around its center.
Mirror – The Mirror Horizontally command: reverses the image horizontally, that is, from left to right.
-The next group is for GIF animation only:
+The next group is for GIF animations and ICO files only:
Pause/Play – pauses animation playback.
Previous Frame and Next Frame – switch animation frames back and forth.
Previous Frame and Next Frame – switch animation frames back and forth. If an ISO file is open, these commands allow to switch between the images contained in the file.
Export Frame – allows to save the current animation frame.
The next group of buttons is related to selection:
@@ -211,6 +213,7 @@
Image: current resolution (in pixels and percentages), real file resolution and selection size (when using the selection tool).
For ICO files, the total number of images in the file, the number of the current image and its size are additionally displayed.
WLX plugin: plugin name and encoding.
At the ending of the status bar, the full name of the file being viewed is displayed.
@@ -238,8 +241,9 @@Additional file viewing mode (Ctrl+Q by default): instead of a separate window, the contents of the file under the cursor will be shown in the opposite (inactive) file panel. As we navigate to next items, displayed content is updated, this allows to view the contents of files simply by moving the cursor in the file panel.
-Quick view can be disabled by pressing Ctrl+Q again, also it will be disabled when switching any panel (active or inactive) to another tab.
"View" actions added in the file association settings are ignored, except for applications that are launched with the {!DC-VIEWER} macro.
+For folders, this mode works similarly to the regular viewer window, but on the ".." item, Double Commander will display information about the parent directory.
+Quick view can be disabled by pressing Ctrl+Q again, also it will be disabled when switching any panel (active or inactive) to another tab.
Not all viewer commands can work in this mode, for example, commands to load the previous or next file in the directory (P and N by default).
Right-click on the status bar brings up a menu that contains several submenus (depending on the current mode):
@@ -1108,6 +1108,18 @@
+
+
+
+
diff --git a/doc/ru/configuration.html b/doc/ru/configuration.html
index 8a86e5be..1edee45f 100644
--- a/doc/ru/configuration.html
+++ b/doc/ru/configuration.html
@@ -110,20 +110,21 @@ extassoc.xml – настройки файловых ассоциаций;
favoritetabs.xml – избранные вкладки;
history.xml – история каталогов, командной строки, поиска и так далее;
localconfig.xml – избранные каталоги;
multiarc.ini – внешние архиваторы;
pixmaps.txt – сопоставляет расширения файлов с именами значков MIME-типов;
session.ini – размер, положение и состояние дочерних окон программы (эти параметры сохраняются отдельно для каждого разрешения экрана);
Здесь можно выбрать шрифты для редактора (F4), просмотрщика (F3), файловых панелей (Основной) и других элементов интерфейса Double Commander, а также их размеры. Для каждого вы можете видеть выбранный шрифт. Одно важное замечание: шрифты для редактора и просмотрщика должны быть МОНОШИРИННЫЕ. На изображении ниже показан пропорциональный шрифт (обратите внимание на странный интервал) и моноширинный шрифт, который отображается с правильными интервалами. Кроме того, с некоторыми пропорциональными шрифтами символы могут налезать друг на друга и выглядеть довольно странно.
Вверху обычный, пропорциональный, шрифт, внизу моноширинный.
-Также для изменения размера шрифта вы можете использовать Ctrl+колесо мыши, эта функция работает для следующих элементов интерфейса или частей Double Commander:
-список файлов в левой и правой панелях;
панель текущего каталога (адреса);
панель функциональных клавиш;
древовидное меню;
результаты поиска в диалоге поиска файлов;
встроенный редактор;
встроенный просмотрщик (если просмотрщик показывает текст, то это действие изменит размер шрифта, если изображение – действие будет работать как команды увеличения/уменьшения).
Также для изменения размера шрифта вы можете использовать Ctrl+колесо мыши, подробнее смотрите в разделе Мышь.
Также вы можете выбрать тип растеризации шрифтов (независимо от системных настроек), смотрите описание <Quality>.
Слева: – файлы, выбранные для копирования или удаления слева.
Справа: – файлы, выбранные для копирования или удаления справа.
Неизвестно: – файлы с одинаковыми именами, но не идентичные.
Выделение: – цвет фона для файла под курсором или выделенных файлов.
6. Индикатор свободного места – здесь вы можете изменить вид индикатора свободного места на диске:
Вторая часть шаблона для Unix/Linux отображает права доступа: чтение (r), запись (w), выполнение (x). Значения сгруппированы по три в следующем порядке: пользователь (владелец), группа пользователя, все остальные.
Если атрибут не должен быть установлен, его нужно заменить символом "-", ненужные следует скрыть: звёздочка "*" обозначает любое количество символов, знак вопроса "?" – любой один символ. Например, с ?r* (Windows) или ?r-* (Linux) будут найдены все файлы и папки только для чтения.
Вы можете использовать цвет из списка или указать свой с помощью кнопки "..".
-Не забывайте нажимать на кнопку "Применить" после внесения изменений в список или в свойства.
Double Commander проверяет список сверху вниз до первого совпадения: правило, находящееся выше в списке, будет перекрывать любое правило ниже.
Первая группа параметров Выделение:
Выделение с помощью мыши – включает возможность выделять и снимать выделение с файлов и папок с помощью мыши.
Построчно – то же самое, только без движения курсора, он будет оставаться в одном положении. Также вы можете указать количество строк.
Постранично – как предыдущее, но прокрутка осуществляется по страницам, а не по строкам (более быстрая прокрутка).
Масштабирование – Double Commander позволяет использовать Ctrl+колесо мыши для изменения размеров шрифтов. Работает для следующих элементов интерфейса или частей программы:
+список файлов в левой и правой панелях;
панель текущего каталога (адреса);
панель функциональных клавиш;
древовидное меню;
результаты поиска в диалоге поиска файлов;
встроенный просмотрщик (если просмотрщик показывает текст);
встроенный редактор.
Масштабирование с Ctrl+колесо мыши – включает или отключает эту возможность.
Открытие файлов и запуск программ – задаёт поведение при щелчке мыши по элементу списка файловой панели:
Двойной щелчок мыши открывает папки и файлы или запускает приложения (по умолчанию).
GETFILEOWNER – владелец файла.
GETFILELINKTO – путь и файл, на который указывает символьная ссылка.
GETFILETYPE – тип файла (как в Проводнике Windows или MIME-тип).
GETFILECOMMENT – описание (комментарий) файла или каталога из файла descript.ion (подробнее смотрите здесь).
GETFILECOMMENT – описание (комментарий) файла или каталога из файла descript.ion (подробнее смотрите здесь). Это поле также можно использовать внутри архивов (если формат архивов поддерживает сохранение описания файлов и соответствующий внешний архиватор настроен на их получение).
GETFILECOMPRESSEDSIZE – размер сжатого файла (реальный размер, если используется сжатие NTFS).
По умолчанию в полях с отметками времени используется формат даты и времени, который был выбран в разделе настроек Список файлов. Также вы можете задать предпочитаемый формат непосредственно в колонке внутри фигурных скобок, используя те же символы форматирования даты и времени.
@@ -651,7 +655,7 @@Назад, Далее – переключают колонки.
Настроить колонку – показывает имя настраиваемой колонки.
>> – кнопка для выбора любого цвета из палитры.
-R – возвращает значение по умолчанию.
+С – возвращает значение по умолчанию.
Все – применяет изменение и на все остальные колонки.
Настроить – открывает собственное окно настроек плагина (если выбранный плагин поддерживает эту функцию).
Double Commander поддерживает использование главного пароля для защиты паролей в WCX- и WFX-плагинах (если разработчик плагина предусмотрел использование этой возможности). Это удобно, потому что ваши пароли будут защищены шифрованием и вам нужно запомнить только один пароль. Пароли шифруются два раза: сначала с помощью Blowfish (448 бит), потом с помощью AES (256 бит).
-Примечание: На данный момент программа не поддерживает изменение главного пароля: при необходимости вам потребуется отключить использование главного пароля в настройках плагина, закрыть программу, открыть каталог с файлами конфигурации, удалить файл pwd.ini, снова запустить программу и включить главный пароль в настройках плагина. Чтобы удалить устаревшие или ненужные сохранённые пароли, вам потребуется закрыть программу и вручную отредактировать файл pwd.ini.
+Double Commander поддерживает использование главного пароля для защиты паролей в WCX- и WFX-плагинах (если разработчик плагина предусмотрел использование этой возможности). Это удобно, потому что ваши пароли будут защищены шифрованием и вам нужно запомнить только один пароль. Пароли шифруются два раза, сначала с помощью Blowfish (448 бит), потом с помощью AES (256 бит), для формирования ключа из главного пароля используется функция Argon2.
+Double Commander поддерживает две версии алгоритма Argon2 (Argon2d и Argon2id) и позволяет указать три параметра: количество итераций, требуемая память, степень параллелизма. RFC 9106 рекомендует использовать Argon2id, если вы не знаете разницы между версиями или если атаки по сторонним каналам считаются реальной угрозой. Увеличение количества итераций и/или размера памяти увеличит время работы функции и усложнит возможность взлома пароля; увеличение степени параллелизма (но не превышая количество логических ядер вашего процессора) позволяет ускорить работу функции. Также рекомендуется подобрать параметры таким образом, чтобы выполнение функции занимало около 0,5-1 секунды (чем больше, тем лучше, но при слишком больших значениях может быть неудобно пользоваться главным паролем).
+Примечание: Если вы активно используете портативную версию Double Commander на USB-флешке на нескольких компьютерах или используете централизованную установку приложения с файлами конфигурации, то может быть практичным выбор параметров, подходящих для наименее производительного компьютера.
+Примечание: На данный момент программа не поддерживает изменение главного пароля: при необходимости вам потребуется отключить использование главного пароля в настройках плагина, закрыть программу, открыть каталог с файлами конфигурации, удалить файл pwd.ini, снова запустить программу и включить главный пароль в настройках плагина. Чтобы удалить устаревшие или ненужные сохранённые пароли, вам потребуется закрыть программу и вручную отредактировать файл pwd.ini.
Тут можно изменить вид главного окна Double Commander. Полагаю, проблем здесь возникнуть не должно, все опции видны на изображении выше. На изображении ниже показано, как выглядит DC с отключенными элементами управления и дополнительными окнами.
Также доступно несколько параметров, которые можно изменить только вручную в файле конфигурации doublecmd.xml.
+Начиная с macOS 11 в Double Commander по умолчанию помимо основной панели инструментов включена панель инструментов в заголовке окна. Вы можете отключить использование этого элемента пользовательского интерфейса вручную: закройте Double Commander, перейдите в каталог файлов конфигурации (подробнее смотрите здесь), откройте файл doublecmd.cfg, найдите параметр ModernUI, измените значение с True на False и снова запустите приложение.
2.10.1. Вид окна > Кнопка списка дисков
@@ -767,10 +775,12 @@Параметры Размер буфера для файловых операций (Кб) и Размер буфера для вычисления хеша (Кб) задают размер выделенной памяти для таких операций, как копирование, перемещение, разрезание или сборка файлов, поиск файлов по содержимому и вычисление контрольных сумм. Следует иметь в виду, что универсального значения не существует, но можно попробовать найти более подходящий размер.
Примечание: Первый параметр не используется в функции копирования в Windows, так как для копирования применяется системная функция.
Число перезаписей при стирании (Wipe) – Здесь вы можете указать количество перезаписей для безопасного удаления файлов.
-Обрабатывать комментарии с файлами/папками – Если включено, то при копировании или перемещении файла/папки с добавленным комментарием файл комментария также будет скопирован или перемещён в каталог назначения.
+Обрабатывать комментарии с файлами/папками – Если включено, то при копировании или перемещении файла/папки с добавленным комментарием, комментарий также будет скопирован или перемещён в каталог назначения. При удалении или стирании файла будет удалён и его комментарий. Если вы переименуете файл, его имя также будет изменено в файле descript.ion.
+ В противном случае файл descript.ion будет обработан как обычный файл.
Выводить сообщения об ошибках файловых операций только в окно протокола – В случае возникновения ошибки файловой операции, сообщение об ошибке появится в окне протокола под файловыми панелями, без появления диалогового окна. Это может быть полезно, потому что окно ошибки приостановит операцию. В разделе настроек Протокол вы можете ограничить общее количество сообщений, разрешив только сообщениями со статусом "Ошибка".
Параметр учитывается в большинстве файловых операций: копирование, перемещение, удаление, стирание, объединение и разрезание файлов, установка свойств файла (отметки времени, владелец, атрибуты), подсчёт контрольной суммы, а также файловые операции при работе с архивами, WFX-плагинами и GVfs.
Стиль автопереименования совпадающих имён – задаёт шаблон автопереименования файла, если файл с таким именем уже существует в целевом каталоге (то есть, когда вы выбираете Автоматически переименовывать копируемые файлы или Автоматически переименовывать имеющиеся файлы в диалоге копирования/перемещения): "Копия (x) имяфайла.тип", "имяфайла (x).тип" или "имяфайла(x).тип", где "x" – счётчик (2, 3, 4 и т.д.).
+Также доступно несколько параметров, которые можно изменить только вручную в файле конфигурации doublecmd.xml.
2.12.1. Файловые операции > Поиск файлов
@@ -865,13 +875,13 @@Состояние главного окна – Размер и положение окна приложения.
Вкладки каталогов – Список вкладок, открытых в левой и правой панелях.
Историю поиска/замены – История поиска файлов (кроме масок имён файлов, смотрите ниже), история масок в инструменте группового переименования и история поиска и замены текста: поиск по содержимому файлов, просмотрщик, встроенные редактор и инструмент сравнения файлов, поиск и замена в настройках избранных каталогов и панели инструментов. Также сохраняется состояние параметров поиска текста (С учётом регистра, Регулярные выражения и Шестнадцатеричное) для каждой записи.
Историю поиска/замены – История поиска файлов (кроме масок имён файлов, смотрите ниже), история масок в инструменте группового переименования и история поиска и замены текста: поиск по содержимому файлов, просмотрщик, встроенные редактор и инструмент сравнения файлов, поиск и замена в настройках избранных каталогов и панели инструментов. Также сохраняется состояние параметров поиска текста (С учётом регистра, Регулярное выражение и Шестнадцатеричное) для каждой записи.
Историю каталогов – Список всех посещённых каталогов (смотрите примечание ниже).
Историю командной строки – Команды, использованные в командной строке.
Историю масок файлов – Double Commander сохраняет общую историю использованных масок файлов для нескольких инструментов: поиск файлов, фильтры в синхронизации каталогов и распаковке архивов, команды выделения группы файлов и снятия выделения.
Максимальное количество записей в истории ограничено 50.
-Примечание об истории посещённых каталогов: В течении сессии Double Commander хранит в памяти до 255 посещённых каталогов (тем не менее при закрытии программы будут сохранены только последние 50 записей). Вы можете изменить количество записей истории во всплывающем меню при вызове команды cm_DirHistory (по умолчанию 30, смотрите атрибут Count в теге <DirHistory>), однако при использовании древовидного меню будет показана вся доступная история.
Максимальное количество записей в истории по умолчанию ограничено 50 (смотрите атрибут MaxStringItems в теге <History>).
Примечание об истории посещённых каталогов: В течении сессии Double Commander хранит в памяти до 255 посещённых каталогов, тем не менее при закрытии программы количество сохраняемых записей будет ограничено значением MaxStringItems. Вы можете изменить количество записей истории во всплывающем меню при вызове команды cm_DirHistory (по умолчанию 30, смотрите атрибут Count в теге <DirHistory>), однако при использовании древовидного меню будет показана вся доступная история.
Примечание: Шаблоны поиска не относятся к истории и сохраняются отдельно (в файле конфигурации doublecmd.xml). Для управления списком шаблонов вы можете использовать инструмент поиска файлов.
Вы можете выбрать, как будет выглядеть список разделов настроек:
Этот раздел содержит настройки инструмента быстрого поиска/фильтра. Быстрый поиск используется для поиска по текущему содержимому файловой панели, быстрый фильтр скроет все имена файлов, не соответствующие условиям.
-
Точное соответствие имени:
Начало (имя должно начинаться с набранных символов) – означает, что набранный текст будет соответствовать маске "текст*", где "*" – любое количество любых символов.
Эти опции можно изменить на лету непосредственно в панели быстрого поиска/фильтра. Также вы можете переключаться между поиском и фильтром.
Настройки:
Игнорировать диакритические знаки и лигатуры – позволяет упростить использование быстрого поиска/фильтра: при поиске Double Commander заменит буквы с диакритическими знаками и лигатуры на буквы латинского алфавита (таблица распространённых символов содержится в исходном коде программы).
Скрывать панель фильтра, когда она не в фокусе – Панель быстрого поиска/фильтра будет автоматически скрыта, как только вы переместите фокус в файловую панель. В кратком режиме скрытие панели работает некорректно, поэтому опция игнорируется, пока не будет найдено подходящее решение.
Сохранять настройки, изменённые через панель фильтра – По умолчанию все параметры, которые были изменены в панели быстрого поиска, будут сохранены в памяти только до закрытия программы, опция позволяет изменить такое поведение.
Только macOS. В этом разделе настроек перечислены установленные приложения, автоматически создающие папки на диске iCloud: вы можете выбрать папки приложений, которые будут доступны в виртуальной папке iCloud.
+
Первый параметр включает отображение значков типов файлов слева от имени:
Только стандартные – Будут отображаться только значки, перечисленные в файле pixmaps.txt, и значки из настроек файловых ассоциаций. В этом случае вы можете использовать значки только из темы значков Double Commander (смотрите каталоги pixmaps/dctheme/XxX/mimetypes в папке программы) или укажите полное (с путём) имя файла. Создание темы значков описано в FAQ.
Не показывать значки.
Показывать оверлейные значки (например, для ярлыков) – Если отмечено, Double Commander будет показывать оверлейные значки, например, стрелки для LNK-файлов и ссылок.
+Показывать оверлейные значки (например, для ярлыков) – Если отмечено, Double Commander будет показывать оверлейные значки, например, стрелки для LNK-файлов и прочие наложенные эмблемы и метки:
+Windows: Эмблемы из настроек операционной системы и сторонних приложений (например, системы контроля версий или локальные каталоги облачных хранилищ).
Linux и другие Unix-подобные системы (кроме macOS и Haiku): Эмблемы RabbitVCS (если доступно) и эмблемы из подсистемы метаданных GIO/GVfs (как в Nautilus, Caja, Thunar, PCManFM и других поддерживающих).
Эмблема символьной ссылки и дополнительная эмблема битой/висячей ссылки будут отображаться в любом случае.
Затенять значки скрытых файлов (медленнее) – Если отмечено, Double Commander будет показывать значки скрытых файлов с уровнем прозрачности 50%.
Отключить загрузку специальных значков – Вы можете отключить загрузку специальных значков (оверлейные значки, значки из EXE/LNK-файлов) для указанных каталогов и их подкаталогов, просто перечислите их через точку с запятой ";" без пробелов.
Размер значков – Вы можете выбрать один из следующих размеров:
@@ -963,7 +983,7 @@Примечание: В Unix-подобных системах Double Commander в первую очередь будет использовать системную тему значков, если каких-то значков не существует, то DC будет использовать свои собственные.
Исключение указанных файлов и папок (один на строку): они не будут отображаться в панелях.
Для включения и выключения этой функции вы можете использовать команду cm_SwitchIgnoreList, добавьте кнопку на панель инструментов или сочетание клавиш.
Подробнее ознакомиться с настройкой и использованием можно на странице справки Работа с архивами.
В этом разделе содержатся настройки всплывающих подсказок при наведении указателя мыши на файл.
Показывать всплывающие подсказки в файловой панели – включает возможность использования подсказок.
@@ -1023,7 +1043,7 @@На изображении в начале описания раздела вы можете видеть пример всплывающей подсказки с плагином textline.wdx, который показывает содержимое выбранных строк текстового файла (в данном случае первой, второй и третьей строк), выбран режим Объединить подсказку DC и системную, сначала системная.
Этот пункт открывает окно настроек файловых ассоциаций. Все ассоциации сохраняются в файл extassoc.xml.
Здесь можно настроить ассоциации файлов с различными программами, а также задать команды или скрипты для выбранных типов файлов. Указанные команды будут добавлены в контекстное меню файлов. Также Double Commander позволяет просто задать (или заменить) значки для типов файлов, не добавляя какие-либо действия.
file – любой файл;
folder – любой каталог;
default – используется, когда для расширения не существует ассоциации.
default – используется, когда для расширения не существует внутренней ассоциации (только для действий "Open", "View" и "Edit", смотрите ниже).
Вставить – добавляет новое расширение в текущую позицию в списке.
Добавить – добавляет новое расширение в конец списка.
@@ -1081,12 +1101,12 @@<?command?> – запускает "command" в оболочке системы и подаёт вывод на команду выше.
Как минимум, вы должны указать имя файла, обычно %p или %p0 для файла под курсором.
Путь запуска – каталог запуска команды. Этот каталог станет рабочим каталогом запускаемой программы и если у вас нет необходимости явно указать его, то просто оставьте это поле пустым: в этом случае рабочим каталогом будет текущий каталог активной файловой панели (обычные файлы) или системный каталог для временных файлов (файлы из архивов и WFX-плагинов). Здесь мы можем использовать переменную %D, %d или переменные окружения.
+Путь запуска – каталог запуска команды. Этот каталог станет рабочим каталогом запускаемой программы и если у вас нет необходимости явно указать его, то просто оставьте это поле пустым: в этом случае рабочим каталогом будет текущий каталог активной файловой панели (обычные файлы) или системный каталог для временных файлов (файлы из архивов и WFX-плагинов). Здесь вы можете использовать переменную %D, %d или переменные окружения.
Все доступные действия отображаются в контекстном меню в подменю "Команды":
2.23.1. Файловые ассоциации > Файловые ассоциации (дополнительно)
+2.24.1. Файловые ассоциации > Файловые ассоциации (дополнительно)
Предлагать добавить в файловые ассоциации файл под курсором (если ещё не включен) – При открытии настроек файловых ассоциаций будет предложено добавить тип с расширением файла под курсором (если оно не найдено в уже существующих типах). Это быстрый способ добавить действие "Открыть с помощью": Double Commander предложит вам указать имя типа и исполняемый файл, всё остальное будет сделано автоматически.
Расширенное контекстное меню – позволяет добавить некоторые пункты в подменю "Команды":
@@ -1110,11 +1130,11 @@Также вы можете применить выбранный способ к уже добавленным путям.
Подробнее ознакомиться с настройкой и использованием можно на странице справки Избранные каталоги.
2.24.1. Избранные каталоги > Избранные каталоги (дополнительно)
+2.25.1. Избранные каталоги > Избранные каталоги (дополнительно)
В этом разделе вы можете выбрать, как будет установлен путь и целевой путь:
Файл doublecmd.xml может быть расположен в разных местах:
Подробнее узнать про параметр командной строки --config-dir можно по этой ссылке.
Расположение задаётся в настройках: Настройки > Параметры... > выбираем в дереве > устанавливаем параметр Месторасположение файлов конфигурации.
Ещё один способ быстро выяснить, где находится doublecmd.xml текущего экземпляра Double Commander, это использовать меню избранных каталогов. В конце его имеется дополнительный раздел под названием "Специальные каталоги", далее выбираем "Каталог Double Commander..." и "%DC_CONFIG_PATH%". Здесь мы найдём doublecmd.xml, который приложение использует в данный момент.
@@ -151,10 +151,42 @@True) или текст из истории поиска (False). По умолчанию True.| Значение | +Описание | +
|---|---|
| 1 | +Символы пробела будут отображаться как символы средней точки ("·", U+00B7). | +
| 2 | +Символы табуляции будут отображаться как длинный пробел (см. Ширина табуляции) с символом правой двойной кавычки ("»", U+00BB) в начале. | +
| 4 | +Символы табуляции будут отображаться как длинный пробел (см. Ширина табуляции) с символом правой двойной кавычки ("»", U+00BB) в конце. | +
False) или скопирует обратно автоматически (True). По умолчанию True.MaxStringItems позволяет указать максимальное количество записей сохраняемой истории. По умолчанию 50.False) при отключении кнопки списка дисков её панель и строка свободного места остаются на том же месте; в противном случае (True) панель будет скрыта, а строка свободного места будет перемещена вверх, на панель кнопок дисков, добавляя пространство для списка файлов.False.ImageExifRotate определяет, будет ли Double Commander учитывать эту информацию при просмотре изображения или нет.| Значение | -Описание | -
|---|---|
| True | -Использовать встроенный в файл изображения флаг ориентации (по умолчанию). | -
| False | -Игнорировать флаг ориентации. | -
<ImageExifRotate>True</ImageExifRotate>
+ Тег ImageExifRotate определяет, будет ли Double Commander учитывать эту информацию при просмотре изображения (True) или нет (False). По умолчанию True.
Атрибут Count (<DirHistory>)
+ Атрибут MaxStringItems (<History>)
Атрибут Save (<Asymmetric>)
Атрибут Save (<FileMask>)
ActiveRight
AutoCopy
+ AutoCopyBackward
AutoExtractOpenMask
AutoSaveWidth
ConfirmQuit
@@ -655,6 +684,7 @@
- MaxCodeSize
MaxTextWidth
Mode
NtfsHourTimeDelay
@@ -678,6 +708,7 @@
Список следующих параметров будет различаться в зависимости от типа файловой операции и семейства операционных систем.
Проверить после завершения – Если отмечено, Double Commander сравнит исходный файл и скопированный файл в целевом каталоге: побайтовое сравнение (Windows) или контрольные суммы BLAKE2 (Linux и другие). Double Commander попытается свести к минимуму эффекты дискового кэша (если файловая система не поддерживает прямой ввод-вывод, программа сообщит о неудаче проверки). Имейте в виду, эта функция заметно снижает скорость операции. Обратите внимание, каждый файл будет прочитан дважды, поэтому общий размер файлов в полосе прогресса операции будет увеличен в два раза. Недоступно в macOS.
Проверить после завершения – Если отмечено, Double Commander сравнит исходный файл и скопированный файл в целевом каталоге: побайтовое сравнение (Windows) или контрольные суммы (Linux и другие: BLAKE3 (x86-64), BLAKE2b (остальные 64-битные процессоры) или BLAKE2s). Double Commander попытается свести к минимуму эффекты дискового кэша (если файловая система не поддерживает прямой ввод-вывод, программа сообщит о неудаче проверки). Имейте в виду, эта функция заметно снижает скорость операции. Обратите внимание, каждый файл будет прочитан дважды, поэтому общий размер файлов в полосе прогресса операции будет увеличен в два раза. В macOS эта функция доступна экспериментально.
Проверять свободное место – Перед копированием файла Double Commander проверит, достаточно ли свободного места на диске в целевом каталоге.
Резервировать место – Если отмечено, Double Commander будет использовать предварительное выделение дискового пространства, это снизит вероятность фрагментации файла. Также это более быстрый способ создания файлов. В Windows Double Commander всегда резервирует место. Не работает в Linux на разделах с файловой системой FAT32.
Следовать ссылкам – Если отмечено, Double Commander будет считать символьные ссылки на папки обычными папками и копировать их содержимое; вместо ссылок на файл будут скопированы файлы, на которые они указывают. Неопределённое (третье) состояние флажка: программа будет каждый раз спрашивать, что она должна делать.
Во-первых, должны быть установлены пакеты gvfs, gvfs-backends и gvfs-fuse. Имейте в виду, что в некоторых дистрибутивах нет пакетов gvfs-backends и gvfs-fuse, потому что они часть пакета gvfs, или же может быть несколько пакетов с именами gvfs-backends-* или gvfs-*.
-Теперь вставьте путь GVfs в строку адреса: для редактирования щёлкните правой кнопкой мыши по панели текущего адреса (или вызовите внутреннюю команду cm_EditPath).
+Теперь вставьте путь GVfs в строку адреса: для редактирования щёлкните правой кнопкой мыши по панели текущего адреса (или вызовите внутреннюю команду cm_EditPath). В качестве альтернативы вы можете использовать внутреннюю команду cm_MapNetworkDrive.
Например, доступ к
ftp://ftpuser@ftpserverВ: Для чего кнопки R и Все в настройках цвета?
+В: Для чего кнопки С и Все в настройках цвета?
О: Всё очень просто:
R – восстанавливает цвет на тот, который был по умолчанию.
С – восстанавливает цвет на тот, который был по умолчанию.
Все – применяет выбранный цвет для всех колонок.
В: Как сделать функциональные клавиши и панель адреса побольше?
-О: Размер зависит от размера шрифта, существует три способа:
-1. Простой и быстрый: вы можете использовать Ctrl+колесо мыши, работает для следующих элементов интерфейса или частей DC:
- - список файлов в левой и правой панелях;
- - панель текущего каталога (адреса);
- - панель функциональных клавиш;
- - древовидное меню;
- - результаты поиска в диалоге поиска файлов;
- - встроенный редактор;
- - встроенный просмотрщик (если просмотрщик показывает текст, то это действие изменит размер шрифта, если изображение – действие будет работать как команды увеличения/уменьшения).
В: Как сделать функциональные клавиши, панель адреса и другие элементы интерфейса побольше?
+О: Размер зависит от размера шрифта, существует несколько способов:
+1. Простой и быстрый: вы можете использовать Ctrl+колесо мыши, смотрите Масштабирование.
2. Откройте "Настройки" в главном меню > Параметры... > Шрифты.
Примечание: Всё возможное доступно только в версии 1.0.0+, для 0.9.x и ниже дополнительно смотрите третий пункт.
3. Закройте DC > откройте doublecmd.xml > найдите тег <Fonts></Fonts> и вручную измените <Size> элемента интерфейса.
3. Для файловых панелей вы можете использовать внутренние команды cm_MainFontZoomOut и cm_MainFontZoomIn. Схожие команды доступны во встроенном просмотрщике и редакторе.
+4. Закройте DC > откройте doublecmd.xml > найдите тег <Fonts></Fonts> и вручную измените <Size> элемента интерфейса.
В: Файловые панели: как изменить высоту элементов (строк) и интервалов между ними?
О: Вид зависит от следующих параметров:
<FilesViews>)О: При назначении горячей клавиши Double Commander позволяет ограничить область работы сочетания клавиш, смотрите Только для этих элементов интерфейса.
В данном случае вам необходимо включить "Files Panel".
В: Есть ли способ добавить звуковые уведомления об окончании операций?
+О: Смотрите описание <Sounds>.
diff --git a/doc/ru/findfiles.html b/doc/ru/findfiles.html index da758427..ac355212 100644 --- a/doc/ru/findfiles.html +++ b/doc/ru/findfiles.html @@ -69,6 +69,7 @@Эта настройка управляет глубиной "погружения" по дереву каталогов во время поиска. Указав "только текущий", мы ограничим поиск папкой, указанной в поле "Начинать с каталога" (подкаталоги просматриваться не будут).
В поле Искать файлы задаём маску, по которой будет осуществляться поиск. Или мы можем просто указать имя файла или его часть.
+Примечание: Имейте в виду, что Double Commander сохраняет общую историю масок файлов для нескольких инструментов: поиск файлов, синхронизация каталогов, распаковка архивов, команды выделения групп файлов.
Дополнительные параметры:
Искать в архивах – если включено, Double Commander дополнительно попытается прочитать содержимое всех архивов в каталоге(ах) поиска. Список поддерживаемых форматов зависит от добавленных архиваторных плагинов.
сравнить имена файлов;
сравнить размеры файлов;
сравнить хеши: будет использоваться контрольная сумма BLAKE2b (x64) или BLAKE2s;
сравнить хеши: будет использоваться контрольная сумма BLAKE3 (x86-64), BLAKE2b (остальные 64-битные процессоры) или BLAKE2s;
сравнить содержимое файлов (побайтовое сравнение).
В результате будут показаны имена файлов, номер группы совпадающих файлов и расположение файлов. Также после передачи списка в панель мы можем использовать специальный режим выделения, где можно выбрать только дубликаты: @@ -293,6 +294,7 @@
В зависимости от типа данных, возвращаемых полем плагина, будет доступен помощник ввода значения: калькулятор (число) или календарь (дата и/или время).
@@ -310,7 +312,8 @@Просмотр – открывает выбранный файл в окне просмотрщика (F3).
Правка – открывает выбранный файл в редакторе (F4).
Перейти к файлу – закрывает окно поиска, открывает в активной файловой панели каталог выбранного файла и устанавливает курсор на этом файле (Enter или двойной щелчок).
Перейти к файлу – закрывает окно поиска, открывает в активной файловой панели каталог выбранного файла и устанавливает курсор на этом файле (Enter или двойной щелчок).
+ Чтобы оставить окно поиска открытым, мы можем использовать клавишу Пробел или назначить любую другую горячую клавишу для команды cm_GotoFile и добавить close=0 в параметры.
Файлы на панель – передаёт список найденных файлов в активную файловую панель.
Также доступно контекстное меню:
@@ -323,6 +326,7 @@Чтобы выделить несколько файлов, мы можем использовать мышь и клавиши Ctrl и Shift или Shift и стрелки.
Клавиши стрелка влево и стрелка вправо переключают фокус между списком результата поиска и кнопкой Новый поиск.
+Список найденных файлов будет очищен при запуске нового поиска или при закрытии приложения, то есть мы можем повторно открыть диалоговое окно поиска и просмотреть результат предыдущего поиска.
diff --git a/doc/ru/help.html b/doc/ru/help.html index d5ed4364..96f7b6e5 100644 --- a/doc/ru/help.html +++ b/doc/ru/help.html @@ -121,7 +121,7 @@В этом меню собраны практически все операции, которые можно производить над файлами. Рассмотрим по порядку:
Создать символьную ссылку... (команда cm_SymLink). Если выбрать этот пункт, то Double Commander создаёт символьную ссылку на файл под курсором и помещает в папку, открытую в противоположной панели.
-
Имя ссылки – здесь указывается путь ссылки и её имя. Именем будет последнее слово после последнего символа разделителя каталогов в строке.
На что указывает – объект, на который создаётся ссылка.
Относительный путь, если возможно – если возможно, Double Commander будет использовать относительный путь к каталогу объекта.
@@ -129,7 +129,7 @@Создать жёсткую ссылку... (команда cm_HardLink). Аналогично предыдущему пункту, только ссылка будет жёсткая и использование относительного пути будет недоступно.
Создать каталог (команда cm_MakeDir) – создаёт новый подкаталог в текущем каталоге. Будет предложено имя файла (без расширения) или имя каталога под курсором, это удобно для создания нескольких каталогов с похожими именами. Также можно создавать несколько подкаталогов за одну операцию, просто отделите подкаталоги разделителем каталогов (в системах Unix/Linux это будет "/" и "\" в Windows).
-
Кнопка со стрелкой вниз открывает историю введённых имён. Кнопка справа от поля ввода позволяет включить или выключить автодополнение из истории создания каталогов.
Если включен Расширенный синтаксис, для вставки текущей даты/времени может быть использован шаблон <[]: внутри квадратных скобок можно использовать символы форматирования даты и времени, а также любые символы, допустимые для имён файлов.
в котором отображается имя файла или папки, MIME-тип, расположение, размер, время модификации и последнего доступа. Для ссылок Double Commander дополнительно покажет объект ссылки (символьная ссылка) или их общее количество (жёсткая ссылка). На вкладке "Атрибуты" можно изменить уровень доступа к файлу и его владельца (если у вас есть на это права). Вкладка "Плагины" опциональна и доступна только если есть подходящий информационный плагин (в данном случае это DEB). Также смотрите описание <SystemItemProperties>.
-Воспользовавшись пунктом Редактировать комментарий (команда cm_EditComment) вы можете создавать или изменять комментарии к файлам, которые хранятся в файле descript.ion. Поддерживаются кодировки UTF, ISO, KOI и ANSI. В разделе настроек Разное вы можете задать кодировку текста по умолчанию.
-Комментарии работают только с обычными файлами в локальной файловой системе, но не с удалёнными или виртуальными файловыми системами (например, на FTP-сервере, в архиве и тому подобное). Чтобы Double Commander учитывал содержимое descript.ion при копировании или перемещении файлов, убедитесь, что в разделе настроек Файловые операции включено Обрабатывать комментарии с файлами/папками.
+Воспользовавшись пунктом Редактировать комментарий (команда cm_EditComment) вы можете создавать или изменять комментарии к файлам, которые хранятся в файле descript.ion (для удаления комментария откройте диалоговое окно и очистите поле редактирования). Поддерживаются кодировки UTF, ISO, KOI и ANSI. В разделе настроек Разное вы можете задать кодировку текста по умолчанию.
+Комментарии работают только с обычными файлами в локальной файловой системе, но не с удалёнными или виртуальными файловыми системами (например, на FTP-сервере, в архиве и тому подобное). Чтобы Double Commander учитывал содержимое descript.ion при файловых операциях, убедитесь, что в разделе настроек Файловые операции включено Обрабатывать комментарии с файлами/папками.
Подсчитать занимаемое место (команда cm_CalculateSpace) рассчитывает размер выделенных папок и файлов в удобных для восприятия округлённых единицах и в байтах.
Действие кнопки Настроить зависит от выбранного архиватора:
архиваторные плагины (WCX): открывает собственное окно настроек плагина (если выбранный плагин поддерживает эту функцию);
внешние архиваторы: открывает окно с полем ввода для дополнительных параметров архиватора (при использовании переменной %S).
внешние архиваторы: открывает окно с полем ввода для дополнительных параметров архиватора (при использовании переменной %S). Double Commander автоматически сохраняет введённую строку параметров, кнопка со стрелкой откроет список сохранённых ранее (смотрите описание AskHistory).
Обратное действие можно выполнить, воспользовавшись пунктом Распаковать (команда cm_ExtractFiles). Этот же диалог вызывается при копировании файлов из архива, если вы вошли в него как в каталог.
В поле Распаковать файлы по маске можно указать маску, определяющую, какие файлы будут распакованы. История масок доступна в выпадающем списке. - В следующей строке указывается каталог назначения (то есть куда будет распакован архив). Его можно сменить вручную или нажав на кнопку обзора справа.
+В поле Распаковать файлы по маске можно указать маску, определяющую, какие файлы будут распакованы. История масок доступна в выпадающем списке.
+Примечание: Имейте в виду, что Double Commander сохраняет общую историю масок файлов для нескольких инструментов: поиск файлов, синхронизация каталогов, распаковка архивов, команды выделения групп файлов.
+В следующей строке указывается каталог назначения (то есть куда будет распакован архив). Его можно сменить вручную или нажав на кнопку обзора справа.
Распаковать каждый архив в отдельный каталог (с именем архива) – Если отмечено, Double Commander создаст в каталоге назначения папку с именем архива и извлечёт файлы в эту папку. С помощью этой опции вы можете распаковать сразу несколько архивов и каждый будет распакован в свою папку в целевом каталоге. Неопределённое (третье) состояние флажка включает "умную" распаковку: если в корне архива несколько объектов, то содержимое архива будет распаковано в папку с именем архива, но если один объект, то содержимое будет распаковано как есть. По умолчанию не отмечено и состояние не сохраняется для следующего вызова команды извлечения.
Учитывать подкаталоги – Если отмечено, структура каталогов в архиве будет сохранена. В противном случае все файлы будут извлечены без воссоздания структуры каталогов.
Флажок Заменять существующие файлы запрещает подтверждение перезаписи файлов.
@@ -214,10 +215,12 @@Пункт Посчитать контрольные суммы... (команда cm_CheckSumCalc) используется для подсчёта контрольных сумм файлов с целью проверки их целостности. Доступны следующие алгоритмы: BLAKE2 (BLAKE2s, BLAKE2sp, BLAKE2b, BLAKE2bp), BLAKE3, CRC32, HAVAL, MD4, MD5, RIPEMD128, RIPEMD160, SFV, SHA, - SHA2 (размер хеша 224, 256, 384 или 512 байт), SHA3 (размер хеша 224, 256, 384 или 512 байт), Tiger/192.
-
Сохранить файл(ы) контрольных сумм как: – строка указывает, где и под каким именем будет сохранён файл, содержащий контрольную сумму.
Для каждого файла создать отдельный файл контрольной суммы – если сумма считается для нескольких выделенных файлов, то для каждого будет создан отдельный файл с контрольной суммой, иначе будет создан один общий, с контрольными суммами всех выделенных файлов.
+Для каждого каталога создать отдельный файл контрольной суммы – Double Commander просканирует выделенные папки или папку под курсором и создаст отдельные файлы контрольной суммы в каждом подкаталоге. Программа не будет учитывать список исключений и состояние параметра Показывать системные и скрытые файлы.
Открыть файл контрольной суммы после расчёта – после завершения операции файл контрольной суммы будет открыт в программе просмотра файлов.
Формат файла – позволяет указать тип окончания строк и разделитель каталогов вместо обычно используемых значений в Windows (CRLF и "\") и Unix-подобных системах (LF и "/").
@@ -238,7 +241,9 @@Здесь собраны команды, при помощи которых можно выделить группу файлов, а также производить разные действия с выделением.
-Первый и второй пункты Выделить группу и Снять выделение с группы (команды cm_MarkPlus и cm_MarkMinus). Эти команды выделяют группы файлов по маске. В маске можно указать часть имён файлов или расширения (вы можете указать несколько значений, перечислив их через точку с запятой ";" без пробелов). Кнопка со стрелкой вниз в конце строки открывает список истории масок. Например, выделить в каталоге все файлы с расширением txt:
+Первый и второй пункты Выделить группу и Снять выделение с группы (команды cm_MarkPlus и cm_MarkMinus). Эти команды выделяют группы файлов по маске. В маске можно указать часть имён файлов или расширения (вы можете указать несколько значений, перечислив их через точку с запятой ";" без пробелов). Кнопка со стрелкой вниз в конце строки открывает список истории масок.
+Примечание: Имейте в виду, что Double Commander сохраняет общую историю масок файлов для нескольких инструментов: поиск файлов, синхронизация каталогов, распаковка архивов, команды выделения групп файлов.
+Например, выделить в каталоге все файлы с расширением txt:
Кнопка Шаблон... даёт возможность создать новый шаблон поиска.
Если в активной панели открыт результат поиска дубликатов, эти команды будут работать в специальном режиме:
@@ -282,6 +287,7 @@Открыть список VFS (команда cm_OpenVirtualFileSystemList) откроет список добавленных плагинов файловой системы (WFX-плагинов), использующих собственные файловые системы или предоставляющие доступ к другим файловым системам и устройствам (локальным или удалённым). А также виртуальные папки:
Компьютер – содержит список обычных дисков с буквой диска и устройств, которые не имеют буквы диска (например, USB-устройства, которые подключены по протоколу MTP, то есть смартфоны, планшеты или плееры). Только Windows.
iCloud – доступ к содержимому диска iCloud. Дополнительно вы можете выбрать папки приложений, которые будут доступны в этой виртуальной папке. Только macOS.
Linux – список всех дистрибутивов Linux, которые вы добавили в WSL, и их корневые файловые системы (Windows 10 и новее).
Сеть – доступ к общим сетевым ресурсам (Windows) или к сетевым ресурсам с помощью Gio (Linux).
Корзина – доступ к файлам, удалённым в корзину.
Double Commander позволяет переименовывать файлы непосредственно в файловой панели. Доступно несколько способов вызова этой операции: внутренняя команда cm_RenameOnly (по умолчанию F2 или Shift+F6), щелчок левой клавиши мыши или соответствующий пункт в меню правой клавиши мыши.
По умолчанию Double Commander выделит имя файла полностью, но вы можете включить выделение имени файла без расширения. Также повторные нажатия горячей клавиши позволяют выделять имя файла по частям, в качестве разделителя используются следующие символы: пробел, дефис, нижнее подчёркивание и точка. Имена папок всегда выделяются полностью.
Для подтверждения изменения имени используйте клавишу Enter или кнопку подтверждения переименования справа от поля редактирования. Для отмены неподтверждённых изменений (для выхода из режима редактирования) используйте клавишу Esc или щелчок мыши вне поля редактирования. Вы можете использовать щелчок мыши вне поля редактирования для подтверждения переименования (как в Проводнике Windows), смотрите описание <RenameConfirmMouse>.
+С помощью стрелок вверх и вниз вы можете последовательно переименовать несколько файлов: новое имя файла будет автоматически сохранено при переходе к правке имени следующего или предыдущего файла. Для выхода из этого режима используйте описанные выше способы подтверждения или отмены операции.
Для группового переименования файлов доступен соответствующий инструмент.
При использовании инструмента быстрого поиска/фильтра, его панель отображается внизу файловой панели. Быстрый поиск используется для поиска по текущему содержимому файловой панели: курсор будет перемещён на ближайший подходящий файл и при использовании клавиш стрелка вверх и стрелка вниз программа будет перемещать курсор по кругу только по файлам, имена которых соответствуют условиям. Быстрый фильтр скроет все имена файлов, не соответствующие условиям (для сброса фильтра используйте клавишу Esc или кнопку "X").
-
Фильтр – переключатель поиск/фильтр;
{ – имя должно начинаться с набранных символов;
} – последние символы до набранной точки "." должны совпадать;
Aa – учитывать регистр символов;
Ďï – диакритика и лигатуры;
Ф – фильтровать файлы;
К – фильтровать каталоги;
X – отключить быстрый поиск и закрыть панель.
Чтобы использовать скрипты Lua, нам требуется интерпретатор Lua, Double Commander поддерживает версии 5.1 - 5.4.
+Чтобы использовать скрипты Lua, нам требуется интерпретатор Lua, Double Commander поддерживает версии 5.1 - 5.5.
Мы можем использовать DLL-файл проекта LuaJIT. LuaJIT сочетает в себе высокоскоростной интерпретатор, написанный на ассемблере, и JIT-компилятор. Также мы получаем библиотеку FFI: с её помощью в скриптах можно будет вызывать внешние функции C и использовать структуры данных C.
Дистрибутивы DC для Windows включают в себя DLL-файл Lua (в DC 0.9.7 и новее из проекта LuaJIT), в иных случаях мы можем найти и установить его с помощью менеджера пакетов или скомпилировать. Если используем 64-битную версию DC, то DLL-файл также должен быть 64-битным.
По умолчанию DC ищет файл с именем lua5.1.dll (Windows), liblua5.1.so.0 (Unix или GNU/Linux) или liblua5.1.dylib (macOS) в своём каталоге и в системном. Мы можем изменить имя файла (и путь) в параметре Библиотека Lua.
@@ -158,9 +158,9 @@Пишет сообщение в окно протокола:
true, то показать окно протокола (если оно скрыто).true, то сообщение будет записано и в файл протокола.true, то показать окно протокола (если оно скрыто). По умолчанию true.true, то сообщение будет записано и в файл протокола. По умолчанию false.Внутренняя функция Double Commander для записи в протокол работает асинхронно (смотрите примечания во введении), поэтому сообщения из DC.LogWrite будут записаны в протокол не сразу, а после завершения работы скрипта. Если необходимо записать текст сообщения сразу, мы можем попробовать добавить вызов DC.ExecuteCommand("") после DC.LogWrite.
"Внутри" сжатого файла мы можем выполнять некоторые минимальные базовые функции, такие как просмотр файла, копирование его в другую панель и некоторые другие.
На изображении ниже показан пример открытия сжатого файла "help.rar":
После вызова команды просмотра (F3) или редактирования (F4), Double Commander извлечёт файл под курсором в системный каталог для временных файлов и откроет. После закрытия просмотрщика временный файл будет удалён. Если открытый в редакторе файл будет изменён, Double Commander предложит упаковать его обратно (если формат сжатых файлов и архиваторный плагин или внешний архиватор поддерживают такую возможность).
+После вызова команды просмотра (F3) или редактирования (F4), Double Commander извлечёт файл под курсором в системный каталог для временных файлов и откроет. После закрытия просмотрщика временный файл будет удалён. Если открытый в редакторе файл будет изменён, Double Commander может упаковать его обратно (если формат сжатых файлов и архиваторный плагин или внешний архиватор поддерживают такую возможность), смотрите <AutoCopyBackward>.
При использовании двойного щелчка мыши или нажатии Enter Double Commander покажет окно свойств упакованного файла:
В строке Архиватор отображается имя используемого архиваторного плагина или имя внешнего архиватора.
@@ -115,7 +116,7 @@Все эти действия будут сконфигурированы в окне настроек Double Commander в разделе "Архиваторы":
-
Все настройки сохраняются в файл multiarc.ini.
Давайте рассмотрим универсальные возможности, предлагаемые нам Double Commander для использования внешнего упаковщика.
@@ -134,7 +135,7 @@Далее нам нужно добавить описание архиватора, путь к исполняемому файлу, а затем расширение файла, без точки.
Если у нас более одного возможного расширения, просто перечисляем их через запятую, без пробела.
-
Примечание: Double Commander поддерживает двойные расширения (например, "tar.gz", "tar.xz" и так далее), они должны размещаться в начале списка расширений (то есть "tar.gz" до "gz").
@@ -498,7 +499,33 @@Несколько параметров, которые можно добавить или изменить вручную в файле конфигурации multiarc.ini напрямую или с помощью экспорта/импорта настроек архиватора.
+AskHistory0 ... AskHistory50
+В значениях сохраняются дополнительные параметры архиватора, которые мы добавили в диалоге упаковки файлов. Мы можем вручную изменить их, добавить новые или удалить ненужные.
+Это удобный способ хранить несколько наборов параметров, более подходящих для разных групп файлов и задач.
+FallBackArchivers
+Позволяет указать несколько исполняемых файлов архиваторов через запятую (полные имена файлов или имена без пути). Если исполняемый файл из поля "Архиватор" не найден, приложение будет использовать первый найденный из значения FallBackArchivers.
В качестве примера смотрите использование 7-Zip в multiarc.ini в папке "default".
+IgnoreString0 ... IgnoreString50
+Это способ указать строки, которые Double Commander должен игнорировать при разборе вывода архиватора.
+Если значение начинается с символа карет ("^"), то текст должен быть в начале игнорируемых строк. В противном случае текст может располагаться в любом месте строки.
+SizeStripChars
+Это редкость, но архиватор может отображать размер файлов с группировкой цифр по разрядам (например, "12,345" или "12 345" вместо "12345"). SizeStripChars позволяет указать символ, который должен быть удалён.
Если нам необходимо указать несколько символов (например, значение может зависеть от региональных настроек операционной системы), то они должны быть перечислены без разделителя.
+ +Это меню содержит несколько дополнительных функций:
Автонастройка – Double Commander проверит все исполняемые файлы архиваторов: если файл будет найден, то программа автоматически добавит его полный путь и включит архиватор, в противном случае архиватор будет отключен.
Мы можем просто удалить расширение из настроек, но в этом случае станут недоступны команды cm_OpenArchive и cm_ExtractFiles. Другой способ:
Если используется WCX-плагин, то мы можем открыть настройки плагина, выбрать расширение и включить флаг "Показывать как нормальные файлы (скрывать значок архива)".
Если для распаковки файлов используется внешний архиватор, то мы можем заполнить поля для использования ID и не указывать расширение файлов.
Если для распаковки файлов используется внешний архиватор, то мы можем использовать опцию "Показывать как нормальные файлы" или мы можем заполнить поля для использования ID и не указывать расширение файлов. Первый способ также позволяет создавать новые архивы.
Для таких файлов Double Commander будет использовать ассоциированный значок вместо общего значка архива.
diff --git a/doc/ru/multirename.html b/doc/ru/multirename.html index 9eca11b9..903386e3 100644 --- a/doc/ru/multirename.html +++ b/doc/ru/multirename.html @@ -108,7 +108,7 @@Это приведёт нас к диалоговому окну инструмента группового переименования:
-
В верхней части мы видим таблицу с файлами, выделенными на исходной панели, по одному файлу на строку. Мы можем переупорядочить список файлов, используя перетаскивание мышью или клавиши Shift+стрелки. Для удаления файла из списка мы можем использовать клавишу Del (после удаления всех файлов Double Commander закроет инструмент группового переименования).
Таблица содержит три колонки:
Примеры:
@@ -168,7 +171,7 @@\x10, \x11, \x12 или \x13\x0A, \x0B, \x0C, \x0DВыражения, помогающие указать разделители строк.
-| Разделители строк | |
|---|---|
| Выражение | Результат |
^ |
- начало строки | -
$ |
- конец строки | -
\A |
- начало текста | -
\Z |
- конец текста | -
. |
- любой символ в строке | -
Несколько примеров:
-| Примеры с разделителями строк | |
|---|---|
| Выражение | Результат |
^foobar |
- находит foobar только в начале строки |
-
foobar$ |
- находит foobar только в конце строки |
-
^foobar$ |
- находит foobar только если это единственное слово в строке |
-
foob.r |
- находит foobar, foobbr, foob1r и т.д. |
-
Метасимвол ^ по умолчанию совпадает только с началом входного текста, а метасимвол $ – только с концом текста. Внутренние разделители строк, имеющиеся в тексте, не будут совпадать с ^ и $.
Однако, если вам необходимо работать с текстом как с многострочным, чтобы ^ совпадал после каждого разделителя строки внутри текста, а $ – перед каждым разделителем, то вы можете включить модификатор m.
Метасимволы \A и \Z аналогичны ^ и $, но на них не действует модификатор m, т.е. они всегда совпадают только с началом и концом всего входного текста.
Метасимвол . по умолчанию совпадает с любым символом, однако, если вы выключите модификатор s, то . не будет совпадать с разделителями строк.
TRegExpr интерпретирует разделители строк так, как это рекомендовано в технических стандартах юникода (Technical Standard #18):
-^ совпадает с началом входного текста, а также, если включен модификатор m, с точкой, непосредственно следующей после \x0D\x0A, \x0A или \x0D (с поддержкой юникода: также \x2028, \x2029, \x0B, \x0C или \x85). Обратите внимание, что он не совпадает в промежутке внутри последовательности \x0D\x0A.
$ совпадает с концом входного текста, а также, если включен модификатор m, с точкой, непосредственно предшествующей \x0D\x0A, \x0A или \x0D (с поддержкой юникода: также \x2028, \x2029, \x0B, \x0C или \x85). Обратите внимание, что он не совпадает в промежутке внутри последовательности \x0D\x0A.
. совпадает с любым символом, но если выключен модификатор s, то . не совпадает с \x0D\x0A, \x0A и \x0D (с поддержкой юникода: также с \x2028, \x2029, \x0B, \x0C и \x85).
Обратите внимание, что ^.*$ (шаблон для пустой строки) не совпадает с пустой строкой вида \x0D\x0A, но совпадает с \x0A\x0D.
Метасимвол . совпадает с любым символом, но если выключен модификатор s, то . не совпадает с \x0D\x0A, \x0A и \x0D (с поддержкой юникода: также с \x{2028}, \x{2029}, \x0B, \x0C и \x85).
Символ . не действует как метасимвол внутри пользовательских наборов символов: [.] означает буквальную точку.
\s\x0D\x0A, \x0A, \x0D, \x0B, \x0C (с поддержкой юникода: также \x{2028}, \x{2029} и \x85)Стандартные наборы \w, \d и \s можно использовать и внутри наборов символов.
Примеры:
@@ -314,7 +265,64 @@Выражения, помогающие указать разделители строк.
+| Разделители строк | |
|---|---|
| Выражение | Результат |
^ |
+ начало строки | +
$ |
+ конец строки | +
\A |
+ начало текста | +
\Z |
+ конец текста | +
\G |
+ совпадение нулевой длины в конечной позиции предыдущего совпадения или если не было совпадения, начало строки (^) |
+
Несколько примеров:
+| Примеры с разделителями строк | |
|---|---|
| Выражение | Результат |
^foobar |
+ находит foobar только в начале строки |
+
foobar$ |
+ находит foobar только в конце строки |
+
^foobar$ |
+ находит foobar только если это единственное слово в строке |
+
Метасимвол ^ по умолчанию совпадает только с началом входного текста, а метасимвол $ – только с концом текста. Внутренние разделители строк, имеющиеся в тексте, не будут совпадать с ^ и $.
Однако, если вам необходимо работать с текстом как с многострочным, чтобы ^ совпадал после каждого разделителя строки внутри текста, а $ – перед каждым разделителем, то вы можете включить модификатор m.
Метасимволы \A и \Z аналогичны ^ и $, но на них не действует модификатор m, т.е. они всегда совпадают только с началом и концом всего входного текста.
Метасимвол . по умолчанию совпадает с любым символом, однако, если вы выключите модификатор s, то . не будет совпадать с разделителями строк.
TRegExpr интерпретирует разделители строк так, как это рекомендовано в технических стандартах юникода (Technical Standard #18):
+^ совпадает с началом входного текста, а также, если включен модификатор m, непосредственно после \x0D\x0A, \x0A или \x0D (с поддержкой юникода: также \x{2028}, \x{2029}, \x0B, \x0C или \x85). Обратите внимание, что он не совпадает в промежутке внутри последовательности \x0D\x0A.
$ совпадает с концом входного текста, а также, если включен модификатор m, непосредственно перед \x0D\x0A, \x0A или \x0D (с поддержкой юникода: также \x{2028}, \x{2029}, \x0B, \x0C или \x85). Обратите внимание, что он не совпадает в промежутке внутри последовательности \x0D\x0A.
Обратите внимание, что ^.*$ (шаблон для пустой строки) не совпадает с пустой строкой вида \x0D\x0A, потому что это неразрывный разделитель строк. Но совпадает с \x0A\x0D, потому что это 2 перевода строки в неправильном порядке.
Граница слова (\b) – позиция между двумя символами, один из которых удовлетворяет \w, а другой – \W (в любом порядке), при этом перед началом и после конца строки подразумевается \W.