萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

強制更新 ActivePerl HTML 幫助文件:一行命令納入手動安裝模組的 POD

問題

ActivePerl 安裝時會依現有模組 POD 產生 HTML 幫助文件。但手動安裝(非 PPM)的模組,其 POD 不會自動加入幫助系統。

解決命令

> perl -MActivePerl::DocTools -e "UpdateHTML()"

或 Unix 風格:

$ perl -MActivePerl::DocTools -e'UpdateHTML()'

原理

  • ActivePerl::DocTools 為 ActivePerl 專用模組
  • UpdateHTML() 掃描 @INC 所有模組的 POD,重建完整 HTML 幫助樹
  • ActivePerl 安裝程式本身即呼叫此函數產生初始文件

適用情境

  • CPAN 安裝模組後:cpan> install Module::Name → 執行上述命令
  • 手動解壓模組至 site/lib 後
  • 定期維護:納入排程任務每週更新一次

補充:查看特定模組文件

perldoc Module::Name          # 終端機檢視
perldoc -m Module::Name       # 顯示原始 POD
pod2html Module::Name.pm > out.html  # 單獨轉 HTML
copyright © 萬盛學電腦網 all rights reserved