An MkDocs plugin that provides Ultralytics Docs customizations at https://docs.ultralytics.com.
Project description
MkDocs Ultralytics Plugin
The MkDocs Ultralytics Plugin is an easy-to-use plugin that generates meta description and image tags based on the first paragraph and the first image in a page. It's specifically designed for MkDocs and provides a seamless integration to enhance your documentation.
Installation
To install the MkDocs Ultralytics Plugin from pip, run the following command:
pip install mkdocs-ultralytics-plugin
Usage
To enable the plugin in your MkDocs project, add it to the plugins section of your mkdocs.yml file:
plugins:
- mkdocstrings
- search
- ultralytics
How it works
The plugin works by extracting the first paragraph and the first image (if available) from your Markdown content. It then generates and adds the appropriate meta description and image tags to the page's <head> section.
Meta Description
The meta description is extracted from the first paragraph of your Markdown content. The generated description is then added to the page's <head> section as a <meta name="description"> tag.
Meta Image
The meta image is extracted from the first image (if available) in your Markdown content. The generated image URL is then added to the page's <head> section as a <meta property="og:image"> tag.
Plugin Code
The core functionality of the plugin is implemented in plugin.py, which defines the MetaPlugin class:
from bs4 import BeautifulSoup
from mkdocs.plugins import BasePlugin
class MetaPlugin(BasePlugin):
def on_page_content(self, content, page, config, files):
# ... (code to generate meta description and image)
def on_post_page(self, output, page, config):
# ... (code to update the output with the generated meta tags)
License
This project is licensed under the AGPL-3.0 License. For more information, see the LICENSE file.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mkdocs-ultralytics-plugin-0.0.14.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2de0cdc3bd26a7bfacf89c5c9dac97b06d3a30041df253ae4220c03d5d9a35d6 |
|
| MD5 | 418d834e179c4eea23304fb0d94be455 |
|
| BLAKE2b-256 | 7f8874a0d052c718f4ab1707165b611ab3ee2f3f44fc19ec96e146cdcca1e69d |
Hashes for mkdocs_ultralytics_plugin-0.0.14-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d40f35d05cb47c26b26f0411851c0ddbb5c4b1f427b84df2187a73b60af1275e |
|
| MD5 | 4b1e83d8a760f71f5f55d5743a3687a2 |
|
| BLAKE2b-256 | c4a0579ca9c9403b434c071c874eb385bf85365016de443b735e2b0004b7600c |
