کتابخانه
quill یه ویرایشگر متن غنی (Rich Text Editor) متن باز برای وبه که توی صفحه یه کادر ویرایش با نوار ابزار می سازه. کاربر بدون دونستن HTML می تونه متن رو پررنگ کنه، لیست و لینک بذاره، تیتر بزنه و عکس اضافه کنه. توی پنل مدیریت، بخش نظرات و فرم های محتوایی خیلی به کار میاد.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز BSD-3-Clause؛ هش هر فایل با منبع بررسی شده است.
۷۰۳ کیلوبایت· ۱۴۶ فایل· انتشار
SHA-256: f6157c72ac9b3f51cdead426335688a027b12405d9d6a4daadd38a676b2d7ff2
quill یه ویرایشگر متن غنی برای وبه که با جاوااسکریپت کار می کنه و روی npm هم منتشر شده. کارش ساده ست: یه div معمولی رو تبدیل می کنه به کادر ویرایشی که شبیه ویرایشگرهای آشنای نرم افزارهای متنی رفتار می کنه. مشکلی که حل می کنه هم مشخصه. اگه توی پنل سایتت فیلدی داری که کاربرها باید توش متن قالب بندی شده بنویسن، نمی خوای ازشون بخوای تگ HTML بنویسن. quill این کار رو برات انجام می ده.
یه ویژگی مهمش اینه که محتوا رو فقط به شکل HTML نگه نمی داره. فرمت داخلی اش اسمش Delta هست، یه ساختار JSON که محتوا و تغییرات متن رو توصیف می کنه. اگه باید محتوا رو توی دیتابیس ذخیره کنی یا بین چند کاربر همگام کنی، همین فرمت کارت رو راحت تر می کنه. دو ظاهر آماده هم داره: یکی با نوار ابزار ثابت بالای کادر و یکی با نوار ابزار شناور که با انتخاب متن ظاهر می شه. ساختارش ماژولیه و می تونی فرمت ها و ماژول های خودت رو هم بهش اضافه کنی.
برای کی مناسبه؟ برای توسعه دهنده هایی که می خوان توی پنل مدیریت، سیستم تیکت، بخش نظرات یا ویرایش مقاله یه ویرایشگر سبک و قابل شخصی سازی بذارن. اگه سایتت وردپرسیه و فقط می خوای نوشته بنویسی، ویرایشگر خود وردپرس کارت رو راه می ندازه و به quill نیازی نداری. اگه هم دنبال صفحه سازی با درگ و دراپ بلوک هستی، quill جواب نمی ده، چون ویرایشگر متنه و صفحه ساز نیست.
برای سایت های فارسی چند نکته رو حتما چک کن. اول راست به چپ بودن متن: quill این امکان رو داره، ولی باید توی تنظیمات نوار ابزار و استایل کادر مطمئن بشی همه چیز درست نشون داده می شه. دوم فونت: فونت فارسی رو با CSS خودت روی کادر ویرایش بذار تا با بقیه سایت هماهنگ باشه. سوم عکس: به طور پیش فرض عکس ها داخل خود محتوا ذخیره می شن، پس اگه حجم دیتابیس برات مهمه، باید یه روش آپلود جدا بنویسی. چهارم، و از همه مهم تر، امنیت: هر محتوایی که از کاربر می گیری رو سمت سرور هم پاکسازی کن و فقط به فیلتر مرورگر تکیه نکن.
نسخه های رسمی و بدون تغییر quill توی مخزن داخلی ما هم در دسترسه. یعنی وقتی دسترسی به منابع بین المللی کند یا قطعه، می تونی فایل ها رو از همین جا بگیری و روی هاست خودت بذاری.
برای استفاده از quill توی یه صفحه لازم نیست پروژه رو پیچیده کنی. کد آماده پایین همین صفحه رو توی سایتت بذار و این قدم ها رو جلو برو:
اگه از npm استفاده می کنی، بسته quill رو نصب کن و توی پروژه import کن. اگه فقط یه سایت ساده داری، همون فایل های آماده کافیه. بعد از اینکه راه افتاد، اول با یه متن آزمایشی چک کن که لیست ها، لینک ها و راست به چپ بودن متن فارسی درست ذخیره و دوباره نمایش داده می شن.
quill یه ویرایشگر متن غنی و متن بازه که توی صفحه وب یه کادر ویرایش با نوار ابزار می سازه. کاربر می تونه متن رو قالب بندی کنه، لینک و لیست بذاره و عکس اضافه کنه. بیشتر توی پنل مدیریت، بخش نظرات، سیستم تیکت و صفحه های نوشتن محتوا استفاده می شه.
quill از راست به چپ پشتیبانی می کنه، ولی باید خودت تنظیمش کنی. راست به چپ بودن رو روی کادر و نوار ابزار فعال کن، فونت فارسی رو با CSS بذار و متنی با ترکیب فارسی و انگلیسی رو آزمایش کن. بهتره قبل از انتشار روی چند مرورگر هم تستش کنی.
آره، ولی آماده توی وردپرس نیست و باید فایل هاش رو توی قالب یا افزونه خودت لود کنی. اگه فقط می خوای نوشته یا برگه بنویسی، ویرایشگر خود وردپرس کافیه. quill بیشتر به درد فرم ها و پنل های سفارشی می خوره که خودت می سازی.
دو راه معمول هست. می تونی فرمت Delta رو که یه JSON هست ذخیره کنی، یا HTML محتوا رو بگیری و ذخیره کنی. هر کدوم رو انتخاب کردی، موقع دریافت از کاربر محتوا رو سمت سرور هم پاکسازی کن تا کد مخرب وارد سایتت نشه.
quill با یه مجوز متن باز از خانواده BSD منتشر شده که استفاده تجاری رو هم اجازه می ده. معمولا فقط باید اعلان کپی رایت و متن مجوز رو توی پروژه نگه داری. برای جزئیات دقیق، متن رسمی مجوز رو یه بار بخون.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.