Como abrir e converter pod para pdf para ler a documentação perl

Apesar de ter sido uma vez um linguagem integral para programação web

, Perl agora caiu no esquecimento em favor das línguas mais modernos, como Python, Ruby e javascript. Muito poucas pessoas pensam que vale a pena o esforço para aprender Perl estes dias.Que linguagem de programação para aprender - Programação WebQue linguagem de programação para aprender - Programação WebHoje vamos dar uma olhada nas várias linguagens de programação web que o poder da Internet. Esta é a quarta parte de uma série de programação iniciantes. Na parte 1, nós aprendemos o básico de ...consulte Mais informação

Mas isso não significa que a linguagem é inútil ou obsoleto. Na verdade, um monte de sites e ferramentas modernas da web ainda dependem de Perl para as operações do dia-a-dia - incluindo Craigslist, IMDb, e DuckDuckGo - por isso, se você estiver interessado em aprender isso, não deixe ninguém te parar ou dissuadi-lo.

Se você estiver indo para aprender Perl, então você também vai querer se familiarizar com POD. Aqui está o que é, porque é importante, eo que fazer quando você tiver esses arquivos.

O que são arquivos POD?

POD significa Plain Old Documentation, que é uma linguagem de marcação básica que é usado para formatar o texto sem muito esforço envolvido. É semelhante a a linguagem Markdown marcação, mas especificamente projetado para documentar código fonte Perl e módulos.O que é Markdown? 4 razões pelas quais você deve aprender agoraO que é Markdown? 4 razões pelas quais você deve aprender agoraCansado de editores HTML e WYSIWYG? Então Markdown é a resposta para você, não importa quem você é.consulte Mais informação

POD pode ser usado de duas maneiras: pode existir diretamente no código-fonte de um arquivo Perl ou pode existir como um arquivo POD separado. Quando ela existe dentro do código, você pode pensar nisso como comentários em qualquer outra linguagem de programação, exceto amador e mais flexível.

#! / Usr / bin / perl

usar strict-

usar warnings-

= pod

= Head1 Exemplo Cabeçalho

Este script faz algumas coisas legais, como isso e aquilo. Os seguintes parâmetros devem existir para que ele funcione corretamente. Não tente fazer isso em uma máquina com problemas.

= cortar

print “Só esse código é executado. N”-

Video: Convertendo PDF para Encore 5 - Parte 01 de 02.avi

documentação incorporado funciona bem para scripts autônomos ou quando você quiser ter certeza de que qualquer um que se depara o arquivo também tem acesso garantido a documentação, mas pode ser complicado quando você deseja documentar uma base de código inteiro em um nível superior.

Felizmente, POD também pode ser usado para criar páginas do tipo manual que são mais adequadas para documentos orientados para o utilizador (Já que os usuários não podem querer mergulhar no código fonte de si um script). Isso é quando os arquivos POD vir a calhar.

Como ler arquivos POD

Para ser claro, a documentação POD embutido é encontrado dentro de arquivos de script Perl reais entre linhas de código, e esses arquivos de script vêm em um dos dois formatos de extensão: .PL ou .pm. Quando você vê uma extensão .pod, isso indica que o arquivo é a documentação pura e inclui nenhum código fonte.

Embora seja possível abrir arquivos POD em qualquer editor de texto, incluindo o bloco de notas, você provavelmente só quero fazer isso se você está realmente edição da própria documentação cru. Pense nisso como abrir um arquivo HTML em um editor: com toda a marcação, o conteúdo de texto real é difícil de ler.

Em vez disso, você deve usar algum tipo de ferramenta de leitor que leva a documentação POD cru e apresenta-lo de uma maneira fácil de ler.

A maneira mais fácil é usar o perldoc ferramenta de linha de comando que é automaticamente incluído quando Perl está instalado em seu sistema. A maioria dos OS X e Linux vêm com Perl já está instalado, mas os usuários do Windows terão que instalá-lo manualmente. (Felizmente, não é mais difícil do que a execução de um arquivo de instalação.)

Agora lançar a linha de comando, navegue até onde o arquivo POD está localizado, e tipo perldoc [arquivo .pod] para vê-lo como formatado corretamente. Por exemplo, se o arquivo foi nomeado library.pod então você digita library.pod perldoc e é isso.

Como converter POD para outros formatos

Mesmo que o perldoc ferramenta não é muito difícil de usar, não é exatamente conveniente quando você quer compartilhar a documentação com os outros ou quando você quiser lê-lo longe de seu computador. Isso é quando você pode querer considerar a conversão em outro formato.

A conversão para HTML: Instalar e usar a ferramenta pod2html que fornece uma maneira fácil de traduzir qualquer arquivo POD em um arquivo HTML legível. Infelizmente, ele só pode executar uma conversão de um-para-um (então você não pode combinar vários arquivos POD em um único arquivo HTML).

A conversão para PDF: Instalar e usar a ferramenta pod2pdf, que é semelhante e tão fácil de usar como a ferramenta pod2html acima, exceto que ele converte em PDF em vez de HTML.

Outra opção seria converter POD para HTML usando o método mostrado acima, abra o arquivo HTML em um navegador como o Chrome ou Firefox, e em seguida, imprimir a página como PDF.

Convertendo para Markdown: Instalar e usar a ferramenta pod2markdown para traduzir entre POD e Markdown. Markdown é uma linguagem de propósito geral de marcação, significa que os usuários são mais propensos a estar familiarizado com ele e há mais ferramentas para fora lá que podem aceitar e mostrar remarcação.

Convertendo para LaTeX: Instalar e usar a ferramenta pod2latex. LaTeX é outra linguagem de marcação, um que é menos comum do que Markdown, mas ainda mais popular do que POD. LaTeX é usado principalmente em documentos acadêmicos e científicos, mas no caso de você precisar dele, existe este conversor.

Convertendo para Plain Text: Instalar e usar a ferramenta pod2text, que produz um ficheiro só de texto com formatação baseada em ASCII. Você provavelmente não vai precisar usar isso, mas no caso de você faça, saiba que a opção existe.

Foi este Post útil?

Uma vez que você tem o jeito dele, arquivos POD são extremamente simples e conveniente de usar. Há um pouco de uma curva de aprendizado, mas é muito menor - especialmente se você já usou uma linguagem de marcação antes. Esperamos que agora você se sentir confortável lidar com arquivos de PI.

Se você está se sentindo sobrecarregado, pergunte-se estes questões importantes para programadores novatos. Tendo a dificuldade não significa necessariamente que você não está destinado a ser um programador, mas é importante ser honesto consigo mesmo e gerir as suas expectativas.4 perguntas a se fazer antes de aprender como codificar4 perguntas a se fazer antes de aprender como codificarAprender uma linguagem de programação é popular. Mas é para todos? Antes de se comprometer com ele, pergunte a si mesmo as seguintes perguntas e ser honesto.consulte Mais informação

Dito isto, prestar atenção a essas dicas para aprender como codificar sem estresse e sabendo como dizer bons tutoriais de codificação de mau.

Video: Como Abrir Qualquer Arquivos PDF,HTML e TXT pelo Android

O que você está usando Perl para? Tem alguma dica para compartilhar ou perguntas a fazer? Deixe-nos saber nos comentários abaixo!