When you think about the power of Python, the clean language or powerful standard library may come to mind. You might certainly point to the external packages too. But what about the relative ease of picking up new libraries or even parts of the standard library? Documentation plays an important role there. And the tools in the Python space for building solid documentation and even publishing articles and books involving live code are huge assets. 
 

 
In this episode, we have Paul Everitt, Pradyun Gedam, Chris Holdgraf, and Chris Sewell to update us on Sphinx, MyST-Parser, ExecutableBooks, JupyerBook, Sphinx Themes, and much more. 
 
Links from the show 
 
<div>Pradyun’s personal website: <a href="https://pradyunsg.me/" target="_blank" rel="noopener">pradyunsg.me</a> 
Chris’s personal website: <a href="https://predictablynoisy.com/" target="_blank" rel="noopener">predictablynoisy.com</a> 
Paul Everitt: <a href="https://twitter.com/paulweveritt" target="_blank" rel="noopener">@paulweveritt</a> 
Paul's free Sphinx and Markdown course: <a href="https://training.talkpython.fm/courses/static-sites-with-sphinx-and-markdown" target="_blank" rel="noopener">training.talkpython.fm</a> 
 
Sphinx: <a href="https://www.sphinx-doc.org" target="_blank" rel="noopener">sphinx-doc.org</a> 
Python documentation: <a href="https://docs.python.org/3/" target="_blank" rel="noopener">docs.python.org</a> 
ExecutableBooks: <a href="https://executablebooks.org/en/latest/" target="_blank" rel="noopener">executablebooks.org</a> 
Jupyter Book: <a href="https://jupyterbook.org/intro.html" target="_blank" rel="noopener">jupyterbook.org</a> 
MyST parser: <a href="https://myst-parser.readthedocs.io/en/latest/" target="_blank" rel="noopener">myst-parser.readthedocs.io</a> 
Sphinx Book Theme: <a href="https://sphinx-book-theme.readthedocs.io/" target="_blank" rel="noopener">sphinx-book-theme.readthedocs.io</a> 
PyData Sphinx Theme: <a href="https://pydata-sphinx-theme.readthedocs.io/en/latest/" target="_blank" rel="noopener">pydata-sphinx-theme.readthedocs.io</a> 
Sphinx Themes Gallery: <a href="https://sphinx-themes.org/" target="_blank" rel="noopener">sphinx-themes.org</a> 
Furo Theme: <a href="https://pradyunsg.me/furo/" target="_blank" rel="noopener">pradyunsg.me</a> 
sphinx-theme-builder: <a href="https://github.com/pradyunsg/sphinx-theme-builder" target="_blank" rel="noopener">github.com</a> 
Python Documentation WG issue tracker: <a href="https://github.com/python/docs-community/" target="_blank" rel="noopener">github.com</a> 
ReadTheDocs CZI: <a href="Funding: https://blog.readthedocs.com/czi-grant-announcement/" target="_blank" rel="noopener">blog.readthedocs.com</a> 
Pandoc: <a href="https://pandoc.org/" target="_blank" rel="noopener">pandoc.org</a> 
Google circa 1996: <a href="http://web.archive.org/web/19990117032727/http://www.google.com/" target="_blank" rel="noopener">web.archive.org</a> 
Python doc example: <a href="​​https://docs.python.org/3/library/constants.html" target="_blank" rel="noopener">docs.python.org</a> 
Tailwind doc example: <a href="https://tailwindcss.com/docs/installation" target="_blank" rel="noopener">tailwindcss.com/docs</a> 
Typora app: <a href="https://typora.io/" target="_blank" rel="noopener">typora.io</a> 
CommonMark: <a href="https://commonmark.org/" target="_blank" rel="noopener">commonmark.org</a> 
Watch this episode on YouTube: <a href="https://www.youtube.com/watch?v=_Lv_8QWwL8g" target="_blank" rel="noopener">youtube.com</a> 
Episode transcripts: <a href="https://talkpython.fm/episodes/transcript/354/sphinx-myst-and-python-docs-in-2022" target="_blank" rel="noopener">talkpython.fm</a> 
 
--- Stay in touch with us --- 
Subscribe on YouTube: <a href="https://talkpython.fm/youtube" target="_blank" rel="noopener">youtube.com</a> 
Follow Talk Python on Twitter: <a href="https://twitter.com/talkpython" target="_blank" rel="noopener">@talkpython</a> 
Follow Michael on Twitter: <a href="https://twitter.com/mkennedy" target="_blank" rel="noopener">@mkennedy</a> </div> 
Sponsors 
<a href='https://talkpython.fm/signalwire'>SignalWire</a>
<a href='https://talkpython.fm/tonic'>Tonic</a>
<a href='https://talkpython.fm/training'>Talk Python Training</a>

Podurama

Home

Trending

Personal

Your Podcasts

New Episodes

My Files

Favourite Episodes

Tags (Folders)

Recently Played

Bookmarks

Followed Playlists

#354: Sphinx, MyST, and Python Docs in 2022

Talk Python To Me