mvsp - En ligne dans le Cloud

PROGRAMME:

Nom

mvs - Un client Mediawiki en ligne de commande

SYNOPSIS

commande mvs [Options] [Options] [nom de fichier]

mvs -h|--aide
mvs --version
mvs-D

wiki mkdir
cd wikitrucs

connexion mvs [-q|-v] [-T] [-d ] [-l code_langue ] [-u ] [-p ] [-w ]

mvs mise à jour [-q|-v] [ ..]
mvs up [[-q|-v] ..]

mvs commit [-q|-v] [-M] [-W] -m "commit message"
mvs com [-q|-v] [-M] [-W] -m "valider le message"
aperçu mvs [-q|-v] [-M] [-W] [-m "commit message"]

DESCRIPTION

"mvs" est un client en ligne de commande dont le but est de simplifier l'édition hors ligne de Wiki
teneur. Il vous permet d'obtenir n'importe quel nombre de pages d'un site Mediawiki donné, d'éditer le
pages avec n'importe quel éditeur, obtenez et fusionnez toutes les mises à jour simultanées des pages, puis en toute sécurité
valider les propres modifications de l'utilisateur dans la version de la page sur le serveur.

Les commandes "mvs" qui prennent un argument de nom de fichier n'acceptent qu'un seul nom de fichier afin de
évitez de prendre trop de bande passante du serveur.

Remarque :Les utilisateurs de "mvs" antérieurs à la version 0.27 remarqueront que dans cette documentation le
les options sont pour la plupart répertoriées après la sous-commande "mvs". Cela fait que "mvs" se comporte plus comme
"cvs", "svn" ou "tla", et devrait donc faciliter la tâche aux personnes habituées à utiliser
ces programmes. Si vous préférez utiliser "mvs" à l'ancienne, cela fonctionnera toujours, au moins
pour les prochaines versions.

PRISE EN MAIN RAPIDE

étape 1: Créez an Compte on le Médiawiki serveur.
Cela doit être fait de la manière habituelle, en visitant le site Web Mediawiki auquel vous souhaitez accéder
contribuer et créer un nouveau compte, définir les préférences, etc.

Il va sans dire que vous voudrez vous familiariser avec les
les directives éditoriales, d'utilisation et de droit d'auteur du site. Vous devriez probablement aussi faire
quelques contributions via l'interface utilisateur normale, et apprenez à suivre les changements récents avant
contribuer à l'aide de mvs.

De plus pour les besoins de ce test vous devriez déjà avoir une page utilisateur comme
Utilisateur: avec quelque chose dessus, où est le nom d'utilisateur avec lequel vous
établi le compte.

étape 2: Créez a de travail annuaire
"mvs" fonctionne avec les fichiers au format Mediawiki avec une extension ".wiki" et qui sont stockés
avec les informations du serveur dans un de travail annuaire. Vous devrez avoir at au
un répertoire de travail pour chaque site Mediawiki auquel vous contribuez.

Utilisez simplement "mkdir" ou l'équivalent pour créer un nouveau répertoire, puis avant cd dans celui-ci
répertoire.

mkdir wikitravel.fr
cd wikitravel.fr

Toutes les opérations ci-dessous doivent être effectuées à partir de ce répertoire.

étape 3: Se connecter en utilisant "mvs connexion"
Pour utiliser la connexion, vous devez connaître le hôtenom du site Mediawiki auquel vous souhaitez
contribuer.

www.wikitravel.org

Maintenant, utilisez le hôte avec votre nom d'utilisateur et votre mot de passe pour vous connecter.

mvs login -d www.wikitravel.org -u -p 'secret'

Si "mvs" connaît votre hôte Mediawiki, il définira le "wiki_path" sur le bon
par défaut pour ce serveur. Dans ce cas, il pourra également sélectionner la version linguistique
de ce Wiki pour vous si vous spécifiez un "language_code":

mvs login -d www.wikitravel.org -l fr -u -p 'secret'

Le code doit correspondre à celui que votre hébergeur wiki utilise pour une langue donnée, et bien sûr
la version linguistique doit exister pour l'hôte donné.

Si votre installation Mediawiki utilise un chemin non standard vers le script wiki, vous pouvez le spécifier sur
connexion. Le chemin d'accès au script wiki est la partie de l'URL après le nom d'hôte et avant
les '?':

connexion mvs \
-d www.wikitravel.org \
-u \
-p 'secret' \
-w 'mw/wiki.phtml'

Vous pouvez modifier les chemins d'édition et d'action dans le fichier .mediawiki créé après avoir réussi
connectez-vous en conséquence.

Désormais, tout ce que vous soumettez au serveur Mediawiki sera crédité à l'utilisateur " ".

NOTE: Si vous avez utilisé une version antérieure de "mvs", vous devriez probablement supprimer le
.mediawiki dans votre répertoire de travail.

étape 4: Utilisez "mvs mise à jour " à rapporter UN or plus de travail fichiers
Vous pouvez récupérer du matériel existant sur le site ou créer de nouvelles pages avec "mvs update",
rappelez-vous que vos fichiers auront besoin d'une extension ".wiki":

mvs update Utilisateur : Utilisateur .wiki : /Page_Test.wiki

Cela devrait produire la sortie :

U utilisateur : .wiki
Un utilisateur: /Page_Test.wiki

Le U (pour Mis à jour) signifie que l'Utilisateur : a été trouvé sur le serveur et son contenu
inséré dans les fichiers locaux. Le A (pour Ajouté) signifie que le
Utilisateur: La page /Test_Page.wiki n'existe pas encore sur le serveur et sera ajoutée
lorsque vous exécutez "mvs commit".

Notez que les deux pages avec lesquelles nous travaillons se trouvent dans votre Espace de nom d'utilisateur. C'est
probablement une bonne idée de vous limiter à travailler avec de telles pages pendant que vous êtes
expérimenter avec "mvs"

étape 5: Modifier le fichiers à a prendre une corrections et contributions
Utilisez votre éditeur de texte préféré pour éditer les fichiers. Vous voudrez peut-être consulter cette page pour
voyez s'il existe un fichier de coloration syntaxique Mediawiki pour votre éditeur :

http://en.wikipedia.org/wiki/Wikipedia:Syntaxe_surlignage

Bien sûr, si vous ne trouvez pas de fichier de surbrillance pour votre éditeur, vous pouvez le créer
un et soumettez-le à la page ci-dessus.

étape 6: Utilisez "mvs s'engager" à soumettre votre change
Lorsque vous avez terminé de modifier un fichier et que vous souhaitez soumettre vos modifications au serveur wiki
utilisez "mvs commit" pour le faire :

mvs commit -m 'commit message' Utilisateur : .wiki

Où « message de validation » est ce que vous voulez dire sur les modifications que vous soumettez
et pourquoi. Vous devez fournir un message de validation ou "mvs commit" échouera. Vous pourriez aussi
constatez que "mvs commit" échoue en se plaignant que le fichier a changé sur le serveur. Si ce
Dans ce cas, vous devrez à nouveau utiliser "mvs update" pour obtenir les modifications les plus récentes.

étape 7: Mises à jour votre wiki fichiers
Vous pouvez réutiliser "mvs update" à tout moment pour réconcilier n'importe lequel de vos fichiers avec le plus
changements récents du serveur. Vos modifications sera pas être écrasé, mais plutôt "mvs"
essaiera de fusionner toutes les modifications du serveur dans les fichiers tels qu'ils existent dans votre travail
annuaire. Notez que la mise à jour et la validation ne fonctionnent que sur un fichier à la fois, afin d'aider
prévenir les accidents et la congestion du serveur.

Si, pour une raison quelconque, il y a un conflit, c'est-à-dire que vous et quelqu'un d'autre avez apporté des modifications qui
semblent être incompatibles et ne peuvent pas être résolus, votre fichier contiendra un conflit
message, comme détaillé dans la documentation pour "mvs update" ci-dessous. Tu must résoudre tout
conflits avant essayer d'utiliser "mvs commit" sur le fichier. Il s'agit généralement d'un très
simple question de choisir une version du changement ou une autre. Tu devrais faire de ton mieux
jugement, en consultant la page « Parler : » appropriée pour essayer de trouver un accord avec le
autre contributeur dans les cas où vous n'êtes tout simplement pas d'accord.

Répéter
Vous pouvez continuer à éditer et à valider les modifications avec les fichiers de votre répertoire de travail.
Ce peut être une bonne idée pour vous de créer éventuellement plusieurs répertoires de travail par
site, en les regroupant peut-être par sujet. Cela fonctionnera bien avec "mvs" car c'est le cas pas
besoin d'avoir une copie complète de toutes les pages d'un serveur donné dans un fonctionnement donné
répertoire pour travailler.

PERSONNAGE CODAGE

Tous vos fichiers ".wiki" doivent être stockés avec un codage UTF-8. Lors de la connexion à un
le serveur mvs déterminera l'encodage utilisé par ce serveur et téléchargera dans ce
encodage uniquement. Pour les serveurs utilisant des jeux de caractères non UTF-8, vous devez utiliser des entités HTML
pour tout personnage que vous souhaitez représenter qui est en dehors du jeu de caractères du serveur.
Cela inclut la Wikipédia en anglais. Cependant, la plupart des nouveaux sites Mediawiki utilisent UTF-8, sur
ces entités HTML de sites sont jamais nécessaire.

ARGUMENTS

Commandes
Le premier argument après les options doit être l'une des deux commandes suivantes :

connexion mvs
Permet à l'utilisateur de se connecter au serveur Mediawiki à l'aide d'un existant login et mot de passe
pour ce serveur. Après avoir appelé "login" tous les "commit" du même répertoire de travail
sera connecté à partir de l'utilisateur connecté.

mise à jour mvs
Met à jour le(s) fichier(s) spécifié(s) avec le contenu du serveur Mediawiki. Si un fichier fait
n'existe pas, il est créé et rempli avec la version en ligne actuelle. Si il n'y a pas
version en ligne, le fichier soit créé et laissé vide, soit laissé tel quel. Si
il y a du contenu à la fois dans le fichier spécifié et dans la page Wiki correspondante, un
on essaie de fusionner les deux, ligne par ligne. Les fichiers qui sont les mêmes que le
version du serveur sont ignorés.

Si aucun nom de fichier n'est donné sur la ligne de commande, tous les fichiers visibles avec le .wiki
extension sont traités.

Les modifications conflictuelles sur une ligne donnée sont détectées sur la base de la date la plus
mise à jour récente du fichier local et date de la dernière modification apportée au Wiki en ligne
page. Si une ligne a changé à la fois dans la page en ligne et dans le fichier local, elle est signalée
comme un conflit, comme dans CVS, mais avec une syntaxe légèrement différente :

********************Début du conflit 1 Insertion vers primaire, Insertion vers secondaire ******************* ********************************************

La ligne telle qu'elle apparaît sur le serveur

************************************************** **************************************************

La ligne telle qu'elle apparaît localement
********************Fin du conflit 1****************************** ******************************************************** ****

"mvs update" rapporte l'état des fichiers qu'il touche à STDERR avec une lettre
indiquant l'état du fichier, puis le nom du fichier, encore une fois comme CVS. Le statut
les lettres sont :

= (Inchangé)
Le fichier est le même que la page sur le serveur.

A (Ajouté)
Le fichier deviendra une nouvelle page sur le serveur wiki.

M (Modifié)
Le fichier a été modifié localement.

U (mis à jour)
Le fichier a été mis à jour avec les modifications du serveur wiki.

C (Conflits)
Le fichier contient des marqueurs de conflit.

? (Inconnu)
Ni le fichier, ni la page serveur correspondante n'existent.

commettre
Valide toutes les modifications du fichier local spécifié sur le site Wiki. Un contrôle est fait
d'abord pour s'assurer qu'il n'y a pas de changement sur le serveur plus récent que le plus
mise à jour récente. Rien ne sera engagé si le fichier et la version du serveur sont identiques.

Lorsque vous exécutez "mvs commit", vous must utilisez le drapeau "-m" pour envoyer un message de validation au
Serveur Mediawiki. par exemple:

mvs commit -m 'Ajout de l'hôtel Eldorado' Paris.wiki

avant-première
Cette commande fonctionne de manière identique à "mvs commit", sauf que rien n'est en fait
engagé. Au lieu de cela, le fichier est téléchargé et le serveur Mediawiki renvoie un
aperçu formaté. L'indicateur "-m" est facultatif. Si vous définissez le MVS_BROWSER
variable d'environnement au chemin et au nom de fichier de votre navigateur préféré, mvs
lancez-le avec la page d'aperçu.

espace extérieur plus propre,
Cette commande supprime tous les fichiers de référence de version locale relatifs aux pages que vous avez
supprimée.

rm Paris.wiki
mvs propre

Déposez votre dernière attestation noms
Tout argument supplémentaire est considéré comme locales noms de fichiers à traiter. Le nom de fichier local
d'une page Mediawiki donnée sera le même que son nom encodé URL avec l'extension
".wiki". Si aucun argument n'est donné, alors tous les noms de fichiers avec l'extension "wiki" et sous
le répertoire courant sont traités.

OPTIONS

-h
Afficher les informations d'utilisation.

-D
Imprimez des informations sur les serveurs Mediawiki connus, puis quittez.

-q
Provoque le silence de la commande. Les messages d'information sont supprimés.

-u " "
Spécifie un nom d'utilisateur pour "mvs login".

-p " "
Spécifie un mot de passe pour "mvs login".

-l " "
Le code de langue que le serveur wiki utilise pour différencier les versions linguistiques.

-m " message>"
Un message de validation pour "mvs commit". Utilisez-le pour expliquer la nature de vos modifications.

-s " message>"
Identique à "-m"

--mineur
Choisissez si vous souhaitez marquer le changement comme une modification mineure. La valeur par défaut est de marquer les modifications comme mineures si
le profil utilisateur Mediawiki est configuré pour le faire par défaut. Utilisez ceci lors de la validation d'un changement
avec "mvs commit" ou prévisualisation avec "mvs preview".

-M
Identique à "--minor yes".

--Regardez
Choisissez d'ajouter ou non la page modifiée à votre liste de surveillance. Spécifier « conserver » conservera
l'état de surveillance actuel. La valeur par défaut est de regarder la page si elle est déjà en cours
regardé, ou si le profil utilisateur Mediawiki est configuré pour le faire par défaut. Utilisez ceci lorsque
valider un changement avec "mvs commit" ou prévisualiser avec "mvs preview".

-W
Identique à "--watch yes".

-w " chemin>"
Le chemin sur "l'hôte" donné vers le script Mediawiki. Cette valeur par défaut est wiki/wiki.phtml
ce qui est correct pour une installation vanille de Mediawiki 1.4.x.

-v
Verbeux. Si cela est défini, "mvs" vous donnera beaucoup d'informations supplémentaires sur ce que c'est
Faire. L'indicateur -q remplace cela.

ENVIRONNEMENT VARIABLES

MVS_BROWSER
Le navigateur que vous préférez utiliser pour prévisualiser les modifications.

HTTP PROXY
Un serveur proxy à utiliser (le cas échéant), exprimé sous la forme d'une URL standard, quelque chose comme ceci :

exporter HTTP_PROXY=http://[username:password@]proxy.myorg.org:8080

MISES EN GARDE

Ceci est une première version de ce programme. Les futures versions peuvent avoir des différences majeures
ce qui affectera votre capacité à les utiliser de manière interchangeable avec celui-ci. En particulier
les arguments de "commande" initiaux peuvent devenir des options et la gestion des conflits peut
changer radicalement.

Utiliser mvsp en ligne à l'aide des services onworks.net