Skip to main content

Sphinx extension with theme to generate Reveal.js presentation

Project description

https://img.shields.io/pypi/v/sphinx-revealjs.svg https://github.com/attakei/sphinx-revealjs/actions/workflows/main.yml/badge.svg Documentation Status

Sphinx extension with theme to generate Reveal.js presentation

Overview

This extension generate Reveal.js presentation from standard reStructuredText.

It include theses features.

  • Custom builder to translate from reST to reveal.js style HTML

  • Template to be enable to render presentation local independent

For more information, refer to the documentation.

Installation

$ pip install sphinx-revealjs

Usage

  1. Create your sphinx documentation

  2. Edit conf.py to use this extension

    extensions = [
        'sphinx_revealjs',
    ]
  3. Write source for standard document style

  4. Build sources as Reveal.js presentation

    $ make revealjs

Change logs

See it

Policy for following to Reveal.js version

This is implemented based Reveal.js. I plan to update it at patch-version for catch up when new Reveal.js version released.

  • If Reveal.js updated minor or patch version, sphinx-revealjs update patch version.

  • If Reveal.js updated major version, sphinx-revealjs update minor version with compatible for two versions.

Contributing

GitHub repository does not have reveal.js library.

If you use from GitHub and editable mode, Run tools/fetch_revealjs.py after install.

$ git clone https://github.com/attakei/sphinx-revealjs
$ cd sphinx-revealjs
$ python tools/fetch_revealjs.py

For more information, See CONTRIBUTING.rst and “contributing” page in documentation.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx_revealjs-3.0.5.tar.gz (2.4 MB view details)

Uploaded Source

Built Distribution

sphinx_revealjs-3.0.5-py3-none-any.whl (2.4 MB view details)

Uploaded Python 3

File details

Details for the file sphinx_revealjs-3.0.5.tar.gz.

File metadata

  • Download URL: sphinx_revealjs-3.0.5.tar.gz
  • Upload date:
  • Size: 2.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for sphinx_revealjs-3.0.5.tar.gz
Algorithm Hash digest
SHA256 7121568d3e2f0e22cf524b3305c951d8b6bb26b13fd665241bc1eabd640de03d
MD5 74ddc5e9ada517283eb13fba84df0f19
BLAKE2b-256 799dbcbebb2a71465945c1264d9855fdb3bc07c0fba93cb83b90e1eefbfd532b

See more details on using hashes here.

File details

Details for the file sphinx_revealjs-3.0.5-py3-none-any.whl.

File metadata

File hashes

Hashes for sphinx_revealjs-3.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 b19412d214339f47517884dde67ef8d0dcd9c367c2b41bd96666407009b21376
MD5 609ece198a47ad44b0e089c113ebe3fb
BLAKE2b-256 1228f6bc446b26d9ece4c591a0c3d26193b985826f9f726b55a5c0741947f8e8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page