Metadata-Version: 2.1
Name: sphinxcontrib-sass
Version: 0.3.4
Summary: Sphinx extension to compile sass to css in running sphinx-build.
Author-email: Kazuya Takei <myself@attakei.net>
Description-Content-Type: text/x-rst
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Sphinx
Classifier: Framework :: Sphinx :: Extension
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Documentation :: Sphinx
Requires-Dist: Sphinx
Requires-Dist: libsass
Requires-Dist: black >=22.3.0,<23 ; extra == "test"
Requires-Dist: flake8 >=3.8.4,<4 ; extra == "test"
Requires-Dist: pytest >=6.2.2,<7 ; extra == "test"
Project-URL: Home, https://github.com/attakei-lab/sphinxcontrib-sass
Project-URL: Source, https://github.com/attakei-lab/sphinxcontrib-sass
Provides-Extra: test

==================
sphinxcontrib-sass
==================

Overview
========

Sphinx extension to compile sass to css in running sphinx-build.

Install
=======

.. code-block:: bash

   pip install sphinxcontrib-sass

Usage
=====

#. Install from source
#. Edit ``conf.py``

   * Set ``sphinxcontrib.sass`` into ``extensions``
   * Configure for ``sphinxcontrib.sass`` (see example)
#. Run ``sphinx-build``

Options
-------

``sass_src_dir``
  Root directory of SASS source files.

``sass_out_dir``
  Root directory to output compiled css files.

``sass_targets``
  File map of sources and outputs

``sass_output_style``
  Output style to generate css by libsass.

``sass_include_paths``
  Include path configuration for libsass.

Example
=======

.. code-block:: python

   extensions = [
       "sphinxcontrib.sass",
   ]
   html_css_files = ["css/custom.css"]

   sass_src_dir = "_sass"
   sass_out_dir = "_static/css"
   sass_targets = {
    "custom.scss": "custom.css"
   }

License
=======

Apache 2.0. See `it <./LICENSE>`_.

