GIT — Git

GIT Một kho Git được duyệt như một thư mục: các tệp đã thay đổi, các nhánh, lịch sử.

Mở một kho

Nút GIT trên thanh nhảy đến dự án yêu thích; nhấp chuột phải cho ra danh sách: các kho đã biết, “Commit”, “Lịch sử…”, các nhánh, “Stash…” và “Các phần đã cất”, “Thẻ…”, “Kho từ xa”. Một thư mục trên đĩa chưa phải là kho sẽ đề xuất ở đó “Clone tại đây”. Các dự án tự được thêm khi bạn vào đó, và một dự án có thư mục đã biến mất sẽ bị quên — trừ khi chính ổ đĩa của nó bị thiếu, vì một USB bị rút ra không làm quên gì cả.

Trạng thái của một thư mục

Mỗi dòng mang màu riêng: xung đột, chưa theo dõi, đã sửa, đã dàn dựng, bị bỏ qua. Git mô tả một tệp theo hai trục — chỉ mục và bản làm việc — và một dòng không đủ chỗ để hiện cả hai: chính những gì còn phải làm quyết định màu. Đường dẫn phân cấp cho biết nhánh hiện tại.

Dàn dựng và commit

“Commit” mở khung nhìn các thay đổi: mỗi dòng một tệp, cột Đang theo dõi cho biết git biết gì về nó. Bạn chỉ định các dòng như ở mọi nơi khác — nhấp, Ctrl+nhấp, Shift+nhấp —, viết thông điệp ở dưới, và Commit đi với những gì đang được chọn. Không chọn gì thì không có gì đi: nút cho biết điều đó.

Nút Chưa theo dõi trên thanh commit ẩn những gì git không theo dõi: một thư mục đầy tệp dùng một lần không còn che lấp hai tệp bạn muốn commit, và Ctrl+A không còn chọn kèm chúng. Khi bỏ chọn, nút cho biết đang ẩn bao nhiêu tệp.

Xem các khác biệt

“Hiện khác biệt” mở diff từng khối một, giữa bản làm việc, chỉ mục (đã dàn dựng) và một commit — trước và sau được gọi tên ở đó. Với tệp nhị phân, chương trình báo rõ như vậy thay vì hiện ra một mớ ký tự vô nghĩa.

Các thao tác

• Commit kèm thông điệp của nó.
• Bỏ qua: tệp được thêm vào .gitignore.
• Hoàn tác (rollback): hộp thoại cho biết có bao nhiêu tệp mới sẽ bị xoá khỏi đĩa và bao nhiêu tệp sẽ trở về trạng thái trong kho. Công việc chưa commit sẽ mất — điều này được ghi rõ.
• Chép › bảng nháp: một dòng của các thay đổi là một tệp trên đĩa, và được sao chép như vậy — để dán ở nơi khác, kể cả bên ngoài Meneaufile. Không cắt cũng không dán: danh sách do git dựng lại, bạn không gỡ được một dòng khỏi đó và cũng không ghi được gì vào đó.
• Mở tại vị trí của nó: tệp nằm ở nơi khác với dòng của nó — dòng sống trong danh sách, còn tệp thì ở bản làm việc, nơi bạn chỉnh sửa nó. Mục này dẫn đến đó.

Các nhánh và lịch sử

Tạo một nhánh, chuyển sang nó, hợp nhất — mục mang tên của nhánh, và trả lời không có gì để trộn: đã cập nhật hoặc trộn đã dừng: một số tệp xung đột. “Lịch sử…” liệt kê các commit: mã băm ngắn, chủ đề, tác giả, ngày của chúng. Rãnh bên trái vẽ đồ thị, mỗi dòng trên đường của mình, và một phép hợp nhất kẻ nét của nó về phía cột lân cận. Nhấp đúp mở chi tiết của một commit: toàn bộ thông điệp và các tệp mà nó đã đụng đến.

Cây merge request

Cây merge request… trong menu của nút GIT vẽ các MR đang mở của dự án GitLab mà kho từ xa trỏ tới. Mỗi MR nằm dưới nhánh mà nó tách ra, thụt một bậc như mục lục: bậc cho biết thứ tự duyệt, và nhấp vào một thẻ sẽ mở MR trong trình duyệt.

• Nguồn gốc được đọc từ các commit. Một MR tách ra từ MR khác nằm dưới MR đó, kể cả khi cả hai cùng nhắm main: “sau !28” cho biết nên duyệt cái nào trước, và “đích main” cảnh báo rằng nó vẫn nhắm main — hợp nhất nó trước sẽ kéo theo các commit của MR kia.
• Các huy hiệu cho thấy trạng thái do GitLab báo: bản nháp, xung đột, cần rebase, chờ duyệt, thảo luận còn mở, pipeline đang chạy, sẵn sàng.
• Nút Checkout, ở góc trên bên phải mỗi thẻ, chuyển bản làm việc sang nhánh của MR để thử hoặc xem lại trước khi duyệt. Nhánh được tải từ máy chủ trước; công việc dang dở được đề nghị cất tạm, như mọi lần chuyển nhánh. Dấu tích đánh dấu nhánh bạn đang ở.
• Mã truy cập cá nhân, có quyền read_api, được tạo trong GitLab: User settings › Access › Personal access tokens › Generate token. Meneaufile hỏi một lần và lưu trong két, trong một mục riêng; một mục NET chứa mật khẩu tài khoản không được coi là mã.

Trao đổi với kho từ xa

“Pull” và “Push”, với số commit liên quan nằm cạnh nhãn — số không thì không hiện. Một nhánh chưa tồn tại ở phía đối diện sẽ đi cùng nhánh thượng nguồn của nó. Các kho từ xa được khai báo và gỡ bỏ từ cùng một menu. Khi máy chủ yêu cầu xác thực, Meneaufile hỏi lại bạn thay vì đứng im không nói gì.

Cất sang một bên

“Stash…” cất công việc đang làm mà không commit, kèm một mô tả tuỳ chọn; “Các phần đã cất” — Công việc đã cất — liệt kê những gì đang chờ, và từ đó bạn lấy lại hoặc vứt bỏ. “Thẻ…” đặt và gỡ thẻ theo cách tương tự.

Ai đã viết dòng này

“Chú giải dòng”, trong menu của một tệp, gán mỗi dòng cho commit và tác giả của nó. Đó là câu hỏi bạn tự đặt ra trước một dòng gây ngạc nhiên, và một danh sách commit không trả lời được.

Các xung đột

Một tệp xung đột mở ra với các phiên bản của nó: phiên bản chung, của ta, của họ, và kết quả mà bạn đang xây dựng. “Lấy tất cả” đổ nguyên một phía vào, “Giải quyết” ghi lại — và tệp rời khỏi nhóm xung đột.

Clone

Từ một thư mục: địa chỉ (https://… hoặc git@host:org/depot.git), tên thư mục sẽ tạo, và lịch sử đầy đủ hoặc rút gọn — N commit gần nhất.

Bundle

Tệp .bundle là một kho Git được đóng gói trong một tệp duy nhất: đủ để mang một dự án theo trên USB, hoặc trao cho ai đó, mà không cần máy chủ. Nhấp đúp cho biết nó chứa gì — các nhánh, các thẻ của nó — và Nhân bản vào đây… biến nó thành một kho bình thường, ngay cạnh nó, không cần mạng. Trong một kho, Tạo bundle… ở menu GIT đóng gói toàn bộ kho vào thư mục của khung nhìn còn lại.

Nếu thiếu git

Meneaufile gọi git của hệ thống. Nếu không có hoặc nằm ngoài PATH, nó nói rõ thay vì thất bại không lý do.

Hướng dẫn sử dụng Meneaufile, bằng tiếng Việt.