5621: start to use markups

svn: r20759
This commit is contained in:
Jérôme Rapinat 2012-12-03 09:59:21 +00:00
parent 2a100e8a8d
commit eb4544e16c
2 changed files with 57 additions and 85 deletions

View File

@ -5,11 +5,11 @@ gramps(1) 3.4.0 gramps(1)
NAAM **NAAM**
gramps - Genealogisch Onderzoek en Analyse Beheersysteem. gramps - Genealogisch Onderzoek en Analyse Beheersysteem.
SAMENVATTING **SAMENVATTING**
gramps [-?|--help] [--usage] [--version] [-O|--open= GEGEVENSBESTAND gramps [-?|--help] [--usage] [--version] [-O|--open= GEGEVENSBESTAND
[-f|--format= FORMAAT]] [-i|--import= BESTAND [-f|--format= FORMAAT]] [-f|--format= FORMAAT]] [-i|--import= BESTAND [-f|--format= FORMAAT]]
[-i|--import= ...] [-e|--export= BESTAND [-f|--format= FORMAAT]] [-i|--import= ...] [-e|--export= BESTAND [-f|--format= FORMAAT]]
@ -17,7 +17,7 @@ SAMENVATTING
sion] sion]
BESCHRIJVING **BESCHRIJVING**
Gramps is een Free/OpenSource genealogisch programma dat in Python, Gramps is een Free/OpenSource genealogisch programma dat in Python,
geschreven is en gebruik maakt van de GTK+/GNOME interface. Gramps zal geschreven is en gebruik maakt van de GTK+/GNOME interface. Gramps zal
voor iedereen die al gewerkt heeft met andere genealogische programma's voor iedereen die al gewerkt heeft met andere genealogische programma's
@ -27,14 +27,14 @@ BESCHRIJVING
che software. che software.
OPTIES **OPTIES**
grampsBESTAND **gramps** *BESTAND*
Wanneer BESTAND opgegeven wordt (zonder vlaggen) als een famili Wanneer *BESTAND* opgegeven wordt (zonder vlaggen) als een famili
estamboom of als een familistamboommap, dan wordt dit bestand estamboom of als een familistamboommap, dan wordt dit bestand
geopend en een interactieve sessie wordt gestart. Indien BESTAND geopend en een interactieve sessie wordt gestart. Indien BESTAND
een bestandsformaat dat door Gramps herkent wordt, zal een lege een bestandsformaat dat door Gramps herkent wordt, zal een lege
familiestamboom aangemaakt worden. De bestandsnaam wordt familiestamboom aangemaakt worden. De bestandsnaam wordt
gebaseerd op de BESTAND naam en de gegevens worden in dit gebaseerd op de *BESTAND* naam en de gegevens worden in dit
bestand geïmporteerd. Met resterende opties wordt geen rekening bestand geïmporteerd. Met resterende opties wordt geen rekening
gehouden. Deze wijze van opstarten is zeer bruikbaar om Gramps gehouden. Deze wijze van opstarten is zeer bruikbaar om Gramps
te gebruiken voor genealogische gegevens via een webbrowser. te gebruiken voor genealogische gegevens via een webbrowser.
@ -42,7 +42,7 @@ OPTIES
Gramps behandelen, zie onder. Gramps behandelen, zie onder.
-f,--format= FORMAAT **-f** , **--format=** *FORMAAT*
Expliciet een formaat opgeven voor BESTAND door de optie -i, of Expliciet een formaat opgeven voor BESTAND door de optie -i, of
-e mee te geven. Indien de -f optie niet opgegeven wordt voor -e mee te geven. Indien de -f optie niet opgegeven wordt voor
BESTAND, wordt het formaat gebaseerd op de bestandsextensie of BESTAND, wordt het formaat gebaseerd op de bestandsextensie of
@ -216,7 +216,7 @@ OPTIES
**gramps** **gramps**
CONCEPTEN **CONCEPTEN**
Ondersteuning van een op python-gebaseerd plugin systeem. Dit laat toe Ondersteuning van een op python-gebaseerd plugin systeem. Dit laat toe
om verslagen, hulpgereedschappen en vensterfilters toe te voegen zonder om verslagen, hulpgereedschappen en vensterfilters toe te voegen zonder
dat het hoofdprogramma dient aangepast. dat het hoofdprogramma dient aangepast.
@ -226,8 +226,8 @@ CONCEPTEN
of LaTeX. Zo kunnen gebruikers het formaat wijzigen naar eigen wens. of LaTeX. Zo kunnen gebruikers het formaat wijzigen naar eigen wens.
GEKENDE BUGS EN BEPERKINGEN **GEKENDE BUGS EN BEPERKINGEN**
BESTANDEN **BESTANDEN**
*${PREFIX}/bin/gramps* *${PREFIX}/bin/gramps*
@ -236,7 +236,7 @@ BESTANDEN
*${HOME}/.gramps* *${HOME}/.gramps*
AUTEURS **AUTEURS**
Donald Allingham <don@gramps-project.org> Donald Allingham <don@gramps-project.org>
http://gramps-project.org/ http://gramps-project.org/
@ -251,11 +251,8 @@ AUTEURS
Erik De Richter <frederik.de.richter@pandora.be> Erik De Richter <frederik.de.richter@pandora.be>
DOCUMENTATIE **DOCUMENTATIE**
De gebruikersdocumentatie is beschikbaar via de normale GNOME Help De gebruikersdocumentatie is beschikbaar via browser in de webstek.
browser in de vorm van een Gramps-handleiding. De handleiding is ook
beschikbaar in XML-formaat: gramps-manual.xml onder doc/gramps-man
ual/$LANG in de officiële brondistributie.
De ontwikkelingsdocumentatie kan gevonden worden op de De ontwikkelingsdocumentatie kan gevonden worden op de
http://www.gramps-project.org/wiki/index.php?title=Portal:Developers http://www.gramps-project.org/wiki/index.php?title=Portal:Developers
@ -263,4 +260,4 @@ DOCUMENTATIE
August 2005 3.4.0 gramps(1) August 2005 4.0.0 gramps(1)

View File

@ -5,14 +5,14 @@ gramps(1) 3.4.0 gramps(1)
NAME **NAME**
gramps - Genealogical Research and Analysis Management Programming Sys gramps - Genealogical Research and Analysis Management Programming Sys
tem. tem.
(w wolnym tłumaczeniu: System Wspomagania Badań Genealogicznych i Pro (w wolnym tłumaczeniu: System Wspomagania Badań Genealogicznych i Pro
gramowego Zarządzania Tą Informacją) gramowego Zarządzania Tą Informacją)
SYNOPSIS **SYNOPSIS**
gramps [-?|--help] [--usage] [--version] [-l] [-u|--force-unlock] gramps [-?|--help] [--usage] [--version] [-l] [-u|--force-unlock]
[-O|--open= BAZA_DANYCH [-f|--format= FORMAT]] [-i|--import= PLIK [-O|--open= BAZA_DANYCH [-f|--format= FORMAT]] [-i|--import= PLIK
[-f|--format= FORMAT]] [-i|--import= ...] [-e|--export= PLIK [-f|--format= FORMAT]] [-i|--import= ...] [-e|--export= PLIK
@ -20,7 +20,7 @@ SYNOPSIS
[ PLIK ] [--version] [ PLIK ] [--version]
OPIS **OPIS**
Gramps jest wolnym, darmowym programem genealogicznym OpenSource. Jest Gramps jest wolnym, darmowym programem genealogicznym OpenSource. Jest
napisany w Python, przy użyciu interfejsu GTK+/GNOME. Dla każdego, kto napisany w Python, przy użyciu interfejsu GTK+/GNOME. Dla każdego, kto
wcześniej używał innego programu genealogicznego (np. Family Tree wcześniej używał innego programu genealogicznego (np. Family Tree
@ -30,9 +30,9 @@ OPIS
jest używany przez większość programów genealogicznych na świecie. jest używany przez większość programów genealogicznych na świecie.
OPCJE **OPCJE**
gramps PLIK **gramps** *PLIK*
Kiedy PLIK jest podany (bez żadnych flag) jako nazwa drzewa Kiedy *PLIK* jest podany (bez żadnych flag) jako nazwa drzewa
rodzinnego albo nazwa katalogu z drzewem, to wybrane drzewo jest rodzinnego albo nazwa katalogu z drzewem, to wybrane drzewo jest
otwierane i rozpoczynana jest sesja interaktywna. Jeśli PLIK otwierane i rozpoczynana jest sesja interaktywna. Jeśli PLIK
jest formatem rozpoznawanym przez Gramps, to tworzone jest puste jest formatem rozpoznawanym przez Gramps, to tworzone jest puste
@ -43,7 +43,7 @@ OPCJE
akceptuje każdy format natywny dla grampsa, zobacz poniżej. akceptuje każdy format natywny dla grampsa, zobacz poniżej.
-f,--format= FORMAT **-f** , **--format=** *FORMAT*
Jawne określenie formatu PLIKU przez poprzedzenie opcji -i, lub Jawne określenie formatu PLIKU przez poprzedzenie opcji -i, lub
-e. Jeśli opcja -f nie jest podana dla żadnego PLIKU, to format -e. Jeśli opcja -f nie jest podana dla żadnego PLIKU, to format
pliku jest określany na podstawie rozszerzenia albo typu MIME. pliku jest określany na podstawie rozszerzenia albo typu MIME.
@ -63,22 +63,23 @@ OPCJE
iso (używany tylko, jeśli jawnie określony przez parametr -f ). iso (używany tylko, jeśli jawnie określony przez parametr -f ).
-l Wyświetla listę dosŧępnych drzew genealogicznych. **-l**
Wyświetla listę dosŧępnych drzew genealogicznych.
-u,--force-unlock **-u** , **--force-unlock**
Wymusza odblokowanie bazy danych. Wymusza odblokowanie bazy danych.
-O,--open= BAZA_DANYCH **-O** , **--open=** *BAZA_DANYCH*
Otwiera BAZĘ_DANYCH, która musi istnieć w katalogu baz lub być Otwiera *BAZĘ_DANYCH* , która musi istnieć w katalogu baz lub być
nazwą istniejącego drzewa rodzinnego. Jeśli nie podano akcji, to nazwą istniejącego drzewa rodzinnego. Jeśli nie podano akcji, to
opcje eksportu albo importu są wykonywane, a następnie jest opcje eksportu albo importu są wykonywane, a następnie jest
uruchamiana sesja interaktywna z otwarciem wybranej bazy. uruchamiana sesja interaktywna z otwarciem wybranej bazy.
-i,--import= PLIK **-i** , **--import=** *PLIK*
Importuje dane z PLIKU. Jeśli nie określono bazy danych, to Importuje dane z *PLIKU* . Jeśli nie określono bazy danych, to
tworzona jest tymczasowa baza kasowana po zamknięciu programu. tworzona jest tymczasowa baza kasowana po zamknięciu programu.
Kiedy podany jest więcej niż jeden plik do importu, to każdy z Kiedy podany jest więcej niż jeden plik do importu, to każdy z
@ -88,8 +89,8 @@ OPCJE
bazie wynikowej. bazie wynikowej.
-e,--export= PLIK **-e** , **--export=** *PLIK*
Eksportuje dane do PLIKU. Dla formatu iso, PLIK natomiast nazwą Eksportuje dane do *PLIKU* . Dla formatu iso, PLIK natomiast nazwą
katalogu, do którego baza danych gramps zostanie zapisana. Dla katalogu, do którego baza danych gramps zostanie zapisana. Dla
gramps-xml, gedcom, wft, gramps-pkg, oraz geneweb, PLIK jest gramps-xml, gedcom, wft, gramps-pkg, oraz geneweb, PLIK jest
nazwą pliku wynikowego. nazwą pliku wynikowego.
@ -99,7 +100,7 @@ OPCJE
podanej przez parametry kolejności. podanej przez parametry kolejności.
-a,--action= AKCJA **-a** , **--action=** *AKCJA*
Wykonuje AKCJĘ na zaimportowanych danych. Działanie to jest Wykonuje AKCJĘ na zaimportowanych danych. Działanie to jest
wykonywane dopiero, gdy wszystkie określone importy zakończą się wykonywane dopiero, gdy wszystkie określone importy zakończą się
powodzeniem. Aktualnie dostępne akcje to: powodzeniem. Aktualnie dostępne akcje to:
@ -122,18 +123,18 @@ OPCJE
konkretnej opcji, jednak część z opcji jest wspólna, szczególnie konkretnej opcji, jednak część z opcji jest wspólna, szczególnie
dla raportów. dla raportów.
name=nazwa **name=nazwa**
Opcja wymagana, określający który raport czy narzędzie będzie Opcja wymagana, określający który raport czy narzędzie będzie
uruchamiane. Jeśli podana wartość nazwy nie pasuje do żadnego uruchamiane. Jeśli podana wartość nazwy nie pasuje do żadnego
dostępnego raportu czy narzędzia, zostanie wyświetlony komunikat dostępnego raportu czy narzędzia, zostanie wyświetlony komunikat
o błędzie oraz lista dostępnych raportów albo opcji (w o błędzie oraz lista dostępnych raportów albo opcji (w
zależności od wartości parametru AKCJA). zależności od wartości parametru AKCJA).
show=all **show=all**
Wyświetla listę wszystkich nazw dostępnych opcji wraz z krótkim Wyświetla listę wszystkich nazw dostępnych opcji wraz z krótkim
opisem dla danego raportu albo narzędzia. opisem dla danego raportu albo narzędzia.
show=nazwa_opcji **show=nazwa_opcji**
Wyświetla opis funkcji udostępnianej przez daną nazwę_opcji, jak Wyświetla opis funkcji udostępnianej przez daną nazwę_opcji, jak
również listę parametrów, które akceptuje dana opcja. również listę parametrów, które akceptuje dana opcja.
@ -146,43 +147,16 @@ OPCJE
jności w jakiej występują w linii poleceń. jności w jakiej występują w linii poleceń.
-d,--debug= NAZWA_LOGGERA **-d** , **--debug=** *NAZWA_LOGGERA*
Włącza logi debuggowania dla celów programistycznych i Włącza logi debuggowania dla celów programistycznych i
testowych. Zobacz do kodu źródłowego po szczegóły. testowych. Zobacz do kodu źródłowego po szczegóły.
--version **--version**
Wyświetla wersję programu i kończy działanie. Wyświetla wersję programu i kończy działanie.
**Działanie**
Następujące opcje są używane przy aktywacji Bonobo:
--oaf-ior-fd=FD
Deskryptor pliku, do którego wpisać OAF IOR.
--oaf-activate-iid= IID
OAF IID do aktywacji.
--oaf-private
Wstgrzymuje rejestrację serwera przez OAF.
Następujące opcje są używane do kontroli dźwięku generowanego za pomocą
Gnome Library.
--disable-sound
Wyłącza użycie serwera dźwięku.
--enable-sound
Włącza użycie serwera dźwięku.
--espeaker= HOSTNAME:PORT
Host:port na którym jest uruchomiony serwer dźwięku.
Działanie
Jeśli pierwszy argument nie rozpoczyna się znakiem myślnik, (nie jest Jeśli pierwszy argument nie rozpoczyna się znakiem myślnik, (nie jest
flagą), to gramps będzie próbował otworzyć plik podany przez pierwszy flagą), to gramps będzie próbował otworzyć plik podany przez pierwszy
argument, a następnie sesję interaktywną a pozostałą część parametrów w argument, a następnie sesję interaktywną a pozostałą część parametrów w
@ -222,7 +196,7 @@ Działanie
cje i błędy do pliku. cje i błędy do pliku.
PRZYKŁADY **PRZYKŁADY**
Aby otworzyć istniejące drzewo rodzinne i zaimportować dane do niego, Aby otworzyć istniejące drzewo rodzinne i zaimportować dane do niego,
można wpisać: można wpisać:
@ -267,21 +241,22 @@ PRZYKŁADY
gramps gramps
ZMIENNE ŚRODOWISKOWE **ZMIENNE ŚRODOWISKOWE**
Program sprawdza w systemie istnienie i wartości następujących zmien Program sprawdza w systemie istnienie i wartości następujących zmien
nych: nych:
LANG - określa ustawienia, jaki język zostanie wybrany. Np.: polski to **LANG** - określa ustawienia, jaki język zostanie wybrany. Np.: polski to
pl_PL.UTF-8. pl_PL.UTF-8.
GRAMPSHOME - określa folder, w którym będzie zapisywane ustawienia i **GRAMPSHOME** - określa folder, w którym będzie zapisywane ustawienia i
bazy programu. Domyślnie jest on nieustawiony, a program przyjmuje, że bazy programu. Domyślnie jest on nieustawiony, a program przyjmuje, że
katalog z danymi zostanie utworzony w profilu użytkownika (zmienna HOME katalog z danymi zostanie utworzony w profilu użytkownika (zmienna HOME
pod Linuxem albo USERPROFILE pod Windows 2000/XP). pod Linuxem albo USERPROFILE pod Windows 2000/XP).
KONCEPCJA **KONCEPCJA**
Obsługa systemu rozszerzeń bazującego na pythonie, pozwalającego na Obsługa systemu rozszerzeń bazującego na pythonie, pozwalającego na
dodawanie formatów importu i eksportu zapisów, generatorów raportów, dodawanie formatów importu i eksportu zapisów, generatorów raportów,
narzędzi i filtrów wyświetlania bez modyfikowania głównego programu narzędzi i filtrów wyświetlania bez modyfikowania głównego programu
@ -292,19 +267,22 @@ KONCEPCJA
użytkownikm wybór formatu wyjściowego w zależności od ich potrzeb. użytkownikm wybór formatu wyjściowego w zależności od ich potrzeb.
ZNANE BŁĘDY I OGRANICZENIA **ZNANE BŁĘDY I OGRANICZENIA**
Prawdopodobne. Lista błędów i propozycji znajduje się na: Prawdopodobne. Lista błędów i propozycji znajduje się na:
http://www.gramps-project.org/wiki/index.php?title=Portal:Developers . http://www.gramps-project.org/wiki/index.php?title=Portal:Developers .
PLIKI **PLIKI**
${PREFIX}/bin/gramps
${PREFIX}/share/gramps *${PREFIX}/bin/gramps*
${HOME}/.gramps (jeśli nie użyta została zmienna środowiskowa GRAMP
SHOME) *${PREFIX}/share/gramps*
*${HOME}/.gramps (jeśli nie użyta została zmienna środowiskowa GRAMP
SHOME)*
AUTORZY **AUTORZY**
Donald Allingham <don@gramps-project.org> Donald Allingham <don@gramps-project.org>
http://gramps-project.org/ http://gramps-project.org/
@ -317,15 +295,12 @@ AUTORZY
Tłumaczenie na polski: Łukasz Rymarczyk <yenidai@poczta.onet.pl> Tłumaczenie na polski: Łukasz Rymarczyk <yenidai@poczta.onet.pl>
DOCUMENTATION **DOCUMENTATION**
Dokumentacja użytkownika jest dostępna poprzez standardową przeglądarkę Dokumentacja użytkownika jest dostępna poprzez standardową przeglądarkę.
pomocy systemu GNOME. Dokumentacja dostępna jest także w formacie XML
jako plik gramps-manual.xml w folderze doc/gramps-manual/$LANG w
głównym źródle dystrybucji.
Dokumentacja dla programistów jest dostępna na stronie projektu: Dokumentacja dla programistów jest dostępna na stronie projektu:
http://www.gramps-project.org/wiki/index.php?title=Portal:Developers http://www.gramps-project.org/wiki/index.php?title=Portal:Developers
January 2008 3.4.0 gramps(1) January 2008 4.0.0 gramps(1)