Manuel:importTextFiles.php
| MediaWiki file: importTextFiles.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.42.3 • 1.41.4 • 1.39.10 |
| Classes: | ImportTextFiles |
Détails
Le fichier importTextFiles.php est un script de maintenance qui importe des fichiers textuels vers des pages du wiki en préservant (sur option) l'horodatage des fichiers. Le nom du fichier (sans l'extension) est utilisé comme titre de page, précédé d'un préfixe donné (sur option).
 Avertissement : | ce script de maintenance ne fonctionne pas sur MediaWiki 1.35.0 . Si vous utilisez MediaWiki 1.35.0, mettez à jours vers MediaWiki 1.35.1 ou supérieur. |
Utilisation
php importTextFiles.php [options...] <file> [<file>...]
Options
| Option/paramètre | Description |
|---|---|
| -u <utilisateur> | Nom d'utilisateur auquel doivent être attribuées les modifications. Si l'utilisateur spécifié n'existe pas, il sera créé. Si aucun nom d'utilisateur n'a été fourni, la modification sera attribuée à l'utilisateur "Maintenance script", qui sera également créé si nécessaire. |
| -s <résumé> | Résumé des modifications Si le sommaire n'est pas fourni, "Importé depuis un fichier texte" sera utilisé. |
| --rc | Affiche les modifications parmi les modifications récentes. Par défaut cette option n'est pas déclarée et les modifications ne sont pas affichées parmi les modifications récentes. |
| --bot | Dans les modifications récentes, marque les modifications comme des "modifications de robot" (uniquement significatif si --rc est également passé). Par défaut, cette option n'est pas définie. |
| --prefix <préfixe> | Les noms de page seront par défaut les noms des fichiers sans l'extension du fichier. Si un préfixe est défini ici, les pages seront préfixées avec ce préfixe. Donc le préfixe est une chaîne à placer devant le nom du fichier lors de la création du nom de page. |
| --use-timestamp | Utiliser la date de modification du fichier texte comme horodatage de la modification. Par défaut, --use-timestamp n'est pas déclaré; dans ce cas on utilise l'horodatage courant au moment de l'importation du fichier textuel. |
| --overwrite | Réécraser les pages existantes. Par défaut, il vaut false de sorte à sauter les pages existantes. Si --use-timestamp est également passé, --overwrite ne réécrasera les pages que si le fichier a été modifié depuis la dernière modification de la page - en d'autres termes si, selon l'horodatage de leur modification, le fichier est plus récent que la page.
|
Exemples
php importTextFiles.php -s "Updating weather observations" --prefix "Template:Latest meteo/" --overwrite --use-timestamp meteo-*.txt
Cette commande importe les fichiers dont le nom vérifie l'expression meteo-*.txt dans le répertoire actuel vers des pages qui commencent par Template:Latest meteo/.
Par exemple, meteo-Sydney.txt sera importé dans la page Template:Latest meteo/meteo-Sydney.
L'horodatage de la modification du fichier sera utilisé comme horodatage de la révision.
Les pages existantes seront écrasées.
Régressions
importTextFiles.php ne fonctionne pas avec MediaWiki 1.35.0 . Utiliser MediaWiki 1.35.1 ou supérieur.