Skip to main content

Section 45.6 Reveal.js Slideshow Options

See Section 34.1 for a more general overview of this conversion.

Subsection 45.6.1 Reveal.js Appearance

The
/publication/revealjs/appearance
element can have the following attributes:
  • @theme: the base name of a file that is a reveal.js theme. (See the reveal.js documentation for available themes.) For example if the desired theme/CSS file is css/theme/solarized.css, then set the value of this attribute to solarized.
  • @custom-css: a string separated list of custom css files to load. These may be local files or remote URLs. For local files, it is recommended to place them in the external files directory so that they are automatically copied from your source folder to the output directory. (Refer to Section 5.6 for more information on external files.)

Subsection 45.6.2 Reveal.js Controls

The
/publication/revealjs/controls
element can have the following attributes:
  • @backarrow: for the visibility of a “back” arrow. Values are faded, hidden, or visible. The default is faded.
  • @display: for the overall visibility of controls. Values are yes or no. The default is yes.
  • @layout: for the location of the controls. Values are edges or bottom-right. The default is bottom-right.
  • @tutorial: for animation of suggested navigation arrows. Values are yes or no. The default is yes.

Subsection 45.6.3 Reveal.js Navigation

The
/publication/revealjs/navigation
element can have the following attribute:
  • @mode: for the arrangement of the navigation through slides. Values are default, linear, or grid. The default is default. The value default refers to the default mode of Reveal.js and is synonomous with grid. In other words, the choice of default or grid results in identical behavior.
See Section 34.1 for more explanation of the two different navigation modes.

Subsection 45.6.4 Reveal.js Resources

You may wish to host the reveal.js CSS and javascript files locally or obtain them online. Be sure to read in Section 34.1 about the necessity of providing the complete MathJax library Section 34.1 if your document has mathematics and you opt for local resources.
The
/publication/revealjs/resources
element can have the following attributes:
  • @host: The values local and cdn will retrieve various Javascript and CSS files (such as the theme) relative to the slideshow HTML file or from an online Content Delivery Network (respectively). PreTeXt will maintain a link to a current, updated, CDN version and this will change without notice. The value embedded instead folds those files (and the fonts a theme uses) into the HTML file at build time, producing a single-file slideshow that presents with no network connection; it implies math="embedded" (below) when the @math attribute is unspecified, while an explicit math="online" is a contradiction, draws an error, and the slideshow is built fully online. See Section 34.1. This attribute may also be given a URL or a local path, though this has not been tested, so should be considered experimental.
  • @math: The value online (the default) loads MathJax in the browser, which typesets the mathematics every time the slideshow is opened. The value embedded instead replaces each piece of mathematics with an SVG image manufactured once, at build time, along with a speech string a screen reader can voice. The slideshow then performs no typesetting at all, and MathJax is never loaded. See Section 34.1 for discussion of the trade-offs, and a limitation of building with embedded mathematics.
You have attempted of activities on this page.