Skip to content

A Sphinx extension for creating slideshows using Bootstrap Carousels.

License

Notifications You must be signed in to change notification settings

Robpol86/sphinx-carousel

Repository files navigation

sphinx-carousel

Github-CI Coverage Status Documentation Status Code style: black PyPI

A Sphinx extension for creating slideshows using Bootstrap 5 Carousels.

📖 See the documentation at https://sphinx-carousel.readthedocs.io

Install

Requires Python 3.6 or greater and Sphinx 4.0 or greater.

pip install sphinx-carousel

Example

# conf.py
extensions = [
    "sphinx_carousel.carousel",
]
===============
An RST Document
===============

.. carousel::

    .. image:: https://i.imgur.com/fmJnevTl.jpg
        :target: https://i.imgur.com/fmJnevT.jpg
    .. image:: https://i.imgur.com/ppGH90Jl.jpg
    .. figure:: https://i.imgur.com/fWyn9A2l.jpg

        An Example Image

        Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut
        labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris
        nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit
        esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt
        in culpa qui officia deserunt mollit anim id est laborum.