Thẻ tài liệu và thẻ trình duyệt

Các thẻ ở khung giữa không chỉ là terminal. Chương này trình bày hai loại thẻ khác: thẻ tài liệu (trình soạn thảo Markdown và mã nguồn tích hợp) và thẻ trình duyệt (trang web nhúng). Hai loại thẻ này dùng chung thanh thẻ với thẻ phiên, và việc mở một phiên không bao giờ thay thế chúng.

1. Thẻ tài liệu

1.1 Cách mở

Thẻ tài liệu được mở khi bạn:

• chạy vopen <file> trong bất kỳ phiên nào (trong Claude Code, kỹ năng /vopen có tác dụng tương tự sau khi cài “Kỹ năng Vela” trong Cài đặt ▸ Chung);
• nhấp đúp vào một tệp trong thẻ Files của bảng bên phải, hoặc chọn “Mở trong trình soạn thảo”;
• mở một ghi chú từ kho kiến thức (xem Cơ sở tri thức cục bộ);
• nhấp “Tài liệu mới” ở đầu bên phải của thanh thẻ.

Cách hiển thị được chọn theo loại tệp:

1.2 Trình soạn thảo Markdown

• Trực quan là trình soạn thảo trực quan, hiển thị đúng như kết quả. Gõ / để mở menu chèn (tiêu đề, danh sách, danh sách việc cần làm, trích dẫn, khối mã, bảng, công thức toán, hình ảnh và đường phân cách). Các khối mã mermaid có rào được hiển thị thành sơ đồ bên dưới khối mã.
• Mã nguồn hiển thị văn bản của tệp đúng như khi được lưu, kể cả phần YAML front matter nếu có, với tô sáng cú pháp Markdown.
• Đối chiếu hiển thị Trực quan và Mã nguồn cạnh nhau, đồng thời giữ hai bên đồng bộ khi bạn chỉnh sửa ở bên nào.
• ⌘/ (Ctrl+/ trên Windows và Linux) chuyển giữa Trực quan và Mã nguồn. Chuyển chế độ mà không chỉnh sửa sẽ không làm thay đổi tệp.
• Dán hoặc kéo thả một ảnh vào tài liệu đã lưu sẽ lưu ảnh vào thư mục assets nằm cạnh tài liệu và chèn một liên kết tương đối tới ảnh đó.

1.3 Chỉnh sửa và lưu

• ⌘S hoặc nút “Lưu” ghi tệp xuống ổ đĩa. Dấu chấm trên thẻ cho biết có thay đổi chưa lưu.
• Tài liệu đang mở được kiểm tra trên ổ đĩa hai giây một lần. Nếu một chương trình khác thay đổi tệp, một biểu ngữ sẽ đưa ra “Tải lại” và “Bỏ qua”; khi bạn cũng có chỉnh sửa chưa lưu, nút tải lại sẽ hiển thị “Tải lại (hủy thay đổi của tôi)”. Nếu tệp trên ổ đĩa đã thay đổi sau khi bạn bắt đầu chỉnh sửa, thao tác lưu sẽ yêu cầu xác nhận trong hộp thoại “Xung đột khi lưu” trước khi ghi đè tệp.
• Khi đóng một thẻ có thay đổi chưa lưu, bạn sẽ được hỏi để chọn “Lưu và đóng”, “Đóng mà không lưu” hoặc “Hủy”.
• ⌘F mở thanh tìm kiếm với các chức năng tìm, thay thế, thay thế tất cả và “Phân biệt hoa thường”; thanh tìm kiếm hoạt động như nhau ở mọi chế độ.
• Nút “Thanh bên” hiển thị “Dàn ý” của tài liệu và “Cây tệp” của thư mục chứa tài liệu; nhấp vào một tệp ở đó để mở tệp. Có thể thay đổi độ rộng của thanh bên.
• Tệp lớn hơn 10 MB được mở ở chế độ chỉ đọc và chỉ hiển thị 10 MB đầu tiên, để thao tác lưu không thể cắt mất phần còn lại của tệp.
• Nhấp chuột phải vào thẻ tài liệu sẽ có “Làm mới tệp” và, với Markdown, “Xuất PDF”, bên cạnh các thao tác đóng thông thường.

1.4 Tài liệu mới và xuất PDF

• “Tài liệu mới” mở một bản nháp trống chưa có trên ổ đĩa và không xuất hiện trong cây dự án. Lần lưu đầu tiên sẽ hỏi nơi lưu: ứng dụng máy tính dùng hộp thoại Lưu thành của hệ thống, còn máy khách trình duyệt và cửa sổ kết nối từ xa hiển thị hộp thoại Lưu thành cho máy đang chạy phiên. Tô sáng cú pháp thay đổi theo tên tệp được chọn. Nhấp chuột phải vào thẻ của bản nháp cũng có mục “Lưu vào ổ đĩa…”.
• “Xuất PDF” chuyển một tài liệu Markdown thành tệp PDF dạng vector, tự động ngắt trang và nhúng phông chữ CJK. Ứng dụng máy tính sẽ hỏi nơi lưu tệp; máy khách trình duyệt thì tải tệp xuống.

2. Thẻ trình duyệt (chỉ có trong ứng dụng máy tính)

Thẻ trình duyệt hiển thị trang web thực bên trong VelaTerm, giúp bạn đặt tài liệu tham khảo, trang theo dõi lỗi hoặc bản xem trước cục bộ ngay cạnh các phiên. Thẻ trình duyệt chỉ có trong ứng dụng máy tính, không có trong máy khách trình duyệt, cửa sổ kết nối từ xa hay bố cục di động.

Cách mở thẻ trình duyệt:

• nút “Trình duyệt tích hợp” ở đầu bên phải của thanh thẻ;
• phím tắt ⌘⇧B;
• vopen <URL> trong một phiên;
• “Trang trình duyệt mới” trong menu ngữ cảnh của dự án hoặc nhóm trên thanh bên.

Thanh công cụ: “Quay lại”, “Tiến tới”, “Tải lại” (hoặc “Dừng tải” khi trang đang tải), thanh địa chỉ (“Nhập URL hoặc từ khóa tìm kiếm”; văn bản không phải địa chỉ sẽ được tìm kiếm trên Google), “Mở trong trình duyệt hệ thống” và hàng “Truy cập nhanh” với ChatGPT, Claude, Gemini và Google.

Hai hình thức:

• Thẻ trình duyệt: mở bằng nút, ⌘⇧B hoặc vopen <URL>. Thẻ này không được lưu trong cây dự án và không còn sau khi khởi động lại.
• Nút trang trình duyệt: tạo bằng “Trang trình duyệt mới”. Đây là một nút trong cây dự án, ghi nhớ địa chỉ của trang và vẫn còn sau khi khởi động lại.

Liên kết mở cửa sổ mới: khi một trang mở liên kết trong cửa sổ mới (ví dụ liên kết target="_blank"), VelaTerm mở liên kết đó trong một thẻ trình duyệt mới.

Trang độc lập: nút “Trung tâm trò chơi” ở đầu bên phải của thanh thẻ mở trung tâm trò chơi của VelaTerm dưới dạng trang độc lập. Trang độc lập không có thanh địa chỉ hay hàng truy cập nhanh, chỉ có “Quay lại”, “Tiến tới” và “Tải lại”; các liên kết mà trang mở vẫn nằm trong cùng thẻ.

Ranh giới bảo mật: trang nhúng được xem như một trang web bên ngoài thông thường. Trang không nhận bất kỳ quyền hay thông tin xác thực nào của VelaTerm, và chỉ có thể mở địa chỉ http và https.

3. Cách các loại thẻ hoạt động cùng nhau

• Thẻ phiên, thẻ tài liệu và thẻ trình duyệt dùng chung một thanh thẻ, và ⌘1–9 chuyển qua lại giữa tất cả các thẻ đó.
• Mở một phiên từ cây chỉ dùng lại thẻ phiên; thẻ tài liệu và thẻ trình duyệt không bao giờ bị thay thế.
• Không thể chia khung thẻ tài liệu và thẻ trình duyệt. ⌘W đóng trực tiếp các thẻ này (tài liệu có thay đổi chưa lưu sẽ hỏi trước).