Folio Writer
Figures, équations et renvois
Numéroter à la main, c'est ainsi que les renvois aux figures se dérèglent. Dans Folio Writer, vous étiquetez une chose une fois, vous y renvoyez par son nom, et la compilation numérote tout — pendant que l'éditeur affiche la figure, sa légende et son équation composée, en place.
Étiquettes
Une figure est une image Markdown ordinaire, seule sur sa ligne, avec une étiquette entre accolades :
{#fig:compression width=70%}
Le texte alternatif est la légende. width= accepte un pourcentage de la largeur du texte ou une taille absolue (3in, 8cm, 400px) et est respecté en PDF, Word et HTML. Un tableau prend son étiquette dans la ligne de légende sous lui :
| Phase | P (GPa) |
|-------|---------|
| B1 | 0–400 |
: Phases de MgO {#tbl:phases}
Une équation est une formule hors texte suivie de son étiquette :
$$K_T = -V \left(\frac{\partial P}{\partial V}\right)_T$$ {#eq:bulk}
Renvois
Renvoyez à tout élément étiqueté avec @ et sa clé — @fig:compression, @tbl:phases, @eq:bulk — et la compilation imprime « Fig. 1 », « Table 1 », « eq. 1 ». Mettez le préfixe en majuscule (@Fig:compression) en début de phrase ; groupez-en plusieurs avec [@fig:a; @fig:b]. Les numéros suivent l'ordre d'apparition dans tout le manuscrit, de sorte que déplacer un chapitre dans le classeur renumérote tout correctement.
La numérotation est faite par pandoc-crossref : sur Mac il s'installe avec les autres outils (Compiler ▸ Configurer les outils externes…), et le serveur Folio Writer l'a, si bien que les compilations depuis l'iPhone et l'iPad numérotent de la même façon. Sans lui, les renvois s'impriment tels quels.
Ce que l'éditeur montre
Avec Rendre les images activé, une image seule sur sa ligne est dessinée telle qu'elle sera exportée, avec sa légende et son étiquette [fig:clé] dessous. Les équations sont composées en place — les mathématiques en ligne reposent sur la ligne de base du texte, celles hors texte ont leur propre ligne avec une marque (eq:clé) à côté. Indices et exposants (H~2~O, x^2^) se lisent H₂O et x². Le Markdown réapparaît dès que le curseur entre dans ce paragraphe, de sorte qu'on n'édite jamais à l'aveugle ; touchez ou cliquez une figure rendue et elle s'ouvre en source.
Sur iOS, ces réglages sont dans Réglages ▸ Éditeur ▸ Rendu (images, équations, indices/exposants, et la part de syntaxe Markdown à masquer) ; sur Mac, dans Réglages ▸ Éditeur. Le fichier lui-même reste toujours du texte brut.
Insérer une figure
Déposez un fichier image dans l'éditeur, collez-en un, ou utilisez Insertion ▸ Image : le fichier est copié dans le dossier Research du projet et le Markdown est écrit pour vous, avec une étiquette que vous pouvez modifier. Gardez les chemins relatifs au projet, pour que le manuscrit compile partout.
La liste des références
Les renvois ne sont pas des citations : @fig:x est résolu avant que la bibliographie ne s'exécute, il ne cherche donc jamais une clé nommée « fig:x ». Quand le manuscrit cite effectivement quelque chose, le fichier compilé se termine par une section References ; pour la placer vous-même, écrivez
# References {.unnumbered}
::: {#refs}
:::
n'importe où dans le brouillon, et la liste mise en forme remplit ce bloc.