Skip to content

Commit

Permalink
UPD: toolbar.html: Separator styles.
Browse files Browse the repository at this point in the history
Other small fixes/changes.
  • Loading branch information
Skif-off committed Dec 18, 2024
1 parent a61c4d7 commit 4bc76ac
Show file tree
Hide file tree
Showing 44 changed files with 46 additions and 32 deletions.
2 changes: 1 addition & 1 deletion doc/en/configuration.html
Original file line number Diff line number Diff line change
Expand Up @@ -982,7 +982,7 @@ <h2><a name="settings">2. Configuration</a></h2>

<p><span class="bold"><a name="ConfigTooltips">2.22. Tooltips</a></span></p>
<p>This section contains the settings for tooltips when the mouse cursor is hovering over a file.</p>
<p class="figure"><img class="largeimage" title="Tooltips" alt="Tooltips" src="images/imgDC/pic47.png" width="726" height="416"></p>
<p class="figure"><img class="largeimage" title="Tooltips" alt="Tooltips" src="images/imgDC/pic47.png" width="724" height="416"></p>
<p><span class="italic">Show tooltip for files in the file panel</span>&nbsp;&ndash; enables the ability to use tooltips.</p>
<p><span class="italic">File types</span>&nbsp;&ndash; contains a list of file groups. Double Commander checks the list from top to bottom until the first match: a file group higher in the list will overlap any file group below.</p>
<p>Buttons:</p>
Expand Down
2 changes: 1 addition & 1 deletion doc/en/copymove.html
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ <h2><a name="confirmation">1. Copy/move dialog window</a></h2>
<p><span class="italic">Ask</span> (by default) provides more possible actions (see below).</p>
<p>The next group is a filter, the ability to specify which files to copy or move (file masks, age and so on). Here we can see the selected template and:</p>
<ul>
<li><p>The <span class="italic">Choose template</span> button (<img title="Template..." alt="Template..." src="images/imgDC/btemplate.png" width="18" height="18">) opens a window with a list of saved templates and with the ability to add a new one.</p></li>
<li><p>The <span class="italic">Choose template</span> button (<img title="Template..." alt="Template..." src="images/imgDC/btemplate.png" width="16" height="16">) opens a window with a list of saved templates and with the ability to add a new one.</p></li>
<li><p><span class="italic">Exclude empty directories</span>&nbsp;&ndash; If enabled, only non-empty directories will be copied or moved. Works only with templates.</p></li>
</ul>
<p>The list of the following parameters will vary depending on the type of file operation and operating system family.</p>
Expand Down
4 changes: 2 additions & 2 deletions doc/en/help.html
Original file line number Diff line number Diff line change
Expand Up @@ -152,7 +152,7 @@ <h2><a name="mnu_file">2.1.1. "Files"</a></h2>
<p class="figure"><img class="largeimage" title="Calculate size" alt="Calculate size" src="images/imgDC/pic19.png" width="293" height="103"></p>

<p><a name="cm_CompareContents"><span class="bold">Compare by Contents</span></a> (internal command <tt>cm_CompareContents</tt>) shows a window with two panels with the files to compare (usually text).</p>
<p class="figure"><img class="largeimage" title="Compare dialog" alt="Compare dialog" src="images/imgDC/pic20.png" width="768" height="278"></p>
<p class="figure"><img class="largeimage" title="Compare dialog" alt="Compare dialog" src="images/imgDC/pic20.png" width="768" height="384"></p>
<p>It's a simple visual comparison and merging tool with a typical features: navigation between differences (next, previous, first or last), copying blocks of text from right to left and from left to right, editing files in-place, undo and redo the last changes, saving with a different name and other.</p>
<p>Options:</p>
<ul>
Expand Down Expand Up @@ -403,7 +403,7 @@ <h2><a name="mnu_help">2.1.9. "Help"</a></h2>

<div>
<h2><a name="iface_toolbar">2.2. Button toolbar</a></h2>
<p class="figure"><img class="largeimage" title="Toolbar sample" alt="Toolbar sample" src="images/imgDC/toolbarsample.png" width="713" height="39"></p>
<p class="figure"><img class="largeimage" title="Toolbar sample" alt="Toolbar sample" src="images/imgDC/toolbarsample.png" width="756" height="38"></p>
<p>The toolbar is holding buttons to execute internal command and launch our applications.</p>
<p>A default configuration is propose but we will certainly each and every one configure it to our needs since it's probably the most configurable part of Double Commander.</p>
<p>That's why a dedicated page is made just for that under <a href="toolbar.html">this link</a>.</p>
Expand Down
Binary file modified doc/en/images/imgDC/luaimg1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/luaimg3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/luaimg4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/luaimg5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/pic20.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/toolbarconfig1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/toolbarconfig3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/toolbarexternal.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/toolbarinbar.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/toolbarinternal1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/toolbarinternal2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/toolbarmenu.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/toolbarsample.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/imgDC/variablesample.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/en/images/screenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions doc/en/lua.html
Original file line number Diff line number Diff line change
Expand Up @@ -287,7 +287,7 @@ <h2><a name="exampleex">3.1.1. Example with the DC.ExecuteCommand</a></h2>

<p>Using the internal command <a href="cmds.html#cm_ExecuteScript">cm_ExecuteScript</a>, we may configure a tool bar button that will execute our script.</p>
<p>Assuming this script file is <code>E:\scripts\lua\music.lua</code>, we could have the button configured this way:</p>
<p class="figure"><img class="largeimage" title="Invoking a Lua script from toolbar" alt="Invoking a Lua script from toolbar" src="images/imgDC/luaimg1.png" width="560" height="290"></p>
<p class="figure"><img class="largeimage" title="Invoking a Lua script from toolbar" alt="Invoking a Lua script from toolbar" src="images/imgDC/luaimg1.png" width="610" height="289"></p>

<p>Also, we may use the internal Double Commander Editor for editing our scripts. If filename has <code>.lua</code> file extension, it will be recognized by internal editor and it will provide us syntax highlighting specific for this Lua language:</p>
<p class="figure"><img class="largeimage" title="Lua syntax highlighting with internal editor" alt="Lua syntax highlighting with internal editor" src="images/imgDC/luaimg2.png" width="660" height="480"></p>
Expand Down Expand Up @@ -638,7 +638,7 @@ <h2><a name="exampleattr">3.2.2. Example with SysUtils.FileGetAttr</a></h2>
<p>In the above example, the <var>params[1]</var> is the 1st parameter passed to the script.</p>
<p>When using the internal command <a href="cmds.html#cm_ExecuteScript">cm_ExecuteScript</a>, it will will be the first parameter passed after the script filename.</p>
<p>So in our example, we may program a sample toolbar button like the following:</p>
<p class="figure"><img class="largeimage" title="Parameter with cm_ExecuteScript" alt="Parameter with cm_ExecuteScript" src="images/imgDC/luaimg3.png" width="560" height="290"></p>
<p class="figure"><img class="largeimage" title="Parameter with cm_ExecuteScript" alt="Parameter with cm_ExecuteScript" src="images/imgDC/luaimg3.png" width="610" height="289"></p>
<p>In this example, the parameter <code>%"0%p</code> will be passed to the script. This will represent, unquoted, the filename of the item currently selected in the active panel at the moment we press the toolbar button.</p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
Expand Down Expand Up @@ -677,7 +677,7 @@ <h2><a name="examplefind">3.2.3. Example using FindFirst, FindNext and FindClose
<li><var>params[2]</var> - which is the outputfilename to store the result</li>
</ol>
<p>So it's easy to configure a toolbar button using the internal command <a href="cmds.html#cm_ExecuteScript">cm_ExecuteScript</a> and pass the parameter to accomplish all this.</p>
<p class="figure"><img class="largeimage" title="Parameter with cm_ExecuteScript" alt="Parameter with cm_ExecuteScript" src="images/imgDC/luaimg4.png" width="560" height="262"></p>
<p class="figure"><img class="largeimage" title="Parameter with cm_ExecuteScript" alt="Parameter with cm_ExecuteScript" src="images/imgDC/luaimg4.png" width="610" height="289"></p>
<p>In this example, the parameter <code>%"0%Ds</code> will be passed to the script as the first parameter. This will represent, unquoted, the directory displayed by the active panel.</p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
Expand Down
21 changes: 14 additions & 7 deletions doc/en/toolbar.html
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,8 @@ <h2><a name="toolbardefinition">1. What is the toolbar and how it could be used<
<p>The idea of the toolbar it to allow each one to customize buttons inside a bar for functions we need to do often.</p>
<p>Double Commander proposes also to use numerous possible parameters based on current displayed/selected files to allow us to pass them as parameters to the application to launch.</p>
<p>Here follows the default toolbar of DC shown above the file panels after a default installation. But don't worry: you may configure it the way you want to adapt to your need and your taste.</p>
<p class="figure"><img class="largeimage" title="Toolbar sample" alt="Toolbar sample" src="images/imgDC/toolbarsample.png" width="713" height="39"></p>
<p class="figure"><img class="largeimage" title="Toolbar sample" alt="Toolbar sample" src="images/imgDC/toolbarsample.png" width="756" height="38"></p>
<p>The middle toolbar is also available, it is located between the file panels. The capabilities and process of configuring the middle toolbar are similar to the main one.</p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>

Expand Down Expand Up @@ -99,8 +100,14 @@ <h2><a name="toolbarconfig">4. How to configure the toolbar</a></h2>

<div>
<h2><a name="catseparator">5.1. Description of elements - Separator</a></h2>
<p>The separator is simply a vertical bar that may be used to separate group of buttons to have similar related actions grouped together.</p>
<p>There have no real active functions, it's just decorative for pleasant looking.</p>
<p>The separator has no real active functions, it's just decorative for pleasant looking. Can be used to separate group of buttons to have similar related actions grouped together.</p>
<p>The following styles are available:</p>
<ul>
<li><p><span class="italic">Separator</span>&nbsp;&ndash; is simply a vertical bar (horizontal in the middle toolbar).</p></li>
<li><p><span class="italic">Space</span>&nbsp;&ndash; adds an empty space, its width corresponds to the size of the button.</p></li>
<li><p><span class="italic">Line break</span>&nbsp;&ndash; all subsequent buttons will be located on a new line of the toolbar.<span class="versionref"><sup>(Alpha version)</sup></span></p></li>
</ul>
<p>The menu will use the first one regardless of the style selected.</p>
<p>In the following example, the person used separator to isolate together functions related with comparisons, then the ones related with clipboard, etc.</p>
<p class="figure"><img class="largeimage" title="Example of separator" alt="Example of separator" src="images/imgDC/toolbarseparator.png" width="420" height="192"></p>
</div>
Expand All @@ -114,10 +121,10 @@ <h2><a name="catinternal">5.2. Description of elements - Internal Command</a></h
<p>As we see in the following image, we may select a custom icon for it but generally just choosing the command from the drop box of command is enough and command already have an internal associated icon.</p>
<p>The tooltip is also there to allow us to write an easy to remember little words to remember us the task of the button as we move cursor over.</p>
<p>Here is an example with that <a href="cmds.html#cm_Search">cm_Search</a> command:</p>
<p class="figure"><img class="largeimage" title="Example of internal command with no parameter" alt="Example of internal command with no parameter" src="images/imgDC/toolbarinternal1.png" width="611" height="186"></p>
<p class="figure"><img class="largeimage" title="Example of internal command with no parameter" alt="Example of internal command with no parameter" src="images/imgDC/toolbarinternal1.png" width="610" height="289"></p>
<p>Some internal commands might accept parameters to configure their actions. When this is required, we'll simply write the parameter for in the parameter box: most parameters must be added as <i>parameter=value</i> (unless otherwise stated), each must be in a separate line, without quotes and other ways of escaping special characters and spaces.</p>
<p>In the following example, we use the internal command <a href="cmds.html#cm_ChangeDir">cm_ChangeDir</a> and we're providing two parameters to indicate which directory to load and show in each panel.</p>
<p class="figure"><img class="largeimage" title="Example of internal command with parameters" alt="Example of internal command with parameters" src="images/imgDC/toolbarinternal2.png" width="611" height="210"></p>
<p class="figure"><img class="largeimage" title="Example of internal command with parameters" alt="Example of internal command with parameters" src="images/imgDC/toolbarinternal2.png" width="610" height="210"></p>
</div>
<br>

Expand All @@ -128,7 +135,7 @@ <h2><a name="catexternal">5.3. Description of elements - External Command</a></h
<p>The "Command" field is for the executable file only (as is, without quotes): we can specify the file name or the file name with the full path, we can also use <a href="variables.html#envvariables">environment variables</a>.</p>
<p>Regarding the parameters, we may select user variables that will be substituted by their actual value based on the current selected file of the active panel and so on. See the dedicated page of the possible variable to use as parameter under <a href="variables.html">this link</a> (please note the use of <a href="variables.html#quotation">quotation marks</a>). To run a command in the terminal, we can use the variables <a href="variables.html#executeterm">%t0 and %t1</a>.</p>
<p>In the following example, we've set a toolbar button to launch the application GIMP and the <code>%p</code> as parameter means that when we click the button to launch GIMP, the complete filename of the current selected file in the active panel will be passed as parameter, since that's what <code>%p</code> stands for.</p>
<p class="figure"><img class="largeimage" title="Example of external command" alt="Example of external command" src="images/imgDC/toolbarexternal.png" width="611" height="230"></p>
<p class="figure"><img class="largeimage" title="Example of external command" alt="Example of external command" src="images/imgDC/toolbarexternal.png" width="610" height="229"></p>
<p>If we do not need to explicitly specify the working directory, then we can leave the "Start Path" field empty, in this case, the working directory will be the current directory of the active file panel.</p>
</div>
<br>
Expand All @@ -141,7 +148,7 @@ <h2><a name="catmenu">5.4. Description of elements - Menu</a></h2>
<p>This will make appear a new sub toolbar below that we can populate as we needed with new toolbar buttons pointing to different tasks.</p>
<p>This example also shows us that it could help to group together buttons related to the same projects, the same areas.</p>
<p>In this example the sub toolbar has functions related with different type of OS's installed in virtual machines.</p>
<p class="figure"><img class="largeimage" title="Example of menu" alt="Example of menu" src="images/imgDC/toolbarmenu.png" width="624" height="319"></p>
<p class="figure"><img class="largeimage" title="Example of menu" alt="Example of menu" src="images/imgDC/toolbarmenu.png" width="610" height="318"></p>
<p>Below is displayed how the configured sub toolbar will appear in the application:</p>
<p class="figure"><img class="largeimage" title="Example of drop menu" alt="Example of drop menu" src="images/imgDC/toolbarmenudrop.png" width="250" height="342"></p>
<p>The sub toolbar configured this way may contains the same type of button type presented before.</p>
Expand Down
2 changes: 1 addition & 1 deletion doc/en/variables.html
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ <h2><a name="quickpres">1. Quick presentation</a></h2>
<p>Variable will help us to when configurating <a href="toolbar.html">toolbar buttons</a> or setting <a href="configuration.html#ConfigAssociations">file association</a> actions and <a href="configuration.html#ConfigHotKeys">hotkey</a> actions.</p>
<p>We will basically use them when it's time to provide a parameter to command based on the current selected file(s), directory where we are and other things like that related with the context of what we're displaying in the panels.</p>
<p>Here is an easy example. The person configured a button to launch IrfanView with the variable <code>%p</code> has the parameter.</p>
<p class="image"><img title="Example of variable" alt="Example of variable" src="images/imgDC/variablesample.png" width="560" height="201"></p>
<p class="image"><img title="Example of variable" alt="Example of variable" src="images/imgDC/variablesample.png" width="610" height="229"></p>
<p>When the person will click that button, it will launch IrfanView with the variable <code>%p</code> be substituted by the current selected file in the active panel.</p>
<p>That's what <b>variables</b> described in this page are all about.</p>
<p>As you will see, most of them are beginning with the percent sign <code>%</code>.</p>
Expand Down
Loading

0 comments on commit 4bc76ac

Please sign in to comment.