Metadata-Version: 2.1
Name: sphinx-jekyll-builder
Version: 0.1.6
Summary: sphinx builder that outputs jekyll compatible markdown files with frontmatter
Home-page: https://github.com/codejamninja/sphinx-jekyll-builder
Author: Jam Risser
Author-email: jam@codejam.ninja
License: MIT
Keywords: sphinx docs documentation jekyll
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: alabaster (==0.7.12)
Requires-Dist: Babel (==2.6.0)
Requires-Dist: certifi (==2018.10.15)
Requires-Dist: chardet (==3.0.4)
Requires-Dist: docutils (==0.14)
Requires-Dist: idna (==2.7)
Requires-Dist: imagesize (==1.1.0)
Requires-Dist: Jinja2 (==2.10)
Requires-Dist: MarkupSafe (==1.1.0)
Requires-Dist: munch (==2.3.2)
Requires-Dist: packaging (==18.0)
Requires-Dist: Pygments (==2.2.0)
Requires-Dist: pyparsing (==2.3.0)
Requires-Dist: pytz (==2018.7)
Requires-Dist: PyYAML (==3.13)
Requires-Dist: requests (==2.20.1)
Requires-Dist: six (==1.11.0)
Requires-Dist: snowballstemmer (==1.2.1)
Requires-Dist: Sphinx (==1.8.1)
Requires-Dist: sphinx-markdown-builder (==0.1.6)
Requires-Dist: sphinxcontrib-websupport (==1.1.0)
Requires-Dist: typing (==3.6.6)
Requires-Dist: urllib3 (==1.24.1)

sphinx-jekyll-builder
=====================

|PyPI| |PyPI - Downloads| |PyPI - Python Version| |GitHub stars|

   sphinx builder that outputs jekyll compatible markdown files with
   frontmatter

Please ★ this repo if you found it useful ★ ★ ★

Features
--------

-  Generates markdown
-  Supports frontmatter
-  Compatible with `jekyll <https://jekyllrb.com>`__
-  Compatible with `gatsby <https://www.gatsbyjs.org/>`__

Installation
------------

.. code:: sh

   pip3 install sphinx-jekyll-builder

Dependencies
------------

-  `Python 3 <https://www.python.org>`__

Usage
-----

Load extension in configuration.

*conf.py*

.. code:: py

   extensions = [
       'sphinx_jekyll_builder'
   ]

If using `recommonmark <https://github.com/rtfd/recommonmark>`__, make
sure you explicitly ignore the build files as they will conflict with
the system.

*conf.py*

.. code:: py

   exclude_patterns = [
       'build/*'
   ]

Build jekyll files with Makefile

.. code:: sh

   make jekyll

Build jekyll files with ``sphinx-build`` command

.. code:: sh

   cd docs
   sphinx-build -M jekyll ./ build

Support
-------

Submit an
`issue <https://github.com/codejamninja/sphinx-jekyll-builder/issues/new>`__

Screenshots
-----------

`Contribute <https://github.com/codejamninja/sphinx-jekyll-builder/blob/master/CONTRIBUTING.md>`__
a screenshot

Contributing
------------

Review the `guidelines for
contributing <https://github.com/codejamninja/sphinx-jekyll-builder/blob/master/CONTRIBUTING.md>`__

License
-------

`MIT
License <https://github.com/codejamninja/sphinx-jekyll-builder/blob/master/LICENSE>`__

`Jam Risser <https://codejam.ninja>`__ © 2018

Changelog
---------

Review the
`changelog <https://github.com/codejamninja/sphinx-jekyll-builder/blob/master/CHANGELOG.md>`__

Credits
-------

-  `Jam Risser <https://codejam.ninja>`__ - Author
-  `Matthew
   Brett <https://github.com/matthew-brett/nb2plots/blob/master/nb2plots/doctree2md.py>`__
   - doctree2md

Support on Liberapay
--------------------

A ridiculous amount of coffee ☕ ☕ ☕ was consumed in the process of
building this project.

`Add some fuel <https://liberapay.com/codejamninja/donate>`__ if you’d
like to keep me going!

|Liberapay receiving| |Liberapay patrons|

.. |PyPI| image:: https://img.shields.io/pypi/v/sphinx-jekyll-builder.svg?style=flat-square
   :target: https://pypi.org/project/sphinx-jekyll-builder
.. |PyPI - Downloads| image:: https://img.shields.io/pypi/dm/sphinx-jekyll-builder.svg?style=flat-square
   :target: https://pypi.org/project/sphinx-jekyll-builder
.. |PyPI - Python Version| image:: https://img.shields.io/pypi/pyversions/sphinx-jekyll-builder.svg?style=flat-square
   :target: https://pypi.org/project/sphinx-jekyll-builder
.. |GitHub stars| image:: https://img.shields.io/github/stars/codejamninja/sphinx-jekyll-builder.svg?style=flat-square&label=Stars
   :target: https://github.com/codejamninja/sphinx-jekyll-builder
.. |Liberapay receiving| image:: https://img.shields.io/liberapay/receives/codejamninja.svg?style=flat-square
   :target: https://liberapay.com/codejamninja/donate
.. |Liberapay patrons| image:: https://img.shields.io/liberapay/patrons/codejamninja.svg?style=flat-square
   :target: https://liberapay.com/codejamninja/donate


