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](#bkmrk-r%C3%A9pertoire-contenant "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". [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_entity_context_menu.png) Verá a janela de gestão de modelos individuais: [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_indi_blueprint.png) 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: - **a lista 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](https://docs.ancestris.org/books/manual-do-utilizador/page/as-etiquetas "As etiquetas") 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: ### [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_HTML.png)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 "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. [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_INDI_OBJE_FILE.png) #### 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". [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_tree_context_menu.png) #### Criar um novo modelo Aparece a janela de gestão pretendida. [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_create_new.png) 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: [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_create_new_file_name.png) 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. [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_new_modifiable.png) 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: [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_create_new_insert_tag.png) 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: [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_create_new_tag_end.png) 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: [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_create_new_tag_size.png) 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. #### Gravar o modelo e observar o resultado Podemos gravar. Clique em **Aceitar** e voltará à árvore dinâmica. O modelo individual modifica-se. [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_new_family.png) Está bom, temos aquilo que queríamos, para o Senhor e para a Senhora! ### Para ir mais longe Evidentemente, a parte mais difícil ainda é conhecer a linguagem HTML por um lado e conhecer as especificidades acrescentadas pelo Ancestris para manipular dados genealógicos, por outro. Quanto à linguagem HTML, existem muitas páginas para o ajudar. Quanto às especificidades do Ancestris, as etiquetas adicionadas ao HTML são: - <prop> ou <ifvalue>; - <name> ou <i18n>; - <mark>. Os parágrafos seguintes tentam explicá-las. #### Etiquetas <prop> ou <ifvalue><prop | ifvalue path="*caminho:para:propriedade*" \[default="*caminho:para:outra:propriedade*"\] \[format="*formato*"\] \[max="*n*"\] \[img="yes"\] \[txt="no"\]>
Mostra a propriedade da entidade definida pelo *caminho*. Se for indicado outro *caminho*, é este o utilizado se a primeira propriedade não for encontrada. Para **múltiplas propriedades**, pode ser indicada uma posição no caminho usando "?i", onde i é a posição da propriedade. Após este número, pode indicar o resto do caminho, se o houver. Veja o exemplo abaixo com as profissões ***format*** e **max** são explicados abaixo. O parâmetro ***img*** pode ser definido como "yes" ou "no" para mostrar o ícone da propriedade. A pré-definição é "no". O parâmetro ***txt*** pode ser definido como "yes" ou "no" para mostrar ou não a propriedade. A pré-definição é "yes". Os parâmetros entre parênteses rectos são opcionais. ##### Caso dos nomes (propriedade NAME) Para personalizar a exibição do nome, podemos utilizar as suas sub-propriedades. Por exemplo: `<media \[path="*caminho:para:multimédia*"\] \[max="*n*"\]>
Mostra multimédia de uma entidade. Se for indicado um *caminho*, é utilizada a multimédia correspondente, caso contrário, é mostrada a primeira encontrada. O parâmetro "max" limita o tamanho da largura, como acima. Os parâmetros entre parênteses rectos são opcionais. #### Etiqueta <name> ou <i18n><name|i18n \[tag="*etiqueta*"\] \[path="*caminho:para:propriedade*"\] \[entity="*etiqueta*"\] >
Mostra o nome da etiqueta dada por **tag**, **path** ou **entity**. Tem de especificar um dos três atributos. **tag** tem prioridade sobre **path**, que tem prioridade sobre **entity**. Exemplos: - `<mark path="*caminho:para:propriedade*" \[test="*value*"\] \[repeat="*n*"\] >
Esta etiqueta é utilizada para mostrar um marcador num modelo. O marcador é mostrado se a propriedade denotada pelo atributo **path** estiver presente para a entidade. Se o atributo **tes**t estiver presente, o marcador só será mostrado se o valor da propriedade for idêntico ao valor de **test**. O atributo **repeat** permite definir o tamanho em número de caracteres do marcador. O atributo **default** é utilizado para definir o caminho alternativo a ser apresentado se a propriedade designada por **path** não for encontrada. Se o atributo "notpresent=true" for especificado, o marcador só será apresentado se a propriedade não existir.. Por exemplo, o seguinte código permite mostrar um marcador verde em indivíduos cujo apelido é Capet e um marcador vermelho se o apelido for Habsbourg: - ``; - ``. O que resulta nos marcadores verdes e vermelhos abaixo: [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_mark_tag.png) ``: mostra uma barra de 5 caracteres quando o sexo do indivíduo é "Desconhecido": [](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_blueprints_mark_repeat_tag.png) ##### Exemplos de utilizadores Eis um exemplo de marcação fornecido por Sylvain, um utilizador, para definir um marcador de cor em função da origem de um evento. [](https://docs.ancestris.org/uploads/images/gallery/2023-04/fr-mark-user-example.png)
|
|||||||||||||||
| Complet : |