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

Cài Apps Script cho Học từ vựng tiếng Hàn 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 Hàn (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-han-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 Hán tự cho Tự điền (âm Hán Việt, âm Hàn, bộ thủ, số nét) và bảng động từ bất quy tắc — 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 & phát âm, Sổ từ, Thêm từ, Thống kê — có sẵn bàn phím Hangul ảo

## 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 Hàn hiện cạnh Trợ giúp.
6. Bấm 📘 Học tiếng Hàn › 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 Hàn (ko-KR) nếu máy chưa có: Windows › Cài đặt › Thời gian & ngôn ngữ › Ngôn ngữ › Thêm tiếng Hàn › 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 Hàn. Thiếu giọng thì kiểu Nghe rồi chọn bị khoá, các kiểu khác vẫn chạy.
- Mở hộp thoại học › Hôm nay để bắt đầu; Thêm từ mới sẽ tự sinh phát âm thực [발음], romaja và hai 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 và Flashcard trong bảng. Không có: hộp thoại học, giọng đọc, bàn phím Hangul ảo, luyện phát âm, tự điền, thống kê. Từ bạn gõ tay trong Excel sẽ trống các cột Phát âm, Romaja, Không dấu và hai cột chia động từ.

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