Skip to main content

Sphinx extension for slides and extended tables.

Project description

kirlent_sphinx is a Sphinx extension that is primarily meant to be used with the Kırlent educational content management system, although it can be used as a regular Sphinx extension.

Features

kirlent_sphinx provides the following components:

Getting started

You can install kirlent_sphinx with pip:

pip install kirlent_sphinx

To enable it in your project, make the following changes in conf.py:

  • Add kirlent_sphinx to extensions:

    extensions = ["kirlent_sphinx"]
    
  • Set kirlent as the theme:

    html_theme = "kirlent"
    
  • Disable index generation:

    html_use_index = False
    

Usage

For the extended table directive, consult the documentation of the table_styling extension of the Cloud Sphinx Theme project.

The slide and speaker-notes directives are derived from the revealjs and rv_note directives of the sphinxjp.themes.revealjs project. The rv_small and rv_code directives of that project have been removed.

The Kırlent HTML theme uses pygments for code highlighting instead of highlight.js which is used by the original theme. In addition, it uses Tailwind utility classes for styling:

.. slide:: Slide title

   .. container:: columns

      .. container:: column w-1/3 bg-blue-lighter

         - item 1a
         - item 1b

      .. container:: column bg-red-lighter

         - item 2

   .. speaker-notes::

      some extra explanation

License

Copyright (C) 2019 H. Turgut Uyar <uyar@tekir.org>

kirlent_sphinx is released under the BSD license. Read the included LICENSE.txt file for details.

kirlent_sphinx contains code derived from the Cloud Sphinx Theme project which is released under the BSD license. Read the included LICENSE_cloud_spheme.txt file for details.

kirlent_sphinx contains code derived from the sphinxjp.themes.revealjs project which is released under the MIT license. Read the included LICENSE_sphinxjp.themes.revealjs.txt file for details.

kirlent_sphinx contains code from the RevealJS project which is released under the MIT license. Read the included LICENSE_revealjs.txt file for details.

kirlent_sphinx contains code from the Tailwind project which is released under the MIT license. Read the included LICENSE_tailwind.txt file for details.

Project details


Download files

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

Files for kirlent-sphinx, version 0.2.2
Filename, size File type Python version Upload date Hashes
Filename, size kirlent_sphinx-0.2.2-py3-none-any.whl (924.1 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size kirlent_sphinx-0.2.2.tar.gz (174.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page