Manual:Image administration/cs

Tento článek popisuje, jak MediaWiki zpracovává a ukládá soubory, a poskytuje některé informace o konfiguraci.

Platí to pro obrázky i pro jakýkoli jiný typ souboru, který lze nahrát. Všechny soubory jsou uloženy s odpovídajícím článkem ve jmenném prostoru "File:". Před MediaWiki 1.14 se místo toho používal jmenný prostor "Image:". "Image:" je stále zachován jako alias pro zpětnou kompatibilitu.



Nahrávání a používání obrázků
Podívejte se na



Povolení nahrávání obrázků
Chcete-li nahrát soubory, musí být splněny tyto podmínky:


 * 1) MediaWiki musí mít povoleno nahrávání. Nastavte  až.
 * 2) Typ souboru musí být povolen. Více informací je na stránce:.
 * 3) Uživatel musí být ve skupině s právem "upload" (nahrát). Ve výchozím nastavení je toto dáno všem přihlášeným uživatelům.

Nahrávání se provádí pomocí Special:Upload.

Viz také, a 



Relevantní parametry pro práci se soubory
Relevantní jsou tyto parametry:





Náhled obrázku
Syntaxe obrázků MediaWiki umožňuje dynamickou změnu velikosti a miniaturu obrázků (obecnou nápovědu k nahrávání souborů viz ).

Miniatura obrázků vyžaduje buď ImageMagick nebo Knihovnu GD – ani jedno není součástí výchozí instalace MediaWiki.

GD
PHP je standardně dodáváno s povoleným GD. K použití GD nebude vyžadovat žádnou konfiguraci ani úpravu.

Doporučuje se používat GD na systémech Windows.

GD lze stáhnout na https://libgd.github.io/. V posledních verzích PHP to není vyžadováno.

ImageMagick
V MediaWiki povolte ImageMagick v  nastavením  na.

ImageMagick lze stáhnout od https://imagemagick.org/.

Jakmile je ImageMagick nainstalován, musíte povolit ImageMagick a nasměrovat MediaWiki na program  nebo   na vašem počítači na  takto:

Pokud používáte ImageMagick, nastavte v LocalSettings.php na. Ujistěte se, že příkaz je spustitelný procesem webového serveru. Například uživatelé Windows budou chtít změnit výchozí nastavení na "C:\ImageMagick\convert.exe" (nebo podobné).

Chcete-li znovu vytvořit staré soubory miniatur před použitím ImageMagick, můžete použít.

Pokud se vykreslování nezdaří, zkontrolujte a zvyšte.

GraphicsMagick lze také použít jako alternativu k ImageMagick. Budete muset nastavit na následující. Například:



GIF
Pro zobrazení náhledů GIF-Animations pod Windows musíte nainstalovat ImageMagick, jak je popsáno výše.

SVG


MediaWiki podporuje vykreslování obrázků SVG: Pokud je povoleno, lze obrázky SVG používat jako jiné obrázkové soubory – automaticky se vykreslí jako soubor PNG a podle potřeby se za běhu vytvoří miniatury. Pokud jste na sdíleném hostiteli a nemáte předinstalovaný vykreslovací modul SVG, měli byste pravděpodobně požádat svého poskytovatele, aby vám jej nainstaloval.

Chcete-li povolit podporu SVG:


 * 1) Povolte nahrávání souborů SVG v souboru LocalSettings.php:   Upozorňujeme, že MediaWiki z bezpečnostních důvodů odmítne soubory SVG obsahující JavaScript.
 * Chcete-li se vyhnout falešně pozitivnímu výsledku, přidejte do souboru.
 * Pokud používáte MediaWiki 1.34 nebo vyšší, se nikdy nepoužije a nyní vždy . Toto můžete bezpečně odstranit ve svém souboru LocalSettings.php.
 * Pokud se zobrazí chyba, že soubor je poškozený, ujistěte se, že funguje správně.
 * 1) Přidejte   do  a nastavte renderer, který chcete použít.
 * Dostupné možnosti jsou ImageMagick, ImagickExt , sodipodi , inkscape , batika , rsvg a imgserv.
 * Například:
 * 1) * librsvg je rychlé, ale nepříliš přesné. Záleží na velkém počtu knihoven. Chcete-li automaticky nainstalovat všechny tyto knihovny, můžete použít správce balíčků. Projekty Wikimedie používají rsvg.
 * 2) * Batik je nejpřesnější dostupný renderer SVG, i když jeho vyhlazování někdy není optimální. Jeho analýza SVG je přísnější, což způsobuje, že odmítá "téměř platné" soubory SVG, které ostatní renderery přijímají (např. commons:File:UbuntuCoF.svg). Batik se spoléhá na Javu a je mnohem pomalejší než rsvg, i když to nemusí být velký problém, pokud neustále nepřidáváte soubory SVG. Viz SVG benchmarks. Spuštění vyžaduje hodně práce, pokud není součástí vaší distribuce.
 * 3) * Inkscape také dělá přesnou práci s SVG, pomohl rychlosti rsvg, ale byl navržen pro interaktivní grafické použití. Nicméně přichází s inkview, což je prohlížeč/převaděč – vyžaduje zapisovatelný domovský adresář pro uživatele, pod kterým je spuštěn. Protože bude spuštěn jako uživatel  nebo něco podobného, ​​pokusí se vytvořit adresáře   a   v odpovídajícím domovském adresáři a v tichosti selže, havaruje nebo visí na neurčito, pokud to nebude možné. Inkscape je vhodnější než rsvg (a) na Windows (dodává se jako samostatný balíček) nebo (b), pokud máte v Inkscape nakreslená důležitá SVG, která se v rsvg nevykreslují správně. Inkscape má stejně komplikovaný řetězec závislostí jako librsvg – používejte pouze v případě, že je ve vaší distribuci nebo je k dispozici jako kompletní samostatný balíček.
 * 4) * Sodipodi je program, ze kterého byl vytvořen Inkscape. Platí stejné úvahy. Sodipod již není v aktivním vývoji.
 * 5) * Od verze 6.x.x ImageMagick vykresluje SVG, ale nedokonale. Toto je výchozí nastavení, ale pokud je to možné, vyhněte se mu. Nicméně to funguje. V systému Windows je třeba nastavit $wgConvertPath, aby nedošlo ke konfliktu s vlastním convert.exe systému Windows. Jednoduchou alternativou v tomto scénáři je přidat do LocalSettings.php řádek, který také umožňuje mezery v cestě.
 * 6) ** Aby se předešlo chybám při vytváření náhledů pomocí ImageMagick, pokud je ≥ 7.0.9-25, pak musí být Inkscape také ≥ 1.x.x. Podobně, pokud je ImageMagick < 7.0.9-25, pak Inkscape musí být také < 1.x.x. Viz ImageMagick problém.
 * 7) * PHP rozšíření Imagick podporuje vykreslování SVG, platí však stejné úvahy jako pro běžný ImageMagick.
 * 8) * Knihovna GD není schopna převádět obrázky SVG do formátu PNG, alespoň podle blogu Joena Asmussena z června 2008 NoScope.
 * 9) * Většina současných webových prohlížečů kromě Internet Explorer (do verze 9) může zobrazovat SVG přímo. Použití librsvg k vykreslení SVG do PNG poskytne mnohem přesnější výsledky a také menší spotřebu šířky pásma. Přímé zobrazení SVG není v MediaWiki ve výchozím nastavení podporováno, pokud nenainstalujete rozšíření.
 * 1) * Většina současných webových prohlížečů kromě Internet Explorer (do verze 9) může zobrazovat SVG přímo. Použití librsvg k vykreslení SVG do PNG poskytne mnohem přesnější výsledky a také menší spotřebu šířky pásma. Přímé zobrazení SVG není v MediaWiki ve výchozím nastavení podporováno, pokud nenainstalujete rozšíření.

Nastavte, pokud vykreslování SVG není potřeba a chcete, aby si uživatelé stáhli soubor svg, aby si jej mohli prohlédnout.

Řešení problémů
Pokud vidíte prázdný čtverec místo SVG (Chrome) nebo žádný obrázek (Firefox) a všechny odkazy PNG vedou k chybě 404 a nikde nevidíte žádnou další chybovou zprávu, zkontrolujte proměnnou. Nastavením na může být transformace SVG vždy odložena. Ujistěte se, že jsou povoleny metody PHP proc_open a symlink (mohou být v php.ini zakázány z důvodu bezpečnosti nebo výkonu).



JPEG (použití GD)
Simply add the following line to LocalSettings.php, this will cause auto fall back to GD library.

For errors with JPEG thumbnails, see JPEG (using GD).

TIFF
Generating thumbnails of TIFF files requires MediaWiki 1.15.0 or newer.

Consider appropriate settings for  and
 * 1) Allow upload of TIFF files in the LocalSettings.php file:
 * 1) Add   to  and set to either jpg or png to specify which type of thumbnail you wish to have generated.
 * 1) Making thumbnails of TIFF files may require system resources beyond those needed for thumbnailing JPEG, GIF, or PNG files.

Deletion of images
Files, like wiki pages, can only be deleted by users with the " (delete)" permission ( by default). Deletion of files is done by deleting the associated description page (or by clicking the "" link in the "" table).

Deletion of individual revisions
If a file has been altered, there is a revision history of the files which is displayed on the file article page. Each revision has a "" link. If this is clicked, the revision and the file are deleted.

Information about old revisions of files are stored in the table while information on old revisions of the pages are stored in the  table.

Undeleting files
Files can be undeleted in exactly the same way as normal wiki pages. The directory in which deleted files are stored is defined by. Information about deleted images are stored in the table.

Deletion of Archived Files
Since MediaWiki version 1.11, deleted images are still stored on the server by default. If you want to delete selected archived images, you can do so using the maintenance script. If you want to delete all of them completely, you can do that with the script. If you delete archived files, you can not undelete those files anymore.

Reasons for Deleting a File
When choosing to delete a file, as described above, users will be asked to provide a reason for deletion. The available reasons can be edited on the MediaWiki:Filedelete-reason-dropdown of your wiki.

Data storage
Whenever an image is uploaded, several things are created:

This page is stored and can be edited like any other page. These are stored in the thumb directory of the image directory, in a separate directory for each main file.
 * 1) An article in the file namespace with the name of the file, e.g. File:MyPicture.png.
 * 1) The file itself is stored in a folder on the file system with whitespaces merged and replaced with.
 * 1) If necessary and thumbnailing is available, thumbnailed versions of the file will be created when necessary (such as for the usage on the file description page).

If is enabled (by default), MediaWiki creates several subdirectories in the images directory.

The directory names are from the first two characters of the md5 hash of the final filename.

Folders
All image files are stored in a folder determined by (, by default).

Description of named image subfolders:


 * archive
 * This is the storage place for files that have been replaced by newer versions.


 * temp
 * Used for temporary storage of files during image uploading. (Due to, these files may not always be automatically deleted).


 * thumb
 * Thumbnails (automatically generated) for the files. If these are deleted, they are automatically regenerated when needed.

Depending on the configuration, there may be additional image subfolders:


 * math
 * Folder to store your rendered TeX input, see also Extension:Math or Manual:Math.


 * x/xy
 * If is set to  (which is the default), images will be stored in subfolders of the images, thus making file paths look like  . See  for more details on why this might be desired and how this system works.

Database tables

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

Space usage
Files need considerably more space than articles. The following calculations assume a block size of 4KB with Linux/Unix servers.

The default setting is.

Space requirements for all directories:


 * 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).

For each file we need:


 * size of the original image file + 2 KB average overhead

For files that need to be thumbnailed:


 * size of the created thumbnail(s) + 2 KB average overhead (each)
 * directory for thumbnail (4KB) (each image has its own thumbnail directory)

Examples:


 * 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, 4 KB for the thumb directory, 64KB for the thumb: Total: 192 KB

File Access
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 (e.g. /c/c4/...) if 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.

Upload form
See the documentation on configuring the upload form.

Licensing
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. To make use of this feature a sysop needs to edit Licenses in the MediaWiki namespace (example: MediaWiki:Licenses). They can do this by going to the MediaWiki:Licenses page of their wiki and clicking 'create' or 'edit'.

The page MediaWiki: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 Wikipedia:MediaWiki:Licenses or Commons:MediaWiki:Licenses.

Foreign Repositories
It is possible to access files stored in foreign repositories, without needing to upload them to the wiki, by setting the 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 production sites.