Skip to content

Commit

Permalink
Merge pull request #10 from GlengarryAg/1.3
Browse files Browse the repository at this point in the history 
1.3
  • Loading branch information
@oldskeptic
oldskeptic authored Feb 21, 2024
2 parents 8e01638 + fff24e3 commit fcba1f4
Show file tree
Hide file tree
Showing 6 changed files with 13,677 additions and 31 deletions.
7 changes: 3 additions & 4 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,11 +1,10 @@
# beer
An OWL2 ontology about Beer, it's styles and ingredients.

Current Version: 1.2
Release Date: 2021-03-24
Current Version: 1.3
Release Date: 2024-02-21
Suggested prefix: beer
Current release: https://rdf.ag/o/beer-2021-03-24

Current release: https://rdf.ag/o/beer-2024-02-21


This is a public repository for issues pertaining to the Beer Ontology. These are the individual build files used by the
Expand Down
29 changes: 15 additions & 14 deletions docs/beer-template-en.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
<link href="css/xmlns-style.css" rel="stylesheet" type="text/css" />
<link href="css/style.css" rel="stylesheet" type="text/css" />
<link rel="mvcb:generatorAgent" type="application/rdf+xml" title="DOAP" href="https://raw.githubusercontent.com/muninn/ontology-tools/master/rdf/voidDescription.rdf" />
m4_include(googleTags.html)
m4_include(miscScripts.html)
<script id="vocab" type="application/ld+json">
m4_include(beer-ONTOLOGY_DATE.jsonld)
</script>
Expand All @@ -20,8 +20,8 @@
<body>

{_header_}
<p class="copyright">For the purposes of Copyright, this work is Copyright &#169; 2021 - Myra Analytics</p>
<p class="copyright">This work is dual-licensed under a <a href="https://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported license</a> and an additional commercial license. Please contact info@myraanalytics.ca for further details.</p>
<p class="copyright">For the purposes of Copyright, this work is Copyright &#169; 2024 - PSW Applied Research Inc.</p>
<p class="copyright">This work is dual-licensed under a <a href="https://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported license</a> and an additional commercial license. Please contact info@pswappliedresearch.com for further details.</p>

<!-- ===================================================================== -->

Expand All @@ -44,7 +44,7 @@ <h3 id="introduction">1. Introduction</h3>

<p>This ontology was created for beer traceability but also to lay the groundwork for providing standardization for beers and beer styles. This will allow brewers to have a better idea of what to expect when they brew a new batch of beer, with the hope that this ontology will help boost creativity for new beer recipes. It will also allow better relationships to form between the brewers and growers since the brewers will know exactly what they are purchasing.</p>

<p>Along with the other Myra Analytics ontologies, <a href="https://rdf.ag/">https://rdf.ag/</a>, brewers, malters and growers are able to not only provide traceability for their products but also be able to easily facilitate the sale of their products on the market.</p>
<p>Along with the other ontologies, <a href="https://rdf.ag/">https://rdf.ag/</a>, brewers, malters and growers are able to not only provide traceability for their products but also be able to easily facilitate the sale of their products on the market.</p>

<h3 id="history">2. Brief History of Beer</h3>

Expand Down Expand Up @@ -115,40 +115,40 @@ <h4 id="acme-brewery-exampls">5.1 ACME Brewery Examples</h4>

<p>As <a href="https://rdf.ag/o/beer#Brewery">beer:Brewery</a> is a class that extends <a href="https://schema.org/Organization">schema:Organization</a>, <a href="http://xmlns.com/foaf/0.1/Organization">foaf:Organization</a> and <a href="https://gs1.org/voc/Organization">gs1:Organization</a>. This allows the use of a wide ecosystem of vocabularies and the street address of the fictitious brewery is recorded with it. While many authors prefer to use blank nodes for brevity, we name nodes here so that example fragments can be related to one another while being short.</p>

importRDFExample[ACME Brewery, our local brewery example][beer/acme-brewery.owl]
importRDFExample[ACME Brewery, our local brewery example][examples/acme-brewery.owl]

<p>Our fictitious brewery brews two different beers: ACME Ale and ACME Best Stout. Within the beer ontology, a <a href="https://rdf.ag/o/beer#Beer">beer:Beer</a> is a beverage that is an instance of a beer style with a brand, name or a common manufacturer without references to quantity or packaging.</p>

<p>The Beer can be related to its parent brewery through several vocabularies such as <a href="https://schema.org/manufacturer">schema:manufacturer</a>, <a href="https://gs1.org/voc/brand">gs1:brand</a> or <a href="https://gs1.org/voc/manufacturer">gs1:manufacturer</a> or even <a href="http://purl.org/dc/terms/creator">dcterms:creator</a>. For users that simply want to record a relationship while not committing to a concrete relationship can use the beer ontology property <a href="https://rdf.ag/o/beer#brewedBy">brewedBy</a> which is easily understandable and can align with most ontological cases.</p>

importRDFExample[ACME Brewery Beers][beer/acme-brewery-beers.owl]
importRDFExample[ACME Brewery Beers][examples/acme-brewery-beers.owl]


<p>A <a href="https://rdf.ag/o/beer#BeverageProduct">Beer:BeverageProduct</a> is a <a href="https://rdf.ag/o/beer#Beer">Beer:Beer</a> that is contained within a container that can be moved or traded. In schema.org parlace, a <a href="https://rdf.ag/o/beer#Beer">Beer:Beer</a> is a <a href="https://schema.org/ProductGroup">schema:ProductGroup</a> that has <a href="https://rdf.ag/o/beer#BeverageProduct">beer:BeverageProduct</a> for <a href="https://schema.org/hasVariant">schema:hasVariant</a>s. This essentially relates the beer as an abstract product to its materialized availability as discrete consumable product by relating the <a href="https://rdf.ag/o/beer#BeverageProduct">Beer:BeverageProduct</a> to its container using a <a href="https://gs1.org/voc/package">gs1:package</a> property.<p>

<p>Thus, should our two beers be exclusively available in 473ml aluminum cans, we can define packaging properties by referencing the <a href="#can473">#can473</a> and write:</p>

importRDFExample[ACME Brewery Beers][beer/acme-brewery-products.owl]
importRDFExample[ACME Brewery Beers][examples/acme-brewery-products.owl]

<p>Each new packaging or container requires a new instance of a <a href="https://rdf.ag/o/beer#BeverageProduct">Beer:BeverageProduct</a>.</p>

<h5 id="brewery_beer">5.1 ACME Brewery with schema.org Offers</h5>

<p><a href="exampleRDF2">Example 2</a> In this example, we create a schema.org offer that will advertise that the beer is available for sale commercially. ACME brewery has an onsite sales counter that will sell individual 473ml aluminum cans of stout.</p>

importRDFExample[ACME Brewery with Offers][beer/brewery_beer.owl]
importRDFExample[ACME Brewery with Offers][examples/brewery_beer.owl]

<p>The addition of a <a href="https://schema.org/Offer">schema:Offer</a> for the can, at a price and in a specified
currency is made and the organization making the offer (the brewery) is listed along with its street location.</p>

<h4 id="germanpuritylaw">5.2 German Purity Law Beer</h4>
<p><a href="exampleRDF3">Example 3</a> The German Beer Purity Law of 1516 had strict limits on the ingredients permitted in beer: water, barley, hops and (later) yeast. The ontology can be used to record data about historical beers and commercial breweries making claims based on this style.</p>

importRDFExample[German Purity Law Beers][beer/germanbeer.owl]
importRDFExample[German Purity Law Beers][examples/germanbeer.owl]

<p>The <a href="https://www.weltenburger.de/">Weltenburg Monastery</a> Brewery, the <a href="https://www.ur-krostitzer.de/">Ur-Krostitzer</a> brand from the Radeberger Group and <a href="https://www.augustiner-braeu.de/">Augustiner-Bräu</a> is a brewery still make beer which qualifies as German Purity Law Beer.</p>

importRDFExample[Recording historical events with the beer ontology.][beer/germanbeerhistorical.owl]
importRDFExample[Recording historical events with the beer ontology.][examples/germanbeerhistorical.owl]

<p>The ontology is flexible enough to record historical event, such as <a href="https://en.wikipedia.org/wiki/Carl_von_Horn_(1847%E2%80%931923)">Karl Graf von Horn</a> drinking locally available beer. It's application to recording alcohol consumption for dietary analysis is also possible.</p>

Expand All @@ -170,10 +170,8 @@ <h3 id="reference">8. Detailed References for All Terms, Classes and Properties<

<h3 id="version_history">9. Version History</h3>

<p>Version 1.5</p>
<ul>
<li>Added <a href="https://www.w3.org/TR/prov-o/">prov</a>/<a href="https://www.w3.org/TR/owl-time/">time</a> ontology alignment according to <a href="https://www.w3.org/TR/owl-time/#time-prov">Time ontology documentation</a>.</li>
</ul>

{_changehistory_}

<p>Version 1.2</p>
<ul>
Expand All @@ -195,6 +193,7 @@ <h3 id="version_history">9. Version History</h3>
<ul>
<li>Initial release.</li>
</ul>


<h3 id="genericnotes">10. General Notes</h3>

Expand All @@ -207,6 +206,8 @@ <h4 id="translation">10.2 Translations</h4>
<p>As a policy, if there is no translation for a label then it is not added and it is kept in the original language. If the translation is the same word, then both labels will still be kept.</p>

<p>In French, the term 'bière blonde' is used interchangeably to mean either a pale ale or a lager depending on the region, which can be extremely confusing. To simplify matters the french label for 'pale ale' will be 'ale pâle' and 'lager' for lager unless further specified by a region. For example, pale ales in Quebec are called 'bière blonde', therefore the <rdfs:label xml:lang="fr_ca"> tag is used to signify Canadian French.</p>

<h4 id="interopRant">10.3 Data Verbosity, Interoperability and Reasoners</h4>
m4_include(reasonnersFAQ-en.html)

<h3 id="releasenotes">11. Release Notes</h3>
Expand Down
27 changes: 14 additions & 13 deletions docs/beer-template-fr.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
<link href="css/xmlns-style.css" rel="stylesheet" type="text/css" />
<link href="css/style.css" rel="stylesheet" type="text/css" />
<link rel="mvcb:generatorAgent" type="application/rdf+xml" title="DOAP" href="https://raw.githubusercontent.com/muninn/ontology-tools/master/rdf/voidDescription.rdf" />
m4_include(googleTags.html)
m4_include(miscScripts.html)
<script id="vocab" type="application/ld+json">
m4_include(beer-ONTOLOGY_DATE.jsonld)
</script>
Expand All @@ -22,10 +22,10 @@

{_header_}

<p class="copyright">Pour les raisons de droit d'auteur, cette oeuvre a tous ses droits réservés par Myra Analytics. &#169; 2021</p>
<p class="copyright">Pour les raisons de droit d'auteur, cette oeuvre a tous ses droits réservés par PSW Applied Research Inc. &#169; 2024</p>

<p class="copyright">
Cette oeuvre est disponible sous une double licence <a href="https://creativecommons.org/licenses/by/3.0/"> licence Creative Commons Attribution 3.0 Unported</a> et une licence commerciale supplémentaire. Veuillez contacter info@myraanalytics.ca pour plus de détails. </p>
Cette oeuvre est disponible sous une double licence <a href="https://creativecommons.org/licenses/by/3.0/"> licence Creative Commons Attribution 3.0 Unported</a> et une licence commerciale supplémentaire. Veuillez contacter info@pswappliedresearch.com pour plus de détails. </p>
</p>


Expand Down Expand Up @@ -120,39 +120,39 @@ <h4 id="acme-brewery-exampls">5.1 Exemple de la Brasserie ACME</h4>

<p>Comme <a href="https://rdf.ag/o/beer#Brewery">beer:Brewery</a> est une classe qui étend <a href="https://schema.org/Organization ">schema:Organization</a>, <a href="http://xmlns.com/foaf/0.1/Organization">foaf:Organization</a> et <a href="https://gs1.org/voc/Organisation">gs1:Organization</a>. Cela permet l'utilisation d'un large écosystème de vocabulaires et l'adresse postale de la brasserie fictive est enregistrée avec elle. Alors que de nombreux auteurs préfèrent utiliser des nœuds vides par souci de concision, nous nommons les nœuds ici afin que les exemples de fragments puissent être liés les uns aux autres tout en étant courts.</p>

importRDFExample[La Brasserie ACME, notre Brasserie locale.][beer/acme-brewery.owl]
importRDFExample[La Brasserie ACME, notre Brasserie locale.][examples/acme-brewery.owl]

<p>Notre brasserie fictive brasse deux bières différentes : ACME Ale et ACME Best Stout. Dans l'ontologie de la bière, une <a href="https://rdf.ag/o/beer#Beer">beer:Beer</a> est une boisson qui est une instance d'un style de bière avec une marque, un nom ou un fabricant commun sans référence à la quantité ou à l'emballage.</p>

<p>Une bière peut être liée à sa brasserie à travers plusieurs vocabulaire tel que <a href="https://schema.org/manufacturer">schema:manufacturer</a>, <a href="https://gs1.org/voc/brand">gs1:brand</a>, <a href="https://gs1.org/voc/manufacturer">gs1:manufacturer</a> ou même <a href="http://purl.org/dc/terms/creator">dcterms:creator</a>. Pour les utilisateurs qui souhaitent simplement enregistrer une relation générale peuvent utiliser la propriété <a href="https://rdf.ag/o/beer#brewedBy">beer:brewedBy</a> qui est facilement compréhensible et peut s'aligner sur la plupart des cas ontologiques.</p>

importRDFExample[Les Bières de la Brasserie ACME][beer/acme-brewery-beers.owl]
importRDFExample[Les Bières de la Brasserie ACME][examples/acme-brewery-beers.owl]

<p>Une <a href="https://rdf.ag/o/beer#BeverageProduct">Beer:BeverageProduct</a> est une <a href="https://rdf.ag/o/beer#Beer">Beer:Beer</a> contenue dans un conteneur pouvant être déplacé ou échangé. Dans le langage Schema.org, une <a href="https://rdf.ag/o/beer#Beer">Beer:Beer</a> est une <a href="https://schema.org/ProductGroup ">schema:ProductGroup</a> qui a <a href="https://rdf.ag/o/beer#BeverageProduct">Beer:BeverageProduct</a> pour <a href="https://schema.org/hasVariant">schema:hasVariant</a>s. Cela relie essentiellement la bière en tant que produit abstrait à sa disponibilité matérialisée en tant que produit consommable discret en reliant le <a href="https://rdf.ag/o/beer#BeverageProduct">Beer:BeverageProduct</a> à son contenant en utilisant une propriété <a href="https://gs1.org/voc/package">gs1:package</a>.<p>

<p>Ainsi, si nos deux bières sont exclusivement disponibles dans des canettes en aluminium de 473 ml, nous pouvons définir les propriétés de l'emballage en référençant le <a href="#can473">#can473</a> et en écrivant:</p>

importRDFExample[Les bières en canette de la Brasserie ACME.][beer/acme-brewery-products.owl]
importRDFExample[Les bières en canette de la Brasserie ACME.][examples/acme-brewery-products.owl]

<p>Chaque nouvel emballage ou conteneur nécessite une nouvelle instance d'un <a href="https://rdf.ag/o/beer#BeverageProduct">Beer:BeverageProduct</a>.</p>

<h5 id="brewery_beer_offer">5.1 Une offre schema.org de la Brasserie ACME</h5>

<p><a href="exampleRDF2">Exemple 2</a> Dans cet exemple, nous créons une offre schema.org qui annoncera que la bière est disponible à la vente dans le commerce. La brasserie ACME dispose d'un comptoir de vente sur place qui vendra des canettes individuelles en aluminium de 473 ml de stout.</p>

importRDFExample[Les offres de vente de la Brasserie ACME.][beer/brewery_beer.owl]
importRDFExample[Les offres de vente de la Brasserie ACME.][examples/brewery_beer.owl]

<p>L'ajout d'un <a href="https://schema.org/Offer">schema:Offer</a> pour la canette, à un prix et dans un délai spécifiés devise est faite et l'organisation qui fait l'offre (la brasserie) est répertoriée avec son emplacement dans la rue.</p>

<h4 id="germanpuritylaw">5.2 La Loi Allemande sur la Pureté de la Bière</h4>

<p><a href="exampleRDF3">Exemple 3</a> La loi allemande sur la pureté de la bière de 1516 fixait des limites strictes aux ingrédients autorisés dans la bière : eau, orge, houblon et (plus tard) levure. L'ontologie peut être utilisée pour enregistrer des données sur les bières historiques et les brasseries commerciales faisant des déclarations basées sur ce style.</p>

importRDFExample[Une Bière baser sur la Loi Allemande sur la Pureté de la Bière][beer/germanbeer.owl]
importRDFExample[Une Bière baser sur la Loi Allemande sur la Pureté de la Bière][examples/germanbeer.owl]

<p>La brasserie du <a href="https://www.weltenburger.de/">Monastère de Weltenburg</a>, <a href="https://www.ur-krostitzer.de/">Ur-Krostitzer</a> (marque du groupe Radeberger) et la brasserie <a href="https://www.augustiner-braeu.de/">Augustiner-Bräu</a> brassent tous de la bière qui se qualifie comme bière de la loi Allemande sur la pureté.</p>

importRDFExample[Enregistrer la consommation historique de bière.][beer/germanbeerhistorical.owl]
importRDFExample[Enregistrer la consommation historique de bière.][examples/germanbeerhistorical.owl]

<p>L'ontologie est suffisamment flexible pour enregistrer un événement historique, tel que <a href="https://en.wikipedia.org/wiki/Carl_von_Horn_(1847%E2%80%931923)">Karl Graf von Horn</a> buvant de la bière disponible localement. Son application à l'enregistrement de la consommation d'alcool pour l'analyse diététique est également possible.</p>

Expand All @@ -173,10 +173,9 @@ <h3 id="reference">8. Références Détaillées Pour Tous les Termes, Classes et
<!-- End of the terms list -->

<h3 id="version_history">9. Historique de l'ontologie</h3>
<p>Version 1.5</p>
<ul>
<li>Ajout de l'alignement des ontologies <a href="https://www.w3.org/TR/prov-o/">prov</a>/<a href="https://www.w3.org/TR/owl-time/">time</a> d'après la <a href="https://www.w3.org/TR/owl-time/#time-prov">documentation de l'ontologies Time</a>.</li>
</ul>


{_changehistory_}
<p>Version 1.2</p>
<ul>
<li>Ajout d'exemples pour la brasserie ACME et les bières allemandes. </li>
Expand Down Expand Up @@ -207,6 +206,8 @@ <h4 id="storability">10.1 Stockage</h4>
<h4 id="translation">10.2 Traductions</h4>

<p>En règle générale, s'il n'y a pas de traduction pour une étiquette, elle n'est pas ajoutée et elle est conservée dans la langue d'origine. Si la traduction est le même mot, les deux libellés seront toujours conservés.</p>

<h4 id="interopRant">10.3 Verbosité, interopérabilité et raisonnement</h4>
m4_include(reasonnersFAQ-fr.html)
<h3 id="releasenotes">11. Notes de publication</h3>

Expand Down
Loading

0 comments on commit fcba1f4

Please sign in to comment.