- Inspired by https://github.com/RayTracing/gpu-tracing/pull/9, I'm
adopting the CSS code style of having one selector per line with
trailing commas for definitions that apply to multiple selectors.
- Corrected "Hilight.js" to "Highlight.js". There _is_ a hilight.js, but
it looks like the syntax highlighting package used by Markdeep is
highlight.js (https://highlightjs.org/).
- Fixed background-color syntax bug.
The v4 alpha release is already a large improvement over the v3 release,
so I'm using v4 as the primary project content, and moving the v3
content into its own directory.
All project documentation (changelog, readme, web index) still remains
to be updated before release.
Figure sizes were all over the map, but Markdeep renders them at a
constant width. This change resizes all figures to 800 pixels wide.
In addition, I tightly cropped all figures for consistency, and updated
the CSS style to ensure a good space before the figure caption.
Resolves#959
To match figure and listing styles.
In addition, I caught and corrected all images with class 'pixel'. We
specified the class, but neglected to quote the class value in the HTML
markup.
Resolves#1009
There were some changes to code styling (via highlight.js) with the
update to Markdeep 1.15, plus we wanted to just revisit our code
styling, both in fenced blocks and inline.
Ultimately, I didn't find any improvement to our inline style.
For the general code style, I made preprocessor '#' characters and the
preprocessor keywords get the same styling. I also suppressed styling
for built-ins, parameters, types, and literals. I also tweaked the
background for deleted lines as well, to make it a bit more desaturated.
In addition, I've added book-highlight-test.css, which can be used to
identify the various syntactic elements for styling. See the header for
usage information.
Resolves#868Resolves#1166
- Honors RTW_IMAGES environment variable to locate RTW image directory
- If RTW_IMAGES is unset, searches for image files in several likely
image directory locations.
- Separates image data management from diffuse texture map class.
- Better error reporting on image load failure.
- More robust getters in the face of absent image data.
Resolves#807
Markdeep provides a `class=pixel` attribute for included images in order
to render with a point-sampled result. I didn't realize this when I
originally created CSS styling and an enclosing `div` element to do this
before. Switching the prior styling to now use Markdeep's feature.
Resolves#498
An incremental improvement to styling for rendered images. Smoothed
images don't match actual renderings, and tend to hide single-pixel
artifacts that may be important.
To achieve this, wrap Markdown image includes with `<div
class="render">`. Note that the div open and close tags must be
separated with blank lines from the `` Markdown directive.
See #179
- Removed credits section from project web page.
- Removed acknowledgments from the project README files.
- Added new, consistent acknowledgments section to the end of each book.
- Updated book bylines for editors, copyright, and version.
Resolves#262
Code blocks are now flush left, full width of text, overflow visible.
Tested (display + print) on:
- Windows/Chrome
- Windows/Brave
- Windows/Firefox
- Windows/Edge
- OSX/Chrome
- OSX/Brave
- OSX/Firefox
There are problems on OSX/Safari. Overflow:visible is not honored, but
you can scroll to the right. (Unfortunately, it does the Apple UI thing
where there's no scroll bar to advertise this capability until you
actually scroll.) There are worse problems, though -- images and figures
fail to show at all.
This adds styles for deleted lines and for highlighted (or new) lines.
Note that switching sub-styles in the middle of a code block will
swallow any leading blank line before, so in some cases you'll see two
blank lines in the tilde block where there would normally be one. This
will still render with a single blank line.
In addition to addressing existing cases, I've also found other cases
where highlighting illustrates incremental changes from one version to
the next, particularly in _Ray Tracing In One Weekend_ (book 1).
See issue #14Resolves#11
Added @media print CSS queries for styling the printed version of the
book from the rendered HTML.
This change includes markup of the book content to hint which chunks
belong together on the same page. Look for `<div class='together'>`.
This includes minor fixes to book content.
