Comment ouvrir et convertir un fichier POD en PDF pour lire la documentation Perl

Quel était le langage de programmation à apprendre - Programmation Web à apprendre - Langage de programmation à apprendre - Programmation Web Aujourd'hui, nous allons examiner les différents langages de programmation Web qui propulsent Internet. Ceci est la quatrième partie d'une série de programmation pour débutants. Dans la partie 1, nous avons appris les bases de… Lire la suite, Perl est maintenant tombé en désuétude au profit de langages plus modernes tels que Python, Ruby et JavaScript. Très peu de gens pensent que cela vaut la peine d'essayer d'apprendre Perl ces jours-ci.

Mais cela ne signifie pas que la langue est inutile ou obsolète. En fait, de nombreux sites Web et outils Web modernes reposent toujours sur Perl pour les opérations quotidiennes, notamment Craigslist, IMDb et DuckDuckGo. Si vous souhaitez en apprendre davantage, ne laissez personne vous arrêter et dissuader. 7 Astuces utiles pour maîtriser un nouveau langage de programmation 7 Astuces utiles pour maîtriser un nouveau langage de programmation Vous pouvez vous laisser submerger lorsque vous apprenez à coder. Vous oublierez probablement les choses aussi vite que vous les apprendrez. Ces conseils peuvent vous aider à mieux conserver toutes ces nouvelles informations. Lire la suite .

Si vous voulez apprendre le Perl, vous voudrez aussi vous familiariser avec POD. Voici ce que c'est, pourquoi c'est important et quoi faire lorsque vous rencontrez de tels fichiers.

Que sont les fichiers POD??

POD signifie Plain Old Documentation, qui est un langage de balisage de base utilisé pour formater du texte sans trop d'effort. Il est similaire au langage de balisage Markdown Qu'est-ce que Markdown? 4 raisons pour lesquelles vous devriez apprendre maintenant Qu'est-ce que Markdown? 4 raisons pour lesquelles vous devriez apprendre maintenant Fatigué des éditeurs HTML et WYSIWYG? Alors Markdown est la solution pour vous, peu importe qui vous êtes. En savoir plus, mais spécialement conçu pour documenter le code source et les modules Perl.

POD peut être utilisé de deux manières: il peut exister directement dans le code source d'un fichier Perl OU il peut exister en tant que fichier POD séparé. Quand il existe dans le code, vous pouvez le voir comme des commentaires dans n’importe quel langage de programmation, à l’exception de plus sophistiqué et plus souple..

#! / usr / bin / perl

utiliser strict;

utiliser des avertissements;

= pod

= head1 Exemple d'en-tête

Ce script fait des trucs sympas, comme ceci et cela. Les paramètres suivants doivent exister pour que cela fonctionne correctement. N'essayez pas de faire cela sur une machine avec des problèmes.

= coupé

impression “Seul ce code est exécuté. \ n”;

La documentation intégrée fonctionne bien pour les scripts autonomes ou lorsque vous voulez vous assurer que tous ceux qui rencontrent le fichier ont également un accès garanti à la documentation, mais cela peut s'avérer fastidieux lorsque vous souhaitez documenter un code base complet à un niveau supérieur..

Heureusement, POD peut également être utilisé pour créer des pages de type manuel qui conviennent mieux aux documents orientés utilisateur. (puisque les utilisateurs peuvent ne pas vouloir fouiller dans le code source d'un script lui-même). C'est à ce moment que les fichiers POD sont utiles.

Comment lire les fichiers POD

Pour être clair, la documentation POD intégrée se trouve dans les fichiers de script Perl réels entre les lignes de code, et ces fichiers de script se présentent sous l’un des deux formats d’extension suivants: .PL ou .PM.. Lorsque vous voyez une extension .POD, cela indique que le fichier est de la pure documentation et qu’il ne contient aucun code source..

Bien qu'il soit possible d'ouvrir les fichiers POD dans n'importe quel éditeur de texte, y compris le Bloc-notes, vous ne voudrez probablement le faire que si vous éditez réellement la documentation brute elle-même. Pensez-y comme à l'ouverture d'un fichier HTML dans un éditeur: avec tout le balisage, le contenu du texte est difficile à lire..

Au lieu de cela, vous devriez utiliser une sorte d’outil de lecture qui prend la documentation brute du POD et la présente sous une forme facile à lire..

Le plus simple est d’utiliser le perldoc outil de ligne de commande qui est automatiquement inclus lorsque Perl est installé sur votre système. Perl est déjà installé sur la plupart des systèmes OS X et Linux, mais les utilisateurs Windows devront l’installer manuellement. (Heureusement, il n'est pas plus difficile d'exécuter un fichier d'installation.)

Maintenant, lancez la ligne de commande, accédez à l'emplacement du fichier POD et tapez perldoc [fichier .POD] pour le voir correctement formaté. Par exemple, si le fichier a été nommé bibliothèque.pod alors vous tapez perldoc library.pod et c'est tout.

Comment convertir POD en d'autres formats

Même si le perldoc Cet outil n’est pas trop difficile à utiliser, il n’est pas très pratique lorsque vous souhaitez partager la documentation avec d’autres personnes ou lorsque vous souhaitez la lire en dehors de votre ordinateur. C'est à ce moment-là que vous voudrez peut-être envisager de convertir en un autre format..

Conversion en HTML: Installez et utilisez l’outil pod2html qui offre un moyen simple de traduire tout fichier POD en fichier HTML lisible. Malheureusement, il ne peut effectuer qu'une conversion individuelle (vous ne pouvez donc pas combiner plusieurs fichiers POD dans un seul fichier HTML)..

Conversion en PDF: Installez et utilisez l'outil pod2pdf, qui est similaire et tout aussi facile à utiliser que l'outil pod2html ci-dessus, sauf qu'il convertit en PDF plutôt qu'en HTML..

Une autre option consisterait à convertir le POD en HTML en utilisant la méthode indiquée ci-dessus, à ouvrir le fichier HTML dans un navigateur tel que Chrome ou Firefox, puis à imprimer la page au format PDF..

Conversion en Markdown: Installez et utilisez l'outil pod2markdown pour effectuer la conversion entre POD et Markdown. Markdown est un langage de balisage à usage général, ce qui signifie que les utilisateurs sont plus susceptibles de le connaître et qu'il existe d'autres outils capables d'accepter et d'afficher Markdown..

Conversion en LaTeX: Installez et utilisez l'outil pod2latex. LaTeX est un autre langage de balisage, moins répandu que Markdown, mais toujours plus populaire que POD. LaTeX est principalement utilisé dans des documents académiques et scientifiques, mais au cas où vous en auriez besoin, ce convertisseur existe.

Conversion en texte brut: Installez et utilisez l'outil pod2text, qui produit un fichier contenant uniquement du texte avec un formatage basé sur ASCII. Vous n'aurez probablement pas besoin de l'utiliser, mais si c'est le cas, sachez que l'option existe.

Ce message était-il utile??

Une fois que vous avez compris, les fichiers POD sont extrêmement simples et pratiques à utiliser. Il y a un peu de courbe d'apprentissage, mais c'est très mineur, surtout si vous avez déjà utilisé un langage de balisage. J'espère que vous êtes maintenant à l'aise avec le traitement des fichiers POD.

Si vous vous sentez dépassé, posez-vous ces questions importantes pour les codeurs débutants. 4 questions à vous poser avant d'apprendre comment coder 4 questions à vous poser avant d'apprendre comment coder Apprendre un langage de programmation est populaire. Mais est-ce pour tout le monde? Avant de vous y engager, posez-vous les questions suivantes et soyez honnête. Lire la suite . Avoir des difficultés ne signifie pas nécessairement que vous n'êtes pas censé être programmeur. 6 Signes que vous n'êtes pas censé être programmeur. 6 Signes que vous n'êtes pas censé être programmeur. Tout le monde n'est pas fait pour être programmeur. Si vous n'êtes pas complètement sûr d'être censé être un programmeur, voici quelques signes qui peuvent vous orienter dans la bonne direction. Lisez plus, mais il est important d'être honnête avec vous-même et de gérer vos attentes.

Cela dit, tenez compte de ces astuces pour apprendre à coder sans stress. Comment apprendre à programmer sans trop de stress Comment apprendre à programmer sans tout de stress Peut-être avez-vous décidé de poursuivre la programmation, que ce soit pour une carrière ou comme un loisir. Génial! Mais peut-être que vous commencez à vous sentir dépassé. Pas si bien. Voici de l'aide pour faciliter votre voyage. Lisez-en plus et sachez comment expliquer les bons didacticiels de codage. Qu'est-ce qui fait un bon didacticiel de programmation? Qu'est-ce qui fait un bon tutoriel de programmation? Tous les tutoriels de programmation ne sont pas égaux. Certains profitent à vous et d'autres finissent par perdre votre temps. Voici ce qu’il faut rechercher dans un tutoriel de programmation de qualité. Lire la suite .

Pourquoi utilisez-vous Perl? Avez-vous d'autres conseils à partager ou des questions à poser? Faites-nous savoir dans les commentaires ci-dessous!

En savoir plus sur: Conversion de fichier, PDF, Programmation.