Metadata-Version: 2.1
Name: sphinxcontrib-budoux
Version: 0.1.3
Summary: This is Sphinx extension to break line of heading texts by BudouX.
License: Apache-2.0
Author: Kazuya Takei
Author-email: myself@attakei.net
Requires-Python: >=3.7,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Sphinx
Classifier: Framework :: Sphinx :: Extension
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Documentation :: Sphinx
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Text Processing :: Markup :: HTML
Requires-Dist: BudouX
Requires-Dist: Sphinx
Requires-Dist: beautifulsoup4
Description-Content-Type: text/x-rst

====================
sphinxcontrib-budoux
====================

Overview
========

This is Sphinx extension to break line of heading texts by BudouX.

Simple example
--------------

From source is:

.. code-block:: rst

   あなたに寄り添う最先端のテクノロジー
   ====================================

Output without this is:

.. code-block:: html

   <h1>あなたに寄り添う最先端のテクノロジー</h1>

Output with this is:

.. code-block:: html

   <h1 style="word-break: keep-all; overflow-wrap: break-word;">あなたに<wbr/>寄り添う<wbr/>最先端の<wbr/>テクノロジー</h1>

Installation
============

.. code-block:: console

   pip install sphinxcontrib-budoux

Usage
=====

.. code-block:: python

   extensions = [
       "sphinxcontrib.budoux",
   ]
   
   # Tag to ijnect for splitted texts
   budoux_split_tag = "wbr"
   # Style for splitted-tag
   budoux_split_style = "budoux_split_style", "word-break: keep-all; overflow-wrap: break-word;"
   # Target tags for apply BudouX
   budoux_targets = ["h1", "h2"]

Note
====

Main targets for edit are heading text, not but contents of paragraph.

If you set ``p``, ``li`` and others into `budoux_targets``, this may not work correctly that you think.

Example
=======

See `doc <doc/>`_ (written by Japanese).

