Skip to content

Commit

Permalink
ADD: multiarc.html: Opening an archive in an associated application (…
Browse files Browse the repository at this point in the history 
…flag 256 and an alternative solution for external archivers). (#50)

UPD: faq.html: 7.1.
UPD: variables.html: Summary table of all variables.
CHG: doublecmd.css: Style for the DC version label.
Other small fixes/changes.

alpha: ADD: cmds.html: cm_CopyNetNamesToClip, cm_LoadList, cm_MoveTabLeft, cm_MoveTabRight.
alpha: ADD: configuration.html: Configuration files: doublecmd.cfg.
alpha: ADD: configuration.html: Section 'Colors': 'Dark mode'.
alpha: ADD: configuration.html: Section 'Miscellaneous': 'Show splash screen'.
alpha: ADD: configuration.html: Section 'Tools/Editor': 'Block indent'.
alpha: ADD: configxml.html: AutoCopy, FindWordAtCursor, ImageBackColor1, ImageBackColor2, LongInStatus.
alpha: ADD: faq.html: 5.8: Using 'Tools > Editor > Highlighters'.
alpha: ADD: help.html: List of pre-installed plugins: MacPreview (macOS), RTF view (Windows).
alpha: ADD: help.html: Note about dark mode (Win10+).
alpha: ADD: help.html: cm_MakeDir: Extended syntax.
alpha: ADD: help.html: cm_ExtractFiles: Smart extract.
alpha: ADD: lua.html: os.setenv(), os.unsetenv().
alpha: ADD: multiarc.html: Add base64.wcx to the list of default plugins.
alpha: ADD: multirename.html: Find and replace: 'Case sensitive' and 'Replace only once per file'.
alpha: ADD: multirename.html: List of files: Load names from clipboard.
alpha: ADD: viewer.html: Note about SVG support, WIC; items 'Office XML (text only)', 'Wrap text' and 'Show transparency'. DEL: 'Show as Wrap text'.
alpha: UPD: cm_options.html: List of parameters.
  • Loading branch information
@Skif-off
Skif-off authored Dec 20, 2022
1 parent 7d1f304 commit 3db77e9
Show file tree
Hide file tree
Showing 48 changed files with 368 additions and 70 deletions.
4 changes: 4 additions & 0 deletions doc/en/cm_options.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,10 @@ <h1>Parameters of internal command <a href="cmds.html#cm_Options">cm_Options</a>
<td class="varcell"><div class="firstcolumnaleft">TOptionsColorsGroup</div></td>
<td class="hintcell">Colors</td>
</tr>
<tr>
<td class="varcell"><div class="firstcolumnaleft">TfrmOptionsColors<span class="versionref"><sup>(Alpha version)</sup></span></div></td>
<td class="hintcell">Colors (Windows 10 1809 and newer)</td>
</tr>
<tr>
<td class="varcell"><div class="firstcolumnaleft">TfrmOptionsFilePanelsColors</div></td>
<td class="hintcell">Colors&nbsp;&gt; File panels</td>
Expand Down
61 changes: 60 additions & 1 deletion doc/en/cmds.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1036,6 +1036,11 @@ <h2><a name="catnetwork">2.6. Network</a></h2>
<div class="cmdname"><a name="cm_NetworkDisconnect">cm_NetworkDisconnect</a></div></td>
<td class="cmdhintcell">Nothing for the moment, but might be used in the future with network related stuff.</td>
</tr>
<tr>
<td class="cmdcell"><img class="IntCmdImage" title="cm_CopyNetNamesToClip" alt="cm_CopyNetNamesToClip" src="../../pixmaps/dctheme/32x32/actions/cm_copynetnamestoclip.png">
<div class="cmdname"><a name="cm_CopyNetNamesToClip">cm_CopyNetNamesToClip</a><span class="versionref"><sup>(Alpha version)</sup></span></div></td>
<td class="cmdhintcell">Windows only: copy names with UNC path.</td>
</tr>
</table>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
Expand Down Expand Up @@ -1095,6 +1100,50 @@ <h2><a name="catmiscellaneous">2.7. Miscellaneous</a></h2>
</table>
</td>
</tr>
<tr>
<td class="cmdcell"><img class="IntCmdImage" title="cm_LoadList" alt="cm_LoadList" src="../../pixmaps/dctheme/32x32/actions/cm_loadlist.png">
<div class="cmdname"><a name="cm_LoadList">cm_LoadList</a><span class="versionref"><sup>(Alpha version)</sup></span></div></td>
<td class="cmdhintcell">Load list of files/folders from the specified text file.<br>
<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Parameter</th>
<th class="innerdescheader">Value</th>
<th class="innerdescheader">Description</th>
</tr>
<tr>
<td class="innerdescparamcell">filename</td>
<td class="innerdescvaluecell">file name</td>
<td class="innerdescdesccell">full path to file with list</td>
</tr>
<tr>
<td class="innerdescparamcell" rowspan="6">side</td>
<td class="innerdescvaluecell">left</td>
<td class="innerdescdesccell">load list into left panel</td>
</tr>
<tr>
<td class="innerdescvaluecell">right</td>
<td class="innerdescdesccell">load list into right panel</td>
</tr>
<tr>
<td class="innerdescvaluecell">active</td>
<td class="innerdescdesccell">load list into active panel</td>
</tr>
<tr>
<td class="innerdescvaluecell">inactive</td>
<td class="innerdescdesccell">load list into inactive panel</td>
</tr>
<tr>
<td class="innerdescvaluecell"><i>(nothing)</i></td>
<td class="innerdescdesccell">load list into active panel</td>
</tr>
<tr>
<td class="innerdescvaluecell"><i>(absent)</i></td>
<td class="innerdescdesccell">load list into active panel</td>
</tr>
</table>
</td>
</tr>
</table>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
Expand Down Expand Up @@ -1597,7 +1646,7 @@ <h2><a name="catnavigation">2.10. Navigation</a></h2>
<tr>
<td class="cmdcell"><img class="IntCmdImage" title="cm_EditPath" alt="cm_EditPath" src="../../pixmaps/dctheme/32x32/actions/cm_editpath.png">
<div class="cmdname"><a name="cm_EditPath">cm_EditPath</a></div></td>
<td class="cmdhintcell">User may type directly the directory he wants see in the selected panel. Also see <kbd>Shift+F6</kbd> <a href="shortcuts.html#main_window">here</a>.</td>
<td class="cmdhintcell">User may type directly the directory he wants see in the selected panel. Also see <kbd>F2</kbd> and <kbd>Shift+F6</kbd> <a href="shortcuts.html#main_window">here</a>.</td>
</tr>
<tr>
<td class="cmdcell"><img class="IntCmdImage" title="cm_ChangeDir" alt="cm_ChangeDir" src="../../pixmaps/dctheme/32x32/actions/cm_changedir.png">
Expand Down Expand Up @@ -2424,6 +2473,16 @@ <h2><a name="cattabs">2.16. Tabs</a></h2>
<div class="shrtctkey">Ctrl+Shift+Tab</div></td>
<td class="cmdhintcell">Change to <a href="help.html#cm_PrevTab">previous tab</a>.</td>
</tr>
<tr>
<td class="cmdcell"><img class="IntCmdImage" title="cm_MoveTabLeft" alt="cm_MoveTabLeft" src="../../pixmaps/dctheme/32x32/actions/cm_movetableft.png">
<div class="cmdname"><a name="cm_MoveTabLeft">cm_MoveTabLeft</a><span class="versionref"><sup>(Alpha version)</sup></span></div></td>
<td class="cmdhintcell">Move current tab to the left.</td>
</tr>
<tr>
<td class="cmdcell"><img class="IntCmdImage" title="cm_MoveTabRight" alt="cm_MoveTabRight" src="../../pixmaps/dctheme/32x32/actions/cm_movetabright.png">
<div class="cmdname"><a name="cm_MoveTabRight">cm_MoveTabRight</a><span class="versionref"><sup>(Alpha version)</sup></span></div></td>
<td class="cmdhintcell">Move current tab to the right.</td>
</tr>
<tr>
<td class="cmdcell"><img class="IntCmdImage" title="cm_RenameTab" alt="cm_RenameTab" src="../../pixmaps/dctheme/32x32/actions/cm_renametab.png">
<div class="cmdname"><a name="cm_RenameTab">cm_RenameTab</a></div></td>
Expand Down
21 changes: 16 additions & 5 deletions doc/en/configuration.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ <h2>Content</h2>
</dl>
</dd>
<dt>2.4. <a href="#ConfigFonts">Fonts</a></dt>
<dt>2.5. Colors:</dt>
<dt>2.5. <a href="#ConfigColor">Colors</a></dt>
<dd>
<dl>
<dt>2.5.1. <a href="#ConfigColorPanels">File panels</a></dt>
Expand Down Expand Up @@ -137,6 +137,7 @@ <h2><a name="config_files">1. Configuration files</a></h2>
<p>The main files are:</p>
<ul>
<li><p><tt>doublecmd.xml</tt>&nbsp;&ndash; all the main program settings;</p></li>
<li><p><tt>doublecmd.cfg</tt><span class="versionref"><sup>(Alpha version)</sup></span>&nbsp;&ndash; settings that are applied before initialization of all program components and loading <tt>doublecmd.xml</tt>;</p></li>
<li><p><tt>extassoc.xml</tt>&nbsp;&ndash; file extension association configuration;</p></li>
<li><p><tt>pixmaps.txt</tt>&nbsp;&ndash; maps file extensions to MIME-types icon names;</p></li>
<li><p><tt>multiarc.ini</tt>&nbsp;&ndash; external archivers;</p></li>
Expand Down Expand Up @@ -196,6 +197,7 @@ <h2><a name="settings">2. Configuration</a></h2>
<p><span class="italic">Tab indents blocks</span>&nbsp;&ndash; If enabled, <kbd>Tab</kbd> and <kbd>Shift+Tab</kbd> act as block indent, unindent when text is selected.</p>
<p><span class="italic">Smart Tabs</span>&nbsp;&ndash; When the <kbd>Tab</kbd> key is used, caret will go to the next non-space character of the previous line.</p>
<p><span class="italic">Tab width</span>&nbsp;&ndash; The width of the tab character (in number of characters). If <span class="italic">Use spaces instead tab characters</span> is enabled, then the <kbd>Tab</kbd> key will insert the specified number of space characters. This setting does not apply if the <span class="italic">Smart Tabs</span> option is enable.</p>
<p><span class="italic">Block indent</span><span class="versionref"><sup>(Alpha version)</sup></span>&nbsp;&ndash; sets the number of characters by which the indent will increase or decrease when using the corresponding commands.</p>
<p><span class="italic">Right margin</span>&nbsp;&ndash; 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).</p>
<br>

Expand Down Expand Up @@ -258,6 +260,15 @@ <h2><a name="settings">2. Configuration</a></h2>
<p>Normal (proportional) font above, monospaced below.</p>
<br>

<p><span class="bold"><a name="ConfigColor">2.5. Colors</a></span><span class="versionref"><sup>(Alpha version)</sup></span></p>
<p><span class="italic">Dark mode</span>&nbsp;&ndash; enables or disables dark mode support (only Windows 10 1809 and newer):</p>
<ul>
<li><p><span class="italic">Auto</span>&nbsp;&ndash; system settings will be used.</p></li>
<li><p><span class="italic">Enabled</span>&nbsp;&ndash; enable forcibly.</p></li>
<li><p><span class="italic">Disabled</span>&nbsp;&ndash; disable forcibly.</p></li>
</ul>
<br>

<p><span class="bold"><a name="ConfigColorPanels">2.5.1. Colors&nbsp;&gt; File panels</a></span></p>
<p>This section contains settings for the appearance of file panels:</p>
<p class="figure"><img class="largeimage" title="Color settings" alt="Color settings" src="images/imgDC/pic30.png" width="804" height="459"></p>
Expand Down Expand Up @@ -787,14 +798,15 @@ <h2><a name="settings">2. Configuration</a></h2>

<p><span class="bold"><a name="ConfigMisc">2.17. Miscellaneous</a></span></p>
<p>This section contains parameters for which there was no suitable place in other sections of the settings:</p>
<p class="figure"><img class="largeimage" title="Miscellaneous" alt="Miscellaneous" src="images/imgDC/pic46.png" width="542" height="483"></p>
<p class="figure"><img class="largeimage" title="Miscellaneous" alt="Miscellaneous" src="images/imgDC/pic46.png" width="542" height="487"></p>
<p><span class="italic">Show splash screen</span><span class="versionref"><sup>(Alpha version)</sup></span>&nbsp;&ndash; 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.</p>
<p><span class="italic">Show warning messages ("OK" button only)</span>&nbsp;&ndash; 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.)</p>
<p><span class="italic">Always go to the root of a drive when changing drives</span>&nbsp;&ndash; 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).</p>
<p><span class="italic">Show current directory in the main window title bar</span>&nbsp;&ndash; If enabled, Double Commander will display the name of the current folder and the active panel path in the main window title bar.</p>
<p><span class="italic">Thumbnails</span>&nbsp;&ndash; Here you can enable to save cache of thumbnails of images and set their size. The thumbnail cache directory can be found in the <a href="#ConfigDC">Configuration</a> 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.</p>
<p>The <span class="italic">Remove thumbnails for no longer existing files</span> button will help to remove obsolete thumbnails.</p>
<p><span class="italic">File comments (descript.ion)</span>&nbsp;&ndash; 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).</p>
<p>The next group of parameters is used for import from Total Commander and export <a href="directoryhotlist.html#exportimporttc">Directory Hotlist</a> and <a href="toolbar.html">toolbar</a>: <span class="italic">TC executable</span>, <span class="italic">Configuration file</span> and <span class="italic">Toolbar output path</span> </p>
<p>The next group of parameters is used for import from Total Commander and export <a href="directoryhotlist.html#exportimporttc">Directory Hotlist</a> and <a href="toolbar.html">toolbar</a>: 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.</p>
<br>

<p><span class="bold"><a name="ConfigRefresh">2.18. Auto refresh</a></span></p>
Expand Down Expand Up @@ -929,15 +941,14 @@ <h2><a name="settings">2. Configuration</a></h2>
<li><p><tt>{!VIEWER}</tt>&nbsp;&ndash; call viewer (internal or external, depends on the configuration);</p></li>
<li><p><tt>{!SHELL}</tt>&nbsp;&ndash; run in terminal and stay open at the end.</p></li>
</ul>
<p>As a command, you can use the <a href="cmds.html">internal commands</a> 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 <a href="lua.html">Lua scripts</a>, in this case you can get the names of the selected files using <a href="cmds.html#cm_CopyFullNamesToClip">cm_CopyFullNamesToClip</a> or <a href="cmds.html#cm_SaveSelectionToFile">cm_SaveSelectionToFile</a>.</p>
<p>As a command, you can use the <a href="cmds.html">internal commands</a> 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 <a href="cmds.html#cm_ExecuteScript">cm_ExecuteScript</a>, you can run <a href="lua.html">Lua scripts</a>, in this case you can get the names of the selected files using <a href="cmds.html#cm_CopyFullNamesToClip">cm_CopyFullNamesToClip</a> or <a href="cmds.html#cm_SaveSelectionToFile">cm_SaveSelectionToFile</a>.</p>
<p><span class="italic">Parameters</span>&nbsp;&ndash; command parameters including variables:</p>
<ul>
<li><p>any variable from <a href="variables.html">"percent" variables</a>.</p></li>
<li><p><tt>&lt;?command?&gt;</tt>&nbsp;&ndash; runs "command" in the system shell and feeds the output to the command above.</p></li>
</ul>
<p>At a minimum, you must specify a file name, usually <code>%p</code>.</p>
<p><span class="italic">Start path</span>&nbsp;&ndash; 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).</p>
<p>An association sets example, called <tt>doublecmd.ext.example</tt>, is in the program directory.</p>
<p>All available actions will be displayed in the "Actions" submenu in the context menu:</p>
<p class="figure"><img class="largeimage" title="Context menu" alt="Context menu" src="images/imgDC/pic49.png" width="460" height="288"></p>
<br>
Expand Down
29 changes: 29 additions & 0 deletions doc/en/configxml.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -171,6 +171,11 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
<td class="hintcell">For the internal Differ tool, set the color for differing characters in binary mode.</td>
</tr>

<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;FindWordAtCursor&gt;<span class="versionref"><sup>(Alpha version)</sup></span><br><small>from &lt;Editor&gt;</small></div></td>
<td class="hintcell">Internal editor and differ tool: if nothing is selected, the search and replace dialog will use the word under the cursor (<code>True</code>) or text from the search history (<code>False</code>). <code>True</code> by default.</td>
</tr>

<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;AutoExtractOpenMask&gt;<br><small>from &lt;FileOperations&gt;</small></div></td>
<td class="hintcell">
Expand Down Expand Up @@ -237,6 +242,11 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
</td>
</tr>

<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;AutoCopy&gt;<span class="versionref"><sup>(Alpha version)</sup></span><br><small>from &lt;Viewer&gt;</small></div></td>
<td class="hintcell">For the internal viewer, enables (<code>True</code>) or disables automatic copying of the selected text to the clipboard. <code>True</code> by default.</td>
</tr>

<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;ExtraLineSpan&gt;<br><small>from &lt;FilesViews&gt;</small></div></td>
<td class="hintcell">
Expand All @@ -261,6 +271,12 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
</td>
</tr>

<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;LongInStatus&gt;<span class="versionref"><sup>(Alpha version)</sup></span><br><small>from &lt;FilesViews&gt;&lt;ColumnsView&gt;</small></div></td>
<td class="hintcell">If the columns view is set and there are no selected files, the status bar displays the file name under the cursor (<code>True</code>) or the number of files (<code>False</code>, by default).<br>
If <code>True</code>, 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.</td>
</tr>

<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;TitleStyle&gt;<br><small>from &lt;FilesViews&gt;&lt;ColumnsView&gt;</small></div></td>
<td class="hintcell">
Expand Down Expand Up @@ -490,6 +506,19 @@ <h2><a name="manualed">3. Options to change manually</a></h2>
</td>
</tr>

<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;ImageBackColor1&gt;<span class="versionref"><sup>(Alpha version)</sup></span><br><small>from &lt;Viewer&gt;</small></div></td>
<td class="hintcell">For the internal viewer, sets the background color of the window when viewing images.</td>
</tr>

<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;ImageBackColor2&gt;<span class="versionref"><sup>(Alpha version)</sup></span><br><small>from &lt;Viewer&gt;</small></div></td>
<td class="hintcell">
If <a href="viewer.html#mnu_image">Image&nbsp;&gt; Show transparency</a> is enabled, the internal viewer indicates transparency using a checkerboard pattern as background and <code>ImageBackColor2</code> defines the color of the squares.<br>
If not set, the viewer will automatically calculate the value: for a dark background, light squares will be used and vice versa.
</td>
</tr>

<tr>
<td class="cmdcell"><div class="firstcolumnaleft">&lt;ImageExifRotate&gt;<br><small>from &lt;Viewer&gt;</small></div></td>
<td class="hintcell">
Expand Down
Loading

0 comments on commit 3db77e9

Please sign in to comment.