search

PreTeXtBook / pretext

PreTeXt: an authoring and publishing system for scholarly documents
https://pretextbook.org
Other
254 stars 203 forks source link

Guide: add image description authoring advice #2077

Closed oscarlevin closed 7 months ago

oscarlevin commented 7 months ago

I welcome your feedback.

rbeezer commented 7 months ago

Dang. I swear I posted here a couple days ago.... Sorry!

Short urgent version: we need four PDF images for the PDF build! I can find KPI.pdf, I'm sure. Two from DMOI? Do you have the Active one handy? I can look.

More, once I check my notes.

oscarlevin commented 7 months ago

I'll get these added tomorrow. That's what I get for never having external assets for my projects!

oscarlevin commented 7 months ago

I've added pdfs for the three svg images that I added to the guide with the previous commit. I assume the png from active calculus is fine as is.

rbeezer commented 7 months ago

Found it in an old tab. Never hiot "Comment".

Nicely done, and great reading. Some nice devices for making your point.

How do we feel about saying "MathML" is banned in shortdescription? Do we want to say PTX m and related are banned? Describe how it should be authored?

Three very small typos that I can fix. Oh, and one bit of stray whitespace - I'll get that too.

rbeezer commented 7 months ago

Very nice! Thanks. Sorry to be slothful on this one.

Do you want to publicize the new "description" element? Certainly on -dev, but maybe on -announce? Can't recall if I've publicly expained that "old" description are now becoming "shortdescription"? I can do that if it sounds like too much of a fiddle.

oscarlevin commented 7 months ago

Thanks. I'll let you make the announcement. There was something, just on -dev I think. But on -announce would be good to promote good descriptions.