Manual:Image administration/ru

Данная статья содержит сведения о том, как MediaWiki хранит файлы и о том, как настроить этот функционал.

Это относится к изображениям так же, как и к любым другим типам файлов, которые могут быть загружены (uploaded). Все файлы хранятся с соответствующей статьёй в пространстве имён "File:" ("Файл:"). MediaWiki до версии 1.14 использовали пространство имён "Image:" вместо "File:". "Image:" до сих пор поддерживается как псевдоним для обратной совместимости.

Загрузка и использование изображений
Смотрите: Help:Images

Включение функции загрузки файлов
Для загрузки файла должны совпасть три условия:


 * 1) Функция загрузки файлов в MediaWiki должна быть включена. Установите $wgEnableUploads в true.
 * 2) Тип файла должен быть разрешенным. Подробности: $wgFileExtensions.
 * 3) Пользователь должен входить в группу с правом "upload". По умолчанию это право дано всем авторизованным пользователям.

Загрузка файлов выполняется с помощью Special:Upload.

Смотрите Manual:Configuring file uploads, Manual:Mime type detection

Параметры, относящиеся к работе с файлами
Следующие параметры имеют отношения к функционалу работы с файлами:
 * Конфигурация изображений
 * Конфигурация путей
 * Конфигурация загрузок

Создание миниатюр изображений
Расширенный синтаксис изображений MediaWiki позволяет автоматически создавать миниатюры изображений (см. Manual:Configuring file uploads/ru по общей помощи по загрузке файлов).

функция создания миниатюр (Image thumbnailing) требует наличия ImageMagick или библиотеки GD. Рекомендуется использовать ImageMagick для получения миниатюр лучшего качества. GD анимированные GIF превращает в статические картинки. ImageMagick сохраняет анимацию GIF в миниатюрах. Загрузить ImageMagick можно с imagemagick.org. Библиотека GD доступна для загрузки с libgd.org. Ни один из этих компонентов не является частью mediawiki, хотя GD может идти как расширение PHP.

Для установки ImageMagick нужно выполнить команду Полный список всех команд для установки ImageMagick можно найти http://firstwiki.ru/index.php/Установка_Imagemagick.

В старых версиях МедиаВики (до 1.10.0) для того, что бы включить создание миниатюр, требуется установить $wgUseImageResize в true. В новых версиях этого не требуется.

Если вы используете ImageMagick, установите $wgUseImageMagick в true в файле LocalSettings.php. Убедитесь что $wgImageMagickConvertCommand указывает на абсолютное положение команды конвертации и что команда выполнима для веб-сервера.

Включение ImageMagick вызывает ошибку: Для устранения ошибки нужно удалить из php.ini запрет на вызов proc_open Для пересоздания старых файлов миниатюр, созданных до использования ImageMagic, используйте $wgThumbnailEpoch.

GIF
Для создания миниатюр для анимированных GIF-файлов ы среде Windows, вам потребуется установить ImageMagick согласно описанию выше.

SVG
MediaWiki поддерживает возможность рендеринга изображений в формате SVG: если такая возможность включена, изображения в формате SVG могут использоваться так же, как и любые другие — они будут автоматически растеризоваться и отображаться в виде файлов в формате PNG, с генерацией миниатюр «на лету», по мере необходимости.

Для включения поддержки SVG необходимо:


 * 1) Разрешите в LocalSettings.php возможность загрузки файлов SVG: $wgFileExtensions[] = 'svg'; Обратите внимание, что по соображениям безопасности MediaWiki откажется обрабатывать SVG-файлы, содержащие JavaScript. Чтобы избежать ложных срабатываний, установите $wgAllowTitlesInSVG = true;. Если вы получаете сообщение об ошибке, где говорится, что файл повреждён, убедитесь, что определение типа MIME работает нормально.
 * 2) Установите $wgSVGConverter, который вы хотите использовать для растеризации.
 * Можно выбирать из ImageMagick, sodipodi, inkscape, batik, rsvg, и imgserv.
 * 1) * Если путь к выбранному программному конвертеру не содержится в переменной окружения system path, то нужно явно задать папку этой программы посредством параметра $wgSVGConverterPath.
 * 2) * librsvg быстр, но не очень аккуратен. Этот пакет включён в весьма сложную цепь зависимостей, в которой вы можете и не захотеть разбираться, если только у вас нет под рукой содержащего эту программу репозитория, который разрешит все эти зависимости за вас. Проекты Викимедиа используют rsvg 2.14. Замечание: Начиная с версии 2.22.3, есть ошибка в вызове локальных параметров (locale handling) — см. сообщение об ошибке в багтрекере Викимедиа и сообщение об ошибке в багтрекере GNOME). Доступна заплатка для инструмента.
 * 3) * Batik обеспечивает наиболее точную отрисовку SVG среди доступных решений, хотя подчас недостаточно хорошо справляется со сглаживанием (anti-aliasing). У него более строгие правила разбора SVG, что заставляет его отвергать «почти правильные» SVG-файлы, принимаемые другими конвертерами (например, commons:File:UbuntuCoF.svg). Батик основан на Java, и гораздо медленнее, чем rsvg, хотя это не может быть большой проблемой, если только вы постоянно не добавляете SVG-файлы. См. сравнительные тесты SVG. Требуется много усилий, чтобы заставить его работать, если только он не входит в ваш дистрибутив.
 * 4) * Inkscape также не слишком аккуратно обрабатывает SVG-файлы, и примерно в два раза медленне, чем rsvg. При этом он был спроектирован для интерактивной работы с графигой, поэтому требует, чтобы у запускающего его пользователя была на сервере домашняя папка (home directory) с правами на запись. Поскольку он будет работать как пользователь www или кто-то подобный, он будет пытаться создать папки .inkscape/ и .gnome2/ в соответствующей домашней папке, и молча сломается, если это ему не удастся. Inkscape предпочтительнее, чем rsvg, в случаях (а) если используется среда Windows (если говорить об отдельном пакете) или (б) если у вас имеются важные SVG-файлы, нарисованные в Inkscape, которые некорректно обрабатываются в rsvg. Inkscape связан сложной цепью зависимостей с librsvg &mdash; используйте, только если эти компоненты есть в вашем дистрибутиве или доступны в качестве полностью автономного пакета.
 * 5) * Sodipodi — это ответвление от Inkscape. Применимо всё то же самое, что и к Inkscape. Sodipod в настоящее время активно не разрабатывается.
 * 6) * ImageMagick обрабатывает SVG-файлы, но с массой ошибок. Кроме того, крайне медленно. Это значение по умолчанию, но избегайте его, если только это возможно.
 * 7) * Библиотека GD не способна преобразовывать изображения SVG в формат PNG, по крайней мере, согласно записи Джоя Асмуссена (Joen Asmussen) в блоге NoScope от июня 2008.
 * 8) * Многие современные веб-браузеры, за исключением Internet Explorer, умеют отображать файлы SVG напрямую — быстро, но неаккуратно (примерно так же, как ImageMagick). Использование librsvg для растенризации SVG и преобразования его в формат PNG даст гораздо более аккуратный результат. Прямое отображение SVG в MediaWiki по умолчанию не поддерживается.

JPEG (с использованием GD)
Об ошибках, связанных с созданием миниатюр JPEG-файлов, см. JPEG (с использованием GD).

TIFF

 * 1) Разрешите в LocalSettings.php возможность загрузки файлов TIFF: $wgFileExtensions[] = 'tif';
 * 2) Добавьте в LocalSettings.php параметр $wgTiffThumbnailType</tt> и установите его значение в jpg или png в зависимости от того, какой из этих форматов вы предпочитаете для создания миниатюр.
 * 3) Изготовление миниатюр для файлов TIFF может потребовать дополнительных системных ресурсов помимо тех, которые необходимы для миниатюр JPEG, GIF и PNG. Соответствующие настройки для этого — $wgMaxImageArea</tt> и $wgMaxShellMemory</tt>.

Удаление изображений
Файлы, как и вики-страницы, могут удалять только участники с правами « (delete)» (по умолчанию — ). Удаление файла вызывает также и удаление ассоциированной с ним вики-страницы с описанием (то же достигается, если перейти по ссылке «» в таблице «»).

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

История версий файлов отличается от истории изменений страниц с их описанием.

Информация о старых версиях файлов хранится в таблице «oldimage».

Восстановление файлов
Вплоть до версии MediaWiki 1.8, удаление изображений/файлов было невосстановимым (могли быть восстановлены только связанные с файлами страницы описаний).

Начиная с версии MediaWiki 1.8 и вплоть до 1.10, архивирование удалённых изображений/файлов (и, следовательно, их восстановление) по умолчанию отключено, но может включаться через настройку $wgSaveDeletedFiles = true.

Начиная с версии MediaWiki 1.11, эта функция по умолчанию включена, и $wgSaveDeletedFiles считается устаревшим. Вместо этого, поведение в отношении файлов находится под контролем$wgFileStore.

Информация об удалённых файлах хранится в таблице «filearchive».

Хранение данных
Как только изображение загружается, создаётся следующее:


 * 1) Статья в пространстве имён file с именем этого файла, например, File:MyPicture.png. Эта страница хранится и может редактироваться подобно любой другой странице.
 * 2) Сам файл, хранящийся в папке файловой системы.
 * 3) Если подключено создание миниатюр, при необходимости будут создаваться уменьшенные версии этого файла (например, для использования на странице описания файла). Они хранятся в папке thumb внутри директории images, в отдельной папке для каждого основного файла.

Если $wgHashedUploadDirectory включена (по умолчанию), MediaWiki создает несколько подпапок в директории images.

Названия папок являются первыми двумя символами md5-хеша конечного имени файла.

Папки
Все файлы изображений хранятся в отдельной папке, расположение которой определяется через $wgUploadPath.

Описание именованных подпапок изображений:


 * archive: Это место хранения файлов, которые заменены более новыми версиями.
 * temp: используется при загрузке изображений. (Но см. ошибку 9018, для таких файлов может оказаться недоступным автоматическое их удаление)
 * thumb: Миниатюры файлов (автоматически создаваемые). Будучи удалены, будут при необходимости автоматически восстановлены.

В зависимости от настроек, может использоваться дополнительная подпапка:
 * math: Папка для хранения растеризованных формул в формате TeX, см. также Manual:Enable TeX или Math.

Таблицы базы данных

 * The file description page is stored as any page in the page, text, revision etc. tables
 * image table: Holds some metadata such as the size of the file and the upload date.
 * oldimage table: This is stores information for files that have been replaced with newer versions.
 * filearchive table: holds the information on the deleted files.
 * imagelinks table: Records what pages use a file.

Использование дискового пространства
Files need considerably more space than articles. The following calculations assume a block size of 4KB with Linux/Unix servers.

Настройка по умолчанию выглядит как $wgHashedUploadDirectory = true.

Требуемое дисковое пространство для всех папок:


 * image directories: 0-f/x0-f: max. 16*16 = 256 directories = 256*4 KB = 1024 KB
 * archive directories: 0-f/x0-f: max. 16*16 = 256 directories = 256*4 KB = 1024 KB
 * thumb directories: 0-f/x0-f: max. 16*16 = 256 directories = 256*4 KB = 1024 KB
 * temp directories: 0-f/x0-f: max. 16*16 = 256 directories = 256*4 KB = 1024 KB

Therefore, the basic amount of space needed without any images uploaded is 4 MB in theory (although the directories are created only when needed).

Для каждого файла необходимо:
 * size of the original image file + 2 KB average overhead

Для файлов, которым требуются миниатюра:
 * size of the created thumbnail(s) + 2 KB average overhead (each)
 * directory for thumbnail (4KB) (each image has its own thumbnail directory)

Примеры:
 * image 20778 Byte png (small size, no thumb): 24 KB for the image: Total 24 KB
 * image 123.000 Byte jpeg (big size, auto thumb): 124 KB for the image, 4KB for the thumb directory, 64 KB for the thumb: Total: 192 KB

Доступ к файлам
Uploaded files are generally served directly by the web server, not through MediaWiki. While there may be a minimal level of security through obscurity with path encryption (eg. /c/c4/...) if $wgHashedUploadDirectory is set, the path can be calculated easily from the file name and does not provide true protection.

For limiting access to authorized users, see Image Authorization

Лицензирование
A feature of MediaWiki allows the Special:Upload Page to streamline licensing of images. Wikipedia's Upload Page has a Licensing drop down box below image summary. This feature is turned off in default MediaWiki. To turn this feature on a sysop needs to edit Licenses in the MediaWiki namespace. Example: MediaWiki:Licenses

Licenses expects a certain format in a wiki list.

Line 1 will produce "License text" and substitute the license 1 template in the image page and transclude license 2.

Line 2 will show a greyed out header with text "Header 1:"

Line 3 will produce "Attribution ShareAlike 2.5" and transclude template cc-by-sa-2.5 on the image page.

For detailed real world example, see w:en:MediaWiki:Licenses

Внешние хранилища
It is possible to access files stored in foreign repositories, without needing to upload them to the wiki, by setting the $wgForeignFileRepos array. This feature offers several possibilities:
 * ForeignAPIRepo accesses files from a remote MediaWiki installation, such as Wikimedia Commons, through its API
 * ForeignDBRepo accesses files through a database, and is useful for creating wiki families
 * FSRepo accesses files from a local folder

In all cases, one would be able to embed files into a page using ordinary image syntax and specifying the name of the file in the foreign repository. Note that some of the above implementations are still experimental, and might not be suitable for high-traffic sites.

If one merely wants make a file accessible from one's site, an alternative to implementing all of the above is:
 * 1) Place the file in e.g., images/
 * 2) Link to it in wikitext via [/images/lawnmower.png My lawnmower]

Версии MediaWiki
Применимо к версиям:
 * MediaWiki 1.9.x и выше
 * другие версии не проверялись