News:

Download Pelles C here: http://www.smorgasbordet.com/pellesc/

Main Menu

Help file suggestion

Started by Quin, April 02, 2025, 05:34:11 PM

Previous topic - Next topic

Pelle

Hello Quin,

Quote from: Quin on May 06, 2025, 07:52:37 PMI also found two more typos:
OK. Thanks.

Quote from: Quin on May 06, 2025, 07:52:37 PMSo Pelle, you actually did make a lot of improvements. Just the ASCII and ANSI tables, as well as any table with the same static text as its entire column row, are the only ones currently in need of fixing :)
The ASCII and ANSI tables are just listing all the numeric values with it's corresponding character. Not terribly interesting. Trying to make these tables more friendly to screen readers will likely make them unreadable to everyone.

Do you actually have an example of a "table with the same static text as its entire column row" ?
/Pelle

Quin

Hi Pelle,
Yes, the ascii table is the example :)
The column text for every single column in that table is "ASCII Character Table", same as the heading right above it.
These aren't needed column headers, so you can safely remove them. I'm not sure if it'll break screen readers being able to navigate the table, though.
Use the assembly, Luke.

John Z

if it helps here are the two I modified.

John Z

Quin

Yup, and John Z's versions read how I expect them to :)
Use the assembly, Luke.

Pelle

Quote from: John Z on May 07, 2025, 05:15:58 PMif it helps here are the two I modified.
Sorry, this looks worse to me (not being blind).
Except for any typos, I'm very much done with this topic for now...
/Pelle

John Z

Quote from: Pelle on May 08, 2025, 02:15:09 PMExcept for any typos, I'm very much done with this topic for now...

Understood -

Well that is my fault.  I was just testing how to make the change not thinking about a final look.
I'm sure your help file is still more usable for the screen reader now than before.

John Z

Quin

Quote from: John Z on May 08, 2025, 05:28:22 PM
Quote from: Pelle on May 08, 2025, 02:15:09 PMExcept for any typos, I'm very much done with this topic for now...

Understood -

Well that is my fault.  I was just testing how to make the change not thinking about a final look.
I'm sure your help file is still more usable for the screen reader now than before.

John Z
Oh it definitely is, and that is certainly much appreciated.
I wonder if we could achieve the wanted look with CSS? I know nothing about how it looks though so...
Use the assembly, Luke.

John Z

Hi Quin,

Yes Pelle already uses CSS for his help file.  I did not include it when creating the test file for the headers.

John Z

Quin

Quote from: John Z on Yesterday at 11:33:03 AMHi Quin,

Yes Pelle already uses CSS for his help file.  I did not include it when creating the test file for the headers.

John Z
Hi,
No, what I meant was I wonder if we can add the columns like you had, and then use CSS to style them.
Use the assembly, Luke.

Robert

Hi Quin:

The Pelles Help file already uses CSS to style the tables, including the headers.

Missing components, regarding navigation with a screen reader, are the
<thead> ... </thead>demarcation tags enclosing the headers and the
<tbody> ... </tbody>demarcation tags on the rest of the table.

I suspect that a regex search and replace utility like DnGrep
https://dngrep.github.io/
could add the missing components.

https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/thead
https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/tbody