در Markdoc بسیار عالی برای اسناد و مدارک فنی، راهنما، ویکی پروژه داخلی، و یا نسل های سایت استاتیک می باشد.
برای مستندات فنی / دفترچه راهنما، Markdoc می توان برای ارسال و رندر راهنماهای دست نوشته ها و دفترچه راهنما برای نرم افزار است. اسناد و مدارک به طور معمول چنین جداگانه خواهد بود از اسناد و مدارک API به طور خودکار تولید، و ممکن است یک دید سطح بالاتر از اسناد API به تنهایی است. این ممکن است برای اسناد مشتری برای برنامه های کاربردی وب / رومیزی، و یا حتی اسناد توسعه قاب استفاده می شود.
برای داخلی پروژه ویکی، ویکی Markdoc از یک فایل ساده متن در هر صفحه تنها تشکیل شده است. با ترکیب یک ویکی با DVCS (مانند جیوه و یا دستگاه گوارش)، شما می توانید با چند نفر دیگر همکاری کنند. استفاده از DVCS برای پیگیری، به اشتراک گذاری و ادغام تغییرات با یک دیگر، و مشاهده ویکی برون تاریخ است.
برای استاتیک نسل سایت، Markdoc ویکیهای به فایل های HTML خام و رسانه تبدیل می کند. این اجازه می دهد تا شما را به مدیریت یک وبلاگ، وب سایت های شخصی و یا مجموعه ای از صفحات در ویکی Markdoc، شاید با سبک های CSS سفارشی، و HTML رندر به یک وب سایت منتشر می شود. Markdoc نیاز بر روی سایت میزبان نصب شده است، از HTML حاصل کاملا مستقل است
ویژگی ها:.
تنظیم ردیابی Google Analytics در یک خط از پیکربندی.
ویکیهای Barebones که درست مثل دایرکتوری با فایل های متنی فرمت نشانه دار در آنها نگاه کنید.
سرور HTTP ساخته شده در نرم افزار و WSGI برای خدمت به ویکی وارد شده با یک فرماندهی واحد.
ایجاد مستمر (از طریق rsync را) به معنی سرور می تواند در حالی که در حال اجرا Markdoc دوباره کامپایل ویکی. فقط مرورگر خود را برای دیدن تغییرات تازه کردن.
اضافه نحو Pygments طراحی برجسته به ویکی Markdoc خود را با یک پارامتر پیکربندی است.
Markdoc نرم افزار حوزه عمومی است. آن را همیشه کاملا رایگان برای استفاده خواهد بود، و شما می توانید آن (در بخش و یا در کل) تحت هیچ شرایطی (منبع باز، اختصاصی و یا در غیر این صورت) بدون اسناد و یا توزیع مجدد encumberances.
مورد نیاز:
argparse
CherryPy
Jinja2
نشانه دار
Pygments
PyYAML
webob
پایتون 2.4 یا بالاتر
rsync را
نظر یافت نشد