# Hướng dẫn cài đặt Học từ vựng tiếng Nhật PRO

Cài Apps Script cho Học từ vựng tiếng Nhật PRO trong khoảng 6 phút. Chỉ áp dụng cho bản Google Trang tính.

## Thông tin nhanh

- **Menu sau khi cài:** 🌸 Học tiếng Nhật (hiện cạnh menu Trợ giúp)
- **Mục bấm đầu tiên:** Mở hộp thoại học — đây là lúc Google hỏi quyền
- **Số file phải dán:** 3 (Code.gs, Data, App)
- **Thời gian:** khoảng 6 phút, làm một lần
- **Web App:** không
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/hoc-tu-vung-tieng-nhat-pro

## Các file trong thư mục 2-Apps-Script

- `Code.gs` (Tập lệnh): phần chạy trên máy chủ Google
- `Data` (Tập lệnh): bảng Kanji cho Tự điền (âm Hán Việt, âm On/Kun, bộ thủ, số nét) — thêm bằng Tệp › + › Tập lệnh, KHÔNG phải HTML
- `App` (HTML): hộp thoại học: Hôm nay, Ôn tập, Luyện tập, Trò chơi, Sổ từ, Thêm từ, Thống kê — có sẵn bàn phím romaji → kana

## Các bước

1. Mở file bằng Google Trang tính (bản sao từ "Tài liệu của tôi" đã có sẵn script, bỏ qua bước 1–2).
2. Tệp › Cài đặt: Ngôn ngữ Việt Nam, Múi giờ (GMT+07:00) Bangkok, Hà Nội, Tính lại "Khi thay đổi và mỗi giờ".
3. Tiện ích mở rộng › Apps Script › dán Code.gs vào Mã.gs.
4. Thêm các file còn lại đúng tên: Data (Tập lệnh), App (HTML).
5. Lưu, quay lại bảng tính, nhấn F5. Menu 🌸 Học tiếng Nhật hiện cạnh Trợ giúp.
6. Bấm 🌸 Học tiếng Nhật › Mở hộp thoại học. Google hỏi quyền: Tiếp tục › chọn tài khoản › "Google chưa xác minh ứng dụng này" › Nâng cao › Chuyển đến … (không an toàn) › Cho phép.

Cảnh báo "chưa được xác minh" là bình thường với mọi Apps Script tự dán vào file của mình; Google chỉ xác minh ứng dụng nộp hồ sơ phát hành công khai.

## Quyền Google hỏi ở mẫu này

- **Xem, sửa, tạo, xoá bảng tính:** đọc và ghi vào chính file của bạn
- **Hiện và chạy nội dung bên thứ ba:** mở hộp thoại quản lý bên trong bảng tính

Dữ liệu nằm trong Google Drive của khách. Script chạy bằng tài khoản Google của khách, không gửi dữ liệu ra ngoài; HiTaVa không xem được file.

## Việc làm một lần

- Kiểm tra múi giờ — lịch ôn tập tính theo ngày, sai múi giờ là “hôm nay” lệch gần nửa ngày.
- Cài giọng đọc tiếng Nhật (ja-JP) nếu máy chưa có: Windows › Cài đặt › Thời gian & ngôn ngữ › Ngôn ngữ › Thêm tiếng Nhật › tích Giọng nói. macOS › Cài đặt hệ thống › Trợ năng › Nội dung được đọc › Quản lý giọng › Tiếng Nhật. Thiếu giọng thì kiểu Nghe rồi chọn bị khoá, các kiểu khác vẫn chạy.
- Chưa thuộc bảng chữ cái? Mở tab Bảng Kana và bật “Hiện romaji ở mặt trước thẻ” trong Nhắc học & chia sẻ.
- Mở hộp thoại học › Hôm nay để bắt đầu; Thêm từ mới sẽ tự sinh romaji, âm Hán Việt và bốn dạng chia ます / て / た / ない.

## Trên Excel

Trên Excel vẫn dùng được các tab, công thức, Ôn hôm nay, Flashcard và Bảng Kana trong bảng. Không có: hộp thoại học, giọng đọc, furigana và đường trọng âm trên thẻ, bàn phím kana, luyện tập, tự điền, thống kê. Từ bạn gõ tay trong Excel sẽ trống các cột Romaji, Không dấu và bốn cột chia động từ.

Trang HTML: https://www.hitava.cloud/huong-dan/hoc-tu-vung-tieng-nhat-pro