# Hướng dẫn sử dụng Study4 Scraper

Đây là tiện ích mở rộng (Extension) dành cho trình duyệt Chrome/Edge, giúp bạn trích xuất tự động danh sách từ vựng từ trang web Study4 và xuất ra định dạng JSON, CSV hoặc chuẩn bị sẵn toàn bộ dữ liệu (Bao gồm file hình ảnh và âm thanh) để nhập vào phần mềm flashcard **Anki**.

## 1. Cài đặt Extension vào trình duyệt

1. Mở trình duyệt Chrome hoặc Edge.
2. Truy cập vào trang quản lý tiện ích mở rộng:
   - Trên Chrome: gõ `chrome://extensions/` vào thanh địa chỉ.
   - Trên Edge: gõ `edge://extensions/` vào thanh địa chỉ.
3. Bật **Chế độ nhà phát triển** (Developer mode) ở góc phải màn hình (hoặc thanh menu bên trái đối với Edge).
4. Nhấn nút **Tải tiện ích đã giải nén** (Load unpacked).
5. Chọn thư mục `study4_scraper_extension` chứa các file mã nguồn của extension này.
6. Biểu tượng của Study4 Scraper sẽ xuất hiện trên thanh công cụ của trình duyệt. Bạn nên "Ghim" (Pin) biểu tượng này ra ngoài để dễ bấm.

## 2. Cách sử dụng cơ bản

1. Truy cập vào trang bài học chứa danh sách flashcard trên Study4 (ví dụ: một khóa học chứa từ vựng IELTS).
2. Click vào biểu tượng của **Study4 Scraper** trên thanh công cụ.
3. Sẽ có 3 lựa chọn xuất dữ liệu:
   - **Tải về CSV (Cơ bản)**: Chỉ tải file CSV chứa văn bản (từ, nghĩa, loại từ, v.v.).
   - **Tải về JSON**: Tải dữ liệu dạng JSON dành cho nhà phát triển.
   - **Tải về file ZIP cho Anki**: Tính năng cao cấp, tải đầy đủ file CSV, hình ảnh và âm thanh. Xem chi tiết ở phần 3.

## 3. Cách trích xuất và nhập (Import) vào Anki (Khuyên dùng)

Tính năng **"Tải về file ZIP cho Anki"** là tính năng mạnh mẽ nhất, giúp bạn mang toàn bộ nội dung học từ Study4 sang Anki để ôn tập offline.

### Bước 1: Trích xuất dữ liệu
1. Mở trang Flashcard trên Study4.
2. Click vào biểu tượng Extension, chọn nút màu cam: **Tải về file ZIP cho Anki (Kèm hình ảnh & âm thanh)**.
3. Extension sẽ bắt đầu quét dữ liệu, tự động tải hình ảnh và âm thanh về. **Vui lòng chờ** (có thể mất vài chục giây) cho đến khi trình duyệt tự động tải xuống một file có tên `study4_anki_deck.zip`.

### Bước 2: Cài đặt Media vào Anki
1. Giải nén file `study4_anki_deck.zip` vừa tải về. Bên trong thư mục bạn sẽ thấy:
   - 1 file `study4_anki.csv`
   - Rất nhiều file `.jpg`, `.png`, và `.mp3` (Đây là các file Media).
2. Mở thư mục chứa dữ liệu Media của Anki trên máy tính bạn:
   - Trên Windows: Nhấn tổ hợp phím `Windows + R`, gõ `%APPDATA%\Anki2` và nhấn Enter. Mở tiếp thư mục mang tên Profile Anki của bạn (thường là `User 1`), sau đó mở thư mục `collection.media`.
   - Copy **toàn bộ** các file `.jpg`, `.png` và `.mp3` từ thư mục vừa giải nén thả vào thư mục `collection.media` này.

### Bước 3: Import file CSV vào Anki
1. Mở phần mềm Anki.
2. Chọn menu **File > Import...** (Hoặc nhấn nút Import File ở dưới cùng).
3. Chọn file `study4_anki.csv` từ thư mục vừa giải nén.
4. Một bảng cấu hình Import sẽ hiện ra. Hãy thiết lập như sau:
   - **Type (Loại thẻ)**: Chọn "Basic" (hoặc loại thẻ Flashcard mà bạn hay dùng).
   - **Deck (Bộ thẻ)**: Chọn bộ thẻ bạn muốn lưu từ vựng Study4.
   - **Field mapping (Ghép cột)**: Đảm bảo các cột (Field) tương ứng với Front/Back của thẻ. Trong file CSV có các cột thứ tự sau: 
     1. Word
     2. Type
     3. Pronunciation
     4. Definition
     5. Examples
     6. Image
     7. UKAudio
     8. USAudio
   - **ĐẶC BIỆT QUAN TRỌNG**: Đánh dấu tích vào ô **"Allow HTML in fields"** (Cho phép dùng thẻ HTML). Nếu không chọn ô này, hình ảnh và âm thanh sẽ không hiển thị được.
5. Nhấn **Import**.

Bây giờ bạn có thể mở bộ thẻ Anki lên và bắt đầu học với đầy đủ hình ảnh minh họa và âm thanh phát âm chuẩn. Chúc bạn học tốt!