#139 Update, format, correct, supplement examples in GL

[Elli Mylonas]

There are pages in the GL where the examples are poorly formatted, or don't make sense on the page. In other cases, the examples are missing or don't cover enough permutations of attributes. We should hold a sprint to go through pages and plan what needs to be done and which pages need better or clearer examples. In advance of the sprint, please list any example lacks that you notice (page title, url, comment) to this ticket discussion.

[Emmanuelle Morlock]

https://www.stoa.org/epidoc/gl/latest/trans-diplomatic.html –> "see also" link missing

https://www.stoa.org/epidoc/gl/latest/trans-textpart.html –> 3rd §: formatting pb 'with an type="textpart".'

https://www.stoa.org/epidoc/gl/latest/trans-textpart.html –> "according to london: Section A": transformed html missing for second and third example block.

https://www.stoa.org/epidoc/gl/latest/trans-linebreak.html
-> to show the effect of a line break, the example shoud provide at least 2 lines (otherwise the rendering is not different is there is a line beginning tag or not.
-> also update the notion of "line breaks" to "line beginings" (very common source of misunderstanding in training sessions). Of course a line begining <lb/> is a kind of a line break, but it's important to be explicit somewhere that the it represents be beginning of a line and not the end of the previous one...

https://www.stoa.org/epidoc/gl/latest/trans-linebreakinword.html
-> the two example options (panciera and london) produce the same rendering. May be more interesting to provide examples with parameters producing different renderings.

https://www.stoa.org/epidoc/gl/latest/trans-linebreakdirection.html
-> the interesting visual rendering is not inside the yellow example box, but on top of it (SEG wit arrow turned towards left. We should have here two explicit examples with arrows showing visually the relation between the @style attribute and the direction of the graphic arrow
-> PHI 1357: unconsistent encoding/rendering for first line?

(to be continued...)

[BODARD Gabriel]

Diplomatic "see also" – it is not that there is a link missing, but that there are no elements given here to be linked to. We should put a test on the "see also" script so that it doesn't appear if empty.

Linebreakinword – As noted elsewhere, the "Panciera" rendering is in fact wrong here (should be = not - at the end of line), and so should be renamed. It actually means "default" in the EpiDoc Stylesheets.

Linebreakdirection – the issue is that neither of these Leiden-styles render text direction. If we want them to, that should be a separate ticket, I think. (In fact, maybe subsumed under FR 132?)

[BODARD Gabriel]

I now see that the "see also" division is triggered by a <divGen type="seealso"/> in the XML, so the solution to the Diplomatic page is to either (a) add a <specList> if there are elements we want cited in there or (b) delete the <divGen>.

[BODARD Gabriel]

I will delete (or rather comment out) the <divGen> for now. Commited at [r2767]

[Pietro Maria Liuzzo]

I have a plan to look at this as promised