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 datumgeboortedatum van Mary Stuart als:
  
  • ExampleVoorbeeld : <prop path="INDI:BIRT" format="{$D}"> displays  vertoont:  4 nov 1631 asals the date of birthgeboortedatum (BIRT)BIRT)

• format="$y" : displaysVertoont thealleen yearhet ofjaar, theingeval dateMary of an eventStuart:
  
  • ExampleVoorbeeld : <prop path="INDI:BIRT" format="{$y}"> displays 18761631

• format="$P" : displaysvertoont theingeval fullMary locationStuart ofals anplaats eventvan geboorte:
  
  • ExampleVoorbeeld : <prop path="INDI:BIRT" format="{$P}"> displaysvertoont: HydeSt. Park,02136,Boston,Suffolk,Massachusetts,USAJames's Palace, City of Westminster, Middlesex, Kingdom of England

• format="$p" : displaysVertoont thede cityplaats ofvan thede eventgebeurtenis.
  
  • ExampleVoorbeeld : <prop path="INDI:BIRT" format="{$p}"> displaysvertoont BostonCity of Westminster

• format="$n" : displaysIngeval thede namedoop ofvan theHenry relatedStuart, entitywordt ifvoor itde existsgerelateerde entiteit (indien aanwezig) de naam weergegeven. Dat is hier het geval, dat is dan Mary Stuart zijn jonge zuster.
  
  • ExampleVoorbeeld : <prop path="INDI:CHR:XREF" format="{$n}"> displays MarieMary STUART, thezij godmotherwas ofmeter thebij eventzijn doop. (CHR)CHR)

• format="$N" : displaysGeeft thede fullvolledige namenaam ofweer thevan relatedde entityentiteit ifals itdeze existsbestaat, voorbeeld is voor Mary Stuart.
  
  • ExampleVoorbeeld : <prop path="INDI:CHR:XREF" format="{$N}"> displaysvertoont: STUART, MarieMary (° 304 marchnov 19091631 + 1624 December 2008)1660) (I0298)

• format="$v" : displaysGeeft thehet typesoort ofgerelateerde relatedentiteit, entity(hier followeddus byde theMeter) fullgevolgd namedoor ofde thevolledige relatednaam entityvan de gerelateerde entiteit. Dus bij de doop van Henry.
  
  • ExampleVoorbeeld : <prop path="INDI:CHR:XREF" format="{$v}"> displaysvertoont: GodmotherMeter : STUART, MarieMary (° 304 marchnov 19091631 + 1624 December 2008)1660) (I0298)

• format="$V" : displaysvertoont thealleen entityhet numbernummer onlyvan de entiteit
  
  • ExampleVoorbeeld : <prop path="INDI:CHR:XREF" format="{$V}"> displaysvertoont dan:  I0298 ifvoor wehetzelfde usevoorbeeld theals same example as abovehierboven.
  • ExampleVoorbeeld : <prop path="INDI:BIRT:SOUR" format="{$V}"> displaysvertoont: S134, thedit IDis numberhet ofID-nummer thevan SOURcede entity supportingSOURce theentiteit BIRThdie eventhet BIRTh evenement bewijst.

• format="text{$e}" : displaysvertoont thede texttekst "text" ifals thede data exists,bestaat, nothinganders otherwise.wordt niets vertoond.
  
  • ExampleVoorbeeld : <prop path="INDI:NAME:SOUR" format="{(*)$e}"> displaysvertoont: (*) ifals INDI:NAME:SOUR exists,bestaat, nothinganders otherwisewordt niets vertoond.

• max="n" : limitszorgt thedat displayde tobreedte van dat wat vertoont wordt, maximaal n% ofis thevan availablede width.beschikbare Validbreedte. forGeldt anzowel imagevoor ortekst forals text.voor een afbeelding.
  
  • ExampleVoorbeeld : <prop path="INDI:NAME" max=10"> displaysvertoont thede fullvolledige namenaam, truncatedmaar toafgekapt tot 10% ofvan thede availablebeschikbare widthbreedte.

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

Other formatting possibilities

• format="$D" : displays the full date of an event
  
  • Example : <prop path="INDI:BIRT" format="{$D}"> displays 10 feb 1876 as the date of birth (BIRT)

• format="$y" : displays the year of the date of an event
  
  • Example : <prop path="INDI:BIRT" format="{$y}"> displays 1876

• format="$P" : displays the full location of an event
  
  • Example : <prop path="INDI:BIRT" format="{$P}"> displays Hyde Park,02136,Boston,Suffolk,Massachusetts,USA

• format="$p" : displays the city of the event
  
  • Example : <prop path="INDI:BIRT" format="{$p}"> displays Boston

• format="$n" : displays the name of the related entity if it exists
  
  • Example : <prop path="INDI:CHR:XREF" format="{$n}"> displays Marie STUART, the godmother of the event (CHR)

• format="$N" : displays the full name of the related entity if it exists
  
  • Example : <prop path="INDI:CHR:XREF" format="{$N}"> displays STUART, Marie (° 30 march 1909 + 16 December 2008) (I0298)

• format="$v" : displays the type of related entity followed by the full name of the related entity
  
  • Example : <prop path="INDI:CHR:XREF" format="{$v}"> displays Godmother : STUART, Marie (° 30 march 1909 + 16 December 2008) (I0298)

• format="$V" : displays the entity number only
  
  • Example : <prop path="INDI:CHR:XREF" format="{$V}"> displays I0298 if we use the same example as above
  • Example : <prop path="INDI:BIRT:SOUR" format="{$V}"> displays S134, the ID number of the SOURce entity supporting the BIRTh event

• format="text{$e}" : displays the text "text" if the data exists, nothing otherwise.
  
  • Example : <prop path="INDI:NAME:SOUR" format="{(*)$e}"> displays (*) if INDI:NAME:SOUR exists, nothing otherwise

• max="n" : limits the display to n% of the available width. Valid for an image or for text.
  
  • Example : <prop path="INDI:NAME" max=10"> displays the full name truncated to 10% of the available width

<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.