Instruction-Notes-Public

« Quay về trang chủ

Lưu trữ ghi chép trên Obsidian với Git

Git

1. Git là gì ?

Git là một hệ thống quản lý phiên bản phân tán. Nó cung cấp cho mỗi lập trình viên/dự án các kho lưu trữ (repository) riêng chứa toàn bộ lịch sử thay đổi của các tệp. Mỗi khi bạn “commit”, Git sẽ “chụp” các tệp và tạo một snapshot cùng một tham chiếu tới snapshot đó. Để việc lưu trữ hiệu quả, nếu các tệp không thay đổi, Git sẽ không lưu trữ tệp — thay vào đó chỉ là một liên kết/tham chiếu đến phiên bản gần nhất nhận sự thay đổi. Với Git, các lập trình viên có thể cộng tác với nhau trên cùng bộ mã nguồn.

2. Các dịch vụ dựa trên Git hiện có:

Lưu trữ ghi chép trên Obsidian với Git-GitHub

Một nhược điểm của Obsidian là tính năng lưu trữ và đồng bộ trực tuyến bị tính phí. Tuy nhiên, vấn đề này có thể được khắc phục bằng cách sử dụng kho lưu trữ thuộc bên thứ ba.

Vì Obsidian sử dụng ngôn ngữ Markdown để đánh dấu hiển thị, các mã nguồn Markdown này có thể được lưu trữ trên các kho Git. Bài viết này chọn GitHub làm dịch vụ để lưu trữ các tài liệu Obsidian. Bạn có thể dùng GitHub Desktop với giao diện đồ họa dễ sử dụng (nếu không quen với việc thiết lập phức tạp và xử lý dòng lệnh), hoặc sử dụng giao diện dòng lệnh Git độc lập. Tuy nhiên, để việc tích hợp mã nguồn trở nên tiện hơn, bạn có thể sử dụng plugin Git để tương tác trực tiếp với kho Git ngay trong quá trình làm việc trên Obsidian. Bài viết này hướng dẫn các bạn thực hiện điều đó

1. Trên GitHub

1.1 - Tạo repo trên GitHub

1.2 - Tạo token truy cập

  1. Nhấn vào ảnh đại diện tài khoản người dùng (góc trên cùng bên phải), vào Settings > Development Settings > Personal Access Tokens > (Khuyến khích) Fine-grained Tokens và chọn Generate New Token

  1. Nhập tên, chọn thời điểm hết hạn và chủ sở hữu tài nguyên (Resource owner).
  2. Tại mục Repository access, chọn phạm vi các repo bạn muốn token truy cập vào.
  3. Tại mục Permissions, chọn các giới hạn truy cập cho các thao tác khác nhau đối với kho mã nguồn và đối với tài khoản, trong phạm vi các repo markdown, khuyến khích không cấp quyền tác động vào tài khoản cho token. Bạn có thể tham khảo các quyền cho repo như gợi ý dưới đây hoặc tự điều chỉnh theo ý bạn:
    • Cho phép truy cập: codespaces metadata, discussions, metadata, security events, actions, administration, code, codespaces, commit statuses, deployments, environments, pull requests, repository custom properties, repository hooks, workflows
    • Cấm truy cập các thành phần còn lại (mặc định)
  4. Kéo xuống dưới cùng và chọn Generate Token
  5. Sao chép và lưu lại token ở một nơi an toàn, tránh làm mất vì token sẽ không hiển thị lại trên GitHub bất kỳ lần nào.

2. Trên máy tính

Cài đặt bản Git tương thích với hệ thống của bạn.

Lưu ý: Trên Windows, Obsidian sẽ gặp lỗi với đường dẫn thư mục nếu bạn sử dụng các bản Git được cung cấp qua trình quản lý gói Pacman cho môi trường MSYS2. Do đó, CHỈ sử dụng bản git được phân phối trên git-scm.com.

3. Trên Obsidian

Vì Git không phải một plugin được cung cấp chính thức bởi Obsidian, bạn cần tắt Restricted Mode trước khi cài đặt. Để cho phép sử dụng plugin không chính thức, vào cấu hình, chọn thẻ Community plugins, chọn Turn on community plugins.

Sau khi bật, giao diện mục này sẽ thay đổi, chọn Community Plugins > Browse:

Tìm và cài đặt Git như hình dưới, sau đó chọn Enable để bật plugin.

Tạo thư mục trống và mở trong Obsidian. Mở khung các lệnh (bằng biểu tượng màn hình dòng lệnh bên thanh trái của giao diện Obsidian hoặc phím tắt Ctrl + P) và nhập Clone an existing remote repo.

Nhập vào khung đầu tiên liên kết đến kho Git đã tạo. Liên kết có dạng:

https://<Token đã tạo ở bước trên>@github.com/<username>/<repo>.git

Nhập tên thư mục hiện tại vào khung tiếp theo. Tại khung thứ 3, hãy để trống, Git sẽ mặc định sao chép mọi nhánh (branch) của mã nguồn về thư mục hiện hành.

Sau khi kéo về xong, khởi động lại Obsidian. Giờ thì bạn đã có thể sử dụng Obsidian để ghi chú nội dung.

Chúc các bạn thành công !

*Bài viết được soạn trên Obsidian