dotfiles/emacs/.emacs.d/elpa/org-re-reveal-ref-20191022.1426

Sample presentation with bibliography

Introduction

Installation

• Install reveal.js and org-re-reveal (from MELPA or GitLab)

• Activate org-re-reveal-ref

  • Place this directory into your load path or install it from MELPA

  • Load package manually (M-x load-library followed by org-re-reveal-ref) or place (require 'org-re-reveal-ref) into your "~/.emacs" and restart

• Load an Org file and export it to HTML

  • Make sure that reveal.js is available in your current directory (e.g., as sub-directory or symbolic link)

  • Load "README.org" (coming with org-re-reveal-ref)

  • Export to HTML: Press C-c C-e v v (write HTML file) or C-c C-e v b (write HTML file and open in browser)

Rationale

• Teaching and learning resources should be free and open

  • In support of Sustainable Development Goal 4 (SDG 4)

  • Open Educational Resources (OER)

    • See cite:HWS+10 for technical and legal requirements of OER

• My OER requirements (see cite:Lec19)

  • (Re-) Usable with FLOSS

  • Following paradigm of single sourcing (see cite:Roc01)

  • Platform independent, also offline use

  • Support proper license attribution beyond copy&paste

    • Tool support with emacs-reveal, which embeds org-re-reveal-ref (see cite:Lec19b,Lec19c)

Reveal.js presentations

Org-re-reveal

• Org-re-reveal provides Org mode export functionality to generate HTML presentations with reveal.js

  • See cite:SD11 for an introduction to Org mode

• Such presentations offer lots of features

  • Themes, animations, and slide transitions

  • Speaker’s view with preview, notes, and timer

  • Embedding of images, audio, video, mathematical formulas

  • Many more

Org-re-reveal-ref

• Package org-re-reveal-ref adds support for citations and bibliography to org-re-reveal

  • Use citations of org-ref as usual

  • With export to reveal.js and PDF

• FLOSS software bundle emacs-reveal contains org-re-reveal-ref

  • Configuration of additional plugins for reveal.js, in particular audio explanations

  • Automatic license attribution for OER figures

  • See OER presentations for a course on operating systems for an example

Conclusions

Summary

• Use cite commands as usual

• Insert bibliography on separate slide with printbibliography

  • See next slide

  • Important: You must use a CUSTOM_ID on that slide, whose value is that of customizable variable org-re-reveal-ref-bib

Bibliography

printbibliography:references.bib

License Information

• This file is published under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.