Perl documentation (POD) navegadores?

que estoy buscando es una buena experiencia de lectura de POD en pantalla.Perl documentation (POD) navegadores?

Durante años, he utilizado perldoc o man corriendo en un xterm para leer documentación de Perl en la pantalla, y un pequeño programa personalizado construido alrededor Pod::LaTeX imprimirlo. La versión impresa es buena: el script hace un buen trabajo. Sin embargo, en la pantalla de lectura es dolorosa:

Usted puede buscar, pero buena suerte para encontrar, por ejemplo, en la sección asDBIx::Class::ResultSet. Menos no sabe nada sobre la estructura del documento, y las búsquedas de palabras comunes en inglés son inútiles.
Me temo que cada vez que el documento me dice see section so-and-so. Estupendo. Ahora tengo que encontrar eso. Y luego regresar a donde estaba no será trivial (aunque puede que sea mi ignorancia menos visible)
Ver el documento tal y cual es peor. !perldoc foo funciona, pero cambiar entre los dos documentos es difícil. En su mayor parte, puede evitar esto suspendiendo menos y ejecutando perldoc desde el shell, pero eso es más teclas y soy flojo.
El formateo deja mucho que desear.

Deseo poder hacer clic en una tabla de contenido y acceder a esa sección. Quiero poder hacer clic en "ver otro" e ir allí. Y así. Hasta el momento, no sé de dos posibilidades:

search.cpan.org, ejemplo DBIx::Class::ResultSet. Requiere una conexión a Internet, pero eso normalmente no es un problema.
Podbrowser. Solo empecé a probar esto, se ve muy bien.

Estoy ejecutando Debian GNU/Linux, ambos Lenny y Squeeze. Pero sugiera programas para todas las plataformas para que esto sea lo más útil posible.

Fuente

2009-10-02 derobert

Muchas de las cosas de las que te quejas son las que acabo de hacer en una ventana de terminal separada (o pantalla, o lo que sea). Tampoco me importa tanto el formateo. :) –

Puede probar Pod::Browser que es un servidor http incorporado al que puede conectarse con su navegador, o algo así como Tk::Pod que es el navegador de la GUI pod.

Fuente

2009-10-02 15:21:29 mpeters

Así que ya sabes, tu primer enlace está muerto. – ale10ander

@Cptn_Hammer lo arregló para los mpeters – derobert

Lo recomiendo convertir toda su POD a HTML usando pod2html

Esto hace que sea navegable, vinculado y de aspecto agradable, y se puede personalizar la apariencia & sentir a través de CSS.

Fuente

2009-10-02 15:15:37 DVK

Esto es lo que uso, ya que es útil cuando se desconecta de la red y es utilizable desde la línea de comandos con lynx (lamentablemente, el bit no está en la distribución estándar de MacOSX, pero Macports lo tiene). Me pregunto si es posible establecer una preferencia ExtUtils :: MakeMaker para construir documentos html de forma predeterminada para todas las instalaciones ... – Ether

¿Has visto CPAN::Mini::Webserver o Pod::POM::Web o Apache::Perldoc? Estos configuran una forma local para que veas bonitas versiones HTML de tus documentos.

Fuente

2009-10-02 16:07:06

¡Solo para agregar dos servidores POD más que parecían haberse perdido hasta ahora!

Fuente

2009-10-03 16:21:25 draegtun

Qué hay para elegir entre estas varias opciones – justintime

@justintime: No se usó Pod :: Servidor web, por lo que no puedo comentar sobre eso. Pero uso Pod :: Server y estoy muy contento con él. Me gusta la forma en que representa el POD y porque se basa en el marco de Squatting me siento cómodo sabiendo que puedo hacer enmiendas locales si es necesario (que no he hecho hasta ahora ... ¡pero sería una buena idea agregar una opción de búsqueda!) . – draegtun

Tener una mirada también en Gtk2 :: :: Ex PodViewer que es un excelente visor de interfaz gráfica de usuario basada en GTK. Si está utilizando también Windows, puede encontrar un contenedor preconstruido en Camelbox (http://code.google.com/p/camelbox/).

Fuente

2011-03-15 10:28:03 register

A primera vista, podviewer (v0.18, que según CPAN es el más reciente) parece un podbrowser menos pulido. – derobert

Perl documentation (POD) navegadores?

Respuesta

Cuestiones relacionadas