mvsp - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

mvs - Một ứng dụng khách Mediawiki dòng lệnh

SYNOPSIS

lệnh mvs [Tùy chọn] [Tùy chọn] [tên tệp]

mvs -h | --help
mvs --version
mvs -D

mkdir wiki
cd wiki

đăng nhập mvs [-q | -v] [-T] [-d ] [-l language_code] [-u ] [-P ] [-w ]

cập nhật mvs [-q | -v] [ ..]
mvs up [[-q | -v] ..]

mvs cam kết [-q | -v] [-M] [-W] -m "thông báo cam kết"
mvs com [-q | -v] [-M] [-W] -m "cam kết thông báo"
mvs xem trước [-q | -v] [-M] [-W] [-m "cam kết thông báo"]

MÔ TẢ

"mvs" là một ứng dụng khách dòng lệnh có mục đích là đơn giản hóa việc chỉnh sửa ngoại tuyến của Wiki
Nội dung. Nó cho phép bạn lấy bất kỳ số lượng trang nào từ một trang Mediawiki nhất định, chỉnh sửa
các trang với bất kỳ trình chỉnh sửa nào, nhận và hợp nhất mọi cập nhật đồng thời của các trang, sau đó một cách an toàn
cam kết các thay đổi của chính người dùng trở lại phiên bản của trang trên máy chủ.

Các lệnh "mvs" có đối số tên tệp chỉ chấp nhận một tên tệp duy nhất để
tránh chiếm quá nhiều băng thông của máy chủ.

Lưu ý:Người dùng "mvs" từ trước phiên bản 0.27 sẽ nhận thấy rằng trong tài liệu này,
hầu hết các tùy chọn được liệt kê sau lệnh phụ "mvs". Điều này làm cho "mv" cư xử giống như
"cvs", "svn" hoặc "tla" và do đó sẽ giúp những người đã quen sử dụng dễ dàng hơn
các chương trình đó. Nếu bạn thích sử dụng "mvs" theo cách cũ, cách đó vẫn sẽ hoạt động, ít nhất là
cho một vài phiên bản tiếp theo.

BẮT ĐẦU NHANH

Bước 1: Tạo an Tài khoản on các phương tiện wiki máy chủ.
Điều này nên được thực hiện theo cách bình thường, bằng cách truy cập trang web Mediawiki mà bạn muốn
đóng góp và tạo tài khoản mới, thiết lập các tùy chọn, v.v.

Hy vọng rằng nó sẽ đi mà không nói rằng bạn sẽ muốn làm quen với
biên tập, sử dụng và nguyên tắc bản quyền của trang web. Bạn có lẽ cũng nên làm
một số đóng góp thông qua giao diện người dùng thông thường và tìm hiểu về cách làm theo những thay đổi gần đây trước đây
đóng góp bằng cách sử dụng mvs.

Ngoài ra, vì lợi ích của thử nghiệm này, bạn nên có một trang người dùng như
Người sử dụng: với một cái gì đó trên đó, ở đâu là tên người dùng mà bạn sử dụng
thành lập tài khoản.

Bước 2: Tạo a đang làm việc thư mục
"mvs" hoạt động với các tệp được định dạng Mediawiki có phần mở rộng ".wiki" và được lưu trữ
cùng với thông tin máy chủ trong một đang làm việc thư mục. Bạn sẽ phải có at ít nhất
một thư mục làm việc cho mỗi trang Mediawiki mà bạn đóng góp.

Đơn giản chỉ cần sử dụng "mkdir" hoặc tương đương để tạo một thư mục mới, sau đó đặt trước cd vào đó
thư mục.

mkdir wikitravel.en
cd wikitravel.vi

Tất cả các hoạt động dưới đây phải được thực hiện từ thư mục này.

Bước 3: Đăng nhập sử dụng "mv đăng nhập"
Để sử dụng đăng nhập, bạn sẽ cần biết chủ nhàtên cho trang Mediawiki mà bạn muốn
đóng góp.

www.wikitravel.org

Bây giờ hãy sử dụng chủ nhà với tên người dùng và mật khẩu của bạn để đăng nhập.

đăng nhập mvs -d www.wikitravel.org -u -p 'bí mật'

Nếu "mvs" biết về máy chủ Mediawiki của bạn, nó sẽ đặt "wiki_path" thành đúng
mặc định cho máy chủ đó. Trong trường hợp này, nó cũng có thể chọn phiên bản ngôn ngữ
của Wiki đó cho bạn nếu bạn chỉ định "language_code":

đăng nhập mvs -d www.wikitravel.org -l fr -u -p 'bí mật'

Mã phải khớp với mã mà máy chủ wiki của bạn sử dụng cho một ngôn ngữ nhất định, và tất nhiên
phiên bản ngôn ngữ phải tồn tại cho máy chủ nhất định.

Nếu cài đặt Mediawiki của bạn sử dụng một đường dẫn không chuẩn đến tập lệnh wiki, bạn có thể chỉ định nó trên
đăng nhập. Đường dẫn đến tập lệnh wiki là một phần của URL sau tên máy chủ và trước
NS '?':

đăng nhập mvs \
-d www.wikitravel.org \
-u \
-p 'bí mật' \
-w 'mw / wiki.phtml'

Bạn có thể thay đổi đường dẫn chỉnh sửa và hành động trong tệp .mediawiki đã tạo sau khi thành công
đăng nhập phù hợp.

Giờ đây, bất cứ thứ gì bạn gửi đến máy chủ Mediawiki sẽ được ghi có cho người dùng " ".

LƯU Ý: Nếu bạn đang sử dụng phiên bản "mvs" cũ hơn, bạn có thể nên xóa
.mediawiki tệp trong thư mục làm việc của bạn.

Bước 4: Sử dụng "mv cập nhật " đến lấy một or chi tiết đang làm việc các tập tin
Bạn có thể tìm nạp tài liệu hiện có từ trang web hoặc tạo các trang mới với "cập nhật mvs",
nhớ rằng các tệp của bạn sẽ cần phần mở rộng ".wiki":

cập nhật mvs Người dùng: Người dùng .wiki: /Test_Page.wiki

Điều này sẽ tạo ra đầu ra:

Người dùng U: .wiki
Một người dùng: /Test_Page.wiki

Chữ U (cho Đã cập nhật) có nghĩa là Người dùng: đã được tìm thấy trên máy chủ và nội dung của nó
được chèn vào các tệp cục bộ. A (để Thêm) có nghĩa là
Người sử dụng: Trang /Test_Page.wiki chưa tồn tại trên máy chủ và sẽ được thêm vào
khi bạn chạy "mvs commit".

Lưu ý rằng cả hai trang chúng tôi đang làm việc đều nằm trong qua một vài thao tác đơn giản về Không gian tên người dùng. nó là
có lẽ là một ý tưởng hay để hạn chế bản thân làm việc với những trang như vậy khi bạn đang
thử nghiệm với "mvs"

Bước 5: Chỉnh sửa các các tập tin đến làm cho đính chính và đóng góp
Sử dụng trình soạn thảo văn bản yêu thích của bạn để chỉnh sửa các tệp. Bạn có thể muốn xem trang này để
xem có tệp đánh dấu cú pháp Mediawiki cho trình chỉnh sửa của bạn không:

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

Tất nhiên nếu bạn không tìm thấy tệp đánh dấu cho bạn trình chỉnh sửa, bạn có thể tạo
một và gửi nó đến trang trên.

Bước 6: Sử dụng "mv làm" đến trình qua một vài thao tác đơn giản về thay đổi
Khi bạn hoàn tất việc chỉnh sửa tệp và muốn gửi các thay đổi của mình đến máy chủ wiki
sử dụng "mvs commit" để làm như vậy:

mvs commit -m 'cam kết thông báo' Người dùng: .wiki

Trong đó 'thông điệp cam kết' là bất cứ điều gì bạn muốn nói về những thay đổi bạn đang gửi
và tại sao. Bạn phải cung cấp thông báo cam kết nếu không "mvs cam kết" sẽ không thành công. Bạn cũng có thể
thấy rằng "mvs commit" không thành công khi khiếu nại rằng tệp đã thay đổi trên máy chủ. Nếu điều này
là trường hợp bạn sẽ cần sử dụng lại "mvs update" để nhận các thay đổi gần đây nhất.

Bước 7: Cập nhật qua một vài thao tác đơn giản về wiki các tập tin
Bạn có thể sử dụng lại "mvs update" bất kỳ lúc nào để điều chỉnh mọi tệp của mình sao cho phù hợp nhất
những thay đổi gần đây từ máy chủ. Những thay đổi của bạn sẽ không bị ghi đè, mà là "mvs"
sẽ cố gắng hợp nhất bất kỳ thay đổi máy chủ nào vào các tệp khi chúng tồn tại trong quá trình làm việc của bạn
danh mục. Lưu ý rằng cập nhật và cam kết chỉ hoạt động trên một tệp tại một thời điểm, vì vậy sẽ giúp
ngăn ngừa sự cố và tắc nghẽn máy chủ.

Nếu vì lý do nào đó xảy ra xung đột, tức là bạn và người khác đã thực hiện các thay đổi
có vẻ như không tương thích và không thể được giải quyết thì tệp của bạn sẽ chứa xung đột
tin nhắn, như được trình bày chi tiết trong tài liệu về "cập nhật mvs" bên dưới. Bạn phải giải quyết bất kỳ
xung đột trước đang cố gắng sử dụng "mvs commit" trên tệp. Đây thường là một
vấn đề đơn giản là chọn một phiên bản thay đổi này hay một phiên bản khác. Bạn nên sử dụng hết sức mình
đánh giá, tham khảo trang "Talk:" có liên quan để cố gắng tìm ra thỏa thuận với
cộng tác viên khác trong trường hợp bạn chỉ đơn giản là không đồng ý.

Lặp lại
Bạn có thể tiếp tục chỉnh sửa và thực hiện các thay đổi với các tệp trong thư mục làm việc của mình.
Có thể là một ý kiến ​​hay cho bạn khi cuối cùng tạo nhiều thư mục hoạt động cho mỗi
trang web, có thể nhóm chúng theo chủ đề. Điều này sẽ hoạt động tốt với "mvs" vì nó không
cần có một bản sao hoàn chỉnh của tất cả các trang từ một máy chủ nhất định trong một hoạt động nhất định
thư mục để làm việc.

TÍNH CÁCH THƯỞNG THỨC

Tất cả các tệp ".wiki" của bạn phải được lưu trữ bằng mã hóa UTF-8. Khi đăng nhập vào một
mv máy chủ sẽ xác định mã hóa được sử dụng bởi máy chủ đó và sẽ tải lên trong đó
chỉ mã hóa. Đối với các máy chủ sử dụng bộ ký tự không phải UTF-8, bạn nên sử dụng các thực thể HTML
cho bất kỳ ký tự nào bạn muốn đại diện nằm ngoài bộ ký tự của máy chủ.
Điều này bao gồm Wikipedia tiếng Anh. Tuy nhiên, hầu hết các trang Mediawiki mới hơn đều sử dụng UTF-8, trên
các trang web này các thực thể HTML là không bao giờ cần thiết.

TRANH LUẬN

Lệnh
Đối số đầu tiên sau các tùy chọn phải là một trong hai lệnh sau:

đăng nhập mvs
Cho phép người dùng đăng nhập vào máy chủ Mediawiki bằng hiện tại đăng nhập và mật khẩu
cho máy chủ đó. Sau khi gọi "đăng nhập", tất cả "cam kết" từ cùng một thư mục làm việc
sẽ được đăng nhập từ người dùng đã đăng nhập.

cập nhật mvs
Cập nhật [các] tệp được chỉ định với nội dung từ máy chủ Mediawiki. Nếu một tập tin không
không tồn tại, nó được tạo và phổ biến với phiên bản trực tuyến hiện tại. Nếu không có
phiên bản trực tuyến, tệp hoặc được tạo và để trống, hoặc chỉ để nguyên. Nếu như
có nội dung trong cả tệp được chỉ định và trong trang Wiki tương ứng,
cố gắng hợp nhất hai, từng dòng một. Các tệp giống như tệp
phiên bản máy chủ bị bỏ qua.

Nếu không có tên tệp nào được cung cấp trên dòng lệnh, tất cả các tệp hiển thị với .wiki
phần mở rộng được xử lý.

Các thay đổi xung đột đối với một dòng nhất định được phát hiện dựa trên ngày của hầu hết
cập nhật gần đây của tệp cục bộ và ngày thay đổi gần đây nhất đối với Wiki trực tuyến
trang. Nếu một dòng đã thay đổi trong cả trang trực tuyến và tệp cục bộ, dòng đó sẽ được gắn cờ
như một xung đột, như trong CVS, nhưng với cú pháp hơi khác:

******************** Bắt đầu xung đột 1 Chèn vào chính, Chèn vào phụ ******************* *****************************************

Dòng khi nó xuất hiện trên máy chủ

****** / TÌM KIẾM ****** / TÌM KIẾM

Dòng khi nó xuất hiện cục bộ
******************** Kết thúc xung đột 1 ************************** ************************************************** ****

"mvs update" báo cáo trạng thái của các tệp mà nó chạm vào STDERR bằng một chữ cái
cho biết trạng thái tệp, và sau đó là tên của tệp, một lần nữa giống như CVS. Tình trạng
các chữ cái là:

= (Không thay đổi)
Tệp giống như trang trên máy chủ.

A (Đã thêm)
Tệp sẽ trở thành một trang mới trên máy chủ wiki.

M (Đã sửa đổi)
Tệp đã được sửa đổi cục bộ.

U (Đã cập nhật)
Tệp đã được cập nhật với những thay đổi từ máy chủ wiki.

C (Xung đột)
Tệp chứa các điểm đánh dấu xung đột.

? (Không xác định)
Cả tệp hoặc trang máy chủ tương ứng đều không tồn tại.

cam kết
Cam kết bất kỳ thay đổi nào trong tệp cục bộ được chỉ định cho trang Wiki. Một séc được thực hiện
trước tiên để đảm bảo rằng không có thay đổi nào trên máy chủ gần đây hơn là
cập nhật gần đây. Sẽ không có gì được bắt đầu nếu tệp và phiên bản máy chủ giống hệt nhau.

Khi chạy "mvs commit" bạn phải sử dụng cờ "-m" để gửi thông báo cam kết đến
Máy chủ Mediawiki. ví dụ:

mvs commit -m 'Đã thêm Khách sạn Eldorado' Paris.wiki

xem trước
Lệnh này hoạt động giống hệt như "mvs commit", ngoại trừ việc không có gì thực sự là
tận tụy. Thay vào đó, tệp được tải lên và máy chủ Mediawiki gửi lại
bản xem trước có định dạng. Cờ "-m" là tùy chọn. Nếu bạn đặt MVS_BROWSER
biến môi trường thành đường dẫn và tên tệp của trình duyệt yêu thích của bạn, mvs sẽ
khởi chạy nó với trang xem trước.

giống cá lăng
Lệnh này xóa mọi tệp tham chiếu phiên bản cục bộ liên quan đến các trang mà bạn
đã xóa.

rm Paris.wiki
mv sạch

Tập tin tên
Bất kỳ đối số bổ sung nào được coi là địa phương tên tệp sẽ được xử lý. Tên tệp cục bộ
của một trang Mediawiki nhất định sẽ giống với tên được mã hóa URL của nó với phần mở rộng
".wiki". Nếu không có đối số nào được đưa ra thì bất kỳ tên tệp nào có phần mở rộng "wiki" trở xuống
thư mục hiện tại được xử lý.

LỰA CHỌN

-h
Hiển thị thông tin sử dụng.

-D
In thông tin về các máy chủ Mediawiki đã biết, sau đó thoát.

-q
Khiến lệnh im lặng. Thông báo cung cấp thông tin bị chặn.

-u " "
Chỉ định tên người dùng cho "đăng nhập mvs".

-p " "
Chỉ định mật khẩu cho "đăng nhập mvs".

-l " "
Mã ngôn ngữ mà máy chủ wiki sử dụng để phân biệt giữa các phiên bản ngôn ngữ.

-m " tin nhắn> "
Một thông báo cam kết cho "mvs cam kết". Sử dụng điều này để giải thích bản chất của các thay đổi của bạn.

-s " tin nhắn> "
Giống như "-m"

--người vị thành niên
Chọn có đánh dấu thay đổi là một chỉnh sửa nhỏ hay không. Mặc định là đánh dấu các thay đổi là nhỏ nếu
hồ sơ người dùng Mediawiki được đặt làm như vậy theo mặc định. Sử dụng điều này khi thực hiện một thay đổi
với "mvs commit" hoặc xem trước với "mvs preview".

-M
Tương tự như "--minor yes".

--đồng hồ
Chọn có thêm trang đã chỉnh sửa vào danh sách theo dõi của bạn hay không. Chỉ định "giữ" sẽ duy trì
trạng thái đã xem hiện tại. Mặc định là xem trang nếu nó đã được
đã xem, hoặc nếu hồ sơ người dùng Mediawiki được đặt làm như vậy theo mặc định. Sử dụng cái này khi
cam kết thay đổi với "mvs commit" hoặc xem trước bằng "mvs preview".

-W
Tương tự như "--watch yes".

-w " đường dẫn> "
Đường dẫn trên "máy chủ" đã cho tới tập lệnh Mediawiki. Điều này mặc định là wiki / wiki.phtml
điều này đúng cho bản cài đặt vani của Mediawiki 1.4.x.

-v
Dài dòng. Nếu điều này được đặt "mvs" sẽ cung cấp cho bạn nhiều thông tin bổ sung về những gì nó
đang làm. Cờ -q sẽ ghi đè điều này.

MÔI TRƯỜNG BIẾN

MVS_BROWSER
Trình duyệt bạn muốn sử dụng để xem trước các thay đổi.

HTTP PROXY
Máy chủ proxy để sử dụng (nếu có), được biểu thị dưới dạng URL chuẩn, giống như sau:

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

THẬN TRỌNG

Đây là phiên bản đầu tiên của chương trình này. Các phiên bản trong tương lai có thể có những điểm khác biệt lớn
điều này sẽ ảnh hưởng đến khả năng của bạn để sử dụng chúng thay thế cho nhau với cái này. Đặc biệt
các đối số "lệnh" ban đầu có thể trở thành các tùy chọn và việc xử lý các xung đột có thể
thay đổi đáng kể.

Sử dụng mvsp trực tuyến bằng các dịch vụ onworks.net