Включение в веб-страницы: вложенные и полноэкранные CDF документы

Файлы в формате CDF можно включать в веб-страницы или просматривать непосредственно в браузере как полноэкранные документы. Вложение CDF объектов может сводиться к простому вставлению фрагмента кода сгенерированного системой Mathematica при сохранении файла, или ввода <embed>-помеченного объекта в ваш HTML вручную.

Вышеприведенный пример выражается следующей простой строчкой HTML кода, в котором указывается имя файла и размер изображения:

<embed src="VoronoiDiagram.cdf" width="588" height="380">

Такой же метод подходит и для блогов, однако мы также предлагаем WordPress Plugin для простоты доступа к тем же JavaScript процедурам, к которым обращается код вложения, генерируемый системой Mathematica, и который повсеместно использован на этом сайте, который гарантирует кросс-платформенную совместимость и при необходимости направляет посетителя к Wolfram CDF Player. Видео ролик в разделе Развёртывание раскажет о том, как это работает.

Развертывание

Дополнительные подробности по включению

Для того, чтобы обеспечить совместимость с каждым типом браузера, вложенный контент должен быть помещен внутрь тэгов <object>, как проиллюстрированно в нижеследующем образце:

<object classid="clsid:612AB921-E294-41AA-8E98-87E7E057EF33" width="500" height="300" type="application/vnd.wolfram.cdf.text">
<param name="src" value="MYFILENAME.cdf">
<embed width="500" height="300" src="MYFILENAME.cdf" type="application/vnd.wolfram.cdf.text">
</object>

Скрипт для вложения Wolfram CDF

Для большей гибкости мы рекомендуем пользоваться скриптом для вложения Wolfram CDF, который является бесплатной JavaScript библиотекой с открытым исходным кодом. Он не использует никаких других библиотек и гарантирует совместимость со всеми браузерами, предоставляет средства проверки факта установки CDF плагина, отображает логитип CDF Player и ссылку на него, если плагин отсутствует, а также предоставляет возможность отображения статических изображений вместо интерактивного контента. Этот же JavaScript код используется в генерируемом системой Mathematica коде вложения. В целях дальнейшей модификации по вашему желанию этот же фрагмент кода показан здесь в качестве образца:

<script type="text/javascript" src="http://www.wolfram.com/cdf-player/plugin/v2.1/cdfplugin.js"></script>
<script type="text/javascript">
	var cdf = new cdfplugin();
	cdf.embed('/path/to/filename.cdf', width, height);
</script>

Код для вложения более чем одного экземпляра

Код Wolfram JavaScript работает по принципу "впечатывания" и может многократно применяться в одном HTML документе, но более эффективным является вложение множественных экземпляров без повторения исходного JavaScript кода или проверки наличия плагина:

<script type="text/javascript">
	cdf.embed('/path/to/additional.cdf', width, height);
</script>

Предоставление альтернативного содержимого

Считается хорошей практикой предоставление статического изображения содержимого CDF вставки на случай, если у посетителей вашего сайта не установлен CDF Player. Оно может давать ссылку на наш сайт загрузки CDF Player-а. Желаемое сообщение, отображаемое в таком случае, указывается с помощью функции setDefaultContent():

<script type="text/javascript">
	cdf.setDefaultContent('<p>Альтернативное содержимое</p>');
	cdf.embed('/path/to/additional.cdf', width, height);
</script>

Указание, что JavaScript должен быть включенным

Если у посетителей вашего сайта может быть отключен JavaScript, вставьте следующую строку в HTML страницу, содержащую CDF содержимое, вложенное с помощью JavaScript:

<noscript><p>Пожалуйста, включите JavaScript</p></noscript>

На странице Примеры вложения CDF материала можно найти CDF документ, который можно использовать для тестирования. Пишите нам для получения дополнительной информации по использованию скрипта Wolfram CDF Embed Script.

Форматирование документа для вложения

Интерактивный модуль оперативной помощи веб-развертывания CDF документа автоматически произведет форматирование контента и создаст код вложения.

При форматировании вручную, интерактивные диаграммы в вашем CDF файле должны быть помещены в ячейки стиля "PluginEmbeddedContent" в системе Mathematica. Для установки стиля ячейки выделите эту ячейку, выберите в меню Format > Style > Other и наберите в диалоговом окне "PluginEmbeddedContent". Эта операция осуществляет установку следующих опций:

ShowCellBracket->False,
CellMargins->{{0,  0}, {0, 0}},
ShowCellLabel->False

Кроме того, после установки всех других настроек, используйте Option Inspector системы Mathematica для установки опции Deployed->True для всего файла. Это предотвращает редактирование CDF документа и скрывает курсор.

Интерактивные диаграммы, созданные с помощью команды Manipulate системы являются масштабируемыми и автоматически регулируют свой размер в соответствии с размерами, указанными в коде вложения. Для достижения фиксированного размера диаграммы используйте явные значения ее опций ImageSize или ContentSize. Использование ImageSize->Medium приведет к использованию размеров, взятых системой Mathematica по умолчанию.

Для определения суммарного размера объекта, производимого командой Manipulate для указания параметров вложения, преобразуйте результат исполнения команды Manipulate в растровое изображение—для этого выделите скобку ячейки и выберите пункт меню Cell > Convert To > Bitmap. Затем выделите получившееся изображение в ячейке, щелкнув по нему, откройте Option Inspector, и найдите в нем ImageSizeRaw. Значение этого параметра даст ширину и высоту объекта Manipulate.

Невложенные полноэкранные CDF документы

Помимо возможности вложения, CDF файлы можно также просматривать в браузере в полноэкранном режиме путем открытия ссылки. Для того, чтобы открытие ссылки приводило к открыванию CDF файла, а не его загрузке, конфигурационные файлы на вашем сервере (.htaccess в случае Apache) должны указывать следующие MIME типы для расширения .cdf и других родственных файловых расширений:

application/vnd.wolfram.player nbp
application/vnd.wolfram.mathematica nb
application/vnd.wolfram.cdf cdf
application/vnd.wolfram.cdf.text cdf