~funderscoreblog cgit wikiget in touch

Макрокоманда EmbedObject

Contents

  1. Макрокоманда EmbedObject
    1. Разрешение использования EmbedObject
    2. Синтаксис и использование
    3. Примеры

Эта макрокоманда используется для встраивания объектов в вики страницу. Объектами обычно являются сущности, обрабатываемые плагинами, такие как Flash, PDF или видео. Опционально может быть задан размер объекта. Остальные параметры зависят от типа приложения.

Если вложенный файл еще не загружен, будет показана строка вложения.

(!) Новое в 1.6: В МойнМойн появился новый (для некоторых форматов встраиваемых объектов достаточно экспериментальный) синтаксис включения: {{объект|описание|параметры}}.

Разрешение использования EmbedObject

EmbedObject — это стандартная макрокоманда. Тем не менее, в целях безопасности, для разрешения использования EmbedObject необходимо явно указать в wikiconfig.py разрешенные MIME-типы встраиваемых объектов.

  1. В файле wikiconfig.py добавьте в секцию «Content options» следующие строки: 

        mimetypes_xss_protect = ['text/html', 'application/x-shockwave-flash', 'application/xhtml+xml',] 
    
    mimetypes_embed = ['application/x-dvi', 'application/postscript', 'application/pdf', 'application/ogg', 'application/vnd.visio', 'image/x-ms-bmp', 'image/svg+xml', 'image/tiff', 'image/x-photoshop', 'audio/mpeg', 'audio/midi', 'audio/x-wav', 'video/fli', 'video/mpeg', 'video/quicktime', 'video/x-msvideo', 'chemical/x-pdb', 'x-world/x-vrml',]

  2. В mimetypes_embed нужно добавить и/или убрать типы вложений, оставив только те, которые будут использоваться. Например, если нужен Flash, переместите 'application/x-shockwave-flash' из mimetypes_xss_protect в mimetypes_embed.

см. также: КакНастраивать

поддерживаемые MIME-типы

Синтаксис и использование

<<EmbedObject(attachment[,option][,option])>>

Именованные параметры:

В зависимости от MIME-типа используются различные подмножества параметров из следующего списка: 

  width = None, float
  height = None, float
  pagename = None, unicode
  align = middle
  alt = ''
  play = False
  loop = False
  quality = high
  op = True
  repeat = False
  autostart = False
  menu = True
  hidden = False

Все MIME-типы поддерживают width и height.

(!) Начиная с версии 1.7 парсер МойнМойн поддерживает единицы измерения. Для параметров width и height в качестве единиц измерения допустимы px, em, pt, in, mm и %.

Если единицы измерения не указаны, по умолчанию используется px.

Дополнительно:

Примеры

Базовые примеры: 

<<EmbedObject(example.swf)>>
<<EmbedObject(example.pdf)>>
<<EmbedObject(example.svg)>>

Реалистичные примеры: 

<<EmbedObject(testpdf.pdf,width=100%,height=600px)>>
<<EmbedObject(example.swf,width=637px,height=392px,play=true,loop=true)>>