Tip&Trick

Heading

Có 7 loại heading. Trong đó 4 loại đầu dùng để làm navigator và 3 loại sau dùng để cấu trúc 1 đoạn văn

Sử dụng các phím tắt như:

Ctrl + 1 = Large Header ( tương đương level 1)
Ctrl + 2 = Medium Header (Level 2)
Ctrl + 3 = Small Header (Level 3)
Ctrl + 4 = Tiny Header (Level 4)

Copy dữ liệu từ Google Docs hoặc Google Sheet

Trực tiếp copy từ google docs hoặc google sheet sang Bookstack có thể gây lỗi về mặt format chữ và lưu trữ ảnh. Cách an toàn nhất là Download các tài liệu dưới dạng docx hoặc XLSX. Sau đó mở bằng Microsoft Office và copy các phần tương ứng lên bookstack => đảm bảo cấu trúc format và toàn bộ nội dung nằm trên bookstack.

Với các hình ảnh copy từ các trang web hoặc từ google docs thì bookstack sẽ chỉ lưu link gốc của ảnh đó => việc hiển thị có thể bị mất nếu nguồn dữ liệu của ảnh đã bị xoá. Tốt nhất là lưu file về máy rồi up lại lên bookstack để ảnh được lưu trong server của bookstack. Các ảnh dạng cắt màn hình, sau khi paste vào vào editor sẽ được lưu lên bookstack server

Sử dụng các diagram

Có 2 loại diagram chính được sử dụng trong bookstack là diagram.net (draw.io) và mermaidjs. Trong đó

Diagram.net dùng để vẽ các loại biểu đồ bằng cách kéo thả 1 diagram vào. và có thể trực tiếp chỉnh sửa diagram này. Bookstack sẽ lưu file diagram này trên server và hỗ trợ chỉnh sửa khi cần
MermaidJS hỗ trợ tạo các diagram dạng UML để viết các loại tài liệu thiết kế và tài liệu tích hợp. Việc vẽ biểu đồ của mermaid bằng cách sử dụng các đoạn script và gen ra biểu đồ tương ứng.