> 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/uk/inshi-temi/28-inserting-images-es.md). # Вставлення зображень es Зображення є важливими елементами в більшості наукових документів. LaTeX пропонує кілька варіантів для роботи із зображеннями та для того, щоб вони виглядали саме так, як вам потрібно. У цій статті пояснюється, як включати зображення в найпоширеніших форматах, як робити їх меншими або більшими та як додавати посилання на зображення всередині документа. ## Вступ Нижче наведено приклад того, як імпортувати зображення в LaTeX. ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{ {images/} } \begin{document} Всесвіт величезний, і здається, що він однорідний, у великому масштабі, всюди, куди ми дивимося. \includegraphics{universe} Над ним зображено галактику \end{document} ``` ![InsertingImagesEx1.png](/files/0b4f94c7c7a2711d3e10c4ca661662aa3ef84ffa) LaTeX сам по собі не має можливості керувати зображеннями, тому потрібно імпортувати пакет **graphicx**. Щоб використати цей пакет, додайте таку лінію до преамбули вашого документа ```latex \usepackage{graphicx} ``` Команда `\graphicspath{ {images/} }` вказує LaTeX, що зображення збережені в папці під назвою *images* у поточному каталозі. Команда `\includegraphics{universe}` відповідає за включення зображення до документа. Тут, *universe* це ім'я файлу зображення без розширення; тож *universe.PNG* перетворюється на *universe*. Ім'я файлу зображення не повинно містити пробілів або кількох розділових знаків. Примітка: *Можна вказати розширення файлу, але рекомендується* його не вказувати. Якщо розширення не вказано, це змушує LaTeX шукати всі підтримувані формати. Для докладнішої інформації дивіться розділ [Генерування зображень у високій та низькій роздільній здатності](#generando-imgenes-en-alta-y-baja-resolucin). [Відкрити приклад в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Шлях до папки із зображеннями Працюючи над документом, який містить кілька зображень, одним зі способів упорядкувати проєкт є зберігати їх в окремій папці. У прикладі з вступу це досягається за допомогою команди `\graphicspath{ {images/} }` яка повідомляє LaTeX, що зображення слід шукати в папці *images*. Шлях є *відносним* до поточного робочого каталогу. Шлях до папки може бути ***відносним*** (рекомендовано), якщо папка знаходиться в тому самому каталозі, що й головний файл .tex, або в одній із підпапок, або може бути ***абсолютним*** якщо потрібно точно вказати шлях. Наприклад: ```latex %Абсолютний шлях у форматі Windows: \graphicspath{ {c:/user/images/} } %Абсолютний шлях у форматі типу Unix (Linux, OsX) \graphicspath{ {/home/user/images/} } ``` Зверніть увагу, що ця команда потребує прямого слеша `/` в кінці, а шлях слід помістити між двома парами фігурних дужок. Також можна задати кілька шляхів, якщо ви зберегли зображення в більш ніж одній папці для кращої організації. Наприклад, якщо є дві папки, одна під назвою *images1* і друга *images2*, використайте команду ```latex \graphicspath{ {images1/}{images2/} } ``` Якщо не вказано жодного шляху, LaTeX шукатиме зображення в поточній папці, де збережено файл .tex. [Відкрити приклад в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Зміна розміру та обертання зображення Якщо під час імпорту зображення в LaTeX потрібно вказати додаткові параметри для зміни ширини, висоти, положення тощо, це можливо за допомогою такої синтаксичної конструкції: ```latex Overleaf — чудовий професійний інструмент для онлайн-редагування, обміну та резервного копіювання ваших проєктів \LaTeX. Також пропонує доволі велику довідкову документацію. \includegraphics[scale=1.5]{lion-logo} ``` ![InsertingImagesEx2.png](/files/6235d76041376fd223d08dd64880be68cdfa01ef) Команда `\includegraphics[scale=1.5]{lion-logo}` включає зображення *lion-logo* до документа, додатковий параметр `scale=1.5` масштабує зображення до 1,5 його початкового розміру. Також можна змінити розмір зображення до заданої висоти й ширини. ```latex Overleaf — чудовий професійний інструмент для онлайн-редагування, обміну та резервного копіювання ваших проєктів \LaTeX. Також пропонує доволі велику довідкову документацію. \includegraphics[width=3cm, height=4cm]{lion-logo} ``` ![InsertingImagesEx3.png](/files/451b51b9a1702422a4f58266b582ca41c7024ab2) Як ви, мабуть, уже здогадалися, параметри в квадратних дужках `[width=3cm, height=4cm]` визначають ширину й висоту зображення. Можна використовувати [різні одиниці](#gua-de-referencia) вимірювання в цих параметрах. Якщо встановлено лише значення *width*, висота масштабуватиметься пропорційно, щоб зберегти пропорції зображення. Також можна встановити розмір зображення відносно інших елементів у документі. Наприклад, якщо хочеш, щоб зображення мало ту саму ширину, що й текст: ```latex Overleaf — чудовий професійний інструмент для онлайн-редагування, обміну та резервного копіювання ваших проєктів \LaTeX. Також пропонує доволі велику довідкову документацію. \includegraphics[width=\textwidth]{universe} ``` ![InsertingImagesEx5.png](/files/f6de60d2904ea79898d3c77e4d68b1b554e336b2) Замість `\textwidth` можна використовувати будь-яку іншу одиницю, яку LaTeX містить за замовчуванням: *\columnsep, \linewidth, \textheight, \paperheight, etc*. Дивіться [довідника](#gua-de-referencia) для кращого опису одиниць. Інший дуже поширений варіант під час додавання зображень до документа — це можливість обертати їх. У LaTeX це дуже просто: ```latex Overleaf — чудовий професійний інструмент для онлайн-редагування, обміну та резервного копіювання ваших проєктів \LaTeX. Також пропонує доволі велику довідкову документацію. \includegraphics[scale=1.2, angle=45]{lion-logo} ``` ![InsertingImagesEx4.png](/files/e1ed4cd61529a83b9f8c9a4a65dd297a8a42a485) Параметр `angle=45` обертає зображення на 45 градусів проти годинникової стрілки. Щоб обернути зображення в тому самому напрямку, що й годинникова стрілка, використовуйте від’ємне число. [Відкрийте приклад в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Розміщення зображення У попередньому розділі було пояснено, як вставити зображення у ваш документ, але інколи поєднання зображень і тексту в документі може виглядати не так, як ви очікували. Щоб змінити це, потрібно використати нове середовище: ```latex У наступному прикладі рисунок буде розміщено безпосередньо під цим реченням. \begin{figure}[h] \includegraphics[width=8cm]{Plot} \end{figure} ``` ![InsertingImagesEx6.png](/files/8d8ac7f835b25c72a2d3396d9a0b85d372b74250) Середовище `figure` використовується для відображення зображень як плаваючих елементів у документі. Це означає, що достатньо просто вставити ваше зображення всередину середовища *figure* і вам більше не потрібно турбуватися про те, де воно з’явиться: LaTeX розмістить його так, щоб воно ідеально вписувалося в потік документа. Хоча на перший погляд це звучить дуже добре, інколи хочеться мати більше контролю над тим, де з’являтимуться зображення. Для встановлення розміщення рисунка можна використати додатковий параметр. У прикладі, `begin{figure}[h]`, параметр у квадратних дужках задає положення рисунка *тут* (тут — англійською). Нижче наведено таблицю з можливими значеннями позиціонування. | Параметр | Положення | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | h | Встановлює положення плаваючого елемента «тут». Тобто приблизно в тому самому місці, де він з’являється в коді (однак позиціонування не завжди є точним) | | t | Вставляє рисунок на початку сторінки. | | b | Вставляє рисунок у кінці сторінки. | | p | Вставляє плаваючі елементи на окрему сторінку, що містить лише рисунки. | | ! | Перевизначає параметри, які LaTeX використовує для визначення «хорошого» положення зображення. | | H | Встановлює плаваючий елемент саме в тому місці, де він з’являється в коді; потрібно імпортувати пакет `float`. Це певною мірою еквівалентно h!. | У наступному прикладі видно зображення, яке з’являється на початку документа, хоча код, що його створює, розташований у кінці документа. ```latex На цій картинці ви можете побачити стовпчикову діаграму, яка показує результати опитування, що включало деякі важливі дані, які вивчалися з плином часу. \begin{figure}[t] \includegraphics[width=8cm]{Plot} \centering \end{figure} ``` ![InsertingImagesEx7.png](/files/812eedac773a3666a7cccedd84905238f02a45f9) Додаткова команда `\centering` відповідає за центрування зображення. Значення вирівнювання за замовчуванням — ліворуч. Також можна обтікати текстом навколо рисунка. Коли документ містить невеликі зображення, це покращує вигляд тексту. ```latex \begin{wrapfigure}{r}{0.25\textwidth} %this figure will be at the right \centering \includegraphics[width=0.25\textwidth]{mesh} \end{wrapfigure} Існує кілька способів побудувати функцію двох змінних, залежно від інформації, яка вас цікавить. Наприклад, якщо ви хочете побачити сітку функції, щоб легше було побачити похідну, ви можете використовувати графік, подібний до того, що ліворуч. \begin{wrapfigure}{l}{0.25\textwidth} \centering \includegraphics[width=0.25\textwidth]{contour} \end{wrapfigure} З іншого боку, якщо вас цікавлять лише певні значення, ви можете використовувати контурний графік, ви можете використовувати контурний графік, ви можете використовувати контурний графік, ви можете використовувати контурний графік, ви можете використовувати контурний графік, ви можете використовувати контурний графік, ви можете використовувати контурний графік, як той, що ліворуч. З іншого боку, якщо вас цікавлять лише певні значення, ви можете використовувати контурний графік, ви можете використовувати контурний графік, ви можете використовувати контурний графік, ви можете використовувати контурний графік, ви можете використовувати контурний графік, ви можете використовувати контурний графік, ви можете використовувати контурний графік, як той, що ліворуч. ``` ![InsertingImagesEx8.png](/files/21030a9ed04b0558d44f0b3c38d68d2be3b663fd) Щоб команди в прикладі працювали, потрібно імпортувати пакет **wrapfig**. Додайте до преамбули рядок ```latex \usepackage{wrapfig} ``` Після імпорту пакета можна використовувати середовище *wrapfigure* за допомогою команди `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`. Зверніть увагу, що середовище має два додаткові параметри у фігурних дужках. Далі пояснюється код детальніше. **{l}** Встановлює вирівнювання рисунка. Використовуйте l для лівого краю і r для правого. Крім того, якщо використовується клас book або подібний, замість l і r можна використовувати o для зовнішнього краю та i для внутрішнього краю сторінки. **{0.25\textwidth}** Це задає ширину коробки, що містить зображення. Це не ширина самого зображення; її слід задавати в команді includegraphics. У прикладі використано відносні одиниці, але можна використовувати й звичайні одиниці (cm, mm, in тощо). Дивіться довідковий посібник, щоб побачити список можливих одиниць. **\centering** Про це вже було сказано раніше, але в попередньому прикладі зображення буде вирівняно по центру відносно коробки, що його містить, а не відносно сторінки. Для повнішої інформації про розміщення зображень дивіться статтю [Розміщення зображень і таблиць](/latex/uk/risunki-ta-tablici/02-positioning-images-and-tables.md) [Відкрити приклад в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Додавання міток, підписів і посилань Можливість додавати підписи з коротким описом зображення та мітки, які потім можна використовувати для посилання на зображення, є дуже корисним інструментом під час роботи з дуже довгими документами. ### Підписи Почнемо з прикладу додавання підпису: ```latex \begin{figure}[h] \caption{Example of a parametric plot ($\sin (x), \cos(x), x$)} \centering \includegraphics[width=0.5\textwidth]{spiral} \end{figure} ``` ![InsertingImagesEx9.png](/files/e7703ea10965a50626fce1911667a792ebb9f3da) Це дуже просто, потрібно лише додати команду `\caption{Some caption}` і всередині фігурних дужок написати текст, який слід показати. Місце, де буде надруковано підпис, залежить від того, де вставлено команду; якщо вона над командою *includegraphics* то підпис з’явиться над зображенням; якщо під нею, тоді підпис з’явиться в нижній частині рисунка. Підписи також можна розміщувати поруч із рисунками. Пакет **sidecap** дозволяє використовувати дуже подібний до попереднього прикладу код для додавання тексту. ```latex \documentclass{article} \usepackage[rightcaption]{sidecap} \usepackage{graphicx} %пакет для керування зображеннями \graphicspath{ {images/} } \begin{SCfigure}[0.5][h] \caption{Example of a parametric plot. Цей підпис буде праворуч} \includegraphics[width=0.6\textwidth]{spiral} \end{SCfigure} ``` ![InsertingImagesEx10.png](/files/6f8e96f353e27404192a4b90c9cbed07cb170a38) У цьому прикладі є дві нові команди: **\usepackage\[rightcaption]{sidecap}** Як ви, ймовірно, вже знаєте, ця команда імпортує пакет із назвою sidecap, але є додатковий параметр: rightcaption. Саме цей параметр визначає місце, де друкується підпис. У цьому випадку — праворуч від зображення; також можна використати leftcaption, щоб перемістити підпис ліворуч. У документах, що використовують класи типу книги, додатково можна використовувати параметри outercaption і innercaption, щоб друкувати підпис на зовнішньому або внутрішньому боці відносно краю сторінки. **\begin{SCfigure}\[0.5]\[h] \end{SCfigure}** Визначає середовище, подібне до figure. Перший параметр — це ширина підпису відносно розміру зображення. Другий параметр h виконує ту саму функцію, що й у середовищі figure. Дивіться розділ про позиціонування зображень для докладнішої інформації. За бажання можна досягти більш просунутого керування форматом підписів. Дивіться [додаткові матеріали](#lecturas-adicionales) для інших посилань. ### Мітки та перехресні посилання На рисунки, як і на багато інших елементів у документі LaTeX (рівняння, таблиці, графіки тощо), можна посилатися з тексту. Досягти цього дуже просто: достатньо додати мітку до середовища *figure* або *SCfigure*, а потім використати цю мітку для посилання на рисунок. ```latex \begin{figure}[h] \centering \includegraphics[width=0.25\textwidth]{mesh} \caption{a nice plot} \label{fig:mesh1} \end{figure} Як ви бачите на рисунку \ref{fig:mesh1}, функція зростає поблизу 0. Також на сторінці \pageref{fig:mesh1} той самий приклад. ``` ![InsertingImagesEx11.png](/files/ac5ad3b389f187e83081972ec711407f3ca5bd31) У цьому прикладі є три команди, що створюють перехресні посилання. **\label{fig:mesh1}** Встановлює мітку для рисунка. Оскільки мітки можна використовувати для різних типів елементів у документі, доброю практикою є використання префікса, наприклад fig: у прикладі. **\ref{fig:mesh1}** Ця команда друкує номер, присвоєний рисунку. Номери генеруються автоматично й оновлюються, якщо пізніше перед посилюваним рисунком буде вставлено інший рисунок. **\pageref{fig:mesh1}** Друкує номер сторінки, на якій з’являється зображення, позначене міткою. Команда `\caption` що додає підпис, є обов’язковою для того, щоб можна було додати мітку та посилатися на рисунок. Ще однією важливою можливістю LaTeX є автоматичне створення *списку рисунків*. Це легко зробити за допомогою: ```latex \listoffigures ``` ![InsertingImagesEx12.png](/files/478d5c50f548c81adee361c3e3b2cced6330e36e) Ця команда працює лише з рисунками, що мають підпис, оскільки використовує його для створення таблиці. У попередньому прикладі перелічено зображення, використані в цій статті. Важлива примітка: *Під час використання перехресних посилань у LaTeX проєкт потрібно компілювати двічі, інакше посилання, посилання на сторінки та список рисунків не працюватимуть*. [Відкрити приклад в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Генерування зображень у високій та низькій роздільній здатності Наразі, коли ми вводимо ім’я файлу зображення в команді *\includegraphics* ми не вказуємо розширення файлу. Однак це не обов’язково, хоча може бути дуже корисним. Якщо розширення не вказано, LaTeX шукатиме будь-який підтримуваний тип зображення в заздалегідь встановленому каталозі зображень; пошук відбуватиметься в певному порядку, який можна змінити. Це дуже корисно під час переходу від чорнової версії вашого документа до фінальної. У чорновику (поки ви пишете статтю, книгу, звіт тощо) бажано використовувати зображення низької роздільної здатності (зазвичай у форматі .png), щоб документ компілювався швидше. У фінальній версії, навпаки, краще вставляти зображення високої роздільної здатності, щоб отримати якісний документ. Цього можна досягти за допомогою: * Не вказуючи розширення файлу в команді *\includegraphics*, і * Вказуючи порядок розширень у преамбулі Отже, якщо є дві версії одного й того самого зображення, наприклад venndiagram.pdf (у високій роздільній здатності) та venndiagram.png (у низькій роздільній здатності), можна додати таку лінію до преамбули під час написання та налагодження документа - ```latex \DeclareGraphicsExtensions{.png,.pdf} ``` Попередня команда гарантує, що якщо знайдено два зображення з однаковою назвою, але з різними розширеннями, буде використано файл .png, а якщо з якоїсь причини цей файл зникне, версія у форматі pdf стане наступним варіантом. Після того, як документ написано, щоб використовувати лише версію у високій роздільній здатності, слід змінити рядок, що визначає розширення, на: ```latex \DeclareGraphicsExtensions{.pdf,.png} ``` Можна навіть покращити описану вище техніку: можна попросити LaTeX генерувати зображення .png низької роздільної здатності під час компіляції документа, якщо PDF ще не було раніше перетворено на PNG. Щоб цього досягти, потрібно додати таке до преамбули після `\usepackage{graphicx}`. ```latex \usepackage{epstopdf} \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile} \DeclareGraphicsExtensions{.png,.pdf} ``` Якщо venndiagram2.pdf існує, але venndiagram2.png — ні, файл vendiagramm2-pdf-converted-to.png буде створено і завантажено замість нього. Команда *convert #1* відповідає за перетворення Є кілька моментів, які слід мати на увазі, якщо обрано цей метод: * Щоб автоматичне перетворення працювало, потрібно запускати *pdflatex* з опцією `--shell-escape`. * Для фінальної версії не слід забути закоментувати рядок `\epstopdfDeclareGraphicsRule`, щоб завантажувалися лише зображення у високій роздільній здатності. Також слід пам’ятати про зміну порядку пріоритету. [Відкрити приклад в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Довідник **Одиниці та вимірювання в LaTeX** | Скорочення | Визначення | | ------------ | ---------------------------------------------------------------- | | pt | Пункт — це одиниця довжини за замовчуванням. Приблизно 0.3515 мм | | mm | міліметр | | cm | сантиметр | | % | дюйм | | ex | висота **x** з поточним шрифтом | | em | ширина **m** з поточним шрифтом | | \columnsep | відстань між колонками | | \columnwidth | ширина колонки | | \linewidth | ширина рядка в поточному середовищі | | \paperwidth | ширина паперу | | \paperheight | висота паперу | | \textwidth | ширина тексту | | \textheight | висота тексту | | \unitlength | одиниці довжини в середовищі *picture* | **Про типи зображень, які можна використовувати в LaTeX** **latex** Якщо документ компілювати командою latex, можна використовувати лише зображення у форматі EPS, який є векторним форматом. **pdflatex** Якщо документ компілювати командою pdflatex для створення PDF, можна використовувати кілька типів зображень- ``` JPG: Найкращий варіант для вставлення фотографій PNG: Найкращий варіант для вставлення діаграм (якщо з якоїсь причини ви не можете використати векторний графік) і знімків екрана PDF: Попри звичку використовувати PDF для документів, загалом PDF може містити лише одне зображення, яке згодом можна імпортувати. EPS: Зображення EPS можна включати за допомогою пакета epstopdf (пакет потрібно лише встановити на комп’ютері; після встановлення жодних додаткових команд у файлі .tex не потрібно) ``` **Векторна графіка чи растрові зображення?** Зображення можна вставляти як у форматі растрових зображень, так і у форматі векторної графіки. Загалом про це не варто турбуватися, але якщо є можливість вибрати формат, слід пам’ятати, що для векторної графіки найкраще зберігати її у форматі PDF або EPS, тоді як для растрових зображень рекомендовані формати JPG або PNG. Це тому, що растрове зображення у файлі формату PDF або EPS потребує багато місця для зберігання. [Відкрити приклад в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Додаткові матеріали Для отримання додаткової інформації див.: * [Розміщення зображень і таблиць](/latex/uk/risunki-ta-tablici/02-positioning-images-and-tables.md) * [Списки таблиць і рисунків](/latex/uk/risunki-ta-tablici/03-lists-of-tables-and-figures.md) * [Односторонні та двосторонні документи](/latex/uk/formatuvannya/08-single-sided-and-double-sided-documents.md) * [Довжини в LaTeX](/latex/uk/formatuvannya/01-lengths-in-latex.md) * [**floatrow** пакет для розширеного керування підписами плаваючих елементів (таблиць і рисунків)](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf) * [**sidecap** документація пакета, для підписів до бічних рисунків](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf) * [**epstopdf** документація пакета (перетворення PDF у EPS)](https://www.google.com/url?sa=t\&rct=j\&q=\&esrc=s\&source=web\&cd=3\&cad=rja\&ved=0CEEQFjAC\&url=http%3A%2F%2Fmirror.hmc.edu%2Fctan%2Fmacros%2Flatex%2Fcontrib%2Foberdiek%2Fepstopdf.pdf\&ei=N4v2UpK7D4eHqQHz2IDACg\&usg=AFQjCNG9CxIXjrbc22kl-8QweEXeEauFew\&sig2=qamKo3qpid8CEqzsHhpIrQ\&bvm=bv.60983673,d.aWM) --- # 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/uk/inshi-temi/28-inserting-images-es.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.