Блоки визуализации

## Введение

Начиная с версии 1.3.5, в Scribus присутствует мощный инструмент под названием блоки визуализации. Первоначально задуманное как средство для вставки формул в документы Scribus, его создатель, Герман Краус (Hermann Kraus), позволил с его помощью создавать почти любой вид специального набора, такого как формулы, нотная запись или шахматная нотация, прямо в Scribus. Хитрость здесь заключается в том, что Scribus использует другие программы, запущенные в фоновом режиме, и импортирует их вывод в блоки специального типа, называемые блоками визуализации.

Хотя эта функция чрезвычайно универсальна, вы не должны забывать, что её использование требует знания кодов разметки, необходимых для конкретной программы. Эти коды в документации по Scribus не рассматриваются.

## Создание блока визуализации

Для создания блока визуализации щёлкните значок блока визуализации на панели меню, выберите пункт меню Вставка > Блок визуализации или нажмите клавишу D:

Курсор превратится в символ кадра с буквой L внутри: |

В качестве следующего шага перетащите рамку и отпустите её, как вы делали для текстовых блоков. По умолчанию, Scribus выведет приветственное сообщение, в котором будет указано, что по крайней мере конфигурация для LaTeX является верной. Ниже вы можете увидеть вывод LaTeX, визуализированный в Scribus. Приветственное сообщение будет отображено на языке пользовательского интерфейса, установленного в меню Настроить Scribus. Если перевод сообщения не доступен, будет показана английская версия:

Снимок экрана, представленный выше, был сделан со стандартным разрешением, равным 72 dpi, что, очевидно, недостаточно для печати. Изменить разрешение, как вы увидите далее, достаточно просто.

# Изменение блоков визуализации

При щелчке правой кнопкой мыши по блоку визуализации откроется контекстное меню, где одной из функций будет «Изменить источник»:

Её выбор приведёт к открытию «сердца» блоков визуализации — окна редактора:

В Scribus версии 1.4 редактор предварительно настроен для работы с LaTeX, Lilypond, gnuplot, dot/GraphViz и POV-Ray.

Слева находится поле с надписью «Введите код». Здесь вы можете вставить код разметки для вывода, ожидаемого из внешней программы. Для предварительно настроенных визуализаторов в Scribus имеются простые фрагменты кода, которые позволят проверить, правильно ли установлены и настроены соответствующие программы. Как вы можете видеть, редактор обеспечивает выделение синтаксических элементов.

Кнопка «Обновить» под текстовым полем обновит содержимое блока визуализации, чтобы у вас была возможность увидеть результаты изменений разметки без закрытия окна редактора. Кнопка «Вернуть» служит для отмены любого изменения, произведённого с текстом. Обратите внимание, что после начала изменения текста будет невозможно изменить средство визуализации. Например, если вы начали редактировать исходный код LaTeX, вы больше не сможете переключиться на Lilypond.

Справа вы можете видеть ряд вкладок. Они доступны не для всех предварительно настроенных языков разметки, поэтому иногда редактор показывает только вкладку «Параметры».

Первой записью на вкладке «Параметры» является «Разрешение». Его значение по умолчанию — «Автоматически», то есть 72 dpi, как было сказано выше. Значение разрешения при выводе можно легко изменить на что-нибудь более подходящее для печати.

Поле «Программа» содержит список поддерживаемых программ. В этом списке редактор отобразит все программы, заданные в меню Файл > Настроить Scribus > Внешние инструменты.

Если вы установите флажок «Использовать преамбулу», редактор будет автоматически использовать начальную и заключительную части, как указано в файлах конфигурации XML. Более подробную информацию можно найти ниже.

В «Сообщениях программы» показываются сообщения, которые в противном случае отображались бы в интерпретаторе командной строки. Они «перехватываются» программой Scribus, как и окончательный вывод, и часто используются для обнаружения проблем в процессе визуализации.

При нажатии на «Запустить внешний редактор» Scribus запустит редактор, указанный в параметрах программы, а кнопка «Убить программу» остановит выполнение внешней программы. Это может быть полезно, когда внешняя программа сталкивается с ошибкой, допущенной в разметке, что приводит к остановке или даже сбою в работе внешней программы.

## Предварительно настроенные программы

### LaTeX

Первая вкладка для LaTeX называется «Шрифты и заголовки». В верхнем выпадающем списке вы можете указать шрифт, используемый в блоке визуализации с LaTeX. По умолчанию, в списке присутствует всего четыре шрифта, но можно легко добавить новые путём изменения файла конфигурации LaTeX способом, описанным далее: Просто добавьте ещё один шрифт под записью `<list name="font" default="">` в файле. Обратите внимание на то, что список шрифтов для LaTeX (как и для других программ для разметки), скорее всего, будет кардинально отличаться от шрифтов, доступных в Scribus и других программах, поскольку программа LaTeX использует свои собственные шрифты и должна быть настроена на использование шрифтов типов Type 1, TrueType и OpenType, доступных в таких программах, как Scribus или LibreOffice. Дополнительные сведения о настройке шрифтов для LaTeX можно получить в Руководстве по выбору шрифтов для LaTeX (PDF).

Следующий выпадающий список позволяет изменить кегль шрифта по умолчанию. Если вы уже пользовались LaTeX, то знаете, что этот параметр относится к основному шрифту. Другие необходимые размеры шрифта, например, для верхнего и нижнего индексов, определяются LaTeX. Вы также заметите, что в редакторе перечислены только некоторые размеры основного шрифта. Опять же, другие размеры можно с лёгкостью добавить под строкой `<list name="fontsize" default="11pt">` в файле конфигурации LaTeX. Поскольку возможности настройки файла LaTeX практически не ограничены, вы можете выбрать различные файлы конфигурации XML в меню Файл > Настроить Scribus > Внешние инструменты.

Текстовое поле «Дополнительные заголовки» позволяет добавить дополнительные заголовки к преамбуле разметки LaTeX, которые будут сохранены в SLA-файле Scribus.

Наконец, можно увидеть различные вкладки с рисунками и символами, которые могут быть созданы при помощи LaTeX:

Чтобы вставить символ в код разметки, можно либо выбрать символ и нажать кнопку «Вставить символ», либо дважды щёлкнуть по значку символа.

Дополнительную информацию можно получить на официальном сайте LaTeX.

### Lilypond

Для Lilypond не доступно никаких дополнительных параметров.

Дополнительную информацию можно получить на официальном сайте Lilypond.

### gnuplot

Функции gnuplot довольно просты. На вкладке «Диапазоны» можно задать начальные и конечные значения для шкал по осям X и Y. По умолчанию используется звёздочка, в результате чего gnuplot подбирает значения автоматически в соответствии со значениями, заданными в тексте разметки.

Вкладка «Метки» служит помощником для задания некоторых визуальных аспектов графика:

- «Название» создаст заголовок для вашего графика, который будет размещён в верхней части визуализированного изображения.
- «Метка оси X» и «Метка оси Y» создадут подписи к осям X и Y.
- Действие полей «Сетка» и «Слой сетки» аналогично действию параметров направляющих/сетки страницы в Scribus, за исключением того, что сетка на графике станет частью визуализированного изображения. Для выбора доступны варианты полного отсутствия сетки, отображения основных линий сетки («Только основные линии») или же основных и вторичных линий сетки («Основные и вторичные линии»). Так же, как и в Scribus, сетку можно отобразить на заднем или на переднем плане.
- «Начало координат» создаст пунктирную линию для обозначения осей X и/или Y. Обратите внимание: сетка любого вида сделает использование начала координат ненужным, поскольку они с сеткой используют один и тот же цвет. Если вы хотите использовать разный стиль линий сетки и осей, вы должны указать это в тексте разметки. Аналогично, добавление оси Z требует редактирования исходного кода графа.

Дополнительную информацию можно получить на официальном сайте gnuplot.

### dot/Graphviz

Для dot/Graphviz не доступно никаких дополнительных параметров.

Дополнительную информацию можно получить на официальном сайте Graphviz.

### POV-Ray

Редактор предлагает только одну вкладку для визуализации файлов POV-Ray, а именно «Параметры визуализации»:

- «Качество» обеспечивает те же семь уровней качества, что и интерфейс командной строки POV-Ray, а редактор использует тот же уровень по умолчанию («Вычисление сред и диффузных отражений» («Compute media and radiosity»)). В противном случае уровни качества перечислены в порядке возрастания, где наихудшее качество обеспечивает уровень «Показывать только быстрые цвета».
- «Сглаживание» — это метод «сглаживания» краёв в визуализированном изображении. Оно может значительно улучшить качество изображения, но его использование может привести к гораздо более длительной визуализации. Параметры «Порог сглаживания» и «Глубина сглаживания» подробно описаны в документации по POV-Ray, но в большинстве случаев значений по умолчанию должно быть достаточно.

Дополнительную информацию можно получить на официальном сайте POV-Ray.

## Отрисовка

После создания разметки по своему вкусу нажмите кнопку «ОК».

Если вы допустили ошибку и внешняя программа не сможет отрисовать эту разметку, Scribus отобразит сообщение об ошибке:

Помимо сообщения об ошибке, обозначением отсутствия отрисованного содержимого будет синий символ «X» в блоке визуализации:

## Дополнительные примечания

Взглянув на контекстное меню блоков визуализации, вы можете перепутать их с блоками изображений. И в какой-то степени будете правы, поскольку тут так же можно изменить параметры предварительного просмотра или обновить содержимое. Однако, есть одно существенное различие: как было сказано выше, текст разметки хранится в файле Scribus, а визуализируемое содержимое всегда создаётся «на лету». Каджый раз, когда вы открываете файл Scribus, содержащий блок визуализации, будет запущена программа, необходимая для его отрисовки, и создан временный файл изображения, которое затем будет помещено в блок. Вот почему блоки визуализации не перечислены в разделе меню Расширения > Управление изображениями.

У такого поведения имеются некоторые последствия. Хотя вы можете использовать файл Scribus с изображениями на другом компьютере, используя Файл > Собрать для вывода и копируя полученный архив на другую машину, для блоков визуализации требуется наличие необходимого программного обеспечения на этой машине. Более того, функция может не работать на разных операционных системах из-за разных параметров командной строки.

Другое ограничение заключается в том, что не все графические эффекты могут быть применены к блокам визуализации.

## Конфигурация

Для работы блоков визуализации на компьютере должны быть установлены необходимые программы. По умолчанию, в Scribus поддерживаются пять программ, а именно: LaTeX, Lilypond, gnuplot, dot/Graphviz и POV-Ray. В Linux диспетчер пакетов позаботится об установке и зависимостях программного обеспечения. На других платформах может понадобиться отдельная установка программ, а также изменение некоторых файлов конфигурации.

Если вы откроете вкладку «Внешние инструменты» в меню настройки, то увидите параметры настройки блоков визуализации в нижней части диалогового окна:

В поле «Конфигурации» Scribus показывает стандартные файлы конфигурации. Для каждой программы, которую вы хотите использовать в Scribus, необходим отдельный файл конфигурации. Чтобы добавить новую программу для блоков визуализации, вы должны создать XML-файл с необходимыми параметрами. Ниже в качестве примера вы можете увидеть урезанный файл конфигурации gnuplot с комментариями:

`<editorsettings description="Gnuplot" icon="gnuplot.png">` Эта строчка задаёт описание программы, а также значок для выпадающего списка в редакторе блоков визуализации. Он должен храниться в том же каталоге, что и XML-файл. Для значка можно использовать файлы с расширением PNG, XPM или SVG.

`<executable command="gnuplot">` Это команда запуска программы из командной строки. Можное использовать только программное обеспечение, которое может работать в командной строке. Кроме того, программа должна иметь возможность выводить данные в формате PNG, PDF или EPS. По умолчанию Scribus использует параметры командной строки для систем Linux/UNIX.

`<imagefile extension=".png"/>` Здесь можно указать редактору, какой формат файла следует ожидать от внешней программы.

`<highlighter> </highlighter>` Эта часть в основном интересна программистам, поскольку она позволяет создавать индивидуальные схемы выделения синтаксических элементов путём использования регулярных выражений. Дополнительную информацию можно получить по адресам http://docs.kde.org/kde3/en/kdeutils/KRegExpEditor/index.html и http://doc.trolltech.com/4.4/qregexp.html.

`<empty-frame-text>` Здесь можно ввести пример текста на языке разметки программы, которую вы хотите использовать, например:

`plot sin(x), (cos(x))**2`

`<preamble>` Если язык разметки, который вы хотите использовать, требует начальной части, вы можете ввести её здесь. В редакторе она показываться не будет.

`<postamble>` Если язык разметки, который вы хотите использовать, требует конечной части, вы можете ввести её здесь. В редакторе она показываться не будет.

`<tab type="settings">` Сюда с помощью простых записей XML могут быть добавлены переводы существующих строк GUI, а также новые вкладки или другие элементы пользовательского интерфейса, например:

`<title><i18n>` ``

- <en>Ranges</en>
- <de>Bereiche</de>.org.org.org
- <fr>Rangées</fr>
- <pl>Zakresy</pl>
- <ru>Диапазоны</ru>

Для добавления нового файла конфигурации, нажмите кнопку «Добавить...». Откроется диалоговое окно. Выберите ваш файл и нажмите «Открыть». Файл будет добавлен в конфигурацию блока визуализации.

Перемещая записи XML выше или ниже по списку, можно изменить порядок записей в выпадающем списке редактора. Если вы хотите использовать другой файл конфигурации XML для определённого языка разметки (например, если вам нужна другая преамбула по умолчанию для блоков LaTeX в проекте), вы можете изменить путь к альтернативному файлу, нажав «Изменить...» или просто добавить новый файл конфигурации с соответствующим именем, например, «MyLateX».

Если вы предпочитаете другой редактор для вашей разметки, например, если не можете жить без Emacs или vi, или если окно редактора просто слишком мало для вас, вы можете заменить встроенный редактор блоков визуализации Scribus на другой редактор, такой как vi или Kate. Просто вставьте путь к исполняемому файлу в текстовое поле «Внешний редактор». Внешний редактор не будет переопределять редактор блоков визуализации: Как только вы сохраните разметку во внешнем редакторе, Scribus «перехватит» данные и отобразит вывод в блоке или же выведет сообщения об ошибках в поле «сообщения программы». Перехват вывода также означает, что любое изменение текста разметки будет сохранено только в вашем файле Scribus. Если вы не указали внешний редактор в меню Настроить Scribus > Внешние инструменты, Scribus выведет сообщение об ошибке:

Кроме того, у вас есть возможность начать с пустого блока. Установив флажок «Принудительное использование dpi», Scribus отрисует выход каждого блока визуализации с разрешением, указанным в поле счётчика справа. По умолчанию там из соображений производительности установлено значение 72 dpi. Если вы хотите создать документ для профессиональной печати, вам нужно будет выбрать более высокое разрешение.