Hướng dẫn ban đầu

  • Revision slug: Project:en/Project:Getting_started
  • Revision title: Hướng dẫn ban đầu
  • Revision id: 340585
  • Created:
  • Creator: tuan_bk
  • Is current revision?
  • Comment

Revision Content

{{ MDCProjectPagesTOC() }}

Mạng nhà phát triển Mozilla (Mozzilla Developer Network) hiện đang có nhiều các công việc khác nhau phù hợp cho mọi người ở bất kỳ trình độ nào. Có một dãy các nhiệm vụ đang càn phải làm, từ việc đơn giản (đọc và sửa lỗi chính tả)  tới các công việc phức tạp (viết tài liệu API).

MDN có giao diện web đơn giản cho phép bất kỳ ai sử dụng. Hãy giúp chúng tôi! Sự thành công của MDN được gây dựng trên tinh thần hợp tác bởi cộng đồng Mozilians.

  • Nội dung quan trọng hơn cách trình bày, ngữ pháp, chính tả. Nếu tiếng anh của bạn không tốt, không cần quá lo lắng về nó!. Nếu bạn mắc lỗi đánh máy - đừng lo lắng về nó! Nếu bạn không nhớ các shướng dẫn trình bày - đừng lo lắng về điều đó! Lỗi đều có thể sửa được. và thay đổi có thể diễn ra nhanh chóng phục hồi.
  • Hỏi những người bạn mới của bạn trong cộng đồng MDN để được giúp và chat. Cộng đồng (cả các nhân viên được trả lương và nhân viên tình nguyện) đều rât thân thiện. Chúng tôi yêu(LOVE!) các thành viên tham gia đóng góp mới! Nếu bạn không nhận được phản hồi nhanh từ email hoặc kênh IRC, nhớ rằng có nhiều người ở trong các múi giờ khác nhau đang làm việc trên các dự án khác nhau. Hãy tự do hỏi nhiều hơn một và / hoặc hỏi nhiều hơn một người. Bạn không bao giwof bị bỏ mặc. Liên hệ Eric Shepherd,  MDN chieftan, nếu bạn không nhận được sự trợ giúp cần thiết. Không có gì quan trọng hơn với chúng tôi bằng việc giúp đỡ các tình nguyện viên.
  • Bất kỳ ai có thể thay đổi bất cứ điều gì. Không ai sẽ buồn nếu bạn thay đổi nội dung của họ, và bạn cũng không nên phiền nếu ai đó thay đổi phần của bạn (mặc dù vậy bạn nên tự do đặt các câu hỏi về sự thay đổi). Sự thay đổi không bị lên án - chúng (hầu hết tất cả) đem lại sự cải thiện
  • Chúng tôi có đường dẫn cho khu vực topic đặc trưng. Nếu bạn đang làm việc trên một khu vực đặc biệt, học có thể giúp bạn.

Hướng dẫn nhanh

Đăng nhập

MDN sử dụng Persona  để xác minh tài khoản. Tạo một tài khoản Persona và đăng nhập vào MDN.

Thực hành

Thực hành kỹ năng viết wiki của bạn trong Sandbox, và khu vực của wiki mà nó có ý nghĩa cho việc học tập và thử nghiệm.

Sửa một trang

  1. Chọn "Edit" ở đầu mỗi trang
  2. Thực hiện thay đổi. Chọn  "PREVIEW CHANGES" để xem thay đổi.
  3. Chọn "SAVE AND KEEP EDITING" để lưu lại sự thay đổi mà không cần đóng lại giao diện sửa đổi. Chọn "SAVE CHANGES" để lưu trang và đóng lại trang đã sửa. Chọn "DISCARD CHANGES" để quay trở lại trang ban đầu.

Bạn sẽ không thể  lưu sự thay đổi và gặp thông báo "Permission Denied"  nếu trình duyệt của bạn được cấu hình để không gửi thông tin referrer. Nếu bạn không thể lưu thay đổi, chắc chắn rằng {{pref("network.http.sendRefererHeader")}} tùy chọn được đặt giá trị mặc định(hiện tại là  "2").

Tạo một trang mới

Nếu bạn không biết nơi nào để tạo một bài báo mới, đừng lo lắng về điều đó! Đặt nó vào một nơi nào đó, và chúng ta sẽ tìm thấy nó và chuyển đến nơi nó cần, hoặc hợp với nội dung hiện tại mà nó phù hợp nhất. Chúng tôi có vài trợ giúp nhỏ mà sẽ giúp bạn tạo ra nội dung trong sáng và ngọt ngào.

Liên kết từ một trang đã tồn tại

  1. Đặt tên của trang mới ở trong trang.
  2. Bôi đen tên và click vào Link icon ()trong toolbar. Hộp thoại "Update Link" xuất hiện, với nội dung đã được chọn xuất hiện trong "Link To" .
  3. "/en-US/docs/" sẽ được chèn vào mặc định ở đầu url. Đặt tên của  trang sau "/en-US/docs/". (Tên trang không phải có cùng tên với link text.)
  4. Click OKđể chèn link.

Nếu trang không tồn tại, link sẽ chuyển màu đỏ. Nếu trang tồn tại, link sẽ chuyển màu sanh. Nếu bạn muốn tạo một trang mới nhưng tiêu đề trang bạn muốn đã tồn tại, kiểm tra trước tiênnếu nó cho phép sửa. Nếu không, nghĩ tiêu đề khác cho nội dung của bạn và tjo link. Xem hướng dẫn đặt tên để hiểu rõ.

Để thêm nội dung vào trang mới, chọn vào các link màu đỏ bạn vừa tạo và bắt đầu viết. Click "SAVE AND KEEP EDITING" để lưu lại thay đổi mà không đóng lại trang chỉnh sửa. Click "SAVE CHANGES" khi bạn đã hoàn tất.

Để tạo một trang mới không có link liên kết tới trang khác, đặt một tên duy nhất cho URL. Ví dụ :

https://developer.mozilla.org/en-US/docs/FooBar

... MDN sẽ tạo một trang mới tên "FooBar" và  mở trình soạn thảo để bạn sửa nội dung trang mới.

Đánh dấu Wiki

Kuma, phần mềm được phát triển bởi Mozilla được MDN sử dụng, nó dùng HTML để đánh dấu ngôn ngữ cho tài liệu. Nếu bạn muốn thấy và sửa nội dung, bạn có thể chọn vào "Source" trong khi ở chế độ edit. Click lần nữa để trở về trình soạn thảo WYSIWYG.

Ghi chép lỗi tài liệu

Bạn có thể báo các lỗi phức tạp bằng cách điền vào mẫu. Sử dụng các trường giá trị sau:

product
Mozilla Developer Network
component
Tài liệu yêu cầu
URL
Trang mà bạn thấy lỗi
Description
Miêu tả về lỗi.

Di chuyển các tài liệu cũ

Các dự án cong mà không được tiếp tục phát triển sẽ được chuyển từ mozilla.org tới các trang trên MDN wiki. Thủ tục cực kỳ đơn giản:

  1. Chọn một tài liệu mà bạn muốn chuyển đi từ danh sách existing content .
  2. Xemhướng dẫn đặt tên trang và quyết định các trang nào nên được gọi bởi wiki.
  3. Tạo những trang này và di chuyển nội dung, đánh dấu phù hợp cho nó sử dụng hướng dẫn đánh dấu wiki.
  4. Xóa nội dung từ danh sách nội dung tồn tại.
  5. Thêm các item để chuyển hướng  nếu cần.
  6. Nếu bạn tiếp tục làm  công việc này một cách toàn diện, bạn cũng nên:
  1. Sử dụng hệ thống tìm kiếm của chúng tôi để tìm bất kỳ link nào từ trang ban đầu của wiki, và sau đó thay đổi những link này tại một trang mới.
  2. Kiểm tra chuyển hướng tới tài liệu gốc, và đánh dấu tag "Junk".

Việt hóa MDN

Nếu bạn hứng thú với việc giúp đỡ chúng tôi dịch các tài liệu của bất kỳ trang Wiki nào sang ngôn ngữ khác, đơn giản xác định ngôn ngữ của trang và tạo trang mới. Xem dự án Địa phương hóa để biết thêm thông tin về dự án hiện tại và cách bắt đầu một dự án mới.

Phân xử "bút chiến" hoặc xung đột khác

Nếu vì lý do nào đó bạn kết thúc với "bút chiến" trên một trang, nơi mà hai hoặc nhiều người hơn đang tiếp tục phục hồi lại, hãy cố gắng phân sử xung đột này với người liên quan trước.

Nếu không có giải pháp phù hợp, hãy mang vấn đề đó tới  MDN mailing list hoặc nhóm developer documentation lead. Các chuyên gia kỹ thuật, nhà văn sẽ tư vấn nếu cần thiết, và kinh nghiệm của họ sẽ được dùng dể giải quyết vấn đề này.

Yêu cầu xóa trang

Nếu bạn tạo một trang vô ý mà muốn xóa nó, thêm tag "junk" vào nó.

Các Items được tag Junk được kiểm tra định kỳ bởi admin wiki và các trang sẽ được xem xét để xóa nếu được chấp nhận.

Chú ý: Không xóa nội dung khác  loại từ các trang mà được tag là "junk".Hu

Revision Source

<p>{{ MDCProjectPagesTOC() }}</p>
<p>Mạng nhà phát triển Mozilla (Mozzilla Developer Network) hiện đang có nhiều các công việc khác nhau phù hợp cho mọi người ở bất kỳ trình độ nào. Có một dãy các nhiệm vụ đang càn phải làm, từ việc đơn giản (đọc và sửa lỗi chính tả)&nbsp; tới các công việc phức tạp (viết tài liệu API).</p>
<p>MDN có giao diện web đơn giản cho phép bất kỳ ai sử dụng. <strong>Hãy giúp chúng tôi! </strong>Sự thành công của MDN được gây dựng trên tinh thần hợp tác bởi <a href="/en-US/docs/Project:Community" title="/en-US/docs/Project:Community">cộng đồng Mozilians</a>.</p>
<ul>
  <li><strong>Nội dung quan trọng hơn cách trình bày, ngữ pháp, chính tả. </strong>Nếu tiếng anh của bạn không tốt, không cần quá lo lắng về nó!. Nếu bạn mắc lỗi đánh máy - đừng lo lắng về nó! Nếu bạn không nhớ các <a href="/en-US/docs/Project:MDC_style_guide" title="/en-US/docs/Project:MDC_style_guide">shướng dẫn trình bày</a> - đừng lo lắng về điều đó! Lỗi đều có thể sửa được. và thay đổi có thể diễn ra nhanh chóng phục hồi.</li>
  <li><strong>Hỏi những người bạn mới của bạn trong cộng đồng MDN để được giúp và chat</strong>. <a href="/en-US/docs/Project:Community" title="/en-US/docs/Project:Community">Cộng đồng</a> (cả các nhân viên được trả lương và nhân viên tình nguyện) đều rât thân thiện. Chúng tôi yêu(LOVE!) các thành viên tham gia đóng góp mới! Nếu bạn không nhận được phản hồi nhanh từ email hoặc kênh IRC, nhớ rằng có nhiều người ở trong các múi giờ khác nhau đang làm việc trên các dự án khác nhau. Hãy tự do hỏi nhiều hơn một và / hoặc hỏi nhiều hơn một người. Bạn không bao giwof bị bỏ mặc. Liên hệ<a class="link-mailto" href="mailto:eshepherd@mozilla.com"> Eric Shepherd</a>,&nbsp; MDN chieftan, nếu bạn không nhận được sự trợ giúp cần thiết. <em>Không có gì quan trọng hơ</em>n với chúng tôi bằng việc giúp đỡ các tình nguyện viên.</li>
  <li><strong>Bất kỳ ai có thể thay đổi bất cứ điều gì.</strong> Không ai sẽ buồn nếu bạn thay đổi nội dung của họ, và bạn cũng không nên phiền nếu ai đó thay đổi phần của bạn (mặc dù vậy bạn nên tự do đặt các câu hỏi về sự thay đổi). Sự thay đổi không bị lên án - chúng (hầu hết tất cả) đem lại sự cải thiện</li>
  <li><strong>Chúng tôi có <a href="/Project:en/Topic_drivers" title="Project:en/Topic_drivers">đường dẫn cho khu vực topic đặc trưng</a>.</strong> Nếu bạn đang làm việc trên một khu vực đặc biệt, học có thể giúp bạn.</li>
</ul>
<h2 id="H.C6.B0.E1.BB.9Bng_d.E1.BA.ABn_nhanh">Hướng dẫn nhanh</h2>
<h3 id=".C4.90.C4.83ng_nh.E1.BA.ADp">Đăng nhập</h3>
<p>MDN sử dụng <a href="http://www.persona.org/" title="http://www.persona.org/">Persona</a>&nbsp; để xác minh tài khoản. Tạo một tài khoản Persona và đăng nhập vào MDN.</p>
<h3 id="Th.E1.BB.B1c_h.C3.A0nh">Thực hành</h3>
<p>Thực hành kỹ năng viết wiki của bạn trong <a href="/en-US/docs/Sandbox" title="Sandbox: An area of the wiki for experiments">Sandbox</a>, và khu vực của wiki mà nó có ý nghĩa cho việc học tập và thử nghiệm.</p>
<h3 id="S.E1.BB.ADa_m.E1.BB.99t_trang">Sửa một trang</h3>
<ol>
  <li>Chọn "Edit" ở đầu mỗi trang</li>
  <li>Thực hiện thay đổi. Chọn&nbsp; "PREVIEW CHANGES" để xem thay đổi.</li>
  <li>Chọn "SAVE AND KEEP EDITING" để lưu lại sự thay đổi mà không cần đóng lại giao diện sửa đổi. Chọn "SAVE CHANGES" để lưu trang và đóng lại trang đã sửa. Chọn "DISCARD CHANGES" để quay trở lại trang ban đầu.</li>
</ol>
<div class="note">
  <p>Bạn sẽ không thể&nbsp; lưu sự thay đổi và gặp thông báo "Permission Denied"&nbsp; nếu trình duyệt của bạn được cấu hình để không gửi thông tin referrer. Nếu bạn không thể lưu thay đổi, chắc chắn rằng {{pref("network.http.sendRefererHeader")}} tùy chọn được đặt giá trị mặc định(hiện tại là&nbsp; "2").</p>
</div>
<h3 id="T.E1.BA.A1o_m.E1.BB.99t_trang_m.E1.BB.9Bi">Tạo một trang mới</h3>
<p>Nếu bạn không biết nơi nào để tạo một bài báo mới, <strong>đừng lo lắng về điều đó!</strong> Đặt nó vào một nơi nào đó, và chúng ta sẽ tìm thấy nó và chuyển đến nơi nó cần, hoặc hợp với nội dung hiện tại mà nó phù hợp nhất. Chúng tôi có vài trợ giúp nhỏ mà sẽ giúp bạn tạo ra nội dung trong sáng và ngọt ngào.</p>
<h4 id="Li.C3.AAn_k.E1.BA.BFt_t.E1.BB.AB_m.E1.BB.99t_trang_.C4.91.C3.A3_t.E1.BB.93n_t.E1.BA.A1i">Liên kết từ một trang đã tồn tại</h4>
<ol>
  <li>Đặt tên của trang mới ở trong trang.</li>
  <li>Bôi đen tên và click vào Link icon (<img alt="" src="/files/3810/link-icon.png" style="width: 29px; height: 28px;" />)trong toolbar. Hộp thoại "Update Link" xuất hiện, với nội dung đã được chọn xuất hiện trong "Link To" .</li>
  <li>"/en-US/docs/" sẽ được chèn vào mặc định ở đầu url. Đặt tên của&nbsp; trang sau "/en-US/docs/". (Tên trang không phải có cùng tên với link text.)</li>
  <li>Click OKđể chèn link.</li>
</ol>
<p>Nếu trang không tồn tại, link sẽ chuyển màu đỏ. Nếu trang tồn tại, link sẽ chuyển màu sanh. Nếu bạn muốn tạo một trang mới nhưng tiêu đề trang bạn muốn đã tồn tại, kiểm tra trước tiênnếu nó cho phép sửa. Nếu không, nghĩ tiêu đề khác cho nội dung của bạn và tjo link. Xem <a href="/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">hướng dẫn đặt tên</a> để hiểu rõ.</p>
<p>Để thêm nội dung vào trang mới, chọn vào các link màu đỏ bạn vừa tạo và bắt đầu viết. Click "SAVE AND KEEP EDITING" để lưu lại thay đổi mà không đóng lại trang chỉnh sửa. Click "SAVE CHANGES" khi bạn đã hoàn tất.</p>
<h4 id="T.E1.BA.A1o_trang_m.E1.BB.9Bi_kh.C3.B4ng_c.C3.B3_link_li.C3.AAn_k.E1.BA.BFt">Tạo trang mới không có link liên kết</h4>
<p>Để tạo một trang mới không có link liên kết tới trang khác, đặt một tên duy nhất cho URL. Ví dụ :</p>
<pre>
https://developer.mozilla.org/en-US/docs/FooBar</pre>
<p>... MDN sẽ tạo một trang mới tên "FooBar" và&nbsp; mở trình soạn thảo để bạn sửa nội dung trang mới.</p>
<h4 id=".C4.90.C3.A1nh_d.E1.BA.A5u_Wiki">Đánh dấu Wiki</h4>
<p><a href="https://github.com/mozilla/kuma" title="https://github.com/mozilla/kuma">Kuma</a>, phần mềm được phát triển bởi Mozilla được MDN sử dụng, nó dùng HTML để đánh dấu ngôn ngữ cho tài liệu. Nếu bạn muốn thấy và sửa nội dung, bạn có thể chọn vào "Source" trong khi ở chế độ edit. Click lần nữa để trở về trình soạn thảo WYSIWYG.</p>
<h2 id="Ghi_ch.C3.A9p_l.E1.BB.97i_t.C3.A0i_li.E1.BB.87u">Ghi chép lỗi tài liệu</h2>
<p>Bạn có thể báo các lỗi phức tạp bằng cách điền vào <a class="external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">mẫu.</a> Sử dụng các trường giá trị sau:</p>
<dl>
  <dt>
    product</dt>
  <dd>
    Mozilla Developer Network</dd>
  <dt>
    component</dt>
  <dd>
    Tài liệu yêu cầu</dd>
  <dt>
    URL</dt>
  <dd>
    Trang mà bạn thấy lỗi</dd>
  <dt>
    Description</dt>
  <dd>
    Miêu tả về lỗi.</dd>
</dl>
<h2 id="Di_chuy.E1.BB.83n_c.C3.A1c_t.C3.A0i_li.E1.BB.87u_c.C5.A9">Di chuyển các tài liệu cũ</h2>
<p>Các dự án cong mà không được tiếp tục phát triển sẽ được chuyển từ <a class="external" href="http://www.mozilla.org">mozilla.org</a> tới các trang trên MDN wiki. Thủ tục cực kỳ đơn giản:</p>
<ol>
  <li>Chọn một tài liệu mà bạn muốn chuyển đi từ danh sách <a href="/Project:en/Existing_Content" title="Project:en/Existing_Content">existing content</a> .</li>
  <li>Xem<a href="/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">hướng dẫn đặt tên trang</a> và quyết định các trang nào nên được gọi bởi wiki.</li>
  <li>Tạo những trang này và di chuyển nội dung, đánh dấu phù hợp cho nó sử dụng <a href="/Project:En/MDC_style_guide" title="Project:en/Wiki_Markup_Reference">hướng dẫn đánh dấu wiki</a>.</li>
  <li>Xóa nội dung từ danh sách <a href="/Project:en/Existing_Content" title="Project:en/Existing_Content">nội dung tồn tại</a>.</li>
  <li>Thêm các item để <a href="/Project:en/Needs_Redirect" title="Project:en/Needs_Redirect">chuyển hướng&nbsp; </a>nếu cần.</li>
  <li>Nếu bạn tiếp tục làm&nbsp; công việc này một cách toàn diện, bạn cũng nên:</li>
</ol>
<ol>
  <li>Sử dụng <a href="/Special:Search" title="Search">hệ thống tìm kiếm </a>của chúng tôi để tìm bất kỳ link nào từ trang ban đầu của wiki, và sau đó thay đổi những link này tại một trang mới.</li>
  <li>Kiểm tra <a href="/Project:en/External_Redirects" title="Project:en/External_Redirects">chuyển hướng</a> tới tài liệu gốc, và đánh dấu tag "Junk".</li>
</ol>
<h2 id="Vi.E1.BB.87t_h.C3.B3a_MDN">Việt hóa MDN</h2>
<p>Nếu bạn hứng thú với việc giúp đỡ chúng tôi dịch các tài liệu của bất kỳ trang Wiki nào sang ngôn ngữ khác, đơn giản xác định ngôn ngữ của trang và tạo trang mới. Xem dự án <a href="/en-US/docs/Project:Localization_Projects" title="/en-US/docs/Project:Localization_Projects">Địa phương hóa</a> để biết thêm thông tin về dự án hiện tại và cách bắt đầu một dự án mới.</p>
<h2 id="Ph.C3.A2n_x.E1.BB.AD_.22b.C3.BAt_chi.E1.BA.BFn.22_ho.E1.BA.B7c_xung_.C4.91.E1.BB.99t_kh.C3.A1c">Phân xử "bút chiến" hoặc xung đột khác</h2>
<p>Nếu vì lý do nào đó bạn kết thúc với "bút chiến" trên một trang, nơi mà hai hoặc nhiều người hơn đang tiếp tục phục hồi lại, hãy cố gắng phân sử xung đột này với người liên quan trước.</p>
<p>Nếu không có giải pháp phù hợp, hãy mang vấn đề đó tới&nbsp; <a href="/Project:en/Community" title="Project:en/Community">MDN mailing list</a> hoặc nhóm <a href="/User:Sheppy" title="User:Sheppy">developer documentation lead</a>. Các chuyên gia kỹ thuật, nhà văn sẽ tư vấn nếu cần thiết, và kinh nghiệm của họ sẽ được dùng dể giải quyết vấn đề này.</p>
<h2 id="Y.C3.AAu_c.E1.BA.A7u_x.C3.B3a_trang">Yêu cầu xóa trang</h2>
<p>Nếu bạn tạo một trang vô ý mà muốn xóa nó, thêm tag "junk" vào nó.</p>
<p>Các Items được tag <a class="internal" href="https://developer.mozilla.org/en-US/docs/tag/junk" title="Special:Tags?tag=Junk">Junk</a> được kiểm tra định kỳ bởi admin wiki và các trang sẽ được xem xét để xóa nếu được chấp nhận.</p>
<div class="note">
  <strong>Chú ý</strong>: Không xóa nội dung khác&nbsp; loại từ các trang mà được tag là "junk".Hu</div>
Revert to this revision