Kết nối GitHub

Kết nối của Notion với GitHub cho phép bạn kết nối liền mạch các quy trình phát triển của mình. Bạn có thể liên kết nội dung GitHub trực tiếp trong các trang Notion, kéo thông tin GitHub vào cơ sở dữ liệu Notion và đồng bộ các yêu cầu kéo với các tác vụ Notion để giữ cho nhóm của bạn được thông báo về trạng thái dự án. Hãy đọc tiếp để tìm hiểu về các tính năng khác nhau của kết nối và cách bạn có thể thiết lập chúng.

Bạn cần phải là chủ sở hữu không gian làm việc Notion và quản trị viên tổ chức GitHub để kết nối Notion và ứng dụng không gian làm việc GitHub.

1. Đi tới Settings trong thanh bên → kết nối.

2. Tìm GitHub (Workspace).

3. Nhấp vào Connect và thực hiện quy trình xác thực.

Liên kết đến một tệp hoặc các dòng cụ thể từ một tệp trực tiếp trong Notion. Bạn thậm chí có thể liên kết từ một commit hoặc nhánh cụ thể nếu bạn muốn mã mà bạn đang tham chiếu luôn được cập nhật.

1. Sao chép permalink cho các dòng bạn muốn từ GitHub.

2. Dán nó vào một trang Notion và chọn Paste as preview để nhúng mã vào trang của bạn.

Bạn có thể đồng bộ các kho lưu trữ GitHub của mình (bao gồm các yêu cầu kéo và vấn đề) vào Notion dưới dạng cơ sở dữ liệu. Để thực hiện việc này:

1. Trong GitHub, hãy sao chép liên kết đến một yêu cầu kéo hoặc vấn đề.

2. Dán liên kết vào Notion và chọn Paste as database.

   • Nếu bạn chưa thực hiện, bạn sẽ được nhắc đăng nhập và kết nối Notion với tài khoản GitHub của mình.

3. Cơ sở dữ liệu đồng bộ sẽ được tạo ở chế độ xem bảng biểu, với tất cả các thuộc tính GitHub được tự động thêm vào.

4. Cơ sở dữ liệu sẽ bắt đầu tự động điền dữ liệu và sẽ tiếp tục đồng bộ nếu bạn điều hướng khỏi trang.

Dưới đây là danh sách các thuộc tính GitHub mà chúng tôi hỗ trợ:

Nhãn và thẻ hiện không được hỗ trợ.

Bạn có thể sử dụng ánh xạ danh tính để kết nối danh tính GitHub với hồ sơ Notion của nhóm bạn. Để thực hiện việc này:

1. Điều hướng đến GitHub email settings của bạn và đảm bảo rằng cài đặt Keep my email addresses privatenot được chọn.

2. Trong hồ sơ GitHub của bạn (https://github.com/{YOUR_USERNAME_HERE}), hãy chỉnh sửa hồ sơ để thêm địa chỉ email Notion của bạn.

Việc này cho phép danh tính của bạn được ánh xạ tới các cơ sở dữ liệu được đồng bộ trong các không gian làm việc mà bạn là thành viên.

Thuộc tính yêu cầu kéo GitHub trong cơ sở dữ liệu Notion của bạn sẽ tự động cập nhật trạng thái nhiệm vụ cho các nhóm liên chức năng. Thuộc tính này cũng có nhiều đặc điểm mà bạn có thể sử dụng trong các bản tổng hợp (rollup), công thức và bộ lọc.

1. Trong cơ sở dữ liệu Notion, hãy nhấp vào + để thêm thuộc tính mới.

2. Tìm kiếm và nhấp vào yêu cầu kéo GitHub để thêm thuộc tính này vào cơ sở dữ liệu của bạn.

   • Nếu bạn không thấy danh sách thuộc tính yêu cầu kéo GitHub, hãy đi tới Settings → More Settings → kết nối → Thêm yêu cầu kéo GitHub.

3. Đảm bảo cơ sở dữ liệu của bạn có Unique ID property. Thuộc tính này sẽ được thêm vào cơ sở dữ liệu của bạn nếu nó chưa có.

4. Để sử dụng thuộc tính yêu cầu kéo GitHub, hãy đảm bảo bạn đã kết nối tài khoản GitHub của mình với Notion. Sau đó, hãy thêm Unique ID của nhiệm vụ Notion vào yêu cầu kéo, hoặc dán URL của yêu cầu kéo GitHub vào thuộc tính đó.

Theo mặc định, Notion bật tính năng liên kết ngược (backlink) trên các nhiệm vụ Notion tới GitHub. Nếu bạn muốn tắt tính năng này, hãy nhấp vào thuộc tính yêu cầu kéo GitHub trong cơ sở dữ liệu của bạn → Edit property. Tắt Linkbacks in GitHub.

Bạn có thể sử dụng thuộc tính yêu cầu kéo GitHub để tự động cập nhật trạng thái các nhiệm vụ của mình trong Notion.

1. Chọn tiêu đề của thuộc tính yêu cầu kéo GitHub của bạn và nhấp vào Chỉnh sửa thuộc tính.

2. Tìm phần Auto-update và chọn thuộc tính trạng thái bạn muốn cập nhật từ menu thả xuống.

3. Chọn trạng thái nhiệm vụ sẽ được thiết lập khi yêu cầu kéo GitHub được Mở, Yêu cầu đánh giá, đã phê duyệt và Hợp nhất.

4. Giờ đây, khi yêu cầu kéo GitHub tiến triển trong GitHub, trạng thái nhiệm vụ của bạn trong Notion sẽ được cập nhật tự động dựa trên cài đặt của bạn.

Bạn cũng có thể hiển thị Hoạt động GitHub trong nhiệm vụ Notion được liên kết. Để thực hiện việc này, hãy nhấp vào thuộc tính GitHub trong cơ sở dữ liệu của bạn → Chỉnh sửa thuộc tính. Bật Activity Comments.

Nếu bạn muốn liên kết một yêu cầu kéo GitHub với một hoặc nhiều nhiệm vụ Notion, chỉ cần nhập một từ khóa và unique ID của các nhiệm vụ Notion vào mô tả yêu cầu kéo của bạn.

Từ khóa là những từ giúp thiết lập mối quan hệ giữa các nhiệm vụ Notion và yêu cầu kéo GitHub. Bạn có thể sử dụng bất kỳ từ nào sau đây:

• close, closes, closed

• fix, fixes, fixed

• resolve, resolves, resolved

• complete, completes, completed, completing

• ref, references

• part of

• liên quan đến

• contributes to

• towards

Ví dụ: yêu cầu kéo GitHub của bạn có thể có mô tả “fixes CTT-13”. Sau khi mô tả đó được thiết lập, nhiệm vụ Notion có ID CTT-13 của bạn sẽ được liên kết với yêu cầu kéo đó.

Nếu mô tả yêu cầu kéo GitHub của bạn sử dụng các từ khóa liên quan đến việc đóng hoặc hoàn thành nhiệm vụ, nhiệm vụ Notion sẽ được đánh dấu là hoàn tất khi yêu cầu kéo được hợp nhất.

Nếu mô tả yêu cầu kéo GitHub của bạn sử dụng các từ khóa liên quan đến việc tham chiếu hoặc liên quan đến một nhiệm vụ, nhiệm vụ Notion sẽ không được đánh dấu là hoàn tất khi yêu cầu kéo được hợp nhất.

Bạn có thể liên kết các nhiệm vụ Notion dưới dạng chỉ tham chiếu, để các nhiệm vụ đó sẽ không bị đánh dấu là hoàn tất.

Để ngắt kết nối GitHub khỏi Notion, bạn cần phải là chủ sở hữu không gian làm việc Notion.

1. Đi tới Settings.

2. Chọn kết nối.

3. Bên cạnh GitHub, hãy chọn ••• → Ngắt kết nối tất cả người dùng.

Khi bạn ngắt kết nối GitHub khỏi Notion, sẽ không ai trong không gian làm việc của bạn có thể sử dụng kết nối này cho đến khi nó được thiết lập lại.