Perl에서는 POD(Plain Old Documentation) 문서를 모듈이나 스크립트에 포함할 수 있습니다.
POD는 간단하고 사용하기 쉬운 마크업 언어(Markup Language)입니다.
POD 문서 사용 규칙:
POD 문서는 =head1 로 시작하고 =cut 으로 끝납니다. =head1 앞과 =cut 뒤에 빈 줄을 추가합니다.
Perl은 POD의 문서를 무시합니다. 예는 다음과 같습니다:
위 프로그램을 실행하면 출력 결과는 다음과 같습니다.
안녕하세요, WorldHello, Codercto
또한 "__END__" 또는 "__DATA__"를 사용하여 해당 줄 뒤의 모든 내용을 "주석 처리"할 수도 있습니다.
위 프로그램을 실행하면 출력 결과는 다음과 같습니다.
Hello, World=head1 Hello, World 예제 이것은 간단한 Perl 예제입니다. "안녕하세요, Codercton"을 인쇄합니다.
다음 예에서는 POD 문서를 읽지 않습니다.
위 프로그램을 실행하면 출력 결과는 다음과 같습니다.
안녕하세요, 세계
Pod(Plain Old Documentation)는 간단하고 사용하기 쉬운 마크업 언어(마크업 언어)로 Perl 프로그램 및 모듈에서 문서 작성에 자주 사용됩니다.
Pod 변환기는 Pod를 텍스트, html, man 등과 같은 다양한 형식으로 변환할 수 있습니다.
Pod 마크업 언어에는 일반, 텍스트, 명령이라는 세 가지 기본 유형이 포함되어 있습니다.
일반 단락 : 일반 단락에 굵게, 기울임꼴, 코드 스타일, 밑줄 등 서식 코드를 사용할 수 있습니다.
원본 단락 : 원본 단락, 변환기 처리가 필요하지 않은 코드 블록이나 기타 부분에 사용되며 단락 재정렬이 필요하지 않습니다.
명령 단락 : 명령 단락은 문서 전체에 작용하며 일반적으로 제목 설정이나 목록 마크업에 사용됩니다.
모든 명령 단락(단 한 줄 길이)은 "="로 시작하고 그 뒤에 식별자가 옵니다. 후속 텍스트는 이 명령의 영향을 받습니다. 이제 널리 사용되는 명령은 다음과 같습니다.
=pod(시작 문서)=head1 제목 텍스트=head2 제목 텍스트=head3 제목 텍스트=head4 제목 텍스트=들여쓰기된 공백 수 초과=항목 접두어=뒤(끝 목록)=시작 문서 형식=끝 end 문서 형식=형식 텍스트용 =인코딩 인코딩 유형=잘라내기(문서 끝)
Perl에서는 pod2html **.pod >**.html을 사용하여 html 형식의 Pod 문서를 생성할 수 있습니다.
다음 POD 인스턴스를 고려해보세요.
pod2html을 사용하면 이 코드가 원본 텍스트에서 복사됩니다.
pod2html 명령을 사용하여 이를 실행하고 HTML 코드로 변환합니다.
$ pod2html test.pod > test.html
브라우저에서 test.html을 열면 아래와 같이 링크 부분이 인덱스입니다.
다음 예에서는 POD 문서에 HTML을 직접 작성합니다.
=begin html=encoding utf-8<h1>코더 튜토리얼</h1><p> www.codercto.com </p>=end html
pod2html을 사용하면 이 코드가 원본 텍스트에서 복사됩니다.
pod2html 명령을 사용하여 이를 실행하고 HTML 코드로 변환합니다.
$ pod2html test.pod > test.html
브라우저에서 test.html을 열면 아래와 같이 링크 부분이 인덱스입니다.