Ultralytics:main
from
ultralytics:clean-exp
Ultralytics Docs are the gateway to understanding and utilizing our cutting-edge machine learning tools. These documents are deployed to https://docs.ultralytics.com for your convenience.
To install the ultralytics package in developer mode, ensure you have Git and Python 3 installed on your system. Then, follow these steps:
Clone the ultralytics repository to your local machine using Git:
git clone https://github.com/ultralytics/ultralytics.git
Navigate to the cloned repository's root directory:
cd ultralytics
Install the package in developer mode using pip (or pip3 for Python 3):
pip install -e '.[dev]'
The mkdocs serve
command builds and serves a local version of your MkDocs documentation, ideal for development and testing:
mkdocs serve
mkdocs
is the main MkDocs command-line interface.serve
is the subcommand to build and locally serve your documentation.๐ง Note:
mkdocs serve
supports live reloading.CTRL+C
.Supporting multi-language documentation? Follow these steps:
Stage all new language *.md files with Git:
git add docs/**/*.md -f
Build all languages to the /site
folder, ensuring relevant root-level files are present:
# Clear existing /site directory
rm -rf site
# Loop through each language config file and build
mkdocs build -f docs/mkdocs.yml
for file in docs/mkdocs_*.yml; do
echo "Building MkDocs site with $file"
mkdocs build -f "$file"
done
To preview your site, initiate a simple HTTP server:
cd site
python -m http.server
# Open in your preferred browser
http://localhost:8000
.Choose a hosting provider and deployment method for your MkDocs documentation:
mkdocs.yml
with deployment settings.mkdocs deploy
to build and deploy your site.mkdocs gh-deploy
We cherish the community's input as it drives Ultralytics open-source initiatives. Dive into the Contributing Guide and share your thoughts via our Survey. A heartfelt thank you ๐ to each contributor!
Ultralytics Docs presents two licensing options:
For Ultralytics bug reports and feature requests please visit GitHub Issues. Become a member of the Ultralytics Discord, Reddit, or Forums for asking questions, sharing projects, learning discussions, or for help with all things Ultralytics!
Press p or to see the previous file or, n or to see the next file