Warning, /documentation/digikam-doc/export_tools/media_wiki.rst is written in an unsupported language. File is not indexed.

 .. meta::
    :description: digiKam Export to MediaWiki Web-Service
    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, mediawiki, export
 
 .. metadata-placeholder
 
    :authors: - digiKam Team
 
    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
 
 .. _media_wiki:
 
 Export To MediaWiki
 ===================
 
 .. contents::
 
 Sharing is caring, and there is probably no better way to share your photographic masterpieces with the world than adding them to a `MediaWiki <https://en.wikipedia.org/wiki/MediaWiki>`_ pool. While the project’s website features its own tool for uploading photos, digiKam’s MediaWiki Export tool can come in rather handy when you need to export multiple photos in one fell swoop without leaving the convenience of your favorite photo management application.
 
 MediaWiki are the base of `Media Repositories <https://en.wikipedia.org/wiki/Digital_library>`_ available on the Internet where free-to-use images can be uploaded. The goal of these digital libraries is to share contents used across all of the Wikimedia projects as the famous **Wikipedia** encyclopedia for example.
 
 To upload a selection of images from your collections to a remote MediaWiki server using the Internet, use the :menuselection:`Export --> Export to MediaWiki` menu entry, or the corresponding icon from the **Tools** tab in Right Sidebar. 
 
 .. figure:: images/export_media_wiki.webp
     :alt:
     :align: center
 
     The MediaWiki Export Dialog
 
 The **Items Properties** tab of the right side allows to customize MediaWiki metadata of each items present from the upload list. Select one item on the left side to see the properties populated by digiKam, and adjust values if necessary. When all is ready, switch to the **Upload Settings** tab to be connected to the remote server and transfer files.
 
 .. figure:: images/export_media_wiki_login.webp
     :alt:
     :align: center
 
     The MediaWiki Export Account Settings
 
 First, you needs to be connected to the server with an **Account**. From this view, you can select the MediaWiki service to use with the **Login** and **Password** properties. By default, the tool propose a list of popular MediaWiki servers available on the Internet, as:
 
     - `Wikimedia Commons <https://commons.wikimedia.org/>`_
     - `Wikimedia Meta <https://meta.wikimedia.org/>`_
     - `Wikipedia <https://en.wikipedia.org/>`_
     - `Wikibooks <https://en.wikibooks.org/>`_
     - `Wikinews <https://en.wikinews.org/>`_
     - `Wikiquote <https://en.wikiquote.org/>`_
     - `Wikisource <https://en.wikisource.org/>`_
     - `Wiktionary <https://en.wiktionary.org/>`_
     - `MediaWiki Organization <https://www.MediaWiki.org/>`_
     - `Wikia Foto <https://foto.wikia.com/>`_
     - `Wikia Uncyclopedia <https://en.uncyclopedia.co/>`_
 
 With the **+ NEW** button, you can append on the list a new MediaWiki based server from Internet or on your local network. The tool will shown a widget to customize the **Name** and the **API Url**. Just press on **+ Add** button to confirm values.
 
 .. figure:: images/export_media_wiki_new.webp
     :alt:
     :align: center
 
     The MediaWiki Export View to create a New Server Settings
 
 When you are connected to the remote Web service with the **Log in** button, the **Account** view must become like this:
 
 .. figure:: images/export_media_wiki_account.webp
     :alt:
     :align: center
 
     The MediaWiki Export Connected to an Account from Wikimedia Commons Web Service
 
 While transferring the files, you can customize some **Information** used by the MediaWiki server to identify the uploading operation. The fields available are listed below:
 
     - **Author**: the author name of the contents as text.
     - **Source**: the original source of the contents as text.
     - **License**: the license of the contents. Use one entry from the list provided by the tool.
     - **Generic categories**: The categories that will be added to the contents as text.
     - **Generic text**: The text that will be added to the contents below the Information template.
     - **Upload comments**: The text that will be used as upload comments. The value *Uploaded via digiKam uploader* will be used if empty.
 
 .. figure:: images/export_media_wiki_info.webp
     :alt:
     :align: center
 
     The MediaWiki Export Information Settings
 
 During uploading the files, you can also apply some operations listed in **Options** view. If the **Resize photos before uploading** option is selected, the photos will be resized before transferring to MediaWiki. The values will be read from the **Maximum Size** and **JPEG quality** settings, which can be used to adjust the compression and maximum height. The width calculation will be done so as to have the aspect ratio conserved. You can also drop **metadata** and GPS **coordinates** information from the files.
 
 .. figure:: images/export_media_wiki_options.webp
     :alt:
     :align: center
 
     The MediaWiki Export Options Settings
 
 
 Press **Start Upload** button to transfer items. You can click on the **Close** button to abort the uploading of photos.
 
 .. figure:: images/export_media_wiki_progress.webp
     :alt:
     :align: center
 
     The MediaWiki Export Uploading Contents to the Web Service
 
 Finally, you can view the uploaded photos by visiting the MediaWiki website.
 
 .. figure:: images/export_media_wiki_stream.webp
     :alt:
     :align: center
 
     The Wikimedia Commons Online Account Displaying the Uploaded Contents