mvsp - Online în cloud

PROGRAM:

NUME

mvs - Un client Mediawiki în linie de comandă

REZUMAT

mvs [Opțiuni] comanda [Opțiuni] [nume fișier]

mvs -h|--ajutor
mvs --version
mvs -D

mkdir wikistuff
cd wikistuff

mvs login [-q|-v] [-T] [-d ] [-l cod_limbă ] [-u ] [-p ] [-w ]

actualizare mvs [-q|-v] [ ..]
mvs sus [[-q|-v] ..]

mvs commit [-q|-v] [-M] [-W] -m "commit mesaj"
mvs com [-q|-v] [-M] [-W] -m „comite mesaj”
previzualizare mvs [-q|-v] [-M] [-W] [-m „commit message”]

DESCRIERE

„mvs” este un client de linie de comandă al cărui scop este de a simplifica editarea offline a Wiki
conţinut. Vă permite să obțineți orice număr de pagini de pe un anumit site Mediawiki, editați
pagini cu orice editor, obțineți și îmbinați toate actualizările simultane ale paginilor și apoi în siguranță
comite modificările proprii ale utilizatorilor înapoi la versiunea paginii de pe server.

Comenzile „mvs” care iau un argument nume de fișier acceptă doar un singur nume de fișier, astfel
evitați să ocupați prea multă lățime de bandă a serverului.

Notă:Utilizatorii „mvs” dinainte de versiunea 0.27 vor observa că în această documentație
opțiunile sunt listate în mare parte după sub-comanda „mvs”. Acest lucru face ca „mvs” să se comporte mai mult ca
„cvs”, „svn” sau „tla” și, prin urmare, ar trebui să facă mai ușor pentru persoanele care sunt obișnuite să folosească
acele programe. Dacă preferați să utilizați „mvs” în modul vechi, cel puțin asta va funcționa
pentru următoarele versiuni.

PORNIRE RAPIDĂ

Pas 1: Crează an cont on il Mediawiki Server.
Acest lucru ar trebui să se facă în mod normal, vizitând site-ul Mediawiki la care doriți
contribuie și creează un cont nou, seteză preferințe etc.

Ar trebui, sperăm, de la sine înțeles că veți dori să vă familiarizați cu
ghidurile editoriale, de utilizare și de copyright ale site-ului. Probabil ar trebui să faci și tu
unele contribuții prin interfața de utilizare obișnuită și aflați despre cum urmează modificările recente înainte
contribuind folosind mvs.

În plus, de dragul acestui test, ar trebui să aveți deja o pagină de utilizator like
Utilizator: cu ceva pe el, unde este numele de utilizator cu care dvs
a stabilit contul.

Pas 2: Crează a de lucru director
„mvs” funcționează cu fișiere formatate Mediawiki cu extensia „.wiki” și care sunt stocate
împreună cu informațiile serverului într-un de lucru director. Va trebui să ai at cel mai puțin
un director de lucru pentru fiecare site Mediawiki la care contribuiți.

Pur și simplu utilizați „mkdir” sau echivalentul pentru a crea un director nou, apoi înainte de cd în acesta
director.

mkdir wikitravel.en
cd wikitravel.en

Toate operațiunile de mai jos ar trebui făcute din acest director.

Pas 3: Intră în cont folosind „mvs Autentificare"
Pentru a utiliza autentificare, va trebui să cunoașteți gazdănumele pentru site-ul Mediawiki la care doriți
a contribui.

www.wikitravel.org

Acum folosiți gazdă cu numele de utilizator și parola pentru a vă autentifica.

mvs login -d www.wikitravel.org -u -p „secret”

Dacă „mvs” știe despre gazda dvs. Mediawiki, va seta „wiki_path” la corect
implicit pentru acel server. În acest caz, va putea selecta și versiunea lingvistică
a acelui Wiki pentru tine dacă specificați un „cod_limbă”:

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

Codul trebuie să se potrivească cu cel pe care gazda dumneavoastră wiki îl folosește pentru o anumită limbă și, desigur
versiunea lingvistică trebuie să existe pentru gazda dată.

Dacă instalarea dvs. Mediawiki folosește o cale nestandard către scriptul wiki, puteți să o specificați
Autentificare. Calea către scriptul wiki este partea URL după numele gazdei și înainte
'?':

autentificare mvs \
-d www.wikitravel.org \
-u \
-p „secret” \
-w „mw/wiki.phtml”

Puteți modifica căile de editare și de acțiune în fișierul .mediawiki creat după succes
conectați-vă în consecință.

Acum, orice trimiteți la serverul Mediawiki va fi creditat utilizatorului " ".

NOTĂ: Dacă ați folosit o versiune anterioară de „mvs”, probabil ar trebui să ștergeți
.mediawiki în directorul dvs. de lucru.

Pas 4: Utilizare „mvs Actualizați" la aduc unu or mai mult de lucru fișiere
Puteți prelua material existent de pe site sau puteți crea pagini noi cu „mvs update”
amintindu-ne că fișierele dvs. vor avea nevoie de o extensie „.wiki”:

Actualizare mvs Utilizator: Utilizator .wiki: /Test_Page.wiki

Aceasta ar trebui să producă rezultatul:

U User: .wiki
Un utilizator: /Test_Page.wiki

U (pentru Actualizat) înseamnă că Utilizatorul: a fost găsit pe server și pe conținutul acestuia
introduse în fișierele locale. A (pentru Added) înseamnă că
Utilizator: Pagina /Test_Page.wiki nu există încă pe server și va fi adăugată
când rulați „mvs commit”.

Rețineți că ambele pagini cu care lucrăm se află în interior ta Spațiu de nume de utilizator. este
probabil este o idee bună să vă limitați la lucrul cu astfel de pagini cât timp sunteți
experimentează cu „mvs”

Pas 5: Editati il fișiere la face corecții și contribuţii
Utilizați editorul de text preferat pentru a edita fișierele. Poate doriți să verificați această pagină pentru
vezi dacă există un fișier de evidențiere a sintaxei Mediawiki pentru editorul tău:

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

Desigur, dacă nu găsiți un fișier de evidențiere pentru editorul dvs., sunteți binevenit să îl creați
unul și trimiteți-l pe pagina de mai sus.

Pas 6: Utilizare „mvs se angajeaza" la prezenta ta schimbari
Când ați terminat de editat un fișier și doriți să trimiteți modificările pe serverul wiki
utilizați „mvs commit” pentru a face acest lucru:

mvs commit -m „mesaj de comitere” Utilizator: .wiki

Unde „commit message” este orice vrei să spui despre modificările pe care le trimiți
și de ce. Trebuie să furnizați un mesaj de confirmare sau „mvs commit” va eșua. S-ar putea, de asemenea
găsiți că „mvs commit” nu reușește, plângând că fișierul s-a schimbat pe server. Dacă aceasta
în acest caz, va trebui să utilizați din nou „mvs update” pentru a obține cele mai recente modificări.

Pas 7: Actualizează ta Wiki fișiere
Puteți utiliza „mvs update” din nou în orice moment pentru a reconcilia oricare dintre fișierele dvs. cu cele mai multe
modificări recente de la server. Schimbările tale voi nu fi suprascris, ci mai degrabă „mvs”
va încerca să îmbine orice modificări ale serverului în fișierele așa cum există în lucrul dvs
director. Rețineți că actualizarea și comiterea funcționează doar pe un fișier la un moment dat, pentru a ajuta
preveni accidentele și congestionarea serverelor.

Dacă dintr-un motiv oarecare există un conflict, adică tu și altcineva ați făcut modificări care
par a fi incompatibil și nu poate fi rezolvat, atunci fișierul dvs. va conține a conflict
mesaj, după cum este detaliat în documentația pentru „mvs update” de mai jos. Tu trebuie să: rezolva orice
conflicte înainte încercând să utilizați „mvs commit” în fișier. Acesta este de obicei foarte
simpla chestiune de a alege o versiune a modificării sau alta. Ar trebui să folosești tot ce poți
judecată, consultând pagina relevantă „Discuție:” pentru a încerca să încheie un acord cu
alt colaborator în cazurile în care pur și simplu nu sunteți de acord.

Repeta
Puteți continua editarea și efectuarea modificărilor cu fișierele din directorul de lucru.
Ar putea fi o idee bună să creați în cele din urmă mai multe directoare de lucru per
site-ul, poate grupându-le după subiect. Acest lucru va funcționa bine cu „mvs”, deoarece funcționează nu
trebuie să aveți o copie completă a tuturor paginilor de pe un anumit server într-o anumită funcționare
director pentru a lucra.

CARACTER CODIFICARE

Toate fișierele dvs. „.wiki” ar trebui să fie stocate cu codificare UTF-8. La autentificare la un anumit
server mvs va determina codificarea folosită de acel server și va încărca în acel server
numai codificare. Pentru serverele care utilizează seturi de caractere non-UTF-8, ar trebui să utilizați entități HTML
pentru orice caracter pe care doriți să îl reprezentați și care se află în afara setului de caractere al serverului.
Aceasta include Wikipedia în engleză. Cu toate acestea, majoritatea site-urilor Mediawiki mai noi folosesc UTF-8, activat
aceste site-uri sunt entități HTML nu Necesar.

ARGUMENTE

Comenzi
Primul argument după opțiuni ar trebui să fie una dintre următoarele două comenzi:

autentificare mvs
Permite utilizatorului să se conecteze la serverul Mediawiki folosind un existent autentificare și parolă
pentru acel server. După apelarea „login”, toate „commit-urile” din același director de lucru
va fi autentificat ca de la utilizatorul conectat.

actualizare mvs
Actualizează fișierele specificate cu conținut de pe serverul Mediawiki. Dacă un fișier o face
nu există, este creat și populat cu versiunea online curentă. Dacă nu există
versiunea online, fișierul fie creat și lăsat necompletat, fie lăsat așa cum este. Dacă
există conținut atât în ​​fișierul specificat, cât și în pagina Wiki corespunzătoare, an
se încearcă îmbinarea celor două rând cu rând. Fișierele care sunt la fel ca
versiunea serverului sunt ignorate.

Dacă nu sunt date nume de fișiere pe linia de comandă, toate fișierele vizibile cu .wiki
extensia sunt procesate.

Modificările conflictuale la o anumită linie sunt detectate pe baza datei celei mai multe
actualizare recentă a fișierului local și data celei mai recente modificări la Wiki online
pagină. Dacă o linie s-a schimbat atât în ​​pagina online, cât și în fișierul local, este semnalată
ca un conflict, ca în CVS, dar cu o sintaxă puțin diferită:

********************Începutul conflictului 1 Inserare la primar, Inserare la secundar ******************* ****************************************

Linia așa cum apare pe server

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

Linia așa cum apare local
******************** Sfârșitul conflictului 1**************************** **************************************************** ****

„mvs update” raportează starea fișierelor pe care le atinge către STDERR cu o scrisoare
indicând starea fișierului și apoi numele fișierului, din nou ca CVS. Statusul
literele sunt:

= (Neschimbat)
Fișierul este același cu pagina de pe server.

A (Adăugat)
Fișierul va deveni o pagină nouă pe serverul wiki.

M (modificat)
Fișierul a fost modificat local.

U (Actualizat)
Fișierul a fost actualizat cu modificări de la serverul wiki.

C (conflicte)
Fișierul conține marcatori de conflict.

? (Necunoscut)
Nici fișierul, nici o pagină de server corespunzătoare nu există.

comite
Commite orice modificări ale fișierului local specificat pe site-ul Wiki. Se face o verificare
mai întâi pentru a vă asigura că nu există modificări pe server mai recente decât cele mai multe
actualizare recenta. Nimic nu va fi comis dacă fișierul și versiunea serverului sunt identice.

Când rulezi „mvs commit” tu trebuie să: utilizați indicatorul „-m” pentru a trimite un mesaj de confirmare către
Serverul Mediawiki. de exemplu:

mvs commit -m „Adăugat Hotel Eldorado” Paris.wiki

avanpremieră
Această comandă funcționează identic cu „mvs commit”, cu excepția faptului că nimic nu este de fapt
comis. În schimb, fișierul este încărcat și serverul Mediawiki trimite înapoi a
previzualizare formatată. Indicatorul „-m” este opțional. Dacă setați MVS_BROWSER
variabilă de mediu la calea și numele fișierului browserului dvs. preferat, mvs va
lansează-l cu pagina de previzualizare.

curat
Această comandă elimină toate fișierele de referință ale versiunii locale referitoare la paginile pe care le aveți
eliminat.

rm Paris.wiki
mvs curat

Fișier nume
Orice argumente suplimentare sunt luate ca local nume de fișiere care urmează să fie procesate. Numele fișierului local
a unei anumite pagini Mediawiki va fi același cu numele său codificat URL cu extensia
„.wiki”. Dacă nu sunt date argumente, atunci orice nume de fișier cu extensia „wiki” și mai mică
directorul curent sunt procesate.

OPŢIUNI

-h
Afișează informații de utilizare.

-D
Imprimați informații despre serverele Mediawiki cunoscute, apoi ieșiți.

-q
Face ca comanda să fie silențioasă. Mesajele informative sunt suprimate.

-u " "
Specifică un nume de utilizator pentru „mvs login”.

-p " "
Specifică o parolă pentru „mvs login”.

-l " "
Codul de limbă pe care serverul wiki îl folosește pentru a face diferența între versiunile de limbă.

-m " mesaj>"
Un mesaj de confirmare pentru „mvs commit”. Folosiți-l pentru a explica natura modificărilor dvs.

-s " mesaj>"
La fel ca „-m”

--minor
Alegeți dacă doriți să marcați modificarea ca o modificare minoră. Implicit este de a marca modificările ca minore dacă
profilul de utilizator Mediawiki este setat să facă acest lucru în mod implicit. Utilizați acest lucru atunci când efectuați o schimbare
cu „mvs commit” sau previzualizarea cu „mvs preview”.

-M
La fel ca „--minor da”.

--ceas
Alegeți dacă doriți să adăugați pagina editată la lista dvs. de urmărire. Specificarea „păstrare” se va menține
starea curentă vizionată. Opțiunea implicită este să vizionați pagina dacă aceasta este deja
vizionat sau dacă profilul de utilizator Mediawiki este setat să facă acest lucru în mod implicit. Folosește asta când
comiterea unei modificări cu „mvs commit” sau previzualizarea cu „mvs preview”.

-W
La fel ca „--watch da”.

-w " cale>"
Calea pe „gazdă” dată către scriptul Mediawiki. Aceasta este implicită wiki/wiki.phtml
care este corect pentru o instalare vanilla a Mediawiki 1.4.x.

-v
Verbos. Dacă este setat, „mvs” vă va oferi o mulțime de informații suplimentare despre ce este
face. Indicatorul -q suprascrie acest lucru.

DE MEDIU VARIABILE

MVS_BROWSER
Browserul pe care preferați să îl utilizați pentru previzualizarea modificărilor.

HTTP PROXY
Un server proxy de utilizat (dacă există), exprimat ca o adresă URL standard, ceva de genul acesta:

export HTTP_PROXY=http://[nume utilizator:parolă@]proxy.myorg.org:8080

Avertismente

Aceasta este o versiune timpurie a acestui program. Versiunile viitoare pot avea diferențe majore
ceea ce vă va afecta capacitatea de a le folosi interschimbabil cu acesta. În special
argumentele inițiale de „comandă” pot deveni opțiuni și gestionarea conflictelor ar putea
schimba dramatic.

Utilizați mvsp online folosind serviciile onworks.net