view release on metacpan or  search on metacpan

OODoc.pod  view on Meta::CPAN

        $section = $doc->getElement('//text:section[@text:name="Foo"]');
        $section = $doc->getSection("Foo");

=head2	OpenOffice::OODoc::Text

This manual page describes all the high level text processing methods and
allows the user's program to deal with all the text containers (headers,
paragraphs, item lists, tables, and footnotes). OpenOffice::OODoc::Text is
dedicated to the text content and structure of any kind of document, and *NOT*
to the so-called "text documents". As a consequence, this chapter describes
all the methods which process ODF text containers in spreadsheets and
presentations as well as in text documents.

The set of covered text objects includes all the markup elements that may be
inserted within paragraphs, such as variable text fields, notes, bibliography
entries, bookmarks, index entries, text runs with special styles, hyperlinks,
etc.

Whatever the document class, the ::Text part of OpenOffice::OODoc may apply to
some style definitions, too. For example, a page style may specify a header
and/or a footer that may contain paragraphs and other text elements.

=head2	OpenOffice::OODoc::Image

This manual page describes all the graphics manipulation API, i.e. all the
available syntax dedicated to insert or remove images in the documents, and
to control the presentation of these images.

Note that OpenOffice::OODoc does *NOT* include any graphical processing API; it
just deals with the Open Document way to include and display images. It allows,
for example, to control the color correction and the display size of an image in
the context of a particular document, but not to change the image itself.

=head2	OpenOffice::OODoc::Styles

This manual page describes the methods to be used to control the styles
of a document, knowing that each page layout, each text element, and each
image is displayed or printed according to a style. This part of the
documentation can be ignored if the user's programs are strictly content-
focused and don't care with the presentation.

Note that some style definitions, such as master pages, can include text
containers or images, which can be processed through methods provides by
OpenOffice::OODoc::Text or OpenOffice::OODoc::Image.

=head2	OpenOffice::OODoc::Document

This manual page describe some miscellaneous methods that deal simultaneously
with text, presentation and/or images. So, in order to discover the capabilities
of a "Document" object (created with ooDocument), the user should use the Text,
Image, Styles AND Document manual pages. The OpenOffice::OODoc::Document class
inherits all the features provided by the other classes with the exceptions of
OpenOffice::OODoc::File and OpenOffice::OODoc::Meta.

=head2	OpenOffice::OODoc::Meta

This manual page describes all the available methods to be used in order to
control the global properties (or "metadata") of a document. Most of these
properties are those an end-user can get or set through the "File/Properties"
command with the OpenOffice.org desktop software.

=head2	OpenOffice::OODoc::Manifest

This manual page describes the manifest management API, knowing that the
manifest, in an ODF file, contains the list of the file components
(or "members") and the media type (or MIME) of each one. The text content,
the style definitions, the embedded images, etc. are each one stored as a
separate "member".

=head1	GENERAL FUNCTIONS (EXPORTED)

=head3	odfConnector()

	Synonym: odfDocument()

=head3	odfContainer($filename)

	Shortcut for OpenOffice::OODoc::File->new().

	This function returns a File object, that is the object representation
	of the physical package containing the text, the images and the style
	definitions of an ODF document.

	See the OpenOffice::OODoc::File manual page for detailed syntax.
	See the OpenOffice::OODoc::Intro manual page to know why, in some
	situations, the using applications need or don't need to deal with
	explicit File objects.

	Synonyms: odfFile(), odfPackage().

=head3	odfDecodeText($ootext)

	Returns the translation of a raw ODF (UTF-8) string in the local character
	set. While the right translation is automatically done by the regular text
	read/write methods of OpenOffice::OODoc, this function is useful only if
	the user's application needs to bypass the API.

=head3	odfDocument()

	Shortcut for OpenOffice::OODoc::Document->new().

	This function is the most general document constructor. It creates
	and returns a new Document object. It can be instantiated on the basis of
	an existing ODF file, or using XML, OpenDocument-compliant data previously
	loaded in memory. With an appropriate "create" parameter, it can be used
	in order to create a new document from scratch as well. The Document class
	provides methods allowing a lot of read/update operations in the text
	content, the graphics, and the presentation. So ooDocument() is the
	recommended first call to get access to a document for further processing.

	See the OpenOffice::OODoc::Document manual page for detailed syntax.


=head3	odfEncodeText($ootext)

	Returns the translation of an application-provided string,
	made of local characters, in an ODF-compliant (UTF-8) string.
	The given string must comply with the active local encoding (see
	odfLocalEncoding()). While the right translation is automatically done
	by the regular text read/write methods of OpenOffice::OODoc, this