Bibliography and un-breaking the build
Hi All, I spent some time yesterday trying to get the builds running again, with mixed success. My fix uncovered a new problem, triggered by the effort to do a better job with references to sources in examples. Take a look at http://teic.github.io/TEI/BIB.html http://teic.github.io/TEI/BIB.html. First, I think item 1 is a problem. It looks heinous, and I’ve a hard time imagining why I’d care to visit individual examples with no source in this way. Maybe we should just suppress it in the output? Second, back-references to examples from specs are a problem. Item #152 is currently breaking ePub validation, because the back-references point at the http://teic.github.io/TEI/ref-reg.html page, but the examples don’t actually occur on that page, they occur on http://teic.github.io/TEI/examples-reg.html http://teic.github.io/TEI/examples-reg.html (both pages are generated from the same source, of course). We could change all back-references to spec pages to go to the examples pages, I suppose. Anyone have a better idea?
Hugh, have you seen my Pull request (and the comments)? https://github.com/TEIC/Stylesheets/pull/183 Peter
Am 03.11.2016 um 15:54 schrieb Hugh Cayless
: Hi All,
I spent some time yesterday trying to get the builds running again, with mixed success. My fix uncovered a new problem, triggered by the effort to do a better job with references to sources in examples. Take a look at http://teic.github.io/TEI/BIB.html http://teic.github.io/TEI/BIB.html.
First, I think item 1 is a problem. It looks heinous, and I’ve a hard time imagining why I’d care to visit individual examples with no source in this way. Maybe we should just suppress it in the output? Second, back-references to examples from specs are a problem. Item #152 is currently breaking ePub validation, because the back-references point at the http://teic.github.io/TEI/ref-reg.html page, but the examples don’t actually occur on that page, they occur on http://teic.github.io/TEI/examples-reg.html http://teic.github.io/TEI/examples-reg.html (both pages are generated from the same source, of course). We could change all back-references to spec pages to go to the examples pages, I suppose. Anyone have a better idea?
-- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
I'd missed it, and that looks like exactly what's needed. Thanks Peter!
On Thu, Nov 3, 2016 at 11:14 AM, Peter Stadler
Hugh, have you seen my Pull request (and the comments)? https://github.com/TEIC/Stylesheets/pull/183
Peter
Am 03.11.2016 um 15:54 schrieb Hugh Cayless
: Hi All,
I spent some time yesterday trying to get the builds running again, with mixed success. My fix uncovered a new problem, triggered by the effort to do a better job with references to sources in examples. Take a look at http://teic.github.io/TEI/BIB.html http://teic.github.io/TEI/BIB.html.
First, I think item 1 is a problem. It looks heinous, and I’ve a hard time imagining why I’d care to visit individual examples with no source in this way. Maybe we should just suppress it in the output? Second, back-references to examples from specs are a problem. Item #152 is currently breaking ePub validation, because the back-references point at the http://teic.github.io/TEI/ref-reg.html page, but the examples don’t actually occur on that page, they occur on http://teic.github.io/TEI/ examples-reg.html http://teic.github.io/TEI/examples-reg.html (both pages are generated from the same source, of course). We could change all back-references to spec pages to go to the examples pages, I suppose. Anyone have a better idea?
-- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
-- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
This is all a tad complicated. Let me try to complicate it further. 1. The reason you are seeing all those back refs for the "no source" non-entry is that I have been trying scrupulously to indicate unsourced items in the er source. Otherwise we cant distinguish between genuinely unsourced items and ones that we just havent got round to sourcing. Suppressing the first entry in the bib might be a solution, though I am not sure I like it. 2. Item #152 is a problem already noted in a ticket raised by Peter, and I thought he'd fixed it., Its nothing to fdo with the examples-reg.html file, which is generated correctly but is not meant to be pointed to from the bib. Instead the bib is meant to point to the spec page for the element i.e. the ref-reg.html page *for the appropriate language*. So if you are looking at the bib in English you shouldn't see entries for works only sourced from FR examples (which these are) But you do because we dont currently have separate bib files for the languages. The quickest solution would just be to un-source these examples I guess, but I don't quite understand why it's only these two that are showing up now, as there are plenty of other FR sourced entries. Maybe there;s some disgusting magic in the format of the xml:id value. On 03/11/16 14:54, Hugh Cayless wrote:
Hi All,
I spent some time yesterday trying to get the builds running again, with mixed success. My fix uncovered a new problem, triggered by the effort to do a better job with references to sources in examples. Take a look at http://teic.github.io/TEI/BIB.html http://teic.github.io/TEI/BIB.html.
First, I think item 1 is a problem. It looks heinous, and I’ve a hard time imagining why I’d care to visit individual examples with no source in this way. Maybe we should just suppress it in the output? Second, back-references to examples from specs are a problem. Item #152 is currently breaking ePub validation, because the back-references point at the http://teic.github.io/TEI/ref-reg.html page, but the examples don’t actually occur on that page, they occur on http://teic.github.io/TEI/examples-reg.html http://teic.github.io/TEI/examples-reg.html (both pages are generated from the same source, of course). We could change all back-references to spec pages to go to the examples pages, I suppose. Anyone have a better idea?
Most likely, the validation is just stopping at the first problem it finds.
On Thu, Nov 3, 2016 at 11:17 AM, Lou Burnard
This is all a tad complicated. Let me try to complicate it further.
1. The reason you are seeing all those back refs for the "no source" non-entry is that I have been trying scrupulously to indicate unsourced items in the er source. Otherwise we cant distinguish between genuinely unsourced items and ones that we just havent got round to sourcing. Suppressing the first entry in the bib might be a solution, though I am not sure I like it.
2. Item #152 is a problem already noted in a ticket raised by Peter, and I thought he'd fixed it., Its nothing to fdo with the examples-reg.html file, which is generated correctly but is not meant to be pointed to from the bib. Instead the bib is meant to point to the spec page for the element i.e. the ref-reg.html page *for the appropriate language*. So if you are looking at the bib in English you shouldn't see entries for works only sourced from FR examples (which these are) But you do because we dont currently have separate bib files for the languages. The quickest solution would just be to un-source these examples I guess, but I don't quite understand why it's only these two that are showing up now, as there are plenty of other FR sourced entries. Maybe there;s some disgusting magic in the format of the xml:id value.
On 03/11/16 14:54, Hugh Cayless wrote:
Hi All,
I spent some time yesterday trying to get the builds running again, with mixed success. My fix uncovered a new problem, triggered by the effort to do a better job with references to sources in examples. Take a look at http://teic.github.io/TEI/BIB.html http://teic.github.io/TEI/BIB.html.
First, I think item 1 is a problem. It looks heinous, and I’ve a hard time imagining why I’d care to visit individual examples with no source in this way. Maybe we should just suppress it in the output? Second, back-references to examples from specs are a problem. Item #152 is currently breaking ePub validation, because the back-references point at the http://teic.github.io/TEI/ref-reg.html page, but the examples don’t actually occur on that page, they occur on http://teic.github.io/TEI/exam ples-reg.html http://teic.github.io/TEI/examples-reg.html (both pages are generated from the same source, of course). We could change all back-references to spec pages to go to the examples pages, I suppose. Anyone have a better idea?
-- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
participants (3)
-
Hugh Cayless
-
Lou Burnard
-
Peter Stadler