[tei-council] Minor error in Guidelines

Kevin Hawkins kevin.s.hawkins at ultraslavonic.info
Thu Jan 26 20:13:43 EST 2012


I'm wondering whether others feel that we should add a bit to

http://www.tei-c.org/Activities/Council/Working/tcw20.xml

or perhaps more properly

P5/Source/Guidelines/en/style-guide.txt

stating this distinction.  There might be other things that those who 
have been editing the Guidelines keep in mind but haven't written down 
for the rest of us.

Such a passage would be similar to this, which I found in tcw20 and is 
similarly prescriptive about encoding practice:

###

In most chapters, the two character code is also used as a prefix for 
the @xml:id values given to each <div> element. Note that every <div> 
element carries an @xml:id value, whether or not it is actually 
referenced explicitly elewhere in the Guidelines.

###

Is this worthwhile, or would none of us ever remember to consult this 
anyway?

--K.

On 1/13/12 11:19 AM, Lou Burnard wrote:
> In the Guidelines, as elsewhere,
>
> <ref target="#foo">section foo</ref>  means: generate a link to #foo and
> represent it by the text "section foo".
>
> <ptr target="#foo"/>  means: generate a link to #foo and represent it by
> whatever text your processor chooses to generate
>
>
>
> On 13/01/12 16:17, Martin Holmes wrote:
>> Could you clarify what the difference is between using<ref>   and<ptr>
>> in the guidelines?
>>
>> Cheers,
>> Martin
>>
>> On 12-01-13 01:32 AM, Sebastian Rahtz wrote:
>>>
>>> On 13 Jan 2012, at 05:01, Martin Holmes wrote:
>>>
>>>> I've put in a bug report for this:
>>>>
>>>> <http://purl.org/TEI/BUGS/3473329>
>>>>
>>>> The basic problem is that in the web view of the Guidelines, figures
>>>> within each chapter are numbered 1, 2, 3, 4 etc., but in the PDF output,
>>>> they're numbered 11.1, 11.2, 11.3…
>>>>
>>> there are two issues here.
>>>
>>>      a) the use of dangerous markup like "<ref target="#sleeprs">figure 4 above</ref>", which should be changed into a<ptr>    to avoid this sort of problem
>>>      b) the different numbering schemes
>>>
>>> for the latter, which do we want for the Guidelines? by chapter, or sequential throughout?
>>>
>>> for the former, I found 3 occurrences of this, and changed them to<ptr>. am testing before committing.
>>> --
>>> Stormageddon Rahtz
>>> Head of Information and Support Group
>>> Oxford University Computing Services
>>> 13 Banbury Road, Oxford OX2 6NN. Phone +44 1865 283431
>>>
>>> Sólo le pido a Dios
>>> que el futuro no me sea indiferente
>>>
>>
>


More information about the tei-council mailing list