Difference between revisions of "Mk:Грампс 3.0 Вики Прирачник - Наредбена линија"

From Gramps
Jump to: navigation, search
(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...)
 
m
 
(29 intermediate revisions by 3 users not shown)
Line 1: Line 1:
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 note| Забелешка |Грампс е дизајниран за да биде интерактивна програма. Затоа користи графички приказ и не може да извршува од вистинска не-графичка конзола. Ќе биде потребно огромно количество труд за да се овозможи да извршува во само-текст терминал. Затоа, групата на опции на наредбената линија нема за цел целосно ослободување од зависноста од графичкиот приказ. Туку, само некои (вообичаени) посоодветни задачи. Исто така, дозволува и извршување на овие задачи од скриптите. Но, до графичкиот приказ мора да има пристап постојано!}}
  
{{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| Совет|Да резимираме, употребата на опциите на наредбената линија овозможува неинтерактивно однесување, но не се ослободува од зависноста од графичкиот приказ. Земете или оставете!}}
  
  
Line 9: Line 9:
 
{{grampsmanualcopyright}}
 
{{grampsmanualcopyright}}
  
{{man index|Gramps 3.0 Wiki Manual - Keybindings|Gramps 3.0 Wiki Manual - About}}  
+
{{man index/mk|Mk:Грампс 3.0 Вики Прирачник - Кратенки на копчиња|Mk:Грампс 3.0 Вики Прирачник - За|3.0}}  
  
 
{{languages|Gramps_3.0_Wiki_Manual_-_Command_Line}}
 
{{languages|Gramps_3.0_Wiki_Manual_-_Command_Line}}
  
  
== Available options ==
+
== Достапни опции ==
  
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]].
+
Овој оддел овозможува список со упатувања на сите опции на наредбената линија достапни во Грампс. Ако сакате да дознате повеќе од само список со опции, видете ги следните оддели: [[Gramps-command line#Operation|Операција]] и [[Gramps-command line#Examples|Примери]].
=== Format options ===
 
  
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 ===
+
Форматот на која било датотека наменета за отворање, увезување или извезување, може да биде одредена со опцијата <pre>-f format</pre> Прифатливите вредности на <tt>''формат''</tt> се прикажани подолу.
 +
*grdb Грампс база на податоци: Овој формат е достапен за отворање, увезување или извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .grdb.
 +
*gramps-xml Грампс XML база на податоци: Овој формат е достапен за отворање, увезување или извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .gramps.
 +
*gedcom GEDCOM датотека: Овој формат е достапен за отворање, увезување или извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .ged.
 +
*gramps-pkg Грампс пакет: Овој формат е достапен за увезување и извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .gpkg.
 +
*geneweb GeneWeb датотека: Овој формат е достапен за увезување и извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .gw.
 +
*wft Веб-семејно стебло: Овој формат е достапен само за извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .wft.
 +
*iso ЦД-слика: Овој формат е достапен само за извезување. Секогаш мора да биде јасно одреден.
  
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)
+
* снабдете чисто име на датотека
 +
* употребете ја оваа опција: <pre>-O filename</pre> или <pre>--open=filename </pre>
  
Examples:
+
-O, Отворање на семејно стебло. Исто така, ова може да се направи едноставно само со впишувањето на името (име или директориум на база на податоци).
 +
 
 +
Примери:
 
  python gramps.py 'Family Tree 1'
 
  python gramps.py 'Family Tree 1'
 
  python gramps.py /home/cristina/.gramps/grampsdb/47320f3d
 
  python gramps.py /home/cristina/.gramps/grampsdb/47320f3d
Line 43: Line 44:
 
  python gramps.py -O /home/cristina/.gramps/grampsdb/47320f3d
 
  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.}}
+
{{Man tip| Совет |Ако не е дадена ниту една опција, само името на датотеката, Грампс ќе ги игнорира останатите аргументи на наредбената линија. Користете го -O знамето за да ја отворите датотеката и сторете нешто со податоците.}}
  
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'.
+
Форматот може да биде одреден со опциите <pre>-f format</pre> или <pre>--format=format</pre> веднаш по ''името на датотеката''. Ако не е одредено, ќе се направи обид за претпоставка заснована на ''името на датотеката''. Можен формат: „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| Совет|Само grdb, gramps-xml и gedcom форматите можат да бидат директно отворени. За други формати, ќе морате да ја употребите опцијата за увоз, којашто ќе постави празна база на податоци, а потоа ќе увезе податоци во неа.}}
  
{{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.}}
+
{{Man tip| Совет|Само една датотека може да се отвори. Ако имате потреба од комбинирање податоци од неколку извори, ќе треба да ја употребите опцијата за увоз.}}
  
=== 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''.
+
Датотеките наменети за увоз можат да бидат одредени со опциите <pre>-i filename</pre> или <pre>--import=filename</pre> Форматот може да биде одреден со опциите <pre>-f format</pre> или <pre>--format=format</pre> веднаш по ''името на датотеката''. Ако не е одредено, обид за претпоставка ќе се направи заснован на ''името на датотеката''.
  
Example:  
+
Пример:  
 
   python gramps.py -i 'Family Tree 1' -i 'Family Tree 2'
 
   python gramps.py -i 'Family Tree 1' -i 'Family Tree 2'
 
   python gramps.py -i test.grdb -i data.gramps
 
   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.}}
+
{{man tip | Совет|Повеќе од една датотека може да се увезе со една наредба. Ако е ова случајот, Грампс ќе ги соедини податоците од следната датотека во базата достапна во моментот.}}
  
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.
+
Кога е дадено повеќе од еден внес на датотека, пред секоја од нив треба да стои знамето <pre>-i</pre> Датотеките се увезени по одредениот редослед, т.е. <pre> -i file1 -i file2 </pre> и <pre> -i file2 -i file1 </pre> можат да изработат различни Грампс ИД броеви во добиената датотека.
  
=== 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.
+
Датотеките наменети за извоз можат да бидат одредени со опциите <pre>-o filename</pre> или <pre>--output=filename</pre> Форматот може да биде одреден со опцијата <pre>-f</pre> веднаш по ''името на датотеката''. Ако не е одредена, обид за претпоставка ќе се направи засновано на ''името на датотеката''. За iso форматот, ''името на датотеката'' е, всушност, името на директориумот каде што ќе биде напишана базата. За grdb, gramps-xml, gedcom, wft, geneweb и gramps-pkg, ''името на датотеката'' е името на добиената датотека.
  
-o, output a family tree in required format. It is not possible to export to a family tree.
+
-o, извоз на семејното стебло во бараниот формат. Не е можно извезување до семејно стебло.
  
Example:
+
Пример:
 
   python gramps.py -i 'Family Tree 1' -i test.grdb -f grdb -o mergdeDB.gramps
 
   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:
+
Забележете дека погоре не се менува „Семејно стебло 1“ затоа што се сè случува преку привремена база на податоци, додека:
 
   python gramps.py -O 'Family Tree 1' -i test.grdb -f grdb -o mergdeDB.gramps
 
   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 !
+
ќе увезе test.grdb во Семејно стебло 1, а потоа ќе го извезе на датотека!
  
{{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.}}
+
{{man tip| Извезување на повеќе датотеки|Можат да се извезат повеќе од една датотека во една наредба. Ако е ова случај, Грампс ќе се обиде да напише неколку датотеки користејќи ги податоците од базата достапни во моментот.}}
  
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.
+
Кога е дадено повеќе од еден изнес на датотека, пред секоја од нив треба да стои знамето <pre>-o</pre> Датотеките се напишани една по една, во одредениот редослед.
  
=== 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.
+
Постапката за изведување на увезените податоци може да биде одредена со опците <pre>-a action</pre> или <pre>--action=action</pre> Ова е направено откако успешно се завршени сите увози.
  
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.
+
*''извештаи'': Оваа постапка дозволува изработување извештаи од наредбената линија. Бидејќи извештаите, главно, имаат многу нивни опции, по оваа постапка треба да следи низата со опции на извештајот. Низата е дадена со користење на опциите <pre>-p option_string</pre> или <pre>--options=option_string</pre>
  
{{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.
+
{{man tip| Низа на опции на извештај |Низата на опции на извештајот треба да ги задоволи следниве услови: Не смее да содржи празни места. Ако некои аргументи мораат да имаат празно место, низата треба да биде во наводници.
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.}}
+
{{man tip| Совет |Ако не е понудена опција, последно употребената вредност ќе се употреби. Ако овој извештај никогаш порано не бил генериран, тогаш ќе се употреби вредноста од последниот генериран извештај, ако може. Инаку, зададената вредност ќе се употреби.}}
  
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.
+
Кога повеќе од една изнесна постапка е дадена, пред секоја треба да стои знамето <pre>-a</pre> Постапките се применуваат една по една, во одредениот редослед.
  
=== List option ===
+
=== Опции на список ===
  
-l, print a list of known family trees
+
-l, печати список на познати семејни стебла.
  
== 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.
+
Ако е дадено знамето <pre>-O</pre> тогаш Грампс ќе се обиде да ја отвори понудената датотека и тогаш ќе почне да работи со податоците, како што е упатено од понатамошните параметри на наредбената линија.
  
{{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.}}
+
{{man note|1=Забелешка |2=Само една датотека може да се отвори во едно повикување од Грампс. Ако треба да добиете податоци од повеќе извори, употребете ги опциите на извозот преку употреба на знамето <pre>-i</pre>}}
  
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.
+
Со или без знамето <pre>-O</pre> може да има повеќекратни увози, извози и постапки понатаму одредени на наредбената линија со употреба на знамињата <pre>-i</pre> <pre>-o</pre> и <pre>-a</pre>
  
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).
+
Редоследот на <pre>-i</pre> <pre>-o</pre> или <pre>-a</pre> не е важен. Редоследот на  извршувањето, всушност, е: сите увози (ако има) -> сите извози (ако има) -> сите постапки (ако има).
  
'{{man note| Note |But opening must always be first!}}
+
{{man note| Забелешка |Но, отворањето мора секогаш да биде прво!}}
  
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.
+
Ако не е дадена опцијата <pre>-O</pre> или <pre>-i</pre> Грампс ќе го лансира главниот прозорец и ќе почне со вообичаената интерактивна сесија со празната база, бидејќи во неа нема податоци за обработување.
  
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.
+
Ако не се дадени опциите <pre>-o</pre> или <pre>-a</pre> Грампс ќе го лансира главниот прозорец и ќе почне со вообичаената интерактивна сесија со база на податоци добиена од отворањето и сите увози (ако има). Оваа база се наоѓа во датотеката ''import_db.grdb'' под директориумот ''~/.gramps/import/''.
  
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.
+
Секоја грешка добиена во текот на увезувањето, извезувањето или некој постапка, или ќе биде исфрлена во stdout (ако се ова отстапки управувани од Грампс) или во stderr (ако не се управувани). Користете ги вообичаените пренасочувања на обвивките на stdout и stderr за да се зачуваат пораките и грешките во датотеки.
  
== 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>
 
:<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:
+
*За јасно одредување на форматите во претходниот пример, додадете ииња на датотеки со соодветните -f опции:
  
 
:<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>
 
:<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):
+
*За да зачувате база на податоци добиена од сите увози, обезбедете -o знаме (користете -f ако името на датотеката не дозволува Грампс да го претпостави форматот):
  
 
:<pre>gramps -i file1.ged -i file2.gpkg -o ~/new-package -f gramps-pkg</pre>
 
:<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:
+
*За да ја зачувате секоја порака со грешка од претходниот пример во датотеките outfile и errfile, извршете:
  
 
:<pre>gramps -i file1.ged -i file2.dpkg -o ~/new-package -f gramps-pkg >outfile 2>errfile </pre>
 
:<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>
 
:<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:
+
*За да отворите база на податоци и врз основа на тие податоци, да генерирате хронолошки извештај во PDF формат, сместувајќи го изнесот во датотеката my_timeline.pdf:
  
 
:<pre>gramps -O file.grdb -a report -p name=timeline,off=pdf,of=my_timeline.pdf </pre>
 
:<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.}}
+
{{man tip|1=Опции на хронолошки извештај |2=Употребете <tt>''name=timeline,show=all''</tt> за да откриете сè за сите достапни опции за хронолошкиот извештај. За да ги дознаете подробностите на одредена опција, употребете <tt>''show=option_name''</tt> , на пример: <tt>''name=timeline,show=off''</tt> string. За да научите за достапните опции за хронолошкиот извештај употребете <tt>''name=show''<tt> string.}}
  
*To convert a grdb on the fly to a .gramps xml file:
+
*За да претворите grdb во текот во .gramps xml датотека:
  
 
:<pre>gramps -O myoriginal.grdb -o output.gramps -f gramps-xml</pre>
 
:<pre>gramps -O myoriginal.grdb -o output.gramps -f gramps-xml</pre>
  
*Finally, to start normal interactive session type:
+
*На крајот, за да почнете со вообичаена интерактивна сесија, впишете:
  
 
:<pre>gramps </pre>
 
:<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.
+
* '''GRAMPSHOME''' - ако е поставено, отфрлете ја зададената патека во профил што му дозволува на корисникот да го употреби мрежниот драјв за зачувување на податоци и сите поставувања.
* '''LANG''' - is used by GRAMPS to determine which language file should be loaded.
+
* '''LANG''' - е употребено од Грампс за да одреди која јазична датотека треба да биде вчитана.
  
  
{{man index|Gramps 3.0 Wiki Manual - Keybindings|Gramps 3.0 Wiki Manual - About}}  
+
{{man index/mk|Mk:Грампс 3.0 Вики Прирачник - Кратенки на копчиња|Mk:Грампс 3.0 Вики Прирачник - За|3.0}}  
  
[[Category:Documentation]]
+
[[Category:Mk:Documentation]]
  
 
{{languages|Gramps_3.0_Wiki_Manual_-_Command_Line}}
 
{{languages|Gramps_3.0_Wiki_Manual_-_Command_Line}}

Latest revision as of 18:09, 10 March 2011

Овој додаток овозможува упатување на способностите на наредбената линија што стануваат достапни при лансирањето на Грампс од терминалот.

Gramps-notes.png
Забелешка

Грампс е дизајниран за да биде интерактивна програма. Затоа користи графички приказ и не може да извршува од вистинска не-графичка конзола. Ќе биде потребно огромно количество труд за да се овозможи да извршува во само-текст терминал. Затоа, групата на опции на наредбената линија нема за цел целосно ослободување од зависноста од графичкиот приказ. Туку, само некои (вообичаени) посоодветни задачи. Исто така, дозволува и извршување на овие задачи од скриптите. Но, до графичкиот приказ мора да има пристап постојано!

Tango-Dialog-information.png
Совет

Да резимираме, употребата на опциите на наредбената линија овозможува неинтерактивно однесување, но не се ослободува од зависноста од графичкиот приказ. Земете или оставете!



Gnome-important.png 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.
Also, only use the known Typographical conventions

Претходно Индекс Следно



Достапни опции

Овој оддел овозможува список со упатувања на сите опции на наредбената линија достапни во Грампс. Ако сакате да дознате повеќе од само список со опции, видете ги следните оддели: Операција и Примери.

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

Форматот на која било датотека наменета за отворање, увезување или извезување, може да биде одредена со опцијата

-f format

Прифатливите вредности на формат се прикажани подолу.

  • grdb Грампс база на податоци: Овој формат е достапен за отворање, увезување или извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .grdb.
  • gramps-xml Грампс XML база на податоци: Овој формат е достапен за отворање, увезување или извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .gramps.
  • gedcom GEDCOM датотека: Овој формат е достапен за отворање, увезување или извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .ged.
  • gramps-pkg Грампс пакет: Овој формат е достапен за увезување и извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .gpkg.
  • geneweb GeneWeb датотека: Овој формат е достапен за увезување и извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .gw.
  • wft Веб-семејно стебло: Овој формат е достапен само за извезување. Кога не е одредено, може да се претпостави ако името на датотеката завршува со .wft.
  • iso ЦД-слика: Овој формат е достапен само за извезување. Секогаш мора да биде јасно одреден.

Опции на отворање

Има два начина за давање на името на датотеката на Грампс што треба да се отвори:

  • снабдете чисто име на датотека
  • употребете ја оваа опција:
    -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

Ако името на датотеката е дадено без ниту една опција-знаме, обидот за отворање на датотеката ќе биде направен, а потоа интерактивната Грампс сесија ќе биде лансирана.

Tango-Dialog-information.png
Совет

Ако не е дадена ниту една опција, само името на датотеката, Грампс ќе ги игнорира останатите аргументи на наредбената линија. Користете го -O знамето за да ја отворите датотеката и сторете нешто со податоците.


Форматот може да биде одреден со опциите

-f format

или

--format=format

веднаш по името на датотеката. Ако не е одредено, ќе се направи обид за претпоставка заснована на името на датотеката. Можен формат: „gedcom“, „gramps-xml“, „gramps-pkg“, „grdb“, „geneweb“.

Tango-Dialog-information.png
Совет

Само grdb, gramps-xml и gedcom форматите можат да бидат директно отворени. За други формати, ќе морате да ја употребите опцијата за увоз, којашто ќе постави празна база на податоци, а потоа ќе увезе податоци во неа.


Tango-Dialog-information.png
Совет

Само една датотека може да се отвори. Ако имате потреба од комбинирање податоци од неколку извори, ќе треба да ја употребите опцијата за увоз.


Опции за увоз

Датотеките наменети за увоз можат да бидат одредени со опциите

-i filename

или

--import=filename

Форматот може да биде одреден со опциите

-f format

или

--format=format

веднаш по името на датотеката. Ако не е одредено, обид за претпоставка ќе се направи заснован на името на датотеката.

Пример:

  python gramps.py -i 'Family Tree 1' -i 'Family Tree 2'
  python gramps.py -i test.grdb -i data.gramps
Tango-Dialog-information.png
Совет

Повеќе од една датотека може да се увезе со една наредба. Ако е ова случајот, Грампс ќе ги соедини податоците од следната датотека во базата достапна во моментот.


Кога е дадено повеќе од еден внес на датотека, пред секоја од нив треба да стои знамето

-i

Датотеките се увезени по одредениот редослед, т.е.

 -i file1 -i file2 

и

 -i file2 -i file1 

можат да изработат различни Грампс ИД броеви во добиената датотека.

Оции за извоз

Датотеките наменети за извоз можат да бидат одредени со опциите

-o filename

или

--output=filename

Форматот може да биде одреден со опцијата

-f

веднаш по името на датотеката. Ако не е одредена, обид за претпоставка ќе се направи засновано на името на датотеката. За iso форматот, името на датотеката е, всушност, името на директориумот каде што ќе биде напишана базата. За grdb, gramps-xml, gedcom, wft, geneweb и gramps-pkg, името на датотеката е името на добиената датотека.

-o, извоз на семејното стебло во бараниот формат. Не е можно извезување до семејно стебло.

Пример:

 python gramps.py -i 'Family Tree 1' -i test.grdb -f grdb -o mergdeDB.gramps

Забележете дека погоре не се менува „Семејно стебло 1“ затоа што се сè случува преку привремена база на податоци, додека:

 python gramps.py -O 'Family Tree 1' -i test.grdb -f grdb -o mergdeDB.gramps

ќе увезе test.grdb во Семејно стебло 1, а потоа ќе го извезе на датотека!

Tango-Dialog-information.png
Извезување на повеќе датотеки

Можат да се извезат повеќе од една датотека во една наредба. Ако е ова случај, Грампс ќе се обиде да напише неколку датотеки користејќи ги податоците од базата достапни во моментот.


Кога е дадено повеќе од еден изнес на датотека, пред секоја од нив треба да стои знамето

-o

Датотеките се напишани една по една, во одредениот редослед.

Опции на постапка

Постапката за изведување на увезените податоци може да биде одредена со опците

-a action

или

--action=action

Ова е направено откако успешно се завршени сите увози.

Во моментов достапни се следните постапки:

  • резиме: Оваа постапка е иста со Извештаи -> Поглед -> Резиме.
  • провери: Оваа постапка е иста со Алатки -> Обработка на база на податоци -> Провери и поправи.
  • алатки: Оваа постапка дозволува извршување на алатка од наредбена линија.
  • извештаи: Оваа постапка дозволува изработување извештаи од наредбената линија. Бидејќи извештаите, главно, имаат многу нивни опции, по оваа постапка треба да следи низата со опции на извештајот. Низата е дадена со користење на опциите
    -p option_string
    или
    --options=option_string
Tango-Dialog-information.png
Низа на опции на извештај

Низата на опции на извештајот треба да ги задоволи следниве услови: Не смее да содржи празни места. Ако некои аргументи мораат да имаат празно место, низата треба да биде во наводници. Низата со опции мора да подредува парови на имиња и вредности на опциите. Во еден пар, името и вредноста на опцијата мора да бидат одделени со ист знак. Различните парови мора да бидат одделени со запирки.


Најголемиот дел од опциите се посебни за секој одделен извештај. Но, имаат и некои заеднички.

  • име=извештај_име: Оваа задолжителна опција одредува кој извештај ќе биде генериран. Ако понуденото извештај_име не одговара со ниту еден достапен извештај, пораката за грешка ќе биде отпечатена следена од списокот со достапните извештаи.
  • покажи=сè: Ова ќе изработи список со имиња за сите опции достапни за дадениот извештај.
  • покажи=опција_име: Ова ќе го отпечати описот на функционалноста понудена од опција_име, како и тоа кои се прифатливите видови и вредности за оваа опција.

Употребете ги претходните опции за да откриете сè за даден извештај.

Tango-Dialog-information.png
Совет

Ако не е понудена опција, последно употребената вредност ќе се употреби. Ако овој извештај никогаш порано не бил генериран, тогаш ќе се употреби вредноста од последниот генериран извештај, ако може. Инаку, зададената вредност ќе се употреби.


Кога повеќе од една изнесна постапка е дадена, пред секоја треба да стои знамето

-a

Постапките се применуваат една по една, во одредениот редослед.

Опции на список

-l, печати список на познати семејни стебла.

Операција

Ако првиот аргумент на наредбената линија не почнува со цртичка (т.е. е без знаме), Грампс ќе се обиде да ја отвори датотеката со името дадено во првиот аргумент и ќе почне интерактивна сесија, занемарувајќи ги останатите аргументи од наредбената линија.

Ако е дадено знамето

-O

тогаш Грампс ќе се обиде да ја отвори понудената датотека и тогаш ќе почне да работи со податоците, како што е упатено од понатамошните параметри на наредбената линија.

Gramps-notes.png
Забелешка

Само една датотека може да се отвори во едно повикување од Грампс. Ако треба да добиете податоци од повеќе извори, употребете ги опциите на извозот преку употреба на знамето
-i

Со или без знамето

-O

може да има повеќекратни увози, извози и постапки понатаму одредени на наредбената линија со употреба на знамињата

-i
-o

и

-a

Редоследот на

-i
-o

или

-a

не е важен. Редоследот на извршувањето, всушност, е: сите увози (ако има) -> сите извози (ако има) -> сите постапки (ако има).

Gramps-notes.png
Забелешка

Но, отворањето мора секогаш да биде прво!

Ако не е дадена опцијата

-O

или

-i

Грампс ќе го лансира главниот прозорец и ќе почне со вообичаената интерактивна сесија со празната база, бидејќи во неа нема податоци за обработување. Ако не се дадени опциите

-o

или

-a

Грампс ќе го лансира главниот прозорец и ќе почне со вообичаената интерактивна сесија со база на податоци добиена од отворањето и сите увози (ако има). Оваа база се наоѓа во датотеката import_db.grdb под директориумот ~/.gramps/import/.

Секоја грешка добиена во текот на увезувањето, извезувањето или некој постапка, или ќе биде исфрлена во stdout (ако се ова отстапки управувани од Грампс) или во stderr (ако не се управувани). Користете ги вообичаените пренасочувања на обвивките на stdout и stderr за да се зачуваат пораките и грешките во датотеки.

Примери

  • За да увезете четири бази (чиишто формати можат да бидат утврдени од нивните имиња), а потоа да ги проверите за грешки, може да впишете:
gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps -i file4.wft -a check
  • За јасно одредување на форматите во претходниот пример, додадете ииња на датотеки со соодветните -f опции:
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
  • За да зачувате база на податоци добиена од сите увози, обезбедете -o знаме (користете -f ако името на датотеката не дозволува Грампс да го претпостави форматот):
gramps -i file1.ged -i file2.gpkg -o ~/new-package -f gramps-pkg
  • За да ја зачувате секоја порака со грешка од претходниот пример во датотеките outfile и errfile, извршете:
gramps -i file1.ged -i file2.dpkg -o ~/new-package -f gramps-pkg >outfile 2>errfile 
  • За да внесете три бази и да почнете со интерактивна Грампс сесија со резултатот:
gramps -i file1.ged -i file2.gpkg -i ~/db3.gramps 
  • За да отворите база на податоци и врз основа на тие податоци, да генерирате хронолошки извештај во PDF формат, сместувајќи го изнесот во датотеката my_timeline.pdf:
gramps -O file.grdb -a report -p name=timeline,off=pdf,of=my_timeline.pdf 
Tango-Dialog-information.png
Опции на хронолошки извештај

Употребете name=timeline,show=all за да откриете сè за сите достапни опции за хронолошкиот извештај. За да ги дознаете подробностите на одредена опција, употребете show=option_name , на пример: name=timeline,show=off string. За да научите за достапните опции за хронолошкиот извештај употребете name=show string.


  • За да претворите grdb во текот во .gramps xml датотека:
gramps -O myoriginal.grdb -o output.gramps -f gramps-xml
  • На крајот, за да почнете со вообичаена интерактивна сесија, впишете:
gramps 

Променливи на средина

Грампс може да ги искористи овие променливи на средината (но не менувајте ги ако не знаете што правите):

  • GRAMPSHOME - ако е поставено, отфрлете ја зададената патека во профил што му дозволува на корисникот да го употреби мрежниот драјв за зачувување на податоци и сите поставувања.
  • LANG - е употребено од Грампс за да одреди која јазична датотека треба да биде вчитана.
Претходно Индекс Следно