Теоретически во вставке может находиться любой Perl-код; он также имеет доступ ко всем переменным нашего скрипта. Однако вводить длинные программы в шаблон неудобно, поэтому разумно создать функции-обертки вроде heading(), paragraph(), list() и image(), вставляющие в документ заголовок, абзац, список и изображение соответственно. Для пользователя шаблона вызов этой функции будет выглядеть как простая подстановка или разворачивание макроса. Функция image(), например, может выглядеть так:

sub image {

    my ($file, $width, $height) = @_;

    $anchor = $doc->insertParagraph($anchor, position => 'after');

    $doc->insertImageElement("Image" . $image_no++, attachment => $anchor, import => $file, size => "${width}cm, ${height}cm");

    return undef;

}

Изображения в OpenDocument являются содержимым абзаца: мы создаем его методом insertParagraph(). Переменная $anchor содержит последний элемент, сгенерированный текущей вставкой, и используется в качестве якоря, чтобы данные элементы появлялись в итоговом документе в том же порядке, что и в шаблоне. Изображения, вставленные в документ, не обязательно будут иметь родной размер, поэтому их высота и ширина задается явным образом (в сантиметрах; использовать здесь 'px', то есть пискели, невозможно). Функция возвращает undef, так что никаких других изменений структуры документа в основном цикле не производится.

По такому же принципу можно запрограммировать и все остальные функции. Следует только иметь в виду одно обстоятельство: стиль, который вы явно или неявно присваиваете созданному элементу, уже должен быть определен в документе. Этого можно добиться, создав его вручную (средствами OpenOffice::OODoc::Style) или разместив в документе элемент с нужным стилем прямо в редакторе OOo Writer.

Рассмотренные здесь примеры, конечно, не претендуют на полноту, но, хочется надеяться, дают представление об использовании OpenOffice::OODoc при решении повседневных задач. Все скрипты, по возможности, проектировались максимально расширяемыми, так что вы можете использовать их в собственных целях. Если у вас получится что-то общественно-полезное, не забудьте опубликовать код где-нибудь на SourceForge.net!

Приложение

OpenDocument изнутри

Документы OpenDocument представляют собой обычный ZIP-архив, расширение которого подбирается в соответствии с типом документа (.odt – для текста, .ods – для электронных таблиц и т. п.). Внутри архива находится несколько XML-файлов и каталогов, наиболее важные из которых таковы:

n  content.xml – непосредственно содержимое документа: текст, таблицы, ссылки на изображения. Последние могут находиться в каталоге Pictures в том же архиве или быть полностью внешними. В файле content.xml также определяются так называемые автоматические стили – то есть те, которые создаются офисным пакетом, когда вы нажимаете кнопки «жирный», «курсив», «список» в панели инструментов. В отличие от именованных стилей (Базовый, Основной текст, Заголовок 1 и т. д.), автоматические стили не имеют постоянного имени.