پاسخ هوش مصنوعی:
خطای ارائه شده در خروجی نشان میدهد که شما تلاش کردهاید از پکیج xepersian
(پشتیبانی از زبان فارسی در XeLaTeX) استفاده کنید، اما تلاش کردهاید سند خود را با موتور pdflatex کامپایل کنید. خطای fontspec.sty: error: 95
پیغام روشنی است که نشان میدهد پکیج fontspec
که برای بارگذاری فونتها در XeLaTeX و LuaLaTeX طراحی شده، با موتور pdfTeX سازگار نیست.
در نتیجه، برای رفع این مشکل، شما باید تنظیمات کامپایل پروژه خود را تغییر دهید و از موتور XeLaTeX یا LuaLaTeX استفاده کنید، چرا که پکیج xepersian
و همچنین fontspec
فقط با این دو موتور کار میکنند. در ادامه مراحل دقیق رفع مشکل توضیح داده شده است.
1. تغییر موتور کامپایل به XeLaTeX در TeXStudio
از آنجایی که از TeXStudio استفاده میکنید، باید مشخص کنید که سند شما با xelatex
کامپایل شود. مراحل زیر را طی کنید:
مراحل:
باز کردن تنظیمات TeXStudio:
به مسیر زیر بروید:
Options -> Configure TeXStudio
تغییر کامپایلر پیشفرض:
- به تب Build بروید.
- گزینه Default Compiler را به XeLaTeX تغییر دهید.
ذخیره تغییرات:
روی دکمه OK
کلیک کنید.
کامپایل کردن سند:
حالا سند خود را کامپایل کنید. باید خروجی بدون خطا تولید شود.
2. معتبر بودن نصب XeTeX و LuaTeX در TeX Live
اگر با پیغام خطا درباره نبود XeLaTeX مواجه شدید، باید اطمینان حاصل کنید که Tex Live شما به طور کامل نصب شده است. نسخه کامل TeX Live شامل تمام موتورهای اصلی (از جمله XeLaTeX و LuaLaTeX) میشود. برای بررسی، میتوانید دستور زیر را در خط فرمان اجرا کنید:
bash
xelatex --version
این دستور نسخه XeLaTeX نصب شده را نشان میدهد. اگر دستوری پیدا نشد، احتمالاً نصب TeX Live ناقص بوده است و باید TeX Live را دوباره به صورت "Full Scheme" نصب کنید.
3. حداقل تنظیمات برای سند فارسی با XeLaTeX
بعد از فعالسازی XeLaTeX، باید سند خود را به روشی تنظیم کنید که با زبان فارسی کار کند. مثال زیر ساختار پایهای لازم برای نوشتن یک سند فارسی را نشان میدهد:
```latex
% کامپایل با XeLaTeX
\documentclass{article}
% استفاده از پکیج فارسی
\usepackage{fontspec}
\usepackage{xepersian}
% انتخاب فونت فارسی
\settextfont{XB Niloofar} % یا هر فونت فارسی دیگر موجود در سیستم شما
\begin{document}
سلام دنیا! % متن فارسی
This is text in English. % متن انگلیسی
\end{document}
```
توضیحات:
- پکیج xepersian: این پکیج پشتیبانی کامل از زبان فارسی را ارائه میکند (شامل راستچین کردن پاراگرافها، تغییر فونتها و غیره).
- فونت فارسی: با استفاده از دستور
\settextfont
باید یک فونت فارسی انتخاب کنید که بر روی سیستم شما نصب شده است. فونتهایی مانند "XB Niloofar" یا "IRANSans" معمولاً نصب میشوند.
- اگر فونت مورد نظر یافت نشد، به قسمت
System Settings
بروید و نام دقیق فونتی را که روی سیستم شما نصب شده است، جستجو کنید.
4. فونتهای فارسی مورد نیاز
اگر فونتهای فارسی در سیستم شما نصب نشدهاند، توصیه میشود بسته فونتهای فارسی پیشفرض برای سیستم خود را دانلود و نصب کنید:
1. برای اوبونتو یا لینوکس:
bash
sudo apt-get install fonts-farsiweb
sudo apt-get install texlive-xetex
2. برای ویندوز:
- فونتهای فارسی استاندارد، مانند B Nazanin، XB Niloofar، و IRANSans را دانلود و نصب کنید.
3. برای مک:
- مطمئن شوید که فونتهای مناسب فارسی روی سیستم مک نصب شدهاند.
5. تست تنظیمات
هرگاه تنظیمات تغییر کرد (مثلاً تغییر موتور کامپایل یا اضافه کردن فونتها)، حتماً یک سند تست ساده مانند زیر را اجرا کنید:
latex
\documentclass{article}
\usepackage{xepersian}
\settextfont{XB Niloofar} % را تنظیم کنید
\begin{document}
سلام! این یک تست است.
\end{document}
6. تغییر دائمی تنظیمات موتور کامپایل در پروژه خاص
اگر میخواهید موتور XeLaTeX تنها برای یک پروژه خاص استفاده شود:
1. به محیط TeXStudio بروید.
2. با استفاده از منوی Tools -> Commands
, برنامه XeLaTeX را برای آن پروژه فعال کنید.
3. در صورت نیاز به تغییر، فایل .tex
مورد نظر را با دستور زیر در خط فرمان کامپایل کنید:
bash
xelatex filename.tex
7. مشکلات رایج و راهحلها
مشکل 1: فونت فارسی پیدا نمیشود
- مطمئن شوید که فونت مورد نظر در سیستم شما نصب شده است.
- از فونت دیگری که با
xepersian
سازگار است، مانند XB Zar
یا IRANSans
، استفاده کنید.
مشکل 2: خطای Package xepersian Error: LaTeX engine is not XeTeX
- این خطا زمانی رخ میدهد که کامپایلر سند به جای XeLaTeX، از pdflatex استفاده کند. حتماً مراحل تغییر کامپایلر را بررسی کنید و از انتخاب XeLaTeX اطمینان حاصل کنید.
خلاصه
برای رفع خطای fontspec
و استفاده از پکیج xepersian
:
1. حتماً کامپایلر را به XeLaTeX یا LuaLaTeX تغییر دهید.
2. فونتهای فارسی سازگار را نصب و استفاده کنید.
3. در صورت نیاز به نصب کامل TeX Live، مجدداً نصب با Full Scheme انجام دهید.
اگر این مراحل را طی کردید و همچنان به مشکل برخوردید، لطفاً جزئیات بیشتری از اسناد لاتک خود و پیغامهای خطا ارسال کنید تا راهنمایی دقیقتری ارائه شود!