Xuất bản bài viết lên Confluence
Kết nối Confluence Cloud và xuất bản các bài viết Clevera thành các trang trong một không gian, kèm theo ảnh chụp màn hình được đính kèm vào trang. Các quyền cần cấp, cách các bảng và bước chuyển đổi, cách cập nhật giữ lại lịch sử trang và các lỗi thường gặp.
Xuất bản một bài viết Clevera thành một trang Confluence trong không gian bạn chọn. Ảnh chụp màn hình được đính kèm vào trang, và việc xuất bản lại có thể cập nhật cùng một trang đó để lịch sử và bình luận của trang được giữ nguyên.
Trước khi bạn bắt đầu
- Trong Clevera: không gian làm việc đang ở gói Pro hoặc Tùy chỉnh, và bạn là chủ sở hữu hoặc quản trị viên để kết nối Confluence. Sau khi đã kết nối, bất kỳ ai có quyền chỉnh sửa bài viết đều có thể xuất bản bài viết đó. Xem Xuất bản bài viết lên các công cụ khác của bạn.
- Trong Confluence: Confluence Cloud (một trang
example.atlassian.net), bất kỳ gói nào. Confluence Server và Data Center không được hỗ trợ. - Quyền: tài khoản Atlassian mà bạn kết nối cần được cho phép thêm trang và thêm tệp đính kèm trong các không gian mà bạn xuất bản lên. Các trang được tạo dưới tên người đó.
- Một bài viết: hãy tạo nó trước. Việc xuất bản chỉ gửi bài viết. Để bao gồm video, hãy đặt nó vào trong bài viết; xem Hiển thị video trong bài viết.
Kết nối Confluence
Bắt đầu từ Tích hợp
Trong Clevera, nhấp vào tên không gian làm việc của bạn trong thanh bên, chọn Tích hợp, tìm Confluence và nhấp vào Kết nối.
Xem lại các quyền
Atlassian hiển thị yêu cầu từ Clevera. Clevera yêu cầu:
Quyền Lý do Xem hồ sơ của bạn Để hiển thị tài khoản nào đang được kết nối Đọc các không gian Để liệt kê các không gian bạn có thể xuất bản lên Đọc trang và chi tiết trang Để tìm một trang có cùng tiêu đề trước khi xuất bản Tạo và cập nhật trang Để xuất bản và cập nhật trang Thêm tệp đính kèm Để tải ảnh chụp màn hình của bài viết lên trang Giữ quyền truy cập khi bạn không sử dụng ứng dụng Để việc xuất bản tiếp tục hoạt động mà không cần đăng nhập mỗi lần Chọn trang web và chấp nhận
Nếu tài khoản của bạn có nhiều trang web Atlassian, hãy chọn đúng trang web trong menu trang web trên cùng màn hình, sau đó nhấp vào Chấp nhận. Bạn sẽ quay lại Tích hợp với thông báo "Confluence đã được kết nối thành công với Acme Inc.!" (tên trang web của bạn).
Thông tin đăng nhập Atlassian sẽ hết hạn sau một thời gian; Clevera tự động gia hạn chúng ở chế độ nền, vì vậy bạn không cần kết nối lại trừ khi có ai đó xóa quyền truy cập của Clevera.
Xuất bản bài viết lên Confluence
Mở tab Xuất bản
Trong trình chỉnh sửa, nhấp vào Chia sẻ → Xuất bản và nhấp vào ô Confluence bên dưới mục Sẵn sàng xuất bản.
Chọn một không gian
Bên dưới mục Nơi lưu trữ, danh sách hiển thị các không gian mà tài khoản của bạn có thể thấy (các không gian đã lưu trữ sẽ bị ẩn). Trang được tạo ở cấp cao nhất của không gian; bạn có thể di chuyển nó vào dưới một trang khác trong Confluence sau đó nếu muốn.
Trang được tạo ở cấp cao nhất của không gian. Xuất bản
Nhấp vào Xuất bản lên Confluence. Clevera sẽ tìm kiếm bản sao hiện có trước; nếu một trang có cùng tiêu đề đã tồn tại trong không gian, hãy chọn việc cần làm (xem Cập nhật trang bạn đã xuất bản). Sau đó, nó sẽ tạo trang, tải lên các ảnh chụp màn hình (Đang tải tệp 2 trên 5) và viết nội dung trang.
Khi hoàn tất, bạn sẽ thấy thông báo "Đã xuất bản lên Confluence." Nhấp vào Mở trong Confluence để xem trang. Bạn có thể đóng cửa sổ Chia sẻ trong khi quá trình đang chạy; một thông báo sẽ cho bạn biết khi hoàn tất.
Trang trông như thế nào trong Confluence
Tiêu đề trang là tiêu đề của bài viết. Trang chỉ chứa bài viết: video mà bài viết lấy từ đó sẽ không được thêm vào.
| Trong Clevera | Trong Confluence |
|---|---|
| Tiêu đề 1–6 | Tiêu đề 1–6 |
| Đậm, nghiêng, gạch ngang, gạch chân, mã nội dòng, liên kết | Được giữ nguyên. Các liên kết đến các trang Clevera khác chỉ giữ lại văn bản. |
| Nổi bật, chỉ số trên, chỉ số dưới | Được giữ nguyên |
| Danh sách có dấu đầu dòng và đánh số | Danh sách, phân cấp và số bắt đầu được giữ nguyên |
| Danh sách kiểm tra | Danh sách công việc, các mục đã chọn vẫn được chọn |
| Trích dẫn | Trích dẫn |
| Khối mã | Khối mã với ngôn ngữ được thiết lập; tiêu đề mã trở thành một dòng đậm phía trên |
| Phương trình | Mã |
| Dấu phân cách | Dấu phân cách |
| Bảng | Bảng với hàng tiêu đề và căn chỉnh cột |
| Chú thích | Bảng điều khiển với tiêu đề chú thích in đậm (xem bên dưới) |
| Các bước đánh số | Danh sách đánh số: tiêu đề của mỗi bước in đậm, nội dung của nó nằm bên dưới |
| Tab | Một tiêu đề cho mỗi tab, theo sau là nội dung của nó |
| Phần có thể thu gọn | Khối mở rộng |
| Thẻ | Danh sách có dấu đầu dòng: tiêu đề được liên kết in đậm, sau đó là mô tả. Các biểu tượng thẻ bị bỏ qua. |
| Ảnh chụp màn hình | Hình ảnh được đính kèm vào trang, với chú thích bên dưới; căn chỉnh và chiều rộng được giữ nguyên |
| Video YouTube hoặc Clevera trong bài viết | Trình phát trong trang. Video Clevera chỉ được bao gồm khi liên kết chia sẻ của video đó được bật. |
| Tệp video trong bài viết | Một liên kết với tiêu đề của nó |
Các chú thích trở thành bảng điều khiển Confluence. Một trang có ảnh chụp màn hình hoặc video Clevera được viết theo định dạng trang Confluence khác, có ít loại bảng điều khiển hơn, vì vậy một số chú thích được ánh xạ sang loại tương đương:
| Chú thích | Trang không có ảnh chụp màn hình | Trang có ảnh chụp màn hình hoặc video Clevera |
|---|---|---|
| Thông tin | Thông tin | Thông tin |
| Ghi chú | Ghi chú | Thông tin |
| Mẹo | Mẹo | Mẹo |
| Thành công | Thành công | Mẹo |
| Cảnh báo | Cảnh báo | Ghi chú (vàng) |
| Nguy hiểm | Lỗi | Cảnh báo (đỏ) |
Ảnh chụp màn hình
Mỗi ảnh chụp màn hình được tải lên dưới dạng tệp đính kèm có tên như clevera-article-image-1234.png, với bình luận "Được tải lên bởi Clevera để xuất bản bài viết". Việc xuất bản lại sẽ thêm một phiên bản mới của cùng tệp đính kèm đó thay vì tạo tệp trùng lặp.
Nếu Confluence không cho phép Clevera đính kèm tệp (ví dụ: kết nối được thực hiện trước khi hỗ trợ tệp đính kèm, hoặc không có quyền đính kèm trong không gian), quá trình xuất bản sẽ dừng lại với thông báo "Không thể đính kèm hình ảnh của bài viết vào trang Confluence" cùng lý do, và trang trống sẽ được chuyển vào thùng rác. Hãy kết nối lại Confluence hoặc yêu cầu quản trị viên không gian cấp quyền đính kèm.
Cập nhật trang bạn đã xuất bản
Việc xuất bản chỉ diễn ra một chiều. Trang Confluence không tự động cập nhật khi bạn chỉnh sửa bài viết trong Clevera, và các chỉnh sửa thực hiện trong Confluence không bao giờ quay lại Clevera. Sau khi bạn chỉnh sửa bài viết, hãy xuất bản lại nó vào cùng không gian đó. Clevera sẽ tìm trang có cùng tiêu đề (không phân biệt chữ hoa chữ thường) và hiển thị "Bài viết này đã có trong Confluence."
- Cập nhật bài viết hiện có sẽ cập nhật cùng một trang: cùng địa chỉ, một phiên bản mới trong lịch sử trang, các bình luận được giữ nguyên. Các thay đổi thực hiện trong Confluence sau đó sẽ bị ghi đè; hãy khôi phục chúng từ Lịch sử trang nếu cần. Nhấp vào Cập nhật trong Confluence.
- Tạo bài viết mới sẽ tạo trang thứ hai dưới Tiêu đề mới mà bạn nhập. Confluence không cho phép hai trang có cùng tiêu đề trong một không gian, vì vậy tiêu đề mới phải khác biệt. Nhấp vào Tạo bài viết mới.
Ngắt kết nối và thu hồi quyền truy cập
- Trong Clevera, mở Tích hợp, nhấp vào Confluence, sau đó chọn Ngắt kết nối và xác nhận. Các trang bạn đã xuất bản vẫn sẽ tồn tại trong Confluence.
- Để xóa Clevera khỏi tài khoản Atlassian của bạn, hãy truy cập
id.atlassian.com, mở Cài đặt tài khoản → Ứng dụng đã kết nối, tìm Clevera và chọn Xóa quyền truy cập.
Giới hạn
| Giới hạn | Giá trị |
|---|---|
| Không gian được liệt kê trong bộ chọn | Lên đến 2.000 |
| Nơi trang được lưu trữ | Cấp cao nhất của không gian |
| Kích thước trang | 5 MB nội dung trang |
| Trang web | Một trang web Confluence cho mỗi không gian làm việc Clevera |
| Cùng tiêu đề trong một không gian | Không được Confluence cho phép; hãy cập nhật hoặc đổi tên |
Khắc phục sự cố
| Bạn thấy | Việc cần làm |
|---|---|
| "No Confluence sites found. Please grant access to at least one site." | Bạn chưa chọn trang web trên màn hình của Atlassian, hoặc tài khoản của bạn không có trang Confluence Cloud nào. Hãy Kết nối lại và chọn một trang web. |
| "Failed to get Confluence sites." hoặc "Failed to connect to Confluence. Please try again." | Nhấp vào Kết nối lần nữa. |
| "Connection failed: …" hoặc "Failed to connect to Confluence: …" | Bạn đã hủy trên màn hình của Atlassian hoặc bị từ chối. Hãy Kết nối lại. |
| "Please select a space to publish to." | Hãy chọn một không gian (space) trong danh sách trước. |
| "Invalid space ID. Please try selecting the space again." | Không gian đó đã bị đổi tên, lưu trữ hoặc xóa. Hãy mở lại tab Xuất bản và chọn lại. |
| Một không gian bị thiếu | Tài khoản của bạn không thể thấy không gian đó, hoặc nó đã bị lưu trữ. |
| Một thông báo kết thúc bằng "Confluence did not allow it. Check your permissions in this space, or reconnect Confluence." | Tài khoản của bạn không thể thêm trang hoặc tệp đính kèm vào không gian đó. Hãy hỏi quản trị viên không gian, hoặc Kết nối lại. |
| Một thông báo kết thúc bằng "the space or page was not found, or you cannot see it." | Trang bạn cố gắng cập nhật đã bị xóa hoặc di chuyển ra ngoài phạm vi truy cập của bạn. Hãy chọn Create a new article. |
| "This article is too large for one Confluence page (over 5 MB)." | Hãy chia bài viết thành hai phần. |
| "Confluence is rate limiting requests. Please wait a moment and try again." | Hãy đợi một phút, sau đó nhấp vào Thử lại. |
| "Failed to update page in Confluence. Please try again." | Có thể ai đó đã chỉnh sửa trang cùng lúc với bạn. Nhấp vào Thử lại. |
| "Authentication failed. Please reconnect your account." hoặc "No refresh token available. Please reconnect your Confluence account." | Nhấp vào Kết nối lại. |
| "Failed to publish to Confluence. Please try again." | Nhấp vào Thử lại. Nếu vẫn tiếp tục lỗi, hãy Kết nối lại. |
| Video trong trang hiển thị lỗi | Trang web của bạn không thể hiển thị các khung nhúng. Hãy xóa khung đó và dán liên kết chia sẻ của video vào một dòng riêng; Confluence sẽ tự động chuyển nó thành bản xem trước. |