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: