# Справка командной строки

Это приложение содержит справку по возможностям командной строки при заупске &app; из терминала.

Здесь важно отметить, что &app; была спроектирована как интерактивная программа. Поэтому она использует графический дисплей и не работает в по-настоящему текстовой консоли. Переработка программы с целью обеспечить её работу из чисто текстового терминала потребовала бы чрезвычайных усилий. Поэтому, набор опций командной строки не ставит своей целью устранение зависимости от графического дисплея. Возможности командной строки просто делают выполнение определённых (типичных) задач более удобным. Также, они позволяют выполнять эти операции из скриптов. Однако, графический дисплей должен быть всё время доступен!

Другими словами, использование командной строки обеспечивает неинтерактивное поведение, но не снимает зависимости от графического дисплея, нравится это Вам или нет!

## Возможные опции

Вот список возможных опций командной строки &app;:

Опции формата

  Формат любого файла, предназначенного для импорта или экспорта, может быть указан с помощью опции `-f` format. format может иметь следующие значения:

  gramps

    База данных &app;. Этот формат доступен для импорта и экспорта. Если не указан, он может быть угадан, если имя является каталогом.

  gedcom

    Файл GEDCOM. Этот формат доступен для импорта и экспорта. Если не указан, он может быть угадан, если имя заканчивается на .ged

  gramps-pkg

    Пакет &app;. Этот формат доступен для импорта и экспорта. Если не указан, он может быть угадан, если имя заканчивается на .tgz

  wft

    Семейное Веб-Дерево (Web Family Tree). Этот формат доступен только для экспорта. Если не указан, он может быть угадан, если имя заканчивается на .wft

  iso

    Изображение CD. Этот формат доступен только для экспорта. Он должен быть всегда явно указан.

Опции импорта

  Файлы, предназначенные для импорта, могут быть указаны с помощью опции `-i` filename Формат может быть указан опцией `-f` следующей непосредственно за именем filename. Если формат не указан, &app; сделает попытку угадать формат, основываясь на имени filename. Для формата

gramps
, имя filename на самом деле является именем каталога, в котором находится база данных &app;. Для форматов
gedcom
и
gramps-pkg
, имя filename является именем соответствующего файла.

Если задано более одного имени для импорта, каждому должен предшествовать флаг `-i`. Файлы импортируются в указанном порядке, т.е. `-i` file1 `-i` file2 и `-i` file2 `-i` file1 могут произвести различные ID в конечной базе данных.

Опции экспорта

  Файлы, преднахначенные для экспорта, могут быть указаны с помощью опции `-o` filename. Формат может быть указан опцией `-f` следующей непосредственно за именемfilename. Если формат не указан, &app; сделает попытку угадать формат, основываясь на имени filename. Для форматов

gramps
и
iso
, имя filename на самом деле является именем каталога, в который будет записана база данных &app;. Для форматов
gedcom
,
wft
и
gramps-pkg
, имя filename является именем экспортируемого файла.

Если задано более одного имени для экспорта, каждому должен предшествовать флаг `-o`. Файлы экспортируются один за другим, в указанном порядке.

Опции действия

  Действие, производимое над ипортированными данными, может быть указано с помощью опции `-a` action. Действие производится после успешного завершения всех импортов. В настоящий момент, доступные опции таковы:

summary
(то же самое, что и Отчёты Вид Итоги базы данных...) и
check
(то же самое, что и Инструменты Обработка Базы Данных Проверить и починить базу данных...).

Если задано более одного действия, каждому должен предшествовать флаг `-a`. Действия призводятся один за другим, в указанном порядке.

## Порядок работы

Порядок опций `-i`, `-o`, или `-a` относительно друг друга не имеет значения. Настоящий порядок выполнения всегда таков: все импорты (если есть) -> все экспорты (если есть) -> все действия (если есть).

Если не дано ни одной опции `-i`, &app; запустит своё главное окно и начнёт обычный интерактивный сеанс с пустой базой данных (т.к. данных всё равно не дано).

Если не дано ни одной опции `-o` или `-a`, &app; запустит своё главное окно и начнёт обычный интерактивный сеанс с базой данных, получившейся как результат всех импортов. Эта база данных будет находится в каталоге ~/.gramps/import.

Любые ошибки в процессе импорта, экспорта или действия будут выброшены на стандартный вывод stdout (если это исключения, пойманные &app;) или на стандартное устройство ошибки stderr (если они не пойманы). Используйте обычные методы перенаправления стандартных устройств, чтобы сохранить сообщения и ошибки в файлы.

## Примеры

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

`gramps -i` file1.ged `-i` file2.tgz `-i` ~/db3 `-i` file4.wft `-a` check

Чтобы явно указать форматы файлов в предыдущем примере, добавьте соответствующие опции `-f` после каждого имени:

`gramps -i` file1.ged `-f` gedcom `-i` file2.tgz `-f` gramps-pkg `-i` ~/db3 `-f` gramps `-i` file4.wft `-f` wft `-a` check

Чтобы записать базу данных, получившуюся в результате всех импортов, добавьте флаг `-o` (используйте опцию `-f` если имя не позволяет &app; угадать формат):

`gramps -i` file1.ged `-i` file2.tgz `-o` ~/new-package `-f` gramps-pkg

Для сохранения сообщений об ошибке в предыдущем примере в файлы outfile и errfile, запустите:

`gramps -i` file1.ged `-i` file2.tgz `-o` ~/new-package `-f` gramps-pkg >outfile 2>errfile

Чтобы импортировать три базы данных и начать интерактивный сеанс &app; с результатом:

`gramps -i` file1.ged `-i` file2.tgz `-i` ~/db3

Наконец, чтобы начать обычный интерактивный сеанс, наберите:

`gramps`