250 lines
16 KiB
XML
250 lines
16 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!--
|
||
User Manual for Gramps - a GTK+/GNOME based genealogy program
|
||
|
||
Copyright (C) 2003 Alexander Roitman
|
||
|
||
Permission is granted to copy, distribute and/or modify this
|
||
document under the terms of the GNU Free Documentation
|
||
License (GFDL), Version 1.1 or any later version published
|
||
by the Free Software Foundation with no Invariant Sections,
|
||
no Front-Cover Texts, and no Back-Cover Texts.
|
||
A copy of the license is included in the file COPYING-DOCS
|
||
distributed with this manual.
|
||
-->
|
||
|
||
<!-- $Id$ -->
|
||
|
||
<!-- =============== Appendices Subsection ================ -->
|
||
<sect2 id="append-cmdline">
|
||
<title>Справка командной строки</title>
|
||
<para>Это приложение содержит справку по возможностям командной
|
||
строки при заупске &app; из терминала. </para>
|
||
|
||
<para>Здесь важно отметить, что &app; была спроектирована как
|
||
интерактивная программа. Поэтому она использует графический
|
||
дисплей и не работает в по-настоящему текстовой консоли. Переработка
|
||
программы с целью обеспечить её работу из чисто текстового терминала
|
||
потребовала бы чрезвычайных усилий. Поэтому, набор опций командной
|
||
строки не ставит своей целью устранение зависимости от графического
|
||
дисплея. Возможности командной строки просто делают выполнение
|
||
определённых (типичных) задач более удобным. Также, они позволяют
|
||
выполнять эти операции из скриптов. Однако, графический дисплей
|
||
должен быть всё время доступен!</para>
|
||
|
||
<para>Другими словами, использование командной строки обеспечивает
|
||
неинтерактивное поведение, но не снимает зависимости от графического
|
||
дисплея, нравится это Вам или нет!
|
||
</para>
|
||
|
||
|
||
<sect3 id="cmdline-options">
|
||
<title>Возможные опции</title>
|
||
|
||
<para>Вот список возможных опций командной строки &app;:
|
||
</para>
|
||
|
||
<variablelist>
|
||
|
||
<varlistentry><term>Опции формата</term>
|
||
<listitem><para> Формат любого файла, предназначенного для
|
||
импорта или экспорта, может быть указан с помощью опции
|
||
<command>-f</command> <replaceable>format</replaceable>.
|
||
<replaceable>format</replaceable> может иметь следующие значения:
|
||
|
||
<variablelist>
|
||
|
||
<varlistentry><term>gramps</term>
|
||
<listitem><para> База данных &app;. Этот формат доступен для импорта и
|
||
экспорта. Если не указан, он может быть угадан, если имя является
|
||
каталогом.
|
||
</para></listitem></varlistentry>
|
||
|
||
<varlistentry><term>gedcom</term>
|
||
<listitem><para> Файл GEDCOM. Этот формат доступен для импорта и
|
||
экспорта. Если не указан, он может быть угадан, если имя заканчивается
|
||
на .ged
|
||
</para></listitem></varlistentry>
|
||
|
||
<varlistentry><term>gramps-pkg</term>
|
||
<listitem><para>Пакет &app;. Этот формат доступен для импорта и
|
||
экспорта. Если не указан, он может быть угадан, если имя заканчивается
|
||
на .tgz
|
||
</para></listitem></varlistentry>
|
||
|
||
<varlistentry><term>wft</term>
|
||
<listitem><para> Семейное Веб-Дерево (Web Family Tree). Этот формат доступен
|
||
только для экспорта. Если не указан, он может быть угадан, если имя
|
||
заканчивается на .wft
|
||
</para></listitem></varlistentry>
|
||
|
||
<varlistentry><term>iso</term>
|
||
<listitem><para> Изображение CD. Этот формат доступен
|
||
только для экспорта. Он должен быть всегда явно указан.
|
||
</para></listitem></varlistentry>
|
||
|
||
</variablelist>
|
||
|
||
</para></listitem>
|
||
</varlistentry>
|
||
|
||
<varlistentry><term>Опции импорта</term>
|
||
<listitem><para> Файлы, предназначенные для импорта, могут быть
|
||
указаны с помощью опции
|
||
<command>-i</command> <replaceable>filename</replaceable>
|
||
Формат может быть указан опцией <command>-f</command>
|
||
следующей непосредственно за именем <replaceable>filename</replaceable>.
|
||
Если формат не указан, &app; сделает попытку угадать формат, основываясь
|
||
на имени <replaceable>filename</replaceable>. Для формата <term>gramps</term>,
|
||
имя <replaceable>filename</replaceable> на самом деле является именем
|
||
каталога, в котором находится база данных &app;. Для форматов
|
||
<term>gedcom</term> и <term>gramps-pkg</term>, имя
|
||
<replaceable>filename</replaceable> является именем соответствующего файла.
|
||
</para>
|
||
|
||
<para>Если задано более одного имени для импорта, каждому должен
|
||
предшествовать флаг <command>-i</command>. Файлы импортируются
|
||
в указанном порядке, т.е.
|
||
<command>-i</command> <replaceable>file1</replaceable>
|
||
<command>-i</command> <replaceable>file2</replaceable>
|
||
и
|
||
<command>-i</command> <replaceable>file2</replaceable>
|
||
<command>-i</command> <replaceable>file1</replaceable>
|
||
могут произвести различные ID в конечной базе данных.
|
||
</para></listitem>
|
||
</varlistentry>
|
||
|
||
|
||
<varlistentry><term>Опции экспорта</term>
|
||
<listitem><para> Файлы, преднахначенные для экспорта, могут быть указаны
|
||
с помощью опции
|
||
<command>-o</command> <replaceable>filename</replaceable>.
|
||
Формат может быть указан опцией <command>-f</command>
|
||
следующей непосредственно за именем<replaceable>filename</replaceable>.
|
||
Если формат не указан, &app; сделает попытку угадать формат, основываясь
|
||
на имени <replaceable>filename</replaceable>. Для форматов
|
||
<term>gramps</term> и <term>iso</term>,
|
||
имя <replaceable>filename</replaceable> на самом деле является именем
|
||
каталога, в который будет записана база данных &app;. Для форматов
|
||
<term>gedcom</term>, <term>wft</term> и <term>gramps-pkg</term>, имя
|
||
<replaceable>filename</replaceable> является именем экспортируемого файла.
|
||
</para>
|
||
|
||
<para> Если задано более одного имени для экспорта, каждому должен
|
||
предшествовать флаг <command>-o</command>. Файлы экспортируются
|
||
один за другим, в указанном порядке.
|
||
</para></listitem>
|
||
</varlistentry>
|
||
|
||
<varlistentry><term>Опции действия</term>
|
||
<listitem><para> Действие, производимое над ипортированными данными,
|
||
может быть указано с помощью опции
|
||
<command>-a</command> <replaceable>action</replaceable>.
|
||
Действие производится после успешного завершения всех импортов.
|
||
В настоящий момент, доступные опции таковы:
|
||
<term>summary</term> (то же самое, что и
|
||
<menuchoice><guimenu>Отчёты</guimenu><guisubmenu>Вид</guisubmenu>
|
||
<guimenuitem>Итоги базы данных...</guimenuitem></menuchoice>)
|
||
и <term>check</term> (то же самое, что и
|
||
<menuchoice><guimenu>Инструменты</guimenu>
|
||
<guisubmenu>Обработка Базы Данных</guisubmenu>
|
||
<guimenuitem>Проверить и починить базу данных...</guimenuitem></menuchoice>).
|
||
</para>
|
||
|
||
<para> Если задано более одного действия, каждому должен
|
||
предшествовать флаг <command>-a</command>. Действия призводятся
|
||
один за другим, в указанном порядке.
|
||
</para></listitem>
|
||
</varlistentry>
|
||
|
||
</variablelist>
|
||
|
||
</sect3>
|
||
|
||
|
||
<sect3 id="cmdline-operation">
|
||
<title>Порядок работы</title>
|
||
|
||
<para>Порядок опций <command>-i</command>, <command>-o</command>,
|
||
или <command>-a</command> относительно друг друга не имеет значения.
|
||
Настоящий порядок выполнения всегда таков: все импорты (если есть) ->
|
||
все экспорты (если есть) -> все действия (если есть). </para>
|
||
|
||
<para>Если не дано ни одной опции <command>-i</command>, &app;
|
||
запустит своё главное окно и начнёт обычный интерактивный сеанс с пустой
|
||
базой данных (т.к. данных всё равно не дано). </para>
|
||
|
||
<para>Если не дано ни одной опции
|
||
<command>-o</command> или <command>-a</command>, &app;
|
||
запустит своё главное окно и начнёт обычный интерактивный сеанс
|
||
с базой данных, получившейся как результат всех импортов.
|
||
Эта база данных будет находится в каталоге
|
||
<replaceable>~/.gramps/import</replaceable>. </para>
|
||
|
||
<para>Любые ошибки в процессе импорта, экспорта или действия
|
||
будут выброшены на стандартный вывод stdout (если это исключения,
|
||
пойманные &app;) или на стандартное устройство ошибки stderr
|
||
(если они не пойманы). Используйте обычные методы перенаправления
|
||
стандартных устройств, чтобы сохранить сообщения и ошибки в файлы. </para>
|
||
|
||
</sect3>
|
||
|
||
<sect3 id="cmdline-examples">
|
||
<title>Примеры</title>
|
||
<para>Для импорта четырёх баз данных (формат которых может быть определён
|
||
по их именам) и последующей проверки получившейся базы данных на целостность,
|
||
можно набрать: </para>
|
||
<para><command>gramps -i</command> <replaceable>file1.ged</replaceable>
|
||
<command>-i</command> <replaceable>file2.tgz</replaceable>
|
||
<command>-i</command> <replaceable>~/db3</replaceable>
|
||
<command>-i</command> <replaceable>file4.wft</replaceable>
|
||
<command>-a</command> <replaceable>check</replaceable>
|
||
</para>
|
||
|
||
<para>Чтобы явно указать форматы файлов в предыдущем примере, добавьте
|
||
соответствующие опции <command>-f</command> после каждого имени: </para>
|
||
<para><command>gramps -i</command> <replaceable>file1.ged</replaceable>
|
||
<command>-f</command> <replaceable>gedcom</replaceable>
|
||
<command>-i</command> <replaceable>file2.tgz</replaceable>
|
||
<command>-f</command> <replaceable>gramps-pkg</replaceable>
|
||
<command>-i</command> <replaceable>~/db3</replaceable>
|
||
<command>-f</command> <replaceable>gramps</replaceable>
|
||
<command>-i</command> <replaceable>file4.wft</replaceable>
|
||
<command>-f</command> <replaceable>wft</replaceable>
|
||
<command>-a</command> <replaceable>check</replaceable>
|
||
</para>
|
||
|
||
<para>Чтобы записать базу данных, получившуюся в результате всех импортов,
|
||
добавьте флаг <command>-o</command> (используйте опцию
|
||
<command>-f</command> если имя не позволяет &app; угадать формат): </para>
|
||
<para><command>gramps -i</command> <replaceable>file1.ged</replaceable>
|
||
<command>-i</command> <replaceable>file2.tgz</replaceable>
|
||
<command>-o</command> <replaceable>~/new-package</replaceable>
|
||
<command>-f</command> <replaceable>gramps-pkg</replaceable>
|
||
</para>
|
||
|
||
<para>Для сохранения сообщений об ошибке в предыдущем примере в файлы
|
||
<replaceable>outfile</replaceable> и
|
||
<replaceable>errfile</replaceable>, запустите:</para>
|
||
<para><command>gramps -i</command> <replaceable>file1.ged</replaceable>
|
||
<command>-i</command> <replaceable>file2.tgz</replaceable>
|
||
<command>-o</command> <replaceable>~/new-package</replaceable>
|
||
<command>-f</command> <replaceable>gramps-pkg</replaceable>
|
||
><replaceable>outfile</replaceable>
|
||
2><replaceable>errfile</replaceable>
|
||
</para>
|
||
|
||
<para>Чтобы импортировать три базы данных и начать интерактивный сеанс
|
||
&app; с результатом: </para>
|
||
<para><command>gramps -i</command> <replaceable>file1.ged</replaceable>
|
||
<command>-i</command> <replaceable>file2.tgz</replaceable>
|
||
<command>-i</command> <replaceable>~/db3</replaceable>
|
||
</para>
|
||
|
||
<para>Наконец, чтобы начать обычный интерактивный сеанс, наберите: </para>
|
||
<para> <command>gramps </command></para>
|
||
|
||
</sect3>
|
||
|
||
</sect2>
|