Metadata-Version: 2.1
Name: latex-to-myst
Version: 0.0.1
Summary: LaTeX to MyST converter
Home-page: https://github.com/TK-21st/latex-to-myst
Author: Tingkai Liu
Author-email: tingkai.liu.21st@gmail.com
License: BSD 3-Clause license
Keywords: latex_to_myst
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.7
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: panflute (>=2.1)
Requires-Dist: numpy (>=1.20)

===========================
LaTeX to MyST Pandoc Filter
===========================
Latex-to-MyST implements a pandoc filter that converts a subset of LaTeX
environments to MyST directives. Although it is probably more pandoc compatible
to write a custom pandoc writer instead of using `RawBlocks` and `RawInline` to
mimics one, the existence of `panflute`_ makes it much easier for python
developers like me to work with filters instead of writers.

To use this filter, install the package by::

    pip install latex_to_myst

which adds a cli :code:`latex2myst`, which can be used to convert latex file to
myst by calling::

    latex2myst latex_file.tex markdown_file.md


LaTex Environments to MyST Directives
-------------------------------------
Latex-to-Myst Current supports:

1. All `amsthm`_ blocks,
2. Display Math
3. Subplots in the form of :code:`{list-table}`.

Many LaTeX environments need to be converted in to MyST directives.
`amsthm`_ for example, can be visualized using the *experimental*
`Sphinx-proof Directives`.

Unfortunately, MyST does not have native support for subplots, and neither
does `pandoc`_. To circumvent the problem, the best solution for now is to
use a :code:`{list-table}` directive. However, *this still needs to be fixed*
as there are some `known issues`_ that need to be addressed.


Work in Progress / Known Issues
-------------------------------
There are some `known issues`_ need to be addressed.


Credits
-------
This module uses `panflute`_ heavily.

.. _`panflute`: https://github.com/sergiocorreia/panflute
.. _`Sphinx-proof Directives`: https://sphinx-proof.readthedocs.io/en/latest/syntax.html#collection-of-directives
.. _`amsthm`: https://ctan.org/pkg/amsthm?lang=en`
.. _`known issues`: https://github.com/TK-21st/latex-to-myst/issues/1
.. _`pandoc`: https://pandoc.org/

=======
History
=======

0.0.1 (2021-11-04)
------------------

* First release on PyPI.

