در MkDocs با استفاده از اصول مانند هر ژنراتور سایت استاتیک دیگری در اطراف.
از آن نیاز به توسعه برای ویرایش یک فایل پیکربندی (MKDocs با استفاده از YAML برای این)، ایجاد قالب صفحه (از طریق Jinja2)، و اضافه کردن مطالب خود را در یک پوشه خاص (به عنوان فایل های نشانه دار).
او سپس می توانید باز کردن پایتون CLI اجرا چند فرمان و جمع آوری یک سایت HTML نهایی از تمام منابع خود را.
اگر او می خواهد برای به روز رسانی چیزی، او می تواند تمام تغییرات او در منبع اصلی و دوباره کامپایل سایت از طریق کنسول.
محصول نهایی مجموعه ای از HTML، CSS، JS و دارایی های ثابت است که می تواند با هر نوع وب سرور موجود در بازار به میزبانی است.
MkDocs پشتیبانی از تعداد نامحدودی از صفحات، نسل منوی اتوماتیک، تم نهایی وب سایت، صفحه داده های متا، و همراه با یک ساختار پروژه عمومی که در آن به آغاز شده است.
MkDocs با هر دو نسخه از زبان برنامه نویسی پایتون، 2.x و 3.x و کار می کند
چه جدید در این نسخه است:
در بارگزاری فایل های 404.html اگر آنها برای جریان وجود داشته باشد تم.
رفع اشکال:
میله طولانی منو، جدول رندر و کد برجسته در MkDocs و ReadTheDocs تم.
موضوع را با کد google_analytics.
__pycache__ حذف از تار بسته.
لینک های نشانه دار که در صفحه جاری را به یک لنگر است.
هنوز کلاس خوبی CSS prettyprint به همه HTML اضافه نکنید، فقط آن را در موضوع MkDocs اضافه کنید.
عنوان بخش ها در موضوع ReadTheDocs.
استفاده از ناظر رای گیری در دیده بان بنابراین بازسازی آثار در فایل سیستم بدون inotify.
بهبود خروجی خطا برای خطاهای مربوط پیکربندی رایج است.
جدید در نسخه 0.13.3 است:
در بارگزاری فایل های 404.html اگر آنها برای تم فعلی وجود داشته باشد.
رفع اشکال:
میله طولانی منو، جدول رندر و کد برجسته در MkDocs و ReadTheDocs تم.
موضوع را با کد google_analytics.
__pycache__ حذف از تار بسته.
لینک های نشانه دار که در صفحه جاری را به یک لنگر است.
هنوز کلاس خوبی CSS prettyprint به همه HTML اضافه نکنید، فقط آن را در موضوع MkDocs اضافه کنید.
عنوان بخش ها در موضوع ReadTheDocs.
استفاده از ناظر رای گیری در دیده بان بنابراین بازسازی آثار در فایل سیستم بدون inotify.
بهبود خروجی خطا برای خطاهای مربوط پیکربندی رایج است.
جدید در نسخه 0.12.2 است:
در بارگزاری فایل های 404.html اگر آنها برای تم فعلی وجود داشته باشد.
رفع اشکال:
میله طولانی منو، جدول رندر و کد برجسته در MkDocs و ReadTheDocs تم.
موضوع را با کد google_analytics.
__pycache__ حذف از تار بسته.
لینک های نشانه دار که در صفحه جاری را به یک لنگر است.
هنوز کلاس خوبی CSS prettyprint به همه HTML اضافه نکنید، فقط آن را در موضوع MkDocs اضافه کنید.
عنوان بخش ها در موضوع ReadTheDocs.
استفاده از ناظر رای گیری در دیده بان بنابراین بازسازی آثار در فایل سیستم بدون inotify.
بهبود خروجی خطا برای خطاهای مربوط پیکربندی رایج است.
جدید در نسخه 0.11.1 است:
در بارگزاری فایل های 404.html اگر آنها برای تم فعلی وجود داشته باشد.
رفع اشکال:
میله طولانی منو، جدول رندر و کد برجسته در MkDocs و ReadTheDocs تم.
موضوع را با کد google_analytics.
__pycache__ حذف از تار بسته.
لینک های نشانه دار که در صفحه جاری را به یک لنگر است.
هنوز کلاس خوبی CSS prettyprint به همه HTML اضافه نکنید، فقط آن را در موضوع MkDocs اضافه کنید.
عنوان بخش ها در موضوع ReadTheDocs.
استفاده از ناظر رای گیری در دیده بان بنابراین بازسازی آثار در فایل سیستم بدون inotify.
بهبود خروجی خطا برای خطاهای مربوط پیکربندی رایج است.
مورد نیاز:
Jinja به 2.7.1 و یا بالاتر
مدل های نشانه گذاری 2.3.1 و یا بالاتر
PyYAML 3.1 و یا بالاتر
نظر یافت نشد