Loading…

درباره این فرمت‌دهنده LaTeX فرمت‌دهنده آنلاین LaTeX

روی پایان‌نامه، مقاله یا اسلایدهای Beamer کار می‌کنید و LaTeX شما کمی به هم ریخته است؟ این فرمت‌دهنده LaTeX از Prettier با موتور unified-latex استفاده می‌کند تا کد شما را دوباره جریان‌دهی و تورفته کند تا محیط‌ها، بخش‌ها و ریاضیات راحت‌تر خوانده شوند—بدون تغییر معنای سند شما.

چرا از این فرمت‌دهنده LaTeX استفاده کنیم؟

  • از Prettier با unified-latex در پس‌زمینه برای قالب‌بندی LaTeX آگاه از ساختار استفاده می‌کند
  • برای اسناد معمولی .tex کار می‌کند (مقالات، گزارش‌ها، پایان‌نامه‌ها، اسلایدهای Beamer، یادداشت‌ها، تکالیف)
  • تورفتگی و شکستن خط را حول محیط‌ها، ریاضیات و آرگومان‌های ماکرو نرمال‌سازی می‌کند
  • نظرات و اکثر خطوط خالی عمدی را تا حد امکان حفظ می‌کند
  • LaTeX را مستقیماً پیست کنید یا یک فایل متنی بیندازید (تا حدود ۵ مگابایت)
  • اندازه تورفتگی قابل تنظیم و راهنمای اختیاری عرض خط نرم از طریق طول شکستن
  • قالب‌بندی اولویت‌دار سمت کاربر در مرورگر شما، با پشتیبان امن سرور در صورت نیاز

🔧 نحوه قالب‌بندی کد LaTeX آنلاین for latex-formatter

1

1. LaTeX خود را جایگذاری یا رها کنید

کد LaTeX را در ویرایشگر جایگذاری کنید یا یک فایل متنی (معمولاً .tex) را کشیده و رها کنید. می‌توانید روی هر چیزی از یک قطعه کوچک تا یک سند کامل کار کنید.

2

2. اندازه تورفتگی و طول بسته‌بندی را انتخاب کنید

اندازه تورفتگی (1-8 فاصله) و طول خط بسته‌بندی اختیاری را تنظیم کنید. طول بسته‌بندی کوتاه‌تر پاراگراف‌های باریک‌تری تولید می‌کند؛ 0 بسته‌بندی خودکار را غیرفعال می‌کند.

3

3. قالب‌بندی و بررسی خروجی

قالب‌بند را اجرا کنید. اگر LaTeX به درستی تجزیه شود، کد تمیز و دوباره تورفته دریافت می‌کنید. اگر مشکل تجزیه وجود داشته باشد، خطایی مشاهده می‌کنید تا بتوانید منبع را اصلاح کنید.

4

4. کپی به ویرایشگر خود

LaTeX قالب‌بندی شده را به ویرایشگر خود برگردانید یا آن را به عنوان یک فایل جدید ذخیره کنید. نسخه تمیز شده را ثبت کنید تا همکاران و بازبین‌ها یک طرح‌بندی یکسان دریافت کنند.

جزئیات فنی

موتور قالب‌بندی

این ابزار از Prettier با پلاگین unified-latex برای تجزیه LaTeX به یک AST ساختاریافته استفاده می‌کند، سپس آن را با تورفتگی و شکستن خط نرمال شده دوباره چاپ می‌کند. این تنها بر روی کد منبع عمل می‌کند و سند شما را کامپایل نمی‌کند.

جنبهرفتار
موتورقالب‌بند Prettier + unified-latex
ورودیLaTeX متن ساده (UTF-8)
خروجیمنبع LaTeX بازقالب‌بندی شده (UTF-8)
اجرااولویت سمت کلاینت (مرورگر) با پشتیبان امن سرور اختیاری
زمان‌بندی~25 ثانیه زمان‌بندی ایمنی برای ورودی‌های سنگین یا اسناد پیچیده

انواع فایل‌های معمول

هر LaTeX متن ساده پذیرفته می‌شود؛ این‌ها رایج‌ترین‌ها هستند:

نوعمثال‌هایادداشت‌ها
اسناد .texمقاله، گزارش، کتاب، beamerمنابع اصلی LaTeX با پیش‌متن + بدنه
قطعه‌کدها\section{}, \begin{proof}…عالی برای پاکسازی قطعات کوچکتر استفاده شده در اسناد یا اسلایدها
فایل‌های ورودیchapter.tex, intro.texفصل‌ها یا بخش‌های مستقل شامل شده از طریق \input/\include

رفتار قالب‌بندی

قالب‌بند بر روی چیدمان و خوانایی تمرکز دارد، نه اعتبارسنجی معنایی.

حوزهکاری که انجام می‌دهدکاری که انجام نمی‌دهد
تورفتگیمحیط‌ها، ساختارهای تودرتو و بدنه‌های ماکرو خاص را بر اساس اندازه تورفتگی پیکربندی شده، تورفته می‌کند.ساختار منطقی را از ماکروهای سفارشی فراتر از آنچه unified-latex درک می‌کند، استنباط نمی‌کند.
شکستن خطخطوط طولانی را بر اساس طول شکستن خط (یا اگر روی 0 تنظیم شده باشد، به همان صورت رها می‌کند) می‌شکند.شکستن خط کامل را برای هر دستور سفارشی یا ماکروی عمیقاً تودرتو تضمین نمی‌کند.
توضیحاتخطوط توضیح و بیشتر توضیحات درون خطی را در جای خود حفظ می‌کند.متن توضیحات را تفسیر یا بازسازی نمی‌کند.
ریاضیمحیط‌های ریاضی و ریاضی درون خطی را دست نخورده نگه می‌دارد و تورفتگی اطراف را در صورت لزوم تنظیم می‌کند.درستی ریاضی یا استفاده از بسته‌های LaTeX را تأیید نمی‌کند.
پیش‌متنبخش‌های پیش‌متن مانند \usepackage, \newcommand و غیره را با فاصله‌گذاری یکنواخت قالب‌بندی می‌کند.بسته‌ها یا دستورات را برای سازگاری مجدداً مرتب نمی‌کند.
همیشه پس از قالب‌بندی مجدد، دوباره کامپایل کنید تا مطمئن شوید سند شما همچنان به درستی ساخته می‌شود.

محدودیت‌ها و عملکرد

قالب‌بند برای اسناد دنیای واقعی استفاده شده در زمینه‌های علمی و فنی تنظیم شده است.

ورودیمحدودیتیادداشت‌ها
اندازه متن (ویرایشگر)≈ ۲ مگابایتمحدودیت سخت برای حفظ واکنش‌پذیری مرورگر اعمال شده است.
بارگذاری فایل‌ها≈ ۵ مگابایتکنترل شده توسط سقف اندازه فایل رابط کاربری.
زمان قالب‌بندی< ۱–۲ ثانیه (معمول)بسته به پیچیدگی سند و عملکرد مرورگر متفاوت است.
رفتار زمان‌بندیشکست با وقاراگر قالب‌بندی از زمان تعیین شده فراتر رود، به جای یک تب قفل شده، خطا دریافت می‌کنید.

ایمنی و حریم خصوصی

برای استفاده استاندارد، قالب‌بندی مستقیماً در مرورگر شما با استفاده از Prettier + unified-latex adapter اجرا می‌شود. در برخی محیط‌ها، اگر افزونه درون مرورگری در دسترس نباشد، ممکن است از یک قالب‌بند بک‌اند امن به عنوان جایگزین استفاده شود. در هر دو حالت، LaTeX به عنوان ورودی موقت در نظر گرفته می‌شود: فقط برای قالب‌بندی استفاده می‌شود و کامپایل یا اجرا نمی‌شود.

برای اسناد بسیار محرمانه (مانند مقالات محرمانه، آزمون‌ها، گزارش‌های اختصاصی)، امن‌ترین گزینه همچنان اجرای latexindent یا سایر ابزارها به صورت محلی روی دستگاه خودتان است.

جایگزین‌های قالب‌بندی LaTeX از طریق خط فرمان

ابزارهای محلی را ترجیح می‌دهید یا می‌خواهید قالب‌بندی را در خط لوله ساخت یا CI خود ادغام کنید؟ در اینجا گزینه‌های رایج آورده شده‌اند.

لینوکس / 🍏 مک

قالب‌بندی یک فایل LaTeX در محل با latexindent

latexindent -w main.tex

فایل main.tex را با تورفتگی و چیدمان استاندارد بازنویسی می‌کند.

قالب‌بندی تمام فایل‌های .tex در یک پروژه

find . -name "*.tex" -print0 | xargs -0 latexindent -w

latexindent را روی هر فایل LaTeX در درخت دایرکتوری جاری اعمال می‌کند.

ویندوز (PowerShell)

قالب‌بندی تمام فایل‌های .tex در پوشه جاری

Get-ChildItem -Filter *.tex | ForEach-Object { latexindent -w $_.FullName }

latexindent را روی هر فایل LaTeX با استفاده از PowerShell اجرا می‌کند.

از این قالب‌بند آنلاین برای پاک‌سازی سریع و قطعه کدها استفاده کنید، سپس latexindent یا ادغام‌های ویرایشگر (VS Code, TeXstudio, Overleaf) را در گردش کار روزانه خود برای اتوماسیون تنظیم کنید.

موارد استفاده عملی قالب‌بند LaTeX

مقالات علمی و پایان‌نامه‌ها

  • پاک‌سازی پیش‌نویس نامرتب قبل از ارسال به استاد راهنما یا همکاران نویسنده.
  • نگهداری بخش‌های طولانی، اثبات‌ها و پیوست‌ها با تورفتگی یکنواخت.
  • یکسان‌سازی طول خطوط برای بررسی آسان‌تر تفاوت‌ها در Git.
% قبل
\begin{proof}Let $G$ be a group with identity $e$...  \end{proof}

% بعد (قالب‌بندی شده)
\begin{proof}
  Let $G$ be a group with identity $e$...
\end{proof}

اسلایدهای Beamer و مطالب آموزشی

  • مرتب‌سازی مجموعه اسلایدها با فریم‌ها و لایه‌های متعدد.
  • آسان‌تر کردن نگهداری بلوک‌های کد مثال و محیط‌های ریاضی برای دستیاران آموزشی.
  • آماده‌سازی یادداشت‌های کارگاه یا درس به سبک یکنواخت.
\begin{frame}{Title}
  \begin{itemize}
    \item First point
    \item Second point
  \end{itemize}
\end{frame}

گزارش‌ها، مستندات و LaTeX متمرکز بر توسعه

  • قالب‌بندی گزارش‌های LaTeX تولید شده خودکار قبل از commit.
  • پاک‌سازی مستندات فنی با بلوک‌های کد و verbatim متعدد.
  • استانداردسازی ماکروها و چیدمان محیط در سراسر یک تیم.
\begin{verbatim}
$ git commit -m "cleaned tex formatting"
\end{verbatim}

❓ Frequently Asked Questions

❓آیا این ابزار LaTeX من را کامپایل می‌کند یا فقط سورس را بازفرمت می‌کند؟

این ابزار فقط سورس LaTeX را بازفرمت می‌کند. فرمتر ورودی را به یک نمایش ساختاریافته تجزیه کرده و سپس با تورفتگی و شکستن خطوط یکنواخت، آن را چاپ می‌کند. هرگز latex، pdflatex، lualatex یا هر موتور TeX دیگری را اجرا نمی‌کند.

🧪آیا فرمت‌بندی معنای سند من را تغییر می‌دهد؟

فرمتر به گونه‌ای طراحی شده که فقط چیدمان — فاصله‌های سفید، شکستن خطوط و تورفتگی — را تغییر دهد در حالی که دستورات، محیط‌ها و محتوا حفظ می‌شوند. با این حال، LaTeX در موارد نادر به برخی شکستن خطوط حساس است (مانند دستورات شکننده)، بنابراین همیشه بهتر است پس از بازفرمت، سند را دوباره کامپایل کرده و خروجی را مرور کنید.

📏سایز فایل LaTeX من چقدر می‌تواند باشد؟

برای عملکرد بهتر مرورگر، فرمتر ورودی را به حدود ۲ مگابایت متن و آپلود فایل را به حدود ۵ مگابایت محدود می‌کند. پایان‌نامه‌های بزرگتر یا فایل‌های پروژه ترکیبی ممکن است نیاز به تقسیم یا استفاده از ابزارهای محلی مانند latexindent داشته باشند.

📦آیا ماکروها و پکیج‌های سفارشی را درک می‌کند؟

فرمتر بر چیدمان متمرکز است: برای تورفتگی و شکستن متن نیازی به دانستن معناشناسی هر ماکرو یا پکیج ندارد. با این حال، سینتکس سفارشی بسیار پیچیده یا تو در تو ممکن است به طور کامل فرمت نشود. در صورت شک، روی یک کپی از سند خود آزمایش کنید.

🔒آیا سند LaTeX من روی سرور ذخیره می‌شود؟

این ابزار به عنوان یک فرمتر اولویت‌دار سمت کاربر طراحی شده: LaTeX در مرورگر شما با استفاده از یک آداپتور محلی در صورت امکان فرمت می‌شود. در برخی تنظیمات، ممکن است از یک فرمتر بک‌اند امن به عنوان جایگزین استفاده شود، اما اسناد به عنوان ورودی فرمت‌بندی موقت تلقی می‌شوند، نه ذخیره‌سازی بلندمدت. برای کارهای بسیار محرمانه، ترجیحاً latexindent یا معادل آن را به صورت محلی اجرا کنید.

Pro Tips

Best Practice

محیط‌ها را به صورت بصری تراز نگه دارید: تورفتگی یکنواخت بلوک‌های \begin و \end، پیمایش اثبات‌ها و مشتقات پیچیده را بسیار آسان‌تر می‌کند.

Best Practice

قبل از کامیت در Git، فرمتر را اجرا کنید تا همکاران به جای نویز فاصله‌های سفید، تغییرات محتوا را بررسی کنند.

Best Practice

هنگام کار با دستورات شکننده یا ماکروهای سفارشی، ابتدا یک کپی از فایل خود را فرمت کرده و دوباره کامپایل کنید تا مطمئن شوید تغییر چیدمان بر خروجی تأثیر نمی‌گذارد.

Best Practice

این فرمتر آنلاین را با latexindent محلی یا پلاگین‌های ویرایشگر جفت کنید تا یک گردش کار کاملاً خودکار برای فرمت‌بندی LaTeX داشته باشید.

Additional Resources

پروژه LaTeX
Documentation
Overleaf – ویرایشگر آنلاین LaTeX
Documentation
مستندات latexindent
Documentation
راهنمای سریع فرمت‌بندی LaTeX
Documentation

Other Tools