[B! pod] lizyのブックマーク

Pod::Text::Color::Delight というモジュールをリリースしました - その手の平は尻もつかめるさ

[追記] 色々と問題を修正しましたので、最新版 (v0.0.5) をご利用なさる事をおすすめ致します。 (問題を報告して下さった@__gfx__さん、@uzullaさんありがとうございます) [追記ここまで] この度、Pod::Text::Color::Delight というモジュールをリリース致しました。 https://metacpan.org/pod/Pod::Text::Color::Delight https://github.com/moznion/Pod-Text-Color-Delight Perlの入門書や入門エントリ等を読みますと、「Perlのドキュメント調べるなら、`perldoc` コマンドでひくのが手っ取り早くて良い！」みたいな事がよく書かれていて、まあまあそれはその通りだよなーとは感じつつも、 `perldoc` コマンドで出力されるドキュメントって白黒で淡泊す

lizy 2013/10/27

perl
pod

リンク

モジュールをGithubに上げる際はトップのディレクトリに README.pod というエイリアスを貼ってほしいと勝手に主張したい件 - (引越し済) 聞かれてもいないことを喋る

Githubのページを開いたら、そこには This is Perl module XXX::XXXX:::XXX. INSTALLATION Install cpanm (App::cpanminus) and then run the following command to install HTML::Pictogram::MobileJp::TypeCast: $ cpanm XXX::XXXX:::XXX ... という説明しかなく、「俺が欲しいのはHow to Installじゃないよ！ SYNOPSISが見たいのだよ！」と仕方なく lib ディレクトリへのリンクをクリックする人は少なくないはずだ。まあ、PODを .pm ファイルから READMEにコピるなんて面倒くさいもんね。しかしGithubでは、PODの書かれた .pm ファイルをトップのディレクトリに README

lizy 2012/03/13

リンク

perlpod - plain old documentation

NAME DESCRIPTION Verbatim Paragraph Command Paragraph Ordinary Block of Text The Intent Embedding Pods in Perl Modules Common Pod Pitfalls SEE ALSO AUTHOR NAME perlpod - plain old documentation DESCRIPTION podから何かへのトランスレーターはpodファイルをパラグラフ毎に読み込み、それを適切な出力フォーマットへと変換します。パラグラフには以下の三種類あります。 <verbatim|/``Verbatim Paragraph''> command ordinary text Verbatim Paragraph そのままのパラグラフ。これはインデント(つまり、スペースかタブで始まって

lizy 2009/11/13

perl
pod

リンク

Pod の書き方 - miau's blog?

思いついたこととかメモ。 ■関数の階層今まで関数書くときは =head1 FUNCTIONS =over =cut =it em hoge なんか説明 =cut sub hoge { .... } =back =cut みたいに書いてたけど、it em じゃなくて head2 のほうがすっきりするのでこっちのほうがいい気がしてきた。 =head1 FUNCTIONS =cut =head2 hoge なんか説明 =cut sub hoge() { .... } pod2html すると関数名に <a name="hoge"> みたいな設定がされるのも魅力。 ■Pod で定数の出力 pod2html ではドキュメントが HTML で出力されるけど、HTML を出力するんじゃなくて HTML::Template やらで使うテンプレートを出力して、一回変換をかけてやるといいかも。つまり、 pac