펄 POD 설명서
펄은 POD 모듈 문서 또는 스크립트 (일반 이전 문서) 포함 할 수 있습니다.
POD는 간단하고 태그 기반 언어 (마크 업 언어)를 사용하기 쉬운 것입니다.
규칙을 사용하여 POD 문서 :
POD 문서는= 표제 1 =절단 끝과 시작하고= 표제 1= 전에 빈 줄을 추가 한 후잘라.
펄은 POD 설명서를 무시합니다. 다음 예는 다음과 같다 :
#!/usr/bin/perl print "Hello, World\n"; =head1 Hello, World 实例 这是一个 Perl 的简单实例。 =cut print "Hello, w3big\n";
위의 프로그램은 출력은 다음과 같습니다
Hello, World Hello, w3big
우리는 또한 라인의 내용을 한 후 "__END__"또는 "__DATA__"를 사용할 수있는 모든 "댓글"아웃 :
#!/usr/bin/perl print "Hello, World\n"; while(<DATA>){ print $_; } __END__ =head1 Hello, World 实例 这是一个 Perl 的简单实例。 print "Hello, w3big\n";
위의 프로그램은 출력은 다음과 같습니다
Hello, World =head1 Hello, World 实例 这是一个 Perl 的简单实例。 print "Hello, w3big\n";
다음 예는 POD 문서를 읽을 수 있습니다 :
#!/usr/bin/perl print "Hello, World\n"; __END__ =head1 Hello, World 实例 这是一个 Perl 的简单实例。 print "Hello, w3big\n";
위의 프로그램은 출력은 다음과 같습니다
Hello, World
POD는 무엇인가?
포드 (일반 이전 문서)를, 간단하고 태그 기반 언어 (마크 업 언어)를 사용하기 쉬운, 그것은 종종 문서로 작성 펄 프로그램과 모듈에 사용됩니다.
포드 포드 변환 등등 텍스트, HTML, 사람이 많은 등의 다양한 포맷으로 변환 할 수있다.
정상, 원본 및 명령 : 포드 마크 업이 세 가지 기본 기본 유형으로 구성되어 있습니다.
정상 단락 : 당신은 밑줄, 굵게, 기울임 꼴, 또는 코딩 스타일로 일반 단락에 서식 코드를 사용할 수 있습니다.
원래 단락 : 텍스트 구절, 코드 블록의 일부 또는 다른 변환 처리가 필요하지 않고, 단락 재배치를 요구하지 않는다.
단락 명령 : 전체 문서 또는 제목 태그를 설정하는 데 사용 일반적으로 목록에 명령 단락 역할.
다음 "="를 사용하여 모든 명령 단락 (그의 유일한 선로 길이)의 식별자이다. 후속 텍스트는이 주문에 의해 영향을받습니다. 포함 명령 널리 사용
=pod (开始文档) =head1 标题文本 =head2 标题文本 =head3 标题文本 =head4 标题文本 =over 缩进空格数量 =item 前缀 =back (结束列表) =begin 文档格式 =end 结束文档格式 =for 格式文本 =encoding 编码类型 =cut (文档结束)
펄에서는 ** pod2html를 사용할 수 있습니다. 포드> **. html로 HTML 문서 포드 형식을 생성 할 수 있습니다.
POD는 다음과 같은 예를 생각해 볼 수 있습니다 :
=begin html =encoding utf-8 =head1 本教程 =cut
이 코드는 원래 때 복사 pod2html 될 것입니다.
HTML 코드로 변환하는 명령을 실행 pod2html 사용
$ pod2html test.pod > test.html
인덱스에 대한 부분을 연결, 브라우저 인 test.html를 열고 아래와 같습니다 :
다음 예는 POD 문서의 HTML에 직접 기록됩니다
=begin html =encoding utf-8 <h1>本教程</h1> <p> www.w3big.com </p> =end html
이 코드는 원래 때 복사 pod2html 될 것입니다.
HTML 코드로 변환하는 명령을 실행 pod2html 사용
$ pod2html test.pod > test.html
인덱스에 대한 부분을 연결, 브라우저 인 test.html를 열고 아래와 같습니다 :