Metadata-Version: 2.1
Name: sphinx-revealjs
Version: 1.4.2
Summary: Sphinx extension with theme to generate Reveal.js presentation
Home-page: https://github.com/attakei/sphinx-revealjs
License: Apache-2.0
Author: Kazuya Takei
Author-email: myself@attakei.net
Requires-Python: >=3.6,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Sphinx
Classifier: Framework :: Sphinx :: Extension
Classifier: Framework :: Sphinx :: Theme
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Documentation :: Sphinx
Classifier: Topic :: Multimedia :: Graphics :: Presentation
Requires-Dist: docutils
Requires-Dist: sphinx
Project-URL: Repository, https://github.com/attakei/sphinx-revealjs
Description-Content-Type: text/x-rst

sphinx-revealjs
===============

.. image:: https://img.shields.io/pypi/v/sphinx-revealjs.svg
    :target: https://pypi.org/project/sphinx-revealjs/

.. image:: https://github.com/attakei/sphinx-revealjs/workflows/Testings/badge.svg
    :target: https://github.com/attakei/sphinx-revealjs/actions

.. image:: https://travis-ci.org/attakei/sphinx-revealjs.svg?branch=master
    :target: https://travis-ci.org/attakei/sphinx-revealjs

.. image:: https://readthedocs.org/projects/sphinx-revealjs/badge/?version=latest
    :target: https://sphinx-revealjs.readthedocs.io/en/latest/?badge=latest
    :alt: 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 `the documentation <https://sphinx-revealjs.readthedocs.io/en/latest/>`_.

Installation
------------

.. code-block:: bash

    $ pip install sphinx-revealjs


Usage
-----

1. Create your sphinx documentation
2. Edit `conf.py` to use this extension

    .. code-block:: python

        extensions = [
            'sphinx_revealjs',
        ]

3. Write source for standard document style

4. Build sources as Reveal.js presentation

    .. code-block:: bash

        $ make revealjs

Change logs
-----------

See `it <./CHANGES.rst>`_

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.

Contributings
-------------

GitHub repository does not have reveal.js library.

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

.. code-block:: bash

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

Copyright
---------

Apache-2.0 license. Please see `LICENSE <./LICENSE>`_.

