12
votes

Navigateurs de documentation Perl (POD)?

Je recherche est une bonne expérience de lecture de pod à l'écran.

pendant des années, j'ai utilisé perdoc ou man exécuté dans un xterm pour lire la documentation Perl à l'écran et un petit programme personnalisé Construit autour de POD :: latex pour l'imprimer. La version imprimée est bonne: le script fait un bon travail. Cependant, la lecture à l'écran est douloureuse:

  • Vous pouvez rechercher, mais bonne chance à trouver par exemple, la section comme dans dbix :: Classe :: ResulatsSet . Moins ne sait rien sur la structure du document et les recherches de mots anglais communs sont inutiles.
  • Je crains chaque fois que le document me dit voir la section SO-et-SO . Génial. Maintenant, je dois trouver ça. Puis revenir à l'endroit où je ne serais pas trivial (bien que cela puisse être mon moins d'ignorance montrant)
  • Voir le document si pire. ! Perldoc FOO fonctionne, mais la commutation entre les deux documents est alors difficile. Vous pouvez surtout contourner cela en suspendant moins et en cours d'exécution perdoc de la coquille, mais c'est plus de frappe et je suis paresseux.
  • Formatage Feuilles beaucoup à désirer.

    Je veux pouvoir cliquer sur une table des matières et aller dans cette section. Je veux pouvoir cliquer sur ça "voir autre" et y aller. Etc. Jusqu'à présent, je connais deux possibilités:

    • Search.cpan.org , exemple DBIX :: Classe :: ResultatsSet . Nécessite une connexion Internet, mais ce n'est pas normalement un problème.
    • podbrowser . Vient de commencer à essayer cela, a l'air assez gentil.

      Je couronne Debian GNU / Linux, Lenny et Squeeze. Mais veuillez suggérer des programmes pour toutes les plateformes pour que cela soit aussi utile que possible.


1 commentaires

Beaucoup de choses que vous vous plaignez est la matière que je fais juste dans une fenêtre de terminal séparée (ou un écran, ou autre). Je ne me soucie pas tellement de formater, non plus. :)


5 Réponses :


2
votes

Je voudrais recomposer la conversion de tout votre pod en HTML en utilisant POD2HTML

Cela le rend standable, lié et agréable, et vous pouvez personnaliser l'apparence et la sensation via CSS.


1 commentaires

C'est ce que j'utilise, car il est pratique lorsqu'il est déconnecté du Net et est tout aussi utilisable à partir de la ligne de commande avec Lynx (malheureusement n'est pas malheureusement dans la distribution standard MacOSX, mais Macports l'a dit). Je me demande s'il est possible de définir une préférence d'extutils :: Makemaker pour créer des documents HTML par défaut pour toutes les installations ...?



7
votes

Vous pouvez essayer POD :: Navigateur , serveur HTTP intégré que vous Peut se connecter à votre navigateur, ou quelque chose comme TK :: POD qui est GUI Navigateur de pod.


2 commentaires

Donc, vous savez, votre premier lien est mort.


@Cptn_hammer a corrigé pour les MPETERS



5
votes

Avez-vous vu CPAN :: Mini :: WebServer ou POD :: POM :: Web ou Apache :: Perldoc ? Celles-ci ont mis en place une façon locale pour vous de voir de belles versions HTML de vos documents.


0 commentaires

1
votes

Juste pour ajouter deux autres serveurs de pod qui semblaient avoir été manqués jusqu'à présent!


2 commentaires

Qu'y a-t-il de choisir entre ces différentes options


@justintime: POD non utilisé :: WebServer Alors ne peut pas commenter à ce sujet. Mais j'utilise POD :: serveur et j'en ai été très heureux. J'aime la façon dont il rend le gousson et parce que son cadre construit sur Squatting, je me sens à l'aise de savoir que je peux faire des amendements locaux si nécessaire (ce que je n'ai pas encore loin ... mais l'ajout d'une option de recherche serait une bonne idée!) .



0
votes

Jetez un coup d'oeil aussi à GTK2 :: Ex :: PodViewer qui est un excellent spectateur d'interface graphique basé sur GTK. Si vous utilisez également Windows, vous pouvez trouver un wrapper prébuilt dans CAMELBOX (http://code.google.com/p/camelbox/).


1 commentaires

À première vue, PodViewer (V0.18, que CPAN indique est le dernier) ressemble à un podbrowser moins poli.