Comment puis-je exporter des Réductions de documents de différents formats?
La Rédaction De La Documentation
En tant que développeur, j'ai été à la recherche de la façon la plus facile d'écrire et de mettre à jour la documentation. Pas un texte ennuyeux que des cris "ne lisez pas moi", mais quelque chose de joyeusement (et facilement) mis en forme avec extra facile de prise en charge du code.
À partir de LaTeX de wiki Markdown, pour n'en nommer que quelques-uns, je pense que Markdown est aussi proche qu'il obtient. Mais le document lui-même est très ringard et pas très portable. Ce besoin pour devenir HTML et PDF.
Démarque De L'Éditeur De
Donc, fondamentalement, je suis à la recherche d'un éditeur, d'un convertisseur, ou de toute astuce que je n'ai pas pensé, à son tour, cette documentation au format HTML et PDF.
Mains vers le bas le plus simple éditeur que j'ai trouvé est StackEdit, mais il n'a pas d'exporter au format HTML; il dépend en ligne les feuilles de style qui ne sont pas reliés correctement et l'exportation en HTML est assez insupportable de voir. Il ne serait pas travailler hors connexion de toute façon.
Exporter au format HTML et PDF
Je suis à la recherche d' tout façon de le faire correctement. Je n'ai pas l'esprit, s'il y a une application autonome ou un script qui convertit le markdown
fichier en HTML. J'ai besoin de quelqu'un pour me montrer les ficelles dans la documentation de génération de que je ne peux pas trouver.
PDF est une autre histoire. Je pense que j'ai spammé mon ordinateur complet avec HTML-PDF convertisseurs, et chacun d'eux a ajouté le spam et des filigranes à mon incroyablement propre documentation.
Bon à savoir, merci. Le modèle par défaut semble bon. Est-il un moyen d'obtenir
pandoc
(ou doxygen
) pour générer un fichier PDF à l'aide de ce modèle/la feuille de style?Je n'ai aucune idée à propos de pandoc ou doxygen, mais vous pouvez générer un PDF directement à partir de StackEdit (Menu->Enregistrer sous...). Le modèle utilisé pour la génération de PDF peut être personnalisé dans les Paramètres->->format PDF modèle.
Par la voie, StackEdit fonctionne en mode hors connexion, une fois le cache de l'application a été entièrement téléchargé (prend environ 1 minute pendant que vous êtes sur la page)
OriginalL'auteur Redsandro | 2013-08-29
Vous devez vous connecter pour publier un commentaire.
Pour le choix de formats de sortie, vous pouvez probablement pas battre pandoc - il vous permet de convertir le format Markdown (et de nombreux autres formats) en HTML, PDF, DocBook, et un nombre plus. Ses valeurs par défaut sont assez sain d'esprit, mais vous pouvez inclure vos propres modèles assez facilement si vous le souhaitez. Il possède aussi un support pour le langage spécifique de la mise en valeur du code en blocs.
Pouvez-vous ajouter un exemple de commande pour la conversion de
markdown
àpdf
à l'aide depandoc
dans votre réponse?pandoc -f markdown -o test.pdf test.md
. Votre réponse est correcte, mais je trouve la sortie plutôt simple/old/ennuyeux/laid comapred du 21e siècle implémentations comme gitHub et de Dépassement de Pile.OriginalL'auteur Oliver Matthews
Juste pour compléter les réponses précédentes:
J'ai trouvé cette ligne de Markdown-à-convertisseur de PDF. Mais il ya certains inconvénients à l'utilisation de services en ligne. Non seulement ils peuvent entacher la PDF (déjeuner libre?), mais ils ne sont pas également inclure des images dans votre document.
Voici un hors ligne Markdown-à-PDF convertisseur appelé Gimli, mais il s'exécute sur Ruby.
Il y a aussi un autre mode hors connexion convertisseur MultiMarkdown au format PDF, mais il utilise Windows à la place.
OriginalL'auteur Redsandro
Les lettres suivantes sont pour désigner certaines caractéristiques en commun:
M: Mathématiques syntaxe de la formule de soutien
G: GitHub Aromatisé Markdown
L: Aperçu En Direct
C: la coloration syntaxique pour le code
E: Exportation vers différents formats
S: Style Personnalisé je.e custom CSS pour HTML, etc.
P: Support pour les plugins
F: Gratuit
D: Active de développement
Ici, ils viennent (dans aucun ordre particulier):
1. Remarquable
Simple, élégant, riche en fonctionnalités
D F L G S P M C E(pdf, html)
2. ReText
Simple, supporte à la fois restructuré texte et markdown
D F M P E(html, odt, pdf)
3. UberWriter
Minimes et léger
F C M E(pdf html rtf)
5. Typora
Simple, élégant
F(while in beta) D G C M L E(html pdf epub docx odt etc.)
6. Haroopad
Riche en fonctionnalités, la version bêta de l'éditeur de blogs et de diffusion, l'importation de nombreux formats
F G L M E(html)
7. Marquez Mes Mots
Simple
F D L E(pdf html)
8. Gitbook Éditeur
Pour la documentation, l'écriture numérique et de l'édition
D F G L C M E (HTML PDF epub mobi)
9. Abricotine
Éditeur basé sur la technologie web
L F D G C E(HTML) M S
10. GhostWriter
Simple, sans distraction, robuste
F G D E (HTML , other formats by extensions), S
11. Signe
Minimes, robuste
D L G C E (PDF) M S
13. Élégant Démarque de l'Éditeur (EME)
Minimal, simple
D L G C E (PDF) M
14. Plugins
Suivants sont des plugins disponibles pour les différents IDEs et éditeurs. Certains plugins pour convertir au format HTML ou PDF. Les vérifier.
- Atom
Vim: Instant-Markdown Plugin
Support: MarkdownPreview Plugin
Sublime Text: Markdown Plugin
GNU Emacs
Code De Visual Studio
Notepadqq
Jetbrains IDEs: Markdown Navigator
Qownnotes
OriginalL'auteur Charitoo
L'éditeur Atom a un plugin de prévisualiser les fichiers Markdown (.md), qui est livré avec une exportation au format HTML fonctionnalité.
OriginalL'auteur Aubin
Avez-vous envisagé de Doxygen? Doxygen sera de sortie dans de multiples formats (tout à la fois si vous le souhaitez). Je l'utilise généralement pour générer un manuel HTML.
Doxygen est principalement conçu pour documenter le code, mais si vous êtes juste de l'écriture autonome manuel de la page et de section commandes liées à la va faire un très bon travail.
La liste de Doxygen formats de sortie est ici.
Détails de la Doxygen Manuel page:
Remarque: Vous aurez besoin d'un TeX de configuration pour l'utiliser. Doxygen de ne pas produire les résultats recherchés juste par lui-même, mais qui s'applique à Pandoc trop.
Est-ce que vous vouliez? PS. il y a des liens sous les mots " ici " et "page" - pas très évident dans cette police.
Merci pour le modifier. Je upvoted votre réponse. Cependant, j'aimerais voir la commande spécifique pertinente à cette question, ce qui implique la conversion de Markdown PDF. E. g.
pandoc -f markdown -o test.pdf test.md
pourpandoc
. Je commande un exemple pour moi, mais pour Doxygen je n'arrive pas à le trouver; tous les exemples semblent commencer à partir deLaTeX
de sortie, comme si j'ai besoin de convertirMarkdown
àLaTeX
premier. BTW, je ne sais pas commentpandoc
vanille fonctionne, mais avec le paquet de Ubuntu il fonctionne immédiatement, pas besoin d'ajouter TeX configuration manuellement.Doxygen utilise un fichier de configuration plutôt que de paramètres de ligne de commande comme pandoc. Ainsi, après avoir obtenu Doxygen, vous devez configurer le fichier "doxyfile" GENERATE_LATEX = OUI (et d'autres de la configuration de base, comme les ENTRÉES), puis exécutez
doxygen doxyfile
. Cela devrait générer le LaTeX de la démarque. Je suis sur Windows, ressemble à Ubuntu, c'est plus de mettre en place pour ce genre de chose (sans surprise).OriginalL'auteur Cheeseminer