Blauwdrukken - Blueprints

Vensters die blauwdrukken gebruiken

Entiteits kaart 

Uitgebreide navigator

Gedcom editor

Algemene principes

Een blauwdruk is een sjabloon die bepaalt wat er van een entiteit moet worden weergegeven en hoe deze moet worden weergegeven.

Een blauwdruk wordt toegewezen aan een bepaalde entiteitscategorie (individu, familie, bron, enz.) voor een bepaalde weergave (dynamische boom, entiteitsbestand, enz.).

U kunt uw eigen blauwdrukken definiëren in plaats van de blauwdrukken te gebruiken die al in Ancestris aanwezig zijn.

Er bestaan al verschillende blauwdrukken ​​binnen Ancestris en deze zijn standaard al geselecteerd voor elk van de entiteitscategorieën en in elke weergave waar blauwdrukken van toepassing zijn.

Blauwdrukken vormen een manier om Ancestris aan te passen. U bent vrij om blauwdrukken te behouden zoals ze zijn of ze aan te passen aan uw behoeften.

U kunt uw eigen blauwdrukken definiëren, d.w.z. zowel de informatie die moet worden weergegeven voor een individu of een gezin (naam, adres, enz.) als wel hoe deze informatie moet worden weergegeven (kleur, lettertype, uitlijning, lay-out, enz.).

Blauwdrukken beheren

Beschrijving

Gebruik

Een praktijk voorbeeld

1. Bepaal waar de foto zich bevindt

2. Open het blauwdrukvenster voor personen

3. Maak een nieuwe blauwdruk

Het blauwdruk venster voor personen opent:

4. Pas de blauwdruk aan

Merk op dat deze eigenschappen met Engelse tekst worden weergegeven.

Meer HTML uitleg, onder andere over tabellen, met veel voorbeelden om zelf online mee te experimenteren, vindt u op w3schools HTML Tables.

5. Sla de blauwdruk op en bekijk het resultaat

We kunnen ons werk nu opslaan, en tegelijkertijd kijken we naar het stamboom overzicht. De blauwdruk verandert:

Dat ziet er goed uit, dat is wat we willen!

Nog een stap verder

Let op, de taal die wordt gebruikt binnen de HTML is altijd Engels. Bij een keuze bijvoorbeeld, staat dus "yes" en "no" en nooit "ja" of "nee".

1.     <prop> of <ifvalue> tags

<prop | ifvalue    path="path:to:prop[?i][:end:of:prop]"    [default="path:to:other:prop"]    [format="format"]    [max="n"]    [img="yes"]    [txt="no"]>

A.  De naam property (NAME property)

B.  De plaats property (PLAC property)

Gehucht, Plaats, Postcode, Provincie, Staat, Land

Dan beginnen we vanaf links te tellen te beginnen met #0. Dit is het gehucht. #1 is dan de Plaats en #4 is dan de Staat. 

Let op de lege komma na Provincie, dat is omdat wij in Nederland geen Staat hebben, alleen een provincie en daarna Land. Stel nu dat we een Nederlands gehucht hebben, bijvoorbeeld: Wateren. Dat wordt dan volledig weergegeven als:

Wateren, Westerveld, 8438SK, Drente, , Nederland

Voorbeelden van PLAC- properties, met de werkelijke uitvoer voor dit gehucht zijn dan:

• <prop path=INDI:BIRT:PLAC format="1 (3)">   Geeft als uitvoer: Westerveld (Drente)
• <prop path=INDI:BIRT:PLAC format="1, 0">  Geeft als uitvoer: Westerveld, Wateren
• <prop path=INDI:BIRT:PLAC format="1, 3, 2 - 4">  Geeft als uitvoer: Westerveld, Drente, 8438SK - Nederland

Merk op dat in het format-veld, karakters anders dan cijfers, 1 op 1 worden weergegeven. Dit geldt dus bijvoorbeeld voor de ronde haken, de komma's, de spaties die her en der staan en het minteken. Die ziet u steeds terug in de uitvoer.

C.  Properties die meermalen kunnen voorkomen zoals beroep (OCCU property)

<prop path=INDI:OCCU?2>

Het getal 2 geeft aan dat het tweede beroep van de persoon moet worden vertoond.

U kunt de laatste uit de reeks properties, hier dus beroepen, als volgt weergeven met het LAST trefwoord::

<prop path=INDI:OCCU?LAST >

Stel u wilt de datum van het tweede beroep van een persoon weergeven, dan ziet de code er zo uit:

<prop path=INDI:OCCU?2:DATE>

Het is dus mogelijk om de eerste 5 beroepen van elke persoon op deze manier weer te geven. In de standaard blauwdruk moet u dan de code wijzigen en die 5 beroeps blokken als volgt invoegen:

  <tr>
    <td valign="top">
       <prop path=INDI:OCCU?1 img=yes txt=no>&nbsp; 
       <b><prop path=INDI:OCCU?1 max=67></b>&nbsp;<br>
    </td>
  </tr>
  <tr>
    <td valign="top">
      <prop path=INDI:OCCU?2 img=yes txt=no>&nbsp;
      <b><prop path=INDI:OCCU?2 max=67></b>&nbsp;<br>
    </td>
  <tr>
  <tr>
    <td valign="top">
      <prop path=INDI:OCCU?3 img=yes txt=no>&nbsp;
      <b><prop path=INDI:OCCU?3 max=67></b>&nbsp;<br>
    </td>
  <tr>
  <tr>
    <td valign="top">
      <prop path=INDI:OCCU?4 img=yes txt=no>&nbsp;
      <b><prop path=INDI:OCCU?4 max=67></b>&nbsp;<br>
    </td>
  <tr>
  <tr>
    <td valign="top">
      <prop path=INDI:OCCU?5 img=yes txt=no>&nbsp;
      <b><prop path=INDI:OCCU?5 max=67></b>&nbsp;<br>
    </td>
  <tr>

Stel we hebben een persoon met drie beroepen, en we maken gebruik van bovenstaande code, dan zou dit er in het stamboom overzicht bijvoorbeeld als volgt kunnen uitzien:

D.  Andere opmaak mogelijkheden

Gebruikte gegevens in onderstaande voorbeelden komen van Wikipedia:

• format="$D" : Geeft bijvoorbeeld de volledige geboortedatum van Mary Stuart als:
  
  • Voorbeeld : <prop path="INDI:BIRT" format="{$D}">   vertoont:  4 nov 1631 als geboortedatum (BIRT)

• format="$y" : Vertoont alleen het jaar, ingeval Mary Stuart:
  
  • Voorbeeld : <prop path="INDI:BIRT" format="{$y}"> displays 1631

• format="$P" : vertoont ingeval Mary Stuart als plaats van geboorte:
  
  • Voorbeeld : <prop path="INDI:BIRT" format="{$P}"> vertoont: St. James's Palace, City of Westminster, Middlesex, Kingdom of England

• format="$p" : Vertoont de plaats van de gebeurtenis.
  
  • Voorbeeld : <prop path="INDI:BIRT" format="{$p}"> vertoont City of Westminster

• format="$n" : Ingeval de doop van Henry Stuart, wordt voor de gerelateerde entiteit (indien aanwezig) de naam weergegeven. Dat is hier het geval, dat is dan Mary Stuart zijn jonge zuster.
  
  • Voorbeeld : <prop path="INDI:CHR:XREF" format="{$n}"> displays Mary STUART, zij was meter bij zijn doop. (CHR)

• format="$N" : Geeft de volledige naam weer van de entiteit als deze bestaat, voorbeeld is voor Mary Stuart.
  
  • Voorbeeld : <prop path="INDI:CHR:XREF" format="{$N}"> vertoont: STUART, Mary (° 4 nov 1631 + 24 December 1660) (I0298)

• format="$v" : Geeft het soort gerelateerde entiteit, (hier dus de Meter) gevolgd door de volledige naam van de gerelateerde entiteit. Dus bij de doop van Henry.
  
  • Voorbeeld : <prop path="INDI:CHR:XREF" format="{$v}"> vertoont: Meter : STUART, Mary (° 4 nov 1631 + 24 December 1660) (I0298)

• format="$V" : vertoont alleen het nummer van de entiteit
  
  • Voorbeeld : <prop path="INDI:CHR:XREF" format="{$V}"> vertoont dan:  I0298 voor hetzelfde voorbeeld als hierboven.
  • Voorbeeld : <prop path="INDI:BIRT:SOUR" format="{$V}"> vertoont: S134, dit is het ID-nummer van de  SOURce entiteit die het BIRTh evenement bewijst.

• format="text{$e}" : vertoont de tekst "text" als de data bestaat, anders wordt niets vertoond.
  
  • Voorbeeld : <prop path="INDI:NAME:SOUR" format="{(*)$e}"> vertoont: (*) als INDI:NAME:SOUR bestaat, anders wordt niets vertoond.

• max="n" : zorgt dat de breedte van dat wat vertoont wordt, maximaal n% is van de beschikbare breedte. Geldt zowel voor tekst als voor een afbeelding.
  
  • Voorbeeld : <prop path="INDI:NAME" max=10"> vertoont de volledige naam, maar afgekapt tot 10% van de beschikbare breedte.

2.     <name> of <i18n> tag

<name|i18n   [tag="tag"]  [path="path:to:prop"]   [entity="tag"]  >

Displ

3.     <media> tag

<media    [path="path:to:media"]    [max="n"]>

Displa

4.     <mark>

<mark  path="path:to:prop"   [test="value"]   [repeat="n"]   [default="path:to:other:prop"]   [notpresent="true"]   >

Dis

<media> tag

<media    [path="path:to:media"]    [max="n"]>

Displays the media of the entity. If a path is specified, the corresponding media is used, otherwise any first media found in the entity is displayed.

The "max" parameter limits the size in width as above.

Parameters in square brackets are optional.

<name> or <i18n> tag

<name|i18n   [tag="tag"]  [path="path:to:prop"]   [entity="tag"]  >

Displays the name of the label given by tag, path or entity.

One of the 3 attributes must be specified. tag takes precedence over path, which takes precedence over entity.

Example:

• <name   tag="NAME"> displays Name
• <name   path="INDI:NAME"> displays Name
• <name   entity="SUBM"> displays Submitter

<mark>

<mark  path="path:to:prop"   [test="value"]   [repeat="n"]   [default="path:to:other:prop"]   [notpresent="true"]   >

Displays a square marker on a blueprint.

The marker is only displayed if the indicated property (path) exists in the entity, and if the value of the property is the same as the value of the "test" attribute.

The repeat attribute is optional and specifies the number of times the marker should be repeated. 

The default attribute is optional and allow to check this property if the property indicated by path doesn't exist.

The notpresent="true" parameter allow to display a marker only if the property doesn't exist.

For instance, the following code displays a green marker for individuals whose name is CAPET, and a red marker for individuals whose name is HABSBOURG.

<font color=green><mark path=INDI:NAME:SURN test=CAPET></font>

<font color=red><mark path=INDI:NAME:SURN test=HABSBOURG></font>

This results in the following view in the dynamic tree for instance:

Another example . The following code displays 5 markers for individuals whose sex is unknown.

<mark path=INDI:SEX test=Unknown repeat=5>

<mark path=INDI:BIRT:SOUR notpresent="true"> : Displays a marker if no source is defined for the birth.

Directory where blueprints files are stored

Blueprints are files of HTML codes that are stored in the User Directory, in a sub-directory called "ancestris/blueprints".

The blueprints directory itself contains several sub-directories, each of them having the title corresponding to the entity to which it applies: it is in each of these sub-directories that the different blueprints are located.

• INDI for blueprints about individuals
• FAM for blueprints about families
• OBJE for blueprints about multimedia objects
• NOTE for blueprints about notes
• SOUR for blueprints about sources
• SUBM for blueprints about submitters
• REPO for blueprints about repositoris

As these are HTML format files, you can open them with your favorite internet browser.

Feel free to share your blueprints with the Ancestris community! Thanks in advance.

Tutorial

We have written a tutorial in PDF format. It is written in French. Please feel free to download it from here.