# Texmaker : Руководство пользователя

Warning : some parts can be obsolete

## Содержание :

- 1. Настройка Texmaker

- 1.1 Настройка редактора
- 1.2 Настройка команд, относящихся к latex-у
- 1.3 Настройка проверки орфографии

- 2. Редактирование документов TeX

- 2.1 Обычные команды
- 2.2 Задание преамбулы для документов TeX
- 2.3 Структура документа
- 2.4 Просмотр документа
- 2.5 Форматирование текста
- 2.6 Разрывы текста
- 2.7 Вставка списка
- 2.8 Вставка таблицы
- 2.9 Вставка окружения "tabbing"
- 2.10 Вставка картинки
- 2.11 Перекрестные ссылки и сноски
- 2.12 Вставка математических формул
- 2.13 Использование отметок "•"

- 3. Компиляция документа

- 3.1 Компиляция
- 3.2 Файл сообщений
- 3.3 Синхронизация исходного текста и pdf с использованием Synctex
- 3.4 Использование XeLaTeX

- 4. Прочие возможности

- 4.1 Сворачивание и разворачивание частей документа
- 4.2 О документах, разделенных на несколько файлов
- 4.3 Библиография
- 4.4 Собственные команды и окружения
- 4.5 Поддержка пакетов Pstricks/Metapost/Tikz/Asymptote
- 4.6 Настройка языка и внешнего вида программы
- 4.7 Команда "Восстановить предыдущую сессию"
- 4.8 "Прямой и обратный поиск" в Texmaker
- 4.9 обзор комманд Texmaker
- 4.10 Горячие клавиши
- 4.11 Панель "исходный код"
- 4.12 Печать документов pdf встроенным просмотрщиком в Windows

# 1. Настройка Texmaker

Прежде чем использовать , Вы должны настроить редактор и команды latex, используя пункт меню "Настройка/Настроить Texmaker".

## 1.1 Настройка редактора

Прежде, чем скомпилировать Ваш первый документ, Вы должны задать кодировку, используемую редактором ("Настрока/Настроить Texmaker/Редактор/Кодировка"). Затем Вы должны использовать ту же кодировку в преамбуле ваших документов (например : \usepackage[cp1251]{inputenc}, если Вы используете в редакторе русскую кодировку Windows)
Внимание : во время открытия файла, Вы получите предупреждение, что документ не может быть правильно раскодирован в кодировке по умолчанию и программа позволит Вам выбрать другую кодировку (не меняя при этом кодировку по умолчанию) .

## 1.2 Настройка команд, относящихся к latex-у

Texmaker не может скомпилировать Ваши документы, если путь к командам LaTeX задан неверно.
Установки по умолчанию должны работать с новыми и стандартными дистрибутивами LaTeX, но Вы можете изменить их ("Настройка Texmaker" -> "Команды"). Чтобы изменить команду, просто кликните на кнопку в конце соответствующей строки и выбрать команду в окне выбора файлов : texmaker сам автоматически подправит синтаксис команды.
Символ % представляет имя файла без расширения, а символ @ будет заменен текущим номером строки.

## 1.3 Настройка проверки орфографии

Проверка орфографии использует словари OpenOffice.org (версии 2.x). Только французский, английский, немецкий, испанский и итальянский словари, имеющие лицензию GPL распространяются вместе с Texmaker.
Вы можете скачать другие словари здесь: http://wiki.services.openoffice.org/wiki/Dictionaries
Чтобы настроить проверку орфографии : "Настроить Texmaker" -> "Редактор" -> "Spelling dictionary" -> кликнуть на кнопку в конце строки чтобы выбрать файл словаря.
Предупреждение : Проверка орфографии начинается с позиции курсора, а не с начала документа.
Во время набора, если нет ошибок, текущее слово подчеркнуто красной чертой. Правый клик на слово открывает контекстное меню, в котором есть несколько предложений по замене. Кликните на выбраном слове, чтобы выполнить замену.

# 2. Редактирование документов TeX

## 2.1 Обычные команды

Стандартные командц (вырезать, скопировать, найти) можно выполнить через пункт меню "Правка" и панель инструментов "Правка".

## 2.2 Задание преамбулы для документов TeX

Чтобы задать преамбулу вашего документа, Вы можете использовать помошника "Быстрый старт" (Меню "Помошник").

Этот диалог позволяет Вам задать главные особенности Вашего документа (класс, размер бумаги, кодировку...).
Замечание : Вы можете добавить другие возможности кликнув на кнопку "+". Все ваши установки будут сохранены.

Вы можете также напечатать свою собственную модель преамбулы в редакторе : Используя команды "Копировать/Вставить" or "Сохранить как", Вы можете использовать ее для новых документов.

## 2.3 Структура документа

Чтобы начать новую часть документа (раздел, подраздел...) с помощью Texmaker, просто используйте этот выпадающий список в панели инструментов :

Это приведет к открытию диалогового окна, которое позволит Вам задать стиль очередной части (раздела, подраздела...).
Замечание : панель "Структура" обновится автоматически.

## 2.4 Просмотр документа

Левая панель "Структура" позволяет Вам быстро перемещаться между частями Вашего документа. Все что Вам нужно сделать это кликнуть на любой пункт (метку, раздел...) и вы перенесетесь к началу соответствующей области в редакторе.

панель "Структура" автоматически обновляется при наборе документа. Вы также можете "Обновить структуру" (меню "Правка") в любой момент.

В каждом файле, для ускоренной навигации можно использовать три закладки : просто кликните слева от номера строки чтобы добавить или удалить закладку. Когда Вы уже задали три закладки, Вы должны удалить одну из них, чтобы добавить новую. Чтобы перейти к строке, отмеченной заклдкой в редакторе, просто кликните на кнопку с номером закладки в строке состояния.

## 2.5 Форматирование текста

Вы можете быстро задать формат части Вашего текста следующим образом :

Дополнительные возможности: выделенный текст может быть быстро заключен в определенное окружение. Например: кликнув на кнопку "B" после выделения слова "Здравствуй" , Вы получите код: \textbf{Здравствуй}.
Эта возможность доступна для всех окружений помеченных "[selection]" в меню "LaTeX".

## 2.6 Разрывы текста

Обычные команды "spacing" доступны в меню "LaTeX" и "Математика". Чтобы быстро вставить команду LaTeX "new line", Вы можете использовать соответствующую команду панели инструментов (сочетание клавиш : Ctrl+Alt+return)

## 2.7 Вставка списка

Код обычного окружения списка можно быстро вставить через меню "LaTeX-List".
Замечание : сокращение для команды "\item" это Ctrl+Alt+H.

## 2.8 Вставка таблицы

Код LaTeX для окружения "Tabular" можно быстро вставить с помошником "Tabular" (меню "Помошник") :

Вы можете задать главные характеристика вашей таблицы.
Замечание : этот диалог позволяет Вам вставлять код прямо в ячейки.
Соответствующий код LaTeX автоматически вставляется в редактор.

## 2.9 Вставка окружения "tabbing"

Чтобы помощь Вам вставить код окружения "tabbing", можно использовать помошника "Быстрый разделитель" (меню "Wizard") :

## 2.10 Вставка картинки

Чтобы вставить в Ваш документ картинку, просто используйте команду "\includegraphics" в меню "LaTeX". Потом кликнете на кнопку справа от строки ввода чтобы выбрать графический файл.
Замечание : если вы кликните на кнопку "+", будет автоматически добавлно окружение "figure" LaTeX.

## 2.11 Перекрестные ссылки и сноски

Этот выпадающий список на панели инструментов позволяет Вам быстро вставить код "label", "cite", "ref", "footnote" и др.
Замечание : метки (label) использованные в вашем документе показываются в панели "Структура".

Дополнительная возможность:для команды \ref, диалог позволяет Вам непосредственно выбрать метку "label".

## 2.12 Вставка математических формул

Вы можете включать и выключать окружение "in-line math" кнопкой "$$" на панели инструментов (сочетание клавиш : Ctrl+Alt+M) или в меню "Математика". Сочетание клавиш для окружения "display math": Alt+Shift+M.
Панель инструментов "Математика" позволяет Вам вставить наиболее ходовые математические формулы (frac, sqrt...)

С панелью инструментов "символы" на панели "Структура", Вы можете вставить коды 400 математических символов и левые и правые скобки (просто кликнув на одну из кнопок "символы" на панели "Структура")

Дополнительная возможность: Панель инструментов "favorites symbols" (*) позволяет Вам создать свою собственную панель символов.

- Чтобы добавить симовол в панель инструментов "favorites symbols", просто сделайте правый клик на символ в другой панели символов и выберете "Add to favorites" во всплывающем меню.
- Чтобы удалить симовол из "favorites symbols", кликните на нем правой кнопкой мышки и выберете "Remove from favorites" во всплывающем меню.

Вы можете также задать формат вашего математического текста через меню "Математика".
Для окужения "array", помошник (похожий на помошника "Быстрая таблица") доступен из меню "Помошник". С этим помошником, Вы можете выбрать окружение : array, matrix, pmatrix.... Ячейки можно заполнять напрямую.

## 2.13 Использование отметок "•"

Отметки "•", автоматически вставляемые некоторыми командами Texmaker, позволяют Вам перемещаться прямо к следующему полю в созданной структуре используя клавишу "Tab" ("Shift+Tab" для перемещения в обратном направлении).
Замечание : Вставление табуляций с помощью клавиши "Tab" не работает в строках, содержащих метку "•".

# 3. Компиляция документа

## 3.1 Компиляция

Самый простой способ скомпилировать документ это использовать команду "Быстрая сборка". Вы можетед задать последовательность команд используемую командой "Быстрая сборка" в диалоге "Настроить Texmaker".

Для запуска команды из панели инструментов : сначала выберете команду, затем нажмите кнопку "Run".

Вы также можете запускать каждую команду одна за другой (сочетания клавиш : F2...F12 - смотри меню "инструменты").
Замечание : команда "Очистить" в меню "Инструменты" позволяет Вам удалить файлы (dvi, toc, aux...) созданные при сборке (за исключением файлов ps и pdf).
Предупреждение : все Ваши файлы должны иметь расширение и Вы не должны собирать безымянные файлы или файлы содержащие пробелы в имени..

## 3.2 Файл сообщений

При выполнении команды "Быстрая сборка", Файл сообщений показывается в панели "Messages / Log file". При щелчке на число в колонке "Line", курсор перемещается на соответствующую строку в редакторе и показывается сообщение об ошибке.
Замечание : количество ошибок и предупреждений LaTeX показывается перед выводом Файл сообщений.

Команды "Next Latex Error" и "Previous LaTeX Error" позволяют перейти к ошибкам, обнаруженным при сборке :

## 3.3 Синхронизация исходного текста и pdf с использованием Synctex

Если Вы добавите опцию "-synctex=1 к команде pdflatex, встроенный просмотрщик pdf будет перемещаться прямо к позиции в pdf-файле, которая соответствует текущей строке в исходном файле (La)TeX.
И наоборот, при щелчке правой кнопкой мыши на слово во встроенном просмотрщик pdf (всплывающее меню), редактор будет перескакивать к соответствующей строке исходного файла.
Замечание : если Вы нажмете клавиши ctrl+space (ctrl+$ на MacOsX) во встроенном просмотрщик pdf, то фокус ввода перемещается в окно редактора.

## 3.4 Использование XeLaTeX

Чтобы использовать xelatex с Texmaker, просто замените команду pdflatex на xelatex.

# 4. Прочие возможности

## 4.1 Сворачивание и разворачивание частей документа

Texmaker позволяет Вам сворачивать и разворачивать все такие блоки как части, главы, разделы команды окружения и др. в Вашем документе. Чтобы сделать это, Нужно установить курсор на первую строку блока. Потом вы просто щелкаете на иконку "-" чтобы свернуть соответствующий блок.
Замечание : Вы можете также использовать всплываюшее меню чтобы переместиться прямо к концу блока.

## 4.2 О документах, разделенных на несколько файлов

Texmaker позволяет работать с документами, разделенными на несколько файлов.
Чтобы включить файл в свой документ, просто используйте команду "\include{file}" в меню "LaTeX". Файл появится в панели "Структура". При щелчке на его имени, Texmaker откроет его.

Затем, Вы можете задать "главный документ" в меню "Настройка". Все команды меню "Инструменты" будут применяться только к этому документу даже при работе с дочерними документами (даже если Вы закроете главный документ).
Вы можете легко переключаться между главным документом и текущим документом с использованием специальной кнопки (прямо над кнопкой "Bold").
Замечание : Вы можете выйти из режима "главного документа" с помощью меню "Настройки".

## 4.3 Библиография

При открытии документа .tex, обнаруженные .bib автоматически анализируются и библиографические ссылки добавляются в авто-расширение. Список библиографических ссылок можно обновить используя пункт "Refresh Bibliography" меню "Правка".

Для файлов .bib, меню "Библиография" позволяет вам прямо вставлять ссылки, соответствующие стандартным типам документов.
Замечание: дополнительные поля можно автоматически удалить командой "очистить" меню "Библиография".

## 4.4 Собственные команды и окружения

Texmaker позволяет Вам вставить ваши собственные командц (сочетания клавиш : Shift+F1...Shift+F10). эти команды определяются в меню "Пользователь - Метки пользователя".
Замечание :

- Если код меню будет "%environment", Texmaker будет вставлять:
  \begin{environment }
  •
  \end{environment }
  и курсор будет помещен прямо к метке "•".
- Все символы "@" в коде будут автоматически замещаться метками "•" в редакторе и курсор будет прямо помещен у первого поля "•" (если в редакторе перед этим был выделен какой-то текст, первая метка "•" будет автоматически заменена на выделенный текст).

Вы можете также запустить ваши собственные команды (сочетания клавиш : Alt+Shift+F1...Alt+Shift+F5). Эти команды определяются в меню "Пользователь - Команды пользователя" и могут быть запущены через панель инструментов (кнопка "Run") .

## 4.5 Поддержка пакетов Pstricks/Metapost/Tikz/Asymptote

Некоторые основные команды пакетов Pstricks/Metapost/Tikz/Asymptote могут быть вставлены с использованием кнопок "PS", "MP", "TI" и "AS" в панели "Структура".
Команды "mpost" и "asy" можно запустить через меню "Инструменты" или кнопку "Run".

## 4.6 Настройка языка и внешнего вида программы

Язык интерфейса и внешний вид изменяются через меню "Настройка" (требуется перезапуск приложения).

## 4.7 Команда "Восстановить предыдущую сессию"

Если Вы вышли из программы без закрытия открытых документов, texmaker автоматически записывает имена этих документов. Командой "Restore previos session" в меню "Файл", все эти файлы можно переоткрыть одним щелчком мыши.

## 4.8 Прямой и обратный поиск в Texmaker

некоторые просмотрщики файлов .dvi могут перескакивать (и визуально подсвечивать) позицию в DVI-файле, которая соответствует строек с определенным номером в исходном файле (La)TeX.
Чтобы использовать эту возможность, Вы можете воспользоваться символом @ в синтаксе команд dvi-просмотрщика ("Настроить Texmaker" -> "Команды").
Например ("Прямой поиск"):

- Чтобы запустить yap из texmaker : "C:/Program Files/MiKTeX 2.7/miktex/bin/yap.exe" -1 -s @%.tex %.dvi
- Чтобы запустить xdvi из texmaker : xdvi %.dvi -sourceposition @:%.tex
- Чтобы запустить kdvi из texmaker : kdvi "file:%.dvi#src:@ %.tex"

Для обратной операции ("обратный поиск") :

- Чтобы запустить texmaker из yap : "C:\Program Files\Texmaker\texmaker.exe" "%f" -line %l (параметры программы : "%f" -line %l )
- Чтобы запустить texmaker из xdvi : xdvi -editor "texmaker %f -line" %.dvi -sourceposition @:%.tex

## 4.9 Обзор комманд Texmaker

texmaker file [-master] [-line xx]
с параметром "-master", документ будет автоматически определен как "главный документ".
с параметром "-line xx", Texmaker после загрузки документа спросит Вас хотите ли Вы переийт к строке xx.

## 4.10 Горячие клавиши

Сочетания клавиш по умолчанию (*:могут быть изменены - "Настроить Texmaker" -> "Редактор") :

- меню "Файл" :
  - Создать : Ctrl+N
  - Открыть : Ctrl+O
  - Сохранить : Ctrl+S
  - Закрыть : Ctrl+W
  - Выход : Ctrl+Q
- меню "Правка" :
  - Отменить действие : Ctrl+Z
  - Повторить отмененное действие : Ctrl+Y
  - Копировать : Ctrl+C
  - Вырезать : Ctrl+X
  - Вставить : Ctrl+V
  - Выделить все : Ctrl+A
  - Закомментировать : Ctrl+T
  - Раскомментировать : Ctrl+U
  - Найти : Ctrl+F
  - Продолжить поиск : Ctrl+M
  - Заменить : CTrl+R
  - Перейти к строке : Ctrl+G
  - Check spelling (from cursor) : Ctrl+Shift+F7
- меню "Инструменты" :
  - Быстрая сборка : F1
  - Latex : F2
  - View dvi : F3
  - Dvi->PS : F4
  - View PS : F5
  - Pdflatex : F6
  - View Pdf : F7
  - PS->Pdf : F8
  - Dvi->Pdf : F9
  - View log : F10
  - Bibtex : F11
  - Make index : F12
- * меню "LaTeX" :
  - * item : Ctrl+Shift+I
  - * Italic : Ctrl+I
  - * Slanted : Ctrl+Shift+S
  - * Bold : Ctrl+O
  - * Typewriter : Ctrl+Shift+T
  - * Small caps : Ctrl+Shift+C
  - * Emphasis : Ctrl+Shift+E
  - * New line : Ctrl+Return
- * меню "Математика":
  - * Inline math mode : Ctrl+Shift+M
  - * Display math mode : Alt+Shift+M
  - * Numbered equations : Ctrl+Shift+N
  - * Subscript : Ctrl+Shift+D
  - * Superscript : CTrl+Shift+U
  - * Frac : Alt+Shift+F
  - * Dfrac : Ctrl+Shift+F
  - * Sqrt : Ctrl+Shift+Q
  - * Left : Ctrl+Shift+L
  - * Right : Ctrl+Shift+R
- Меню "Пользователь " :
  - Метки пользователя : Shift+F1...Shift+F10
  - Команды пользователя : Shift+Alt+F1...Shift+Alt+F10

## 4.11 Панель "Исходный код"

Чтобы облегчить операции копирования и вставки между двумя документами, пользователь может открыть два документа (в режиме "только для чтения") кроме редактора в пнели "исходный код".

## 4.12 Печать документов pdf встроенным просмотрщиком в Windows

- Проверьте, что программа ghostscript установлена, и что путь к файлу "gswin32c.exe" в диалоге "Настройка Texmaker" правилен.
- После нажатия кнопки "print", Задайте размер бумаги и диапазон страниц для печати.
- Используйте кнопку "настройка" в появившемся стандартном диалоге печати Windows чтобы задать размер и ориентацию бумаги.