7031718449
* feat: add MathJax option * docs: move math engine note * refactor: update LaTeX documentation and improve MathJax integration - Adjusted LaTeX documentation for clarity and formatting. - Enhanced MathJax configuration in the templates to support both KaTeX and MathJax rendering. - Removed deprecated comments and streamlined the script loading process for MathJax. - Updated the passthrough extension settings in the Hugo configuration for better compatibility with LaTeX math expressions. * docs: simplify LaTeX documentation and clarify configuration steps - Updated LaTeX documentation to reflect that KaTeX is enabled by default, removing the need for manual activation. - Added examples for using LaTeX math expressions and clarified the configuration for the passthrough extension in Hugo. - Enhanced MathJax section to emphasize its use as an alternative rendering engine.
3.6 KiB
title, weight
| title | weight |
|---|---|
| LaTeX | 4 |
به طور پیش‌فرض، (\KaTeX) برای رندر کردن عبارت‌های ریاضی LaTeX استفاده می‌شود. نیازی به فعال‌سازی دستی نیست، می‌توانید فوراً از عبارت‌های ریاضی LaTeX در محتوای مارک‌داون خود استفاده کنید.
مثال
هر دو عبارت‌های ریاضی درون‌خطی و پاراگراف جداگانه LaTeX در محتوای مارک‌داون پشتیبانی می‌شوند.
درون‌خطی
این \(\sigma(z) = \frac{1}{1 + e^{-z}}\) درون‌خطی است.
این (\sigma(z) = \frac{1}{1 + e^{-z}}) درون‌خطی است.
پاراگراف جداگانه
$$F(\omega) = \int_{-\infty}^{\infty} f(t) e^{-j\omega t} \, dt$$
به صورت زیر رندر خواهد شد:
F(\omega) = \int_{-\infty}^{\infty} f(t) e^{-j\omega t} \, dt
به عنوان مثال، استفاده از محیط هم‌ترازی:
$$
\begin{aligned}
\nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\
\nabla \cdot \mathbf{B} &= 0 \\
\nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\
\nabla \times \mathbf{B} &= \mu_0 \left( \mathbf{J} + \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t} \right)
\end{aligned}
$$
به صورت زیر رندر خواهد شد:
\begin{aligned}
\nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\
\nabla \cdot \mathbf{B} &= 0 \\
\nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\
\nabla \times \mathbf{B} &= \mu_0 \left( \mathbf{J} + \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t} \right)
\end{aligned}
پیکربندی
Important
لطفاً افزونه passthrough را در فایل پیکربندی Hugo فعال و پیکربندی کنید تا Hugo بتواند عبارت‌های ریاضی LaTeX را در محتوای مارک‌داون شما تشخیص دهد.
markup:
goldmark:
extensions:
passthrough:
delimiters:
block: [['\[', '\]'], ["$$", "$$"]]
inline: [['\(', '\)']]
enable: true
توابع پشتیبانی شده
برای مشاهده فهرست توابع پشتیبانی شده، به توابع پشتیبانی شده KaTeX مراجعه کنید.
شیمی
عبارت‌های شیمی از طریق افزونه mhchem پشتیبانی می‌شوند.
درون‌خطی: (\ce{H2O}) آب است.
پاراگراف جداگانه:
$$\ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}$$
به صورت زیر رندر خواهد شد:
\ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}
موتور ریاضی
MathJax
به طور پیش‌فرض، KaTeX برای رندر کردن عبارت‌های ریاضی LaTeX در طول فرآیند ساخت استفاده می‌شود که روش ترجیحی است. به عنوان جایگزین، می‌توانید از MathJax برای رندر کردن عبارت‌های ریاضی استفاده کنید.
برای استفاده از آن، موارد زیر را به فایل پیکربندی hugo.yaml اضافه کنید:
params:
math:
engine: mathjax