Bỏ qua để đến nội dung chính

Cài đặt

💡TL;DR
Cài Notemd từ Community plugins, hoặc chép ba tệp tiện ích thuộc cùng một bản phát hành GitHub vào kho ghi chú. Bật tiện ích, cấu hình nhà cung cấp và thử trên một ghi chú dùng để kiểm tra. Máy chủ mô hình và công cụ xuất gốc có yêu cầu riêng.

Cách 1: Tiện ích cộng đồng (khuyên dùng)​

  1. Mở Settings → Community plugins trong đúng kho ghi chú.
  2. Cho phép tiện ích cộng đồng nếu cần, rồi chọn Browse.
  3. Tìm Notemd, kiểm tra kho mã là Jacobinwwey/obsidian-NotEMD, rồi chọn Install.
  4. Chọn Enable. Mở thanh bên Notemd bằng biểu tượng trên thanh công cụ hoặc bảng lệnh.

Mở Notemd trong Obsidian. Nếu trình duyệt không mở được liên kết, dùng các bước ở trên. Bạn không cần bộ xử lý giao thức riêng để đọc hướng dẫn này.

Cách 2: Cài thủ công​

Điều kiện cần​

Cần có ứng dụng Obsidian và một kho ghi chú có thể sao lưu. Manifest khai báo phiên bản Obsidian tối thiểu là 0.15.0; khai báo này không chứng minh ứng viên phát hành hiện tại đã được thử trên phiên bản cũ đó.

Các bước​

  1. Mở GitHub Releases và tải main.js, manifest.json, styles.css từ cùng một bản phát hành. README.md đi kèm để tham khảo, không phải tệp bắt buộc khi chạy tiện ích.
  2. Tạo <vault>/.obsidian/plugins/notemd/ rồi chép ba tệp vào đó. .obsidian là thư mục cấu hình mặc định; dùng thư mục thực tế nếu kho của bạn đã đổi vị trí này.
  3. Tải lại Obsidian, mở Community plugins và bật Notemd.
  4. Kiểm tra phiên bản hiển thị trước khi cấu hình nhà cung cấp. Không ghép manifest mới với mã chạy cũ.

Cách khác: Cài qua BRAT​

Nếu đã dùng BRAT, thêm Jacobinwwey/obsidian-NotEMD bằng quy trình cài tiện ích beta của BRAT. Chọn bản phát hành cụ thể khi tái hiện lỗi. BRAT là công cụ bên ngoài tùy chọn, không phải phụ thuộc của cách cài thông thường.

Kiểm tra sau cài đặt​

Mở cài đặt Notemd, chọn nhà cung cấp và mô hình bạn có quyền dùng, rồi chạy Kiểm tra kết nối. Tiếp tục với hướng dẫn bắt đầu trên một bản sao ghi chú. Một số phép thử kết nối chỉ xác nhận điểm cuối liệt kê mô hình truy cập được; tác vụ thực tế mới kiểm tra việc sinh nội dung và lưu kết quả.

Yêu cầu hệ thống​

Thành phầnPhạm vi
Manifest tiện íchKhai báo Obsidian tối thiểu 0.15.0; isDesktopOnly là false
Bằng chứng kiểm thửXem biên bản nghiệm thu có ngày của bản phát hành; thiết bị di động thực và Obsidian 0.15.0 hiện chưa được xác minh
Mô hình trên đám mâyKết nối mạng, tài khoản/khóa được cấp quyền và mô hình được hỗ trợ
Mô hình cục bộMáy chủ cài riêng đang chạy, cùng mô hình đã tải hoặc nạp
Xuất slide / mạch bằng công cụ gốcCông cụ máy tính và phụ thuộc theo định dạng; kiểm tra môi trường xuất trước khi chạy

Không có cam kết chung về phiên bản hệ điều hành cho mọi công cụ xuất tùy chọn. Xem trước mạch trong Notemd không chứng minh biên dịch TeX gốc thành công; kiểm thử trên máy tính cũng không chứng minh hoạt động trên di động.

Gỡ cài đặt​

Tắt hoặc gỡ Notemd trong Community plugins. Ghi chú và sản phẩm đã tạo vẫn là các tệp thông thường trong kho; hãy xem lại trước khi xóa. Sao lưu cài đặt tiện ích nếu định cài lại. Gỡ tiện ích không hoàn tác những chỉnh sửa ghi chú đã hoàn thành.

Cập nhật​

Chọn Check for updates trong Community plugins rồi cập nhật Notemd. Nếu cập nhật thủ công, dừng tác vụ Notemd đang chạy, sao lưu kho và cài đặt, thay ba tệp chạy bằng tệp cùng bản phát hành rồi tải lại. Đọc ghi chú phát hành và thử một tác vụ nhỏ trước khi chạy theo thư mục.

Không thay tệp cài đặt của kho bằng tài sản phát hành. Khi cần quay lại bản cũ, giữ bản sao lưu và chủ động cài một phiên bản đã biết là tương thích; giữ lại các kết quả bạn còn cần.

Tiếp theo​