Skip to content

Latest commit

 

History

History
76 lines (48 loc) · 3.25 KB

BPT_for_Text_Editions_1.md

File metadata and controls

76 lines (48 loc) · 3.25 KB

BPT for Text Editions 1

There is a need in text editions to go beyond vanilla Markdown. Below the text edition specific extensions that characterize BPT are listed.

anchors

See the section on references

Bibliography

  • references are in YAML using CSL field names
  • citations are in author_year format (acting as citekey)

Illustrations

  • Vanilla Markdown has ![foo](/url "title")which results in HTML <img src="/url" alt="foo" title="title" />
  • This is just one of many possibilities, by the way.
  • Still, this system doesn't work for cases where the image descrption is very long, has multiply paragraphs and contains markup. This is the case in Brill325, for example.
  • In such cases, we place the description in a separate tag, like so <=.ill_FILENAME DESCRIPTION =>. For example:
![](01-00.jpg)

<=.ill_01-00.jpg Around 1750 Samuel Luchtmans I commissioned this allegorical mantelpiece painting from the artist Nicolaas Reyers. For many years it decorated the home of the Luchtmans family on the Rapenburg, and it now hangs in the offices of Brill. The painting shows Pallas Athena with her shield and lance, accompanied by Hermes with his winged helmet and herald’s staff. In the foreground three naked little boys are playing with prints depicting periwigged gentlemen, presumably Leiden professors.

Language and script

  • md: ~|ἄνδρα μοι ἔννεπε, μοῦσα|~grc-Grek

Table of contents

See Markdown TOC by Jon Schlinkert.

Tables

Tables are plain markdown.

We use this CommonMark extension to add captions to tables.

(See also here and here ).

Example

| First Header  | Second Header | Third Header |
| :------------ | :-----------: | -------------------: |
| First row | Data  | Very long data entry |
| Second row | **Cell**  | *Cell*  |
| Third row  | Cell that spans across two columns  ||
[Table caption, works as a reference][section-mmd-tables-table1] | |

Text direction

  • md: ~|הלך אבא לעבודה|~rtl

Language and script and text direction combined

  • md: ~|~|הלך אבא לעבודה|~he-Hebr|~rtl

It probably makes sense to indicate the base directionality and lang-script combination in a comment at the top of a work, i.e between <!-- -->, and to indicate in the text itself only the exceptions. This prevents redundant markup.

In the bpt+2tei.py, we'll include rules like:

  • not included in the base directionality (unless it is ltr) are line numbers
  • not included in the base directionality (unless it is ltr) are note numbers

see also