Đưa một tài liệu HTML lên web

Chỉ có một câu lệnh cần nhớ. Phần còn lại máy tự lo.

🚀 Làm thế nào

Gõ đúng một dòng này:

/UID_01_publish_html_doc  <đường dẫn tới file hoặc thư mục>

Ví dụ:

/UID_01_publish_html_doc  Library/C10_N8N_MQTT_PlayWright/Doc_html
/UID_01_publish_html_doc  Temp/bao_cao.html
Tài liệu cứ nằm nguyên chỗ của nó. Không phải chép đi đâu cả. Sửa file gốc là trang web đổi theo ngay.

📄 Đưa được những gì

Bạn đưaĐiều kiệnKết quả
Một file
bao_cao.html		đuôi .html HDID_00003_bao_cao.html
Một thư mục
Doc_html/		 bên trong phải có index.html HDID_00003_Doc_html/
các trang con bấm được bình thường

Muốn đặt tên đẹp hơn tên file: thêm --name Ten_Ban_Muon.

⚙️ Máy làm gì sau khi bạn gõ

  1. Kiểm traĐường dẫn có thật không, đã đưa lên lần nào chưa. Đưa lại cùng một tài liệu thì máy báo "đã có rồi" chứ không tạo bản trùng.
  2. Cấp mã HDIDSố tăng dần: HDID_00001, HDID_00002… Tài liệu cũ giữ nguyên mã của nó mãi mãi, nên link đã chia sẻ không bao giờ chết.
  3. Nối tài liệu vào webTài liệu nằm trong dự án thì chỉ tạo một "lối tắt" trong web server — không phải khởi động lại gì cả, có ngay lập tức. (Tài liệu để ngoài dự án là trường hợp hiếm, khi đó web server tài liệu khởi động lại vài giây; MQTT không liên quan.)
  4. Tự kiểm tra lạiMáy mở thử đúng đường link đó. Không lên được thì nó tự hoàn tác sạch sẽ và báo lỗi — không để lại trạng thái nửa vời.
  5. Báo link cho bạnXong. Mở link là đọc được.

📚 Đọc tài liệu ở đâu

Tất cả nằm ở một chỗ, có mục lục sẵn:

https://hdid.lotus1104.synology.me/

Mở link này là thấy danh sách mọi tài liệu đã đưa lên, bấm vào là đọc.

Đường dẫn dài cũ web.lotus1104.synology.me/share/02_Link/FID_00005_HTML_DOC/ vẫn chạy — link đã chia sẻ trước đây không chết.

🧰 Vài lệnh thỉnh thoảng cần

Muốn gìGõ
Xem đã đưa lên những gì… --list
Thử trước, chưa làm gì cả… <path> --dry-run
Gỡ một tài liệu xuống… --remove HDID_00003
Web mất hết tài liệu sau khi dựng lại máy… --reapply

Thay … bằng /UID_01_publish_html_doc, hoặc chạy thẳng python3 docs/tools/publish_html_doc.py từ gốc repo.

⚠️ Ba điều dễ sai

Đừng chép file vào thư mục trên NAS. Chỗ …/B06_MQTT_Broker/www/share/02_Link/FID_00005_HTML_DOC/ trông rất giống nơi tài liệu nằm, nhưng file bỏ vào đó không lên web. Cứ để tài liệu ở chỗ cũ và dùng câu lệnh trên.
Đừng tự tạo shortcut trong web server. Câu lệnh trên đã tự tạo và tự quản lý; tạo tay sẽ bị xoá mất ở lần chạy sau.
Thư mục thì bắt buộc có index.html. Không có thì máy từ chối ngay, vì người đọc sẽ không biết vào trang nào trước.