Come faccio a fare un riferimento a una figura in markdown usando Pandoc?

Question

Attualmente sto scrivendo un documento a Markdown e vorrei fare un riferimento a un'immagine dal mio testo.

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

![image1](img/image1.png)

Voglio fare quel riferimento perché dopo aver convertito il mio markdown in PDF, le immagini vengono posizionate in una o due pagine dopo e il documento non ha alcun senso.

AGGIORNARE:

ho provato Risposta di Ryan in quel post E non posso farlo funzionare. Apparentemente il codice:

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

dovrebbe produrre:

\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}).

Invece, ottengo:

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

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

Ho notato due problemi:

• \label{image} Non viene visualizzato: non viene creato alcun riferimento.
• (\autoref{image}) diventa \href{\#image}{image} : non viene rilevato alcun riferimento incrociato.

E poi, quando lo converto in PDF ovviamente non si collega all'immagine. C'è un link, ma non si collega a nulla.

Qualsiasi aiuto sarebbe molto apprezzato!!

Answer 1

In Pandoc puoi anche fare:

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

Answer 2

Ho fatto una chiacchierata con Ryan Gray dopo aver letto la sua risposta In un post simile. In realtà la sua soluzione di usare:

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

viene adattato solo quando si utilizza multimarkdown.

Quando si tratta di Pandoc, l'unica soluzione per fare riferimenti incrociati è l'utilizzo di parole chiave direttamente in lattice:

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

Answer 3

Puoi usare il Pandoc-fignos Filtro per la numerazione delle figura e il riferimento. Funziona con qualsiasi formato di output, non solo in lattice.

Aggiungi un'etichetta agli attributi dell'immagine come questo:

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

... e poi fare riferimento alla figura in questo modo:

 @fig:description

Le informazioni su come installare e applicare il filtro Pandoc-Fignos sono fornite nella sua pagina web. C'è anche il Pandoc-Eqnos Filtra per fare lo stesso tipo di cose con le equazioni.

Answer 4

Pandoc supporta le sezioni di riferimento (tramite Identificatori della sezione prefisso da #).

Commenti su questo questione aperta Descrivi come le seguenti opere di lavoro sfruttano gli identificatori della sezione per la generazione di riferimenti all'immagine in lattice e HTML:

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

</div>

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

La linea vuota prima </div> è obbligatorio.

Answer 5

Supponendo che tu voglia l'output PDF di Pandoc alla fine:

La soluzione migliore per inserire le immagini e cambiare i loro attributi che ho trovato è:

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

e nel mio template.latex Io ho:

\usepackage{wrapfig}
\usepackage{float}

Altre soluzioni non possono specificare la larghezza o l'altezza dell'immagine, almeno non nel markdown standard. Tuttavia, è spesso essenziale per qualcosa come un libro o un documento specificare le dimensioni delle figure, tranne per il fatto che si desidera configurare la dimensione delle immagini di uscita prima di usarle nel documento. In tal caso dovresti affrontare diverse impostazioni per quegli strumenti che usi per creare le immagini.

Consiglio in caso di matplotlib di esportare in PDF e quindi utilizzare il codice che ho pubblicato. Ciò fornirà la migliore qualità dell'immagine e la massima flessibilità nella configurazione dell'immagine nel PDF di output, senza doversi preoccupare delle cose.