<chapter id="fundamentals"> <chapterinfo> <authorgroup> <author ><personname ><firstname ></firstname ></personname ></author> <othercredit role="translator" ><firstname >Андрей</firstname ><surname >Балагута</surname ><affiliation ><address ><email >uj2@mail.ru</email ></address ></affiliation ><contrib >Перевод на русский язык</contrib ></othercredit ><othercredit role="translator" ><firstname >Николай</firstname ><surname >Шафоростов</surname ><affiliation ><address ><email >shafff@ukr.net</email ></address ></affiliation ><contrib >Обновление перевода</contrib ></othercredit ><othercredit role="translator" ><firstname >Мария</firstname ><surname >Шикунова</surname ><affiliation ><address ><email >translation-team@basealt.ru</email ></address ></affiliation ><contrib >Обновление перевода</contrib ></othercredit ><othercredit role="translator" ><firstname >Олеся</firstname ><surname >Герасименко</surname ><affiliation ><address ><email >translation-team@basealt.ru</email ></address ></affiliation ><contrib >Редактирование перевода</contrib ></othercredit > </authorgroup> </chapterinfo> <title >Основы</title> <para >У пользователей, имеющих опыт использования текстовых редакторов, проблем с работой в &kate; возникнуть не должно. Следующие два раздела <link linkend="starting-kate " >Запуск &kate;</link > и <link linkend="working-with-kate" >Работа в &kate;</link > позволят узнать всё, что нужно для начала продуктивной работы с редактором. </para> <sect1 id="starting-kate"> <title >Запуск &kate;</title> <para >Запуск &kate; выполняется из меню запуска приложений или из командной строки. </para> <sect2 id="starting-from-the-menu"> <title >Из меню запуска</title> <para >Откройте меню программ &kde;, щёлкнув левой кнопкой мыши по значку на панели инструментов, который расположен в левом нижнем углу экрана. В появившемся <guimenu >меню запуска</guimenu > выберите пункт <menuchoice ><guimenu >Приложения</guimenu ><guisubmenu >Служебные</guisubmenu > <guimenuitem >&kate; (Улучшенный текстовый редактор)</guimenuitem ></menuchoice > или просто введите «kate» в строке поиска. </para> </sect2> <sect2 id="starting-from-the-command-line"> <title >Из командной строки</title> <para >Чтобы запустить &kate;, введите «kate» в командной строке. Если указать имя файла в качестве параметра, как это сделано в приведённом ниже примере, то редактор откроет или создаст этот файл. </para> <informalexample> <screen ><prompt >%</prompt ><userinput ><command >kate</command > <option ><replaceable >myfile.txt</replaceable ></option ></userinput > </screen> </informalexample> <para >При наличии доступа в Интернет появляется возможность открывать и сохранять удалённые файлы благодаря реализации «прозрачной» работы с сетью в &kde;. </para> <informalexample> <screen ><prompt >%</prompt ><userinput ><command >kate</command > <option ><replaceable >&kde-ftp;README</replaceable ></option ></userinput > </screen> </informalexample> <para >Чтобы изменить каталог для сохранения временных файлов (по умолчанию <filename class="directory" >/tmp</filename >), укажите переменную среды <envar >TMPDIR</envar > перед запуском &kate;, например: <informalexample > <screen ><prompt >%</prompt ><userinput ><command >mkdir</command > /tmp/kate -p && export TMPDIR=/tmp/kate && kate</userinput > </screen> </informalexample> </para> <sect3 id="command-line-options"> <title >Параметры командной строки</title> <para >При запуске &kate; из командной строки возможно указать следующие ключи:</para> <variablelist> <varlistentry> <term ><userinput ><command >kate</command > <option >--help</option ></userinput ></term> <listitem> <para >Выводит список всех доступных команд. </para> </listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >-s</option > <option >--start</option > <parameter >имя_сеанса</parameter ></userinput ></term> <listitem> <para >Запускает &kate; и открывает сеанс <parameter >имя_сеанса</parameter >. Если указанный сеанс не существует, он будет создан. Если программа &kate; с данным сеансом уже запущена, то переданные в командной строке файлы будут открыты в уже существующем окне программы. </para> </listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >-p</option > <option >--pid</option > <parameter >PID</parameter ></userinput ></term> <listitem> <para >Открывает файл в экземпляре с указанным PID (идентификатор процесса). </para> </listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >-e</option > <option >--encoding</option > <parameter >кодировка</parameter > <parameter >URL</parameter ></userinput ></term> <listitem ><para >Использует определённую кодировку для документа. </para ></listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >-l</option > <option >--line</option > <parameter >номер_строки</parameter > <parameter >URL</parameter ></userinput ></term> <listitem ><para >Переходит к строке с указанным номером после открытия документа. </para ></listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >-c</option > <option >--column</option > <parameter >позиция</parameter > <parameter >URL</parameter ></userinput ></term> <listitem ><para >Переходит в указанную позицию строки после открытия документа. </para ></listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >-i</option > <option >--stdin</option ></userinput ></term> <listitem ><para >Получает текст из стандартного ввода. Аналогично указанию <option >-</option >, используемому во многих программах с наличием командной строки, и позволяет направить вывод команды в &kate;.</para ></listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >--startanon</option ></userinput ></term> <listitem ><para >Запускает &kate; с новым безымянным сеансом, подразумевает параметр <option >-n</option >.</para ></listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >-n</option > <option >--new</option ></userinput ></term> <listitem ><para >Принудительно запускает новый экземпляр &kate; (игнорируется, если используется <option >start</option > и указанный сеанс уже открыт в другом экземпляре &kate;); данный параметр применяется автоматически, если не указаны какие-либо параметры или ссылки.</para ></listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >-b</option > <option >--block</option ></userinput ></term> <listitem ><para >Если используется уже запущенный экземпляр &kate;, выполняет блокировку до выхода из него, если указаны ссылки для открытия.</para> <para >С этой опцией &kate; возможно использовать в качестве редактора для набора сообщений фиксации для таких систем контроля версий, как &git; или <application >Subversion</application >. Для работы с этими системами необходима блокировка редактора до того момента, пока пользователь не напишет сообщение, потому что затем они открывают временный файл, который в противном случае был бы пустым. </para> <para >Эта опция также используется в KIO (ввод/вывод &kde;) при открытии сетевого файла (загруженного в качестве временного), который требует повторной отправки после сохранения. </para ></listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >--tempfile</option ></userinput ></term> <listitem ><para >Использует указанные файлы как временные и удаляет их (если они локальные, а у пользователя достаточно прав) при закрытии, если только они не были изменены с момента их открытия.</para ></listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >--desktopfile</option > <parameter >имя_файла</parameter ></userinput ></term> <listitem ><para >Имя файла .desktop (без пути) для этого приложения.</para> <para >Это особенно полезно для приложений-оболочек и приложений, имеющих, как правило, несколько файлов рабочей области. У каждого файла рабочей области может быть своя командная строка для записи <option >Exec</option >. </para ></listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >--author</option ></userinput ></term> <listitem> <para >Показывает список авторов &kate; в окне терминала. </para> </listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >-v</option > <option >--version</option ></userinput ></term> <listitem> <para >Показывает сведения о версии &kate;. </para> </listitem> </varlistentry> <varlistentry> <term ><userinput ><command >kate</command > <option >--license</option ></userinput ></term> <listitem> <para >Показывает информацию о лицензии. </para> </listitem> </varlistentry> </variablelist> </sect3> </sect2> <sect2 id="drag-and-drop"> <title >Перетаскивание</title> <para >&kate; поддерживает протокол перетаскивания мышью &kde;. Файлы возможно перетащить в &kate; с рабочего стола, из диспетчера файлов &dolphin; или с какого-либо сетевого &FTP;-сайта, открытого в окне &dolphin;. </para> </sect2> </sect1> <sect1 id="working-with-kate"> <title >Работа в &kate;</title> <para >В разделе <link linkend="quick-start" >Начало работы</link > рассказано о четырёх опциях, которые позволят быстро настроить основные возможности &kate;. Раздел <link linkend="keystroke-commands" >Комбинации клавиш</link > содержит описание некоторых комбинаций клавиш для тех, кто не может или не желает работать с мышью. </para> <sect2 id="quick-start"> <title >Начало работы</title> <para >В этом разделе описываются несколько подпунктов меню <guimenu >Вид</guimenu >, которые помогут быстро настроить &kate; необходимым образом. </para> <para >При первом запуске &kate; появятся две области с белым фоном. Над ними будет находиться панель инструментов с наиболее часто используемыми командами. Ещё выше — строка меню. </para> <para >Область слева — это боковая панель. В ней доступны список открытых файлов (вкладка <guilabel >Документы</guilabel >) и проводник (<guilabel >Просмотр файловой системы</guilabel >) в виде «служебных панелей». Переключаться между ними возможно с помощью ярлыков, которые находятся слева от боковой панели. </para> <para >Если программа &kate; запущена для открытия файла (например, из Dolphin), то в правой области появится текст редактируемого файла, а в списке файлов, который находится на боковой панели, — его имя. С помощью селектора файлов возможно просматривать файловую структуру и открывать файлы для редактирования. </para> <para >Включить и отключить все служебные панели возможно либо с помощью меню <menuchoice ><guimenu >Вид</guimenu ><guisubmenu >Боковые панели</guisubmenu ></menuchoice >, либо с помощью комбинации клавиш <keycombo action="simul" >&Ctrl;&Alt;&Shift;<keycap >F</keycap ></keycombo >. При использовании этого меню становятся очевидны широта возможностей и гибкость &kate;. </para> <para >В меню <guisubmenu >Боковые панели</guisubmenu > отображается список всех подключённых модулей. Чтобы показать или скрыть служебную панель, установите флажок напротив соответствующего пункта списка или щёлкните левой кнопкой мыши по соответствующей кнопке на боковой панели. </para> </sect2> <sect2 id="keystroke-commands"> <title >Комбинации клавиш</title> <para >Почти все комбинации клавиш &kate; возможно перенастроить с помощью меню <link linkend="settings" >Настройка</link >. По умолчанию комбинации клавиш в &kate; настроены следующим образом: </para> <informaltable> <tgroup cols="2"> <tbody> <row> <entry ><para ><keycombo action="simul" ><keycap >F1</keycap ></keycombo ></para ></entry> <entry ><para >Справка</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Shift;<keycap >F1</keycap ></keycombo ></para ></entry> <entry ><para ><link linkend="whats-this" >Что это?</link ></para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;<keycap >N</keycap ></keycombo ></para ></entry> <entry ><para ><link linkend="file-new" >Создать</link > документ</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;<keycap >L</keycap ></keycombo ></para ></entry> <entry ><para >Сохранить всё</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;<keycap >O</keycap ></keycombo ></para ></entry> <entry ><para ><link linkend="file-open" >Открыть документ</link > </para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;&Alt;<keycap >O</keycap ></keycombo > </para ></entry> <entry ><para >Быстрый переход</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;&Shift;<keycap >F</keycap ></keycombo > </para ></entry> <entry ><para >Полноэкранный режим</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;&Shift;<keycap >,</keycap ></keycombo > </para ></entry> <entry ><para >Настроить &kate;</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;<keycap >W</keycap ></keycombo > / <keycombo action="simul" >&Ctrl;&Esc;</keycombo ></para ></entry> <entry ><para ><link linkend="file-close" >Закрыть</link > </para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;<keycap >Q</keycap ></keycombo > </para ></entry> <entry ><para >Выход — закрыть редактор </para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;&Alt;&Shift;<keycap >F</keycap ></keycombo > </para ></entry> <entry ><para >Показать боковые панели</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;&Shift;<keycap >T</keycap ></keycombo > </para ></entry> <entry ><para >Разделить по горизонтали</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;&Shift;<keycap >L</keycap ></keycombo > </para ></entry> <entry ><para >Разделить по вертикали</para ></entry> </row> <row> <entry ><para ><keycap >F8</keycap ></para ></entry> <entry ><para >Следующая створка</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Shift;<keycap >F8</keycap ></keycombo > / <keycombo action="simul" >&Ctrl;&Esc;</keycombo ></para ></entry> <entry ><para >Предыдущая створка</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Ctrl;&Shift;<keycap >R</keycap ></keycombo > </para ></entry> <entry ><para >Закрыть текущую створку</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Alt;&Right;</keycombo ></para ></entry> <entry ><para >Следующая вкладка</para ></entry> </row> <row> <entry ><para ><keycombo action="simul" >&Alt;&Left;</keycombo ></para ></entry> <entry ><para >Предыдущая вкладка</para ></entry> </row> </tbody> </tgroup> </informaltable> <para >Кроме того, возможно использовать комбинации клавиш, предоставляемые компонентом <ulink url="help:/katepart/keybindings.html" >&katepart;</ulink > и всеми подключёнными модулями <link linkend="plugins" >модулями &kate;</link >.</para> </sect2> </sect1> <sect1 id="kate-mdi"> <title >Работа с многодокументным интерфейсом &kate;</title> <sect2 id="kate-mdi-overview"> <title >Обзор</title> <para >Окно, представление, документ, панель, редактор... Что означают эти понятия в терминологии &kate;? Эта глава даст ответы на все вопросы, связанные с окнами &kate;.</para> <sect3 id="kate-mdi-overview-mainwindow"> <title >Главное окно</title> <para ><indexterm ><primary >Главное окно</primary ></indexterm > Главное окно &kate; представляет собой стандартное окно приложения &kde;, в которое добавлены боковые панели с представлениями инструментов. Главное окно содержит строку меню с расположенными на ней стандартными меню и панель инструментов, на которой находятся кнопки часто используемых команд.</para> <para >Самая важная часть окна — это область редактирования; по умолчанию она содержит один компонент для редактирования текста, в котором происходит работа с документами.</para> <para >Возможности закрепления окна используются для окон инструментов любого модуля, включённого в диалоге настройки параметров.</para> <para >Размещение служебных панелей возможно изменить. Для этого щёлкните правой кнопкой мыши по вкладке панели и выберите край экрана, в который следует её перенести.</para> <para >Служебная панель может иметь <emphasis >Фиксированное размещение</emphasis > (устанавливается вызовом контекстного меню с помощью щелчка правой кнопкой мыши). В этом случае при переходе к другой служебной панели последней будет выделено не всё пространство, а при её скрытии будет показана служебная панель, имеющая фиксированное размещение.</para> <para >Если у подключаемого модуля есть параметры конфигурации, первый пункт контекстного меню позволяет открыть соответствующую страницу в диалоге настройки &kate;.</para> </sect3> </sect2> <sect2 id="kate-mdi-editor"> <title >Область редактирования</title> <para ><indexterm ><primary >Область редактирования</primary ></indexterm > В &kate; возможно редактировать несколько документов одновременно, разделив область редактирования на панели (наподобие тех, что используются в &konqueror; и <application >emacs</application >). С помощью панелей (фреймов) возможно просматривать в области редактирования несколько документов (или несколько экземпляров одного документа). Например, если в начале файла расположены важные определения, с которыми нужно часто сверяться, эту возможность сложно не оценить по достоинству. Ещё один пример: при написании программы удобно будет в одной панели открыть заголовочный файл, а в другой — файл реализации.</para> <para >Если один и тот же документ открыть в нескольких панелях редактора, то все изменения (редактирование и выделение текста), сделанные в одной панели, будут немедленно отражены во всех остальных. Операция поиска и перемещение курсора действуют только в активной панели.</para> <para >В текущей версии &kate; нельзя открыть один и тот же документ несколько раз в том смысле, что редактироваться будет только один экземпляр, и изменения не будут отражаться во втором.</para> <para >После разделения редактора на две панели они имеют одинаковую ширину и отображают текущий документ этого редактора. Новая панель будет снизу (в случае разделения по горизонтали) или справа (в случае разделения по вертикали). Активной становится новая панель — об этом говорит мигающий текстовый курсор.</para> </sect2> </sect1> <sect1 id="fundamentals-using-sessions"> <title >Работа с сеансами</title> <para >Сеанс позволяет открывать несколько документов и настраивать расположение элементов интерфейса на своё усмотрение. Поддерживается возможность создания бесконечного количества именованных сеансов, а также использования безымянных и анонимных сеансов для файлов, открываемых только один раз. Благодаря реализации концепции сеансов появилась возможность запуска нескольких экземпляров &kate; одновременно — с разными сеансами в каждом.</para> <para >Поддержка сеансов присутствует в трёх областях: <itemizedlist> <listitem ><para ><link linkend="command-line-options" ><emphasis >Ключи командной строки</emphasis ></link > — возможность выбора сеанса при открытии &kate; с помощью командной строки.</para> </listitem> <listitem ><para ><link linkend="sessions-menu" ><emphasis >Меню «Сеанс»</emphasis ></link > — позволяет переключаться между сеансами, сохранять и настраивать их.</para ></listitem> <listitem ><para ><link linkend="config-dialog-sessions" ><emphasis >Окно настройки</emphasis ></link > — позволяет настроить параметры работы с сеансами.</para ></listitem> </itemizedlist> </para> <para >При создании нового сеанса используется конфигурация <guilabel >Сеанс по умолчанию</guilabel >. Чтобы сохранить конфигурацию окна в этом стандартном сеансе, включите сохранение конфигурации окна на странице параметров сеансов (в окне настройки &kate;), загрузите стандартный сеанс, настройте параметры окна и сохраните сеанс снова.</para> <para >При загрузке любого сохранённого сеанса в заголовке окна &kate; отображается его имя. Следовательно, заголовок окна выглядит следующим образом: «<replaceable >имя_сеанса</replaceable >: <replaceable >имя_документа или ссылка</replaceable > — &kate;».</para> <para >Если при открытии файлов из командной строки указывается ключ <option >--start <replaceable >имя_сеанса</replaceable ></option > или выбирается сеанс в диалоге выбора сеансов, то перед открытием указанных в командной строке файлов загружаются файлы соответствующего выбранного сеанса. &kate; позволяет всегда открывать файлы в новом сеансе. Для этого установите соответствующий флажок на странице параметров сеансов диалога настройки программы или укажите ключ <option >--start</option > с пустым аргументом: <replaceable >''</replaceable >.</para> <!--FIXME still valid for kf5 --> <para >Начиная с &kate; 2.5.1 <acronym >PID</acronym > текущего экземпляра экспортируется в переменную окружения <envar >KATE_PID</envar >. Для открытия файлов из встроенного терминала используется текущий экземпляр программы, если явно не указано иного.</para> </sect1> <sect1 id="fundamentals-getting-help"> <title >Получение справки</title> <sect2> <title >Получение справки в &kate;</title> <variablelist> <varlistentry> <term >Данное руководство</term> <listitem> <para >Здесь детально описаны все команды меню, параметры настройки, инструменты, диалоговые окна, модули. Также здесь описано главное окно &kate;, сам редактор и различные понятия и концепции, которые используются в приложении.</para> <para >Чтобы открыть руководство, нажмите клавишу <keycap >F1</keycap > или вызовите пункт меню <menuchoice ><guimenu >Справка</guimenu > <guimenuitem >Руководство пользователя &kate;</guimenuitem ></menuchoice >.</para ></listitem> </varlistentry> <varlistentry id="whats-this"> <term >Контекстная справка («Что это?»)</term> <listitem> <para >Контекстная справка позволяет сразу получить сведения о каком-либо элементе графического окна, будь то кнопка или любая другая область окна.</para> <para >Разработчики постарались обеспечить контекстной справкой все элементы, для которых это необходимо. Окно настройки &kate; полностью снабжено контекстной справкой, также как и многие другие диалоговые окна.</para> <para >Чтобы вызвать контекстную справку, воспользуйтесь комбинацией клавиш <keycombo action="simul" >&Shift;<keycap >F1</keycap ></keycombo > или выберите пункт меню <menuchoice ><guimenu >Справка</guimenu ><guimenuitem >Что это?</guimenuitem ></menuchoice >. Указатель мыши примет вид стрелки со знаком вопроса; теперь достаточно просто щёлкнуть левой кнопкой мыши по нужному элементу окна — небольшое окно с контекстной справкой тут же появится на экране (если, конечно, такая справка доступна).</para> </listitem> </varlistentry> <varlistentry> <term >Кнопки справки в диалоговых окнах</term> <listitem> <para >В некоторых диалоговых окнах присутствует кнопка <guibutton >Справка</guibutton >. При нажатии этой кнопки будет открыт соответствующий раздел документации в &khelpcenter;.</para> </listitem> </varlistentry> </variablelist> </sect2> <sect2> <title >Получение справки из внешних файлов</title> <para >В настоящее время &kate; не поддерживает чтение документации, относящейся к редактируемому документу. В зависимости от типа редактируемого файла, может быть полезен <link linkend="kate-application-plugin-konsole" >встроенный эмулятор терминала</link >, например, для просмотра руководств &UNIX; (man-страницы) или документации в формате info. Также возможно использовать &konqueror;.</para> </sect2> <sect2> <title >Статьи про &kate;</title> <para >Дополнительная информация доступна на <ulink url="https://kate-editor.org/featured-articles" >домашней странице &kate;</ulink >.</para> </sect2> </sect1> </chapter>
Generated by dwww version 1.15 on Thu Jun 27 10:08:09 CEST 2024.