¿Cómo abrir y convertir la vaina a pdf para leer la documentación de perl

A pesar de que una vez fue una lenguaje incorporado de programación web, Perl ahora ha quedado en el camino a favor de los más modernos lenguajes como Python, Ruby y javascript. Muy pocas personas piensan que vale la pena el esfuerzo de aprender Perl estos días.¿Qué lenguaje de programación para aprender - Programación Web¿Qué lenguaje de programación para aprender - Programación WebHoy vamos a echar un vistazo a los diversos lenguajes de programación web que potencian el Internet. Esta es la cuarta parte de una serie de programación principiantes. En la parte 1, aprendimos lo básico del ...Lee mas

Pero eso no significa que el lenguaje es inútil u obsoletos. De hecho, una gran cantidad de sitios web modernos y herramientas web todavía dependen de Perl para las operaciones del día a día - incluyendo Craigslist, IMDb, y DuckDuckGo - por lo que si usted está interesado en aprenderlo, no dejes que nadie te detenga o disuadir.

Si usted va a aprender Perl, entonces también querrá familiarizarse con POD. Esto es lo que es, por qué es importante, y lo que hay que hacer cuando se encuentra con este tipo de archivos.

¿Qué son los archivos POD?

POD significa Documentación Plain Old, que es un lenguaje de marcado básico que se utiliza para dar formato al texto sin mucho esfuerzo. Es similar a el lenguaje de marcado de rebajas, pero específicamente diseñado para la documentación de código y módulos de fuente de Perl.¿Qué es Markdown? 4 razones por las que debe aprender ya!¿Qué es Markdown? 4 razones por las que debe aprender ya!Cansado de los editores de HTML y WYSIWYG? Luego de rebajas es la respuesta para usted, no importa lo que eres.Lee mas

POD se puede utilizar de dos maneras: puede existir directamente dentro del código fuente de un archivo Perl o puede existir como un archivo POD separada. Cuando existe dentro del código, se puede pensar en ello como comentarios en cualquier otro lenguaje de programación, excepto más elegante y más flexible.

#! / Usr / bin / perl

utilizar estric-

utilizar ADVERTENCIAS-

= vaina

= Head1 Header Ejemplo

Este script hace algunas cosas interesantes, como esto y lo otro. deben existir los siguientes parámetros para que funcione correctamente. No intente hacer esto en una máquina con problemas.

= cortar

se ejecuta la impresión “Sólo este código. norte"-

documentación incorporado funciona bien para las secuencias de comandos independientes o cuando se quiere asegurarse de que cualquier persona que se encuentra con el archivo también tiene la garantía de acceso a la documentación, pero puede ser engorroso cuando se quiere documentar un código base entera en un nivel superior.

Afortunadamente, POD también se puede utilizar para crear páginas de tipo manual que son más adecuados para los documentos orientados a los usuarios (Ya que los usuarios pueden no querer profundizar en el código fuente de un script en sí). Fue entonces cuando los archivos POD son útiles.

Cómo leer archivos POD

Para ser claros, la documentación POD incrustado se encuentra dentro de los archivos reales de scripts de Perl en el medio de líneas de código, y estos archivos de comandos vienen en uno de los dos formatos de extensión: .PL o .PM. Cuando vea una extensión .pod, indica que el archivo es pura documentación e incluye ningún código fuente.

Si bien es posible abrir archivos POD en cualquier editor de texto que incluye el Bloc de notas, es probable que sólo quiere hacer que si en realidad estás editando la propia documentación de crudo. Piense en ello como abrir un archivo HTML en un editor: con todo el margen de beneficio, el contenido de texto real es difícil de leer.

En su lugar, se debe utilizar algún tipo de herramienta lector que lleva la documentación POD prima y la presenta de una manera fácil de leer.

La forma más sencilla es utilizar el perldoc herramienta de línea de comandos que se incluye automáticamente cuando Perl está instalado en su sistema. La mayoría de OS X y sistemas Linux vienen con Perl ya está instalado, pero los usuarios de Windows tendrán que instalar manualmente. (Afortunadamente, no es más difícil que la ejecución de un archivo de instalación.)

Ahora lanzar la línea de comandos, vaya a donde se encuentra el archivo de POD, y el tipo perldoc [archivo .pod] para ver como el formato correcto. Por ejemplo, si el archivo fue nombrado library.pod entonces debería escribir library.pod perldoc y eso es.

Cómo convertir POD a otros formatos

A pesar de perldoc herramienta no es demasiado difícil de usar, que no es exactamente conveniente cuando se desea compartir la documentación con otros o cuando se quiere leerlo lejos de su computadora. Fue entonces cuando es posible que desee considerar la conversión a otro formato.

La conversión a HTML: Instalar y utilizar la herramienta pod2html que proporciona una manera fácil de traducir cualquier archivo de POD en un archivo HTML legible. Por desgracia, sólo se puede realizar una conversión de uno-a-uno (por lo que no es posible combinar varios archivos POD en un único archivo HTML).

La conversión a PDF: Instalar y utilizar la herramienta pod2pdf, que es similar y tan fácil de usar como la herramienta pod2html anterior, excepto que se convierte en PDF en lugar de HTML.

Otra opción sería convertir POD a HTML usando el método mostrado anteriormente, abra el archivo HTML en un navegador como Chrome o Firefox, y luego imprimir la página en PDF.

La conversión a Markdown: Instalar y utilizar la herramienta pod2markdown para traducir entre la vaina y de rebajas. Reducción del precio es un lenguaje de propósito general marcado, significa que los usuarios tienen más probabilidades de estar familiarizado con él y hay más herramientas por ahí que puede aceptar y mostrar rebaja.

La conversión a LaTeX: Instalar y utilizar la herramienta pod2latex. LaTeX es otro lenguaje de marcas, uno que es menos frecuente que la de rebajas, pero aún más popular que el POD. El látex se utiliza principalmente en los documentos académicos y científicos, pero en caso de que lo necesite, existe este convertidor.

La conversión a texto sin formato: Instalar y utilizar la herramienta pod2text, que produce un archivo de sólo texto con formato basado en ASCII. Es probable que no tendrá que utilizar esto, pero en caso de que no, saber que existe la opción.

¿Le resultó útil este mensaje?

Una vez que tenga la caída de ella, archivos POD son extremadamente sencillo y cómodo de usar. Hay un poco de una curva de aprendizaje, pero es muy menor - especialmente si usted ha usado un lenguaje de marcado antes. Esperemos que ahora se siente cómodo tratando con archivos POD.

Si se siente abrumado, hágase estas preguntas importantes para los programadores novatos. Tener dificultad no significa necesariamente que no está destinado a ser un programador, pero es importante ser honesto con uno mismo y gestionar sus expectativas.4 preguntas que debe hacerse antes de aprender a Código4 preguntas que debe hacerse antes de aprender a CódigoEl aprendizaje de un lenguaje de programación es muy popular. Pero, ¿es para todo el mundo? Antes de comprometerse a ello, no hágase las siguientes preguntas y ser honesto.Lee mas

Dicho esto, preste atención a estos consejos para aprender cómo codificar y sin estrés y sabiendo cómo saber tutoriales de codificación bien del mal.

¿Qué estás usando Perl para? Consiguieron algún otro consejo para compartir o preguntas que hacer? Háganos saber en los comentarios!