## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnMacros/EmbedObject
##master-date:2010-05-14T18:26:16Z
#acl -All:write Default
#format wiki
#language ru

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

<<TableOfContents>>

Эта макрокоманда используется для встраивания объектов в вики страницу. Объектами обычно являются сущности, обрабатываемые плагинами, такие как 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',] 
}}}
 1. В {{{mimetypes_embed}}} нужно добавить и/или убрать типы вложений, оставив только те, которые будут использоваться. Например, если нужен Flash, переместите {{{'application/x-shockwave-flash'}}} из {{{mimetypes_xss_protect}}} в {{{mimetypes_embed}}}.
 
''см. также: КакНастраивать''

'''поддерживаемые MIME-типы'''
 . application/x-shockwave-flash
 . 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  

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

{{{
<<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.

Дополнительно:
 . {{{'video'}}} поддерживает параметры `repeat`, `autostart`, `menu`, `op`
 . {{{'audio'}}} поддерживает параметры `play`, `repeat`, `autostart`, `op`, `hidden`
  . по умолчанию width равен 60, а height — 20
 . {{{'application'}}} поддерживает `play`, `menu`, `autostart`

== Примеры ==

Базовые примеры:
{{{
<<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)>>
}}}