# Переменные в документах

Переменные позволяют &kword; вносить в документ очень специфические изменения, которые иначе потребовали бы постоянного внимания пользователя.

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

После объявления переменной в документ вставляется объектная ссылка, которую &kword; заменяет на значение этой переменной.

Переменные могут быть фиксированными (после вставки в документ их значение постоянно) или изменяемыми (&kword; обновляет ссылки при каждом изменении переменной).

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

## Дата и время

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

&kword; позволяет использовать как фиксированные, так и переменные значения даты и времени.

### Вставка даты

Чтобы вставить в текст дату, подведите курсор к нужному месту в тексте и выберите пункт меню Вставка ПеременнаяДата. В появившемся подменю выберите Текущая дата (фиксированная) или Текущая дата (переменная).

Текущая дата (фиксированная)

  Этот пункт меню позволяет вставить в документ текущую дату. Дата определяется по системным часам компьютера и всегда остаётся постоянной; она не изменяется даже тогда, когда &kword; обновляет переменные документа.

  Данный пункт часто используется для вставки в текст даты создания документа или для занесения в отчёт даты проделанной работы. См. также Текущая дата (переменная).

Текущая дата (переменная)

  Этот пункт меню позволяет вставить в документ текущую дату. Дата определяется по часам компьютера и изменяется, когда &kword; обновляет переменные документа.

  Этот пункт можно использовать в любом месте, где необходима текущая дата. См. также Текущая дата (фиксированная).

После того, как вы выберете тип переменной, появится диалоговое окно.

Верхний выпадающий список позволяет определить формат переменной. Доступно несколько вариантов:

В соответствии с локалью

  Дата будет вставлена в формате, указанном в Центре управления KDE.

  Чтобы выбрать этот вариант, просто удостоверьтесь, что вверху окна в выпадающем списке выбран пункт В соответствии с локалью. В этом же окне вы можете увидеть, как дата выглядит в выбранном формате. Если внесённые изменения вас устраивают, нажмите кнопку OK.

Готовые форматы даты

  В &kword; есть 12 готовых форматов даты, которых хватает в большинстве случаев. Просто выберите один из них в верхнем выпадающем списке. В этом же окне вы можете увидеть, как дата выглядит в выбранном формате. Если внесённые изменения вас устраивают, нажмите кнопку OK.

Другой формат

  Если подходящий формат отсутствует, вы можете создать его сами.

  С помощью нескольких букв и цифр можно указать, в каком порядке следуют элементы даты.

  Строка, определяющая формат даты, состоит из заполнителей и разделителей. Список заполнителей дан в следующих трёх таблицах.

  Дни и числа

  Заполнители для дней и чисел | д | дд | ддд | дддд
  Пример | 6 | 06 | Пт | Пятница

  Месяцы

  Заполнители для месяцев | М | ММ | МММ | ММММ
  Пример | 1 | 01 | Янв | Январь

  Год

  Заполнители для года | гг | гггг
  Пример | 02 | 2002

  Чтобы создать строку, определяющую формат даты, запишите в нужном порядке заполнители, разделив их любыми символами (разделителями).

  Например:

  дд.ММ.гггг означает 06.03.2002

  а

  д ММММ гггг г. превратится в 6 марта 2002 г.

  Заметьте, что &kword; заменяет только заполнители; пробелы, точки и другие символы остаются нетронутыми.

  Следует также помнить, что заполнители указываются с учётом регистра. дд является заполнителем, тогда как ДД - нет.

  Чтобы создать собственный формат даты, сначала выберите вариант Другой.

  Затем введите несколько заполнителей и разделителей в верхний выпадающий список. Также можно выбирать заполнители из списка Вставка:; они будут вставлены в текущей позиции курсора.

В этом же окне можно увидеть, как строка с текущей датой выглядит в выбранном формате. Если вас устраивают внесённые изменения, нажмите кнопку OK, и переменная будет вставлена в документ.

После того, как дата вставлена, можно изменять её формат и переключать режим фиксированно/переменная. Просто щёлкните по ней правой кнопкой мыши, и в появившемся меню выберите Пользовательские переменные.... В следующем подменю вы сможете выбрать новую переменную или другой формат; переменная будет сразу же обновлена.

### Вставка времени

Чтобы вставить в текст время, подведите курсор к нужному месту в тексте и выберите пункт меню Вставка ПеременнаяВремя. Теперь вы сможете выбрать пункт Текущее время (фиксированное) или Текущее время (переменное).

Текущее время (фиксированное)

  Этот пункт меню позволяет вставить в документ текущее время. Время определяется по системным часам компьютера и всегда остаётся постоянным; оно не изменяется даже тогда, когда &kword; обновляет переменные документа.

  Этот пункт прекрасно подходит для вставки в документ времени какого-то события. См. также Текущее время (переменное).

Текущее время (переменное)

  Этот пункт меню позволяет вставить в документ текущее время. Время определяется по часам компьютера и изменяется, когда &kword; обновляет переменные документа.

  Этот пункт используется в любом месте, где необходимо текущее время. См. также Текущее время (фиксированное).

При выборе этого пункта появится диалоговое окно.

Верхний выпадающий список позволяет настроить вид переменной. Доступно несколько вариантов:

В соответствии с локалью

  Время будет вставлено в формате, указанном в Центре управления KDE.

  Чтобы выбрать этот вариант, просто удостоверьтесь, что вверху окна в выпадающем списке выбран пункт В соответствии с локалью. В этом же окне вы можете увидеть, как время выглядит в данном формате. Если внесённые изменения вас устраивают, нажмите кнопку OK.

Готовые форматы времени

  В &kword; есть пять готовых форматов времени, которых хватает в большинстве случаев. Просто выберите один из них в верхнем выпадающем списке. В этом же окне вы можете увидеть, как время выглядит в данном формате. Если внесённые изменения вас устраивают, нажмите кнопку OK.

Другой формат

  Если подходящий формат времени отсутствует, вы можете сами его создать.

  С помощью нескольких букв и цифр можно указать, в каком порядке следуют элементы времени.

  Строка, определяющая формат времени, состоит из заполнителей и разделителей. Список заполнителей дан в следующих пяти таблицах.

  Часы

  Заполнители для часов | ч | чч
  Пример | 6 | 06

  Минуты

  Заполнители для минут | м | мм
  Пример | 3 | 03

  Секунды

  Заполнители для секунд | с | сс
  Пример | 2 | 02

  Миллисекунды

  Заполнители для миллисекунд | млс
  Пример | 022

  Секунды

  Заполнители для обозначения AM/PM | ap | AP
  Пример | am | AM

  Чтобы создать строку, определяющую формат времени, запишите в нужном порядке заполнители, разделив их любыми символами (разделителями).

  Например:

  чч:мм:сс означает 06:23:13

  а

  ч:мм ap превратится в 6:23 am

  Заметьте, что &kword; заменяет только заполнители. Пробелы, двоеточия и другие символы остаются нетронутыми.

  Следует также помнить, что заполнители указываются с учётом регистра. чч является заполнителем, тогда как ЧЧ - нет.

  Чтобы создать собственный формат времени, выберите вариант Другой.

  Теперь введите несколько заполнителей и разделителей в верхний выпадающий список. Также можно выбрать заполнители из списка Вставка:; они будут вставлены в текущей позиции курсора.

  В этом же окне можно увидеть, как строка с текущим временем выглядит в выбранном формате. Если вас устраивают внесённые изменения, нажмите кнопку OK, и переменная будет вставлена в документ.

В этом же окне можно увидеть, как строка с текущим временем выглядит в выбранном формате. Если вас устраивают внесённые изменения, нажмите кнопку OK, и переменная будет вставлена в документ.

После того, как время вставлено, можно изменять его формат и переключать режим фиксированное/переменное. Просто щёлкните по нему правой кнопкой мыши, и в появившемся меню выберите Пользовательские переменные.... В следующем подменю вы сможете выбрать новую переменную или другой формат; переменная будет сразу же обновлена.

## Номера страниц

&kword; позволяет легко вставлять в документ номера страниц.

Для этого можно использовать две переменные: Текущая страница и Количество страниц

Чтобы вставить номер страницы, подведите курсор к нужному месту в тексте и выберите пункт меню Вставка ПеременнаяНомер страницы. Номер страницы будет вставлен в текущую позицию курсора.

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

Номера страниц автоматически обновляются по ходу редактирования документа.

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

## Названия разделов

Чтобы вставить название раздела, подведите курсор к нужному месту в тексте и выберите пункт меню Вставка ПеременнаяНазвание раздела.

Чтобы определить название текущего раздела, &kword; ищет на текущей странице абзац со стилем Заголовок 1. Первый же абзац с таким стилем - это название раздела. Если на текущей странице такого абзаца не найдено, &kword; продолжает поиск на предыдущих страницах.

## Другие переменные

В &kword; есть также и другие переменные, которые могут оказаться полезными; их значение меняется от документа к документу. Чтобы вставить их в текст, выберите пункт меню Вставка ПеременнаяСведения одокументе . Из появившегося списка выберите нужную переменную. Эти переменные описаны в следующей таблице.

Переменная | Пример | Подробности
--- | --- | ---
Имя файла | Report.kwd | Название файла, в котором хранится этот документ
Автор | Василий Пупкин | Имя автора, указанное в окне Сведения о документе.
Город | Москва | Город, указанный в окне Сведения о документе.
Организация | KDE | Название организации, указанное в окне Сведения о документе.
Страна | Россия | Страна, указанная в окне Сведения о документе.
Название каталога | /home/vpupkin/kword | Название каталога, в котором хранится документ (без имени файла).
Полный путь и имя файла | /home/vpupkin/kword/Report.kwd | Полный путь к текущему документу.
Описание | Отчёт за август 2002 г. | Описание документа, указанное в окне Сведения о документе.
Название документа | Отчёт | Название документа, указанное в окне Сведения о документе.
Адрес электронной почты | vpupkin@kde.ru | Адрес электронной почты автора, указанный в окне Сведения о документе.
Факс | Любой номер факса | Номер факса, указанный в окне Сведения о документе.
Имя файла | Report.kwd | Полное имя файла.
Имя файла без расширения | Report | Позволяет вставить имя файла без расширения (обычно расширение - .kwd).
Почтовый индекс | Любой почтовый индекс | Почтовый индекс, указанный в окне Сведения о документе.
Улица | ул. Цветочная, 159 | Адрес (улица и номер дома), указанный в окне Сведения о документе.
Телефон | Любой номер телефона | Номер телефона, указанный в окне Сведения о документе.
Должность | Начальник отдела автоматизации | Должность автора, указанная в окне Сведения о документе.

Переменные, значение которых неизвестно, будут показаны как <Ничего>. Чтобы присвоить им значение, воспользуйтесь окном Сведения о документе.

## Пользовательские переменные

&kword; предлагает вам множество готовых переменных, однако иногда бывает удобно создать свои собственные.

Вы можете определить любое количество переменных для каждого документа.

### Создание новой переменной

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

Выберите пункт меню Вставка ПеременнаяДругая Создать.

В появившемся окне укажите название переменной и её текущее значение.

Чтобы подтвердить создание переменной и вставить её в текст, нажмите OK. Чтобы отменить создание переменной, нажмите кнопку Отмена.

Теперь вы можете вставить эту переменную в любом месте документа.

### Изменение значения переменной

Чтобы работа с переменными была удобной, &kword; позволяет давать им значение и в последствии изменять его. Чтобы изменить значение:

Выберите пункт меню Сервис Пользовательские переменные....

В появившемся окне показаны все созданные вами переменные. В первом столбце указано название переменной, а во втором - её значение.

Чтобы изменить значение, просто щёлкните поле справа от переменной и введите нужное значение.

Когда вы закончите вносить изменения, нажмите кнопку OK, и все переменные будут обновлены.

### Вставка созданной переменной

Чтобы вставить созданную переменную в текст, выберите пункт меню Вставка ПеременнаяПользовательская . Созданные вами переменные будут показаны в появившемся подменю. Щёлкните по той, которая вам нужна, и &kword; вставит её в текущую позицию курсора.

## Обновление значений всех переменных

&kword; позволяет вам обновить значения всех переменных одной командой (чтобы удостовериться, что всем переменным присвоены надлежащие значения). Это особенно важно для переменных, обозначающих дату и время.

Чтобы обновить все переменные, просто выберите пункт меню Вставка ПеременнаяОбновить все значения .

## Обновление значений отдельных переменных

&kword; также позволяет обновить значение отдельной переменной (обозначающей дату или время), не затрагивая при этом остальных переменных.

Просто наведите указатель мыши на переменную, которую вы хотите обновить, и щёлкните правой кнопкой мыши. В появившемся меню будут показаны различные форматы даты и времени, а также пункт, позволяющий переключать режим фиксированное/переменное. Просто выберите новый параметр, и переменная будет обновлена.