Skip to main content

Blauwdrukken - Blueprints

Een blauwdruk is een sjabloon dat wordt gebruikt om de weergave van een entiteit in bepaalde vensters van Ancestris aan te passen.

Vensters die blauwdrukken gebruiken

Alleen de volgende vensters gebruiken blauwdrukken. Voor elk van hen laat een voorbeeld zien hoe de blauwdrukken eruit zouden kunnen zien. Deze vensters zijn:
  • Stamboom overzicht (de stamboom als boomstructuur).
  • Entiteiten kaart.
  • De (uitgebreide) Navigator.
  • De Gedcom editor.
Stamboom overzicht
Het stamboom overzicht maakt gebruik van blauwdrukken voor individuen en gezinnen. Blauwdrukken zijn de gebieden die binnen de gekleurde kaders worden weergegeven.
nl-blueprints-tree.png
U gaat naar het stamboom overzicht via het menu "Beeld - Stamboom overzicht":
nl-blueprints-tree-menu.png

Entiteits kaart 

De Entiteitskaart gebruikt blauwdrukken voor alle categorieën entiteiten.

Blauwdrukken kunnen voor verschillende weergaven worden hergebruikt. Hier wordt de blauwdruk die wordt gebruikt voor individuen in het stamboom overzicht, gebruikt in de Entiteitskaart.

nl-blueprints-card.png

U gaat naar de entiteitskaart via het menu "Beeld - Entiteitskaart".
nl-blueprints-card-menu.png

Uitgebreide navigator


De Uitgebreide Navigator gebruikt blauwdrukken voor zowel individuen als gezinnen.

Hieronder staan ​​blauwdrukken die worden gebruikt voor de individuen van het geselecteerde paar. U merkt misschien dat ze niet hetzelfde zijn. De blauwdruk van de echtgenoot geeft niet het Sosa-nummer weer en geeft het entiteitsnummer weer boven de naam.
nl-blueprints-extended-navigator.png
En dit is de blauwdruk voor elk kind van de geselecteerde familie.
nl-blueprints-extended-navigator-family.png
U gaat naar de uitgebreide navigator via het menu "Beeld - Navigator".
nl-blueprints-extended-navigator-menu.png

Gedcom editor

De Gedcom Editor gebruikt blauwdrukken in het onderste gedeelte voor alle entiteitscategorieën.

Wat betreft de entiteitskaart, de Gedcom Editor gebruikt blauwdrukken voor individuen of families, maar ook voor andere entiteiten.

Hier is bijvoorbeeld een eenvoudige blauwdruk van een Repository-entiteit.

nl-blueprints-gedcom-repository.png

Of een eenvoudige blauwdruk van een multimedia-entiteit.

nl-blueprints-gedcom-multimedia.png

Nu u heeft gezien hoe blauwdrukken eruit zien en waar ze worden gebruikt, gaan we kijken hoe ze werken.

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

Als u enkele wijzigingen wilt aanbrengen in de beschikbare blauwdrukken, moet u er wat meer over leren. Dit is het onderwerp van de volgende paragrafen op deze pagina.

Technisch gezien is een blauwdruk een stukje HTML-code dat in een bestand op uw schijf is geschreven. Raadpleeg de paragraaf Directory met blauwdrukkenbestanden voor meer informatie.

Blauwdrukken beheren

Het beheren van blauwdrukken bestaat uit het uitvoeren van twee soorten activiteiten.

  • blauwdrukken toewijzen aan entiteiten en weergaven
  • eigen blauwdrukken maken of verwijderen

Dit wordt gedaan met behulp van het blauwdrukvenster.

Het blauwdrukvenster beheert de blauwdrukken voor één entiteitscategorie tegelijk.

Het venster is hetzelfde, ongeacht de entiteitscategorie, maar het bevat alleen blauwdrukken die zijn gekoppeld aan de gegeven entiteitscategorie.

Om toegang te krijgen tot het Blueprint-venster voor een bepaalde entiteitscategorie, moet u het Ancestris-contextmenu van een entiteit van de overeenkomstige categorie gebruiken. Als volgt:

  • Persoon: Klik met de rechtermuisknop op een persoon in de Entiteitskaartweergave en selecteer vervolgens "Weergave van personen wijzigen" om het blauwdrukvenster voor een persoon te openen.
  • Familie: Klik met de rechtermuisknop op een familie in de Entiteitskaartweergave en selecteer vervolgens "Wijzig weergave van families" om het blauwdrukvenster voor families te openen.
  • Overig: Idem voor Notes, Sources, Multimedia, Repositories, enz. Dit kan worden gedaan vanaf de Entity-kaart of de Gedcom Editor voor de overeenkomstige entiteiten.

Hier ziet u hoe u toegang krijgt tot het blauwdrukvenster voor individuen, vanuit de entiteitskaart, klik met de rechtermuisknop, en uit het contextmenu kiest u "Weergave van personen wijzigen".
nl-blueprints-context-menu.png
Dan opent het blauwdruk venster voor personen:
nl-blueprints-manager.png
Wat de entiteitscategorie ook is, de bewerkingen in dit venster zijn hetzelfde.

In de nu volgende beschrijving, gebruiken we het voorbeeld van het blauwdrukvenster voor personen.

Beschrijving


De grootte van het Blauwdruk-venster kan worden gewijzigd door aan de rechter benedenhoek te trekken.

Het voorbeeldgebied en het teksteditor-gebied kunnen worden aangepast door de scheidingsbalk van deze twee gebieden met de muis te verplaatsen of door op de pijlen aan de linkerkant van de scheidingsbalk te klikken:

nl-blueprints-manager-html.png

Als u hierop klikt, opent het HTML-editor gedeelte, de indeling is dan de volgende:
Het Blauwdruk-venster bevat de volgende gebieden.

  • De lijst met blauwdrukken aan de linkerkant, toont de blauwdrukken die momenteel beschikbaar zijn voor de eerder geselecteerde entiteitscategorie. Om aan een blauwdruk te werken, selecteert u deze in de lijst.
  • Het voorbeeldgebied rechtsboven toont een voorbeeld van de blauwdruk die in de lijst is geselecteerd.
  • De HTML-editor rechtsonder geeft de HTML-code weer van de blauwdruk die is geselecteerd in de lijst aan de linkerkant, en waarvan u de code kunt bewerken. De horizontale scheidingsbalk onder het voorbeeldgebied moet met de muis omhoog worden gesleept om de onderstaande code te zien.
  • Betekenis van de knoppen:
    • De knop Nieuw voegt een kopie van de momenteel geselecteerde blauwdruk toe aan de lijst en vraagt ​​u een andere naam in te voeren. Dit wordt de nieuw geselecteerde blauwdruk en u kunt deze wijzigen.
    • De knop Verwijderen verwijdert de geselecteerde blauwdruk uit de lijst
    • De knop Eigenschap invoegen... verschijnt wanneer u HTML-code bewerkt. Gebruik het om een ​​TAG in de HTML-code in te voegen. Het zal het invoegen op de cursorpositie.
    • De knop OK valideert de wijzigingen en verlaat het venster.
    • De knop Annuleren sluit het venster zonder de wijzigingen te valideren.

Gebruik

Het Blauwdruk-venster voorziet in de volgende behoeften:

  • Bekijk de beschikbare blauwdrukken. Om de beschikbare blauwdrukken te bekijken zonder ze te activeren (dus zonder het paneel te sluiten), klikt u achtereenvolgens op elk ervan in de lijst aan de linkerkant en controleert u het resultaat in het voorbeeldgebied.
  • Kies een andere blauwdruk. Om een ​​andere blauwdruk toe te wijzen aan de momenteel geselecteerde entiteitscategorie in een van de weergaven, klikt u op een blauwdruk in de lijst en bevestigt u deze keuze door op de knop OK te drukken.
  • Wijzig een blauwdruk. Om veiligheidsredenen kunnen de standaard beschikbare blauwdrukken niet worden gewijzigd. Om een ​​bestaande blauwdruk te wijzigen, moet u er eerst een kopie van maken. Selecteer de juiste in de lijst, klik op Nieuw en geef de blauwdruk een nieuwe naam. Gebruik vervolgens het HTML-editorpaneel om uw wijzigingen aan te brengen.
  • Maak een nieuwe blauwdruk. Om een ​​nieuwe blauwdruk te maken, is het raadzaam om een ​​bestaande blauwdruk te kopiëren. Zie hierboven.
  • Een blauwdruk verwijderen. Om een ​​blauwdruk te verwijderen, selecteert u deze in de lijst en klikt u op de knop Verwijderen. U wordt vervolgens gevraagd om de verwijdering te bevestigen, daarna die definitief is. Opmerking: om veiligheidsredenen kunnen blauwdrukken die standaard bij Ancestris worden meegeleverd, niet worden verwijderd.

Een praktijk voorbeeld

Stel dat we een eenvoudige blauwdruk hebben zonder foto, voor de individuen in de dynamische stamboom, en we willen een foto invoegen. De stappen om dit te doen zijn de volgende:

  1. Bepaal waar de foto zich bevindt in de gegevens van het individu. Gebruik daarvoor de Gedcom-editor.
  2. Open het blauwdrukvenster voor personen.
  3. Maak een nieuwe blauwdruk door 'eenvoudige blauwdruk' zonder afbeelding te kopiëren. Hernoem het 'MyBlueprint-Indi-Tree'
  4. Pas de blauwdruk aan om de hierboven geïdentificeerde foto-eigenschap in te voegen en pas de grootte in het frame aan met behulp van het voorbeeld
  5. Sla de blauwdruk op en controleer het resultaat

Elk van deze 5 stappen wordt hieronder beschreven.

1. Bepaal waar de foto zich bevindt


De Gedcom-editor laat zien waar de foto's zich bevinden voor alle personen.
We zien hieronder dat de foto zich bevindt in de FILE-tag, gekoppeld aan de OBJE-tag, die zelf is gekoppeld aan de INDI-tag.

nl-blueprints-photo.png

We zien dat de fotobestanden op het adres "INDI:OBJE:FILE" staan. (Hoofdtag INDI, dan subtag OBJE en dan subtag FILE)
Dat is wat we wilden weten.

2. Open het blauwdrukvenster voor personen

Omdat we de blauwdruk voor Individuen in het stamboom overzicht willen wijzigen, moeten we eerst een individu in het stamboom overzicht selecteren.
nl-blueprints-change-display.png

Vervolgens klikken we met de rechtermuisknop op het individu. In het contextmenu dat verschijnt, kiezen we voor "Weergave van personen wijzigen".


3. Maak een nieuwe blauwdruk

Het blauwdruk venster voor personen opent:

nl-blueprints-simple.png


Omdat we een nieuwe blauwdruk willen maken uitgaande van de "Eenvoudige" blauwdruk, maken we eerst een kopie van de "Eenvoudige" Blauwdruk.

Om dit te doen, selecteren we de blauwdruk in de lijst aan de linkerkant. Vervolgens zien we in het voorbeeld wat deze blauwdruk voor een individu weergeeft: eenvoudige tekst zonder foto. Wat we willen doen is de foto van het individu toevoegen.

Vervolgens klikken we op "Nieuw". Ancestris vraagt ​​de naam van de nieuwe blauwdruk:
nl-blueprints-new.png

We typen "MijnBlueprint-Indi-Stamboom" en drukken op OK.

Dan komen we terug in het vorige blauwdrukvenster, maar nu met een nieuwe bewerkbare blauwdruk. (Eventueel de HTML code opentrekken zoals hierboven uitgelegd)

nl-blueprints-myblueprint.png

We hebben de nieuwe blauwdruk geselecteerd in de lijst aan de linkerkant, hetzelfde voorbeeld rechtsboven, en de HTML-code staat rechtsonder.

We zien dat deze blauwdruk bewerkbaar is, omdat de knoppen "Verwijderen" en "Eigenschap invoegen..." zichtbaar en ingeschakeld zijn.

We zullen nu de HTML-code wijzigen zodat de foto wordt weergegeven..

4. Pas de blauwdruk aan


nl-blueprints-myblueprint-3.png

We kunnen zien dat er 4 regels met eigenschappen in de HTML-code staan: naam, geboorte, overlijden, beroep.

Merk op dat deze eigenschappen met Engelse tekst worden weergegeven.


De HTML <prop>-tag, (zoals bij rode pijl) en alles erin, is specifiek voor Ancestris. Dit maakt het mogelijk om de genealogische gegevens van het Gedcom-bestand te manipuleren.

We willen de foto onder aan het scherm plaatsen, dus voegen we een andere eigenschap in, de hierboven geïdentificeerde eigenschap, INDI:OBJE:FILE, deze komt na de 4 eigenschappen die al worden weergegeven.

We plaatsen daarom de cursor onder </table>, dat is namelijk het label dat het einde van een tabel markeert. (bij de blauwe pijl)

Daarna drukken we op de knop "Eigenschap invoegen...". Er verschijnt een venster met een keuze uit mogelijke eigenschappen (het linkervenster hieronder).

nl-blueprints-myblueprint-insert.png nl-blueprints-myblueprint-insert-2.png

In dit venster vinden we de regel Multimedia OBJE, we vouwen de flap open om de inhoud van OBJE weer te geven en we zien de regel FILE. We vinken het vakje aan bij FILE, zoals in het rechter screenshot hierboven. En we klikken op "OK".

We zien nu dat de preview is veranderd, de foto is erbij gekomen.
nl-blueprints-myblueprint-inserted.png


Maar het is nog niet af, want in de preview ziet u dat de foto te groot is. En ook wij zijn van gedachten veranderd. We willen de foto in de rechterbovenhoek van de tekst plaatsen en niet onder de tekst.

Omdat de tekst in een tabel is gestructureerd, is het in feite nodig om de afbeelding in een nieuwe cel (vakje) in de tabel te plaatsen, en wel een cel rechts van de reeds bestaande tekst. Om dit te doen, passen we de HTML-code als volgt aan:
we verplaatsen de regel die we zojuist in de tabelstructuur hebben ingevoegd door een cel toe te voegen met behulp van de <td> </td>-tags.

Omdat we ook de grootte van de afbeelding willen beperken, voegen we een Ancestris-specificiteit toe: we voegen "max = 20" toe aan het einde, binnen de tag <prop ...>, wat betekent dat we de fotogrootte beperken tot 20% van de beschikbare breedte.
Het voorbeeld verandert wanneer u de code wijzigt. Dit is handig want het laat u meteen zien of wat u doet goed is. Zodra de code is gewijzigd, ziet het voorbeeld er correct uit en ziet het venster er zo uit.

nl-blueprints-myblueprint-updated.png

Voor de duidelijkheid, vooral voor degenen die niet gewend zijn aan HTML code, is deze afbeelding gekleurd, als volgt:
  • De gehele tabel staat tussen de HTML-tags <table>   en   </table>, deze tags zijn in blauw. Merk op dat de zogenoemde "sluit"-tag van de tabel, begint met een schuine streep, de slash, dat geldt voor elke sluit-tag!! (We kijken hierbij even niet naar de extra tekst "width=100%" die in de eerste <table> tag staat.)
  • De tabel bevat 1 regel, namelijk tussen de HTML-tags <tr>   en   </tr>, deze zijn in roze. Ook hier weer die slash bij de sluit-tag!
  • De originele tekst van de blauwdruk staat tussen de HTML-tags voor een cel, nl tussen <td>   en   </td>, hier in groen weergegeven. (<br> betekent: Break, oftewel begin op een nieuwe regel)
  • Onze wijzigingen staan in een nieuwe cel, binnen dezelfde roze regel als de vorige cel, ook tussen  <td>   en   </td>, deze nieuwe cel is in geel aangegeven. Er zijn nu dus twee cellen, de groene en de gele, beide binnen één en dezelfde roze regel.
De code in het geel doet zijn werk: de foto staat in een vakje rechts van de andere tekst, maar op dezelfde regel van de tabel.
Bovendien is de foto beperkt tot 20% van de breedte.



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 nl-tree-view.png stamboom overzicht. De blauwdruk verandert:

nl-blueprints-tree-new.png

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

Nog een stap verder

Het moeilijkste deel blijft natuurlijk om aan de ene kant HTML te kennen en aan de andere kant de specifieke kenmerken te onthouden die door Ancestris zijn toegevoegd om uw genealogische gegevens te kunnen verwerken.

Wat de HTML-taal zelf betreft, zijn er veel websites die u kunnen helpen. vergeet daarom niet de bovengenoemde web pagina van w3schools te bezoeken.

Met betrekking tot de specifieke toevoegingen van Ancestris vind u hier de tags die aan de HTML zijn toegevoegd. Let wel deze gelden alleen binnen Ancestris. Deze tags zijn:

  1. <prop> of <ifvalue>
  2. <naam> of <i18n>
  3. <media>
  4. <mark>
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".
In de volgende 4 secties wordt beschreven hoe u deze speciale Ancestris tags kunt gebruiken..


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"]>

Deze Ancestris tag geeft de eigenschap (property) weer, van de entiteit die wordt aangegeven door het pad (path). Als er ook een default-pad is opgegeven, wordt dat default pad gebruikt als de eerste eigenschap(property) niet wordt gevonden.

Als er meerdere eigenschappen zijn, kan een volgorde-nummer in het pad worden aangegeven met behulp van "?i", waarbij i het volgnummer is van de eigenschap is. Na dit nummer kan de rest van het pad worden opgegeven, indien aanwezig. Zie bijvoorbeeld verderop op deze pagina, het voorbeeld met de beroepen.

De format en max parameters worden hieronder uitgelegd.

De parameter img kan worden ingesteld op "yes" of "no" om het pictogram van de eigenschap weer te geven. Standaard is dit "no".

De txt-parameter kan worden ingesteld op "yes" of "no" om de naam van de eigenschap al dan niet weer te geven. Standaard is "yes".

Parameters tussen vierkante haken zijn optioneel.

U kunt ofwel "prop" of "ifvalue" gebruiken.


A.  De naam property (NAME property)
Om de weergave van de naam aan te passen, kunt u de naam sub-eigenschappen gebruiken.

Voorbeeld:
<prop path=INDI:NAME > a.k.a <prop path=INDI:NAME:NICK>

Er staan hier dus 2 prop-tags achter elkaar met een stukje gewone tekst "a.k.a." ertussen. Dit geeft de volledige naam (1e prop-tag) en de bijnaam (2e prop-tag) weer. Voorbeeld voor John Kennedy als individu wordt dan:
John F. Kennedy a.k.a. Jack


B.  De plaats property (PLAC property)
Het is mogelijk om door middel van één of meer nummers, die jurisdicties op te geven, die u voor een plaats wilt vertonen.

De syntax van de regel die in de HTML-editor moet worden opgegeven, kan er dan bijvoorbeeld zo uitzien:

<prop path=INDI:BIRT:PLAC format="1 (4)">

waarbij 1 en 4 de jurisdictie posities zijn, in de definitie van de plaats criteria (zie Bestand/Eigenschappen).

Voorbeeld: ervan uitgaande dat al onze plaatsen het volgende formaat volgen (volgens de PLAC-tag in het Gedcom-bestand of in "Bestand - Plaats jurisdicties bewerken" ):

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)
In het geval van een property die meerdere malen kan voorkomen, is het mogelijk om de volgorde van deze getoonde eigenschap op te geven.

De syntaxis van de regel die in de HTML-editor moet worden geplaatst, is de volgende
<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 nl-tree-view.png bijvoorbeeld als volgt kunnen uitzien:

nl-blueprint-occupations.png


D.  Andere opmaak mogelijkheden

Gebruikte gegevens in onderstaande voorbeelden komen van Wikipedia:

nl-blueprint-mary-stuart.png nl-blueprint-henry-stuart-2.pngnl-blueprint-henry-stuart-2.png nl-blueprint-henry-stuart-1.png



  • 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, MarieMary304 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, MarieMary304 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 tagpath 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:

mark_exemple.png


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.

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.