• Relate: [[Tutorial]] [[Note-taking]]

Mình đã nghe nói tới việc thiết lập một static site với Github Page và Jekyll nhưng lần nọ loay hoay thử không thành công nên đành tạm bỏ ngang không đụng tới nữa. Cho tới hôm nay xem lại bài viết từng đăng trên Blog về các ứng dụng ghi chú và rồi lại lần mò tìm tới keyword “Digital Garden” thì tìm thấy một nguồn tham khảo khá thú vị và hữu ích với chủ đề Digital Gardener. Bắt tay vào làm thử và thành công ngoài mong đợi vì thực chất các khâu thực hiện không hề phức tạp. Kể ra phần tốn thời gian nhất chính là cài đặt Jekyll, đã thực hiện lần trước.

Đồ chơi cần thiết

Tên Tham chiếu Mô tả
Cài đặt Jekyll Jekyll Cài đặt Jekyll phù hợp cho máy tính của bạn. Ở đây mình dùng macOS
Jekyll Garden Jekyll Garden Github repo dùng để copy cấu hình cho Digital Garden sử dụng Jekyll theme. Xem phần How to
Github Desktop Github Desktop Sử dụng để đồng bộ dữ liệu qua lại giữa Github và máy tính cho repo dùng làm Digital Garden
Visual Studio Code VS Code Cài đặt code editor cơ bản để chỉnh sửa các file trong repo cho thuận tiện
Obsidian Obsidian Cài đặt Obsidian làm ứng dụng ghi chú

Thiết lập

Thiết lập cơ bản

  • Xem kỹ phần hướng dẫn nhắc đến ở mục Jekyll Garden
  • Có thể xem cách thiết lập của repo từ template hoặc chính repo của github site này tại https://github.com/thinh-vu/thinh-vu.github.io

    Tuỳ chỉnh

    Cấu hình chung

Các thiết lập chung có thể được tuỳ chỉnh trong file _config.yml, trong đó có 1 số mục cần quan tâm:

  • Mô tả trang & copyright

    Thanh menu

    Tìm và chỉnh sửa file Nav.html, có thể xoá các menu không phù hợp hoặc bổ sung theo ý

Cài đặt tracking

  • Sử dụng Google Tag Manager là công cụ duy nhất để quản lý các công cụ theo dõi hiệu năng website. Mặc định theme Jekyll-Garden không có thẻ <head></head><body></body> nên cần thêm vào để có thể đặt mã theo dõi của GTM theo yêu cầu.

  • Cài đặt Google Analytics vào GTM để theo dõi các thông tin cơ bản về lưu lượng truy cập

    Lưu ý khi sử dụng

    Định dạng markdown được hỗ trợ bởi Jekyll sẽ có một số điểm khác biệt so với tuỳ chọn mặc định của Obsidian. Vì vậy, điều quan trọng là nắm được những khác biệt này và thiết lập cấu hình Obsidian để phù hợp với định dạng được hỗ trợ. Cần lưu ý một số điểm sau:

  • Sử dụng Relative path to file để đảm bảo hình và file đính kèm có thể hiển thị đúng
  • Tắt chế độ Use [[Wikilinks]] mặc định để đảm bảo file đính kèm sẽ được sử dụng Relative file path

Soạn thảo ghi chú

  • Ẩn các ghi chú dạng danh mục, chỉ dùng cho mục đích đặt backlink đến các ghi chú khác khỏi feed ghi chú. Đặt giá trị hide vào mục feed trong YAML meta.