diff --git a/doc/en/cm_options.html b/doc/en/cm_options.html index 0a17c661..8fccb98c 100644 --- a/doc/en/cm_options.html +++ b/doc/en/cm_options.html @@ -45,6 +45,10 @@
Parameter | +Value | +Description | +
---|---|---|
filename | +file name | +full path to file with list | +
side | +left | +load list into left panel | +
right | +load list into right panel | +|
active | +load list into active panel | +|
inactive | +load list into inactive panel | +|
(nothing) | +load list into active panel | +|
(absent) | +load list into active panel | +
The main files are:
doublecmd.xml – all the main program settings;
doublecmd.cfg(Alpha version) – settings that are applied before initialization of all program components and loading doublecmd.xml;
extassoc.xml – file extension association configuration;
pixmaps.txt – maps file extensions to MIME-types icon names;
multiarc.ini – external archivers;
Tab indents blocks – If enabled, Tab and Shift+Tab act as block indent, unindent when text is selected.
Smart Tabs – When the Tab key is used, caret will go to the next non-space character of the previous line.
Tab width – The width of the tab character (in number of characters). If Use spaces instead tab characters is enabled, then the Tab key will insert the specified number of space characters. This setting does not apply if the Smart Tabs option is enable.
+Block indent(Alpha version) – sets the number of characters by which the indent will increase or decrease when using the corresponding commands.
Right margin – Line length marker, thin vertical line at the given position: lines will not be truncated with a forced line break, it is just a visual hint. Useful in cases where there is a recommendation to limit the length of strings (for example, 80 or 120 characters).
Normal (proportional) font above, monospaced below.
2.5. Colors(Alpha version)
+Dark mode – enables or disables dark mode support (only Windows 10 1809 and newer):
+Auto – system settings will be used.
Enabled – enable forcibly.
Disabled – disable forcibly.
This section contains settings for the appearance of file panels:
@@ -787,14 +798,15 @@This section contains parameters for which there was no suitable place in other sections of the settings:
- + +Show splash screen(Alpha version) – If enabled, before displaying the main window, Double Commander will show a splash screen containing the program icon and version, compilation date, and the version of Lazarus, FPC, and operating system.
Show warning messages ("OK" button only) – shows warning messages if enabled. (For example, if Double Commander cannot set some property or attribute of a file due to file system restrictions in the target directory.)
Always go to the root of a drive when changing drives – If unchecked, Double Commander will go to the last open directory on this drive (in this case, you can go to the root directory of the drive by pressing its button twice).
Show current directory in the main window title bar – If enabled, Double Commander will display the name of the current folder and the active panel path in the main window title bar.
Thumbnails – Here you can enable to save cache of thumbnails of images and set their size. The thumbnail cache directory can be found in the Configuration section. Double Commander uses PNG or JPEG (only for *.bmp, *.jpg and *.jpeg) formats. The thumbnail name is the MD5 sum of the full name of the source file. The full name of the source file, its size and modification date will be added to the file.
The Remove thumbnails for no longer existing files button will help to remove obsolete thumbnails.
File comments (descript.ion) – Here you can set the default encoding for existing file comments (OEM, ANSI or UTF-8) and the encoding for new files (UTF-8 BOM, UTF-16 LE or UTF-16 BE).
-The next group of parameters is used for import from Total Commander and export Directory Hotlist and toolbar: TC executable, Configuration file and Toolbar output path
+The next group of parameters is used for import from Total Commander and export Directory Hotlist and toolbar: the path and name of the Total Commander executable file and the main configuration file, as well as the directory where the toolbar files are located.
{!VIEWER} – call viewer (internal or external, depends on the configuration);
{!SHELL} – run in terminal and stay open at the end.
As a command, you can use the internal commands of Double Commander. The parameters of the internal commands are specified one per line, so you can specify only one here. Also, using the internal command cm_Execute Script, you can run Lua scripts, in this case you can get the names of the selected files using cm_CopyFullNamesToClip or cm_SaveSelectionToFile.
+As a command, you can use the internal commands of Double Commander. The parameters of the internal commands are specified one per line, so you can specify only one here. Also, using the internal command cm_ExecuteScript, you can run Lua scripts, in this case you can get the names of the selected files using cm_CopyFullNamesToClip or cm_SaveSelectionToFile.
Parameters – command parameters including variables:
any variable from "percent" variables.
At a minimum, you must specify a file name, usually %p
.
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).
-An association sets example, called doublecmd.ext.example, is in the program directory.
All available actions will be displayed in the "Actions" submenu in the context menu:
True
) or text from the search history (False
). True
by default.True
) or disables automatic copying of the selected text to the clipboard. True
by default.True
) or the number of files (False
, by default).True
, the status bar will also show the number of files when the cursor is on the ".." item. For links, target objects will additionally be displayed.ImageBackColor2
defines the color of the squares.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. Not available in macOS(*).
Check free space – Double Commander calculates the size of the selected files, so it can check if there is enough free 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.
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. In the third state (the square is filled with color or with a dash): the program will ask each time what it should do.
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.
Correct links – If enabled, Double Commander will check the links and, if necessary, correct their target path based on the target directory. If a relative path is specified, then the corrected path will also be written as relative.
Copy attributes – If enabled, the attributes of the source file will be copied, otherwise, default values will be used: 666 (files) or 777 (folders). Also see description of <CopyXattributes>
here. For Windows: see description of <CopyAttributes>
here.
Drop readonly flag – If enabled, Double Commander will add "w" attribute (Linux).
(DC supports both formats.)
How to create or edit:
Use UniHighlighter Editor or HglEditor (download). Both programs were written for Windows, but you can use Wine. HglEditor will save HGL-file in the new format.
- Two packs of various highlighters are also available.
How to add:
1) Portable version
Copy (or move) your HGL-file(s) to the "highlighters" folder near doublecmd.exe and restart DC.
Q: What does the message "This is not a valid plugin!" mean?
-A: This usually means a problem with dependencies: not all required libraries are available in your system. How to find out the names of libraries:
+A: This usually means a problem with dependencies: not all required libraries are available in your system. If there are no details in the description of the plugin, could not contact the author or find a solution using search engines, then try the following:
ldd pluginname | grep "not found"
ldd pluginname | grep "not found"
), GNU Binutils or AnyELF plugin.If this is a WDX plugin written in Lua:
1. The Lua library is not available: see DLL required.
diff --git a/doc/en/help.html b/doc/en/help.html index 79123556..8dcbf6e7 100644 --- a/doc/en/help.html +++ b/doc/en/help.html @@ -90,11 +90,11 @@For Linux there are versions based on GTK toolkit and based on Qt. Also portable version is available (compiled binaries packed with XZ, use doublecmd.sh to launch).
Note: The features of the update of the portable version are described in the FAQ.
On the first launch Double Commander will automatically detect the system language, and set it for the interface. DC is translated into many languages. The language can be changed in the menu via Configuration > Options... > Language.
-Double Commander determines and uses the current system theme. It looks like this (Ubuntu, two themes and two icon sets):
- -As can be seen from the figure, there are left file panel, a command line and a lower window that is a log viewer (it shows all the actions from the file manager).
+Double Commander determines and uses the current system theme. It looks like this (Ubuntu, three themes and two icon sets):
+ +As can be seen from the figure, there are left file panel, a command line and a lower window that is a log viewer (it shows all the actions from the file manager). Double Commander also supports dark mode in Windows (Windows 10 1809 and newer).(Alpha version)
Double Commander uses Total Commander plugin API, so under Windows you can use plugins from Total Commander (many of them are compatible with DC). See the description of the types of plugins in the Plugins settings section.
-DC is distributed with several pre-installed plugins: several packer plugins (WCX) for working with archives as directories (virtual file system, VFS), file system plugin (WFX) for working with FTP, some content plugins (WDX). The program has a built-in Exif content plugin to get some data that can be stored in the metadata of JPEG files: date, pixel dimensions, image orientation and camera information. Version for Linux includes WFX plugin for working with network storage (SMB/CIFS), search plugin (DSX) and lister plugin (WLX) for viewing video. Version for Windows includes two WLX plugins: Windows Media Player and Explorer Preview plugin. Other plugins can be installed manually.
+DC is distributed with several pre-installed plugins: several packer plugins (WCX) for working with archives as directories (virtual file system, VFS), file system plugin (WFX) for working with FTP, some content plugins (WDX). The program has a built-in Exif content plugin to get some data that can be stored in the metadata of JPEG files: date, pixel dimensions, image orientation and camera information. Version for Linux includes WFX plugin for working with network storage (SMB/CIFS), search plugin (DSX) and lister plugin (WLX) for viewing video. Version for Windows includes three WLX plugins: Windows Media Player, Explorer Preview and plugin for viewing RTF(Alpha version). Version for macOS(*) includes the universal WLX plugin MacPreview.(Alpha version) Other plugins can be installed manually.
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 "\"), for example, directory1\directory2\directory3
.
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 "\").
+ +If Extended syntax(Alpha version) 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.
Create Shortcut (Windows only) – Double Commander creates a shortcut (Microsoft Windows .lnk file) to the file under the cursor, and places it in a folder, open on the adjacent panel.
@@ -174,7 +176,7 @@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.
-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. By default it is unchecked and its state is not saved for the next call of the extract command.
+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(Alpha version): 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.
@@ -399,7 +401,7 @@Display tabs. Click on tabs with left mouse or you can use the keyboard to navigate tabs (Ctrl+Tab and Ctrl+Shift+Tab by default). To change the order of the tabs, use drag & drop.
+Display tabs. Click on tabs with left mouse or you can use the keyboard to navigate tabs (Ctrl+Tab and Ctrl+Shift+Tab by default). To change the order of the tabs, use drag & drop or the cm_MoveTabLeft and cm_MoveTabRight commands(Alpha version).
You can protect tabs from closing or changing the directory, the available tab states are described in the "Tabs" subsection. Locked tabs are marked with an asterisk (if Show locked tabs with an asterisk * is enabled).
Value = os.getenv(VariableName)
Will return the Value of the variable VariableName passed in parameter.
If no variable of that name exists, it will return nil
.
os.setenv(VariableName, Value)
+Add or change the VariableName environment variable. In case of an error, the function returns -1.
os.unsetenv(VariableName)
+Remove the VariableName environment variable. In case of an error, the function returns -1.
The selected text will be automatically copied to the clipboard.
By default, the viewer call is assigned to the F3 key, we can change this in the settings. A quick view mode (Ctrl+Q) is also available: instead of a separate window, the opposite (inactive) file panel will be used.
-Supported image formats: BMP, CUR, GIF, ICNS, ICO, JPEG, PNG, PNM (PBM, PGM and PPM), PSD, TIFF, XPM. In addition, if the required libraries are available (near the executable file of Double Commander or in the PATH):
+Supported image formats: BMP, CUR, GIF, ICNS, ICO, JPEG, PNG, PNM (PBM, PGM and PPM), PSD, SVG/SVGZ(Alpha version), TIFF, XPM. In addition, if the required libraries are available:
HEIF/HEIC and AVIF: libheif-1.dll (Windows) or libheif.so.1 (Linux and other Unix-like systems)
SVG and SVGZ: libcairo-2.dll, librsvg-2-2.dll and libgobject-2.0-0.dll (Windows) or libcairo.so.2, librsvg-2.so.2 and libgobject-2.0.so.0 (Linux and other Unix-like systems)
WebP: libwebp.so.n, where "n" is 7, 6 or 5 (Linux and other Unix-like systems)
HEIF/HEIC and AVIF: libheif-1.dll (Windows) or libheif.so.1 (Linux and other Unix-like systems).
WebP: libwebp.so.n, where "n" is 7, 6 or 5 (Linux and other Unix-like systems).
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.(Alpha version)
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(*)).
Double Commander supports the TurboJPEG library: it is a JPEG codec that uses SIMD instructions to accelerate the decoding and encoding of images. If the following library file is available: libturbojpeg.dll (Windows), libturbojpeg.so.0 (Linux and other Unix-like systems) or libturbojpeg.dylib (macOS(*)).
+Note: In Windows, libraries must be located near the Double Commander executable file or in the PATH.
+Double Commander supports Windows Imaging Component (Windows Vista and newer)(Alpha version): the Windows Imaging Component (WIC) provides an extensible framework for working with images. WIC includes several built-in codecs (BMP, DDS, GIF, ICO, JPEG, JPEG, XR, PNG and TIFF), additionally available external codecs for free and proprietary RAW image formats, HEIF/HEIC, WebP. Double Commander will skip codecs for BMP, GIF, ICO, JPEG, PNG and TIFF, because these formats are already supported.
The built-in viewer supports saving to the following image formats: BMP, ICO, JPEG (we can choose the quality from 1 to 100), 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.
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.
@@ -102,12 +104,13 @@Show as Bin – Show file contents as is. Non-printable characters will be displayed as dots, however, when copying text, control characters (line feed, carriage return, tabulation and so on) will be respected. A fixed line width of 80 characters is used.
Show as Hex – The window will display three columns: offset from the beginning of the file (in bytes), 16 characters in hexadecimal representation and the same 16 characters in plain text. Non-printable characters will be displayed as dots. When selecting values in the second column, the corresponding symbols in the third column will be selected (and vice versa).
Show as Dec – Like the previous, but bytes will be represented in decimal notation.
Show as Wrap text – Like Show as Text, but with wrapping lines that do not fit in the window (by word boundaries).
Show as Book – A special viewing mode: text will be displayed in multiple columns (like a book spread or a newspaper). We can set the font and size, text and background colors, and the number of columns (1, 2 or 3).
Graphics – switches to image viewing. See the list of supported image formats at the beginning of the page.
Plugins – Viewing with WLX plugins. If the selected file can be opened by several installed plugins, then repeated calls of this command will switch them in a circle.
Office XML (text only)(Alpha version) – The viewer will show text from XML-based office documents: Microsoft Office (DOCX, XLSX) and OpenOffice/LibreOffice (ODT, ODS). Without text formatting, but preserving paragraphs.
Plugins have priority over the Graphics mode.
+Plugins have priority over the Graphics and Office XML (text only) modes.
+Wrap text(Alpha version) – enables or disables wrapping lines that do not fit in the window (by word boundaries).
Show text cursor – enables the display of a blinking text cursor.
@@ -130,6 +133,7 @@Stretch – resizes the image so it fills the viewer window (the aspect ratio will be saved automatically).
Stretch only large – resizes the image only if it is larger than the current window size (the aspect ratio will be saved automatically).
Center – The image will be displayed in the center of the viewer window instead of the upper left corner.
+Show transparency(Alpha version) – enables the use of a checkerboard pattern as a background for transparent parts of the image.
The Rotate submenu includes several similar actions:
The first three commands rotate the image by a specified number of degrees around its center: + 90 (90 degrees to the right), + 180 and - 90 (90 degrees to the left).
Width – Menu for selecting the line width (from 1 to 25 pixels).
Color – allows to set the color of the line.
Full Screen – switches the window to full-screen mode (the contents of the window without the operating system's typical window-framing interface) and back. This mode is available not only when viewing images, just use hotkeys (Alt+Enter by default).
Resize – The image resizing tool allows to specify the width and height in pixels (the aspect ratio will be saved automatically).
+Full Screen – switches the window to full-screen mode (the contents of the window without the operating system's typical window-framing interface) and back. This mode is available not only when viewing images, just use hotkeys (Alt+Enter by default).
When the window is expanded to full screen, an additional Slide Show button will become available: we can enable automatic loading the next image in the current directory and set the file display time (from 1 to 25 seconds).
diff --git a/doc/ru/cm_options.html b/doc/ru/cm_options.html index a999634c..6f3b8960 100644 --- a/doc/ru/cm_options.html +++ b/doc/ru/cm_options.html @@ -225,6 +225,10 @@Параметр | +Значение | +Описание | +
---|---|---|
filename | +имя файла | +полный путь к файлу со списком | +
side | +left | +загрузить список в левую панель | +
right | +загрузить список в правую панель | +|
active | +загрузить список в активную панель | +|
inactive | +загрузить список в неактивную панель | +|
(пусто) | +загрузить список в текущую активную панель | +|
(отсутствует) | +загрузить список в текущую активную панель | +
Основными файлами являются:
doublecmd.xml – все главные настройки программы;
doublecmd.cfg(Альфа-версия) – настройки, которые применяются до инициализации всех компонентов программы и загрузки doublecmd.xml;
extassoc.xml – настройки файловых ассоциаций;
pixmaps.txt – сопоставляет расширения файлов с именами значков MIME-типов;
multiarc.ini – внешние архиваторы;
Первая группа параметров позволяет указать внешнюю программу для редактирования текстовых файлов. Double Commander будет автоматически добавлять полное имя файла как последний параметр запуска при каждом вызове редактора.
Дополнительно: Запускать в терминале и Не закрывать окно терминала после запуска программы могут быть полезны, если вы используете консольную программу и/или терминальный вывод программы имеет значение (или просто временно для отладки).
Опции встроенного редактора:
@@ -196,6 +197,7 @@Tab меняет отступ блоков – Нажатия клавиш Tab и Shift+Tab соответственно увеличивают и уменьшают отступ выделенного текста.
"Умные" табуляции – Нажатия клавиши Tab будут перемещать каретку к позиции под следующим непробельным символом предыдущей строки.
Ширина табуляции – Ширина символа табуляции (в количестве символов). Если включено Использовать пробелы вместо символов табуляции, то клавиша Tab будет вставлять указанное количество символов пробела. Эта настройка не применяется, если включена опция "Умные" табуляции.
+Отступ блока(Альфа-версия) – задаёт количество символов, на которое будет увеличиваться или уменьшаться отступ при использовании соответствующих команд.
Правая граница – Маркер длины строк, тонкая вертикальная линия в заданной позиции: строки не будут обрезаться с принудительным переносом на новую строку, это просто визуальная подсказка. Полезно в случаях, когда существует рекомендация ограничить длину строк (например, 80 или 120 символов).
Вверху обычный, пропорциональный, шрифт, внизу моноширинный
2.5. Цвета(Альфа-версия)
+Тёмный режим – включает или выключает поддержку темного режима (только Windows 10 1809 и новее):
+Авто – будут использоваться системные настройки.
Включён – включить принудительно.
Отключён – отключить принудительно.
2.5.1. Цвета > Файловые панели
В этом разделе собраны настройки внешнего вида файловых панелей:
@@ -787,14 +798,15 @@В этом разделе находятся параметры, для которых не нашлось подходящего места в других разделах настроек:
- + +Показывать заставку при запуске(Альфа-версия) – Если включено, до отображения главного окна Double Commander покажет заставку, содержашую значок и версию программы, дату компиляции, а также версию Lazarus, FPC и операционной системы.
Показывать некритические сообщения об ошибках (с одной кнопкой "ОК") – если программа совершит действие или операцию с ошибкой и при этом не произойдёт никаких фатальных потерь, то будет показано окно с текстом ошибки и одной кнопкой "ОК". Иначе ошибка выводится не будет. (Например, если Double Commander не может установить какое-либо свойство или атрибут файла из-за ограничений файловой системы в целевом каталоге.)
При смене диска всегда переходить в корневой каталог – Если не отмечено, Double Commander будет переходить в последний открытый каталог этого диска (в этом случае вы можете перейти в корневой каталог диска, дважды нажав его кнопку).
Показывать текущий каталог в заголовке окна – Если включено, Double Commander будет отображать в заголовке окна имя текущей папки и путь активной панели.
Эскизы – Здесь вы можете включить сохранение кэша миниатюр изображений и установить их размер. Каталог для хранения кэша эскизов можно узнать в разделе Конфигурация. Double Commander использует форматы PNG или JPEG (только для *.bmp, *.jpg и *.jpeg). В качестве имени эскиза используется MD5-сумма полного имени исходного файла. В файл будут добавлены полное имя исходного файла, его размер и дата модификации.
Кнопка Удалить эскизы для отсутствующих файлов поможет удалить устаревшие эскизы.
Комментарии к файлам (descript.ion) – Здесь вы можете установить кодировку по умолчанию для файлов с комментариями (OEM, ANSI или UTF-8) и кодировку для новых файлов (UTF-8 BOM, UTF-16 LE или UTF-16 BE).
-Следующая группа параметров используется для импортирования из Total Commander и экспортирования избранных каталогов и панели инструментов: Исполняемый файл TC, Файл настроек и Каталог с панелями инструментов.
+Следующая группа параметров используется для импортирования из Total Commander и экспортирования избранных каталогов и панели инструментов: путь и имя исполняемого файла Total Commander и основного файла конфигурации, а также каталог, в котором находятся файлы панели инструментов.
{!VIEWER} – вызывает просмотрщик (встроенный или внешний, в зависимости от настроек);
{!SHELL} – запустить в терминале и оставить его открытым.
В качестве команды можно использовать внутренние команды Double Commander. Параметры внутренних команд задаются по одному на строку, поэтому здесь вы можете указать только один. Также с помощью внутренней команды cm_ExecuteScript можно запускать скрипты Lua, в этом случае вы можете получить имена выделенных файлов с помощью cm_CopyFullNamesToClip или cm_SaveSelectionToFile.
+В качестве команды можно использовать внутренние команды Double Commander. Параметры внутренних команд задаются по одному на строку, поэтому здесь вы можете указать только один. Также с помощью внутренней команды cm_ExecuteScript можно запускать скрипты Lua, в этом случае вы можете получить имена выделенных файлов с помощью cm_CopyFullNamesToClip или cm_SaveSelectionToFile.
Параметры – параметры команд, включая переменные:
все доступные в параметрах DC переменные;
<?command?> – запускает "command" в оболочке системы и подаёт вывод на команду выше.
Как минимум, вы должны указать имя файла, обычно %p
.
Путь запуска – каталог запуска команды. Этот каталог станет рабочим каталогом запускаемой программы и если у вас нет необходимости явно указать его, то просто оставьте это поле пустым: в этом случае рабочим каталогом будет текущий каталог активной файловой панели (обычные файлы) или системный каталог для временных файлов (файлы из архивов и WFX-плагинов).
-Примеры файловых ассоциаций можно посмотреть в файле doublecmd.ext.example в каталоге программы.
Все доступные действия отображаются в контекстном меню в подменю "Команды":
True
) или текст из истории поиска (False
). По умолчанию True
.True
) или выключает (False
) автоматическое копирование выделенного текста в буфер обмена. По умолчанию True
.True
) или количество файлов (False
, по умолчанию).True
, строка состояния также будет показывать количество файлов, когда курсор находится на пункте "..". Для ссылок дополнительно будут отображаться целевые объекты.ImageBackColor2
определяет цвет клеток.Проверить после завершения – Если отмечено, Double Commander будет сравнивать исходный файл и скопированный файл в целевом каталоге: побайтовое сравнение (Windows) или контрольные суммы BLAKE2 (Linux и другие). Double Commander попытается свести к минимуму эффекты дискового кэша. Недоступно в macOS(*).
Проверять свободное место – Double Commander подсчитывает размер выбранных файлов, поэтому может проверить, достаточно ли свободного места в целевом каталоге.
Резервировать место – Если отмечено, Double Commander будет использовать предварительное выделение дискового пространства, это снизит вероятность фрагментации файла. Также это более быстрый способ создания файлов. В Windows Double Commander всегда резервирует место.
Следовать ссылкам – Если отмечено, Double Commander будет считать символьные ссылки на папки обычными папками и копировать их содержимое; вместо ссылок на файл будут скопированы файлы, на которые они указывают. В третьем состоянии (квадрат залит цветом или с тире): программа будет каждый раз спрашивать, что она должна делать.
Следовать ссылкам – Если отмечено, Double Commander будет считать символьные ссылки на папки обычными папками и копировать их содержимое; вместо ссылок на файл будут скопированы файлы, на которые они указывают. Неопредёленное (третье) состояние флажка: программа будет каждый раз спрашивать, что она должна делать.
Исправлять ссылки – Если отмечено, Double Commander проверит и, если необходимо, поправит их целевой путь с учётом целевого каталога. Если задан относительный путь, то исправленный путь тоже будет записан как относительный.
Копировать атрибуты – Если отмечено, будут скопированы атрибуты исходного файла, в противном случае будут использоваться значения по умолчанию: 666 (файлы) или 777 (папки). Также смотрите описание <CopyXattributes>
здесь. Для Windows: смотрите описание <CopyAttributes>
здесь.
Сбросить флаг "Только для чтения" – Если отмечено, Double Commander будет добавлять флаг разрешения на запись "w" (Linux).
(DC поддерживает оба формата.)
Как создать или изменить:
Используйте UniHighlighter Editor или HglEditor (скачать). Обе программы были написаны для Windows, но вы можете использовать Wine. HglEditor сохранит HGL-файл в новом формате.
- Также доступны два архива с различными схемами подсветки синтаксиса.
Как добавить:
1) Портативная версия
Скопируйте (или переместите) HGL-файл(ы) в папку "highlighters" рядом с doublecmd.exe и перезапустите DC.
В: Что означает сообщение "Этот файл не является корректным плагином!"?
-О: Обычно это означает проблему с зависимостями: не все необходимые библиотеки доступны в вашей системе. Как узнать названия библиотек:
+О: Обычно это означает проблему с зависимостями: не все необходимые библиотеки доступны в вашей системе. Если в описании плагина отстутствуют подробности, не удалось связаться с автором или найти решение с помощью поисковых систем, то попробуйте следующее:
ldd pluginname | grep "not found"
ldd pluginname | grep "not found"
), GNU Binutils или плагин AnyELF.Если это WDX-плагин, написанный на Lua:
1. Недоступна библиотека Lua: смотрите Необходимая DLL.
diff --git a/doc/ru/help.html b/doc/ru/help.html index 774b12e1..10b0e915 100644 --- a/doc/ru/help.html +++ b/doc/ru/help.html @@ -90,11 +90,11 @@Для Linux существуют версии с использованием библиотек GTK и Qt. Также доступна портативная версия (скомпилированные двоичные файлы, упакованные XZ, для запуска используйте doublecmd.sh).
Примечание: Особенности обновления портативной версии описаны в FAQ.
При первом запуске Double Commander автоматически определит системный язык и установит его для интерфейса. DC переведён на многие языки. Язык можно изменить в Настройки > Параметры... > Язык.
-Double Commander определяет и использует текущую системную тему. Выглядит это так (Ubuntu, две темы и два набора значков):
- -На изображении видны левая файловая панель, командная строка и ниже окно протокола (оно показывает все действия файлового менеджера).
+Double Commander определяет и использует текущую системную тему. Выглядит это так (Ubuntu, три темы и два набора значков):
+ +На изображении видны левая файловая панель, командная строка и ниже окно протокола (оно показывает все действия файлового менеджера). Double Commander также поддерживает тёмный режим в Windows (Windows 10 1809 и новее).(Альфа-версия)
Double Commander использует API плагинов Total Commander, так что под Windows вы можете использовать плагины для Total Commander (многие из них совместимы с DC). Описание типов плагинов смотрите в разделе настроек Плагины.
-DC поставляется с несколькими предустановленными плагинами: несколько архиваторных плагинов (WCX) для работы с архивами как с каталогами (виртуальная файловая система, VFS), плагин файловых систем (WFX) для доступа к FTP, несколько информационных плагинов (WDX). В программу встроен информационный плагин Exif для получения некоторых данных, которые могут храниться в метаданных файлов JPEG: дата, размеры в пикселях, ориентация изображения и информация о камере. В Linux-версии добавлены WFX-плагин для доступа к сетевым дискам (SMB/CIFS), плагин поиска (DSX) и плагин просмотрщика (WLX) для видео. Версия для Windows включает в себя два WLX-плагина: Windows Media Player и плагин предпросмотра Проводником. Другие плагины могут быть установлены вручную.
+DC поставляется с несколькими предустановленными плагинами: несколько архиваторных плагинов (WCX) для работы с архивами как с каталогами (виртуальная файловая система, VFS), плагин файловых систем (WFX) для доступа к FTP, несколько информационных плагинов (WDX). В программу встроен информационный плагин Exif для получения некоторых данных, которые могут храниться в метаданных файлов JPEG: дата, размеры в пикселях, ориентация изображения и информация о камере. В Linux-версии добавлены WFX-плагин для доступа к сетевым дискам (SMB/CIFS), плагин поиска (DSX) и плагин просмотрщика (WLX) для видео. Версия для Windows включает в себя три WLX-плагина: Windows Media Player, предпросмотр Проводником и плагин для просмотра RTF(Альфа-версия). Версия для macOS(*) включает в себя универсальный WLX-плагин MacPreview.(Альфа-версия) Другие плагины могут быть установлены вручную.
Создать жёсткую ссылку... (команда cm_HardLink). Аналогично предыдущему пункту, только ссылка будет жёсткая и использование относительного пути будет недоступно.
-Создать каталог (команда cm_MakeDir) – создаёт новый подкаталог в текущем каталоге. Будет предложено имя файла (без расширения) или имя каталога под курсором, это удобно для создания нескольких каталогов с похожими именами. Также можно создавать несколько подкаталогов за одну операцию, просто отделите подкаталоги разделителем каталогов (в системах Unix/Linux это будет "/" и "\" в Windows), например, каталог1\каталог2\каталог3
.
Создать каталог (команда cm_MakeDir) – создаёт новый подкаталог в текущем каталоге. Будет предложено имя файла (без расширения) или имя каталога под курсором, это удобно для создания нескольких каталогов с похожими именами. Также можно создавать несколько подкаталогов за одну операцию, просто отделите подкаталоги разделителем каталогов (в системах Unix/Linux это будет "/" и "\" в Windows).
+ +Если включен Расширенный синтаксис(Альфа-версия), для вставки текущей даты/времени может быть использован шаблон <[]
, внутри квадратных скобок можно использовать символы форматирования даты и времени, а также любые символы, допустимые для имён файлов.
Создать ярлык (только Windows) – Double Commander создаст ярлык Microsoft Windows (LNK-файл) на файл под курсором в папке, открытой в противоположной панели.
@@ -174,7 +176,7 @@В поле Распаковать файлы по маске можно указать маску, определяющую, какие файлы будут распакованы. История масок доступна в выпадающем списке. В следующей строке указывается каталог назначения (то есть куда будет распакован архив). Его можно сменить вручную или нажав на кнопку обзора справа.
-Распаковать каждый архив в отдельный каталог (с именем архива) – Если отмечено, Double Commander создаст в каталоге назначения папку с именем архива и извлечёт файлы в эту папку. С помощью этой опции вы можете распаковать сразу несколько архивов и каждый будет распакован в свою папку в целевом каталоге. По умолчанию не отмечено и не сохраняется для следующего вызова команды извлечения.
+Распаковать каждый архив в отдельный каталог (с именем архива) – Если отмечено, Double Commander создаст в каталоге назначения папку с именем архива и извлечёт файлы в эту папку. С помощью этой опции вы можете распаковать сразу несколько архивов и каждый будет распакован в свою папку в целевом каталоге. Неопредёленное (третье) состояние флажка включает "умную" распаковку(Альфа-версия): если в корне архива несколько объектов, то содержимое архива будет распаковано в папку с именем архива, но если один объект, то содержимое будет распаковано как есть. По умолчанию не отмечено и состояние не сохраняется для следующего вызова команды извлечения.
Учитывать подкаталоги – Если отмечено, структура каталогов в архиве будет сохранена. В противном случае все файлы будут извлечены без воссоздания структуры каталогов.
Флажок Заменять существующие файлы запрещает подтверждение перезаписи файлов.
@@ -399,7 +401,7 @@Показывает вкладки, для перехода между ними можно использовать щелчок левой кнопки мыши или горячие клавиши (по умолчанию Ctrl+Tab и Ctrl+Shift+Tab). Чтобы изменить порядок вкладок, используйте перетаскивание мышью.
+Показывает вкладки, для перехода между ними можно использовать щелчок левой кнопки мыши или горячие клавиши (по умолчанию Ctrl+Tab и Ctrl+Shift+Tab). Чтобы изменить порядок вкладок, используйте перетаскивание мышью или команды cm_MoveTabLeft и cm_MoveTabRight(Альфа-версия).
Вы можете защитить вкладки от закрытия или изменения каталога, доступные состояния вкладок описаны в подразделе "Вкладки". Заблокированные вкладки отмечаются звёздочкой (если включена опция Отмечать заблокированные вкладки звёздочкой *).
Value = os.getenv(VariableName)
Получить в Value значение переменной окружения VariableName.
Если переменная не существует, то функция вернёт nil
.
os.setenv(VariableName, Value)
+Добавить или изменить переменную окружения VariableName. В случае ошибки функция возвращает -1.
os.unsetenv(VariableName)
+Удалить переменную окружения VariableName. В случае ошибки функция возвращает -1.