search

SMPTE / html-pub

Tools for publishing SMPTE documents as HTML documents
BSD 3-Clause "New" or "Revised" License
1 stars 0 forks source link

Content allowed in table cells #149

Open bgschunck opened 1 year ago

bgschunck commented 1 year ago

What content can be present in a table cell? Plain text, images, and equations but not text that contains sections and headings. Images, but not figures. Nested tables are not allowed. Cells with plain text could include lists and inline math.

palemieux commented 1 year ago

I am not super excited with the idea of allowing lists, since it makes reading the table much harder. Instead cells can be split.

Do we have an example of a table whose cell contain lists?

palemieux commented 1 year ago

Below is a proposed list of allowed elements:

bgschunck commented 1 year ago

I don't like lists in cells either. It was mentioned during the meeting last Friday. As I recall, Ellen Ryan had a use case in one or her documents, probably VC-6 Part 1.

IMO, we should leave lists out of cells. If any use cases arise, we can revisit the issue later.

-- Brian Schunck Email: @.**@.>

From: Pierre-Anthony Lemieux @.> Sent: Saturday, July 8, 2023 6:06 PM To: SMPTE/html-pub @.> Cc: Brian Schunck @.>; Author @.> Subject: Re: [SMPTE/html-pub] Content allowed in table cells (Issue #149)

I am not super excited by allowing lists, since it makes reading the table much harder. Instead cells can be split.

Do we have an example of a table whose cell contain lists?

- Reply to this email directly, view it on GitHubhttps://github.com/SMPTE/html-pub/issues/149#issuecomment-1627561675, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AB2VU4SVE2DUWCBWZBM5KTLXPH7W5ANCNFSM6AAAAAA2DC7VGM. You are receiving this because you authored the thread.Message ID: @.***>

bgschunck commented 1 year ago

Seems fine to me on a quick first look. The list includes code, math, images, and simple markup for text. Let's go with it. We can add/remove elements later as use cases emerge but it looks fine so far.

-- Brian Schunck Email: @.**@.>

From: Pierre-Anthony Lemieux @.> Sent: Saturday, July 8, 2023 6:34 PM To: SMPTE/html-pub @.> Cc: Brian Schunck @.>; Author @.> Subject: Re: [SMPTE/html-pub] Content allowed in table cells (Issue #149)

Below is a proposed list of allowed elements:

- Reply to this email directly, view it on GitHubhttps://github.com/SMPTE/html-pub/issues/149#issuecomment-1627566522, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AB2VU4QWK2CS7LBPOVTWWTDXPIC65ANCNFSM6AAAAAA2DC7VGM. You are receiving this because you authored the thread.Message ID: @.***>

SteveLLamb commented 1 year ago

If done clean, I don't see any issue with lists in cells, especially when documenting workflows. See https://doc.smpte-doc.org/html-pub/feature/annex-pubstate-workflow/#sec-sample-workflow for an example of this I'm using in the html-pub guide. I could redo with rowspan, but that is actually worse / harder to read with all the border, and in this case I really need the list.