search

Health-Sprints / A-Machine

A-Machine
GNU General Public License v3.0
1 stars 0 forks source link

Document structure semantics tags #10

Open mrchristian opened 3 years ago

mrchristian commented 3 years ago

From Shinyu:

https://docs.google.com/document/d/1prgiLs8BUC0Kypw9KyxSbg1m47wLuD6VYR-GuLSZWGU/edit#bookmark=id.czpri7jj6qzz

Yes, we should use HTML section element for sectioning with in an HTML document. Also we can omit the section element when using multiple HTML files for parts of a book because the HTML body element represents the root section in a document. For EPUB publications, we should use the parts of book vocabulary defined in https://idpf.github.io/epub-vocabs/structure/, and should follow "HTML usage context" in this spec, e.g. "HTML usage context: section, body" for "chapter". We can use <section epub:type="chapter" role="doc-chapter"> or <body epub:type="chapter" role="doc-chapter"> for a chapter. (Note: the role property value is defined in https://www.w3.org/TR/dpub-aria-1.0/ that has similar concept with epub:type but is needed for non-EPUB context)

mrchristian commented 3 years ago

Document structure semantics tags: I need to process what Shinyu has written here and his links to standards recommendations. I would suggest Vivlio come up with an example encoding for HTML/XHTML and EPUB XHTML, then Shinyu can consult on the model. HTML semantic section tags for example.

mrchristian commented 3 years ago

HTML 5 and EPUB https://inclusivepublishing.org/resources/tutorials/semantic-markup-epub-3/