Latest web development tutorials

documentación de Perl POD

Perl puede ser embebido POD (Llanura Documentación de edad) en la documentación del módulo o script.

POD es un simple y fácil de usar lenguaje basado en etiquetas (lenguaje de marcas).

documentación POD usando reglas:

documentación POD comienza conhead1 =, =extremocortado,y antes dehead1 == corta despuésdela adición de una línea en blanco.

Perl ignora la documentación POD. Ejemplos son los siguientes:

#!/usr/bin/perl

print "Hello, World\n";

=head1 Hello, World 实例
这是一个 Perl 的简单实例。
=cut

print "Hello, w3big\n";

El programa anterior, la salida es:

Hello, World
Hello, w3big

También podemos utilizar "__END__" o "__DATA__" después de que los contenidos de la línea en la que todos los "Comentarios" fuera:

#!/usr/bin/perl

print "Hello, World\n";

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

__END__

=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, w3big\n";

El programa anterior, la salida es:

Hello, World

=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, w3big\n";

Los siguientes ejemplos no son leídos documentación POD:

#!/usr/bin/perl

print "Hello, World\n";

__END__

=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, w3big\n";

El programa anterior, la salida es:

Hello, World

¿Cuál es POD?

Pod (Plain Old Documentación), es un simple y fácil de usar lenguaje basado en etiquetas (lenguaje de marcado), se utiliza a menudo en programas y módulos de perl escrito en el documento.

conversión Pod Pod se puede convertir en una variedad de formatos, tales como texto, html, hombre mucho y así sucesivamente.

Pod marcado consiste en tres tipos básicos básicos: normal, original, y los comandos.

  • párrafo normal: Puede utilizar códigos de formato en los párrafos ordinarios, como negrita, cursiva o estilo de programación, subrayado.

  • No se requiere pasajes de texto, por parte del bloque de código u otro procesamiento convertidor, pero no requiere el párraforeordenamiento: párrafo original.

  • Párrafo comandos: Comando papel párrafo en todo el documento o una lista de los comúnmente utilizados para establecer las etiquetas de título.

    Todos los párrafos de comando (su única línea de longitud) usando los "=" y luego es un identificador. El texto subsiguiente se verá afectada por esta Orden. Comando ahora es ampliamente utilizado incluirá

    =pod (开始文档)
    =head1 标题文本
    =head2 标题文本
    =head3 标题文本
    =head4 标题文本
    =over 缩进空格数量
    =item 前缀
    =back (结束列表)
    =begin 文档格式
    =end 结束文档格式
    =for 格式文本
    =encoding 编码类型
    =cut (文档结束)

En Perl, puede utilizar pod2html **. Pod> **. Html para generar un formato pod documento html.

POD Considere los siguientes ejemplos:

=begin html
=encoding utf-8

=head1 本教程

=cut

Este código será la copia original cuando pod2html.

Utilice pod2html ejecutar el comando para convertirlo en código HTML:

$ pod2html test.pod > test.html 

Test.html abrir el navegador, Sección de enlaces para el índice, se muestra a continuación:

Los siguientes ejemplos se escriben directamente en el HTML documentación POD:

=begin html
=encoding utf-8

<h1>本教程</h1>
<p> www.w3big.com </p>

=end html

Este código será la copia original cuando pod2html.

Utilice pod2html ejecutar el comando para convertirlo en código HTML:

$ pod2html test.pod > test.html 

Test.html abrir el navegador, Sección de enlaces para el índice, se muestra a continuación: