کتابخانه
speech-rule-engine یه کتابخانه جاوااسکریپت متن باز برای تبدیل ساختارهای XML، به خصوص فرمول های ریاضی در قالب MathML، به متنی قابل خوندن برای صفحه خوان هاست. ایده اش از موتور ChromeVox اومده، هم توی Node.js کار می کنه هم توی مرورگر، و مجوزش Apache هست.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز Apache-2.0؛ هش هر فایل با منبع بررسی شده است.
۵٫۸ مگابایت· ۳۶۱ فایل· انتشار
SHA-256: cbfe0284070f69b8be3e4dacb5a8d0b53e4df5bf56523aed11148e690a8e2ebc
speech-rule-engine یه موتور مستقل برای ساختن توضیح گفتاری از ساختارهای XML هست. ایده اش از موتور ChromeVox اومده، یعنی همون صفحه خوان کروم، و بعدها به یه بسته جدا تبدیل شده که می تونی توی پروژه خودت ازش استفاده کنی. مهم ترین کارش اینه که فرمول ریاضی در قالب MathML رو به جمله ای مثل «x به توان دو به علاوه یک» تبدیل کنه تا کاربر صفحه خوان بتونه فرمول رو بفهمه.
مشکلی که حل می کنه ساده ست. فرمول ریاضی برای چشم قشنگ دیده می شه، ولی صفحه خوان ها معمولا نمی دونن باید باهاش چی کار کنن. اگه فرمول رو به شکل عکس بذاری، چیزی برای خوندن وجود نداره. اگه MathML باشه، ساختارش هست ولی یکی باید اون رو به گفتار تبدیل کنه. این کار همون چیزیه که این موتور انجام می ده. MathJax هم برای دسترس پذیری فرمول ها از همین موتور استفاده می کنه. بسته به نسخه، چند سبک گفتار و خروجی بریل هم توش پیش بینی شده.
برای کی مناسبه؟ برای توسعه دهنده هایی که سایت آموزشی، دانشگاهی، مجله علمی یا وبلاگ ریاضی و فیزیک دارن و می خوان محتواشون برای نابینایان و کم بینایان هم قابل استفاده باشه. اگه توی سایت وردپرسی ت فرمول زیاد داری و خودت جاوااسکریپت می نویسی، می تونی خروجی گفتاری رو توی aria-label یا یه ابزار خوانش بذاری. ولی اگه سایتت فقط متن ساده داره، یا فرمول هات عکس هستن و قصد نداری تبدیلشون کنی به MathML، این بسته به دردت نمی خوره.
یه نکته برای سایت های فارسی: روی قاعده های آماده فارسی حساب نکن. قبل از انتخاب، فهرست زبان های پشتیبانی شده توی مستندات رو ببین و اگه فارسی لازم داری، حساب کن چقدرش رو باید خودت اضافه کنی. موقع استفاده هم دو چیز رو یادت باشه. اول، ورودی باید MathML درست باشه، پس اگه فرمول ها رو با LaTeX می نویسی، اول باید تبدیلشون کنی. دوم، سبک خوانش روی خروجی اثر می ذاره و باید با مخاطب سایتت جور باشه.
نسخه های رسمی و بدون تغییر speech-rule-engine توی مخزن داخلی ما هم هست. پس وقتی دسترسی به منابع بین المللی مشکل داره، می تونی از همین جا دانلودش کنی.
اول مشخص کن می خوای توی صفحه استفاده ش کنی یا توی Node.js. بعدش این قدم ها رو دنبال کن:
قبل از اینکه روی سایت اصلی بذاری، با یه صفحه تست و یه صفحه خوان واقعی امتحانش کن. اگه سایتت وردپرسیه، اول روی نسخه آزمایشی کار کن تا با قالب و افزونه های دیگه تداخل پیدا نکنه.
یه ساختار XML، به خصوص فرمول ریاضی در قالب MathML، رو می گیره و ازش توضیح گفتاری می سازه که صفحه خوان ها یا ابزارهای تبدیل متن به صدا می تونن بخونن. یعنی فرمول فقط یه شکل روی صفحه نیست و کاربر نابینا هم می تونه بفهمه چی نوشته شده.
ورودی اصلیش MathML هست، نه LaTeX. اگه فرمول هات رو با LaTeX می نویسی، اول باید تبدیلشون کنی به MathML، مثلا با MathJax، و بعد خروجی رو به این کتابخانه بدی. جزئیات دقیقش رو توی مستندات نسخه ای که استفاده می کنی بخون.
نباید روی قاعده های آماده فارسی حساب کنی. کتابخانه برای چند زبان قاعده داره، ولی اینکه فارسی بینشون باشه یا نه رو باید از مستندات نسخه خودت چک کنی. اگه نبود، باید قاعده های گفتار رو خودت بنویسی یا از زبان نزدیک استفاده کنی.
مجوز Apache معمولا استفاده توی پروژه های تجاری رو هم اجازه می ده، به شرطی که متن مجوز و اطلاعیه های حق نشر رو نگه داری و اگه تغییری توی کد دادی، اون رو هم مشخص کنی. اگه پروژه حساسی داری، متن کامل مجوز رو یه بار خودت بخون.
توی خود فایل ها فرقی نیست. ما نسخه رسمی و بدون تغییر رو نگه می داریم تا وقتی دسترسی به منبع اصلی مشکل داره، بتونی از همین جا دانلودش کنی. فایل ها دستکاری نمی شن و فقط روی هاست داخلی در دسترس هستن، یعنی دسترسی بهشون به اینترنت بین الملل بستگی نداره.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.