Add badges and remove toc in README
diff --git a/README.Rmd b/README.Rmd
index 15c729a..a78d115 100644
--- a/README.Rmd
+++ b/README.Rmd
@@ -1,11 +1,14 @@
---
title: "R Markdown Format for reveal.js Presentations"
output:
- github_document:
- toc: true
- toc_depth: 2
+ github_document: default
---
+<!-- badges: start -->
+[![CRAN status](https://www.r-pkg.org/badges/version/revealjs)](https://CRAN.R-project.org/package=revealjs)
+[![R-CMD-check](https://github.com/rstudio/revealjs/workflows/R-CMD-check/badge.svg)](https://github.com/rstudio/revealjs/actions)
+<!-- badges: end -->
+
## Overview
This repository provides an [R Markdown](http://rmarkdown.rstudio.com) custom format for [reveal.js](https://revealjs.com/) HTML presentations.
diff --git a/README.md b/README.md
index 603fd96..913abdd 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,12 @@
R Markdown Format for reveal.js Presentations
================
- - [Overview](#overview)
- - [Rendering](#rendering)
- - [Display Modes](#display-modes)
- - [Incremental Bullets](#incremental-bullets)
- - [Appearance and Style](#appearance-and-style)
- - [Slide Transitions](#slide-transitions)
- - [Slide Backgrounds](#slide-backgrounds)
- - [2-D Presentations](#d-presentations)
- - [Reveal Options](#reveal-options)
- - [Figure Options](#figure-options)
- - [MathJax Equations](#mathjax-equations)
- - [Document Dependencies](#document-dependencies)
- - [Reveal Plugins](#reveal-plugins)
- - [Advanced Customization](#advanced-customization)
- - [Shared Options](#shared-options)
+<!-- badges: start -->
+
+[![CRAN
+status](https://www.r-pkg.org/badges/version/revealjs)](https://CRAN.R-project.org/package=revealjs)
+[![R-CMD-check](https://github.com/rstudio/revealjs/workflows/R-CMD-check/badge.svg)](https://github.com/rstudio/revealjs/actions)
+<!-- badges: end -->
## Overview
@@ -42,28 +33,28 @@
date: March 22, 2005
output: revealjs::revealjs_presentation
---
-
+
# In the morning
-
+
## Getting up
-
+
- Turn off alarm
- Get out of bed
-
+
## Breakfast
-
+
- Eat eggs
- Drink coffee
-
+
# In the evening
-
+
## Dinner
-
+
- Eat spaghetti
- Drink wine
-
+
## Going to sleep
-
+
- Get in bed
- Count sheep
@@ -84,9 +75,9 @@
source file, with the same name.
Note: Unlike the the other slideshow outputs, the slideshow viewer popup
-from RStudio will be blank, to view the slide show click the `open in
-browser` button, and the slide show will render in your default web
-browser.
+from RStudio will be blank, to view the slide show click the
+`open in browser` button, and the slide show will render in your default
+web browser.
### R Console
@@ -115,9 +106,9 @@
The following single character keyboard shortcuts enable alternate
display modes:
- - `'f'` enable fullscreen mode
+- `'f'` enable fullscreen mode
- - `'o'` enable overview mode
+- `'o'` enable overview mode
Pressing `Esc` exits all of these modes.
@@ -142,20 +133,20 @@
There are several options that control the appearance of revealjs
presentations:
- - `theme` specifies the theme to use for the presentation (available
+- `theme` specifies the theme to use for the presentation (available
themes are “default”, “simple”, “sky”, “beige”, “serif”,
“solarized”, “blood”, “moon”, “night”, “black”, “league” or
“white”).
- - `highlight` specifies the syntax highlighting style. Supported
+- `highlight` specifies the syntax highlighting style. Supported
styles include “default”, “tango”, “pygments”, “kate”, “monochrome”,
“espresso”, “zenburn”, and “haddock”. Pass null to prevent syntax
highlighting.
- - `center` specifies whether you want to vertically center content on
+- `center` specifies whether you want to vertically center content on
slides (this defaults to false).
- - `smart` indicates whether to produce typographically correct output,
+- `smart` indicates whether to produce typographically correct output,
converting straight quotes to curly quotes, `---` to em-dashes, `--`
to en-dashes, and `...` to ellipses. Note that `smart` is enabled by
default.
@@ -175,11 +166,11 @@
You can use the `transition` and `background_transition` options to
specify the global default slide transition style:
- - `transition` specifies the visual effect when moving between slides.
+- `transition` specifies the visual effect when moving between slides.
Available transitions are “default”, “fade”, “slide”, “convex”,
“concave”, “zoom” or “none”.
- - `background_transition` specifies the background transition effect
+- `background_transition` specifies the background transition effect
when moving between full page slides. Available transitions are
“default”, “fade”, “slide”, “convex”, “concave”, “zoom” or “none”.
@@ -195,14 +186,14 @@
data-transition attribute, for example:
## Use a zoom transition {data-transition="zoom"}
-
+
## Use a faster speed {data-transition-speed="fast"}
You can also use different in and out transitions for the same slide,
for example:
## Fade in, Slide out {data-transition="slide-in fade-out"}
-
+
## Slide in, Fade out {data-transition="fade-in slide-out"}
## Slide Backgrounds
@@ -215,11 +206,11 @@
few examples.
## CSS color background {data-background=#ff0000}
-
+
## Full size image background {data-background="background.jpeg"}
-
+
## Video background {data-background-video="background.mp4"}
-
+
## Embed a web page as a background {data-background-iframe="https://example.com"}
Backgrounds transition using a fade animation by default. This can be
@@ -237,11 +228,11 @@
For example:
# Horizontal Slide 1
-
+
## Vertical Slide 1
-
+
## Vertical Slide 2
-
+
# Horizontal Slide 2
With this layout horizontal navigation will proceed directly from
@@ -272,15 +263,15 @@
There are a number of options that affect the output of figures within
reveal.js presentations:
- - `fig_width` and `fig_height` can be used to control the default
+- `fig_width` and `fig_height` can be used to control the default
figure width and height (7x5 is used by default)
- - `fig_retina` Specifies the scaling to perform for retina displays
+- `fig_retina` Specifies the scaling to perform for retina displays
(defaults to 2, which currently works for all widely used retina
- displays). Note that this only takes effect if you are using knitr
- \>= 1.5.21. Set to `null` to prevent retina scaling.
+ displays). Note that this only takes effect if you are using
+ knitr >= 1.5.21. Set to `null` to prevent retina scaling.
- - `fig_caption` controls whether figures are rendered with captions
+- `fig_caption` controls whether figures are rendered with captions
For example:
@@ -299,15 +290,15 @@
reveal.js presentations for rendering LaTeX and MathML equations. You
can use the `mathjax` option to control how MathJax is included:
- - Specify “default” to use an https URL from the official MathJax CDN.
+- Specify “default” to use an https URL from the official MathJax CDN.
- - Specify “local” to use a local version of MathJax (which is copied
+- Specify “local” to use a local version of MathJax (which is copied
into the output directory). Note that when using “local” you also
need to set the `self_contained` option to false.
- - Specify an alternate URL to load MathJax from another location.
+- Specify an alternate URL to load MathJax from another location.
- - Specify null to exclude MathJax entirely.
+- Specify null to exclude MathJax entirely.
For example, to use a local copy of MathJax:
@@ -380,7 +371,7 @@
option. Plugins currently supported include:
| Plugin | Description |
-| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+|------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| [notes](https://revealjs.com/speaker-view/) | Present per-slide notes in a separate browser window. |
| [zoom](http://lab.hakim.se/zoom-js/) | Zoom in and out of selected content with Alt+Click. |
| [search](https://github.com/hakimel/reveal.js/blob/master/plugin/search/search.js) | Find a text string anywhere in the slides and show the next occurrence to the user. |
@@ -473,3 +464,10 @@
All documents located in the same directory as `_output.yaml` will
inherit it’s options. Options defined explicitly within documents will
override those specified in the shared options file.
+
+## Code of Conduct
+
+Please note that the revealjs project is released with a [Contributor
+Code of
+Conduct](https://pkgs.rstudio.com/revealjs/CODE_OF_CONDUCT.html). By
+contributing to this project, you agree to abide by its terms.