Difference between revisions of "Text Directionality Draft Questions"

From TEIWiki
Jump to navigation Jump to search
(link to draft's talk page, which has more comments)
(Footnotes in wiki markup, and one confusing note)
Line 16: Line 16:
  
 
===Footnotes in wiki markup, and one confusing note===
 
===Footnotes in wiki markup, and one confusing note===
 +
 +
[FIXED by MDH. Thanks for this suggestion. If it now looks right, this issue can be deleted.]
  
 
I found this passage, which appears to contain footnote text:
 
I found this passage, which appears to contain footnote text:

Revision as of 14:06, 7 November 2013

These are some questions for readers of the Text Directionality Draft document (members of Council and of the Text Directionality Workgroup). Feel free to add comments and new questions.

Note that comments are also being made on the draft's talk page.

Is the draft written at the appropriate level of detail?

There may be way too much or way too little detail here.

At the simplest level, we could say "CSS Writing Modes and CSS Transforms provide properties and values for encoding text directionality and transformation. You may wish to use them in the TEI @style attribute, or in <rendition>/@rendition," and stop there. I think that would be unhelpful and unkind, since the CSS specifications are not really human-friendly, and there are some aspects of our suggested usage which is orthogonal to the way the specifications are addressed, since we're using the CSS properties descriptively rather than prescriptively.

On the other hand, you may feel that even more detail is required, with more and better examples. The examples for transforms, for example, are rudimentary and scarcely hint at the actual complexity of the CSS specification.

Where does this section belong in the Guidelines?

Originally, I thought it should be added to the end of the "Languages and Character Sets" front matter section, but I no longer think so; the draft contains examples of TEI encoding which wouldn't make sense to someone who has not yet actually read the body of the Guidelines. Other possible locations would be 10.6.6 Languages and writing systems, or Chapter 5: Non-standard Characters and Glyphs (which would obviously have to be retitled). The draft may even not belong in the Guidelines at all; it could be a peripheral document on the TEI website or on the wiki.

Footnotes in wiki markup, and one confusing note

[FIXED by MDH. Thanks for this suggestion. If it now looks right, this issue can be deleted.]

I found this passage, which appears to contain footnote text:

* The value "use-glyph-orientation" may be dropped from the CSS Writing Modes specification.
along with the transform property from CSS Transforms.

To convey this in MediaWiki, I suggest using the Cite.php mechanisms: <ref> and then <references/> at the end. I would change it myself, but I'm unclear on whether "along with the transform property" is part of the footnote as well.