Nl:Gramps 3.0 Wiki Handleiding - Opdrachtregel - Revision history

Erikdr: /* Formaatopties */

2008-07-23T19:16:48Z

‎Formaatopties

Erikdr at 07:42, 23 July 2008

2008-07-23T07:42:02Z

Erikdr at 07:25, 23 July 2008

2008-07-23T07:25:00Z

Erikdr at 07:24, 23 July 2008

2008-07-23T07:24:28Z

Erikdr: New page: This appendix provides the reference to the command line capabilities available when launching GRAMPS from the terminal. {{Man note| Note |GRAMPS was designed to be an interactive program...

2008-07-23T07:20:36Z

New page: This appendix provides the reference to the command line capabilities available when launching GRAMPS from the terminal. {{Man note| Note |GRAMPS was designed to be an interactive program...

New page

This appendix provides the reference to the command line capabilities available when launching GRAMPS from the terminal.

{{Man note| Note |GRAMPS was designed to be an interactive program. Therefore it uses graphical display and cannot run from the true non-graphical console. It would take an enormous amount of effort to enable it to run in a text-only terminal. This is why the set of command line options does not aim to completely get rid of dependency on the graphical display. Rather, it merely makes certain (typical) tasks more convenient. It also allows one to execute these tasks from the scripts. However, the graphical display must be accessible at all times!}}

{{Man tip| Tip |To summarize, the use of the command line options provides non-interactive behavior, but does not get rid of graphical display dependency. Take it or leave it!}}

{{grampsmanualcopyright}}

{{man index|Gramps 3.0 Wiki Manual - Keybindings/nl|Gramps 3.0 Wiki Manual - About/nl}}

{{languages|Gramps_3.0_Wiki_Manual_-_Command_Line/nl}}

== Beschikbare opties ==

This section provides the reference list of all command line options available in GRAMPS. If you want to know more than just a list of options, see next sections: [[Gramps-command line#Operation|Operation]] and [[Gramps-command line#Examples| Examples]].
=== Formaatopties ===

The format of any file destined for opening, importing, or exporting can be specified with the <pre>-f format</pre> option. The acceptable <tt>''format''</tt> values are listed below.
*grdb GRAMPS database: This format is available for opening, import, and export. When not specified, it can be guessed if the filename ends with .grdb
*gramps-xml GRAMPS XML database: This format is available for opening, import, and export. When not specified, it can be guessed if the filename ends with .gramps
*gedcom GEDCOM file: This format is available for opening, import, and export. When not specified, it can be guessed if the filename ends with .ged
*gramps-pkg GRAMPS package: This format is available for import and export. When not specified, it can be guessed if the filename ends with .gpkg
*geneweb GeneWeb file: This format is available for import and export. When not specified, it can be guessed if the filename ends with .gw
*wft Web Family Tree: This format is available for export only. When not specified, it can be guessed if the filename ends with .wft
*iso CD image: This format is available for export only. It must always be specified explicitly.

=== Opening options ===

There are two ways to give GRAMPS the name of the file to be opened:

* supply bare file name
* use this option : <pre>-O filename</pre> or <pre>--open=filename </pre>

-O, Open of a family tree. This can be done also by just typing the name (name or database dir)

Examples:
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

If the filename is given without any option flag, the attempt to open the file will be made, and then the interactive GRAMPS session will be launched.

{{Man tip| Tip |If no option is given, just the file name, GRAMPS will ignore the rest of the command line arguments. Use the -O flag to open the file and do something with the data.}}

The format can be specified with the <pre>-f format</pre> or <pre>--format=format</pre> option, immediately following the ''filename'' . If not specified, the guess will be attempted based on the ''filename''. Format possible: 'gedcom','gramps-xml','gramps-pkg', 'grdb','geneweb'.

{{Man tip| Tip |Only grdb, gramps-xml, and gedcom formats can be opened directly. For other formats, you will need to use the import option which will set up the empty database and then import data into it.}}

{{Man tip| Tip |Only a single file can be opened. If you need to combine data from several sources, you will need to use the import option.}}

=== Import options ===

The files destined for import can be specified with the <pre>-i filename</pre> or <pre>--import=filename</pre> option. The format can be specified with the <pre>-f format</pre> or <pre>--format=format</pre> 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

{{man tip | 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 <pre>-i</pre> flag. The files are imported in the specified order, i.e. <pre> -i file1 -i file2 </pre> and <pre> -i file2 -i file1 </pre> might produce different GRAMPS IDs in the resulting database.

=== Export options ===

The files destined for export can be specified with the <pre>-o filename</pre> or <pre>--output=filename</pre> option. The format can be specified with the <pre>-f</pre> 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 !

{{man tip| 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 <pre>-o</pre> 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 <pre>-a action</pre> or <pre>--action=action</pre> 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 <pre>-p option_string</pre> or <pre>--options=option_string</pre> option.

{{man tip| Report option string |The report option string should satisfy the following conditions:It must not contain any spaces. If some arguments need to include spaces, the string should be enclosed with quotation marks.
Option string must list pairs of option names and values.
Within a pair, option name and value must be separated by the equal sign.
Different pairs must be separated by commas.}}

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.

{{man tip| Tip |If an option is not supplied, the last used value will be used. If this report has never been generated before, then the value from last generated report will be used when applicable. Otherwise, the default value will be used.}}

When more than one output action is given, each has to be preceded by <pre>-a</pre> flag. The actions are performed one by one, in the specified order.

=== List option ===

-l, print a list of known family trees

== Operation ==

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 <pre>-O</pre> 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.

{{man note|1=Note |2=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 <pre>-i</pre> flag.}}

With or without the <pre>-O</pre> flag, there could be multiple imports, exports, and actions specified further on the command line by using <pre>-i</pre> , <pre>-o</pre> , and <pre>-a</pre> flags.

The order of <pre>-i</pre> , <pre>-o</pre> , or <pre>-a</pre> 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).

'{{man note| Note |But opening must always be first!}}

If no <pre>-O</pre> or <pre>-i</pre> 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 <pre>-o</pre> or <pre>-a</pre> 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:

:<pre>gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps -i file4.wft -a check</pre>

*To explicitly specify the formats in the above example, append filenames with appropriate -f options:

:<pre>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</pre>

*To record the database resulting from all imports, supply -o flag (use -f if the filename does not allow GRAMPS to guess the format):

:<pre>gramps -i file1.ged -i file2.gpkg -o ~/new-package -f gramps-pkg</pre>

*To save any error messages of the above example into files outfile and errfile, run:

:<pre>gramps -i file1.ged -i file2.dpkg -o ~/new-package -f gramps-pkg >outfile 2>errfile </pre>

*To import three databases and start interactive GRAMPS session with the result:

:<pre>gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps </pre>

*To open a database and, based on that data, generate timeline report in PDF format putting the output into the my_timeline.pdf file:

:<pre>gramps -O file.grdb -a report -p name=timeline,off=pdf,of=my_timeline.pdf </pre>

{{man tip|1=Timeline report options |2=Use the <tt>''name=timeline,show=all''</tt> to find out about all available options for the timeline report. To find out details of a particular option, use <tt>''show=option_name''</tt> , e.g. <tt>''name=timeline,show=off''</tt> string. To learn about available report names, use <tt>''name=show''<tt> string.}}

*To convert a grdb on the fly to a .gramps xml file:

:<pre>gramps -O myoriginal.grdb -o output.gramps -f gramps-xml</pre>

*Finally, to start normal interactive session type:

:<pre>gramps </pre>

== 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.

{{man index|Gramps 3.0 Wiki Manual - Keybindings/nl|Gramps 3.0 Wiki Manual - About/nl}}

[[Category:Nl:Documentatie]]

{{languages|Gramps_3.0_Wiki_Manual_-_Command_Line|Gramps_3.0_Wiki_Manual_-_Command_Line/nl}}

← Older revision		Revision as of 07:24, 23 July 2008
Line 11:		Line 11:
	{{man index\|Gramps 3.0 Wiki Manual - Keybindings/nl\|Gramps 3.0 Wiki Manual - About/nl}}		{{man index\|Gramps 3.0 Wiki Manual - Keybindings/nl\|Gramps 3.0 Wiki Manual - About/nl}}

−	{{languages\|Gramps_3.0_Wiki_Manual_-_Command_Line/nl}}	+	{{languages\|Gramps_3.0_Wiki_Manual_-_Command_Line\|Gramps_3.0_Wiki_Manual_-_Command_Line/nl}}

@@ Line 19: / Line 19: @@
 === Formaatopties ===
-The format of any file destined for opening, importing, or exporting can be specified with the <pre>-f format</pre> option. The acceptable <tt>''format''</tt> values are listed below.
+Het bestandsformaat dat gebruikt moet worden om bestanden te openen, te importeren of te exporteren kan bepaald worden door de
-*grdb GRAMPS database: This format is available for opening, import, and export. When not specified, it can be guessed if the filename ends with .grdb
+ -f
-*gramps-xml GRAMPS XML database: This format is available for opening, import, and export. When not specified, it can be guessed if the filename ends with .gramps
+'''format''' optie te gebruiken. Welke ''formaten'' gebruikt kunnen worden wordt aangegeven in onderstaand lijstje:
-*gedcom GEDCOM file: This format is available for opening, import, and export. When not specified, it can be guessed if the filename ends with .ged
-*gramps-pkg GRAMPS package: This format is available for import and export. When not specified, it can be guessed if the filename ends with .gpkg
-*geneweb GeneWeb file: This format is available for import and export. When not specified, it can be guessed if the filename ends with .gw
+* grdb GRAMPS-bestand: dit formaat is beschikbaar voor openen, importeren en exporteren. Wanneer niet expliciet vermeld kan de bestandsnaam afgeleid worden via de .grdb-extensie.
-*wft Web Family Tree: This format is available for export only. When not specified, it can be guessed if the filename ends with .wft
+* gramps-xml GRAMPS XML bestand: dit formaat is beschikbaar voor openen, importeren en exporteren. Wanneer niet expliciet vermeld kan de bestandsnaam afgeleid worden via de .gramps-extensie.
-*iso CD image: This format is available for export only. It must always be specified explicitly.
+* gedcom GEDCOM bestand: dit formaat is beschikbaar voor openen, importeren en exporteren. Wanneer niet expliciet vermeld kan de bestandsnaam afgeleid worden via de .ged-extensie.
 === Opstartopties ===

@@ Line 1: / Line 1: @@
-This appendix provides the reference to the command line capabilities available when launching GRAMPS from the terminal.
+Deze appendix behandelt de mogelijkheden van de opdrachtregel wanneer u GRAMPS opstart via een ''terminal''-venster.
-{{Man note| Note |GRAMPS was designed to be an interactive program. Therefore it uses graphical display and cannot run from the true non-graphical console. It would take an enormous amount of effort to enable it to run in a text-only terminal. This is why the set of command line options does not aim to completely get rid of dependency on the graphical display. Rather, it merely makes certain (typical) tasks more convenient. It also allows one to execute these tasks from the scripts. However, the graphical display must be accessible at all times!}}
+{{Man note| Opmerking |GRAMPS werd ontwikkeld om een volledig interactief programma te zijn. Daarom gebruikt GRAMPS een grafische schil en kan dan ook niet gedraaid worden via een terminal met enkel tekst. Het zou trouwens een enorme inspanning vergen om zo een programma te kunen draaien in een terminal met enkel tekst. Om precies die reden zijn een aantal opdrachtregels beschikbaar, maar ook daar is er geen volledige onafhankelijkheid van de grafische schermen. De opdrachtregels maken sommige typische taken eenvoudiger. Het laat de gebrukker toe om bepaalde  ''scripts'' te draaien. Maar de grafische schil moet steeds bereikbaar zijn!}}
-{{Man tip| Tip |To summarize, the use of the command line options provides non-interactive behavior, but does not get rid of graphical display dependency. Take it or leave it!}}
+{{Man tip| Tip |Samengevat: de opdrachtregels bieden een soort van niet-actief gedrag, maar de afhankelijkheid van de grafische schermen blijft bestaan. Aan u de beslissing om opdrachtregels te gebruiken of niet!}}
@@ Line 28: / Line 28: @@
 *iso CD image: This format is available for export only. It must always be specified explicitly.
-=== Opening options ===
+=== Opstartopties ===
 There are two ways to give GRAMPS the name of the file to be opened:
@@ Line 53: / Line 53: @@
 {{Man tip| Tip |Only a single file can be opened. If you need to combine data from several sources, you will need to use the import option.}}
-=== Import options ===
+=== Importopties ===
 The files destined for import can be specified with the <pre>-i filename</pre> or <pre>--import=filename</pre> option. The format can be specified with the <pre>-f format</pre> or <pre>--format=format</pre> option, immediately following the ''filename'' . If not specified, the guess will be attempted based on the ''filename''.
@@ Line 65: / Line 65: @@
 When more than one input file is given, each has to be preceded by <pre>-i</pre> flag. The files are imported in the specified order, i.e. <pre> -i file1 -i file2 </pre> and <pre> -i file2 -i file1 </pre> might produce different GRAMPS IDs in the resulting database.
-=== Export options ===
+=== Exportopties ===
 The files destined for export can be specified with the <pre>-o filename</pre> or <pre>--output=filename</pre> option. The format can be specified with the <pre>-f</pre> 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.
@@ Line 81: / Line 81: @@
 When more than one output file is given, each has to be preceded by <pre>-o</pre> flag. The files are written one by one, in the specified order.
-=== Action options ===
+=== Actieopties ===
 The action to perform on the imported data can be specified with the <pre>-a action</pre> or <pre>--action=action</pre> option. This is done after all imports are successfully completed.
@@ Line 114: / Line 114: @@
 When more than one output action is given, each has to be preceded by <pre>-a</pre> flag. The actions are performed one by one, in the specified order.
-=== List option ===
+=== Lijstopties ===
 -l, print a list of known family trees
-== Operation ==
+== Werking ==
 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.
@@ Line 138: / Line 138: @@
 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 ==
+== Voorbeelden ==
 *To import four databases (whose formats can be determined from their names) and then check the resulting database for errors, one may type:
@@ Line 174: / Line 174: @@
 :<pre>gramps </pre>
-== Environment variables==
+== Omgeveingsvariabelen==
 GRAMPS can take advantage of these environment variables (but do not change them if you do not know what are you doing):

@@ Line 9: / Line 9: @@
 {{grampsmanualcopyright}}
-{{man index|Gramps 3.0 Wiki Manual - Keybindings/nl|Gramps 3.0 Wiki Manual - About/nl}}
+{{man index/nl|Gramps 3.0 Wiki Manual - Keybindings/nl|Gramps 3.0 Wiki Manual - About/nl}}
 {{languages|Gramps_3.0_Wiki_Manual_-_Command_Line|Gramps_3.0_Wiki_Manual_-_Command_Line/nl}}
@@ Line 181: / Line 181: @@
-{{man index|Gramps 3.0 Wiki Manual - Keybindings/nl|Gramps 3.0 Wiki Manual - About/nl}}
+{{man index/nl|Gramps 3.0 Wiki Manual - Keybindings/nl|Gramps 3.0 Wiki Manual - About/nl}}
 [[Category:Nl:Documentatie]]
 {{languages|Gramps_3.0_Wiki_Manual_-_Command_Line|Gramps_3.0_Wiki_Manual_-_Command_Line/nl}}