Start translate preface.txt
[gitmagic.git] / vi / basic.txt
blob7a1f777c5820ae634bd96f861690bcd7e5167b72
1 == Vài mẹo Cơ bản ==
3 Thay vì lao vào cả một biển lệnh với Git, hãy sử dụng các ví dụ cơ bản để bắt đầu.
4 Mặc dù chúng rất đơn giản, nhưng tất cả chúng đều rất hữu dụng.
5 Quả thực là vậy, trong tháng đầu tiên sử dụng Git Tôi chưa bao giờ vượt qua những gì nói trong chương này.
7 === Ghi lại State ===
9 About to attempt something drastic? Trước khi làm điều đó, thực hiện với tất cả các tệp tin trong thư mục hiện hành bằng cách:
11  $ git init
12  $ git add .
13  $ git commit -m "My first backup"
15 Bây giờ nếu như các thay đổi của bạn không như mong đợi, hãy phục hồi lại bản cũ:
17  $ git reset --hard
19 Lưu lại state lần nữa:
21  $ git commit -a -m "Another backup"
23 === Thêm, Xóa, Đổi tên ===
25 Lệnh ở trên chỉ giữ dấu vết các tệp tin và hiện diện tại thời điểm vạn chạy lệnh *git add*. Nếu bạn thêm các tệp tin hay thư mục, bạn sẽ phải thông báo với Git:
27  $ git add readme.txt Documentation
29 Tương tự như vậy, nếu bạn muốn Git bỏ qua các tệp tin nào đó:
31  $ git rm kludge.h obsolete.c
32  $ git rm -r incriminating/evidence/
34 Git xóa bỏ những tệp tin nếu như bạn chưa làm vậy.
36 Đổi tên tệp tin thì cũng giống như là việc bạn gỡ bỏ tên cũ và đặt vào tên mới. Sử dụng lệnh *git mv* có cú pháp rất giống lệnh *mv*. Ví dụ:
38  $ git mv bug.c feature.c
40 ===  Chức năng Undo/Redo  ===
42 Đôi khi bạn chỉ muốn quay trở lại và bỏ đi những thay đổi trong quá khứ tại một thời điểm nào đó bởi vì chúng tất cả đã sai. Thì lệnh:
44  $ git log
46 sẽ hiển thị cho bạn danh sách các lần commit gần đây cùng với giá trị băm SHA1:
48 ----------------------------------
49 commit 766f9881690d240ba334153047649b8b8f11c664
50 Author: Bob <bob@example.com>
51 Date:   Tue Mar 14 01:59:26 2000 -0800
53     Replace printf() with write().
55 commit 82f5ea346a2e651544956a8653c0f58dc151275c
56 Author: Alice <alice@example.com>
57 Date:   Thu Jan 1 00:00:00 1970 +0000
59     Initial commit.
60 ----------------------------------
62 Chỉ vài ký tự của giá trị băm là đủ để chỉ ra một commit;
63 một cách khác là chép và dán giá trị băm. Gõ:
65  $ git reset --hard 766f
67 để phục hồi lại state đã chỉ ra và xóa bỏ tất cả các lần commit mới hơn kể từ đó.
69 Một lúc nào đó bạn lại muốn nhảy tới một cái cũ hơn. Trong trường hợp này thì gõ:
71  $ git checkout 82f5
73 This takes you back in time, while preserving newer commits. However, like time travel in a science-fiction movie, if you now edit and commit, you will be in an alternate reality, because your actions are different to what they were the first time around.
75 This alternate reality is called a 'branch', và <<branch, chúng ta có nhiều điều để nói về nó sau này>>. Bây giờ, chỉ cần nhớ là
77  $ git checkout master
79 sẽ mang chúng ta trở về hiện tại. Also, to stop Git complaining, always
80 commit or reset your changes before running checkout.
82 To take the computer game analogy again:
84 - *`git reset --hard`*: load an old save and delete all saved games newer than the one just loaded.
86 - *`git checkout`*: load an old game, but if you play on, the game state will deviate from the newer saves you made the first time around. Any saved games you make now will end up in a separate branch representing the alternate reality you have entered. <<branch,We deal with this later>>.
88 You can choose only to restore particular files and subdirectories by appending them after the command:
90  $ git checkout 82f5 some.file another.file
92 Hãy cẩn thận, như là lệnh *checkout* có thể âm thầm ghi đè lên các tệp tin. Để
93 ngăn ngừa rủi ro như thế, hãy commit trước khi chạy lệnh checkout, nhất là khi
94 mới học sử dụng Git. Tóm lại, bất kỳ khi nào bạn không chắc chắn về một lệnh nào đó, dù có là lệnh của Git hay không, đầu tiên hãy chạy lệnh *git commit -a*.
96 Bạn không thích việc cắt dán ư? Hãy sử dụng:
98  $ git checkout :/"My first b"
100 để nhảy tới lần commit mà bắt đầu với thông điệp đã cho.
101 Bạn cũng có thể yêu cầu state thứ 5 kể từ cuối cùng:
103  $ git checkout master~5
105 === Reverting ===
107 In a court of law, events can be stricken from the record. Likewise, you can pick specific commits to undo.
109  $ git commit -a
110  $ git revert 1b6d
112 will undo just the commit with the given hash. The revert is recorded as a new
113 commit, bạn có thể xác nhận bằng lệnh *git log*.
115 === Tạo Changelog ===
117 Một số dự án yêu cầu có http://en.wikipedia.org/wiki/Changelog[changelog].
118 Tạo một cái bằng cách gõ:
120  $ git log > ChangeLog
122 === Tải về các Tệp tin ===
124 Lấy về một bản sao của một dự án quản lý bằng Git bằng cách gõ:
126  $ git clone git://server/path/to/files
128 Ví dụ, để lấy tất cả các tệp tin mà tôi đã dùng để tạo ra cho trang mạng này là:
130  $ git clone git://git.or.cz/gitmagic.git
132 Chúng ta sẽ có nhiều điều để nói về lệnh *clone* sớm thôi.
134 === The Bleeding Edge ===
136 Nếu bạn đã tải về một bản sao của một dự án sử dụng *git clone*, bạn có thể nâng cấp lên phiên bản cuối cùng với lệnh:
138  $ git pull
140 === Instant Publishing ===
142 Suppose you've written a script you'd like to share with others. You could just tell them to download from your computer, but if they do so while you're improving the script or making experimental changes, they could wind up in trouble.  Of course, this is why release cycles exist. Developers may work on a project frequently, but they only make the code available when they feel it is presentable.
144 Thực hiện điều này với Git, trong thư mục nơi script của bạn nằm trong:
146  $ git init
147  $ git add .
148  $ git commit -m "First release"
150 Sau đó nói với những người cùng sử dụng hãy chạy:
152  $ git clone your.computer:/path/to/script
154 để tải script về. This assumes they have ssh access. Nếu không, chạy *git daemon* và nói với người sử dụng là chạy lệnh sau để thay thế:
156  $ git clone git://your.computer/path/to/script
158 Kể từ lúc này, bất cứ khi nào mã nguồn của bạn đã sẵn sàng, chỉ việc thực hiện:
160  $ git commit -a -m "Next release"
162 và những người sử dụng có thể cập nhật dữ liệu của họ bằng cách chuyển tới thư mục làm việc tương ứng và gõ:
164  $ git pull
166 Your users will never end up with a version of your script you don't want them to see.
168 === Tôi Phải Làm Gì? ===
170 Tìm tất cả các thay đổi kề từ lần bạn commit lần cuối bằng lệnh:
172  $ git diff
174 Hay từ hôm qua:
176  $ git diff "@{yesterday}"
178 Hay giữa một bản nào đó và bản trước đây 2 bản:
180  $ git diff 1b6d "master~2"
182 In each case the output is a patch that can be applied with *git apply*.
183 Try also:
185  $ git whatchanged --since="2 weeks ago"
187 Thường thường, tôi sẽ dùng http://sourceforge.net/projects/qgit[qgit]
188 để thay thế cách ở trên, bởi vì nó có giao diện đồ họa bóng bẩy, hay
189 http://jonas.nitro.dk/tig/[tig], có giao diện dòng lệnh làm việc rất tối với
190 các máy có kết nối chậm. Một lựa chọn khác là cài đặt máy chủ web, chạy lệnh *git instaweb*
191 và sử dụng bất kỳ trình duyệt web nào.
193 === Bài tập===
195 Coi A, B, C, D là 4 lần commit thành công where B is the same as A except some files have been removed. Chúng ta muốn thêm các tệp tin đó trở lại D. Chúng ta thực hiện điều này bằng cách nào?
197 Ở đây chúng ta có ít nhất 3 giải pháp. Giả thiết chúng ta đang ở D:
199   1. Sự khác nhau giữa A và B là việc các tệp tin đã bị gỡ bỏ. We can create a patch representing this difference and apply it:
201    $ git diff B A | git apply
203   2. Since we saved the files back at A, chúng ta có thể lấy lại:
205    $ git checkout A foo.c bar.h
207   3. We can view going from A to B as a change we want to undo:
209    $ git revert B
211 Lựa chọn nào là tốt nhất? Cái nào bạn thích nhất. It is easy to get what you want with Git, and often there are many ways to get it.