Y a-t-il un éditeur facile à utiliser "What-You-You-See-IS-Get" pour POD disponible?
Je ne suis pas aussi utilisé pour la syntaxe de la POD afin d'avoir la possibilité d'écrire la gousse et de voir immédiatement ce que la production ressemblera à beaucoup. Idéalement, cet éditeur aurait une sorte de "achèvement du code" pour aider à la syntaxe correcte.
Y a-t-il un éditeur comme celui-ci?
4 Réponses :
Non, du moins pas que j'ai jamais entendu parler de murmure. POD est une forme de balise très simple; Il ne faut pas prendre longtemps pour l'apprendre.
Cela dit, tout éditeur de texte décent doit être configurable pour reconnaître les directives de la POD et appliquer la syntaxe en surbrillance. Si votre éditeur achève la fin des mots-clés, vous l'obtiendriez aussi. (Remarque: l'achèvement du code ne s'appliquerait pas à un éditeur hypothétique WYSIWYG.)
En ce qui concerne la sortie de la sortie, il n'y a pas de moyen standard de rendu pod. Il peut être rendu comme texte brut, html ou autre chose pour laquelle quelqu'un a été écrit un traducteur. Selon votre éditeur de texte, vous pouvez ajouter une "commande utilisateur" pour traduire le document actuel et le montrer dans une visionneuse appropriée. Par exemple, exécutez-le via pod2html et ouvrez la page résultante de Firefox.
edit: le Conseils pour écrire POD section de Perlpod dit
Si vous êtes plus familier avec l'écriture
en HTML qu'avec l'écriture dans POD, vous
peut essayer votre main à l'écriture
Documentation en HTML simple, et
la convertir en pod avec le
Expérimental POD :: HTML2POD module
Ce qui vous permettrait d'utiliser un éditeur HTML WYSIWYG pour écrire une documentation. (Au moins en principe; beaucoup dépendraient de quel type de sortie l'éditeur produit.)
HTML n'est-ce pas WYSIWYG cependant. Ce que vous voyez est ce que vous voyez et non ce que les autres pourraient voir. :)
Oui, cela pourrait fonctionner, je suppose, mais HTML2Pod dit: "Essayez d'éviter d'utiliser un éditeur HTML WYSIWYG, car ils produisent souvent une source effrayante" ... qui me met plus ou moins dans la même position. Si je dois manifester la syntaxe de toute façon, je pourrais aussi faire l'affaire à Perldoc tout de suite. Quoi qu'il en soit, ce n'était pas rien de majeur, alors j'ai abandonné l'idée. Merci pour l'aide en tout cas.
Bien que non un éditeur GTK2 :: EX :: PodViewer est un excellent spectateur de guiche de pod basé sur GTK. Il peut également être utilisé facilement sur Windows grâce aux liaisons GTK de Camelbox (http://code.google.com/p/camelbox/). Le programme d'installation de CamelBox sort sur la boîte avec une enveloppe entièrement fonctionnelle à GTK2 :: Ex :: Podviewer.
Vue Web de la POD vous permet de télécharger un fichier de pod, obtenez-le d'une URL ou de coller sa Contenu et modifiez-le à la volée. Le HTML généré peut être affiché dans le style de votre choix, imitant comment il ressemblerait à CPAN, Metacpan ou GitHub.
Pour donner crédit où il est dû, le backend est construit sur la danseuse et utilise POD :: Simple :: HTML pour générer l'aperçu HTML. L'interface utilisateur est faite avec Twitter Bootstrap, beaucoup de code JavaScript / JQuery et de l'éditeur ACE.
up sur GITUB
Je ne sais pas si un, mais vous pourriez piquer les gens Padre à ce sujet. Search.cpan.org/dist/padre
Il n'y a pas d'espoir d'une telle chose. POD est un format conçu pour une traduction facile à d'autres formats. Vous ne devriez pas vous soucier de ce à quoi on dirait parce que ce que vous voyez n'est pas ce que les autres vont voir. POD n'est pas une langue de présentation. C'est un balisage structurel que quelque chose d'autre décide de présenter.
Quel problème avez-vous avec la pod qui vous donne envie de cela?
Merci pour les entrées. J'ai abandonné l'idée maintenant. J'ai eu un "manuel" pour un perlrogramme qui a été écrit en texte clair. En tant que tel, il était difficile d'organiser et de structurer avec des en-têtes, des chapitres, des sous-chapitres, etc. Mon idée initiale était de le convertir en Perldoc pour ajouter une sorte de lisibilité facile tout en étant capable de la visualiser à partir de Commandline. Mais la perspective de convertir 500+ lignes de texte à Perldoc sans le soutien d'un éditeur décent n'était pas attrayante :)
Padre.perlide.org/trac/ticket/844