Skip to main content
On this page

Trang nhật ký cập nhật

Theme TanaFlows tích hợp sẵn giao diện dòng thời gian Timeline Layout (timeline-layout.hbs) chuyên nghiệp, rất phù hợp để làm trang Nhật ký cập nhật sản phẩm (Changelog), lộ trình phát triển (Roadmap) hoặc danh sách bản tin (Newsletter).

Để tạo trang Changelog dạng Timeline, bạn cần thực hiện cấu hình định tuyến trong file routes.yaml của Ghost và thiết lập các trang trong Ghost Admin theo 3 bước hướng dẫn dưới đây.

Bước 1: Khai báo định tuyến trong routes.yaml

Bạn cần cấu hình để Ghost hiểu đường dẫn /changelog/ sẽ gom các bài viết có tag #changelog và render ra giao diện timeline.

  1. Vào Ghost Admin > Settings > Labs.

  2. Tìm phần Routes và bấm nút Download current routes.yaml để tải file định tuyến hiện tại về máy tính.

  3. Mở file routes.yaml bằng một phần mềm soạn thảo văn bản (như Notepad, VS Code) và thêm đoạn cấu hình dưới đây vào mục collections::

    collections:
      /changelog/:
        permalink: /changelog/{slug}/
        template: timeline-layout
        order: published_at desc
        filter: tag:[hash-changelog]
        data: page.changelog

    Ý nghĩa của cấu hình này:

    • /changelog/: Trang danh sách dòng thời gian sẽ nằm ở đường dẫn yourdomain.com/changelog/.
    • template: timeline-layout: Sử dụng tệp giao diện timeline của theme (timeline-layout.hbs).
    • filter: tag:[hash-changelog]: Chỉ hiển thị các bài viết có gắn tag nội bộ #changelog (trong tệp YAML, tag nội bộ bắt đầu bằng # được ký hiệu là hash-).
    • data: page.changelog: Lấy thông tin tiêu đề và mô tả của Trang đơn (Page) có slug là changelog để hiển thị ở phần đầu trang Changelog.

  4. Lưu file lại và tải ngược (Upload) file routes.yaml lên lại mục Routes của Ghost.

Bước 2: Tạo trang giới thiệu (Changelog Hub)

Đây là trang chứa tiêu đề lớn và phần mô tả ngắn giới thiệu về changelog hiển thị ở đầu dòng thời gian.

  1. Vào Ghost Admin > Pages > bấm New Page.
  2. Đặt tiêu đề cho trang (Ví dụ: Changelog hoặc Nhật ký cập nhật).
  3. Mở cài đặt trang (biểu tượng bánh răng góc trên bên phải):
    • Đặt Page URL (Slug) là: changelog (để đồng bộ với khai báo data: page.changelog ở Bước 1).
    • Điền dòng giới thiệu ngắn vào ô Excerpt (Ví dụ: Xem các cập nhật, tính năng mới và cải tiến gần đây của TanaFlows.).
  4. Bấm Publish (Xuất bản) trang này.

Bước 3: Đăng các bản cập nhật Changelog

Mỗi khi bạn có một bản cập nhật mới cần đăng lên dòng thời gian:

  1. Vào Ghost Admin > Posts > bấm New Post.
  2. Đặt tiêu đề cho bản cập nhật (Ví dụ: Bản cập nhật v1.2.0: Tích hợp Smart Search).
  3. Soạn thảo nội dung chi tiết các thay đổi trong bài viết.
  4. Mở cài đặt bài viết (Post settings):
    • Trong ô Tags, nhập tag nội bộ: #changelog (Ghost sẽ tự động nhận diện tag này để đưa bài viết vào dòng thời gian).
    • (Tùy chọn) Thêm Feature Image (Ảnh đại diện) cho bài viết nếu bạn muốn hiển thị ảnh minh họa trực quan trên dòng thời gian.
    • Điền tóm tắt ngắn vào ô Excerpt để hiển thị nội dung tóm tắt trên trang danh sách timeline.
  5. Bấm Publish (Xuất bản) bài viết.

Kết quả và tính năng hiển thị

  • Dòng thời gian dọc (Vertical Timeline): Các bài viết cập nhật sẽ được xếp dọc theo đường chỉ tuyến thời gian đẹp mắt, bài viết mới nhất nằm ở trên cùng.
  • Nhãn Mới nhất (Latest Badge): Bài cập nhật mới nhất ở đầu dòng thời gian sẽ tự động có một nhãn màu nổi bật ghi Latest để gây sự chú ý.
  • Responsive tốt: Trên thiết bị di động, giao diện sẽ tự động chuyển đổi sang dạng một cột dọc gọn gàng để dễ theo dõi.
  • Phân trang thông minh: Tự động tích hợp nút Load more (Xem thêm) ở cuối trang danh sách nếu bạn đăng quá số lượng bài viết quy định trên một trang.