> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/latex/ru/specializirovannye/02-chemistry-formulae.md). # Химические формулы В этой статье рассматриваются два пакета LaTeX, предназначенные для набора химического содержимого и документации: * [chemfig](https://www.ctan.org/pkg/chemfig): пакет для [рисования структурных формул молекул](#using-chemfig-to-draw-molecules-structural-formulae) * [mhchem](https://ctan.org/pkg/mhchem): пакет для [набора химических формул и уравнений](#using-mhchem-to-typeset-chemical-formulae-and-equations) ## Использование chemfig для рисования молекул (структурных формул) Рисование молекулы в основном сводится к соединению групп атомов линиями. Простые линейные формулы можно легко нарисовать с помощью `chemfig` пакета, как показано в следующем примере: ```latex \documentclass{article} \usepackage{chemfig} \begin{document} \section{Introduction} Записывать химические формулы с помощью chemfig просто. \chemfig{A=B} \end{document} ``` [Откройте этот `chemfig` пример в Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+1\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Csection%7BIntroduction%7D%0AWriting+chemical+formulae+with+chemfig+is+straightforward.%0A%0A%5Cchemfig%7BA%3DB%7D%0A%5Cend%7Bdocument%7D) На следующем изображении показан результат, полученный в примере выше: ![Базовый пример chemfig](/files/bfb785e2d35c09f15d71121c2608f52dcc79b45c) Пакет подключается с помощью `\usepackage{chemfig}` в преамбуле. Команда `\chemfig{A=B}` рисует молекулу. Символ `=` определяет тип связи. См. [справочное руководство](#reference-guide) список типов связей. ### Углы Существует несколько способов определить углы между связями в молекулах. ```latex Для задания химических формул можно использовать единицы, определяющие углы \chemfig{A-[1]B-[7]C} Абсолютные углы \chemfig{A-[:50]B-[:-25]C} Относительные углы \chemfig{A-[::50]B-[::-25]C} ``` [Откройте этот `chemfig` пример в Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+2\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0ATo+define+chemical+formulae+you+can+use+units+that+define+the+angles%0A%0A%5Cchemfig%7BA-%5B1%5DB-%5B7%5DC%7D%0A%0AAbsolute+angles%0A%0A%5Cchemfig%7BA-%5B%3A50%5DB-%5B%3A-25%5DC%7D%0A%0ARelative+angles%0A%0A%5Cchemfig%7BA-%5B%3A%3A50%5DB-%5B%3A%3A-25%5DC%7D%0A%5Cend%7Bdocument%7D) На следующем изображении показан результат, полученный в примере выше: ![Chemfig2OLV2.png](/files/921a90310d09bf46403d359ac4a977a82709b3e5) Каждая из трёх команд в приведённом выше примере использует свой способ определения угла между связями. * `единицы по умолчанию`: В команде `\chemfig{A-[1]B-[7]C}` параметры в квадратных скобках задают угол в специальных единицах; каждая единица равна 45°. Поэтому в примере углы равны 45° и 315°. * `абсолютные единицы`: Углы можно задавать в абсолютных единицах, в команде `\chemfig{A-[:50]B-[:-25]C}` параметр в квадратных скобках представляет угол в градусах, измеряемый от горизонтальной базовой линии. Допускаются отрицательные углы. * `относительные углы`: В третьем примере `\chemfig{A-[::50]B-[::-25]C}` углы измеряются относительно предыдущей связи, а не базовой линии. ### Кольца Ниже приведён пример синтаксиса для рисования правильных многоугольников: ```latex Правильные многоугольники: \chemfig{A*5(-B=C-D-E=)} Возможны и незамкнутые кольца: \chemfig{A*5(-B=C-D)} ``` [Откройте этот `chemfig` пример в Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+3\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0ARegular+polygons%3A%0A%0A%5Cchemfig%7BA%2A5%28-B%3DC-D-E%3D%29%7D%0A%0AIncomplete+rings+are+also+possible%3A%0A%0A%5Cchemfig%7BA%2A5%28-B%3DC-D%29%7D%0A%5Cend%7Bdocument%7D) На следующем изображении показан результат, полученный в примере выше: ![Chemfig3OLV2.png](/files/ba94bcf0dd11b0fa2ea33e027fa46949cea6532c) Синтаксис команды `\chemfig{A*5(-B=C-D-E=)}` объясняется ниже: * `Один`: Это первый атом, остальные атомы будут рисоваться от него * `*5`: Количество сторон многоугольника * `(-B=C-D-E=)`: Остальные атомы и связи. Если их недостаточно для завершения многоугольника, будет нарисовано незамкнутое кольцо. Кроме того, этой команде можно передать дополнительный параметр: двойную звёздочку. Например, если `**5` указано вместо `*5` внутри многоугольника рисуется круг. #### Соединённые кольца Следующий пример рисует химическую структуру кофеина: ```latex \documentclass{article} \usepackage{chemfig} \begin{document} \section{Мне нужен кофеин.} \chemfig{*6((=O)-N(-)-(*5(-N=-N(-)-))=-(=O)-N(-)-)} \end{document} ``` [Откройте этот `chemfig` пример в Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Drawing+caffeine+using+chemfig\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BI+need+caffeine.%7D%0A%0A%5Cchemfig%7B%2A6%28%28%3DO%29-N%28-%29-%28%2A5%28-N%3D-N%28-%29-%29%29%3D-%28%3DO%29-N%28-%29-%29%7D%0A%5Cend%7Bdocument%7D) Следующая графика показывает результат, полученный в примере с кофеином: ![Изображение молекулы кофеина, созданное с использованием пакета LaTeX chemfig](/files/4c3737a853d70d6be917cfd0aa870cb02a3ecb23) ### Ветки Химические формулы не всегда линейны; на самом деле наиболее распространённый тип — разветвлённые формулы. Ниже приведён пример того, как их создавать. ```latex Разветвлённая молекула \vspace{.5cm} \chemfig{H-C(-[2]H)(-[6]H)-C(=[1]O)-[7]H} ``` [Откройте этот `chemfig` пример в Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+4\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0ABranched+molecule+%5Cvspace%7B.5cm%7D%0A%0A%5Cchemfig%7BH-C%28-%5B2%5DH%29%28-%5B6%5DH%29-C%28%3D%5B1%5DO%29-%5B7%5DH%7D%0A%5Cend%7Bdocument%7D) На следующем изображении показан результат, полученный в примере выше: ![Chemfig4OLV2.png](/files/744b6c16344e329e214c598117b88e0e42e22616) Ветви в каждом узле создаются добавлением формул в круглых скобках. Например, код ```latex C(-[2]H)(-[6]H) ``` создаёт две ветви у «C», одну с углом 2 единицы (90°) и другую с углом 6 единиц (270°). Ветви можно добавлять и к кольцам: ```latex Разветвлённое кольцо \vspace{.5cm} \chemfig{A*6(-B=C(-CH_3)-D-E-F(=G)=)} ``` [Откройте этот `chemfig` пример в Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+5\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0ABranched+ring%0A%5Cvspace%7B.5cm%7D%0A%0A%5Cchemfig%7BA%2A6%28-B%3DC%28-CH_3%29-D-E-F%28%3DG%29%3D%29%7D%0A%5Cend%7Bdocument%7D) На следующем изображении показан результат, полученный в примере выше: ![Chemfig5OLV2.png](/files/46bf0e4c0d54c2a8373b12deeddede741fe3b959) Синтаксис похож: с помощью круглых скобок ветвь можно присоединить к узлу (атому). Например, ```latex F(=G) ``` присоединяет ветвь к узлу «F». Более сложные примеры можно создавать, используя вложенные ветви и даже присоединяя кольца как ветви. ### Настройка формул Можно изменить несколько параметров, таких как цвета и расстояние между узлами, а также добавить дополнительный текст для описания формулы. ```latex {\huge \setchemfig{atom sep=2em,bond style={line width=1pt,red,dash pattern=on 2pt off 2pt}} \chemname {\chemfig{H-C(-[2]H)(-[6]H)-C(=[1]O)-[7]H}} {Ацетальдегид} } ``` [Откройте этот `chemfig` пример в Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Chemfig+example+6\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bchemfig%7D%0A%5Cbegin%7Bdocument%7D%0A%7B%5Chuge+%0A++++%5Csetchemfig%7Batom+sep%3D2em%2Cbond+style%3D%7Bline+width%3D1pt%2Cred%2Cdash+pattern%3Don+2pt+off+2pt%7D%7D++%0A++++%5Cchemname%0A++++%7B%5Cchemfig%7BH-C%28-%5B2%5DH%29%28-%5B6%5DH%29-C%28%3D%5B1%5DO%29-%5B7%5DH%7D%7D++++%0A++++%7BAcetaldehyde%7D%0A%7D%0A%5Cend%7Bdocument%7D) На следующем изображении показан результат, полученный в примере выше: ![Рисование ацетальдегида в LaTeX с использованием пакета chemfig](/files/7e66102fc2474507dd81d6b04f00ac9174e613cc) Здесь есть две новые команды: * `\setchemfig{}`: Эта команда используется для настройки параметров рисования химических структур. * `\chem``name{}{}` : Первый параметр в этой команде — это `chemfig` формула, второй — это текст, который будет напечатан под формулой. В примере этот текст — «Ацетальдегид». Обратите также внимание, что используется шрифт `huge`. Можно использовать любой другой [размер шрифта](/latex/ru/shrifty/01-font-sizes-families-and-styles.md) и формула будет масштабирована соответствующим образом. ### Справочное руководство (chemfig) **Типы связей** | Тип связи | код | выходной | | ---------------------- | ------------------- | ------------------------------------------------------------- | | одинарная | `\chemfig{O - H}` | ![Bond1.png](/files/f9750e83265c50b3dcecb0aae5383ea1322d0aca) | | двойного | `\chemfig{O = H}` | ![Bond2.png](/files/98d1c965df7fdfbd3a210029e898efcab0bc8564) | | тройная | `\chemfig{O ~ H}` | ![Bond3.png](/files/d6a7bc5eff2bcd3ad0941519641265a5bfff6585) | | простой правый клин | `\chemfig{O > H}` | ![Bond4.png](/files/d54c16e9215170f962689582670c095a71dc99b9) | | простой левый клин | `\chemfig{O < H}` | ![Bond5.png](/files/32734d112d7fd6cfbe04a9605a90b2cf8c376574) | | пунктирный правый клин | `\chemfig{O >: H}` | ![Bond6.png](/files/558862838ee07c70bcebfc0d6431988ebbe1bdb6) | | пунктирный левый клин | `\chemfig{O <: H}` | ![Bond7.png](/files/79fbd482c7dba9f6203e045d95ff9ebf8f9671b8) | | полый правый клин | `\chemfig{O >\| H}` | ![Bond8.png](/files/962b3990b83bbc6d97b9f6af04fe3eaeaf387663) | | полый левый клин | `\chemfig{O <\| H}` | ![Bond9.png](/files/5ef8a8618d3164f824cd0863a7ed6db9cd600d83) | ## Использование mhchem для набора химических формул и уравнений Это `mhchem` многофункциональная `\ce` команда, которая [поддерживается предпросмотром Visual Editor в Overleaf](#visual-editors-preview-of-chemical-formulae-and-equations), позволяет набирать химические формулы и уравнения; например, запись `\ce{H2O}` набирает $$\text{H}\_2\text{O}$$, химическую формулу воды. * **Примечание**: В последних версиях `mhchem` могут [увеличить время, необходимое для компиляции вашего проекта](/latex/ru/baza-znanii/038-fixing-and-preventing-compile-timeouts.md#mhchemtimeout). Переход на [`chemformula` пакет](https://ctan.org/pkg/chemformula?lang=en), а также использование её `\ch` команды, может уменьшить время компиляции, но `\ch` команда в настоящее время не просматривается Visual Editor. ### Как загрузить пакет mhchem Чтобы использовать последнюю версию `mhchem`, которая сейчас является версией 4, добавьте следующую строку в преамбулу документа: ```latex \usepackage[version=4]{mhchem} ``` Это загружает `mhchem` с его стилями по умолчанию для форматирования химических формул и уравнений. Чтобы изменить эти значения по умолчанию, вы можете либо использовать `mhchem` параметры пакета или `\mhchemoptions` команду. Например, чтобы изменить шрифт текстового режима на без засечек и рисовать стрелки с использованием PGF/Ti*к*Z, вы можете загрузить `mhchem` с помощью ```latex \usepackage[version=4,arrows=pgf-filled,textfontname=sffamily]{mhchem} ``` или вы можете использовать `\mhchemoptions` команду в вашем документе ```latex \mhchemoptions{arrows=pgf-filled,textfontname=sffamily} ``` Это [`mhchem` документация пакета](http://mirrors.ctan.org/macros/latex/contrib/mhchem/mhchem.pdf) содержит дополнительные рекомендации по настройке `mhchem`, а также множество примеров химических формул и уравнений, некоторые из которых мы воспроизводим здесь, чтобы помочь вам начать. Обратите внимание на использование пробелов в более сложном вводе для `\ce` команды. Эти пробелы необходимы, чтобы помочь `mhchem` корректно разобрать ваши химические формулы и уравнения; их отсутствие может вызвать ошибку [Неожиданный символ ввода](#the-unexpected-input-character-mhchem-error). ### Несколько примеров Следующий проект Overleaf загружает `mhchem` его, используя три параметра пакета: * `arrows=pgf-filled`: рисует заполненные стрелки с использованием PGF * `textfontname=sffamily`: вне математического режима химические формулы и уравнения набираются шрифтом без засечек по умолчанию * `mathfontname=mathsf`: в математическом режиме используется шрифт без засечек Это `\ce` команда используется для набора ряда примеров. ```latex \documentclass{article} %Загрузить mhchem с некоторыми параметрами пакета \usepackage[version=4,arrows=pgf-filled, textfontname=sffamily, mathfontname=mathsf]{mhchem} \begin{document} \subsection*{Простые молекулы} \begin{itemize} \item Вода: \verb|\ce{H2O}|, \ce{H2O} \item Бензол: \verb|\ce{C6H6}|, \ce{C6H6} \item Перекись водорода: \verb|\ce{H2O2}|, \ce{H2O2} \item Уксусная кислота: \verb|\ce{C2H4O2}|, \ce{C2H4O2} \item Глюкоза: \verb|\ce{C6H12O6}|, \ce{C6H12O6} \end{itemize} \subsection*{Химические уравнения} Два базовых примера: \begin{itemize} \item \verb|\ce{2H2 + O2 -> 2H2O}| набирает \ce{2H2 + O2 -> 2H2O} \item \verb|\ce{CO2 + C -> 2 CO}| набирает \ce{CO2 + C -> 2 CO} \end{itemize} \subsection*{Более сложный пример} Запись \verb|\ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}| набирает это:\vskip10pt \noindent \ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}. \subsection*{Пример в математическом режиме} Химические выражения можно набирать с помощью команд математического режима, таких как \verb|\frac|. \vskip10pt \noindent Запись \verb|\[K=\frac{[\ce{Hg^2+}][\ce{Hg}]}{[\ce{Hg2^2+}]}\]| даёт следующее: \[K=\frac{[\ce{Hg^2+}][\ce{Hg}]}{[\ce{Hg2^2+}]}\] \end{document} ``` [Откройте этот `mhchem` пример в Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=mhchem+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%25Load+mhchem+using+some+package+options%0A%5Cusepackage%5Bversion%3D4%2Carrows%3Dpgf-filled%2C%0Atextfontname%3Dsffamily%2C%0Amathfontname%3Dmathsf%5D%7Bmhchem%7D%0A%5Cbegin%7Bdocument%7D%0A%5Csubsection%2A%7BSimple+molecules%7D%0A%0A%5Cbegin%7Bitemize%7D%0A%5Citem+Water%3A+%5Cverb%7C%5Cce%7BH2O%7D%7C%2C+%5Cce%7BH2O%7D%0A%5Citem+Benzene%3A+%5Cverb%7C%5Cce%7BC6H6%7D%7C%2C+%5Cce%7BC6H6%7D%0A%5Citem+Hydrogen+peroxide%3A+%5Cverb%7C%5Cce%7BH2O2%7D%7C%2C+%5Cce%7BH2O2%7D%0A%5Citem+Acetic+acid%3A+%5Cverb%7C%5Cce%7BC2H4O2%7D%7C%2C+%5Cce%7BC2H4O2%7D%0A%5Citem+Glucose%3A+%5Cverb%7C%5Cce%7BC6H12O6%7D%7C%2C+%5Cce%7BC6H12O6%7D%0A%5Cend%7Bitemize%7D%0A%0A%5Csubsection%2A%7BChemical+equations%7D%0A%0ATwo+basic+examples%3A%0A%0A%5Cbegin%7Bitemize%7D%0A%5Citem+%5Cverb%7C%5Cce%7B2H2+%2B+O2+-%3E+2H2O%7D%7C+typesets+%5Cce%7B2H2+%2B+O2+-%3E+2H2O%7D%0A%5Citem+%5Cverb%7C%5Cce%7BCO2+%2B+C+-%3E+2+CO%7D%7C+typesets+%5Cce%7BCO2+%2B+C+-%3E+2+CO%7D%0A%5Cend%7Bitemize%7D%0A%0A%5Csubsection%2A%7BA+more+complex+example%7D%0A%0AWriting+%5Cverb%7C%5Cce%7BHg%5E2%2B+-%3E%5BI-%5D+HgI2+-%3E%5BI-%5D+%5BHg%5E%7BII%7DI4%5D%5E2-%7D%7C+typesets+this%3A%5Cvskip10pt%0A%5Cnoindent+%5Cce%7BHg%5E2%2B+-%3E%5BI-%5D+HgI2+-%3E%5BI-%5D+%5BHg%5E%7BII%7DI4%5D%5E2-%7D.%0A%0A%5Csubsection%2A%7BA+math+mode+example%7D%0A%0AChemical+expressions+can+be+typeset+using+math+mode+commands+such+as+%5Cverb%7C%5Cfrac%7C.+%5Cvskip10pt%0A%0A%5Cnoindent+Writing+%5Cverb%7C%5C%5BK%3D%5Cfrac%7B%5B%5Cce%7BHg%5E2%2B%7D%5D%5B%5Cce%7BHg%7D%5D%7D%7B%5B%5Cce%7BHg2%5E2%2B%7D%5D%7D%5C%5D%7C+produces+this%3A%0A%0A%5C%5BK%3D%5Cfrac%7B%5B%5Cce%7BHg%5E2%2B%7D%5D%5B%5Cce%7BHg%7D%5D%7D%7B%5B%5Cce%7BHg2%5E2%2B%7D%5D%7D%5C%5D%0A%5Cend%7Bdocument%7D) Этот проект выводит следующее: ![Графика, показывающая примеры mhchem](/files/7205cc04317fd7f3c0ada5f960916f81bc05800a) Это [`mhchem` документация пакета](http://mirrors.ctan.org/macros/latex/contrib/mhchem/mhchem.pdf) стоит прочитать, поскольку он содержит множество примеров химических формул и уравнений, а также информацию о параметрах пакета и настройке. ### Предпросмотр химических формул и уравнений в Visual Editor Visual Editor Overleaf предоставляет предпросмотр химических формул и уравнений, набранных `\ce` командой, как показано в следующем видеоклипе: {% embed url="" %} ### Ошибка mhchem «Unexpected input character» Это `mhchem` ошибка пакета **`Сбой проверки: неожиданный символ ввода`** часто возникает из-за отсутствия пробелов во вводе команды `\ce` — пробелы необходимы для `mhchem` того, чтобы точно разобрать более сложные химические выражения. Эта ошибка может возникнуть при копировании и вставке примеров из PDF-документов, где пробелы могут воспроизводиться неточно. Следующий пример демонстрирует эту ошибку: ```latex \ce{CO2+C->2CO} ``` [Откройте этот **вызывающий ошибку** `mhchem` пример в Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=mhchem+errors+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bversion%3D4%5D%7Bmhchem%7D+%0A%5Cbegin%7Bdocument%7D%0A%5Cce%7BCO2%2BC-%3E2CO%7D%0A%5Cend%7Bdocument%7D) В качестве минимума нам нужно поставить пробел между `C` и `->` ; однако такого подхода всё ещё может быть недостаточно для набора нужного выражения. При правильном добавлении всех пробелов это выглядит так: ```latex \ce{CO2 + C -> 2 CO} ``` [Откройте этот исправленный `mhchem` пример в Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=mhchem+corrected+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bversion%3D4%5D%7Bmhchem%7D+%0A%5Cbegin%7Bdocument%7D%0A%5Cce%7BCO2+%2B+C+-%3E+2+CO%7D%0A%5Cend%7Bdocument%7D) Этот проект выводит следующее: ![](/files/055c83654745af75debed7c243596065a1c8a1f4) ## Дополнительное чтение Для получения дополнительной информации см. * [Диаграммы молекулярных орбиталей](/latex/ru/specializirovannye/04-molecular-orbital-diagrams.md) * [Диаграммы Фейнмана](/latex/ru/specializirovannye/03-feynman-diagrams.md) * [Пакет TikZ](/latex/ru/risunki-i-tablicy/05-tikz-package.md) * [Вставка изображений](/latex/ru/drugie-temy/27-inserting-images.md) * [Список греческих букв и математических символов](/latex/ru/matematika/11-list-of-greek-letters-and-math-symbols.md) * [Это **chemfig** документация пакета](http://www.ctan.org/pkg/chemfig) * [Это **tikz/pgf** документация пакета](http://www.ctan.org/pkg/pgf) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/latex/ru/specializirovannye/02-chemistry-formulae.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.