Gramps é um programa de genealogia livre e de código aberto. Ele é escrito em Python e usa a interface GTK+/GNOME. Gramps deve parecer familiar a qualquer pessoa que já tenha usado outro programa de genealogia, tais como o Family Tree Maker (TM), Personal Ancestral Files (TM), ou o GNU Geneweb. Ele suporta a importação do formato GEDCOM, que é amplamente usado por quase todos os outros programas de genealogia.
Quando ARQUIVO for indicado (sem qualquer outra opção) como um nome de árvore genealógica ou como pasta do banco de dados, ela será aberta e iniciada uma sessão interativa. Se ARQUIVO for um formato compreendido pelo Gramps, será criada uma árvore genealógica vazia com o nome baseado no ARQUIVO e os dados são importados para ela. As demais opções serão ignoradas. Esta forma de execução é apropriada para usar o Gramps como manipulador de dados genealógicos em, por exemplo, navegadores Web. Este método aceita qualquer formato de dados nativo do Gramps, conforme abaixo.
-f,--format= FORMATO
Indica expressamente o formato do ARQUIVO, precedente das opções -i ou -e. Se a opção -f não for fornecida para um ARQUIVO, o formato será identificado de acordo com a sua extensão ou tipo MIME.
Os formatos disponíveis para exportação são gramps-xml (se o ARQUIVO terminar com .gramps), gedcom (se o ARQUIVO terminar com .ged) ou qualquer outro formato de arquivo disponível através do sistema de plugins do Gramps.
Os formatos disponíveis para importação são grdb, gramps-xml, gedcom, gramps-pkg (se o ARQUIVO terminar com .gpkg), e geneweb (se o ARQUIVO terminar com .gw).
Os formatos disponíveis para exportação são gramps-xml, gedcom, gramps-pkg, wft (se o ARQUIVO terminar com .wft), geneweb, e iso (deve sempre ser indicado com a opção -f).
Exibe uma lista com as árvores genealógicas conhecidas.
-u,--force-unlock
Desbloqueia um banco de dados previamente bloqueado.
-O,--open= BANCODEDADOS
Abre o BANCODEDADOS, que deve ser uma pasta de banco de dados ou um nome de árvore genealógica existentes. Se não forem indicadas opções de ação, importação ou exportação na linha de comando, será iniciada uma sessão interativa usando este banco de dados.
-i,--import= ARQUIVO
Importa os dados do ARQUIVO. Se não for indicado um banco de dados, o Gramps usará um arquivo temporário, que será excluído ao sair do programa.
Quando mais de um arquivo de origem for indicado, cada um deles deve ser precedido da opção -i. Os arquivos são importados na ordem indicada, por exemplo, -i ARQUIVO1 -i ARQUIVO2 e -i ARQUIVO2 -i ARQUIVO1 poderá produzir diferentes gramps IDs no banco de dados resultante.
Executa a AÇÃO nos dados importados. Isto será executado após a conclusão de todas as importações. Até o momento, as ações disponíveis são summary (o mesmo que Relatórios->Exibir->Resumo), check (o mesmo que Ferramentas->Processamento do banco de dados->Verificar e reparar), report (gera o relatório), e tool (executa uma ferramenta de plugin). Para o report e tool é necessário fornecer OPÇÕES (com uso da opção -p).
As OPÇÕES devem satisfazer as seguintes condições:
Não podem conter espaços. Se alguns argumentos precisam incluir espaços, a string deve ser colocada entre aspas, ou seja, seguir a sintaxe do shell. String de opção é uma lista de pares com o nome e o valor (separados por sinal de igual). Os pares de nome e valor devem ser separados por vírgula.
Muitas opções são específicas de cada relatório ou ferramenta. Entretanto, algumas opções são comuns.
Esta opção obrigatória determina qual relatório ou ferramenta será executado. Se o nome fornecido não corresponder a um relatório ou ferramenta, será exibida uma mensagem de erro seguida de uma lista de relatórios e ferramentas disponíveis (dependendo da AÇÃO).
Se o primeiro argumento da linha de comando não começar com um traço (isto é, sem uma opção), o Gramps tentará abrir o arquivo com o nome fornecido pelo primeiro argumento e iniciar a sessão interativa, ignorando o resto dos argumentos da linha de comando.
Se for fornecida a opção -O, então o Gramps tentará abrir o banco de dados indicado e trabalhar com estes dados, de acordo com as instruções dos parâmetros adicionais da linha de comando.
A ordem das opções -i, -e ou -a não importa. A ordem utilizada será sempre esta: todas as importações (se existirem) -> todas as ações (se existirem) -> todas as exportações (se existirem). Mas a abertura deve estar sempre em primeiro lugar!
Se as opções -O ou -i não forem fornecidas, o Gramps será aberto com a sua janela principal e iniciará a sessão interativa padrão com um banco de dados vazio, uma vez que não há nada a processar.
Se as opções -e ou -a não forem fornecidas, o Gramps será aberto com a sua janela principal e iniciará a sessão interativa padrão com um banco de dados resultante de todas as importações. Este banco de dados está localizado no arquivo import_db.grdb da pasta ~/.gramps/import.
Os erros encontrados durante a importação, exportação ou ação, serão direcionados para stdout (se forem exceções tratadas pelo Gramps) ou para stderr (se não forem tratadas). Use redirecionamentos usuais de stdout e stderr do shell para salvar mensagens e erros em arquivos.
Gravar o banco de dados resultante de todas as importações, indicando a opção -e (use -f se o nome do arquivo não permirtir que o gramps reconheça o formato automaticamente):
GRAMPSHOME - se definida, força o Gramps a usar a pasta indicada para armazenar as configurações e os bancos de dados do programa. Por padrão, esta variável não é definida e o Gramps assume que a pasta com todos os bancos de dados e configurações do perfil devem ser criadas na pasta do usuário (descrita na variável de ambiente HOME no Linux ou USERPROFILE no Windows 2000/XP).
Suporta um sistema de plugins baseado em Python, permitindo acrescentar importações e exportações adicionais, geradores de relatórios, ferramentas e filtros de exibição, sem modificação do programa principal.
Além da impressão direta, é possível gerar relatórios em diversos formatos de arquivo, tais como OpenOffice.org, AbiWord, HTML ou LaTeX, para permitir aos usuários a modificação de acordo com suas necessidades.
A documentação para usuários está disponível através da opção de ajuda padrão do GNOME, na forma de Manual do Gramps. O Manual também está disponível no formato XML como gramps-manual.xml em doc/gramps-manual/$LANG nas fontes oficiais da sua distribuição.
A documentação para desenvolvedores pode ser encontrada na página http://developers.gramps-project.org.
