Skip to content

Commit

Permalink
ADD: cmds:html: cm_View: Add the 'cursor' parameter.
Browse files Browse the repository at this point in the history
ADD: shortcuts.html: Shift+F3.
ADD: viewer.html: Shift+F3 and some details about the opening of files.
  • Loading branch information
Skif-off committed Mar 2, 2024
1 parent 2fab429 commit 3073030
Show file tree
Hide file tree
Showing 6 changed files with 51 additions and 30 deletions.
22 changes: 14 additions & 8 deletions doc/en/cmds.html
Original file line number Diff line number Diff line change
Expand Up @@ -541,36 +541,42 @@ <h2><a name="catfileoperations">2.4. File Operations</a></h2>
<div class="cmdname"><a name="cm_View">cm_View</a></div>
<div class="shrtctkey">F3</div></td>
<td class="cmdhintcell">Open file in the <a href="viewer.html">viewer program</a>.<br>
<br>
The command supports one parameter that allows to force a viewing mode (in this case, plugins will be ignored, but you can switch the mode later in the viewer window).
See the description of the modes on <a href="viewer.html#mnu_view">this page</a>.<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" rowspan="2">cursor</td>
<td class="innerdescvaluecell">1/true/on/yes</td>
<td class="innerdescdesccell">open only the file under the cursor</td>
</tr>
<tr>
<td class="innerdescvaluecell">0/false/off/no</td>
<td class="innerdescdesccell">default behavior</td>
</tr>
<tr>
<td class="innerdescparamcell" rowspan="4">mode</td>
<td class="innerdescvaluecell">text</td>
<td class="innerdescdesccell">Show as Text</td>
<td class="innerdescdesccell">show as Text</td>
</tr>
<tr>
<td class="innerdescvaluecell">bin</td>
<td class="innerdescdesccell">Show as Bin</td>
<td class="innerdescdesccell">show as Bin</td>
</tr>
<tr>
<td class="innerdescvaluecell">hex</td>
<td class="innerdescdesccell">Show as Hex</td>
<td class="innerdescdesccell">show as Hex</td>
</tr>
<tr>
<td class="innerdescvaluecell">dec</td>
<td class="innerdescdesccell">Show as Dec</td>
<td class="innerdescdesccell">show as Dec</td>
</tr>
</table>
<br>
Note: This parameter will work if there are no selected files or only one file is selected.
The "mode" parameter allows to forcibly choose the viewing mode (in this case, plugins will be ignored, but we can switch the mode later in the viewer window), but this parameter will work under one of the conditions: there are no selected files, only the file under the cursor is selected, or together with the "cursor=1" parameter. See the description of the modes on <a href="viewer.html#mnu_view">this page</a>.
</td>
</tr>
<tr>
Expand Down
14 changes: 9 additions & 5 deletions doc/en/shortcuts.html
Original file line number Diff line number Diff line change
Expand Up @@ -73,13 +73,21 @@ <h2><a name="main_window">2. Main window</a></h2>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">F3</div></td>
<td class="hintcell">1. On file: open file for view in internal viewer (multiple files are OK too)<br>
<td class="hintcell">1. On file: open file for view in <a href="viewer.html">internal viewer</a> (multiple files are OK too)<br>
2. On directory: open this directory</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">Shift+F3</div></td>
<td class="hintcell">Open only the file under the cursor in internal viewer (if more than one file is selected)</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">F4</div></td>
<td class="hintcell">Open file in editor</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">Shift+F4</div></td>
<td class="hintcell">Create a new text file and open in the internal editor or open existing file</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">F5</div></td>
<td class="hintcell">Copy items from source to target</td>
Expand Down Expand Up @@ -408,10 +416,6 @@ <h2><a name="main_window">2. Main window</a></h2>
<td class="varcell"><div class="shortcutname">Shift+F2</div></td>
<td class="hintcell">Set focus to command line</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">Shift+F4</div></td>
<td class="hintcell">Create a new text file and open in the internal editor or open existing file</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">Shift+F10</div></td>
<td class="hintcell">Show context menu for files and folders</td>
Expand Down
4 changes: 2 additions & 2 deletions doc/en/viewer.html
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ <h2><a name="intro">1. Introduction</a></h2>
<p>The built-in viewer is designed to view files of any size in text, hexadecimal or binary format and image files.</p>
<p class="figure"><img class="largeimage" title="Built-in file viewer" alt="Built-in file viewer" src="images/imgDC/viewer.png" width="792" height="432"></p>
<p>The selected text will be automatically copied to the clipboard, to disable we can use the <a href="configxml.html">&lt;AutoCopy&gt;</a> parameter.</p>
<p>By default, the viewer call is assigned to the <kbd>F3</kbd> key, we can change this in the <a href="configuration.html#ConfigHotKeys">settings</a>.</p>
<p>By default, the viewer (internal command <tt>cm_View</tt>) call is assigned to the <kbd>F3</kbd> key. If several files are selected, the first selected file will be opened and we can switch these files using the <span class="italic">Previous file</span> and <span class="italic">Next file</span> commands (otherwise, these commands will load files in the current directory). To open the file under the cursor anyway, we can use <kbd>Shift+F3</kbd>. We can change hotkeys in the <a href="configuration.html#ConfigHotKeys">Keys&nbsp;&gt; Hot Keys</a> settings section.</p>
<p>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:</p>
<ul>
<li><p>HEIF/HEIC and AVIF: <tt>libheif.dll</tt> (Windows) or <tt>libheif.so.1</tt> (Linux and other Unix-like systems).</p></li>
Expand All @@ -73,7 +73,7 @@ <h2><a name="mainmenu">2. Main menu</a></h2>

<div>
<h2><a name="mnu_file">2.1. "File"</a></h2>
<p>Items <span class="italic">Previous</span> and <span class="italic">Next</span> are used to load the previous or next file in the directory. The sort order in the file panel is used.</p>
<p>Items <span class="italic">Previous</span> and <span class="italic">Next</span> are used to load the previous or next file in the directory. If several files are selected, the commands will load these files. The sort order in the file panel is used.</p>
<p>Items <span class="italic">Save</span> and <span class="italic">Save As...</span> are available only when viewing images.</p>
<p><span class="italic">Print...</span>&nbsp;&ndash; opens a system dialog for sending a file for printing. Printing is only available when viewed with plugins that support printing files.</p>
<p><span class="italic">Print setup...</span>&nbsp;&ndash; opens a dialog for setting the print borders (left, right, top and bottom page margins).</p>
Expand Down
22 changes: 14 additions & 8 deletions doc/ru/cmds.html
Original file line number Diff line number Diff line change
Expand Up @@ -541,36 +541,42 @@ <h2><a name="catfileoperations">2.4. Файловые операции</a></h2>
<div class="cmdname"><a name="cm_View">cm_View</a></div>
<div class="shrtctkey">F3</div></td>
<td class="cmdhintcell">Открыть файл в <a href="viewer.html">программе просмотра</a>.<br>
<br>
Команда поддерживает один параметр, позволяющий принудительно выбрать режим просмотра (в этом случае плагины будут проигнорированы, но вы сможете переключить режим позже в окне программы просмотра).
Описание режимов смотрите на <a href="viewer.html#mnu_view">этой странице</a>.<br>
<br>
<table class="innercmddesc">
<tr class="rowinnerdesc">
<th class="innerdescheader">Параметр</th>
<th class="innerdescheader">Значение</th>
<th class="innerdescheader">Описание</th>
</tr>
<tr>
<td class="innerdescparamcell" rowspan="2">cursor</td>
<td class="innerdescvaluecell">1/true/on/yes</td>
<td class="innerdescdesccell">открыть только файл под курсором</td>
</tr>
<tr>
<td class="innerdescvaluecell">0/false/off/no</td>
<td class="innerdescdesccell">поведение по умолчанию</td>
</tr>
<tr>
<td class="innerdescparamcell" rowspan="4">mode</td>
<td class="innerdescvaluecell">text</td>
<td class="innerdescdesccell">Показать как текст</td>
<td class="innerdescdesccell">показать как текст</td>
</tr>
<tr>
<td class="innerdescvaluecell">bin</td>
<td class="innerdescdesccell">Показать в двоичном виде</td>
<td class="innerdescdesccell">показать в двоичном виде</td>
</tr>
<tr>
<td class="innerdescvaluecell">hex</td>
<td class="innerdescdesccell">Показать в шестнадцатеричном виде</td>
<td class="innerdescdesccell">показать в шестнадцатеричном виде</td>
</tr>
<tr>
<td class="innerdescvaluecell">dec</td>
<td class="innerdescdesccell">Показать в десятеричном виде</td>
<td class="innerdescdesccell">показать в десятеричном виде</td>
</tr>
</table>
<br>
Примечание: Этот параметр будет работать, если нет выделенных файлов или выделен только один файл.
Параметр "mode" позволяет принудительно выбрать режим просмотра (в этом случае плагины будут проигнорированы, но мы сможем переключить режим позже в окне программы просмотра), но этот параметр будет работать при одном из условий: нет выделенных файлов, выделен только файл под курсором или вместе с параметром "cursor=1". Описание режимов смотрите на <a href="viewer.html#mnu_view">этой странице</a>.
</td>
</tr>
<tr>
Expand Down
15 changes: 10 additions & 5 deletions doc/ru/shortcuts.html
Original file line number Diff line number Diff line change
Expand Up @@ -73,13 +73,22 @@ <h2><a name="main_window">2. Главное окно</a></h2>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">F3</div></td>
<td class="hintcell">1. На файле: открыть файл в просмотрщике (так же и несколько выделенных файлов)<br>
<td class="hintcell">1. На файле: открыть файл в <a href="viewer.html">просмотрщике</a> (так же и несколько выделенных файлов)<br>
2. На папке: открыть эту папку</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">Shift+F3</div></td>
<td class="hintcell">Открыть только файл под курсором в просмотрщике (если выделено более одного файла)</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">F4</div></td>
<td class="hintcell">Открыть файл под курсором в редакторе</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">Shift+F4</div></td>
<td class="hintcell">Создать новый текстовый файл и открыть его в редакторе или открыть существующий</td>
</tr>

<tr>
<td class="varcell"><div class="shortcutname">F5</div></td>
<td class="hintcell">Копировать файлы/каталоги в неактивную панель</td>
Expand Down Expand Up @@ -408,10 +417,6 @@ <h2><a name="main_window">2. Главное окно</a></h2>
<td class="varcell"><div class="shortcutname">Shift+F2</div></td>
<td class="hintcell">Установить фокус в командную строку</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">Shift+F4</div></td>
<td class="hintcell">Создать новый текстовый файл и открыть его в редакторе или открыть существующий</td>
</tr>
<tr>
<td class="varcell"><div class="shortcutname">Shift+F10</div></td>
<td class="hintcell">Показать контекстное меню файлов и папок</td>
Expand Down
4 changes: 2 additions & 2 deletions doc/ru/viewer.html
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ <h2><a name="intro">1. Введение</a></h2>
<p>Встроенный просмотрщик предназначен для просмотра файлов любого размера в текстовом, шестнадцатеричном или двоичном формате, а также файлов изображений.</p>
<p class="figure"><img class="largeimage" title="Встроенная программа просмотра файлов" alt="Встроенная программа просмотра файлов" src="images/imgDC/viewer.png" width="792" height="432"></p>
<p>Выделенный текст будет автоматически скопирован в буфер обмена, для отключения мы можем использовать параметр <a href="configxml.html">&lt;AutoCopy&gt;</a>.</p>
<p>По умолчанию вызов просмотрщика назначен на клавишу <kbd>F3</kbd>, мы можем изменить это в <a href="configuration.html#ConfigHotKeys">настройках</a>.</p>
<p>По умолчанию вызов просмотрщика (внутренняя команда <tt>cm_View</tt>) назначен на клавишу <kbd>F3</kbd>. Если выделено несколько файлов, то будет открыт первый выделенный файл и мы можем переключать эти файлы командами <span class="italic">Предыдущий файл</span> и <span class="italic">Следующий файл</span> (в противном случае эти команды будут загружать файлы в текущем каталоге). Чтобы в любом случае открыть файл под курсором, мы можем использовать <kbd>Shift+F3</kbd>. Мы можем изменить горячие клавиши в разделе настроек <a href="configuration.html#ConfigHotKeys">Клавиши&nbsp;&gt; Горячие клавиши</a>.</p>
<p>Поддерживаемые форматы изображений: BMP, CUR, GIF, ICNS, ICO, JPEG, PNG, PNM (PBM, PGM и PPM), PSD, SVG/SVGZ, TIFF, XPM. Кроме того, если необходимые библиотеки доступны:</p>
<ul>
<li><p>HEIF/HEIC и AVIF: <tt>libheif.dll</tt> (Windows) или <tt>libheif.so.1</tt> (Linux и другие Unix-подобные системы).</p></li>
Expand All @@ -73,7 +73,7 @@ <h2><a name="mainmenu">2. Главное меню</a></h2>

<div>
<h2><a name="mnu_file">2.1. "Файл"</a></h2>
<p>Пункты <span class="italic">Предыдущий</span> и <span class="italic">Следующий</span> служат для загрузки предыдущего или следующего файла в каталоге. Используется порядок сортировки в файловой панели.</p>
<p>Пункты <span class="italic">Предыдущий</span> и <span class="italic">Следующий</span> служат для загрузки предыдущего или следующего файла в каталоге. Если выделено несколько файлов, то команды будут загружать эти файлы. Используется порядок сортировки в файловой панели.</p>
<p>Пункты <span class="italic">Сохранить</span> и <span class="italic">Сохранить как...</span> доступны только при просмотре изображений.</p>
<p><span class="italic">Печать...</span>&nbsp;&ndash; открывает системный диалог отправки файла на печать. Печать доступна только при просмотре с плагинами, поддерживающими печать файлов.</p>
<p><span class="italic">Параметры печати...</span>&nbsp;&ndash; открывает диалог для настройки границ печати (левое, правое, верхнее и нижнее поля страницы).</p>
Expand Down

0 comments on commit 3073030

Please sign in to comment.