کتابخانه
KaTeX یه کتابخونه جاوااسکریپتی برای نمایش فرمول های ریاضی روی وبه. فرمول رو با سینتکس LaTeX می نویسی و KaTeX تو مرورگر یا روی سرور تبدیلش می کنه به خروجی تمیز و سریع. برای سایت های آموزشی، وبلاگ های علمی و هر جایی که فرمول لازم داری به درد می خوره.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۳ مگابایت· ۹۳ فایل· انتشار
SHA-256: fa140498b8cfc8302cbe5e7cb1bdbc1f952bc38b3fa258ede09e73edbf9a74bc
اگه تا حالا خواسته باشی یه فرمول ریاضی رو تو صفحه وب بذاری، می دونی که HTML معمولی برای این کار ساخته نشده. راه ساده اش اینه که فرمول رو عکس کنی و آپلود کنی، ولی نتیجه معمولاً خوب نیست. عکس تو صفحه های بزرگ تر تار می شه، متنش قابل کپی و جستجو نیست و برای هر تغییر کوچیک باید دوباره بسازیش. KaTeX دقیقاً برای همین مشکل ساخته شده. فرمول رو به شکل متن و با سینتکس LaTeX می نویسی و کتابخونه تبدیلش می کنه به HTML و CSS که با فونت های خودش نمایش داده می شه.
نقطه قوتش سرعته. رندر همزمان انجام می شه، پس بعد از نمایش فرمول ها صفحه جابه جا نمی شه و پرش نمی بینی. به کتابخونه دیگه ای هم وابسته نیست. با render و renderToString می تونی تو مرورگر یا سمت سرور با Node ازش استفاده کنی. اسکریپت کمکی auto-render هم کنارشه. متن صفحه رو می گرده، جداکننده هایی مثل دو تا دلار رو پیدا می کنه و فرمول ها رو خودش تبدیل می کنه، پس برای هر فرمول جدا کد نمی خواد بنویسی. گزینه هایی مثل displayMode و throwOnError هم برای کنترل نمایش و خطاها هست.
کجا به درد می خوره؟ سایت آموزشی، وبلاگ علمی، مستندات فنی، بانک سوال یا فروشگاه دوره های ریاضی و فیزیک. کجا نه؟ KaTeX بخش بزرگی از دستورهای LaTeX رو پشتیبانی می کنه، ولی کل LaTeX نیست. اگه بسته های خاص یا دستورهای نادر لازم داری، قبل از تصمیم چندتا از فرمول های واقعی خودت رو تست کن و ببین همه شون درست درمیان. MathJax پوشش گسترده تری داره، ولی KaTeX معمولاً سبک تر و سریع تره. یادت باشه KaTeX فقط نمایش می ده و ویرایشگر فرمول نیست.
یه نکته برای سایت های ایرانی: فایل CSS و فونت های KaTeX رو از هاست خودت لود کن. اگه به یه CDN خارجی وصل باشی، تو روزهایی که اینترنت بین الملل مشکل داره فرمول ها خراب یا خام نشون داده می شن. نسخه های رسمی و بدون تغییر KaTeX تو مخزن داخلی ما هم در دسترسه و می تونی از همین جا برداری و رو هاست خودت بذاری. تو صفحه های راست به چپ هم حواست باشه که فرمول ها ذاتاً چپ به راست نوشته می شن.
راه انداختنش پیچیده نیست. کد آماده پایین همین صفحه رو می تونی مستقیم تو قالب یا صفحه ات بذاری. قدم های کلی اینه:
اگه می خوای فرمول رو دستی رندر کنی، katex.render رو استفاده کن. برای خروجی آماده سمت سرور هم renderToString هست. تو وردپرس می تونی همین فایل ها رو از طریق قالب یا یه افزونه که کد سفارشی اضافه می کنه به سایت بدی. آخر کار هم یه صفحه آزمایشی با چندتا فرمول بساز و مطمئن شو همه چی درسته.
KaTeX کتابخونه ای برای نمایش فرمول های ریاضی با سینتکس LaTeX روی صفحه وبه. بزرگ ترین فرقش با MathJax سرعت و سادگیه، چون رندر همزمان انجام می شه. در عوض MathJax دستورهای بیشتری رو پشتیبانی می کنه. اگه فرمول هات معمولین و سرعت صفحه برات مهمه، KaTeX انتخاب خوبیه.
بله، چون یه کتابخونه جاوااسکریپته و به وردپرس وابسته نیست. کافیه فایل های CSS و جاوااسکریپت رو تو قالب یا با یه افزونه برای افزودن کد سفارشی به سایت اضافه کنی. بعدش تابع رندر خودکار رو اجرا کن تا فرمول های داخل نوشته ها تبدیل بشن.
معمولاً دلیلش اینه که فایل CSS لود نشده یا پوشه فونت ها کنار اون نیست. KaTeX علاوه بر خروجی HTML یه نسخه MathML هم می سازه که CSS مخفی اش می کنه. بدون CSS هر دو نسخه دیده می شن. مسیر فایل ها رو تو تب Network مرورگر چک کن.
خود فرمول ها چپ به راست هستن و معمولاً مشکلی ندارن. ولی اگه فرمول وسط متن فارسی جابه جا یا بهم ریخته دیده شد، جهت اون بخش رو چک کن. متن فارسی بلند رو هم بهتره داخل فرمول ننویسی و بیرونش بذاری.
بله، به شرطی که همه فایل ها از هاست خودت لود بشن. KaTeX به سرویس خارجی نیاز نداره، ولی اگه CSS و فونت ها رو از CDN بگیری، با قطعی اینترنت بین الملل لود نمی شن. بهترین کار اینه که همه فایل ها رو کنار فایل های سایتت نگه داری.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.