Perl-임베디드 문서

Perl 모듈 및 스크립트에 Pod (Plain Old Text) 문서를 임베드 할 수 있습니다. 다음은 Perl 코드에 포함 된 문서를 사용하는 규칙입니다.

빈 줄 a =로 문서를 시작하십시오.head1 시작 부분에 명령을 내리고 =cut

Perl은 코드에 입력 한 Pod 텍스트를 무시합니다. 다음은 Perl 코드에 포함 된 문서를 사용하는 간단한 예입니다.

#!/usr/bin/perl

print "Hello, World\n";

=head1 Hello, World Example
This example demonstrate very basic syntax of Perl.
=cut

print "Hello, Universe\n";

위의 코드가 실행되면 다음 결과가 생성됩니다.

Hello, World
Hello, Universe

파일 끝에 Pod를 배치하고 __END__ 또는 __DATA__ 절단 표시를 사용하는 경우 다음과 같이 첫 번째 Pod 명령 앞에 빈 줄을 두어야합니다. 그렇지 않으면 앞에 빈 줄이 없어야합니다. =head1, 많은 번역가는 =head1 포드 블록을 시작합니다.

#!/usr/bin/perl

print "Hello, World\n";

while(<DATA>) {
  print $_;
}

__END__

=head1 Hello, World Example
This example demonstrate very basic syntax of Perl.
print "Hello, Universe\n";

위의 코드가 실행되면 다음 결과가 생성됩니다.

Hello, World

=head1 Hello, World Example
This example demonstrate very basic syntax of Perl.
print "Hello, Universe\n";

DATA 부분을 읽지 않고 동일한 코드에 대한 예를 하나 더 살펴 보겠습니다.

#!/usr/bin/perl

print "Hello, World\n";

__END__

=head1 Hello, World Example
This example demonstrate very basic syntax of Perl.
print "Hello, Universe\n";

위의 코드가 실행되면 다음 결과가 생성됩니다.

Hello, World

POD는 무엇입니까?

Pod는 Perl, Perl 프로그램 및 Perl 모듈에 대한 문서를 작성하는 데 사용되는 사용이 간편한 마크 업 언어입니다. Pod를 일반 텍스트, HTML, 매뉴얼 페이지 등과 같은 다양한 형식으로 변환하는 데 사용할 수있는 다양한 변환기가 있습니다. 포드 마크 업은 세 가지 기본 유형의 단락으로 구성됩니다.

  • Ordinary Paragraph − 굵게, 기울임 꼴, 코드 스타일, 하이퍼 링크 등 일반 단락에 서식 코드를 사용할 수 있습니다.

  • Verbatim Paragraph − 축 어적 단락은 일반적으로 특별한 구문 분석이나 서식이 필요하지 않고 줄 바꿈해서는 안되는 코드 블록 또는 기타 텍스트를 표시하는 데 사용됩니다.

  • Command Paragraph− 명령 단락은 일반적으로 제목이나 목록의 일부로 전체 텍스트 청크를 특별하게 처리하는 데 사용됩니다. 모든 명령 단락은 =로 시작하고 그 뒤에 식별자가 있고 그 뒤에 명령이 원하는대로 사용할 수있는 임의의 텍스트가옵니다. 현재 인식되는 명령은-

=pod
=head1 Heading Text
=head2 Heading Text
=head3 Heading Text
=head4 Heading Text
=over indentlevel
=item stuff
=back
=begin format
=end format
=for format text...
=encoding type
=cut

POD 예

다음 POD를 고려하십시오-

=head1 SYNOPSIS
Copyright 2005 [TUTORIALSOPOINT].
=cut

당신이 사용할 수있는 pod2html 위의 POD를 HTML로 변환하기 위해 Linux에서 사용할 수있는 유틸리티이므로 다음과 같은 결과가 생성됩니다.

다음으로, 다음 예를 고려하십시오.

=head2 An Example List

=over 4
=item * This is a bulleted list.
=item * Here's another item.
=back
=begin html
<p>
Here's some embedded HTML.  In this block I can
include images, apply <span style="color: green">
styles</span>, or do anything else I can do with
HTML.  pod parsers that aren't outputting HTML will
completely ignore it.
</p>

=end html

pod2html을 사용하여 위의 POD를 HTML로 변환하면 다음과 같은 결과가 생성됩니다.

An Example List
   This is a bulleted list.
   Here's another item.
Here's some embedded HTML. In this block I can include images, apply 
styles, or do anything else I can do with HTML. pod parsers that aren't 
outputting HTML will completely ignore it.