Skip to content

Commit dce6110

Browse files
committed
Add information on book printing and PDFs
Resolves #1206
1 parent 889d33c commit dce6110

File tree

5 files changed

+45
-2
lines changed

5 files changed

+45
-2
lines changed

PRINTING.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
Printing These Books
2+
====================================================================================================
3+
4+
These books have been formatted to be print friendly (using CSS media queries). That means that you
5+
should be able to print them directly from your browser of choice (usually Ctrl-P on Windows and
6+
Linux, or Cmd-P on Mac).
7+
8+
We've taken some care to set up sensible page breaks in the printed versions, though you still may
9+
find a few odd artifacts here and there. For example, the latest version of Markdeep can let
10+
images/figures and their captions land on different pages. This issue has been reported, and there
11+
may be a fix in the works for this.
12+
13+
14+
Pre-Printed Books
15+
------------------
16+
I've gone back and created PDFs for each book for versions v2.0.0, v3.0.0, v3.2.3. You can find
17+
these in the assets section of each release on the [GitHub releases page][releases]. We will include
18+
PDFs for all books with all future releases.
19+
20+
21+
Creating PDFs of These Books
22+
-----------------------------
23+
If you wish to create your own PDF of any of these books (like for a version currently in
24+
development, or to test the results on your own changes), the easiest way is to use a save-to-PDF
25+
print driver. When viewing a book in your browser, issue your browser's print command, and look
26+
through the available destination printers. Hopefully you'll find a save-to-PDF printer already set
27+
up and available. If not, you should be able to search for and find such a print driver for your
28+
particular operating system.
29+
30+
31+
32+
[releases]: https://github.com/RayTracing/raytracing.github.io/releases

README.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,8 +27,8 @@ we strongly recommend that you jump above the v4 train.
2727
- [Ray Tracing: The Next Week][web2]
2828
- [Ray Tracing: The Rest of Your Life][web3]
2929

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

3333

3434
Project Status
@@ -202,6 +202,7 @@ _**please review the [CONTRIBUTING][] document for the most effective way to pro
202202
[implementations]: https://github.com/RayTracing/raytracing.github.io/wiki/Implementations
203203
[milestone 16]: https://github.com/RayTracing/raytracing.github.io/milestone/16
204204
[milestone 19]: https://github.com/RayTracing/raytracing.github.io/milestone/19
205+
[PRINTING.md]: PRINTING.md
205206
[v3.2.3]: https://github.com/RayTracing/raytracing.github.io/releases/tag/v3.2.3
206207
[web1]: https://raytracing.github.io/books/RayTracingInOneWeekend.html
207208
[web1-v3]: https://raytracing.github.io/books/v3/RayTracingInOneWeekend.html

books/RayTracingInOneWeekend.html

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,9 @@
6969
Peter maintains a site related to this book series at https://in1weekend.blogspot.com/, which
7070
includes further reading and links to resources.
7171

72+
These books have been formatted to print well directly from your browser. We also include PDFs of
73+
each book [with each release][releases], in the "Assets" section.
74+
7275
If you want to communicate with us, feel free to send us an email at:
7376

7477
- Peter Shirley, [email protected]
@@ -4186,6 +4189,7 @@
41864189

41874190
[discussions]: https://github.com/RayTracing/raytracing.github.io/discussions/
41884191
[gfx-codex]: https://graphicscodex.com/
4192+
[releases]: https://github.com/RayTracing/raytracing.github.io/releases/
41894193
[repo]: https://github.com/RayTracing/raytracing.github.io/
41904194
[square-pixels]: https://www.researchgate.net/publication/244986797
41914195

books/RayTracingTheNextWeek.html

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,9 @@
3131
you want a weekend project. Order is not very important for the concepts presented in this book, and
3232
without BVH and Perlin texture you will still get a Cornell Box!
3333

34+
These books have been formatted to print well directly from your browser. We also include PDFs of
35+
each book [with each release][releases], in the "Assets" section.
36+
3437
Thanks to everyone who lent a hand on this project. You can find them in the acknowledgments section
3538
at the end of this book.
3639

books/RayTracingTheRestOfYourLife.html

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,9 @@
4141

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

44+
These books have been formatted to print well directly from your browser. We also include PDFs of
45+
each book [with each release][releases], in the "Assets" section.
46+
4447
Thanks to everyone who lent a hand on this project. You can find them in the acknowledgments section
4548
at the end of this book.
4649

0 commit comments

Comments
 (0)