AtteanX::Serializer::RDFa - RDFa Serializer for Attean
use Attean; use Attean::RDF qw(iri); use URI::NamespaceMap; my $ser = Attean->get_serializer('RDFa')->new; my $string = $ser->serialize_iter_to_bytes($iter); my $ns = URI::NamespaceMap->new( { ex => iri('http://example.org/') }); $ns->guess_and_add('foaf'); my $note = RDF::RDFa::Generator::HTML::Pretty::Note->new(iri('http://example.org/foo'), 'This is a Note'); my $ser = Attean->get_serializer('RDFa')->new(base => iri('http://example.org/'), namespaces => $ns, style => 'HTML::Pretty', generator_options => { notes => [$note]}); $ser->serialize_iter_to_io($fh, $iter);
This module can be used to serialize RDFa with several different styles. It is implemented using Attean to wrap around RDF::RDFa::Generator, which does the heavy lifting. It composes Attean::API::TripleSerializer and Attean::API::AbbreviatingSerializer.
In addition to attributes required by Attean::API::TripleSerializer that should not be a concern to users, the following attributes can be set:
style
This attribute sets the serialization style used by RDF::RDFa::Generator, see its documentation for details.
namespaces
A HASH reference mapping prefix strings to URI::NamespaceMap objects. RDF::RDFa::Generator will help manage this map, see its documentation for details.
base
An Attean::API::IRI object representing the base against which relative IRIs in the serialized data should be resolved. There is some support in RDF::RDFa::Generator, but currently, it doesn't do much.
generator_options
A HASH reference that will be passed as options to RDF::RDFa::Generator's create_document method. This is typically options that are specific to different styles, see synopsis for example.
create_document
This implements four required methods:
serialize_iter_to_io( $fh, $iterator )
Serializes the elements from the Attean::API::Iterator $iterator to the IO::Handle object $fh.
$iterator
$fh
serialize_iter_to_bytes( $fh )
Serializes the elements from the Attean::API::Iterator $iterator and returns the serialization as a UTF-8 encoded byte string.
media_types
file_extensions
Declares that HTML media types are used for the output of this module.
Please report any bugs to https://github.com/kjetilk/p5-atteanx-serializer-rdfa/issues.
RDF::RDFa::Generator, RDF::Trine::Serializer::RDFa.
The style attribute may be implemented with better constraints.
Make the writers (i.e. the code actually writing the DOM) configurable.
Kjetil Kjernsmo <kjetilk@cpan.org>.
This software is copyright (c) 2017, 2018, 2019, 2021 by Kjetil Kjernsmo.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
To install AtteanX::Serializer::RDFa, copy and paste the appropriate command in to your terminal.
cpanm
cpanm AtteanX::Serializer::RDFa
CPAN shell
perl -MCPAN -e shell install AtteanX::Serializer::RDFa
For more information on module installation, please visit the detailed CPAN module installation guide.