Ah, thanks for the clarification, and a big thanks for keeping us moving!
I think the clearer we can be, the better, so letās go with what you have!
Iāll resend the invites by tomorrow latest.
As for the questions about the license on the webbook: Iāve heard back from Pressbooks, and it appears that the chapter title does, in fact, override the book title in the chapter-level copyright license when a chapter author is added to the metadata, but this only happens when the chapterās license has been set to something other than the bookās license. As an example, if the book is CC-BY, but the chapter was set to CC-BY-SA, the chapter title would appear in the license statement. However, since in this case, both the book and the license are CC-BY, only the authorās name appears in the license statement. The team at Pressbooks sees clearly the use-cases like ours, and will be considering ways to update this feature in the longer term. Given our timelines with this book, however, they have suggested that we remove the authors from chapter-level metadata, so the license statement is consistent on all the pages, and instead add author names manually to the beginning of a chapterās body, so the chapter authors are still duly credited for their contributions. Iāll note that if we do make the manual additions, it would be best to format the author names as either a heading 2 or paragraph style, so the content is organized logically (see more about Organizing Content in the Accessibility Toolkit). Hope this helps!
@christina.hendricks Iāve resent invites for you to join the remaining books! While I was doing so, I noticed that this book is titled āIntroduction to the Philosophy of Mindā while the others follow the pattern āIntroduction to Philosophy: Ethicsā. If this was a recent change, Iād suggest updating the Book Information and any other places inside the book where the full book-title is mentioned, perhaps also the book cover. This might already be on your radar, and apologies if so!
For mentions inside the book, you can use the Search & Replace tool! Take a look at the Pressbooks user guide chapter: https://guide.pressbooks.com/chapter/search-and-replace/. Hopefully this will save time going through the book to make the replacements.
Wow, I think there are just a couple of things left to do on this book!
Accessibility Assessment: I went through and answered the questions I knew the answers to without doing a full book assessment yet.
A small thing, and a question for @apurva: when I do export to PDF (whether print or digital), if I look at the āsidebarā with a ToC in my PDF reader (Preview for Mac), the organization looks strange. It looks like most things are in heading 1 and so out towards the left on the list of ToC on the sidebar, except then it appears that all of the chapter titles act like theyāre heading 2 and are all organized under āIntroduction to the Book,ā which is the last heading 1 item before the chapters. Then the rest of the backmatter items show up as if heading one.
Itās the same on Adobe Acrobat reader, if you look at the sidebar with the ābookmarkā icon clicked.
I wouldnāt worry too much about it but then it makes me wonder whether this creates an accessibility problem. The PDF would read as if each chapter were somehow nested under the larger category of āIntroduction to the Book.ā
Thatās very exciting! Not too far before we can release!
This is a really good catch, Christina, and it does look this mis-ordering will affect the accessibility of the PDF. I did try to do some troubleshooting myself, but unfortunately couldnāt come up with a fix. So, I have been in touch with the Pressbooks team, to see if they can possibly look into this in more detail and hopefully help us find a solution. Iāll keep you posted when I hear more from them!
Hi Christina! Iāve had a good exchange with the Pressbooks team, who have in fact compiled a comprehensive list of accessibility improvements they can make to the TOC/bookmarks navigation in the PDF exports. They will be going over this list over time, but have suggested some temporary solutions for us as follows:
In order for the chapters to be correctly and logically nested in the bookmarks bar in the PDF, the following changes need to be made:
A new part needs to be added to the book, and marked as 'Invisibleā
The existing part on the book (titled āChaptersā) needs to be marked as visible
Note: The slight downside of this change is that the webbook version will display the visible part (titled āChaptersā) in the TOC, which I know was something we hoped to avoid. We could, if desired, implement these changes to export a PDF and āpinā this file so it is available for downloads (As long as this file is the most recently exported PDF file, it will appear in the Book Downloads dropdown on the homepage.). Then, we could revert the changes and export the ebook and any other formats, so the web version is similar to how it is now. Iāll leave it to you whether youād like to do multiple exports (one for PDF and one for the other formats) as Pressbooks has suggested, or whether to just implement the changes and let this remain the same across the formats.
If necessary, you can also remove the automatic part and chapter numbering on the book globally, so that export formats do not contain a part-title page or a part-number in the TOC. If you wanted to preserve the chapter numbers, you will need to add these in manually, (in the chapter-title), OR leave the automatic part and chapter numbering option enabled. You can decide on whether to enable/disable the auto chapter and part numbering, and enter this manually.
In order for the chapter endnotes to not appear in the bookmarks bar in PDF, these will need to be reset to regular footnotes. Go to Appearance --> Theme Options --> PDF Options --> Footnote Style --> Select āRegular Footnoteā and Save. Please feel free to implement this change if you would like to.
For the title page: with the current Custom Title page, the only solution is to remove this page from displaying in the bookmarks bar entirely, which may not be best practice. I can provide some instructions (or implement some changes) so that the page styling remains the same, but it does not display in the bookmarks bar in PDF. If we decide to go with this, it may be worth mentioning a few sentences about this in the Accessibility Statement. Alternatively, we could revert to the regular auto-generation Title Page, which should display correctly in the bar. Please let me know which of the 2 options you prefer.
Unfortunately, the copyright page is not listed in the bookmarks bar in the PDF. Thereās no short term solution for this, but I wanted to flag this if you wanted to include it in the Accessibility Assessment.
Iāve tried to list out all the major decisions/action items in bold formatting above. If thereās anything that still unclear or confusing, please let me know. This issue has turned to be a bit more complex than expected, so Iām happy to explain things in more detail or answer any outstanding questions that you might have.
Thank you for this comprehensive info, @apurva . I think I understand nearly all of it, but I have a question about this part:
I get that the existing part needs to be marked as visible and Iāll think about whether to keep it that way forever or just for the PDF export. But I am not sure I understand the first bullet, aboveāis it that I just need to add an empty part somewhere in the book and make it invisible? Does it matter where it goes?
As for the custom title page, I think for accessibility purposes itās best to keep it in the bookmarks bar rather than removing it. So I guess for now that means taking out the custom title page. My understanding is that if I just remove the custom one then one will be auto-generated in its place and work correctly for the PDF bookmarks bar. Please let me know if that isnāt correct, though.
Oh, a couple of other question about accessibility, @apurva:
Iām doing the accessibility checklist and I want to double check that the headings should start with heading 2, in the body of the chapters or frontmatter/backmatter. I believe the chapter title (or frontmatter/backmatter title) is in heading 1, so headings after that should start with heading 2, but I want to make sure thatās correct. Thatās how we have it now!
First, it asks about row and column headers, and I think it only has column headers. Is that your read too?
It also asks about a caption, and I canāt figure out how to do that on TablePress (there is an option for the table title to appear above or below the tableā¦do you think that serves the same point as a caption?)
Finally, it asks about cell padding and I donāt know how to tell what that is on a TablePress table.
Iām now wondering if itās better to just create a table within Pressbooks itself as perthe tables chapter in the BCcampus accessibility toolkit? Then I could manipulate the html or follow the other manual instructions for Pressbooks there.
Yep, all thatās needed is to add an empty part in the book and mark it as invisible. I donāt think order matters. When I tested this solution, I placed this empty invisible part after the āChaptersā one, and it seemed to work well.
Yes, thatās right! Since the chapter titles are styled as heading 1, anything that follows should start with heading 2, and go lower.
Looking at the webbook checklist table, it looks like there are table rows, however, these have not been identified using the scope method outlined in the BCcampus Accessibility Toolkit. A caption can added if you enable the āPrint Table Descriptionā option. And as for the cell padding ā thereās at minimum, a uniform padding of 8px in each cell.
Given that there doesnāt appear to be a simple way to add table row headers using TablePress, Iād say yes, creating the tables using HTML may be best. Apologies for asking you to redo these tables ā but itās better that this be resolved now rather than later!
Argh: so sorry, @christina.hendricks, I completely fell off the map on this project. My apologies!
Iām not sure where things are now, or if I can still help in some way. Iām looking back through the messages, but am not clear on whatās been done/still needed. If there is something I could help with, please call on me!
Hi @xolotlāthanks for checking back in!
If you have time, it would be really great if you could help with the last little bit.
The last thing to do is to redo the tables as per the accessibility concerns listed above. There are two tables: accessibility checklist and version history. They are currently in TablePress, but they need to be redone in html as per the tables chapter in the BCcampus accessibility toolkit.
Then I think we can fill out the accessibility checklist with a āyesā for all the parts about tables and weāll be ready to go.
Please let me know if you could do this, and if so, whether it might be within the next few days. I can get to it in the next few days if not!
Before I do the other, we should resolve some questions:
The caption is redundant to the header right before the table, but the default styles here place the caption below the table, so I left both. Itās a bit redundant, but it seems like both the title and caption might be warranted, right?
I styled the table in the āfull gridā PB standard style which seems most visually clear, but other standard PB table styles are available. Is full grid the right choice?
For the accessibility assessment table on the other page, we have a bit of a conundrum as it includes row headers that apply to multiple rows, but according to accessibility standards, we should not merge cells or probably leave cells blank. The most accessible thing to do seems to be to repeat the row headers for every row, which may seem a bit redundant. Do you all agree?
Lastly, these accessible tables wonāt have the sorting, searching and row display controls that come via TablePress, but these small tables donāt really seem to need them. That might be less true in books with larger data tables.
Hmm, looking at the table for the version history, Iād say the heading above it is not necessary, but the caption should remain as is.
I find this to be the clearest too! Happy to let Christina chime in if she prefers another table.
Hmm, repeating the row headers does seem to be the best route. It will not seem redundant for anyone reading the book with a screen reader, and if anything, will also make it much clearer for those reading the book in other formats (eg: if youāre scrolling through the table, sometimes the header row is off-screen, so it may not be easiest to recall what it was).
Agreed about the search and sort display controls as being less of a need for these small tables!
Thanks so much, @xolotl for working on this! I agree with @apurva on her comments above. I am not sure what the other table styles in PB look like, but this one looks fine. And I think the issue with the row headers is best addressed by repeating the headers for each row where needed. I donāt know exactly what the best approach is for a table like this is from an accessibility perspective, but if we find out more later we can change it.
@christina.hendricks ā could you let me know when all of these final changes have been completed? Iām hoping to confirm the final PDF page count to calculate the size for the cover for the print format. I can then pass this info along to Jonathan, whoās working on the cover design to finalize this too!
Sure thing, @apurva. I think once @xolotl finishes the table then thatās it. We can generate the exports and make them visible on the site and hit āpublishā!
Not too far before we can release!