Skip to main content

A Sphinx extension for embedding YouTube video links.

Project description

sphinx-youtube-links

sphinx-youtube-links adds a Sphinx directive that creates styled YouTube video links with automatic title extraction.

Basic usage

To add a YouTube link to your document, use the youtube directive with the desired YouTube URL:

.. youtube:: https://www.youtube.com/watch?v=dQw4w9WgXcQ

You can also specify a custom title:

.. youtube:: https://www.youtube.com/watch?v=dQw4w9WgXcQ
   :title: Custom Video Title

Project setup

sphinx-youtube-links is published on PyPI and can be installed with:

pip install sphinx-youtube-links

After adding sphinx-youtube-links to your Python project, update your Sphinx's conf.py file to include sphinx-youtube-links as one of its extensions:

extensions = [
    "sphinx_youtube_links"
]

Community and support

You can report any issues or bugs on the project's GitHub repository.

youtube-links is covered by the Ubuntu Code of Conduct.

License and copyright

youtube-links is released under the GPL-3.0 license.

© 2025 Canonical Ltd.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx_youtube_links-0.0.3.tar.gz (77.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sphinx_youtube_links-0.0.3-py3-none-any.whl (17.6 kB view details)

Uploaded Python 3

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page