mvsp - Online nel cloud

PROGRAMMA:

NOME

mvs - Un client Mediawiki a riga di comando

SINOSSI

mvs [Opzioni] comando [Opzioni] [nome file]

mvs -h|--aiuto
mvs --versione
mv -D

mkdir wiki
cd wikistuff

mvs login [-q|-v] [-T] [-d ] [-l codice_lingua ] [-u ] [-P ] [-w ]

aggiornamento mvs [-q|-v] [ ..]
mv su [[-q|-v] ..]

mvs commit [-q|-v] [-M] [-W] -m "messaggio di commit"
mvs com [-q|-v] [-M] [-W] -m "commit messaggio"
mvs preview [-q|-v] [-M] [-W] [-m "commit message"]

DESCRIZIONE

"mvs" è un client a riga di comando il cui scopo è semplificare la modifica offline di Wiki
contenuto. Ti consente di ottenere un numero qualsiasi di pagine da un determinato sito Mediawiki, modifica il
pagine con qualsiasi editor, ottenere e unire eventuali aggiornamenti simultanei delle pagine e quindi in modo sicuro
reimmettere le modifiche degli utenti alla versione della pagina sul server.

I comandi "mvs" che accettano un argomento del nome di file accettano solo un singolo nome di file in questo modo
evitare di occupare troppa larghezza di banda del server.

Nota:Gli utenti di "mvs" precedenti alla versione 0.27 noteranno che in questa documentazione il
le opzioni sono per lo più elencate dopo il sottocomando "mvs". Questo fa sì che "mvs" si comportino più come
"cvs", "svn" o "tla", e quindi dovrebbe rendere più facile per le persone che sono abituate a usare
quei programmi. Se preferisci usare "mvs" alla vecchia maniera, almeno funzionerà ancora
per le prossime versioni.

AVVIO RAPIDO

step 1: Creare an conto on , il MediaWiki server.
Questo dovrebbe essere fatto nel modo normale, visitando il sito Web Mediawiki a cui si desidera
contribuire e creare un nuovo account, impostare le preferenze, ecc.

Si spera che sia ovvio che vorrai familiarizzare con il
linee guida redazionali, d'uso e di copyright del sito. Probabilmente dovresti anche fare
alcuni contributi tramite la normale interfaccia utente e scopri come seguire le modifiche recenti prima
contribuendo utilizzando mvs.

Inoltre per il bene di questo test dovresti già avere una pagina utente come
Utente: con qualcosa sopra, dove è il nome utente con cui
stabilito il conto.

step 2: Creare a lavoro elenco
"mvs" funziona con file formattati Mediawiki con estensione ".wiki" e che sono memorizzati
insieme alle informazioni sul server in a lavoro elenco. Dovrai avere at meno
una directory di lavoro per ogni sito Mediawiki a cui contribuisci.

Usa semplicemente "mkdir" o l'equivalente per creare una nuova directory, quindi prima di cd in quella
directory.

mkdir wikitravel.it
cd wikitravel.it

Tutte le operazioni seguenti devono essere eseguite da questa directory.

step 3: Login utilizzando "mvs Accedere"
Per utilizzare il login è necessario conoscere il hostnome per il sito Mediawiki a cui si desidera
contribuire.

www.wikitravel.org

Adesso usa il host con il tuo nome utente e password per accedere.

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

Se "mvs" conosce il tuo host Mediawiki, imposterà "wiki_path" al corretto
predefinito per quel server. In questo caso sarà anche in grado di selezionare la versione in lingua
di quel Wiki per te se specifichi un "language_code":

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

Il codice deve corrispondere a quello che il tuo host wiki usa per una data lingua, e ovviamente
la versione della lingua deve esistere per l'host specificato.

Se la tua installazione di Mediawiki utilizza un percorso non standard per lo script wiki puoi specificarlo su
Accedere. Il percorso dello script wiki è la parte dell'URL dopo il nome host e prima
il '?':

accesso mvs
-dwww.wikitravel.org
-u
-p 'segreto'
-w 'mw/wiki.phtml'

È possibile modificare i percorsi di modifica e azione nel file .mediawiki creato dopo l'operazione
accedere di conseguenza.

Ora tutto ciò che invii al server Mediawiki verrà accreditato all'utente " ".

NOTA: Se hai usato una versione precedente di "mvs" dovresti probabilmente eliminare il
.mediawiki nella tua directory di lavoro.

step 4: Usa il "mvs aggiornare " a andare a prendere prima or Scopri di più lavoro file
Puoi recuperare materiale esistente dal sito o creare nuove pagine con "mvs update",
ricordando che i tuoi file avranno bisogno di un'estensione ".wiki":

Aggiorna mvs Utente: Utente .wiki: /Pagina_Test.wiki

Questo dovrebbe produrre l'output:

Utente: .wiki
Un utente: /Pagina_Test.wiki

La U (per Aggiornato) indica che l'Utente: è stato trovato sul server e sui suoi contenuti
inserito nei file locali. La A (per Added) significa che il
Utente: La pagina /Test_Page.wiki non esiste ancora sul server e verrà aggiunta
quando esegui "mvs commit".

Nota che entrambe le pagine con cui stiamo lavorando sono all'interno il tuo Spazio dei nomi utente. È
probabilmente una buona idea limitarti a lavorare con tali pagine mentre sei
sperimentando con "mvs"

step 5: Modifica , il file a make correzioni e contributi
Usa il tuo editor di testo preferito per modificare i file. Potresti voler dare un'occhiata a questa pagina per
controlla se esiste un file di evidenziazione della sintassi Mediawiki per il tuo editor:

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

Ovviamente se non trovi un file di evidenziazione per il tuo editor puoi crearlo
uno e invialo alla pagina sopra.

step 6: Usa il "mvs commettere" a inviare il tuo i cambiamenti
Quando hai finito di modificare un file e vuoi inviare le tue modifiche al server wiki
usa "mvs commit" per farlo:

mvs commit -m 'commit messaggio' Utente: .wiki

Dove "commit message" è tutto ciò che vuoi dire sulle modifiche che stai inviando
e perché. Devi fornire un messaggio di commit o "mvs commit" fallirà. potresti anche
trova che "mvs commit" fallisce lamentandosi del fatto che il file è cambiato sul server. Se questo
è il caso che dovrai utilizzare nuovamente "mvs update" per ottenere le modifiche più recenti.

step 7: Aggiornanento il tuo wiki file
Puoi utilizzare di nuovo "mvs update" in qualsiasi momento per riconciliare i tuoi file con il massimo
modifiche recenti dal server. Le tue modifiche andrete a non è un essere sovrascritto, ma piuttosto "mvs"
proverà a unire tutte le modifiche al server nei file così come esistono nel tuo lavoro
directory. Nota che l'aggiornamento e il commit funzionano solo su un file alla volta, in modo da aiutare
prevenire incidenti e congestione del server.

Se per qualche motivo c'è un conflitto, ad esempio tu e qualcun altro avete apportato modifiche che
sembrano incompatibili e non possono essere risolti, il tuo file conterrà a conflitto
messaggio, come dettagliato nella documentazione per "mvs update" di seguito. Voi devono obbligatoriamente: risolvere qualsiasi
conflitti prima tentativo di utilizzare "mvs commit" sul file. Questo di solito è molto
semplice questione di scegliere una versione del cambiamento o un'altra. Dovresti usare il tuo meglio
giudizio, consultando la relativa pagina "Discussione:" per cercare di elaborare un accordo con il
altro collaboratore nei casi in cui semplicemente non sei d'accordo.

Ripetere
Puoi continuare a modificare e confermare le modifiche con i file nella tua directory di lavoro.
Potrebbe essere una buona idea creare eventualmente più directory di lavoro per
sito, magari raggruppandoli per argomento. Funzionerà bene con "mvs" poiché lo fa non è un
bisogno di avere una copia completa di tutte le pagine di un dato server in un dato lavoro
directory per funzionare.

CARATTERE CODIFICA

Tutti i tuoi file ".wiki" dovrebbero essere archiviati con la codifica UTF-8. Dopo aver effettuato l'accesso a un dato
server mvs determinerà la codifica utilizzata da quel server e caricherà in quella
solo codifica. Per i server che utilizzano set di caratteri non UTF-8 dovresti usare entità HTML
per ogni carattere che vuoi rappresentare che è al di fuori del set di caratteri del server.
Questo include la Wikipedia in inglese. La maggior parte dei siti Mediawiki più recenti, tuttavia, utilizza UTF-8, su
questi siti sono entità HTML mai necessario.

ARGOMENTI

Comandi
Il primo argomento dopo le opzioni dovrebbe essere uno dei seguenti due comandi:

accesso mvs
Consente all'utente di accedere al server Mediawiki utilizzando un esistente login e password
per quel server. Dopo aver chiamato "login" tutti i "commit" dalla stessa directory di lavoro
verrà registrato come dall'utente che ha effettuato l'accesso.

aggiornamento mvs
Aggiorna i file specificati con il contenuto dal server Mediawiki. Se un file lo fa
non esiste viene creato e popolato con la versione online corrente. Se non c'è
versione online, il file è stato creato e lasciato vuoto o semplicemente lasciato così com'è. Se
c'è contenuto sia nel file specificato che nella corrispondente pagina Wiki, e
si tenta di unire i due, riga per riga. File che sono gli stessi del
versione del server vengono ignorati.

Se non vengono forniti nomi di file sulla riga di comando, tutti i file visibili con .wiki
estensione vengono elaborati.

Le modifiche in conflitto a una determinata riga vengono rilevate in base alla data del più
aggiornamento recente del file locale e data dell'ultima modifica al Wiki online
pagina. Se una riga è cambiata sia nella pagina online che nel file locale, viene contrassegnata
come un conflitto, come in CVS, ma con una sintassi leggermente diversa:

********************Inizio del conflitto 1 Inserisci in Primario, Inserisci in Secondario ****************** ****************************************

La linea come appare sul server

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

La linea come appare localmente
********************Fine del conflitto 1************************* ************************************************** ****

"mvs update" riporta lo stato dei file che tocca a STDERR con una lettera
indicando lo stato del file e quindi il nome del file, sempre come CVS. Lo stato
le lettere sono:

= (invariato)
Il file è lo stesso della pagina sul server.

A (Aggiunto)
Il file diventerà una nuova pagina sul server wiki.

M (Modificato)
Il file è stato modificato localmente.

U (aggiornato)
Il file è stato aggiornato con modifiche dal server wiki.

C (Conflitti)
Il file contiene indicatori di conflitto.

? (Sconosciuto)
Non esistono né il file né una pagina server corrispondente.

commettere
Conferma tutte le modifiche nel file locale specificato nel sito Wiki. Si fa un controllo
prima per assicurarsi che non ci siano modifiche sul server più recenti del più
aggiornamento recente. Non verrà eseguito alcun commit se la versione del file e quella del server sono identiche.

Quando esegui "mvs commit" tu devono obbligatoriamente: usa il flag "-m" per inviare un messaggio di commit al
Server MediaWiki. per esempio:

mvs commit -m 'Aggiunto Hotel Eldorado' Paris.wiki

anteprima
Questo comando funziona in modo identico a "mvs commit", tranne per il fatto che nulla è effettivamente
impegnato. Invece, il file viene caricato e il server Mediawiki invia indietro a
anteprima formattata. Il flag "-m" è facoltativo. Se imposti MVS_BROWSER
variabile ambientale al percorso e al nome del file del tuo browser preferito, mvs lo farà
avvialo con la pagina di anteprima.

cavedano
Questo comando rimuove qualsiasi file di riferimento della versione locale relativo alle pagine che hai
cancellato.

rmParis.wiki
mvs pulito

Compila il nomi
Eventuali argomenti aggiuntivi sono presi come locale nomi di file da elaborare. Il nome del file locale
di una determinata pagina Mediawiki sarà lo stesso del suo nome URL codificato con l'estensione
".wiki". Se non vengono forniti argomenti, qualsiasi nome di file con l'estensione "wiki" e sotto
la directory corrente viene elaborata.

VERSIONI

-h
Visualizza le informazioni sull'utilizzo.

-D
Stampa le informazioni sui server Mediawiki conosciuti, quindi esci.

-q
Fa sì che il comando sia silenzioso. I messaggi informativi vengono soppressi.

-u " "
Specifica un nome utente per "mvs login".

-p " "
Specifica una password per "mvs login".

-l " "
Il codice della lingua utilizzato dal server wiki per differenziare le versioni linguistiche.

-m " messaggio>"
Un messaggio di commit per "mvs commit". Usalo per spiegare la natura delle tue modifiche.

-s " messaggio>"
Uguale a "-m"

--minore
Scegli se contrassegnare la modifica come modifica minore. L'impostazione predefinita è contrassegnare le modifiche come minori se
il profilo utente Mediawiki è impostato per farlo per impostazione predefinita. Usalo quando commetti una modifica
con "mvs commit" o in anteprima con "mvs preview".

-M
Uguale a "--minore sì".

--guarda
Scegli se aggiungere la pagina modificata alla tua watchlist. Specificare "mantieni" manterrà
lo stato di osservazione corrente. L'impostazione predefinita è guardare la pagina se è già in corso
guardato, o se il profilo utente di Mediawiki è impostato per farlo per impostazione predefinita. Usalo quando
commit di una modifica con "mvs commit" o anteprima con "mvs preview".

-W
Uguale a "--guarda sì".

-w " percorso>"
Il percorso sul dato "host" allo script Mediawiki. Questa impostazione predefinita è wiki/wiki.phtml
che è corretto per un'installazione vanilla di Mediawiki 1.4.x.

-v
Verboso. Se questo è impostato "mvs" ti darà molte informazioni extra su cosa sia
facendo. Il flag -q lo sovrascrive.

AMBIENTALE VARIABILI

MVS_BROWSER
Il browser che preferisci utilizzare per visualizzare in anteprima le modifiche.

HTTP_PROXY
Un server proxy da utilizzare (se presente), espresso come URL standard, qualcosa del genere:

esporta HTTP_PROXY=http://[nome utente:password@]proxy.myorg.org:8080

AVVERTENZE

Questa è una prima versione di questo programma. Le versioni future potrebbero presentare grandi differenze
che influenzerà la tua capacità di usarli in modo intercambiabile con questo. In particolare
gli argomenti iniziali di "comando" possono diventare opzioni e la gestione dei conflitti potrebbe
cambiare drasticamente.

Usa mvsp online utilizzando i servizi onworks.net