NAME

Perl6::Pod::Block::Include - to include pod in the specified place

SYNOPSIS

=Include t/data/P_test1.pod(para :private :public)
=Include file:t/data/P_test1.pod
=Include http://example.com/api.pod(head1 :public)
=Include http://example.com/api.pod ( !DESCRIPTION )

=begin Include
file:../intro.pod( :!develop )
file:../api.pod(:public,para :notes)
http://example.com/todo.pod
=end Include

DESCRIPTION

The =Include block is used to include other Pod documents or their parts. The target file is defined by a URI:

=Include
file:../intro.pod
http://example.com/todo.pod

To include certain parts of a document, add the blockname and/or attributes after the main link. For example:

=Include file:../intro.pod(para :public,item1)
=Include http://example.com/document.pod ( :todo )

The content of included documents will be filtered through those rules.

Examples of the rules:

(para :pubic)

Only paragraphs with the attribute :public are included

(:todo :private)

Only blocks with the attributes :todo and :private are included

(head1, head2)

Only include head1 and head2 blocks

SEE ALSO

http://perlcabal.org/syn/S26.html,

Samples of =Include: https://github.com/zag/webdao/blob/master/contrib/webdao-book.pod6, https://raw.github.com/zag/ru-perl6-book/master/perl6-book.pod

AUTHOR

Zahatski Aliaksandr <zag@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2010 by Zahatski Aliaksandr

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.