web-dev-qa-db-fra.com

saut de page lors de la création de pdf

Je suis en train de créer un fichier pdf de fichier texte markdown en utilisant doxygen (1.8.6). Maintenant, je veux obtenir un saut de page à une étape spécifique du fichier de démarquage, j'ai utilisé ceci lien .

Dans le lien donné ils ont mentionné d'utiliser '>' pour le saut de ligne. Mais ils n'ont pas parlé de saut de page. Oui, je peux aussi utiliser '>' pour les sauts de page, mais je dois écrire ce symbole 5 fois ou plus sur un fichier texte Markdown, ce qui rend le fichier markdown bizarre. Y a-t-il d'autres moyens d'obtenir des sauts de page dans les fichiers de démarques?

markdowndoxygen
53
user2760375

J'ai rencontré le même et le résoudre en insérant

\saut de page

C'est en fait une commande LaTeX, plutôt qu'une commande Markdown.

44
ronencozen

Comme Markdown accepte le HTML et les CSS simples, ajoutez simplement cette ligne à l'endroit où vous souhaitez forcer le saut de page.

<div style="page-break-after: always;"></div>

Si votre éditeur Markdown rencontre des difficultés pour exporter PDF correctement, essayez d’abord d’exporter au format HTML, puis ouvrez-le avec votre navigateur et imprimez-le au format PDF.

125
tomodian

Blockquotes vs sauts de ligne

> N'est pas utilisé pour les sauts de ligne dans Markdown. Il est utilisé pour les citations de bloc. Par exemple, le code Markdown suivant

> A man provided with paper, pencil, and rubber, and
> subject to strict discipline, is in effect a universal machine.

devient

Un homme muni de papier, de crayon et de caoutchouc et soumis à une discipline stricte est en fait une machine universelle.

(Ceci est un citation de Alan Turing .)

Notez comment il est rendu avec un arrière-plan jaune par Stack Overflow. Si vous examinez le balisage généré, vous découvrirez que les balises <blockquote> Sont utilisées.

Les sauts de ligne peuvent généralement être insérés en terminant une ligne par deux espaces ou plus (syntaxe Markdown) ou en utilisant des balises raw <br> (La plupart des processeurs Markdown autorisent le HTML incorporé). Par exemple (en utilisant ␣ Pour représenter un espace), ce Markdown

123 Fake Street␣␣
Springfield, USA

devient

123 Fake Street
Springfield, États-Unis

Sauts de page

Depuis que la spécification d'origine Markdown a été conçue pour la sortie HTML (qui n'a pas le concept de pages), les sauts de page ne sont pas pris en charge.

Doxygen tilise LaTeX pour générer ses PDF . Il ne semble pas prendre en charge inline LaTeX¹, mais vous devriez pouvoir modifier le fichier intermédiaire .tex, Puis utiliser pdflatex pour générer votre fichier PDF:

  1. Utilisez Doxygen pour générer un fichier .tex
  2. Editez le fichier .tex Manuellement et ajoutez \newpage Partout où vous le souhaitez
  3. Exécuter pdflatex documentation.tex
  4. Examiner documentation.pdf

Cette question peut être une référence utile pour l’étape 3 ci-dessus.

¹Doxygen supporte LaTeX en ligne formules , mais je n'ai trouvé aucune mention de commandes LaTeX en ligne arbitraires comme \newpage Qui fonctionnent dans le texte environnement.

10
Chris

Une solution de dernier recours consiste à modifier manuellement la sortie HTML afin de la rendre en PDF comme vous le souhaitez).

2
Tomas Romero

Je sais que la question est morte, mais j'ai trouvé un moyen qui, à mon avis, pourrait être utile à d'autres personnes que moi.

Vous pouvez utiliser la commande\pagebreak dans un élément invisible. De cette façon, cela fonctionne avec le latex et avec le HTML.

<div style="page-break-after: always; visibility: hidden"> 
\pagebreak 
</div>
2
Noè Murr

Bien que ces réponses fonctionnent, elles brisent en quelque sorte l’un des objectifs de Markdown (MD), qui consiste à être très lisible en tant que document texte simple et à pouvoir être formaté en présentations plus riches.

Dès que vous commencez à incorporer un tas de HTML/CSS dans le texte, vous perdez le premier aspect de MD. Vous pouvez aussi bien utiliser Word, Libre, HTML/CSS, etc.

Je pense que MD ferait bien d’ajouter une séquence de saut de page. Quelque chose comme: <<<<>>>> ou similaire aux opérateurs de formatage. Je l'utilise dans mon texte de MD. Il ne provoque pas de saut de page dans les convertisseurs PDF ou HTML), mais il est reconnaissable à la fois dans ces deux formats et dans les formulaires en texte brut.

0
Ed S