Як зробити посилання на фігуру в розмітці за допомогою pandoc?

Наразі я пишу документ у відмітці, і я хотів би зробити посилання на зображення з мого тексту.

this is my text, I want a reference to my image1 [here]. blablabla

![image1](img/image1.png)

Я хочу зробити це посилання, оскільки після перетворення моєї відмітки в pdf зображення розміщуються на одній або двох сторінках після, і документ не має сенсу.

ОНОВЛЕННЯ:

Я спробував відповідь Райана на цій посаді, і я не можу змусити її працювати. Мабуть код:

[image]: image.png "Image Title" 
![Alt text][image] 
A reference to the [image](#image).

повинен виробляти:

\begin{figure}[htbp] 
\centering 
\includegraphics[keepaspectratio,width=\textwidth,height=0.75\textheight]{i mage.png} 
\caption{Alt text} 
\label{image} 
\end{figure} 

A reference to the image (\autoref{image}).

натомість я отримую:

\begin{figure}[htbp]
\centering
\includegraphics{image.png}
\caption{Alt text}
\end{figure}

A reference to the \href{\#image}{image}.

Я помітив дві проблеми:

• \label{image} не відображається: посилання не створюється.
• (\autoref{image})стає \href{\#image}{image}: перехресне посилання не виявлено.

І тоді, коли я конвертую це в pdf, воно, очевидно, не посилається на зображення. Є посилання, але воно ні до чого не посилається.

Будь-яка допомога буде дуже вдячна !!

У pandoc ви навіть можете:

![This is the caption\label{mylabel}](/url/of/image.png)
See figure \ref{mylabel}.

Ви можете використовувати фільтр pandoc-fignos для нумерації фігур та посилань. Він працює з будь-яким вихідним форматом - не тільки з LaTeX.

Додайте мітку до таких атрибутів зображення:

 ![Caption.](image.png) {#fig:description}

... а потім посилайтеся на фігуру так:

 @fig:description

Інформація про встановлення та застосування фільтра pandoc-fignos наведена на його веб-сторінці. Існує також фільтр pandoc-eqnos для того, щоб робити те ж саме з рівняннями.

Я спілкувався з Райаном Грієм, прочитавши його відповідь у подібному дописі. Насправді його рішення щодо використання:

[image]: image.png "Image Title" 
![Alt text][image] 
A reference to the [image](#image).

адаптується лише при використанні мультимаркету.

Що стосується pandoc, єдине рішення зробити перехресні посилання - це використання безпосередньо ключових слів латексу:

[image]: image.png "Image Title"
![Alt text \label{mylabel}][image]
See figure \ref{mylabel}.

Pandoc підтримує посилання на розділи (за допомогою ідентифікаторів розділів з префіксом #).

У коментарях до цього відкритого питання описано, як описані нижче способи використання ідентифікаторів розділу для генерації посилань на зображення в LaTeX та HTML:

<div id="fig:lalune">
![A voyage to the moon\label{fig:lalune}](lalune.jpg)

</div>

[The voyage to the moon](#fig:lalune).

Порожній рядок раніше </div>обов'язковий.

Припускаючи, що ви хочете вивести PDF Pandoc наприкінці:

Найкраще рішення для вставки зображень та зміни їх атрибутів я знайшов:

\begin{figure}[H]
\includegraphics[width=0.25\textwidth, height=!]{images/path.png}
\centering
\caption{mycaption}
\end{figure}

і в моєму template.latex:

\usepackage{wrapfig}
\usepackage{float}

Інші рішення не можуть визначати ширину або висоту зображення, принаймні, не в стандартній розмітці. Однак часто для книги чи паперу дуже важливо вказати розміри фігур, за винятком того, що ви хочете налаштувати розмір вихідних зображень перед тим, як використовувати їх у своєму документі. У цьому випадку вам доведеться мати різні налаштування для тих інструментів, які ви використовуєте для створення зображень.

Я рекомендую у випадку Matplotlib експортувати в PDF, а потім використовувати код, який я розмістив. Це дасть найкращу якість зображення та найбільшу гнучкість у налаштуванні того, як буде виглядати зображення у вихідному PDF, не турбуючись про речі.

За допомогою pandoc-crossref ви можете перетинати посилання на фігури з таким синтаксисом:

![Caption](file.ext){#fig:label}

Потім посилайтеся на рисунок у тексті, подібний до синтаксису цитування, [@fig:label]і компілюйте з ним --filter pandoc-crossref(потрібно прийти раніше, --filter pandoc-citeprocякщо ви також використовуєте це).

Ви можете керувати стилем, наприклад, \usepackage[font=small,labelfont=bf]{caption}в header-includes.

Акуратний пов'язаний трюк, якщо ви використовуєте \listoffiguresв латексе, - це цей луа-фільтр , який дозволяє встановити короткий заголовок, а не всю легенду фігури відображати у списку фігур:

![Caption](file.ext){#fig:label short-caption='my short caption'}

потім компілюйте з --lua-filter short-captions.lua.