Mk:Грампс 3.0 Вики Прирачник - Наредбена линија
Овој додадток овозможува упатување на способностите на наредбената линија што стануваат достапни при лансирањето на Грампс од терминалот. This appendix provides the reference to the command line capabilities available when launching GRAMPS from the terminal.
Совет Да резимираме, употребата на опциите на наредбената линија овозможува не-интерактивно однесување, но не се ослободува од зависноста ог графичкиот приказ. Земете или оставете! |
Special copyright notice: All edits to this page need to be under two different copyright licenses:
These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [https://www.gramps-project.org/...]), not via internal links. |
Previous | [[Gramps {{{3}}} Wiki Manual| Index]] | Next |
Languages: |
English • Deutsch • français • македонски • Nederlands • shqip |
Contents
Достапни опции Available options
Овој оддел овозможува список со упатувања на сите опции на наредбената линија достапни во Грампс. Ако сакате да дознате повеќе од само список со опции, видете ги следните оддели: Операција и Примери.
Опции на формат
Форматот на која било датотека наменета за отворање, увезување или извезување, може да биде одредена со опцијата
-f format
. Прифатливите вредности на формат се прикажани подолу.
- grdb Грампс база на податоци: Овој формат е достапен за отворање, увезување или извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .grdb
- gramps-xml Грампс XML база на податоци: Овој формат е достапен за отворање, увезување или извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .gramps
- gedcom GEDCOM датотека: Овој формат е достапен за отворање, увезување или извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .ged
- gramps-pkg Грампс пакет: Овој формат е достапен за увезување и извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .gpkg
- geneweb GeneWeb датотека: Овој формат е достапен за увезување и извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .gw
- wft Веб Семејно стебло: Овој формат е достапен само за извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .wft
- iso CD слика: Овој формат е достапен само за извезување. Секогаш мора да биде јасно одреден.
Опции на отворање
Има два начина за давање на името на датотеката на Грампс што треба да се отвори:
- снабдете чисто име на датотека supply bare file name
- употребете ја оваа опција:
-O filename
или--open=filename
-O, Отворање на семејно стебло. Ова, исто така, може да се направи едноставно само со впишувањето на името (име или директориум на база на податоци)
Примери:
python gramps.py 'Family Tree 1' python gramps.py /home/cristina/.gramps/grampsdb/47320f3d python gramps.py -O 'Family Tree 1' python gramps.py -O /home/cristina/.gramps/grampsdb/47320f3d
Ако името на датотеката е дадено без ниту една опција-знаме, обидот за отворање на датотеката ќе биде направен, а потоа интерактивната Грампс сесија ќе биде лансирана.
Форматот може да биде одреден со опциите
-f format
или
--format=format
веднаш по името на датотеката . Ако не е одредено, ќе се направи обид за претпоставка заснована на името на датотеката. МОжен формат: 'gedcom','gramps-xml','gramps-pkg', 'grdb','geneweb'.
Совет Само една датотека може да се отвори. Ако имате потреба од комбинирање на податоци од неколку извори, ќе треба да ја употребите опцијата за увоз. |
Опции за увоз
Датотеките наменети за увоз можат да бидат одредени со опциите
-i filename
или
--import=filename
. The format can be specified with the
-f format
or
--format=format
option, immediately following the filename . If not specified, the guess will be attempted based on the filename.
Example:
python gramps.py -i 'Family Tree 1' -i 'Family Tree 2' python gramps.py -i test.grdb -i data.gramps
Tip More than one file can be imported in one command. If this is the case, GRAMPS will incorporate the data from the next file into the database available at the moment. |
When more than one input file is given, each has to be preceded by
-i
flag. The files are imported in the specified order, i.e.
-i file1 -i file2
and
-i file2 -i file1
might produce different GRAMPS IDs in the resulting database.
Оции на извоз Export options
The files destined for export can be specified with the
-o filename
or
--output=filename
option. The format can be specified with the
-f
option immediately following the filename . If not specified, the guess will be attempted based on the filename . For iso format, the filename is actually the name of directory the GRAMPS database will be written into. For grdb, gramps-xml, gedcom, wft, geneweb, and gramps-pkg, the filename is the name of the resulting file.
-o, output a family tree in required format. It is not possible to export to a family tree.
Example:
python gramps.py -i 'Family Tree 1' -i test.grdb -f grdb -o mergdeDB.gramps
Note that above does not change 'Family Tree 1' as everything happens via a temporary database, whereas:
python gramps.py -O 'Family Tree 1' -i test.grdb -f grdb -o mergdeDB.gramps
will import test.grdb into Family Tree 1, and then export to a file !
Exporting more files More than one file can be exported in one command. If this is the case, GRAMPS will attempt to write several files using the data from the database available at the moment. |
When more than one output file is given, each has to be preceded by
-o
flag. The files are written one by one, in the specified order.
Опции на Action options
The action to perform on the imported data can be specified with the
-a action
or
--action=action
option. This is done after all imports are successfully completed.
Currently available actions are:
- summary: This action is the same as Reports ->View ->Summary
- check: This action is the same as Tools ->Database Processing ->Check and Repair .
- tool: This action allow to run a tool from a command line.
- report: This action allows producing reports from the command line. As reports generally have many options of their own, this action should be followed by the report option string. The string is given using the
-p option_string
or--options=option_string
option.
Most of the report options are specific for every report. However, there some common options.
- name=report_name: This mandatory option determines which report will be generated. If the supplied report_name does not correspond to any available report, the error message will be printed followed by the list of available reports.
- show=all: This will produce the list of names for all options available for a given report.
- show=option_name: This will print the description of the functionality supplied by the option_name, as well as what are the acceptable types and values for this option.
Use the above options to find out everything about a given report.
When more than one output action is given, each has to be preceded by
-a
flag. The actions are performed one by one, in the specified order.
Опции на список List option
-l, print a list of known family trees
Операција
If the first argument on the command line does not start with dash (i.e. no flag), GRAMPS will attempt to open the file with the name given by the first argument and start interactive session, ignoring the rest of the command line arguments.
If the
-O
flag is given, then GRAMPS will try opening the supplied file name and then work with that data, as instructed by the further command line parameters.
Note Only one file can be opened in a single invocation of GRAMPS. If you need to get data from multiple sources, use the importing options by using -iflag. |
With or without the
-O
flag, there could be multiple imports, exports, and actions specified further on the command line by using
-i
,
-o
, and
-a
flags. The order of
-i
,
-o
, or
-a
options with respect to each does not matter. The actual execution order always is: all imports (if any) -> all exports (if any) -> all actions (if any).
'
Note But opening must always be first! |
If no
-O
or
-i
option is given, GRAMPS will launch its main window and start the usual interactive session with the empty database, since there is no data to process, anyway. If no
-o
or
-a
options are given, GRAMPS will launch its main window and start the usual interactive session with the database resulted from opening and all imports (if any). This database resides in the import_db.grdb file under the ~/.gramps/import/ directory.
Any errors encountered during import, export, or action, will be either dumped to stdout (if these are exceptions handled by GRAMPS) or to stderr (if these are not handled). Use usual shell redirections of stdout and stderr to save messages and errors in files.
Примери Examples
- To import four databases (whose formats can be determined from their names) and then check the resulting database for errors, one may type:
gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps -i file4.wft -a check
- To explicitly specify the formats in the above example, append filenames with appropriate -f options:
gramps -i file1.ged -f gedcom -i file2.gpkg -f gramps-pkg -i ~/db3.gramps -f gramps-xml -i file4.wft -f wft -a check
- To record the database resulting from all imports, supply -o flag (use -f if the filename does not allow GRAMPS to guess the format):
gramps -i file1.ged -i file2.gpkg -o ~/new-package -f gramps-pkg
- To save any error messages of the above example into files outfile and errfile, run:
gramps -i file1.ged -i file2.dpkg -o ~/new-package -f gramps-pkg >outfile 2>errfile
- To import three databases and start interactive GRAMPS session with the result:
gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps
- To open a database and, based on that data, generate timeline report in PDF format putting the output into the my_timeline.pdf file:
gramps -O file.grdb -a report -p name=timeline,off=pdf,of=my_timeline.pdf
- To convert a grdb on the fly to a .gramps xml file:
gramps -O myoriginal.grdb -o output.gramps -f gramps-xml
- Finally, to start normal interactive session type:
gramps
Варијабли на околина Environment variables
GRAMPS can take advantage of these environment variables (but do not change them if you do not know what are you doing):
- GRAMPSHOME - if set, override default path to profile allowing user to use ex. network drive to store data and all settings.
- LANG - is used by GRAMPS to determine which language file should be loaded.
Previous | [[Gramps {{{3}}} Wiki Manual| Index]] | Next |
Languages: |
English • Deutsch • français • македонски • Nederlands • shqip |