Modelos

Um modelo é um conjunto de parâmetros que permitem personalizar a exibição de uma entidade em certas janelas do Ancestris.

Janelas que utilizam modelos

Só as vistas seguintes utilizam modelos. Um exemplo permite ver a que se parecem os modelos em cada caso.

Árvore dinâmica

A árvore dinâmica utiliza os modelos para entidades e famílias. Os modelos aqui são as zonas no interior das respectivas caixas.

Cartão de entidade

O cartão de entidade utiliza os modelos para todas as categorias de entidade.

Podemos ter o mesmo modelo individual que para a árvore dinâmica. Aqui, o modelo individual é o interior do cartão de entidade

Navegador estendido

O navegador estendido utiliza os modelos para entidades individuais e familiares.

Aqui podemos ver os modelos para os indivíduos do casal seleccionado. Note que não são iguais. O modelo do cônjuge não mostra o número Sosa. Pode portanto, seleccionar diferentes modelos para cada um.

E um modelo para a família seleccionada:

Editor Gedcom

O editor Gedcom utiliza os modelos na sua zona inferior (zona de edição) para todas as categorias de entidades.

Tal como para o cartão de entidade, o editor Gedcom utiliza modelos individuais e familiares, mas também outras entidades. Por exemplo, veja aqui um modelo para a entidade Repositório:

Ou um modelo simples de uma entidade multimédia:

Agora que já vimos como é que se parecem os modelos e onde são utilizados, vejamos como funcionam.

Princípios gerais

Um modelo é uma estrutura que define o que é necessário mostrar de uma entidade e como fazê-lo.

Um modelo é atribuído a uma dada categoria de entidade (indivíduo, família, fonte, etc.) para uma dada janela (árvore dinâmica, cartão de entidade, etc.).

Pode  utilizar outros modelos além dos pré-definidos e já existentes no Ancestris.

Existem vários modelos no Ancestris e já estão previamente seleccionados para cada uma das categorias de entidades e cada janela em causa. Assim, os modelos são uma opção simples no Ancestris. É livre de os ignorar e não é obrigatório fazer quaisquer alterações aos mesmos.

Pode mesmo definir os seus próprios modelos, ou seja, por um lado, as informações a mostrar para um indivíduo ou família (nome, morada, etc.) e para uma janela, por outro, o aspecto visual destas informações (cor, tipo de letra, alinhamento, disposição, etc.).

Se quiser fazer algumas alterações aos modelos, terá de aprender um pouco mais sobre eles. Este é o objectivo do que se segue neste tópico. Tecnicamente, um modelo é também uma peça de código em formato HTML escrita num ficheiro no seu disco. Consulte o parágrafo Localização da pasta de modelos para saber mais.

Gestão dos modelos

A gestão de modelos consiste em dois tipos de actividades:

• atribuição de modelos a entidades e vistas;
• construção dos seus próprios modelos e eliminação de outros.

Esta gestão é feita utilizando a janela de gestão de modelos. Existe uma janela de gestão para cada categoria de entidade. Esta janela é a mesma, qualquer que seja o tipo de entidade em causa, com excepção dos modelos que a janela contém e da forma de acesso à janela.

Para aceder à janela de uma categoria de entidade, utilize o menu contextual do Ancestris na categoria da entidade em questão:

• clique direito do rato sobre um indivíduo, depois a acção "Seleccionar modelo para Indivíduos" para abrir a janela de gestão de modelos dos indivíduos;
• clique direito do rato sobre uma família, depois a acção "Seleccionar modelo para Famílias" para abrir a janela de gestão de modelos familiares;
• o mesmo para Notas, Fontes, Multimédia, Repositórios, etc, podendo isto ser feito a partir do cartão de entidade ou do editor Gedcom para as entidades correspondentes.

Eis como aceder à janela de gestão de modelos para indivíduos, a partir do cartão de entidade: clique direito do rato no indivíduo e depois escolha "Seleccionar modelo para Indivíduos".

Verá a janela de gestão de modelos individuais:

Qualquer que seja a categoria de entidade, o funcionamento desta janela é idêntico, pelo que faremos a descrição para o caso de um modelo individual abaixo.

Descrição

A janela de gestão de modelos contém as seguintes áreas:

• alista de modelos à esquerda mostra os modelos actualmente disponíveis para a categoria de entidade previamente seleccionada. É a partir desta lista que o utilizador é convidado a seleccionar um modelo;
• a área de antevisão no canto superior direito, que permite antever o modelo seleccionado na lista à esquerda;
• o editor HTML no canto inferior direito, que mostra o código HTML do modelo seleccionado na lista à esquerda e permite ao utilizador modificá-lo, se necessário. Se não o vir, utilize a barra de separação horizontal, deslocando-a para cima com o rato;
• uma série de botões na parte inferior:
  • o botão Novo adiciona uma cópia do modelo actualmente seleccionado na lista da esquerda e convida o utilizador a atribuir um nome a este novo modelo, que se torna então o modelo a modificar;
  • o botão Eliminar elimina o modelo seleccionado da lista;
  • o botão Inserir propriedade insere uma etiqueta no código HTML actualmente mostrado no editor HTML, na posição do cursor;
  • o botão Aceitar fecha a janela, validando as alterações;
  • o botão Cancelar fecha a janela sem validar as alterações.

Esta janela pode ser redimensionada.

A área de antevisão e a área do editor de texto podem ser ajustadas movendo o separador entre estas duas áreas com o rato ou clicando nas setas do separador no lado esquerdo das áreas:

Utilização geral

A janela cobre os seguintes requisitos:

• Consulta dos modelos disponíveis - para ver como são os diferentes modelos disponíveis sem os activar (isto é, sem fechar o painel), clique sucessivamente em cada um deles na lista à esquerda e veja o resultado na área de antevisão;
• Mudar de modelo - para atribuir um novo modelo à categoria de entidade actualmente seleccionada numa das vistas, clique no modelo desejado na lista à esquerda e valide clicando em Aceitar;
• Modificação de um modelo - por razões de segurança, os modelos que já estão disponíveis não podem ser modificados. Para modificar um modelo existente, deve primeiro fazer uma cópia do mesmo. Seleccione-o na lista à esquerda, clique em Novo e dê-lhe um novo nome. As diferentes modificações terão então de ser feitas no editor HTML;
• Novo - para criar um novo modelo, recomenda-se começar a partir de um modelo existente, seleccionando-o da lista à esquerda e depois clicar em Novo. Uma vez renomeado este novo modelo, as várias modificações terão de ser feitas no editor HTML;
• Eliminação de um modelo - para remover um modelo da lista, seleccione-o e clique no botão Eliminar. Ser-lhe-á então pedido que confirme a eliminação do modelo em questão, que será definitiva;
  • Nota: por razões de segurança, os modelos que já estão disponíveis não podem ser eliminados.

Em geral, quando estiver prestes a fechar o painel validando as possíveis modificações através do botão Aceitar, certifique-se de seleccionar previamente na lista à esquerda o modelo seleccionado para a exibição da categoria da entidade seleccionada na árvore dinâmica.

Caso prático

Suponhamos que temos um modelo simples sem fotografia para os indivíduos na árvore dinâmica e queremos inserir a sua fotografia. Os passos são os seguintes:

1. localizar onde se encontram as fotografias dos indivíduos nos dados das entidades individuais;
2. abrir a janela de gestão de modelos a partir do local onde o modelo será finalmente aplicado;
3. criar um novo modelo, copiando o modelo simples sem imagem e dando-lhe um novo nome "MeuModeloIndiArvore"Novo_Modelo_Individual_Árvore";
4. modificar o modelo para inserir a propriedade Fotografia localizada acima e ajustar o seu tamanho na moldura graças à antevisão;
5. gravar o modelo e observar o resultado.

Localizar onde se encontram as fotografias dos indivíduos

A abertura do editor Gedcom permite-lhe ver onde estão as fotografias para cada indivíduo. Pode ver que está na etiqueta INDI:OBJE:FILE. Era isto que queríamos saber.

Abrir a janela de gestão de modelos a partir do local onde o modelo será finalmente aplicado

Uma vez que queremos mudar o modelo de indivíduos para a árvore, é aqui que chamamos a janela de gestão de modelos.

Assim, a partir da árvore, clique com o botão direito do rato sobre um indivíduo. No menu contextual, escolhemos "Seleccionar modelo para Indivíduos".

Criar um novo modelo

Aparece a janela de gestão pretendida.

Como queremos criar um novo modelo, criamo-lo, por exemplo, a partir do modelo "Simples". É mais simples!

Por isso, seleccionamo-lo. Na antevisão, vemos então o que este modelo mostra para um indivíduo. Um texto simples sem fotografia. O que queremos fazer é adicionar a fotografia. Por isso, criamos uma cópia, porque não podemos modificar este. Para tal, clicamos em "Novo". Depois aparece esta janela:

Inserimos o nome do novo modelo e clicamos em Aceitar. Voltamos então à janela de gestão anterior com um novo modelo, que pode ser modificado.

Temos o novo modelo seleccionado à esquerda, a mesma antevisão no canto superior direito e o código HTML no canto inferior direito. Podemos ver que este modelo é modificável, porque os botões Eliminar e Inserir propriedade estão clicáveis.

Vamos agora alterar o código HTML para adicionar a fotografia.

Modificar o modelo

Podemos ver 4 linhas de propriedades no código HTML: nome, nascimento, óbito, profissão.

A etiqueta HTML <prop> e tudo que ela contém é uma especificação do Ancestris, que nos permite manipular os dados genealógicos no ficheiro Gedcom.

Queremos colocar a fotografia abaixo, por isso queremos inserir outra propriedade, a localizada acima: INDI:OBJE:FILE, depois das quatro já presentes. 

Colocamos o cursor sob </table>, a etiqueta que marca o fim de uma tabela.

Clicamos em Inserir propriedade. Aparece uma janela listando uma escolha de propriedades disponíveis:

Nesta janela, encontramos a linha Multimédia (OBJE), expandimo-la para fazer aparecer o seu conteúdo e vemos a linha Ficheiro (FILE). Marcamos a caixa. E clicamos em Aceitar.

Vejamos agora o que mudou:

Mas ainda não é isto, porque na antevisão pode ver-se que a imagem é demasiado grande. E talvez seja melhor colocá-lo no canto superior direito do texto.

Uma vez que o texto foi estruturado numa tabela, é necessário colocar a imagem numa caixa da tabela, a criar à direita do texto. Para o fazer, modificamos o código HTML da seguinte forma: movemos a linha que acabamos de inserir para a estrutura da tabela, adicionando uma célula através das etiquetas <td> e </td>.

Como também queremos limitar o tamanho da imagem, adicionamos uma especificação do Ancestris: "max = 20" no final, dentro da etiqueta <prop ... >, o que significa limitar o tamanho da imagem a 20% da largura disponível. A antevisão muda à medida que se altera o código. O que é muito útil e permite ver imediatamente se o que está a fazer está correcto. Uma vez alterado o código, a antevisão já parece correcta e a janela tem o seguinte aspecto:

O código realçado em azul fez o seu papel: a fotografia está agora numa célula da tabela e limitada a 20% da largura.

SauvegarderGravar leo calquemodelo ete observerobservar leo résultatresultado

OnPodemos peutgravar. sauvegarder.Clique Onem cliqueAceitar sure OKvoltará età onárvore regardedinâmica. enO mêmemodelo tempsindividual l'arbre dynamique. Le calque se modifie.modifica-se.

C'estEstá bon,bom, ontemos aquilo que queríamos, para o Senhor e para a ce qu'on voulait, pour Monsieur, et pour Madame !Senhora!

PourPara allerir plusmais loinlonge

BienEvidentemente, sûr,a leparte plusmais durdifícil resteainda doncé conhecer a linguagem HTML por um lado e conhecer as especificidades acrescentadas pelo Ancestris para manipular dados genealógicos, por outro.

Quanto à connaîtrelinguagem leHTML, langageexistem muitas páginas para o ajudar.

Quanto às especificidades do Ancestris, as etiquetas adicionadas ao HTML d'un part, et à connaître les spécificités ajoutées par Ancestris pour manipuler les données généalogiques.

Pour ce qui est du langage HTML de nombreux sites existent pour vous aider.

Pour ce qui est des spécificités Ancestris, les balises ajoutées au HTML sontsão:

• <prop> ou <ifvalue>;
• <name> ou <i18n>;
• <mediamark>.

LesOs paragraphesparágrafos suivantsseguintes tententtentam de vous les indiquer tous. explicá-las.

BaliseEtiquetas <prop> ou <ifvalue>

<prop | ifvalue    path="path:to:propcaminho:para:propriedade"    [default="path:to:other:propcaminho:para:outra:propriedade"]    [format="formatformato"]    [max="n"]    [img="yes"]    [txt="no"]>

AfficheMostra laa propriétépropriedade deda l'entitéentidade définiedefinida parpelo le chemin (path)caminho. SiSe unfor autreindicado cheminoutro est indiquécaminho, c'esté celuieste quio estutilizado utilisése sia laprimeira premièrepropriedade propriéténão n'estfor pas trouvé.encontrada.

Les paramètre format ete max sontsão expliquésexplicados ci-dessous.abaixo.

LeO paramètreparâmetro img peutpode êtreser misdefinido àcomo 'yes'"yes" ou à"no" 'no'para pourmostrar affichero leícone pictoda depropriedade. laA propriété.pré-definição Paré défaut, c'est 'no'"no".

LeO paramètreparâmetro txt peutpode êtreser misdefinido àcomo 'yes'"yes" ou à"no" 'no'para pour afficher la propriétémostrar ou non.não Para défaut,propriedade. c'estA 'yes'pré-definição é "yes".

LesOs paramètresparâmetros entre crochetsparênteses sontrectos facultatifs.são opcionais.

CasCaso desdos nomsnomes (propriétépropriedade NAME)

PourPara personnaliserpersonalizar l'affichagea duexibição nom,do onnome, peutpodemos utiliserutilizar lesas sous-propriétéssuas du nom.sub-propriedades.

ExemplePor :exemplo: <prop path=INDI:NAME > dit : <prop path=INDI:NAME:NICK> afficheramostrará leo nomnome completcompleto, suiviseguido dudo surnom.diminutivo.

Exemple :Assim: DUPONT dit : DUDUCHE

CasCaso desdos lieuxlocais (propriétépropriedade PLAC)

IlÉ estpossível possibleforçar deprecisamente forcera précisément le niveaujurisdição que l'ondesejamos veutver voirnos affichélocais. pourA unsintaxe lieu.

da

Lalinha syntaxea deinserir lano ligne à mettre dans l'éditeureditor HTML esté decomo lase forme suivantesegue:

<prop path=INDI:BIRT:PLAC format="2 (7)">

oùonde 2 ete 7 sontsão lesos rangsordinais desdas juridictionsjurisdições, danstal lacomo définitiondefinidas duno formatformato desdos lieux.

locais.

Exemple,Por supposonsexemplo, suponhamos que nosos lieuxnossos soientlocais formatésestão commeformatados suitcomo dansse l'étiquettesegue PLACna etiqueta PLAC:

Village,Local, Ville,Código postal, Code_Insee,Freguesia, Code_Postal,Concelho, Département,Distrito, Région,Região, PaysPaís

PourPara savoirsaber leo rang,ordinal, oncontamos comptecomeçando à partir deem 1, doncdonde 2 esté lao Ville,código etpostal e 7 esto le pays.país.

DansNeste cecaso, cas,podemos ondizer peut dire queque:

• <prop path=INDI:BIRT:PLAC format="2 (7)"> afficheramostrará VilleCódigo postal (Pays)País)
• <prop path=INDI:BIRT:PLAC format="2, 1"> afficheramostrará Ville,Código Villagepostal, Local
• <prop path=INDI:BIRT:PLAC format="2 (5)"> afficheramostrará VilleCódigo postal (Département)Distrito)

AutresOutros cascasos de formatageformatação

• format="$D" : affichemostra laa datedata complètecompleta d'unde événementum evento;
  • Exemple :Exemplo: <prop path="INDI:BIRT" format="{$D}"> afficheramostrará 10 fév 1876.;

• format="$y" : affichemostra l'annéeo ano da data de laum date d'un événementevento;
  • Exemple :Exemplo: <prop path="INDI:BIRT" format="{$y}"> afficheramostrará 1876.;

• format="$P" : affichemostra leo lieulocal completcompleto d'unde événementum evento;
  • Exemple :Exemplo: <prop path="INDI:BIRT" format="{$P}"> afficheramostrará Lyon, 69002, Rhône, FranceFrance;.

• format="$p" : affichemostra laa villefreguesia de l'événementum evento:
  • Exemple :Exemplo: <prop path="INDI:BIRT" format="{$p}"> afficheramostrará LyonLyon;.

• format="$n" : affichemostra leo nomnome deda l'entitéentidade liéeligada, sise elle existeexistir:
  
  • Exemple :Exemplo: <prop path="INDI:CHR:XREF" format="{$n}"> afficheramostrará Marie STUART, laa marrainemadrinha dude baptème.baptismo;

• format="$N" : affichemostra leo nomnome completcompleto deda l'entitéentidade liéeligada, sise elle existeexistir:
  
  • Exemple :Exemplo: <prop path="INDI:CHR:XREF" format="{$N}"> afficheramostrará STUART, Marie (° 30 mars 1909 + 16 décembre 2008) (I0298).;

• format="$v" : affichemostra leo nomnome completcompleto deda l'entitéentidade liéeligada, sise elleexistir existecom aveca sasua naturenatureza:
  
  • Exemple :Exemplo: <prop path="INDI:CHR:XREF" format="{$v}"> afficheramostrará Marraine : STUART, Marie (° 30 mars 1909 + 16 décembre 2008) (I0298).;

• format="$V" : affichemostra lesó numéroo d'entiténúmero uniquementde entidade:
  • Exemple :Exemplo: <prop path="INDI:CHR:XREF" format="{$V}"> afficheramostrará I0298 si l'on reste dans l'exemple ci-dessus.;
  • Exemple :Exemplo: <prop path="INDI:BIRT:SOUR" format="{$V}"> afficheramostrará S134, l'identifianto identificador da fonte de la source de la naissance.nascimento;

• format="texttexto{$e}" : affichemostra leo textetexto "texttexto" sise laos donnéedados existe,existirem, riennada sinon.se não;
  
  • Exemple :Exemplo: <prop path="INDI:NAME:SOUR" format="{(*)$e}"> afficheramostrará (*) sise INDI:NAME:SOUR existe, riennada sinon.se não;

• max="n" : limitelimita l'affichagea àexibição a n% deda lalargura largeurdisponível. disponible.Válido Valablepara pour une imageimagens ou pour du texte.texto;
  
  • Exemple :Exemplo: <prop path="INDI:NAME" max=10"> afficheramostrará leo nomnome completcompleto tronquétruncado àa 10% deda lalargura largeur disponible.disponível.

BaliseEtiqueta <media>

<media    [path="path:to:mediacaminho:para:multimédia"]    [max="n"]>

AfficheMostra un mediamultimédia de l'entité.uma Sientidade. unSe cheminfor estindicado indiquéum (path)caminho, leé mediautilizada correspondanta est utilisé sinon le premier mémultimédia trouvécorrespondente, estcaso affiché.contrário, é mostrada a primeira encontrada.

LeO paramètreparâmetro "max" limitelimita lao tailletamanho enda largeurlargura, commecomo ci-dessus.acima.

LesOs paramètresparâmetros entre crochetsparênteses sontrectos facultatifs.são opcionais.

BaliseEtiqueta <name> ou <i18n>

<name|i18n   [tag="tagetiqueta"]  [path="path:to:propcaminho:para:propriedade"]   [entity="tagetiqueta"]  >

AfficheMostra leo nomnome deda l'étiquetteetiqueta donnéedada par tag, path ou entity.

Il faut spécifier un des 3 attributs. por tag est prioritaire sur , path, qui est prioritaire sur ou entity.

ExempleTem :de especificar um dos três atributos. tag tem prioridade sobre path, que tem prioridade sobre entity.

Exemplos:

• <name   tag="NAME"> affichera mostrará NomNome.
• <name   path="INDI:NAME"> affichera mostrará NomNome.
• <name   entity="SUBM"> affichera mostrará Fournisseur d'informationInvestigador.

 

Répertoire contenant les calques

Les calques sont sauvegardés dans le Répertoire utilisateur, dans un sous-répertoire dénommé "ancestris/blueprints".

Le répertoire blueprints, contient lui-même plusieurs sous-répertoires, chacun d'eux ayant l'intitulé de l'étiquette correspondant à l'entité concernée : c'est dans chacun de ces sous-répertoires que se trouvent les différents calques.

• INDI pour les calques des entités individus
• FAM pour les calques des entités familles
• OBJE pour les calques des entités élément multimédias
• NOTE pour les calques des entités notes
• SOUR pour les calques des entités sources
• SUBM pour les calques des entités fournisseurs d'informations
• REPO pour les calques des entités dépôts

Comme ce sont des fichiers au format HTML, vous pouvez les ouvrir avec votre navigateur internet favori.

 

Et vous pouvez même les partager sur la communauté Ancestris ! Merci par avance.

 

 

B-A BA

Il existe un B-A-BA pédagogique sur les calques au format PDF. Vous pouvez le télécharger.