From dafd5e5cf1fcbde6da9971f3a3a4bdea532dcd70 Mon Sep 17 00:00:00 2001 From: Raff Viglianti Date: Thu, 16 Jan 2025 18:00:35 -0500 Subject: [PATCH 1/9] First pass at addressing #2392. Made bibl, biblFull, and biblStruct members of att.canonical. Ajusted the guidelines to reflect this addition and clarified uses of bibl vs ref. --- P5/Source/Guidelines/en/CO-CoreElements.xml | 15 +++++++++++++-- P5/Source/Specs/bibl.xml | 1 + P5/Source/Specs/biblFull.xml | 1 + P5/Source/Specs/biblStruct.xml | 1 + 4 files changed, 16 insertions(+), 2 deletions(-) diff --git a/P5/Source/Guidelines/en/CO-CoreElements.xml b/P5/Source/Guidelines/en/CO-CoreElements.xml index 7df83faa4f..e3b31c8adf 100644 --- a/P5/Source/Guidelines/en/CO-CoreElements.xml +++ b/P5/Source/Guidelines/en/CO-CoreElements.xml @@ -4201,6 +4201,17 @@ encoding of short-form references such as Baxter, 1983 is not as bibl elements but as cross-references to such elements; see section below.

+

+ Bibliographic references encoded with bibl, biblFull, and biblStruct may use the attributes defined in att.canonical: ref and key. The ref may be used to point to a more detailed definition, either within or outside the TEI document, as shown in the following example: + + The song of Achilles by Madeline Miller. + + The key attribute, on the other hand, links a bibliographical reference to an externally- or project-defined identifier as demonstrated here: + + Book 16 of Homer's Iliad. + + These attributes should not be used for encoding bibliographic pointers (short-form citations); for that purpose, see section below. +

In cases where the encoder wishes to impose more structure on the bibliographic information, for example to make sure it conforms to a particular stylesheet or retrieval processor, the biblStruct @@ -5476,8 +5487,8 @@ following example: normalize bibliographic references: Nelson claims (Nelson [1980] pages 13–37) ... If it is desired to capture additional information like this in a short-form - reference, then bibl may be used with the corresp attribute pointing to - the full bibliographic reference: Nelson claims (Nelson [1980] pages 13–37) ... + reference, then bibl may be used with the ref attribute pointing to + the full bibliographic reference: Nelson claims (Nelson [1980] pages 13–37) ...

The ref element may also be used to provide a reference to a copy of the bibliographic item itself, particularly if this is available online, as in the following example: diff --git a/P5/Source/Specs/bibl.xml b/P5/Source/Specs/bibl.xml index 0ee30b97b8..33d96dbe49 100644 --- a/P5/Source/Specs/bibl.xml +++ b/P5/Source/Specs/bibl.xml @@ -25,6 +25,7 @@ ausgezeichnet sein können. + diff --git a/P5/Source/Specs/biblFull.xml b/P5/Source/Specs/biblFull.xml index c65a5a3260..a227844da7 100644 --- a/P5/Source/Specs/biblFull.xml +++ b/P5/Source/Specs/biblFull.xml @@ -23,6 +23,7 @@ strutturata nella quale sono presenti tutti i componenti di descrizione di un file TEI. + diff --git a/P5/Source/Specs/biblStruct.xml b/P5/Source/Specs/biblStruct.xml index 49e90392f6..afc179e706 100644 --- a/P5/Source/Specs/biblStruct.xml +++ b/P5/Source/Specs/biblStruct.xml @@ -22,6 +22,7 @@ contenere solo altri elemento nell'ordine specificato. + From ae075cc6f93be0eaab46e59b2aee80256c4c6cd2 Mon Sep 17 00:00:00 2001 From: Raff Viglianti Date: Thu, 16 Jan 2025 20:33:32 -0500 Subject: [PATCH 2/9] prose adjustments. Refs #2392 --- P5/Source/Guidelines/en/CO-CoreElements.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/P5/Source/Guidelines/en/CO-CoreElements.xml b/P5/Source/Guidelines/en/CO-CoreElements.xml index e3b31c8adf..fbb8cfa9b7 100644 --- a/P5/Source/Guidelines/en/CO-CoreElements.xml +++ b/P5/Source/Guidelines/en/CO-CoreElements.xml @@ -4202,7 +4202,7 @@ encoding of short-form references such as Baxter, cross-references to such elements; see section below.

- Bibliographic references encoded with bibl, biblFull, and biblStruct may use the attributes defined in att.canonical: ref and key. The ref may be used to point to a more detailed definition, either within or outside the TEI document, as shown in the following example: + Bibliographic references encoded with bibl, biblFull, and biblStruct may link to a likely more detailed bibliographic reference to the same resource using either the attribute ref or key defined in att.canonical. The ref may be used to point to a definition either within or outside the TEI document, as shown in the following example: The song of Achilles by Madeline Miller. From bb8cd4a343a4404e7d3b21007bed78f162d8122e Mon Sep 17 00:00:00 2001 From: Raff Viglianti Date: Thu, 16 Jan 2025 20:41:08 -0500 Subject: [PATCH 3/9] replaced and with or. Refs #2392 --- P5/Source/Guidelines/en/CO-CoreElements.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/P5/Source/Guidelines/en/CO-CoreElements.xml b/P5/Source/Guidelines/en/CO-CoreElements.xml index fbb8cfa9b7..9b73dc6d5e 100644 --- a/P5/Source/Guidelines/en/CO-CoreElements.xml +++ b/P5/Source/Guidelines/en/CO-CoreElements.xml @@ -4202,7 +4202,7 @@ encoding of short-form references such as Baxter, cross-references to such elements; see section below.

- Bibliographic references encoded with bibl, biblFull, and biblStruct may link to a likely more detailed bibliographic reference to the same resource using either the attribute ref or key defined in att.canonical. The ref may be used to point to a definition either within or outside the TEI document, as shown in the following example: + Bibliographic references encoded with bibl, biblFull, or biblStruct may link to a likely more detailed bibliographic reference to the same resource using either the attribute ref or key defined in att.canonical. The ref may be used to point to a definition either within or outside the TEI document, as shown in the following example: The song of Achilles by Madeline Miller. From 81baf1304b39bf4e05e22ab89110589a0ea77919 Mon Sep 17 00:00:00 2001 From: Raff Viglianti Date: Thu, 16 Jan 2025 21:49:38 -0500 Subject: [PATCH 4/9] further adjustments to prose --- P5/Source/Guidelines/en/CO-CoreElements.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/P5/Source/Guidelines/en/CO-CoreElements.xml b/P5/Source/Guidelines/en/CO-CoreElements.xml index 9b73dc6d5e..43108c3b42 100644 --- a/P5/Source/Guidelines/en/CO-CoreElements.xml +++ b/P5/Source/Guidelines/en/CO-CoreElements.xml @@ -4202,7 +4202,7 @@ encoding of short-form references such as Baxter, cross-references to such elements; see section below.

- Bibliographic references encoded with bibl, biblFull, or biblStruct may link to a likely more detailed bibliographic reference to the same resource using either the attribute ref or key defined in att.canonical. The ref may be used to point to a definition either within or outside the TEI document, as shown in the following example: + Bibliographic references encoded with bibl, biblFull, or biblStruct may link to a another, likely more detailed, bibliographic reference to the same resource using either the attribute ref or key defined in att.canonical. The ref attribute performs this linking function using a URI that may point either within or outside the TEI document, as shown in the following example: The song of Achilles by Madeline Miller. From 5374479375a3d9bdbf02562b760a5e6e2358890a Mon Sep 17 00:00:00 2001 From: Raff Viglianti Date: Sat, 18 Jan 2025 13:37:13 -0500 Subject: [PATCH 5/9] Updated example usage of `@key` on bibl --- P5/Source/Guidelines/en/CO-CoreElements.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/P5/Source/Guidelines/en/CO-CoreElements.xml b/P5/Source/Guidelines/en/CO-CoreElements.xml index 43108c3b42..d24b8973c0 100644 --- a/P5/Source/Guidelines/en/CO-CoreElements.xml +++ b/P5/Source/Guidelines/en/CO-CoreElements.xml @@ -4208,7 +4208,7 @@ below.

The key attribute, on the other hand, links a bibliographical reference to an externally- or project-defined identifier as demonstrated here: - Book 16 of Homer's Iliad. + Book 16 of Homer's Iliad. These attributes should not be used for encoding bibliographic pointers (short-form citations); for that purpose, see section below.

From d87af1fa81520214994b003e354c51cfc0281fe2 Mon Sep 17 00:00:00 2001 From: Raff Viglianti Date: Sat, 18 Jan 2025 13:38:06 -0500 Subject: [PATCH 6/9] Replaced likely with possibly --- P5/Source/Guidelines/en/CO-CoreElements.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/P5/Source/Guidelines/en/CO-CoreElements.xml b/P5/Source/Guidelines/en/CO-CoreElements.xml index d24b8973c0..ee38da3501 100644 --- a/P5/Source/Guidelines/en/CO-CoreElements.xml +++ b/P5/Source/Guidelines/en/CO-CoreElements.xml @@ -4202,7 +4202,7 @@ encoding of short-form references such as Baxter, cross-references to such elements; see section below.

- Bibliographic references encoded with bibl, biblFull, or biblStruct may link to a another, likely more detailed, bibliographic reference to the same resource using either the attribute ref or key defined in att.canonical. The ref attribute performs this linking function using a URI that may point either within or outside the TEI document, as shown in the following example: + Bibliographic references encoded with bibl, biblFull, or biblStruct may link to a another, possibly more detailed, bibliographic reference to the same resource using either the attribute ref or key defined in att.canonical. The ref attribute performs this linking function using a URI that may point either within or outside the TEI document, as shown in the following example: The song of Achilles by Madeline Miller. From 62fdd0906de56835b3f799613af6d7239bb03c3f Mon Sep 17 00:00:00 2001 From: Raff Viglianti Date: Sat, 18 Jan 2025 14:29:17 -0500 Subject: [PATCH 7/9] Fixed typo --- P5/Source/Guidelines/en/CO-CoreElements.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/P5/Source/Guidelines/en/CO-CoreElements.xml b/P5/Source/Guidelines/en/CO-CoreElements.xml index ee38da3501..3d48f9131a 100644 --- a/P5/Source/Guidelines/en/CO-CoreElements.xml +++ b/P5/Source/Guidelines/en/CO-CoreElements.xml @@ -4202,7 +4202,7 @@ encoding of short-form references such as Baxter, cross-references to such elements; see section below.

- Bibliographic references encoded with bibl, biblFull, or biblStruct may link to a another, possibly more detailed, bibliographic reference to the same resource using either the attribute ref or key defined in att.canonical. The ref attribute performs this linking function using a URI that may point either within or outside the TEI document, as shown in the following example: + Bibliographic references encoded with bibl, biblFull, or biblStruct may link to another, possibly more detailed, bibliographic reference to the same resource using either the attribute ref or key defined in att.canonical. The ref attribute performs this linking function using a URI that may point either within or outside the TEI document, as shown in the following example: The song of Achilles by Madeline Miller. From 1b3b00a0160164023e5ac3e15cf25f1baae3d9ae Mon Sep 17 00:00:00 2001 From: ebeshero Date: Mon, 20 Jan 2025 15:55:29 -0500 Subject: [PATCH 8/9] small phrasing revision in CO --- P5/Source/Guidelines/en/CO-CoreElements.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/P5/Source/Guidelines/en/CO-CoreElements.xml b/P5/Source/Guidelines/en/CO-CoreElements.xml index 3d48f9131a..cacbc3ce0b 100644 --- a/P5/Source/Guidelines/en/CO-CoreElements.xml +++ b/P5/Source/Guidelines/en/CO-CoreElements.xml @@ -4206,7 +4206,7 @@ below.

The song of Achilles by Madeline Miller. - The key attribute, on the other hand, links a bibliographical reference to an externally- or project-defined identifier as demonstrated here: + The key attribute, on the other hand, associates a bibliographical reference to an external or project-defined identifier as demonstrated here: Book 16 of Homer's Iliad. From c5e31b1aba976d012c2302217b07b076b788d7f0 Mon Sep 17 00:00:00 2001 From: ebeshero Date: Mon, 20 Jan 2025 15:57:45 -0500 Subject: [PATCH 9/9] one more tiny phrasing revision to CO re #2392 --- P5/Source/Guidelines/en/CO-CoreElements.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/P5/Source/Guidelines/en/CO-CoreElements.xml b/P5/Source/Guidelines/en/CO-CoreElements.xml index cacbc3ce0b..72cf611fe3 100644 --- a/P5/Source/Guidelines/en/CO-CoreElements.xml +++ b/P5/Source/Guidelines/en/CO-CoreElements.xml @@ -4206,7 +4206,7 @@ below.

The song of Achilles by Madeline Miller. - The key attribute, on the other hand, associates a bibliographical reference to an external or project-defined identifier as demonstrated here: + The key attribute, on the other hand, associates a bibliographical reference with an external or project-defined identifier as demonstrated here: Book 16 of Homer's Iliad.