2010-01-29 17 views
10

¿Hay un editor de "lo que ves es lo que recibes" fácil de usar para Pod disponible?¿Hay un editor WYSIWYG Perl Pod?

No estoy tan acostumbrado a la sintaxis de Pod todavía así que tener la opción de escribir el Pod y ver inmediatamente cómo sería la salida ayudará mucho. Idealmente, este editor tendría algún tipo de "finalización de código" para ayudar con la sintaxis correcta.

¿Hay un editor como este?

+3

No sé si, pero podrías criticar a la gente de Padre al respecto. http://search.cpan.org/dist/Padre – Schwern

+1

No hay esperanza de tal cosa. Pod es un formato diseñado para facilitar la traducción a otros formatos. No debería importarle lo que parece porque lo que ve no es lo que otras personas van a ver. Pod no es un lenguaje de presentación. Es un marcado estructural que otra cosa decide presentar. –

+0

¿Qué problema tienes con Pod que te hace querer esto? –

Respuesta

5

No, al menos no de lo que haya oído hablar alguna vez. Pod es una forma muy simple de marcado; no debería tomar mucho tiempo aprenderlo.

Dicho esto, cualquier editor de texto decente debe ser configurable para reconocer las directivas Pod y aplicarles resaltado de sintaxis. Si tu editor realiza la finalización del código de palabras clave, también lo obtendrás. (Nota: la finalización del código no se aplicaría a un hipotético editor WYSIWYG.)

En cuanto a ver la salida, no hay una forma estándar de renderizar Pod. Se puede representar como texto sin formato, HTML o cualquier otra cosa para la que alguien haya sido escrito como traductor. Dependiendo de su editor de texto, puede agregar un "comando de usuario" para traducir el documento actual y mostrarlo en un visor apropiado. Por ejemplo, ejecútelo en pod2html y abra la página resultante en Firefox.

Editar: La sección Hints for Writing Pod de perlpod dice

Si usted está más familiarizado con la escritura en HTML que con la escritura en la vaina, que puede probar su mano en la escritura de documentación en HTML simple y conversión a Pod con el módulo de experimental Pod::HTML2Pod

que todo Deberías usar un editor WYSIWYG HTML para escribir documentación. (Al menos en principio, mucho dependerá del tipo de salida que produzca el editor.)

+0

Sin embargo, HTML no es WYSIWYG.Lo que ves es lo que ves y no lo que otras personas puedan ver. :) –

+0

Sí, eso podría funcionar, supongo, pero HTML2Pod dice: "Trate de evitar el uso de un editor HTML WYSIWYG, ya que a menudo producen fuente de miedo" ... que más o menos me pone en la misma posición. Si tengo que codificar a mano la sintaxis de todos modos, también podría hacerlo en perldoc de inmediato. De todos modos, no era nada importante, así que descarté la idea. Gracias por la ayuda sin embargo. – Fredrik

1

No está terminado App::Wx::PodEditor en CPAN.

+0

http://search.cpan.org/perldoc/App::Wx::PodEditor podría haber sido un mejor enlace. –

1

Aunque no es un editor, Gtk2 :: Ex :: PodViewer es un visor de POD GUI excelente basado en GTK. Se puede usar fácilmente también en Windows gracias a los enlaces GTK de Camelbox (http://code.google.com/p/camelbox/). El instalador de Camelbox sale de la caja con un contenedor totalmente funcional para Gtk2 :: Ex :: PodViewer.

Cuestiones relacionadas