Skip to content

Add information on book printing and PDFs #1213

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 15, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions PRINTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
Printing These Books
====================================================================================================

These books have been formatted to be print friendly (using CSS media queries). That means that you
should be able to print them directly from your browser of choice (usually Ctrl-P on Windows and
Linux, or Cmd-P on Mac).

We've taken some care to set up sensible page breaks in the printed versions, though you still may
find a few odd artifacts here and there. For example, the latest version of Markdeep can let
images/figures and their captions land on different pages. This issue has been reported, and there
may be a fix in the works for this.


Pre-Printed Books
------------------
I've gone back and created PDFs for each book for versions v2.0.0, v3.0.0, v3.2.3. You can find
these in the assets section of each release on the [GitHub releases page][releases]. We will include
PDFs for all books with all future releases.


Creating PDFs of These Books
-----------------------------
If you wish to create your own PDF of any of these books (like for a version currently in
development, or to test the results on your own changes), the easiest way is to use a save-to-PDF
print driver. When viewing a book in your browser, issue your browser's print command, and look
through the available destination printers. Hopefully you'll find a save-to-PDF printer already set
up and available. If not, you should be able to search for and find such a print driver for your
particular operating system.



[releases]: https://github.com/RayTracing/raytracing.github.io/releases
5 changes: 3 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,8 @@ we strongly recommend that you jump above the v4 train.
- [Ray Tracing: The Next Week][web2]
- [Ray Tracing: The Rest of Your Life][web3]

These books have been formatted for both screen and print. For printed copies, or to create PDF
versions, use the print function in your browser.
These books have been formatted for both screen and print. For more information about printing your
own copies, or on getting PDFs of the books, see [PRINTING.md][] for more information.


Project Status
Expand Down Expand Up @@ -202,6 +202,7 @@ _**please review the [CONTRIBUTING][] document for the most effective way to pro
[implementations]: https://github.com/RayTracing/raytracing.github.io/wiki/Implementations
[milestone 16]: https://github.com/RayTracing/raytracing.github.io/milestone/16
[milestone 19]: https://github.com/RayTracing/raytracing.github.io/milestone/19
[PRINTING.md]: PRINTING.md
[v3.2.3]: https://github.com/RayTracing/raytracing.github.io/releases/tag/v3.2.3
[web1]: https://raytracing.github.io/books/RayTracingInOneWeekend.html
[web1-v3]: https://raytracing.github.io/books/v3/RayTracingInOneWeekend.html
Expand Down
4 changes: 4 additions & 0 deletions books/RayTracingInOneWeekend.html
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,9 @@
Peter maintains a site related to this book series at https://in1weekend.blogspot.com/, which
includes further reading and links to resources.

These books have been formatted to print well directly from your browser. We also include PDFs of
each book [with each release][releases], in the "Assets" section.

If you want to communicate with us, feel free to send us an email at:

- Peter Shirley, [email protected]
Expand Down Expand Up @@ -4186,6 +4189,7 @@

[discussions]: https://github.com/RayTracing/raytracing.github.io/discussions/
[gfx-codex]: https://graphicscodex.com/
[releases]: https://github.com/RayTracing/raytracing.github.io/releases/
[repo]: https://github.com/RayTracing/raytracing.github.io/
[square-pixels]: https://www.researchgate.net/publication/244986797

Expand Down
3 changes: 3 additions & 0 deletions books/RayTracingTheNextWeek.html
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,9 @@
you want a weekend project. Order is not very important for the concepts presented in this book, and
without BVH and Perlin texture you will still get a Cornell Box!

These books have been formatted to print well directly from your browser. We also include PDFs of
each book [with each release][releases], in the "Assets" section.

Thanks to everyone who lent a hand on this project. You can find them in the acknowledgments section
at the end of this book.

Expand Down
3 changes: 3 additions & 0 deletions books/RayTracingTheRestOfYourLife.html
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,9 @@

As before, https://in1weekend.blogspot.com/ will have further readings and references.

These books have been formatted to print well directly from your browser. We also include PDFs of
each book [with each release][releases], in the "Assets" section.

Thanks to everyone who lent a hand on this project. You can find them in the acknowledgments section
at the end of this book.

Expand Down