Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Vietnamese README file #73

Merged
merged 3 commits into from
Aug 21, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
113 changes: 61 additions & 52 deletions documents/README.vi.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,134 +2,143 @@
<img src="https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/icons/favicon-circle.png" width="100" />
<strong>
<h1>Shioru</h2>
<p>ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น</p>
<p>Trợ lý trong máy chủ Discord của bạn sẽ giúp máy chủ của bạn trở thành một nơi tốt hơn để ở lại.</p>
</strong>
<img src="https://img.shields.io/badge/discord.js-v14-7354F6?logo=discord&logoColor=white" />
<img src="https://img.shields.io/github/stars/Maseshi/Shioru.svg?logo=github" />
<img src="https://img.shields.io/github/v/release/Maseshi/Shioru" />
<img src="https://img.shields.io/github/license/Maseshi/Shioru.svg?logo=github" />
<img src="https://img.shields.io/github/last-commit/Maseshi/Shioru" />
<a title="Trạng thái" target="_blank" href="https://shioru.statuspage.io/">
<a title="Status" target="_blank" href="https://shioru.statuspage.io/">
<img src="https://img.shields.io/badge/dynamic/json?logo=google-cloud&logoColor=white&label=status&query=status.indicator&url=https%3A%2F%2Fq60yrzp0cbgg.statuspage.io%2Fapi%2Fv2%2Fstatus.json" />
</a>
<a title="đám đông" target="_blank" href="https://crowdin.com/project/shioru">
<a title="Crowdin" target="_blank" href="https://crowdin.com/project/shioru">
<img src="https://badges.crowdin.net/shioru/localized.svg" />
</a>
<a title="CodeFactor" target="_blank" href="https://www.codefactor.io/repository/github/maseshi/shioru">
<img src="https://www.codefactor.io/repository/github/maseshi/shioru/badge" alt="CodeFactor" />
</a>
<a title="top.gg" target="_blank" href="https://top.gg/bot/704706906505347183">
<a title="Top.gg" target="_blank" href="https://top.gg/bot/704706906505347183">
<img src="https://top.gg/api/widget/upvotes/704706906505347183.svg" />
</a>
</div>

[เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents)
[Thay đổi ngôn ngữ](https://github.com/Maseshi/Shioru/tree/main/documents)

[VI](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [GIÀ](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md)
Trợ lý máy chủ giỏi của bạn sẽ giúp máy chủ của bạn trông sinh động hơn. Cô ấy có thể làm một số việc, bạn có thể xem thông tin chi tiết cho các lệnh bằng cách gõ `/help`.

<div align="center">
<a href="https://discord.com/api/oauth2/authorize?client_id=704706906505347183&permissions=8&scope=applications.commands%20bot&redirect_uri=https%3A%2F%2Fshiorus.web.app%2Fthanks-you">
<img src="https://img.shields.io/badge/Invite_Bot-1967D2?logo=discord&logoColor=white&style=for-the-badge" />
</a>
</div>

## Đặc trưng
## Tính năng nổi bật

- Hoạt động trên [Discord.js](https://discord.js.org/) v14.
- Có thể tùy chỉnh nhiều mục mong muốn
- Có thể phát nhạc từ [YouTube](https://www.youtube.com/), [Spotify](https://www.spotify.com/) và [SoundCloud](https://soundcloud.com/) với tính năng phát lại tự động.
- Hỗ trợ nhiều ngôn ngữ Bạn có thể kiểm tra các ngôn ngữ được hỗ trợ từ các tệp[ngôn ngữ](https://github.com/Maseshi/shioru/blob/main/source/languages)của kho lưu trữ này.
- Hệ thống bậc (trình độ và kinh nghiệm)
- Dựa trên [Discord.js](https://discord.js.org/) v14
- Một loạt các tùy chỉnh có thể được thực hiện.
- Có thể phát nhạc từ [YouTube](https://www.youtube.com/), [Spotify](https://www.spotify.com/) và [SoundCloud](https://soundcloud.com/), với tính năng phát lại tự động.
- Hỗ trợ nhiều ngôn ngữ, bạn có thể kiểm tra ngôn ngữ được hỗ trợ từ [tệp ngôn ngữ](https://github.com/Maseshi/Shioru/blob/main/source/configs/languages.json) của repository này.
- Hệ thống cấp bậc (cấp độ và kinh nghiệm)
- Hỗ trợ tùy chỉnh thông báo máy chủ
- Bạn có thể nói chuyện bằng cách nhập `@Shioru` theo sau là tin nhắn bạn muốn liên lạc.
- Lệnh ứng dụng (/) có thể được sử dụng.
- Bạn có thể trò chuyện bằng cách `@Shioru` theo sau là tin nhắn bạn muốn gửi.
- Có thể sử dụng các lệnh ứng dụng (/)

และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย...
Và nhiều tính năng thú vị khác...

## điều kiện tiên quyết
## Điều kiện tiên quyết

- [Node.js](https://nodejs.org/) v18.0.0 trở lên
- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า
- [Node.js](https://nodejs.org/) v18.0.0 hoặc cao hơn
- [Python](https://www.python.org/downloads/) v2.0.0 hoặc cao hơn
- [Firebase](https://firebase.google.com/)
- [FFmpeg](https://www.ffmpeg.org/download.html)
- [FFmpeg](https://ffmpeg.org/download.html)
- [Git](https://git-scm.com/downloads)

## Hướng dẫn cài đặt nhanh

ทดสอบแล้วบนระบบ Mac, Linux และ Windows
Đã thử nghiệm trên các hệ thống Mac, Linux Windows

### เพิ่มบอทไปยังเซิร์ฟเวอร์
### Thêm bot vào máy chủ.

- Chuyển đến [Cổng thông tin dành cho nhà phát triển Discord](https://discord.com/developers/applications)
- Nhấp vào **"Ứng dụng mới"** và đặt tên cho bot của bạn và chấp nhận các quy tắc của chính sách Discord.
- ไปที่หน้า **"Bot"** และเปิดใช้งานตัวเลือกทั้งหมดในส่วน **Privileged Gateway Intent** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png)
- เชิญบอทของคุณไปที่เซิร์ฟเวอร์โดยไปที่หน้า **OAuth2 > URL Generator** เลือก `bot` และ `applications.commands` เลือก `Administrator` จากนั้นคัดลอกลิงก์และวางในที่อยู่ของเบราว์เซอร์ของคุณ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png)
- Đi đến trang [Discord Developer Portal](https://discord.com/developers/applications)
- Nhấn **"New Application"** và đặt tên cho bot của bạn và chấp nhận các quy tắc chính sách Discord.
- Đến trang **"Bot"** và bật tất cả các tùy chọn trong phần **Privileged Gateway Intents**.
![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png)
- Mời bot của bạn vào máy chủ bằng cách đi đến trang **OAuth2 > URL Generator**, lựa chọn `bot` và `applications.commands` và lựa chọn `Administrator`.
Sau đó sao chép liên kết và dán nó vào địa chỉ trình duyệt của bạn.
![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png)

### Thiết lập bot

เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้:
- Vì chúng ta sử dụng [sodium](https://www.npmjs.com/package/sodium) để mã hóa và giải mã, chúng ta cần cài đặt các thành phần bổ sung sau:

```bat
@REM บน Windows
@REM Trên Windows
npm install -g windows-build-tools
```
```sh
# บน MacOS (Darwin)
# Trên MacOS (Darwin)
brew install libtool autoconf automake
```
```sh
# บน Linux
# Trên Linux
sudo apt-get install libtool-bin
```

- Khởi chạy một thiết bị đầu cuối và chạy lệnh sau.
- Khởi chạy terminal và chạy những lệnh sau.

```bat
git clone https://github.com/Maseshi/Shioru.git
cd Shioru
npm install
```

- Bạn có thể sửa đổi một số dữ liệu trong **config** at `./source/config.js`
- Bạn có thể sửa một số dữ liệu trong **config** `./source/configs/data.js`.

### Thiết lập căn cứ hỏa lực
### Cài đặt Firebase

- Truy cập https://firebase.google.com/ và bắt đầu thiết lập dự án.
- Thêm một dự án mới và làm theo các bước.
- เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png)
- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example`
- Đến **tạo > [cơ sở dữ liệu thời gian thực](https://console.firebase.google.com/u/0/project/_/database/data)** để tạo cơ sở dữ liệu lưu trữ.
- Đi đến https://firebase.google.com/ và bắt đầu thiết lập dự án.
- Thêm một dự án mới và thực hiện các bước.
- Thêm ứng dụng đầu tiên của bạn là **Website**, đặt tên ứng dụng của bạn mà không chọn **"Also set up Firebase Hosting for this app."** và đăng kí ứng dụng.
![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png)
- Firebase sẽ cung cấp cho bạn thông tin về cấu hình. Áp dụng các giá trị này cho tệp `.env.example`.
- Đi đến **Build > [Realtime Database](https://console.firebase.google.com/u/0/project/_/database/data)** để tạo cơ sở dữ liệu để lưu trữ dữ liệu.

### phát triển
### Phát triển

- Đổi tên tệp `.env.example` thành `.env` và chèn tất cả các giá trị cần thiết.
- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น
- Đổi tên tệp `.env.example` thành `.env` và thêm tất cả giá trị.
- Đi đến terminal và chạy `npm run dev` cho chế độ phát triển (development) và `npm start` cho chế độ cung cấp (production).
> **LƯU Ý**: Khi bạn vào chế độ phát triển (development), một số tính năng có thể bị tắt, chẳng hạn như gửi thống kê, cập nhật dữ liệu, v.v.

## Khắc phục sự cố nhanh
## Xử lý sự cố nhanh

- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง
- Nếu bạn gặp sự cố trong quá trình cài đặt thành phần mà trên terminal cho biết `gyp ERR! stack Error: not found: make`. Sự cố này có thể do **build tool** không được cài đặt đúng cách hoặc chúng có thể chưa được cài đặt. Giải pháp là tải xuống phiên bản mới nhất của [Node.js](https://nodejs.org/) và đánh dấu vào phần này trong quá trình cài đặt.

![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png)

- Nếu bạn không thể cài đặt gói **sodium** , hãy cài đặt **libsodium-wrappers** để thay thế.
- Nếu bạn không thế cài đặt gói **sodium**, cài đặt **libsodium-wrappers** thay thế.

```bat
npm cài đặt ffmpeg-static@latest --save
npm uninstall sodium
npm install libsodium-wrappers@latest --save
```
- Nếu bạn không thể phát nhạc hoặc các lệnh phát lại nhạc không hoạt động, hãy cài đặt [ffmpeg](https://ffmpeg.org/download.html) **(recommended)** hoặc cài đặt gói **ffmpeg-static** và thử lại.

- Nếu bạn không thể phát nhạc hoặc lệnh phát lại nhạc không hoạt động, hãy cài đặt [FFmpeg](https://ffmpeg.org/download.html) **(được khuyến nghị)** hoặc cài đặt gói **ffmpeg-static**. và thử lại

```bat
npm cài đặt ffmpeg-static@latest --save
npm install ffmpeg-static@latest --save
```

## Cải thiện bản dịch

và nhiều tính năng thú vị khác...
Bạn có thể giúp chúng tôi dịch các ngôn ngữ hiện có hoặc ngôn ngữ hiện không có sẵn trên [Crowdin](https://crowdin.com/project/shioru).

## tín dụng
## Credits

Bạn có thể giúp chúng tôi dịch một ngôn ngữ hiện có hoặc một ngôn ngữ hiện không khả dụng tại [Crowdin](https://crowdin.com/project/shioru-bot).
Cảm ơn tất cả nhà sáng tạo gốc vì đã cho phép chúng tôi sử dụng những tác phẩm tuyệt vời này của bạn.

Cảm ơn tất cả những người sáng tạo ban đầu đã cho phép sử dụng những tác phẩm tuyệt vời này của bạn.
Avatar được vẽ bởi: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098)

## tìm thấy một vấn đề
## Tìm thấy vấn đề

Avatar vẽ bởi: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098)
Nếu bạn gặp bất kỳ vấn đề nào từ công việc hiện tại của mình, bạn có thể cho chúng tôi biết thông qua tab [issue](https://github.com/Maseshi/Shioru/issues) của repo này.