Como abrir e converter POD para PDF para ler a documentação Perl

Propaganda

Embora já tenha sido um linguagem integral para programação web Qual idioma de programação aprender - Programação WebHoje vamos dar uma olhada nas várias linguagens de programação da Web que alimentam a Internet. Esta é a quarta parte de uma série de programação para iniciantes. Na parte 1, aprendemos o básico de ... consulte Mais informação , Perl agora caiu no esquecimento em favor de linguagens mais modernas como Python, Ruby e JavaScript. Muito poucas pessoas pensam que vale a pena o esforço para aprender Perl atualmente.

Mas isso não significa que o idioma seja inútil ou obsoleto. De fato, muitos sites e ferramentas da web modernos ainda contam com o Perl para as operações diárias - incluindo Craigslist, IMDb e DuckDuckGo -, se você estiver interessado em aprender, não deixe ninguém te parar ou te dissuadir 7 truques úteis para dominar uma nova linguagem de programaçãoNão há problema em ficar impressionado quando você está aprendendo a codificar. Você provavelmente esquecerá as coisas tão rapidamente quanto as aprende. Essas dicas podem ajudar você a reter melhor todas as novas informações.

consulte Mais informação .

Se você quiser aprender Perl, também desejará se familiarizar com o POD. Aqui está o que é, por que é importante e o que fazer quando você encontra esses arquivos.

O que são arquivos POD?

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

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 existe dentro do código, você pode pensar nele como comentários em qualquer outra linguagem de programação, exceto mais sofisticada e flexível.

#! / usr / bin / perl

use estrito;

use avisos;

= pod

= head1 Exemplo de cabeçalho

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

= corte

print “Apenas este código é executado. \ n ";

A documentação incorporada funciona bem para scripts independentes ou quando você deseja garantir que qualquer pessoa que depare com o arquivo também tem acesso garantido à documentação, mas pode ser complicado quando você deseja documentar uma base de código inteira em um nível mais alto nível.

Felizmente, o POD também pode ser usado para criar páginas do tipo manual que são mais adequadas para documentos orientados ao usuário (já que os usuários podem não querer se aprofundar no código fonte de um script). É quando os arquivos POD são úteis.

Como ler arquivos POD

Para ficar claro, a documentação POD incorporada é encontrada nos arquivos de script Perl reais entre as 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, indica que o arquivo é pura documentação e não inclui código-fonte.

Embora seja possível abrir arquivos POD em qualquer editor de texto, incluindo o Bloco de notas, você provavelmente só deseja fazer isso se estiver editando a documentação bruta. Pense nisso como abrir um arquivo HTML em um editor: com toda a marcação, é difícil ler o conteúdo real do texto.

Em vez disso, você deve usar algum tipo de ferramenta de leitor que obtenha a documentação bruta do POD e a apresente de maneira fácil de ler.

A maneira mais fácil é usar o perldoc ferramenta de linha de comando incluída automaticamente quando Perl está instalado no seu sistema. A maioria dos sistemas OS X e Linux vem com o Perl já instalado, mas os usuários do Windows precisarão instalá-lo manualmente. Felizmente, não é mais difícil do que executar um arquivo instalador.

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

Como converter POD para outros formatos

Mesmo que a perldoc A ferramenta não é muito difícil de usar, não é exatamente conveniente quando você deseja compartilhar a documentação com outras pessoas ou quando deseja lê-la fora do seu computador. É aí que você pode considerar a conversão para outro formato.

Convertendo para HTML: Instale e use o pod2html ferramenta que fornece uma maneira fácil de converter qualquer arquivo POD em um arquivo HTML legível. Infelizmente, ele só pode realizar uma conversão um para um (para que você não possa combinar vários arquivos POD em um único arquivo HTML).

Convertendo para PDF: Instale e use o pod2pdf, que é semelhante e tão fácil de usar quanto a ferramenta pod2html acima, exceto que ela é convertida em PDF em vez de HTML.

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

Convertendo para Markdown: Instale e use o pod2markdown ferramenta para traduzir entre POD e Markdown. O Markdown é uma linguagem de marcação de uso geral, ou seja, é mais provável que os usuários estejam familiarizados com ele e há mais ferramentas por aí que podem aceitar e exibir o Markdown.

Convertendo para LaTeX: Instale e use o pod2latex ferramenta. O LaTeX é outra linguagem de marcação, menos comum que o Markdown, mas ainda mais popular que o POD. O LaTeX é usado principalmente em documentos acadêmicos e científicos, mas, se você precisar, esse conversor existe.

Convertendo em texto sem formatação: Instale e use o pod2text ferramenta, que produz um arquivo somente de texto com formatação baseada em ASCII. Você provavelmente não precisará usar isso, mas, se precisar, saiba que a opção existe.

Esta publicação foi útil?

Depois de entender, os arquivos POD são extremamente simples e fáceis de usar. Existe um pouco de uma curva de aprendizado, mas é muito menor - especialmente se você já usou uma linguagem de marcação antes. Espero que agora você se sinta à vontade para lidar com arquivos POD.

Se você está se sentindo oprimido, pergunte a si mesmo estes perguntas importantes para codificadores novatos 4 perguntas a fazer antes de aprender a codificarAprender uma linguagem de programação é popular. Mas é para todo mundo? Antes de se comprometer, faça as seguintes perguntas e seja honesto. consulte Mais informação . Ter dificuldade não significa necessariamente que você não pretende ser um programador 6 sinais de que você não deve ser um programadorNem todo mundo está preparado para ser um programador. Se você não tem certeza absoluta de que pretende ser um programador, aqui estão alguns sinais que podem levá-lo na direção certa. consulte Mais informação , mas é importante ser honesto consigo mesmo e gerenciar suas expectativas.

Dito isto, preste atenção a essas dicas para aprendendo a codificar sem estresse Como aprender a programar sem todo o estresseTalvez você tenha decidido seguir a programação, seja para uma carreira ou apenas como um hobby. Ótimo! Mas talvez você esteja começando a se sentir sobrecarregado. Não é tão bom. Aqui está uma ajuda para facilitar sua jornada. consulte Mais informação e sabendo como distinguir bons tutoriais de codificação de maus O que faz um bom tutorial de programação?Nem todos os tutoriais de programação são iguais. Alguns beneficiam você e outros acabam desperdiçando seu tempo. Aqui está o que procurar em um tutorial de programação de qualidade. consulte Mais informação .

Para que você está usando o Perl? Você tem outras dicas para compartilhar ou perguntas a fazer? Deixe-nos saber nos comentários abaixo!