Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Off topic, but the typesetting here looks top notch and I am curious if anyone can elaborate on the tooling used to render this for the web?


From the Acknowledgements:

> The HTML layout at htdp.org is the work of Matthew Butterick, who created these styles for our on-line documentation.

Some of his other work:

https://docs.racket-lang.org/pollen/

https://beautifulracket.com/


He's also the person behind Practical Typography [0], a great reference/guide for essential typography and layout concepts and terms. It has opinionated recommendations covering nearly everything you'll need to make beautiful documents like this one.

Particularly helpful is the practical advice: how to get the desired results in Word, Pages, or with HTML/CSS; not just high-level abstract guidelines. There's everything from keyboard shortcuts for inserting different dashes (to accompany the explanation on when to use each type) [1] to guidance on page margins in print and on the web [2].

0: https://practicaltypography.com/

1: https://practicaltypography.com/hyphens-and-dashes.html

2: https://practicaltypography.com/page-margins.html


https://docs.racket-lang.org/scribble/

It's like LaTeX, but in Scheme.

Matthew Butterick did the visual redesign of the Web format output.


At one point, I made my embedded API/package docs tool use Scribble.

For example, this document for a package is generated entirely from fragments scattered throughout the code, and package metadata: https://docs.racket-lang.org/roomba/


I am not quite sure what you mean. When I click the link and go to some page of the book, I see the usual interface of racket docs and such. I just see text on a web page. Do you mean the font? Or something else?




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: