Help:Import/ca: Difference between revisions

Revision as of 16:00, 4 June 2024

Latest revision as of 23:18, 22 July 2024

Line 1:

{{MovedToMediaWiki|Help:Import}}[[Category:Handbook orphan translations]]

<languages />

{{H:h|editor toc}}

[[File:Meta-Wiki Importer Icon.svg|180px|right|Icona de l'importador de Meta-Wiki]]

<div lang="en" dir="ltr" class="mw-content-ltr">

There are two types of '''import''', both accessed through [[Special:Import]]:

*'''transwiki import''', also called '''interwiki import''': import pages directly from another wiki; the settings of the destination wiki determine which source wikis are enabled; {{msg|import-interwiki-text}} appears; after "Transfer pages into namespace" one can specify a target namespace; the option "all" actually means "the same as the original".

*'''upload import''': import a file in a special [[w:XML|XML]] format produced by [[:mw:Help:export|export]]ing pages from another wiki; {{msg|importtext}} appears;

</div>

Vegeu la pàgina [[Importador]] per a més informació sobre els grups d'usuari que fan aquestes accions.

<span id="Transwiki_import"></span>

== Importació transwiki ==

En moltes wikis de Wikimedia la importació transwiki està desactivada també, hi apareix {{msg|importnosources}}: "{{MediaWiki:importnosources}}" Tanmateix, actualment es poden importar pàgines de [[commons:]], [[foundation:]], [[w:]], [[cs:]] i [[fr:]] a Meta, i les pàgines de Meta es poden importar a [[mw:]]. L'acció d'importar s'afig a l'historial de pàgina i a [[Special:Log/import]].

<div lang="en" dir="ltr" class="mw-content-ltr">

If an imported page has the same name as an existing page in the target wiki, the page is overwritten if the imported page is newer (according to the timestamps). If an error occurred during the import then you may find the import is partially complete (some pages imported, but not all). Since pages are overwritten, attempting the import again should not be a problem.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

If you specified to include history information, then you should also see information about the edits in the 'history' of the imported pages, and in the user contributions. The edits will not show up in 'recent changes' (neither positioned at the time of the original edit, nor at the time of importing). The effect will be similar to a full history merge and it may be quite difficult to later determine which edits were imported.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

There is an option "Include all templates", which will import the templates that are on an imported page. If this is not used they will be redlinked unless a template of the same name exists on the target wiki. If this is used, templates of the same name on the target wiki will be overwritten and the import will include not only the templates on the imported page but also any templates used within those templates. It is possible to import a collection of pages by specially creating a page that transcludes them, and importing that page, with the option on. However, this should be done very carefully or it may result in far more being imported than desired - again, it will import all templates on the transcluded pages and all templates nested within those templates.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

Useful applications of importing include:

*when a page is moved to another wiki and subsequently edited there, have the history together in the target wiki; this is especially useful if the source page becomes more difficult to find due to page moves etc.

*when a page is moved to another wiki and deleted on the source wiki, preserve the history.

*in order to have templates that exist on another wiki/subdomain.

*on certain projects such as wikisource and wiktionary, to move multilingual content between language subdomains.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

===Implementation===

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

To check whether your wiki has the transwiki right configured, and, where it is configured, to which wikis, you can query your wiki using the api.

</div>

* ''<wiki url>''/w/api.php?action=paraminfo&modules=import

** eg. https://meta.wikimedia.org/w/api.php?action=paraminfo&modules=import

<div lang="en" dir="ltr" class="mw-content-ltr">

The configuration is expressed in <code><param name="interwikisource" description="For interwiki imports: wiki to import from"> &hellip;</code>

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

Alternatively one can check the global configurations at http://noc.wikimedia.org/conf/highlight.php?file=InitialiseSettings.php and look in the section <code>wgImportSources</code>.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

If there is no transwiki configured, then seek your local community's consensus to have the transwiki configured, and to identify from which wikis you may wish to import. Requests for configuration changes should be lodged in [[:Phabricator:]]. You would be expected to link to your community's discussion in your bug request.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

A query of the API at your local wiki would also display the usergroup rights, check for the <code><add></code> tag

</div>

* ''<wiki url>''/w/api.php?action=query&meta=siteinfo&siprop=usergroups

** https://meta.wikimedia.org/w/api.php?action=query&meta=siteinfo&siprop=usergroups

<span id="Assignation_of_transwiki_import_rights"></span>

===Assignació de permisos d'importació transwiki===

<div lang="en" dir="ltr" class="mw-content-ltr">

Most transwiki rights are assigned to users following a successful discussion in their community's wiki, followed up by a request to stewards at [[Steward requests/Permission]]. Some wikis have requested and been granted that local bureaucrats be able to assign this right, check with your wiki for the current situation there.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

==Upload import==

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

How to export, and the format of exported pages, is described at [[:mw:Help:Export]]. Normally any user can export wiki pages to a file, but to import pages into a wiki from a file, you must have 'Sysop' privileges on that wiki. So if you have your own MediaWiki installation, then you should be able to see the 'Special:Import' page there. Within the Wikimedia Foundation family of wiki projects, only users with the <tt>importupload</tt> user-right can import pages into a wiki from a file; this includes only members of the "[[importer]]" group and stewards.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

To import wiki pages from your computer, simply click browse to locate the file on your local file system.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

=== Editing the import file ===

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

In the case of upload import, because of the simple readable file format the XML file can easily be edited between exporting and importing. This should be done with caution and integrity, one can make antedated edits and use false user names, and in combination with deletion, one can "[[w:en:historical revisionism|change history]]". Applications of this editing include:

*adding a note to the edit summary about the importing

*changing user names and/or page names to avoid name conflicts (just between the title tags and between the username tags or also in links and signatures)

*changing namespace names into the generic or the applicable ones (ditto)

Note that if two versions of the page have the same timestamp (because one was uploaded with the same timestamp as a preexisting version), the later (imported) version will show up in the edit history but not in the article itself.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

See [[:mw:Manual:XML Import file manipulation in CSharp]] for an example of working with these XML files in Visual Studio .NET C#.

</div>

<span id="Merging histories and other complications"></span>

<div lang="en" dir="ltr" class="mw-content-ltr">

== Merging histories and other complications ==

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

''See also [[mw:Manual:Importing_XML_dumps#Troubleshooting]].''

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

If the import includes history information, and the edits involved a user name which in the importing project is used by somebody else, then upload import should be applied, and the occurrences of the user name in the XML file should first be replaced by another name, to avoid ambiguity. If the user name was not used yet in the importing project then the user contributions are available anyway, although an account is not automatically created.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

Just like when a page is referred to in a link, and/or put in a URL, generic namespace names are automatically converted, and if a prefix is not a namespace name the page will arrive in the main namespace. However, e.g. "Meta:" may be ignored (dropped) on a project that uses that prefix for interwiki linking. It may be desirable to change it in the XML file to "Project:" before importing.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

If a page name exists already, importing revisions of a page with that name causes the page histories to be merged. Note that after inserting a revision between two existing revisions in the page history, the change made by the user who made the next edit seems different from what it actually has been: to see the actual change made by the user one has to take the diff between the two already existing revisions, not the diff with respect to the inserted one. Therefore this should not be done except to reconstruct the true page history.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

A revision is not imported if a revision of the same page, date, and time (up to the exact second) exists already. In practice this occurs only when the revision has already been imported (either to the current wiki, or previously to the wiki from which the export was made, or both were imported from a third site).

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

An edit summary may refer to, and possibly link to, another page. This may be confusing when the page has been imported but the target page has not.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

The edit summary does not automatically show that the page has been imported, but in the case of upload import that can be added to the edit summaries in the XML file before importing. That can avoid some potential sources of ambiguity and/or confusion. When editing the XML file with find/replace, note that adding a text to the edit summaries requires distinguishing between edits which already have an edit summary, hence comment tags in the XML file, and those without these tags. If there are multiple pairs of comment tags, only the last one is effective.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

==User contributions==

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

Without provisions for user name conflicts, the user contributions list shows:

*the edits by the person registered under the user name concerned on the project

*for each wiki from which pages have been imported, the edits of imported pages before import, by the user who on the source project has the user name concerned

If at the time of import the page did not exist yet on the target site, the two can be distinguished by comparing the time of import with the time of the edit.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

If the user page and user talk page do not have a user contributions link in the page margin then the user is not registered, so all their edits are imported.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

== Large-scale transfer ==

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

For a large-scale transfer, somebody with sufficient system privileges can move data within the server, which is more practical than sending large XML files from the server to a user's local computer and then back to the server.

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

Large files may be rejected for two reasons. The PHP upload limit, found in PHP configuration file php.ini:

</div>

<pre>

; Maximum allowed size for uploaded files.

upload_max_filesize = 20M

</pre>

<div lang="en" dir="ltr" class="mw-content-ltr">

And also the hidden variable limiting the size in the input form. Found in the mediawiki source code

</div>, ''includes/specials/SpecialImport.php'':

<pre> <input type='hidden' name='MAX_FILE_SIZE' value='20000000' /> </pre>

<div lang="en" dir="ltr" class="mw-content-ltr">

Maybe you should change the following four directives in php.ini:

</div>

; Maximum size of POST data that PHP will accept.

post_max_size = 20M

max_execution_time = 1000 ; Maximum execution time of each script, in seconds

max_input_time = 2000 ; Maximum amount of time each script may spend parsing request data

; Default timeout for socket based streams (seconds)

default_socket_timeout = 2000

<div lang="en" dir="ltr" class="mw-content-ltr">

==See also==

</div>

<div lang="en" dir="ltr" class="mw-content-ltr">

* [[data dumps]] describes the maintenance script <tt>maintenance/importDump.php</tt> which provides an alternate import mechanism, but hasn't always remained in working order with recent MediaWiki releases

* [[Importer]]

</div>

[[Category:Editor handbook{{#translation:}}]]