blob: d705c3f305b779281627cae2cd4cab4749f576bb [file] [log] [blame]
<html><head>
<meta HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8">
</head>
<body>
<table width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="84%" height="769" valign="top">
<h1>การเขียน/แก้ไข CVS ด้วยตัวเอง</h1>
<h2>การขอสิทธิ์ในการแก้ไขด้วยตัวเอง</h2>
<ol>
<li>สมัครเป็นสมาชิก OpenOffice.org [<a href="howto-subscribe.html">วิธีสมัคร</a>]</li>
<li><a href="#genkey">สร้างคู่กุญแจสาธารณะและกุญแจส่วนตัว</a></li>
<li><a href="#submitkey">ส่งกุญแจสาธารณะไปยังเว็บไซท์ของ OpenOffice.org</a></li>
<li><a href="#tunnel">สร้าง SSH Tunnel ในการติดต่อ</a></li>
<li><a href="#cvs">ใช้งาน CVS ผ่าน SSH Tunnel</a></li>
<!--<li>ลงนามในข้อตกลงลิขสิทธิ์ร่วม (Joint Copyright Agreement : JCA)
(ดู <a href="http://www.openoffice.org/contributing.html">http://www.openoffice.org/contributing.html</a>)
โดยนักพัฒนาจะต้องกรอกเอกสาร และลงลายมือชื่อของตัวเอง
ก่อนจะส่งเอกสาร <u>ฉบับจริง</u> ทางจดหมาย ไปที่เจ้าหน้าที่ของ OO.o
หลังจากนั้น นักพัฒนาจึงจะได้รหัส และสิทธิให้แก้ไข CVS ได้</li>
<p>หลังจากส่งเอกสารไปแล้ว ควรจะส่งอีเมลไปบอกเจ้าหน้าที่ที่รับผิดชอบด้วย ว่าเราได้ส่งเอกสารไปให้แล้ว
โดยทั่วไปจะได้รับการตอบรับภายในหนึ่งเดือน หากเกินกว่านี้ ให้ลองอีเมลไปสอบถามกับผู้รับผิดชอบอีกทีเพื่อติดตาม</p>-->
</ol>
<a href="http://www.openoffice.org/docs/ddSSHGuide.html">เอกสารอย่างละเอียด (ฉบับภาษาอังกฤษ)</a>
<h2><a name="genkey"></a>สร้างคู่กุญแจสาธารณะและกุญแจส่วนตัว</h2>
<ul>
<li>ในการแก้ไข CVS จะต้องทำผ่าน Secure Shell (SSH2) เท่านั้น ด้วยเหตุผลด้านความปลอดภัย</li>
<li>การจะใช้ SSH2 ได้นั้น
เราจะต้องมี <b>กุญแจส่วนตัว (private key)</b> และ <b>กุญแจสาธารณะ (public key)</b> เสียก่อน
โดยเราจะเก็บกุญแจส่วนตัวของเราเอาไว้กับตัว และส่งกุญแจสาธารณะของเราไปให้ทาง OO.o
(ทุกๆ ครั้งที่มีการติดต่อทาง SSH2 กับ OO.o
จะมีการตรวจสอบกุญแจสองอันนั้น ว่าเป็นคู่กันจริงหรือไม่
เพื่อเป็นการยืนยันว่า ตัวเรา คือ "ตัวเรา" จริงๆ)</li>
<li>สร้างกุญแจส่วนตัวและกุญแจสาธารณะบนระบบยูนิกซ์ (และ MacOSX)
<ol>
<li>ใช้คำสั่ง ssh-keygen -d</li>
<li>ระบุ Passphrase สำหรับยืนยันตัวตน (ไม่ใส่ก็ได้)</li>
<li>จะได้ไฟล์สองไฟล์ ใน ~/.ssh/ คือ id_rsa (กุญแจส่วนตัว) และ id_rsa.pub (กุญแจสาธารณะ)
<li>เปลี่ยนสิทธิการเข้าถึงกุญแจส่วนตัว ให้เป็นของผู้ใช้คนเดียว ด้วยคำสั่ง chmod 700 id_rsa
</ol>
</li>
<li>สำหรับวินโดว์ จำเป้นต้องติดตั้ง Cygwin ก่อน<br>
<b>Cygwin</b> เป็นชุดโปรแกรม ที่ทำให้เราใช้คำสั่งของระบบปฏิบัติการ Unix
บนระบบปฏิบัติการ Windows ได้</li>
ดาวน์โหลด และดูวิธีติดตั้ง ได้ที่ <a href="http://www.cygwin.com/">http://www.cygwin.com/</a><br>
ในขั้นตอนการติดตั้ง Cygwin ให้แน่ใจว่า
ได้เลือกติดตั้งแพคเกจเหล่านี้*
<ul>
<li>cvs (Category: Devel)</li>
<li>openssh (Category: Net)</li>
<li>openssl (Category: Libs)</li>
<li>patch (Category: Utils)</li>
</ul>
</ul>
<h2><a name="submitkey"></a>ส่งกุญแจสาธารณะไปยังเว็บไซท์ของ OpenOffice.org</h2>
วิธีการแจ้ง กุญแจสาธารณะ ของเราไปที่ OOo (<u>แจ้งเฉพาะ กุญแจสาธารณะ เท่านั้น</u>)
<ol>
<li>ไปที่ IssueZilla (ต้องสมัครสมาชิก OpenOffice.org ก่อน)</li>
<li>เปิดประเด็น (issue) ใหม่</li>
<li>เลือกหัวข้อประเด็นเป็น "website"</li>
<li>ช่อง Assign: ให้ใส่ "ssh2key@openoffice.org"
<li>ช่อง CC: ใส่ใส่อีเมลของ Project Owner (สำหรับโครงการโอเพ่นออฟฟิศ.อ็อก ภาษาไทย สามารถอ่านรายชื่อ<a href="http://th.openoffice.org/servlets/ProjectMemberList">สมาชิกของโครงการ</a>)
<li>เขียนอธิบายถึงเหตุผลที่คุณต้องการมี CVS Account และโครงการที่ต้องการมีส่วนร่วม
<li>ส่ง public key ที่ได้จากโปรแกรม เป็นไฟล์แนบ (attachment) เลือกประเภทของไฟล์เป็น text/plain</li>
</ol>
</li>
</ul>
<p>หลังจากส่งกุญแจสาธารณะไปแล้ว โดยปกติจะได้รับการตอบรับ และเข้าใช้ CVS ได้ ภายในสองสัปดาห์ (ได้รับอีเมลบอกว่า Issue นี้ Resolved)<br>
หากเกินกว่านี้ ให้ลองอีเมลไปสอบถามกับผู้รับผิดชอบอีกทีเพื่อติดตาม</p>
<h2><a name="tunnel"></a>สร้าง SSH Tunnel ในการติดต่อ</h2>
<ol>
<li>(สำหรับวินโดว์) เรียกใช้ Cygwin ก่อน</li>
<li>สั่ง ssh -2 -x -L 2401:localhost:2401 tunnel@openoffice.org</li>
<li>ถ้าพบข้อความให้ใส่ Passphrase แสดงว่าถูกต้อง ถ้าเป็นคำว่า Password แทน แสดงว่ากุญแจสาธารณะยังไม่เรียบร้อย
<li>ใส่ Passphrase (หรือไม่ต้องทำอะไร ถ้าไม่ได้ตั้ง Passphrase ไว้) จากนั้น จะขึ้นข้อความว่า SSH Tunnel เรียบร้อย ให้กด Ctrl+C ถ้าต้องการเลิกทำงาน ให้เปิดหน้าจอนี้ทิ้งไว้ แล้วสร้างหน้าจอใหม่เพื่อใช้งาน CVS
</ol>
<h2><a name="cvs"></a>ใช้งาน CVS ผ่าน SSH Tunnel</h2>
<p><b>การตั้งค่า CVSROOT</b><br>
ให้ตั้งค่า CVSROOT ของตนเอง ดังนี้<br>
export CVSROOT=":pserver:username@localhost:/cvs"<br>
โดย username เป็นชื่อสมาชิกที่สมัคร OpenOffice.org ไป และใช้ password เดียวกัน ส่วน localhost ไม่ต้องเปลี่ยน</p>
<p><b>การล็อกอินเข้าใช้ CVS</b><br>
สั่ง cvs login และใส่รหัสผ่าน
</p>
<p><b>การดึงข้อมูลจาก CVS</b><br>
สำหรับผู้พัฒนาเนื้อหา (Content Developer)
ในครั้งแรก ให้ทำการ checkout เนื้อหาที่มีอยู่ของโครงการ <b>th</b> มาไว้ที่เครื่องของตัวเองก่อน โดย:
<pre><tt> arthit@arthit:/tmp> <b>cvs -z9 co th</b>
cvs server: Updating th
cvs server: Updating th/www
U th/www/index.html
...</tt></pre>
ถึงขั้นตอนนี้ เนื้อหาต่างๆ (หน้าเวบ รูปภาพ คู่มือ และไฟล์อื่นๆ) ของโครงการ th ก็จะมาอยู่ที่เครื่องของเราแล้ว</p>
<p><b>การเขียนข้อมูลกลับไปยัง CVS</b><br>
เมื่อเราได้ทำการแก้ไขไฟล์ใดๆ ในเครื่องของเราไปแล้ว
และต้องการที่จะส่งมันกลับไปที่ CVS
สามารถทำได้โดยใช้คำสั่ง
<pre><tt> arthit@arthit:/tmp/th/www> <b>cvs -z9 commit -m "fix some typos, add new link"</b></tt></pre>
ในเครื่องหมายคำพูดนั้น คือโน๊ตย่อสั้นๆ ว่าเราได้ทำการแก้ไขอะไรไปบ้าง</p>
<p>ในกรณีที่เราได้เพิ่มไฟล์ใหม่เข้าไป เราต้องบอก CVS เสียก่อน ว่าเรามีไฟล์ใหม่แล้ว แล้วค่อยสั่ง commit อีกครั้งหนึ่ง
<pre><tt> arthit@arthit:/tmp/th/www> <b>cvs add newpage.html</b></tt></pre></p>
<p><a href="http://www.openoffice.org/docs/ddCVS.html">วิธีการใช้งาน CVS เพิ่มเติม</a> (ภาษาอังกฤษ)</p>
</td>
<td width="1%" valign="top">&nbsp;</td>
<td width="15%" valign="top">
<table width="100%" border="1" bordercolor="#000000" cellspacing="0" cellpadding="5">
<tr><td bgcolor="#000080"><font color="#fffffff" face="Verdana, Arial, Helvetica, sans-serif" size="3"><b>ชุมชนภาษาไทย</b></font></td></tr>
<tr><td><font size="2"><a href="index.html">แนะนำ</a></font></td></tr>
<tr><td bgcolor="#000080"><font color="#fffffff" face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>ผลิตภัณฑ์</b></font></td></tr>
<tr><td><font size="2">
<a href="about-product.html">รายละเอียด</a><br>
<a href="about-downloads.html">ดาวน์โหลด</a><br>
<a href="about-cdrom.html">ซีดีรอม</a><br>
<a href="about-spellcheck.html">ตัวตรวจตัวสะกด</a></font></td></tr>
<tr><td bgcolor="#000080"><font color="#fffffff" face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>โครงการ</b></font></td></tr>
<tr><td><font size="2">
<a href="background.html">ความเป็นมา</a><br>
<a href="faq.html">ถาม/ตอบ</a>
</font></td></tr>
<tr><td bgcolor="#000080"><font color="#fffffff" face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>ขอความช่วยเหลือ</b></font></td></tr>
<tr><td><font size="2">
<a href="about-mailinglist.html">เมลลิงลิสต์</a><br>
<a href="about-documentation.html">เอกสาร</a>
</font></td></tr>
<tr><td bgcolor="#000080"><font color="#fffffff" face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>ร่วมพัฒนา</b></font></td></tr>
<tr><td><font size="2">
<a href="about-helping.html">ทำอย่างไร?</a><br>
<a href="about-issuezilla.html">แจ้งบั๊ก</a><br>
</font></td></tr>
<tr><td bgcolor="#000080"><font color="#fffffff" face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>ติดต่อ</b></font></td></tr>
<tr><td><font size="2">
<a href="about-mailinglist.html">เมลลิงลิสต์</a><br>
<a href="addresses.html">ที่อยู่</a>
</font></td></tr>
<tr><td bgcolor="#000080"><font color="#fffffff" face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>อื่นๆ</b></font></td></tr>
<tr><td><font size="2">
<a href="credits.html">เครดิต</a><br>
<a href="about-legal.html">ข้อกฏหมาย</a><br>
</font></td></tr>
</table>
</td>
</tr>
</table>
</body>
</html>