Neoteroi/mkdocs-plugins
این مجموعه از افزونه‌های MkDocs برای بهبود قابلیت‌های مستندسازی در پروژه‌های مبتنی بر MkDocs طراحی شده است.
این افزونه‌ها به توسعه‌دهندگان کمک می‌کنند تا مستندات خود را حرفه‌ای‌تر، پویاتر و ساختاریافته‌تر ارائه دهند.
کاربرد:
این پلاگین‌ها قابلیت‌های جدیدی مثل نمایش پویا کد، مدیریت محتوای شرطی، افزودن تاریخ به صفحات، و یکپارچه‌سازی با ابزارهای دیگر را به MkDocs اضافه می‌کنند. ️
در چه شرایطی بهتره استفاده شود؟
وقتی که نیاز داری مستندات پیچیده، چندزبانه یا شرطی داشته باشی و بخوای از قابلیت‌های پیشرفته‌تری نسبت به حالت پیش‌فرض MkDocs استفاده کنی. همچنین برای تیم‌های توسعه که می‌خوان مستنداتشون با کد همیشه همگام باشه، عالیه.
چند مثال از موارد استفاده:
- نمایش خودکار تغییرات اخیر در مستندات با افزونه mkdocs-latest-changes
- افزودن متااطلاعات شرطی بر اساس محیط (مثل تست یا تولید)
- ایجاد محتوای پویا با استفاده از داده‌های خارجی (مثل JSON یا API)
- افزودن تاریخ انتشار یا به‌روزرسانی به صفحات مستندات
- ##MkDocs
- ##Documentation
- ##StaticSite
- ##Plugins
- ##DeveloperTools
- ##OpenSource
- ##TechDocs
- ##Python
- ##WebDev
- ##CodeDocs