diff --git a/documents/README.bg.md b/documents/README.bg.md index 6f7d4ad2..c23b34e4 100644 --- a/documents/README.bg.md +++ b/documents/README.bg.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[BG](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - Поддръжка за персонализиране на известията на сървъра - Можете да говорите, като напишете `@Shioru` , последвано от съобщението, което искате да комуникирате. - Може да се използва командата на приложението (/). +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Предпоставки -- [Node.js](https://nodejs.org/) v18.0.0 или по-нова версия -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Ръководство за бързо инсталиране +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Отидете на [Портал за разработчици на Discord](https://discord.com/developers/applications) -- Щракнете върху **„Ново приложение“** и дайте име на своя бот и приемете правилата на правилата на 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) - -### Настройте бот - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Стартирайте терминал и изпълнете следната команда. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Преименувайте файла `.env.example` на `.env` и вмъкнете всички необходими стойности. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Можете да промените някои данни в **config** в `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Отидете на [Портал за разработчици на Discord](https://discord.com/developers/applications) +- Щракнете върху **„Ново приложение“** и дайте име на своя бот и приемете правилата на правилата на 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) -### Настройте Firebase +### 4. ตั้งค่าฐานข้อมูล - Отидете на https://firebase.google.com/ и започнете да настройвате проекта. - Добавете нов проект и следвайте стъпките. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Отидете на **създаване > [база данни в реално време](https://console.firebase.google.com/u/0/project/_/database/data)** , за да създадете база данни за съхранение. -### развиват се +## 🪛 การพัฒนา -- Преименувайте файла `.env.example` на `.env` и вмъкнете всички необходими стойности. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Бързо отстраняване на неизправности +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Ако не можете да инсталирате пакет **sodium** , вместо това инсталирайте **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm инсталирайте ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Ако не можете да възпроизвеждате музиката си или командите за възпроизвеждане на музика не работят, инсталирайте [ffmpeg](https://ffmpeg.org/download.html) **(препоръчително)** или инсталирайте пакета **ffmpeg-static** и опитайте отново. +- บน Linux หรือ MacOS -```bat -npm инсталирайте ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Подобрете Преводач + sh start.sh || sudo sh start.sh -и много други интересни функции... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## кредит +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Можете да ни помогнете да преведем съществуващ език или език, който в момента не е наличен в [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Благодарим на всички оригинални творци, че позволиха използването на тези ваши прекрасни произведения. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +и много други интересни функции... ## намери проблем -Рисунка на аватар от: [夏月 まりな (НАЦУКИ МАРИНА)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.cs.md b/documents/README.cs.md index bef91f26..dbc55851 100644 --- a/documents/README.cs.md +++ b/documents/README.cs.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[EN](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [ČT](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ - Podpora přizpůsobení oznámení serveru - Můžete mluvit tak, že napíšete `@Shioru` a poté zprávu, kterou chcete komunikovat. - Lze použít aplikační příkaz (/). +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Předpoklady -- [Node.js](https://nodejs.org/) v18.0.0 nebo vyšší -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Stručný návod k obsluze +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Přejděte na [Discord Developer Portal](https://discord.com/developers/applications) -- Klikněte na **„Nová aplikace“** a pojmenujte svého robota a přijměte pravidla zásad 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) - -### Nastavit robota - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Spusťte terminál a spusťte následující příkaz. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Přejmenujte soubor `.env.example` na `.env` a vložte všechny potřebné hodnoty. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Některá data můžete upravit v **config** na `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Přejděte na [Discord Developer Portal](https://discord.com/developers/applications) +- Klikněte na **„Nová aplikace“** a pojmenujte svého robota a přijměte pravidla zásad 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) -### Nastavte Firebase +### 4. ตั้งค่าฐานข้อมูล - Přejděte na https://firebase.google.com/ a začněte nastavovat projekt. - Přidejte nový projekt a postupujte podle pokynů. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Přejděte na **vytvořit > [databázi v reálném čase](https://console.firebase.google.com/u/0/project/_/database/data)** a vytvořte databázi úložiště. -### rozvíjet +## 🪛 การพัฒนา -- Přejmenujte soubor `.env.example` na `.env` a vložte všechny potřebné hodnoty. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Rychlé odstraňování problémů +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Pokud nemůžete nainstalovat balíček **sodium** , nainstalujte místo toho **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm odinstalovat sodík -npm nainstalovat libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Pokud nemůžete přehrávat hudbu nebo příkazy pro přehrávání hudby nefungují, nainstalujte [ffmpeg](https://ffmpeg.org/download.html) **(doporučeno)** nebo nainstalujte balíček **ffmpeg-static** a zkuste to znovu. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Vylepšete Překladač + sh start.sh || sudo sh start.sh -a mnoho dalších zajímavých funkcí... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## kredit +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Můžete nám pomoci přeložit existující jazyk nebo jazyk, který není aktuálně dostupný na [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Děkujeme všem původním tvůrcům za umožnění použití těchto vašich úžasných děl. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +a mnoho dalších zajímavých funkcí... ## našel problém -Kresba avatara od: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.da.md b/documents/README.da.md index d684ffca..ee2252a4 100644 --- a/documents/README.da.md +++ b/documents/README.da.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[DA](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - Understøttelse af tilpasning af servermeddelelser - Du kan tale ved at skrive `@Shioru` efterfulgt af den besked, du vil kommunikere. - Applikationskommandoen (/) kan bruges. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Forudsætninger -- [Node.js](https://nodejs.org/) v18.0.0 eller nyere -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Hurtig installationsvejledning +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Gå til [Discord Developer Portal](https://discord.com/developers/applications) -- Klik på **"Ny applikation"** og navngiv din bot og accepter Discord-politikreglerne. -- ไปที่หน้า **"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) - -### Opsæt en bot - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Start en terminal og kør følgende kommando. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Omdøb filen `.env.eksempel` til `.env` og indsæt alle de nødvendige værdier. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Du kan ændre nogle data i **config** på `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Gå til [Discord Developer Portal](https://discord.com/developers/applications) +- Klik på **"Ny applikation"** og navngiv din bot og accepter Discord-politikreglerne. +- ไปที่หน้า **"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) -### Konfigurer Firebase +### 4. ตั้งค่าฐานข้อมูล - Gå til https://firebase.google.com/ og start opsætningen af projektet. - Tilføj et nyt projekt og følg trinene. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Gå til **opret > [realtidsdatabase](https://console.firebase.google.com/u/0/project/_/database/data)** for at oprette en lagerdatabase. -### udvikle +## 🪛 การพัฒนา -- Omdøb filen `.env.eksempel` til `.env` og indsæt alle de nødvendige værdier. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Hurtig fejlfinding +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Hvis du ikke kan installere pakke **sodium** , installer **libsodium-wrappers** i stedet for. +## 🍵 ใช้งานจริง -```bat -npm installer ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Hvis du ikke kan afspille din musik, eller musikafspilningskommandoer ikke virker, skal du installere [ffmpeg](https://ffmpeg.org/download.html) **(anbefalet)** eller installere **ffmpeg-static** -pakken og prøve igen. +- บน Linux หรือ MacOS -```bat -npm installer ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Forbedre Oversæt + sh start.sh || sudo sh start.sh -og mange andre interessante funktioner... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## kredit +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Du kan hjælpe os med at oversætte et eksisterende sprog eller et sprog, der i øjeblikket ikke er tilgængeligt hos [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Tak til alle originale skabere for at tillade brugen af disse vidunderlige værker. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +og mange andre interessante funktioner... ## fundet et problem -Avatar tegning af: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.de.md b/documents/README.de.md index ecd0415c..472d4385 100644 --- a/documents/README.de.md +++ b/documents/README.de.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -Ihr guter Serverassistent wird dazu beitragen, dass Ihr Server lebendiger aussieht. Sie kann viele Dinge tun, zu denen Sie detaillierte Informationen zu den verschiedenen Befehlen finden können, indem Sie `/help` Sie können Shioru von[hier aus einladen, Ihrem Server beizutreten](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,100 +43,134 @@ Ihr guter Serverassistent wird dazu beitragen, dass Ihr Server lebendiger aussie - Unterstützung für die Anpassung der Serverbenachrichtigung - Sie können sprechen, indem Sie `@Shioru` eingeben, gefolgt von der Nachricht, die Sie übermitteln möchten. - Der Anwendungsbefehl (/) kann verwendet werden. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard und viele weitere interessante Features... ## Voraussetzungen -- [Node.js](https://nodejs.org/) v18.0.0 oder höher -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Kurzanleitung zur Einrichtung +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Gehen Sie zu [Discord Developer Portal](https://discord.com/developers/applications) -- Klicken Sie auf **„Neue Anwendung“** , geben Sie Ihrem Bot einen Namen und akzeptieren Sie die Richtlinienregeln von Discord. -- Gehen Sie zu Seite **„Bot“** und aktivieren Sie alle Optionen in Abschnitt **Privileged Gateway Intent** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Laden Sie Ihren Bot zum Server ein, indem Sie auf Seite **gehen. OAuth2 > URL-Generator** Wählen Sie `Bot` und `Anwendungen. Befehle` Wählen Sie `Administrator` Kopieren Sie dann den Link und fügen Sie ihn in die Adresse Ihres Browsers ein. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### Richten Sie einen Bot ein - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Starten Sie ein Terminal und führen Sie den folgenden Befehl aus. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Benennen Sie die Datei `.env.example` in `.env` um und fügen Sie alle erforderlichen Werte ein. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Sie können einige Daten in **config** unter `./source/config.js`ändern +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Gehen Sie zu [Discord Developer Portal](https://discord.com/developers/applications) +- Klicken Sie auf **„Neue Anwendung“** , geben Sie Ihrem Bot einen Namen und akzeptieren Sie die Richtlinienregeln von Discord. +- Gehen Sie zu Seite **„Bot“** und aktivieren Sie alle Optionen in Abschnitt **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) -### Richten Sie Firebase ein +### 4. ตั้งค่าฐานข้อมูล - Gehen Sie zu https://firebase.google.com/ und beginnen Sie mit der Einrichtung des Projekts. - Fügen Sie ein neues Projekt hinzu und befolgen Sie die Schritte. - Fügen Sie Ihre erste Anwendung mit **Website hinzu.** Benennen Sie Ihre App optional. **„Richten Sie auch Firebase Hosting für diese App ein“** und registrieren Sie die App. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase stellt Ihnen Informationen zur Konfiguration zur Verfügung. Wenden Sie diese Werte auf Datei `.env.example`an +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Gehen Sie zu **erstellen > [Echtzeitdatenbank](https://console.firebase.google.com/u/0/project/_/database/data)** , um eine Speicherdatenbank zu erstellen. -### entwickeln +## 🪛 การพัฒนา -- Benennen Sie die Datei `.env.example` in `.env` um und fügen Sie alle erforderlichen Werte ein. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Schnelle Fehlerbehebung +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Wenn Sie Paket **Natrium** nicht installieren können, installieren Sie stattdessen **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -Git-Klon https://github.com/Maseshi/Shioru.git -cd Shioru -npm install --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Wenn Sie Ihre Musik nicht abspielen können oder die Musikwiedergabebefehle nicht funktionieren, installieren Sie [ffmpeg](https://ffmpeg.org/download.html) **(empfohlen)** oder installieren Sie das **ffmpeg-static** Paket und versuchen Sie es erneut. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Verbessern Sie die Übersetzung + sh start.sh || sudo sh start.sh -Sie können uns helfen, eine vorhandene Sprache oder eine Sprache zu übersetzen, die derzeit nicht unter [Crowdin](https://crowdin.com/project/shioru-bot)verfügbar ist. + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## Kredit +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Vielen Dank an alle Originalschöpfer, die die Nutzung Ihrer wunderbaren Werke gestattet haben. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Avatar-Zeichnung von: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +Sie können uns helfen, eine vorhandene Sprache oder eine Sprache zu übersetzen, die derzeit nicht unter [Crowdin](https://crowdin.com/project/shioru-bot)verfügbar ist. ## habe ein Problem gefunden -Wenn Sie auf Probleme stoßen von Ihrem aktuellen Job Sie können uns dies über die Registerkarte [Problem](https://github.com/Maseshi/Shioru/issues) dieses Repositorys mitteilen. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.el.md b/documents/README.el.md index 6b53fa50..1c7a42ea 100644 --- a/documents/README.el.md +++ b/documents/README.el.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[EL](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - Υποστήριξη για προσαρμογή ειδοποιήσεων διακομιστή - Μπορείτε να μιλήσετε πληκτρολογώντας `@Shioru` ακολουθούμενο από το μήνυμα που θέλετε να επικοινωνήσετε. - Μπορεί να χρησιμοποιηθεί η εντολή εφαρμογής (/). +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Προαπαιτούμενα -- [Node.js](https://nodejs.org/) v18.0.0 ή νεότερη έκδοση -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Οδηγός γρήγορης εγκατάστασης +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Μεταβείτε στο [Discord Developer Portal](https://discord.com/developers/applications) -- Κάντε κλικ στο **"Νέα εφαρμογή"** και ονομάστε το bot σας και αποδεχτείτε τους κανόνες της πολιτικής 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) - -### Ρυθμίστε ένα bot - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Εκκινήστε ένα τερματικό και εκτελέστε την ακόλουθη εντολή. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Μετονομάστε το αρχείο `.env.example` σε `.env` και εισαγάγετε όλες τις απαραίτητες τιμές. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Μπορείτε να τροποποιήσετε ορισμένα δεδομένα σε **config** at `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Μεταβείτε στο [Discord Developer Portal](https://discord.com/developers/applications) +- Κάντε κλικ στο **"Νέα εφαρμογή"** και ονομάστε το bot σας και αποδεχτείτε τους κανόνες της πολιτικής 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) -### Ρυθμίστε το Firebase +### 4. ตั้งค่าฐานข้อมูล - Μεταβείτε στη διεύθυνση https://firebase.google.com/ και ξεκινήστε τη ρύθμιση του έργου. - Προσθέστε ένα νέο έργο και ακολουθήστε τα βήματα. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - ไปที่ **สร้าง > [ฐานข้อมูลเรียลไทม์](https://console.firebase.google.com/u/0/project/_/database/data)** เพื่อสร้างฐานข้อมูลสำหรับจัดเก็บข้อมูล -### αναπτύσσω +## 🪛 การพัฒนา -- Μετονομάστε το αρχείο `.env.example` σε `.env` και εισαγάγετε όλες τις απαραίτητες τιμές. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Γρήγορη αντιμετώπιση προβλημάτων +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Εάν δεν μπορείτε να εγκαταστήσετε το πακέτο **sodium** , εγκαταστήστε **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm εγκατάσταση ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Εάν δεν μπορείτε να αναπαράγετε τη μουσική σας ή οι εντολές αναπαραγωγής μουσικής δεν λειτουργούν, εγκαταστήστε το [ffmpeg](https://ffmpeg.org/download.html) **(συνιστάται)** ή εγκαταστήστε το πακέτο **ffmpeg-static** και δοκιμάστε ξανά. +- บน Linux หรือ MacOS -```bat -npm εγκατάσταση ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Βελτιώστε τη Μετάφραση + sh start.sh || sudo sh start.sh -και πολλά άλλα ενδιαφέροντα χαρακτηριστικά... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## πίστωση +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Μπορείτε να μας βοηθήσετε να μεταφράσουμε μια υπάρχουσα γλώσσα ή μια γλώσσα που δεν είναι προς το παρόν διαθέσιμη στο [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Ευχαριστούμε όλους τους πρωτότυπους δημιουργούς που επέτρεψαν τη χρήση αυτών των υπέροχων έργων σας. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +και πολλά άλλα ενδιαφέροντα χαρακτηριστικά... ## βρήκε πρόβλημα -Σχέδιο Avatar από: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.en-GB.md b/documents/README.en-GB.md index 46f4c091..b92607da 100644 --- a/documents/README.en-GB.md +++ b/documents/README.en-GB.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -ผู้ช่วยเซิร์ฟเวอร์ที่ดีของคุณจะช่วยให้เซิร์ฟเวอร์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งต่างๆ ได้โดยพิมพ์ `/help` คุณสามารถเชิญ Shioru เข้าร่วมเซิร์ฟเวอร์ของคุณได้จาก[ที่นี่](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ - รองรับการปรับแต่งการแจ้งเตือนของเซิร์ฟเวอร์ - สามารถพูดคุยได้โดยการพิมพ์ `@Shioru` ตามด้วยข้อความที่ต้องการสื่อสาร - สามารถใช้งานคำสั่งแอปพลิเคชั่น (/) ได้ +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## ข้อกำหนดเบื้องต้น -- [Node.js](https://nodejs.org/) v18.0.0 หรือมากกว่า -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## คู่มือการตั้งค่าด่วน +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- ไปที่ [Discord Developer Portal](https://discord.com/developers/applications) -- คลิก **"New Application"** แล้วตั้งชื่อบอทของคุณและยอมรับกฎนโยบายของ 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) - -### ตั้งค่าบอท - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - เปิดใช้งานเทอร์มินัลแล้วรันคำสั่งต่อไปนี้ + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- ทำการเปลี่ยนชื่อไฟล์ `.env.example` เป็น `.env` แล้วใส่ค่าที่จำเป็นทั้งหมด -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- ไปที่ [Discord Developer Portal](https://discord.com/developers/applications) +- คลิก **"New Application"** แล้วตั้งชื่อบอทของคุณและยอมรับกฎนโยบายของ 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) -### ตั้งค่า Firebase +### 4. ตั้งค่าฐานข้อมูล - ไปที่ https://firebase.google.com/ และเริ่มตั้งค่าโครงการ - เพิ่มโครงการใหม่และทำตามขั้นตอนต่างๆ - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - ไปที่ **สร้าง > [ฐานข้อมูลเรียลไทม์](https://console.firebase.google.com/u/0/project/_/database/data)** เพื่อสร้างฐานข้อมูลสำหรับจัดเก็บข้อมูล -### พัฒนา +## 🪛 การพัฒนา -- ทำการเปลี่ยนชื่อไฟล์ `.env.example` เป็น `.env` แล้วใส่ค่าที่จำเป็นทั้งหมด -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## การแก้ไขปัญหาอย่างรวดเร็ว +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- หากคุณไม่สามารถติดตั้งแพ็คเกจ **sodium** ได้ ให้ติดตั้ง **libsodium-wrappers** แทน +## 🍵 ใช้งานจริง -```bat -npm uninstall sodium -npm install libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- หากคุณไม่สามารถเล่นเพลงหรือคำสั่งเล่นเพลงไม่ทำงาน ให้ติดตั้ง [ffmpeg](https://ffmpeg.org/download.html) **(แนะนำ)** หรือติดตั้งแพ็คเกจ **ffmpeg-static** แล้วลองใหม่อีกครั้ง +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Improve Translate + sh start.sh || sudo sh start.sh -คุณสามารถช่วยเราแปลภาษาที่มีอยู่หรือภาษาที่ยังไม่พร้อมใช้งานในขณะนี้ได้ที่ [Crowdin](https://crowdin.com/project/shioru-bot). + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## เครดิต +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -ขอขอบคุณผู้สร้างจากต้นทางทุกท่านที่อนุญาตให้สามารถใช้งานผลงานอันยอดเยี่ยมเหล่านี้ของท่านได้ +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -ภาพวาดประจำตัวโดย: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +คุณสามารถช่วยเราแปลภาษาที่มีอยู่หรือภาษาที่ยังไม่พร้อมใช้งานในขณะนี้ได้ที่ [Crowdin](https://crowdin.com/project/shioru-bot). ## พบปัญหา -หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issue](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.en-US.md b/documents/README.en-US.md index 3d403a95..0db9b118 100644 --- a/documents/README.en-US.md +++ b/documents/README.en-US.md @@ -2,7 +2,7 @@

Shioru

-

Personal assistants in Discord that will help make your guild a better place.

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [Switch Languages](https://github.com/Maseshi/Shioru/tree/main/documents) -Your best personal assistants will help your guild look more lively. She can do so many things that you can easily see detailed information on all commands by typing `/help`. +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,90 +43,86 @@ Your best personal assistants will help your guild look more lively. She can do - Support customization of server notifications - You can chat by typing `@Shioru` followed by the message you wish to communicate. - Able to use application commands (/) -- Simulate a database system for testing -- Supports working on shards +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard And many other interesting features... ## Prerequisites -- [Node.js](https://nodejs.org/) v18.0.0 or higher -- [Python](https://www.python.org/downloads/) v3.8.0 or higher -- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 or higher -- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) or [manual install](#1-install-build-tools) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) - [Firebase Tools](https://firebase.google.com/docs/cli) -- [FFmpeg](https://ffmpeg.org/download.html) +- [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Installation +## การติดตั้ง -### 1. Install **Build Tools** +### 1. ติดตั้ง **Build Tools** -Install **Build tools** by running the following command according to your operating system. +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- For Linux and MacOS operating systems +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh sudo apt update sudo apt install build-essential ``` -- For Windows operating system +- สำหรับระบบปฏิบัติการ Windows ```sh npm install --global --production --add-python-to-path windows-build-tools ``` -> **💡 TIP**: You can skip this step through the Node.js installer as shown in the following image. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) -### 2. Clone the bot and install the components. +### 2. โคลนบอทและติดตั้งส่วนประกอบ -- Launch a terminal and run the following command. +- Launch a terminal and run the following commands. ```bat git clone https://github.com/Maseshi/Shioru.git cd Shioru npm install ``` -- Change the file name `.env.example` to `.env` and enter all required values. - > **💡 NOTE**: You can edit some data in **config** at [./source/configs/data.js](../source/configs/data.js). +- Rename the `.env.example` file to `.env` and add all values. -### 3. Setup bot and invite to join. + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Go to [Discord Developer Portal](https://discord.com/developers/applications) -- Click **"New Application"** and name your bot and accept the Discord policy rules. -- Go to the **"Bot"** page and enable all options in the **Privileged Gateway Intent** section. - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Invite your bot to the server by going to the **OAuth2 > URL Generator** page, selecting `bot` and `applications.commands`, selecting `Administrator`, then copy the link and paste it in the browser address bar. Your sir - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) +### 3. ตั้งค่าบอทและเชิญเข้าร่วม -### 4. Setup database +- Go to the [Discord Developer Portal](https://discord.com/developers/applications) +- Click **"New Application"** and give your bot a name and accept the Discord policy rules. +- Go to the **"Bot"** page and enable all options in the **Privileged Gateway Intents** section. ![](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) + +### 4. ตั้งค่าฐานข้อมูล - Go to https://firebase.google.com/ and start setting up the project. -- Add a new project and follow the steps. -- Add your first application with **Website** Name your app without needing to select the **"Also set up Firebase Hosting for this app."** option and register the app. - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase will provide you with information about its configuration. Apply these values to the file. `.env` +- Add a new project and go through the steps. +- Add your first application with **Website**, name your app without the need to select **"Also set up Firebase Hosting for this app."** and register the app. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Go to **Build > [Realtime Database](https://console.firebase.google.com/u/0/project/_/database/data)** to create a database for storing data. -## 🪛 Development +## 🪛 การพัฒนา -- Open a terminal and run `npm run emulators` to simulate the database system in **dev mode**. -- Open a new terminal and run the command `npm run dev`. - > **💡 NOTE**: When you enter development mode. Some features may be disabled, such as sending statistics, updating data, etc. +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## ☕ Serve +## ☕ จำลอง -Test the actual use by performing tasks similar to real use. The system will automatically calculate the split of the work fraction according to the number of guilds. +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ -- Open a terminal and run `npm run emulators` to simulate the database system in **emulation mode**. -- Open a new terminal and run the command `npm run serve`. - > **💡 NOTE:** You will automatically enter development mode as this is a production simulation. Cause some features may not work. +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -## 🍵 Production +## 🍵 ใช้งานจริง -For actual use, the prepared command or set of commands can be used normally as follows: +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- On Linux or MacOS +- บน Linux หรือ MacOS ```sh # with command file (recommend) @@ -138,7 +134,7 @@ For actual use, the prepared command or set of commands can be used normally as npm start ``` -- On Windows +- บน Windows ```bat @REM with command file (recommend) @@ -150,42 +146,31 @@ For actual use, the prepared command or set of commands can be used normally as npm start ``` -### 🐳 Running on Docker +### 🐳 ทำงานบน Docker -This operation requires [Docker](https://www.docker.com/products/docker-desktop/) +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -- Use the command `npm run docker:build` and wait for all the work to complete. -- Then open the Docker program and run it with the required environment information (env) or use the command `npm run docker:run` and wait until the bot is running. - > **💡 NOTE**: You can check the functionality using the command `docker ps -a`. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -## Quick Troubleshooting +## แก้ไขปัญหาอย่างรวดเร็ว ### `gyp ERR! stack Error: not found: make` -This problem may be caused by **Build tools** being installed incorrectly or may not have been installed yet. This problem can be solved by looking at the [installation](#1-install-build-tools) section. +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) ### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` -It is possible that you have not yet simulated the database system on the machine in test mode. You can solve this problem by closing the bot and running the following command on another page. +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง ```bat npm run emulators ``` -## Improve Translate +## ปรับปรุงการแปลภาษา You can help us translate existing languages or languages that are not currently available on [Crowdin](https://crowdin.com/project/shioru). -## Credits - -Thank you to all the original creators for allowing us to use these wonderful works of yours. - -Personal drawing by: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) - ## Found a problem -If you encounter any problems from your current job You can let us know through the tab. [issue](https://github.com/Maseshi/Shioru/issues) of this repository. - -## Google Translate - -The content of this document has been translated by the [Google Translate](https://translate.google.com/) service. We apologize for any errors. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.es-ES.md b/documents/README.es-ES.md index 9b8ca07c..3150f7f6 100644 --- a/documents/README.es-ES.md +++ b/documents/README.es-ES.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -Su buen asistente de servidor ayudará a que su servidor se vea más animado. Ella puede hacer muchas cosas de las cuales puedes encontrar información detallada de diferentes comandos escribiendo `/help` Puedes invitar a Shioru a unirse a tu servidor desde[aquí](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ Su buen asistente de servidor ayudará a que su servidor se vea más animado. El - Soporte para la personalización de notificaciones del servidor - Puede hablar escribiendo `@Shioru` seguido del mensaje que desea comunicar. - Se puede utilizar el comando de aplicación (/). +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## requisitos previos -- [Node.js](https://nodejs.org/) v18.0.0 o superior -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Guía de configuración rápida +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Ir a [Portal de desarrolladores de Discord](https://discord.com/developers/applications) -- Haga clic en **"Nueva aplicación"** y asigne un nombre a su bot y acepte las reglas de la política de Discord. -- Vaya a la página **"Bot"** y habilite todas las opciones en la sección **Privileged Gateway Intent** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Invite a su bot al servidor yendo a la página **OAuth2 > Generador de URL** seleccione `bot` y `aplicaciones.comandos` seleccione `Administrador` luego copie el enlace y péguelo en la dirección de su navegador. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### configurar un bot - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Inicie una terminal y ejecute el siguiente comando. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Cambie el nombre del archivo `.env.example` a `.env` e inserte todos los valores necesarios. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Puede modificar algunos datos en **config** en `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Ir a [Portal de desarrolladores de Discord](https://discord.com/developers/applications) +- Haga clic en **"Nueva aplicación"** y asigne un nombre a su bot y acepte las reglas de la política de Discord. +- Vaya a la página **"Bot"** y habilite todas las opciones en la sección **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) -### Configurar base de fuego +### 4. ตั้งค่าฐานข้อมูล - Vaya a https://firebase.google.com/ y comience a configurar el proyecto. - Agrega un nuevo proyecto y sigue los pasos. - Agregue su primera aplicación con **Sitio web** Asigne un nombre opcional a su aplicación **"Configure también Firebase Hosting para esta aplicación"** y registre la aplicación. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase le proporcionará información sobre la configuración. Aplicar estos valores al archivo `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Vaya a **crear > [base de datos en tiempo real](https://console.firebase.google.com/u/0/project/_/database/data)** para crear una base de datos de almacenamiento. -### desarrollar +## 🪛 การพัฒนา -- Cambie el nombre del archivo `.env.example` a `.env` e inserte todos los valores necesarios. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Solución rápida de problemas +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Si no puede instalar el paquete **sodio** , instale **libsodium-wrappers** en su lugar. +## 🍵 ใช้งานจริง -```bat -npm desinstalar sodio -npm instalar libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Si no puede reproducir su música o los comandos de reproducción de música no funcionan, instale [ffmpeg](https://ffmpeg.org/download.html) **(recomendado)** o instale el paquete **ffmpeg-static** y vuelva a intentarlo. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Mejorar Traducir + sh start.sh || sudo sh start.sh -Puede ayudarnos a traducir un idioma existente o un idioma que no está disponible actualmente en [Crowdin](https://crowdin.com/project/shioru-bot). + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## crédito +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Gracias a todos los creadores originales por permitir el uso de estas maravillosas obras suyas. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Dibujo de avatar por: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +Puede ayudarnos a traducir un idioma existente o un idioma que no está disponible actualmente en [Crowdin](https://crowdin.com/project/shioru-bot). ## encontró un problema -Si encuentra algún problema de tu trabajo actual Puedes hacérnoslo saber a través de la pestaña [número](https://github.com/Maseshi/Shioru/issues) de este repositorio. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.fi.md b/documents/README.fi.md index fbaf3594..d920153b 100644 --- a/documents/README.fi.md +++ b/documents/README.fi.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[FI](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - Palvelimen ilmoitusten mukauttamisen tuki - Voit puhua kirjoittamalla `@Shioru` ja sen jälkeen viestin, jonka haluat kommunikoida. - Sovelluskomentoa (/) voidaan käyttää. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Edellytykset -- [Node.js](https://nodejs.org/) v18.0.0 tai uudempi -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Pika-asennusopas +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Siirry [Discord-kehittäjäportaaliin](https://discord.com/developers/applications) -- Napsauta **"Uusi sovellus"** ja nimeä bottisi ja hyväksy Discord-käytäntösäännöt. -- ไปที่หน้า **"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) - -### Asenna botti - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Käynnistä pääte ja suorita seuraava komento. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Nimeä tiedosto uudelleen `.env.example` muotoon `.env` ja lisää kaikki tarvittavat arvot. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Voit muokata joitain tietoja kohdassa **config** osoitteessa `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Siirry [Discord-kehittäjäportaaliin](https://discord.com/developers/applications) +- Napsauta **"Uusi sovellus"** ja nimeä bottisi ja hyväksy Discord-käytäntösäännöt. +- ไปที่หน้า **"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) -### Ota Firebase käyttöön +### 4. ตั้งค่าฐานข้อมูล - Siirry osoitteeseen https://firebase.google.com/ ja aloita projektin määrittäminen. - Lisää uusi projekti ja seuraa ohjeita. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Siirry kohtaan **luo > [reaaliaikainen tietokanta](https://console.firebase.google.com/u/0/project/_/database/data)** luodaksesi tallennustietokanta. -### kehittää +## 🪛 การพัฒนา -- Nimeä tiedosto uudelleen `.env.example` muotoon `.env` ja lisää kaikki tarvittavat arvot. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Nopea vianetsintä +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Jos et voi asentaa pakettia **natrium** , asenna sen sijaan **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm asentaa ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Jos et voi toistaa musiikkia tai musiikin toistokomennot eivät toimi, asenna [ffmpeg](https://ffmpeg.org/download.html) **(suositus)** tai asenna **ffmpeg-static** -paketti ja yritä uudelleen. +- บน Linux หรือ MacOS -```bat -npm asentaa ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Paranna käännöstä + sh start.sh || sudo sh start.sh -ja monia muita mielenkiintoisia ominaisuuksia... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## luotto +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Voit auttaa meitä kääntämään olemassa olevan kielen tai kielen, joka ei ole tällä hetkellä saatavilla osoitteessa [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Kiitos kaikille alkuperäisille tekijöille, jotka annoitte käyttää näitä upeita teoksianne. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +ja monia muita mielenkiintoisia ominaisuuksia... ## löysi ongelman -Avatar piirtäjä: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.fr.md b/documents/README.fr.md index e772e5d1..ad7609ae 100644 --- a/documents/README.fr.md +++ b/documents/README.fr.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -Votre bon assistant de serveur aidera votre serveur à paraître plus vivant. Elle peut faire beaucoup de choses dont vous pouvez trouver des informations détaillées sur différentes commandes en tapant `/help` Vous pouvez inviter Shioru à rejoindre votre serveur à partir de[ici](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ Votre bon assistant de serveur aidera votre serveur à paraître plus vivant. El - Prise en charge de la personnalisation des notifications du serveur - Vous pouvez parler en tapant `@Shioru` suivi du message que vous souhaitez communiquer. - La commande d'application (/) peut être utilisée. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Conditions préalables -- [Node.js](https://nodejs.org/) v18.0.0 ou supérieur -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Gite](https://git-scm.com/downloads) -## Guide d'installation rapide +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Aller à [Discord Developer Portal](https://discord.com/developers/applications) -- Cliquez sur **"Nouvelle application"** et donnez un nom à votre bot et acceptez les règles de la politique Discord. -- Allez à la page **"Bot"** et activez toutes les options dans la section **Privileged Gateway Intent** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Invitez votre bot sur le serveur en vous rendant sur la page **OAuth2 > Générateur d'URL** sélectionnez `bot` et `applications.commands` sélectionnez `Administrator` puis copiez le lien et collez-le dans l'adresse de votre navigateur. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### Configurer un bot - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Lancez un terminal et exécutez la commande suivante. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Renommez le fichier `.env.example` en `.env` et insérez toutes les valeurs nécessaires. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Vous pouvez modifier certaines données dans **config** à `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Aller à [Discord Developer Portal](https://discord.com/developers/applications) +- Cliquez sur **"Nouvelle application"** et donnez un nom à votre bot et acceptez les règles de la politique Discord. +- Allez à la page **"Bot"** et activez toutes les options dans la section **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) -### Configurer Firebase +### 4. ตั้งค่าฐานข้อมูล - Accédez à https://firebase.google.com/ et commencez à configurer le projet. - Ajoutez un nouveau projet et suivez les étapes. - Ajoutez votre première application avec **Site Web** Nommez éventuellement votre application **"Configurez également l'hébergement Firebase pour cette application"** et enregistrez l'application. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase vous fournira des informations sur la configuration. Appliquer ces valeurs au fichier `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Allez à **créer > [base de données temps réel](https://console.firebase.google.com/u/0/project/_/database/data)** pour créer une base de données de stockage. -### développer +## 🪛 การพัฒนา -- Renommez le fichier `.env.example` en `.env` et insérez toutes les valeurs nécessaires. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Dépannage rapide +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Si vous ne pouvez pas installer le package **sodium** , installez **libsodium-wrappers** à la place. +## 🍵 ใช้งานจริง -```bat -npm installer ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Si vous ne pouvez pas lire votre musique ou si les commandes de lecture de musique ne fonctionnent pas, installez [ffmpeg](https://ffmpeg.org/download.html) **(recommandé)** ou installez le package **ffmpeg-static** et réessayez. +- บน Linux หรือ MacOS -```bat -npm installer ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Améliorer Traduire + sh start.sh || sudo sh start.sh -Vous pouvez nous aider à traduire une langue existante ou une langue qui n'est pas disponible actuellement chez [Crowdin](https://crowdin.com/project/shioru-bot). + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## crédit +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Merci à tous les créateurs originaux d'avoir permis l'utilisation de ces merveilleuses œuvres. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Dessin d'avatar par : [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +Vous pouvez nous aider à traduire une langue existante ou une langue qui n'est pas disponible actuellement chez [Crowdin](https://crowdin.com/project/shioru-bot). ## trouvé un problème -Si vous rencontrez des problèmes de votre travail actuel Vous pouvez nous le faire savoir via l'onglet [numéro](https://github.com/Maseshi/Shioru/issues) de ce référentiel. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.hi.md b/documents/README.hi.md index ce464a27..ef582977 100644 --- a/documents/README.hi.md +++ b/documents/README.hi.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[एन](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [वें](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [जेए](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - सर्वर अधिसूचना अनुकूलन के लिए समर्थन - आप जिस संदेश से संवाद करना चाहते हैं उसके बाद `@Shioru` टाइप करके बात कर सकते हैं। - एप्लिकेशन कमांड (/) का उपयोग किया जा सकता है। +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard आपका अच्छा सर्वर सहायक आपके सर्वर को अधिक जीवंत दिखने में मदद करेगा। वह बहुत कुछ कर सकती है जिसके लिए आप `/help` टाइप करके विभिन्न कमांड की विस्तृत जानकारी प्राप्त कर सकते हैं।आप शिओरू को[यहाँ](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) ## आवश्यक शर्तें -- [Node.js](https://nodejs.org/) v18.0.0 या अधिक -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [गिट](https://www.ffmpeg.org/download.html) - [गिट](https://git-scm.com/downloads) -## त्वरित सेटअप गाइड +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- [डिसॉर्डर डेवलपर पोर्टल](https://discord.com/developers/applications)पर जाएं -- **"नया एप्लिकेशन"** पर क्लिक करें और अपने बॉट को नाम दें और डिस्कॉर्ड नीति नियमों को स्वीकार करें। -- ไปที่หน้า **"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) - -### एक बॉट सेट करें - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - एक टर्मिनल लॉन्च करें और निम्न कमांड चलाएँ। + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- फ़ाइल `.env.example` से `.env` का नाम बदलें और सभी आवश्यक मान डालें। -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- आप **कॉन्फ़िगरेशन** में `./source/config.js`में कुछ डेटा संशोधित कर सकते हैं +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- [डिसॉर्डर डेवलपर पोर्टल](https://discord.com/developers/applications)पर जाएं +- **"नया एप्लिकेशन"** पर क्लिक करें और अपने बॉट को नाम दें और डिस्कॉर्ड नीति नियमों को स्वीकार करें। +- ไปที่หน้า **"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) -### फायरबेस सेट करें +### 4. ตั้งค่าฐานข้อมูล - https://firebase.google.com/ पर जाएं और प्रोजेक्ट सेट करना शुरू करें। - एक नई परियोजना जोड़ें और चरणों का पालन करें। - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - स्टोरेज डेटाबेस बनाने के लिए **पर जाएं > [रीयलटाइम डेटाबेस](https://console.firebase.google.com/u/0/project/_/database/data)** बनाएं। -### विकास करना +## 🪛 การพัฒนา -- फ़ाइल `.env.example` से `.env` का नाम बदलें और सभी आवश्यक मान डालें। -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## त्वरित समस्या निवारण +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- यदि आप पैकेज **सोडियम** स्थापित नहीं कर सकते हैं, तो इसके बजाय **लिबसोडियम-रैपर** स्थापित करें। +## 🍵 ใช้งานจริง -```bat -npm ffmpeg-स्थिर @ नवीनतम स्थापित करें --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- यदि आप अपना संगीत नहीं चला सकते हैं या संगीत प्लेबैक आदेश काम नहीं करते हैं, तो [ffmpeg](https://ffmpeg.org/download.html) **(अनुशंसित)** स्थापित करें या **ffmpeg-स्थैतिक** पैकेज स्थापित करें और पुनः प्रयास करें। +- บน Linux หรือ MacOS -```bat -npm ffmpeg-स्थिर @ नवीनतम स्थापित करें --save -``` + ```sh + # with command file (recommend) -## अनुवाद में सुधार करें + sh start.sh || sudo sh start.sh -और कई अन्य रोचक विशेषताएं... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## श्रेय +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -आप किसी मौजूदा भाषा या ऐसी भाषा का अनुवाद करने में हमारी मदद कर सकते हैं जो वर्तमान में [Crowdin](https://crowdin.com/project/shioru-bot)पर उपलब्ध नहीं है। +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -अपने इन अद्भुत कार्यों के उपयोग की अनुमति देने के लिए सभी मूल रचनाकारों को धन्यवाद। +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +और कई अन्य रोचक विशेषताएं... ## एक समस्या मिली -अवतार आरेखण द्वारा: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.hr.md b/documents/README.hr.md index 0497b63b..caadb716 100644 --- a/documents/README.hr.md +++ b/documents/README.hr.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[HR](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ - Podrška za prilagodbu obavijesti poslužitelja - Možete razgovarati upisivanjem `@Shioru` nakon čega slijedi poruka koju želite komunicirati. - Može se koristiti naredba aplikacije (/). +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Preduvjeti -- [Node.js](https://nodejs.org/) v18.0.0 ili noviji -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Vodič za brzo postavljanje +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Idite na [Discord Developer Portal](https://discord.com/developers/applications) -- Kliknite **"Nova aplikacija"** i imenujte svog bota te prihvatite pravila pravila Discorda. -- ไปที่หน้า **"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) - -### Postavite bota - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Pokrenite terminal i pokrenite sljedeću naredbu. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Preimenujte datoteku `.env.example` u `.env` i umetnite sve potrebne vrijednosti. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Možete izmijeniti neke podatke u **config** na `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Idite na [Discord Developer Portal](https://discord.com/developers/applications) +- Kliknite **"Nova aplikacija"** i imenujte svog bota te prihvatite pravila pravila Discorda. +- ไปที่หน้า **"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) -### Postavite Firebase +### 4. ตั้งค่าฐานข้อมูล - Idite na https://firebase.google.com/ i počnite postavljati projekt. - Dodajte novi projekt i slijedite korake. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Idite na **stvoriti > [bazu podataka u stvarnom vremenu](https://console.firebase.google.com/u/0/project/_/database/data)** za stvaranje baze podataka za pohranu. -### razviti +## 🪛 การพัฒนา -- Preimenujte datoteku `.env.example` u `.env` i umetnite sve potrebne vrijednosti. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Brzo rješavanje problema +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Ako ne možete instalirati paket **sodium** , umjesto toga instalirajte **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm uninstall sodium -npm install libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Ako ne možete reproducirati svoju glazbu ili naredbe za reprodukciju glazbe ne rade, instalirajte [ffmpeg](https://ffmpeg.org/download.html) **(preporučeno)** ili instalirajte **ffmpeg-static** paket i pokušajte ponovno. +- บน Linux หรือ MacOS -```bat -npm instaliraj ffmpeg-static@najnovije --spremi -``` + ```sh + # with command file (recommend) -## Poboljšajte Prevoditelj + sh start.sh || sudo sh start.sh -i mnoge druge zanimljive karakteristike... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## Kreditna +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Možete nam pomoći prevesti postojeći jezik ili jezik koji trenutno nije dostupan na [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Hvala svim izvornim stvarateljima što su dopustili korištenje ovih vaših prekrasnih djela. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +i mnoge druge zanimljive karakteristike... ## pronašao problem -Crtanje avatara: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.hu.md b/documents/README.hu.md index 81fa1048..3cde6cdb 100644 --- a/documents/README.hu.md +++ b/documents/README.hu.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[HU](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ - Támogatás a szerver értesítések testreszabásához - Beszélhet úgy, hogy beírja `@Shioru` számot, majd a kommunikálni kívánt üzenetet. - Az alkalmazásparancs (/) használható. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Előfeltételek -- [Node.js](https://nodejs.org/) v18.0.0 vagy újabb -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Gyors telepítési útmutató +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Lépjen a [Discord fejlesztői portálra](https://discord.com/developers/applications) -- Kattintson **„Új alkalmazás”** lehetőségre, nevezze el a botját, és fogadja el a Discord szabályzat szabályait. -- ไปที่หน้า **"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) - -### Állíts be egy botot - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Indítson el egy terminált, és futtassa a következő parancsot. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Nevezze át a fájlt `.env.example` re `.env` ra, és írja be az összes szükséges értéket. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Néhány adatot módosíthat a **config** -ben a `./source/config.js`címen. +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Lépjen a [Discord fejlesztői portálra](https://discord.com/developers/applications) +- Kattintson **„Új alkalmazás”** lehetőségre, nevezze el a botját, és fogadja el a Discord szabályzat szabályait. +- ไปที่หน้า **"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) -### A Firebase beállítása +### 4. ตั้งค่าฐานข้อมูล - Nyissa meg a https://firebase.google.com/ oldalt, és kezdje el a projekt beállítását. - Adjon hozzá egy új projektet, és kövesse a lépéseket. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Menjen a **létrehozása > [valós idejű adatbázis létrehozásához](https://console.firebase.google.com/u/0/project/_/database/data)** tároló adatbázis létrehozásához. -### fejleszteni +## 🪛 การพัฒนา -- Nevezze át a fájlt `.env.example` re `.env` ra, és írja be az összes szükséges értéket. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Gyors hibaelhárítás +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Ha nem tudja telepíteni **sodium** csomagot, telepítsen helyette **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm uninstall sodium -npm install libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Ha nem tudja lejátszani a zenét, vagy a zenelejátszási parancsok nem működnek, telepítse [ffmpeg](https://ffmpeg.org/download.html) **(ajánlott)** vagy a **ffmpeg-static** csomagot, és próbálkozzon újra. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## A Fordítás javítása + sh start.sh || sudo sh start.sh -és még sok más érdekes funkció... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## hitel +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Segíthet nekünk lefordítani egy meglévő vagy egy olyan nyelvet, amely jelenleg nem érhető el [Crowdin](https://crowdin.com/project/shioru-bot)webhelyen. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Köszönet minden eredeti alkotónak, hogy lehetővé tették e csodálatos műveid felhasználását. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +és még sok más érdekes funkció... ## problémát talált -Ha bármilyen problémába ütközik jelenlegi munkahelyétől Értesíthet minket a tárház [probléma](https://github.com/Maseshi/Shioru/issues) lapján. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.id.md b/documents/README.id.md index f3f622ef..4d7599c0 100644 --- a/documents/README.id.md +++ b/documents/README.id.md @@ -1,8 +1,8 @@
- +

Shioru

-

Asisten bawaan server Discord akan membantu Anda menjadikan server Anda tempat yang lebih baik

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [Ubah bahasa](https://github.com/Maseshi/Shioru/tree/main/documents) -Asisten peladen yang baik akan membantu peladen Anda terlihat lebih hidup. Dia dapat melakukan banyak hal, yang dapat Anda lihat secara detail dengan mengetik `/help`. Anda dapat mengundang Shioru ke server Anda dari [sini](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). +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,76 +43,127 @@ Asisten peladen yang baik akan membantu peladen Anda terlihat lebih hidup. Dia d - Dukungan untuk kustomisasi pemberitahuan server - Anda dapat berbicara dengan mengetikkan `@Shioru` diikuti dengan pesan yang ingin Anda komunikasikan. - Perintah aplikasi (/) dapat digunakan. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard dan banyak fitur menarik lainnya... ## Prasyarat -- [Node.js](https://nodejs.org/) v18.0.0 atau lebih tinggi -- [Python](https://www.python.org/downloads/) v2.0.0 atau lebih tinggi -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Panduan Pengaturan Cepat +## การติดตั้ง -Diuji pada sistem Mac, Linux, dan Windows. +### 1. ติดตั้ง **Build Tools** -### Tambahkan bot ke server +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Buka [Portal Pengembang Discord](https://discord.com/developers/applications) -- Klik **"Aplikasi Baru"** dan beri nama bot Anda dan setujui aturan kebijakan Discord -- Buka halaman **"Bot"** dan aktifkan semua opsi di bagian "Bot". **Maksud Gerbang Khusus** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Undang bot Anda ke server dengan membuka halaman **OAuth2 > URL Generator**, pilih `bot` dan `applications.commands` lalu pilih `. Administrator` lalu salin tautan dan tempelkan di alamat peramban Anda. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### Siapkan bot - -Karena kami menggunakan [natrium](https://www.npmjs.com/package/sodium) dalam penyandian dan pengodean, maka kami perlu menginstal komponen tambahan berikut ini: - -```bat -@REM pada Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# Di MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# Di Linux -sudo apt-get instal libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Luncurkan terminal dan jalankan perintah berikut. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Ganti nama file `.env.example` menjadi `.env` dan masukkan semua nilai yang diperlukan. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) + +### 3. ตั้งค่าบอทและเชิญเข้าร่วม -- Anda dapat memodifikasi beberapa data di **config** di `./source/config.js` +- Buka [Portal Pengembang Discord](https://discord.com/developers/applications) +- Klik **"Aplikasi Baru"** dan beri nama bot Anda dan setujui aturan kebijakan Discord +- Buka halaman **"Bot"** dan aktifkan semua opsi di bagian "Bot". **Maksud Gerbang Khusus** ![](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) -### Siapkan Firebase +### 4. ตั้งค่าฐานข้อมูล - Buka https://firebase.google.com/ dan mulailah menyiapkan proyek Anda. - Tambahkan proyek baru dan ikuti langkah-langkahnya. - Tambahkan juga aplikasi pertama Anda. **Situs Web** Beri nama aplikasi Anda tanpa perlu memilih opsi **"Siapkan Firebase Hosting untuk aplikasi ini"** dan daftarkan aplikasi. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase akan memberi Anda informasi tentang konfigurasinya. Terapkan nilai-nilai ini pada berkas. `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Buka **Create > [Real-time database](https://console.firebase.google.com/u/0/project/_/database/data)** Untuk membuat database untuk menyimpan data. -### mengembangkan +## 🪛 การพัฒนา -- Ganti nama file `.env.example` menjadi `.env` dan masukkan semua nilai yang diperlukan. -- Buka terminal dan jalankan perintah `npm run dev` untuk pengembangan dan `npm start` untuk produksi. > **Catatan**: Saat Anda memasuki mode pengembangan. Beberapa fitur mungkin dinonaktifkan, seperti mengirim statistik, memperbarui data, dll. +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น + +## ☕ จำลอง + +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ + +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน + +## 🍵 ใช้งานจริง + +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -## Pemecahan Masalah Cepat +- บน Linux หรือ MacOS -- Jika Anda mengalami masalah selama instalasi komponen di mana pada terminal tertulis `gyp ERR! stack Error: not found: make` Masalah ini mungkin disebabkan oleh **Build tools** yang tidak terinstal dengan benar atau mungkin belum terinstal. Solusinya adalah mengunduh versi terbaru. [Node.js](https://nodejs.org/) dan periksa bagian ini dalam proses instalasi. + ```sh + # with command file (recommend) - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + sh start.sh || sudo sh start.sh + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker + +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) + +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` + +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +<<<<<<< HEAD - Jika Anda tidak dapat menginstal package **sodium** , instal **libsodium-wrappers** sebagai gantinya. ```bat @@ -145,3 +196,16 @@ Gambar avatar oleh: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en ## menemukan masalah Jika Anda mengalami masalah dalam pekerjaan Anda saat ini, Anda dapat memberi tahu kami melalui tab [masalah](https://github.com/Maseshi/Shioru/issues) pada repositori ini. +======= +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +Anda dapat membantu kami menerjemahkan bahasa yang sudah ada atau bahasa yang saat ini belum tersedia di [Crowdin](https://crowdin.com/project/shioru). + +## menemukan masalah + +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ +>>>>>>> 7cd9c5100281cee9c71d556039e6a723965221fa diff --git a/documents/README.it.md b/documents/README.it.md index fbd3031b..0942aaa9 100644 --- a/documents/README.it.md +++ b/documents/README.it.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -Il tuo buon assistente del server aiuterà il tuo server a sembrare più vivace. Può fare molte cose di cui puoi trovare informazioni dettagliate su diversi comandi digitando `/help` Puoi invitare Shioru a unirsi al tuo server da[qui](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ Il tuo buon assistente del server aiuterà il tuo server a sembrare più vivace. - Supporto per la personalizzazione delle notifiche del server - Puoi parlare digitando `@Shioru` seguito dal messaggio che vuoi comunicare. - È possibile utilizzare il comando dell'applicazione (/). +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard e molte altre caratteristiche interessanti... ## Prerequisiti -- [Node.js](https://nodejs.org/) v18.0.0 o versione successiva -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Guida rapida all'installazione +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Vai a [Portale per sviluppatori Discord](https://discord.com/developers/applications) -- Fai clic su **"Nuova applicazione"** e dai un nome al tuo bot e accetta le regole della politica di Discord. -- Vai alla pagina **"Bot"** e abilita tutte le opzioni nella sezione **Privileged Gateway Intent** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Invita il tuo bot sul server andando alla pagina **OAuth2 > URL Generator** seleziona `bot` e `application.commands` seleziona `Administrator` quindi copia il link e incollalo nell'indirizzo del tuo browser. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### Imposta un bot - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Avvia un terminale ed esegui il seguente comando. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Rinominare il file `.env.example` in `.env` e inserire tutti i valori necessari. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Puoi modificare alcuni dati in **config** in `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Vai a [Portale per sviluppatori Discord](https://discord.com/developers/applications) +- Fai clic su **"Nuova applicazione"** e dai un nome al tuo bot e accetta le regole della politica di Discord. +- Vai alla pagina **"Bot"** e abilita tutte le opzioni nella sezione **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) -### Configura Firebase +### 4. ตั้งค่าฐานข้อมูล - Vai su https://firebase.google.com/ e inizia a configurare il progetto. - Aggiungi un nuovo progetto e segui i passaggi. - Aggiungi la tua prima applicazione con **Sito web** Assegna un nome facoltativo alla tua app **"Imposta anche Firebase Hosting per questa app"** e registra l'app. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase ti fornirà informazioni sulla configurazione. Applica questi valori al file `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Vai a **crea > [database in tempo reale](https://console.firebase.google.com/u/0/project/_/database/data)** per creare un database di archiviazione. -### sviluppare +## 🪛 การพัฒนา -- Rinominare il file `.env.example` in `.env` e inserire tutti i valori necessari. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Risoluzione rapida dei problemi +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Se non puoi installare il pacchetto **sodium** , installa invece **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm uninstall sodium -npm install libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Se non riesci a riprodurre la tua musica o i comandi di riproduzione musicale non funzionano, installa [ffmpeg](https://ffmpeg.org/download.html) **(consigliato)** o installa il pacchetto **ffmpeg-static** e riprova. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Migliora Traduci + sh start.sh || sudo sh start.sh -Puoi aiutarci a tradurre una lingua esistente o una lingua che non è attualmente disponibile su [Crowdin](https://crowdin.com/project/shioru-bot). + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## credito +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Grazie a tutti i creatori originali per aver permesso l'uso di queste tue meravigliose opere. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Disegno avatar di: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +Puoi aiutarci a tradurre una lingua esistente o una lingua che non è attualmente disponibile su [Crowdin](https://crowdin.com/project/shioru-bot). ## trovato un problema -In caso di problemi dal tuo lavoro attuale Puoi farcelo sapere tramite la scheda [issue](https://github.com/Maseshi/Shioru/issues) di questo repository. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.ja.md b/documents/README.ja.md index 210aa6cc..f2028e0d 100644 --- a/documents/README.ja.md +++ b/documents/README.ja.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -優れたサーバー アシスタントは、サーバーをより活発に見せるのに役立ちます。 彼女ができることはたくさんあり、詳細なコマンドは `/help` を入力して見つけることができます [ここ](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ - サーバー通知のカスタマイズのサポート - `@Shioru`の後に伝えたいメッセージを入力すると、チャットできます。 - アプリケーションコマンド (/) が使用できます。 +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard 他にもたくさんの興味深い機能があります... ## 前提条件 -- [Node.js](https://nodejs.org/) v18.0.0 以降 -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## クイックセットアップガイド +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- [Discord Developer Portal](https://discord.com/developers/applications) に移動します。 -- **"New Application"**をクリックしてボットに名前を付け、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) - -### ボットを設定する - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - ターミナルを起動し、次のコマンドを実行します。 + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- ファイルの名前を変更します `.env.example` を `.env` として、必要なすべての値を挿入します。 -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- `./source/config.js` の **config** で一部の情報を編集できます。 +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- [Discord Developer Portal](https://discord.com/developers/applications) に移動します。 +- **"New Application"**をクリックしてボットに名前を付け、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) -### Firebase をセットアップする +### 4. ตั้งค่าฐานข้อมูล - https://firebase.google.com/ にアクセスして、プロジェクトのセットアップを開始します。 - 新しいプロジェクトを追加し、手順に従います。 - 最初のアプリケーションを **ウェブサイト** に追加し、オプション **「このアプリの Firebase Hosting もセットアップする」** を選択せず​​にアプリに名前を付けて、アプリを登録します。 ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase は構成に関する情報を提供します。 これらの値をファイルに適用します。 `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - **[作成] > [リアルタイム データベース](https://console.firebase.google.com/u/0/project/_/database/data)** に移動して、ストレージ データベースを作成します。 -### 発展させる +## 🪛 การพัฒนา -- ファイルの名前を変更します `.env.example` を `.env` として、必要なすべての値を挿入します。 -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## クイックトラブルシューティング +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- **sodium** パッケージをインストールできない場合は、代わりに **libsodium-wrappers** をインストールしてください。 +## 🍵 ใช้งานจริง -```bat -npm アンインストールナトリウム -npm インストール libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- 音楽を再生できない、または音楽再生コマンドが機能しない場合は、[ffmpeg](https://ffmpeg.org/download.html) **(推奨)** をインストールするか、パッケージをインストールしてください。 **ffmpeg-static** して再試行してください。 +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## 翻訳を改善する + sh start.sh || sudo sh start.sh -既存の言語または現在 [Crowdin](https://crowdin.com/project/shioru-bot). で利用できない言語の翻訳にご協力ください。 + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## クレジット +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -これらの素晴らしい作品の使用を許可してくれたすべてのオリジナル クリエイターに感謝します。 +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -アバターペイント: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +既存の言語または現在 [Crowdin](https://crowdin.com/project/shioru-bot). で利用できない言語の翻訳にご協力ください。 ## 問題が見つかりました -問題が発生した場合 現在の仕事から タブからお知らせください。 [issue](https://github.com/Maseshi/Shioru/issues) のリポジトリです。 +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.ko.md b/documents/README.ko.md index 4c4d21dc..927b78c5 100644 --- a/documents/README.ko.md +++ b/documents/README.ko.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -당신의 좋은 서버 도우미는 당신의 서버가 더 활기차게 보이도록 도와줄 것입니다. 그녀는 `/help` 여기[에서 서버에 가입하도록 Shioru를 초대할 수 있습니다](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - 서버 알림 사용자 정의 지원 - `@Shioru` 다음에 전달하고 싶은 메시지를 입력하여 대화할 수 있습니다. - 응용 명령어(/)를 사용할 수 있습니다. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard 그리고 다른 많은 흥미로운 기능들... ## 전제 조건 -- [Node.js](https://nodejs.org/) v18.0.0 이상 -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## 빠른 설정 가이드 +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Discord 개발자 포털로 이동 -- **"새 애플리케이션"** 클릭하고 봇에 이름을 지정하고 Discord 정책 규칙을 수락합니다. -- 페이지 **"Bot"** 로 이동하여 섹션 **Privileged Gateway Intent** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- 페이지 **OAuth2 > URL 생성기** 선택 `봇` 및 `applications.commands` 선택 `관리자` 로 이동하여 봇을 서버에 초대한 다음 링크를 복사하여 브라우저 주소에 붙여넣습니다. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### 봇 설정 - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - 터미널을 실행하고 다음 명령을 실행합니다. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- 파일 `.env.example` 의 이름을 `.env` 으로 바꾸고 필요한 모든 값을 삽입합니다. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- **config** at `./source/config.js`에서 일부 데이터를 수정할 수 있습니다. +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Discord 개발자 포털로 이동 +- **"새 애플리케이션"** 클릭하고 봇에 이름을 지정하고 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) -### Firebase 설정 +### 4. ตั้งค่าฐานข้อมูล - https://firebase.google.com/으로 이동하여 프로젝트 설정을 시작합니다. - 새 프로젝트를 추가하고 단계를 따릅니다. -- 웹사이트 \***\* 있는 첫 번째 애플리케이션을 추가합니다 **선택적으로 앱 이름\*\* 지정합니다. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase에서 구성에 대한 정보를 제공합니다. 이 값을 파일 `.env.example`에 적용합니다. +- 웹사이트 **** 있는 첫 번째 애플리케이션을 추가합니다 **선택적으로 앱 이름** 지정합니다. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - **create > [realtime database](https://console.firebase.google.com/u/0/project/_/database/data)** 로 이동하여 스토리지 데이터베이스를 생성합니다. -### 개발하다 +## 🪛 การพัฒนา -- 파일 `.env.example` 의 이름을 `.env` 으로 바꾸고 필요한 모든 값을 삽입합니다. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## 빠른 문제 해결 +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- 패키지 **나트륨** 설치할 수 없는 경우 대신 **libsodium-wrappers** 을 설치하십시오. +## 🍵 ใช้งานจริง -```bat -npm 설치 ffmpeg-static@latest --저장 -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- 음악을 재생할 수 없거나 음악 재생 명령이 작동하지 않으면 [ffmpeg](https://ffmpeg.org/download.html) **(권장)** 설치하거나 **ffmpeg-static** 패키지를 설치하고 다시 시도하십시오. +- บน Linux หรือ MacOS -```bat -npm 설치 ffmpeg-static@latest --저장 -``` + ```sh + # with command file (recommend) -## 번역 개선 + sh start.sh || sudo sh start.sh -기존 언어 또는 현재 [Crowdin](https://crowdin.com/project/shioru-bot)에서 사용할 수 없는 언어를 번역하는 데 도움을 줄 수 있습니다. + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## 신용 거래 +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -당신의 멋진 작품을 사용할 수 있도록 허락해주신 모든 오리지널 크리에이터들에게 감사드립니다. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -아바타 작화: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +기존 언어 또는 현재 [Crowdin](https://crowdin.com/project/shioru-bot)에서 사용할 수 없는 언어를 번역하는 데 도움을 줄 수 있습니다. ## 문제를 발견 -문제가 발생하면 현재 작업에서 이 저장소의 [issue](https://github.com/Maseshi/Shioru/issues) 탭을 통해 알려주실 수 있습니다. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.lt.md b/documents/README.lt.md index 9cc9052d..23180016 100644 --- a/documents/README.lt.md +++ b/documents/README.lt.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[LT](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - Serverio pranešimų tinkinimo palaikymas - Galite kalbėti įvesdami `@Shioru` , o po to pranešimo, su kuriuo norite susisiekti. - Galima naudoti programos komandą (/). +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Būtinos sąlygos -- [Node.js](https://nodejs.org/) v18.0.0 arba naujesnė versija -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Greitos sąrankos vadovas +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Eikite į [Discord kūrėjų portalą](https://discord.com/developers/applications) -- Spustelėkite **„Nauja programa“** , pavadinkite savo robotą ir sutikite su „Discord“ politikos taisyklėmis. -- ไปที่หน้า **"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) - -### Nustatykite robotą - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Paleiskite terminalą ir paleiskite šią komandą. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Pervardykite failą `.env.example` į `.env` ir įterpkite visas reikalingas reikšmes. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Kai kuriuos duomenis galite keisti **config** adresu `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Eikite į [Discord kūrėjų portalą](https://discord.com/developers/applications) +- Spustelėkite **„Nauja programa“** , pavadinkite savo robotą ir sutikite su „Discord“ politikos taisyklėmis. +- ไปที่หน้า **"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) -### Nustatykite „Firebase“. +### 4. ตั้งค่าฐานข้อมูล - Eikite į https://firebase.google.com/ ir pradėkite nustatyti projektą. - Pridėkite naują projektą ir atlikite nurodytus veiksmus. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Eikite į **sukurti > [realaus laiko duomenų bazę](https://console.firebase.google.com/u/0/project/_/database/data)** norėdami sukurti saugojimo duomenų bazę. -### vystytis +## 🪛 การพัฒนา -- Pervardykite failą `.env.example` į `.env` ir įterpkite visas reikalingas reikšmes. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Greitas trikčių šalinimas +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Jei negalite įdiegti paketo **sodium** , vietoj to įdiekite **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm įdiegti ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Jei negalite leisti muzikos arba muzikos atkūrimo komandos neveikia, įdiekite [ffmpeg](https://ffmpeg.org/download.html) **(rekomenduojama)** arba įdiekite paketą **ffmpeg-static** ir bandykite dar kartą. +- บน Linux หรือ MacOS -```bat -npm įdiegti ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Tobulinti vertimą + sh start.sh || sudo sh start.sh -ir daug kitų įdomių funkcijų... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## kreditas +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Galite padėti mums išversti esamą kalbą arba kalbą, kurios šiuo metu nėra [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Dėkojame visiems originaliems kūrėjams už leidimą naudoti šiuos nuostabius jūsų kūrinius. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +ir daug kitų įdomių funkcijų... ## rado problemą -Avataro piešinys: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.nl.md b/documents/README.nl.md index 59fe4fe3..80da2034 100644 --- a/documents/README.nl.md +++ b/documents/README.nl.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -Uw goede serverassistent zal ervoor zorgen dat uw server er levendiger uitziet. Ze kan veel dingen doen waarvan je gedetailleerde informatie over verschillende commando's kunt vinden door `/help` te typen.Je kunt Shioru uitnodigen om lid te worden van je server vanaf[hier](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ Uw goede serverassistent zal ervoor zorgen dat uw server er levendiger uitziet. - Ondersteuning voor aanpassing van servermeldingen - U kunt praten door `@Shioru` te typen, gevolgd door het bericht dat u wilt communiceren. - Het toepassingscommando (/) kan worden gebruikt. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard en vele andere interessante functies... ## ข้อกำหนดเบื้องต้น -- [Node.js](https://nodejs.org/) v18.0.0 of hoger -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Handleiding voor snelle installatie +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Ga naar [Discord Developer Portal](https://discord.com/developers/applications) -- Klik op **"Nieuwe toepassing"** en geef uw bot een naam en accepteer de Discord-beleidsregels. -- Ga naar pagina **"Bot"** en schakel alle opties in sectie **Privileged Gateway Intent** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Nodig uw bot uit voor de server door naar pagina **OAuth2 > URL Generator** te gaan selecteer `bot` en `applications.commands` selecteer `Beheerder` kopieer de link en plak deze in het adres van uw browser. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### ตั้งค่าบอท - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Start een terminal en voer de volgende opdracht uit. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Hernoem het bestand `.env.example` naar `.env` en voer alle benodigde waarden in. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- U kunt enkele gegevens wijzigen in **config** op `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Ga naar [Discord Developer Portal](https://discord.com/developers/applications) +- Klik op **"Nieuwe toepassing"** en geef uw bot een naam en accepteer de Discord-beleidsregels. +- Ga naar pagina **"Bot"** en schakel alle opties in sectie **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) -### Stel Firebase in +### 4. ตั้งค่าฐานข้อมูล - Ga naar https://firebase.google.com/ en begin met het opzetten van het project. - Voeg een nieuw project toe en volg de stappen. - Voeg uw eerste applicatie toe met **Website** Noem uw app optioneel **"Stel ook Firebase Hosting in voor deze app"** en registreer de app. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase geeft u informatie over de configuratie. Pas deze waarden toe op bestand `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Ga naar **maak > [realtime database](https://console.firebase.google.com/u/0/project/_/database/data)** om een opslagdatabase aan te maken. -### ontwikkelen +## 🪛 การพัฒนา -- Hernoem het bestand `.env.example` naar `.env` en voer alle benodigde waarden in. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Snelle probleemoplossing +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Als u pakket **sodium** niet kunt installeren, installeer dan in plaats daarvan **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm natrium verwijderen -npm installeren libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Als je je muziek niet kunt afspelen of als de afspeelopdrachten voor muziek niet werken, installeer dan [ffmpeg](https://ffmpeg.org/download.html) **(aanbevolen)** of installeer het **ffmpeg-static** pakket en probeer het opnieuw. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Verbeter vertalen + sh start.sh || sudo sh start.sh -U kunt ons helpen een bestaande taal te vertalen of een taal die momenteel niet beschikbaar is bij [Crowdin](https://crowdin.com/project/shioru-bot). + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## credit +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Bedankt aan alle oorspronkelijke makers voor het toestaan van het gebruik van deze prachtige werken van jou. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Avatartekening door: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +U kunt ons helpen een bestaande taal te vertalen of een taal die momenteel niet beschikbaar is bij [Crowdin](https://crowdin.com/project/shioru-bot). ## een probleem gevonden -Als u problemen ondervindt van je huidige werk U kunt ons dit laten weten via het tabblad [nummer](https://github.com/Maseshi/Shioru/issues) van deze repository. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.no.md b/documents/README.no.md index cc7f2bb0..5ed8d432 100644 --- a/documents/README.no.md +++ b/documents/README.no.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[NO](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - Støtte for tilpasning av servervarsling - Du kan snakke ved å skrive `@Shioru` etterfulgt av meldingen du vil kommunisere. - Programkommandoen (/) kan brukes. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Forutsetninger -- [Node.js](https://nodejs.org/) v18.0.0 eller nyere -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Hurtigoppsettguide +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Gå til [Discord Developer Portal](https://discord.com/developers/applications) -- Klikk **"Ny applikasjon"** og navngi boten din og godta Discord-policyreglene. -- ไปที่หน้า **"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) - -### Sett opp en bot - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Start en terminal og kjør følgende kommando. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Gi nytt navn til filen `.env.example` til `.env` og sett inn alle nødvendige verdier. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Du kan endre noen data i **config** på `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Gå til [Discord Developer Portal](https://discord.com/developers/applications) +- Klikk **"Ny applikasjon"** og navngi boten din og godta Discord-policyreglene. +- ไปที่หน้า **"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) -### Konfigurer Firebase +### 4. ตั้งค่าฐานข้อมูล - Gå til https://firebase.google.com/ og begynn å sette opp prosjektet. - Legg til et nytt prosjekt og følg trinnene. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Gå til **opprette > [sanntidsdatabase](https://console.firebase.google.com/u/0/project/_/database/data)** for å opprette en lagringsdatabase. -### utvikle +## 🪛 การพัฒนา -- Gi nytt navn til filen `.env.example` til `.env` og sett inn alle nødvendige verdier. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Rask feilsøking +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Hvis du ikke kan installere pakke **sodium** , installer **libsodium-wrappers** i stedet. +## 🍵 ใช้งานจริง -```bat -npm installer ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Hvis du ikke kan spille musikk eller musikkavspillingskommandoer ikke fungerer, installer [ffmpeg](https://ffmpeg.org/download.html) **(anbefalt)** eller installer **ffmpeg-static** -pakken og prøv igjen. +- บน Linux หรือ MacOS -```bat -npm installer ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Forbedre Oversett + sh start.sh || sudo sh start.sh -og mange andre interessante funksjoner... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## kreditt +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Du kan hjelpe oss med å oversette et eksisterende språk eller et språk som for øyeblikket ikke er tilgjengelig på [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Takk til alle originale skapere for å tillate bruken av disse fantastiske verkene dine. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +og mange andre interessante funksjoner... ## funnet et problem -Avatartegning av: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.pl.md b/documents/README.pl.md index 3db245f3..a7626189 100644 --- a/documents/README.pl.md +++ b/documents/README.pl.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -Twój dobry asystent serwera sprawi, że Twój serwer będzie wyglądał bardziej żywo. Potrafi robić wiele rzeczy, a szczegółowe informacje o różnych komendach można znaleźć, wpisując `/help` Możesz zaprosić Shioru do dołączenia do twojego serwera z[tutaj](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,100 +43,134 @@ Twój dobry asystent serwera sprawi, że Twój serwer będzie wyglądał bardzie - Obsługa dostosowywania powiadomień serwera - Możesz rozmawiać, wpisując `@Shioru` , a następnie wiadomość, którą chcesz przekazać. - Można użyć polecenia aplikacji (/). +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard i wiele innych ciekawych funkcji... ## Wymagania wstępne -- [Node.js](https://nodejs.org/) w wersji 18.0.0 lub nowszej -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Podręcznik szybkiej obsługi +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Idź do [Portal deweloperów Discord](https://discord.com/developers/applications) -- Kliknij **„Nowa aplikacja”** i nadaj swojemu botowi nazwę oraz zaakceptuj zasady polityki Discord. -- Przejdź do strony **„Bot”** i włącz wszystkie opcje w sekcji **Privileged Gateway Intent** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Zaproś swojego bota na serwer wchodząc na stronę **OAuth2 > Generator URL** wybierz `bot` i `application.commands` wybierz `Administrator` następnie skopiuj link i wklej go w adres swojej przeglądarki. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### Skonfiguruj bota - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Uruchom terminal i uruchom następujące polecenie. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Zmień nazwę pliku `.env.example` na `.env` i wstaw wszystkie niezbędne wartości. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Możesz zmodyfikować niektóre dane w **config** w `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Idź do [Portal deweloperów Discord](https://discord.com/developers/applications) +- Kliknij **„Nowa aplikacja”** i nadaj swojemu botowi nazwę oraz zaakceptuj zasady polityki Discord. +- Przejdź do strony **„Bot”** i włącz wszystkie opcje w sekcji **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) -### Skonfiguruj Firebase +### 4. ตั้งค่าฐานข้อมูล - Przejdź do https://firebase.google.com/ i rozpocznij konfigurowanie projektu. - Dodaj nowy projekt i postępuj zgodnie z instrukcjami. - Dodaj swoją pierwszą aplikację za pomocą **Witryna** Opcjonalnie nazwij swoją aplikację **„Skonfiguruj także Hosting Firebase dla tej aplikacji”** i zarejestruj aplikację. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase dostarczy Ci informacji o konfiguracji. Zastosuj te wartości do pliku `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Przejdź do **utwórz > [bazę danych czasu rzeczywistego](https://console.firebase.google.com/u/0/project/_/database/data)** , aby utworzyć bazę danych magazynu. -### rozwijać +## 🪛 การพัฒนา -- Zmień nazwę pliku `.env.example` na `.env` i wstaw wszystkie niezbędne wartości. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Szybkie rozwiązywanie problemów +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Jeśli nie możesz zainstalować pakietu **sodu** , zamiast tego zainstaluj **pakiety libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -git klon https://github.com/Maseshi/Shioru.git -cd Shioru -npm zainstaluj --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Jeśli nie możesz odtwarzać muzyki lub polecenia odtwarzania muzyki nie działają, zainstaluj [ffmpeg](https://ffmpeg.org/download.html) **(zalecane)** lub zainstaluj pakiet **ffmpeg-static** i spróbuj ponownie. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Popraw tłumaczenie + sh start.sh || sudo sh start.sh -Możesz pomóc nam przetłumaczyć istniejący język lub język, który nie jest obecnie dostępny w [Crowdin](https://crowdin.com/project/shioru-bot). + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## kredyt +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Dziękuję wszystkim oryginalnym twórcom za umożliwienie korzystania z tych wspaniałych dzieł. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Rysunek awatara autorstwa: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +Możesz pomóc nam przetłumaczyć istniejący język lub język, który nie jest obecnie dostępny w [Crowdin](https://crowdin.com/project/shioru-bot). ## znalazł problem -Jeśli napotkasz jakiekolwiek problemy z Twojej obecnej pracy Możesz nas o tym powiadomić za pomocą zakładki [problem](https://github.com/Maseshi/Shioru/issues) tego repozytorium. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.pt-BR.md b/documents/README.pt-BR.md index 7364abb2..3a09bc29 100644 --- a/documents/README.pt-BR.md +++ b/documents/README.pt-BR.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -Seu bom assistente de servidor ajudará seu servidor a parecer mais animado. Ela pode fazer muitas coisas que você pode encontrar informações detalhadas de diferentes comandos digitando `/help` Você pode convidar Shioru para se juntar ao seu servidor de[aqui](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ Seu bom assistente de servidor ajudará seu servidor a parecer mais animado. Ela - Suporte para personalização de notificação do servidor - Você pode falar digitando `@Shioru` seguido da mensagem que deseja comunicar. - O comando de aplicativo (/) pode ser usado. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Pré-requisitos -- [Node.js](https://nodejs.org/) v18.0.0 ou superior -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Guia de configuração rápida +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Ir para [Discord Developer Portal](https://discord.com/developers/applications) -- Clique em **"Novo aplicativo"** , nomeie seu bot e aceite as regras da política do Discord. -- Vá para a página **"Bot"** e habilite todas as opções na seção **Privileged Gateway Intent** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Convide seu bot para o servidor acessando a página **OAuth2 > URL Generator** selecione `bot` e `applications.commands` selecione `Administrador` depois copie o link e cole-o no endereço do seu navegador. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### Configurar um bot - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Inicie um terminal e execute o seguinte comando. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Renomeie o arquivo `.env.example` para `.env` e insira todos os valores necessários. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Você pode modificar alguns dados em **config** em `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Ir para [Discord Developer Portal](https://discord.com/developers/applications) +- Clique em **"Novo aplicativo"** , nomeie seu bot e aceite as regras da política do Discord. +- Vá para a página **"Bot"** e habilite todas as opções na seção **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) -### Configurar o Firebase +### 4. ตั้งค่าฐานข้อมูล - Acesse https://firebase.google.com/ e comece a configurar o projeto. - Adicione um novo projeto e siga as etapas. - Adicione seu primeiro aplicativo com **Site** Nomeie seu aplicativo opcionalmente **"Também configure o Firebase Hosting para este aplicativo"** e registre o aplicativo. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- O Firebase fornecerá informações sobre a configuração. Aplique esses valores ao arquivo `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Vá para **criar > [banco de dados em tempo real](https://console.firebase.google.com/u/0/project/_/database/data)** para criar um banco de dados de armazenamento. -### desenvolver +## 🪛 การพัฒนา -- Renomeie o arquivo `.env.example` para `.env` e insira todos os valores necessários. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Solução rápida de problemas +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Se você não conseguir instalar o pacote **sódio** , instale **libsodium-wrappers** em vez disso. +## 🍵 ใช้งานจริง -```bat -npm desinstalar sódio -npm instalar libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Se você não conseguir reproduzir sua música ou os comandos de reprodução de música não funcionarem, instale [ffmpeg](https://ffmpeg.org/download.html) **(recomendado)** ou instale o pacote **ffmpeg-static** e tente novamente. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Melhorar Traduzir + sh start.sh || sudo sh start.sh -Você pode nos ajudar a traduzir um idioma existente ou um idioma que não esteja disponível no momento em [Crowdin](https://crowdin.com/project/shioru-bot). + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## crédito +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Obrigado a todos os criadores originais por permitirem o uso dessas suas maravilhosas obras. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Desenho de avatar por: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +Você pode nos ajudar a traduzir um idioma existente ou um idioma que não esteja disponível no momento em [Crowdin](https://crowdin.com/project/shioru-bot). ## encontrou um problema -Se você encontrar quaisquer problemas do seu trabalho atual Você pode nos informar através da guia [edição](https://github.com/Maseshi/Shioru/issues) deste repositório. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.ro.md b/documents/README.ro.md index 96173fd4..26038bd8 100644 --- a/documents/README.ro.md +++ b/documents/README.ro.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[EN](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ - Suport pentru personalizarea notificărilor serverului - Puteți vorbi tastând `@Shioru` urmat de mesajul pe care doriți să-l comunicați. - Comanda aplicației (/) poate fi utilizată. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Cerințe preliminare -- [Node.js](https://nodejs.org/) v18.0.0 sau mai mare -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Ghid de instalare rapidă +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Accesați [Discord Developer Portal](https://discord.com/developers/applications) -- Faceți clic pe **„Aplicație nouă”** și denumiți botul dvs. și acceptați regulile politicii 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) - -### Configurați un bot - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Lansați un terminal și executați următoarea comandă. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Redenumiți fișierul `.env.example` la `.env` și introduceți toate valorile necesare. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Puteți modifica unele date în **config** la `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Accesați [Discord Developer Portal](https://discord.com/developers/applications) +- Faceți clic pe **„Aplicație nouă”** și denumiți botul dvs. și acceptați regulile politicii 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) -### Configurați Firebase +### 4. ตั้งค่าฐานข้อมูล - Accesați https://firebase.google.com/ și începeți configurarea proiectului. - Adăugați un proiect nou și urmați pașii. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Accesați **creați > [bază de date în timp real](https://console.firebase.google.com/u/0/project/_/database/data)** pentru a crea o bază de date de stocare. -### dezvolta +## 🪛 การพัฒนา -- Redenumiți fișierul `.env.example` la `.env` și introduceți toate valorile necesare. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Depanare rapidă +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Dacă nu puteți instala pachetul **sodium** , instalați în schimb **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm uninstall sodium -npm install libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Dacă nu puteți reda muzica sau comenzile de redare a muzicii nu funcționează, instalați [ffmpeg](https://ffmpeg.org/download.html) **(recomandat)** sau instalați pachetul **ffmpeg-static** și încercați din nou. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Îmbunătățiți Traducerea + sh start.sh || sudo sh start.sh -și multe alte caracteristici interesante... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## credit +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Ne puteți ajuta să traducem o limbă existentă sau o limbă care nu este disponibilă în prezent la [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Mulțumim tuturor creatorilor originali pentru că ați permis utilizarea acestor lucrări minunate ale voastre. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +și multe alte caracteristici interesante... ## a gasit o problema -Desen avatar de: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.ru.md b/documents/README.ru.md index 54acb890..20bac910 100644 --- a/documents/README.ru.md +++ b/documents/README.ru.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -Ваш хороший помощник по серверу поможет вашему серверу выглядеть более живым. Она может делать много вещей, и вы можете найти подробную информацию о различных командах, набрав `/help` Вы можете пригласить Шиору присоединиться к вашему серверу из[здесь](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - Поддержка настройки уведомлений сервера - Вы можете говорить, набрав `@Shioru` , а затем сообщение, которое вы хотите передать. - Можно использовать команду приложения (/). +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard и много других интересных функций... ## ข้อกำหนดเบื้องต้น -- [Node.js](https://nodejs.org/) v18.0.0 или выше -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Руководство по быстрой установке +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Перейти на [Портал разработчиков Discord](https://discord.com/developers/applications) -- Нажмите **«Новое приложение»** , назовите своего бота и примите правила политики Discord. -- Перейдите на страницу **«Бот»** и включите все параметры в разделе **Намерение привилегированного шлюза** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Пригласите своего бота на сервер, перейдя на страницу **OAuth2 > Генератор URL-адресов** выберите `бот` и `application.commands` выберите `Администратор` затем скопируйте ссылку и вставьте ее в адрес вашего браузера. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### Настроить бота - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Запустите терминал и выполните следующую команду. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Переименуйте файл `.env.example` в `.env` и вставьте все необходимые значения. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Вы можете изменить некоторые данные в **config** в `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Перейти на [Портал разработчиков Discord](https://discord.com/developers/applications) +- Нажмите **«Новое приложение»** , назовите своего бота и примите правила политики Discord. +- Перейдите на страницу **«Бот»** и включите все параметры в разделе **Намерение привилегированного шлюза** ![](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) -### Настроить Firebase +### 4. ตั้งค่าฐานข้อมูล - Перейдите на https://firebase.google.com/ и начните настройку проекта. - Добавьте новый проект и следуйте инструкциям. - Добавьте свое первое приложение с помощью **Веб-сайт** Назовите свое приложение по желанию **«Также настройте хостинг Firebase для этого приложения»** и зарегистрируйте приложение. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase предоставит вам информацию о конфигурации. Примените эти значения к файлу `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Перейдите к **, создайте > [базу данных реального времени](https://console.firebase.google.com/u/0/project/_/database/data)** , чтобы создать базу данных хранилища. -### развивать +## 🪛 การพัฒนา -- Переименуйте файл `.env.example` в `.env` и вставьте все необходимые значения. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Быстрое устранение неполадок +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Если вы не можете установить пакет **натрия** , установите вместо него **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm установить ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Если вы не можете воспроизвести музыку или команды воспроизведения музыки не работают, установите [ffmpeg](https://ffmpeg.org/download.html) **(рекомендуется)** или установите пакет **ffmpeg-static** и повторите попытку. +- บน Linux หรือ MacOS -```bat -npm установить ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Улучшить перевод + sh start.sh || sudo sh start.sh -Вы можете помочь нам перевести существующий язык или язык, который в настоящее время недоступен на [Crowdin](https://crowdin.com/project/shioru-bot). + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## кредит +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Спасибо всем создателям за то, что разрешили использовать эти ваши замечательные работы. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Рисунок аватара: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +Вы можете помочь нам перевести существующий язык или язык, который в настоящее время недоступен на [Crowdin](https://crowdin.com/project/shioru-bot). ## нашел проблему -Если вы столкнулись с какими-либо проблемами с вашей текущей работы Вы можете сообщить нам об этом через вкладку [выпуск](https://github.com/Maseshi/Shioru/issues) этого репозитория. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.sv-SE.md b/documents/README.sv-SE.md index 85d42c48..eea06971 100644 --- a/documents/README.sv-SE.md +++ b/documents/README.sv-SE.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[SV](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - Stöd för anpassning av serveraviseringar - Du kan prata genom att skriva `@Shioru` följt av meddelandet du vill kommunicera. - Programkommandot (/) kan användas. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## Förutsättningar -- [Node.js](https://nodejs.org/) v18.0.0 eller senare -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Snabbguide +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Gå till [Discord Developer Portal](https://discord.com/developers/applications) -- Klicka på **"Ny applikation"** och namnge din bot och acceptera reglerna för Discord-policyn. -- ไปที่หน้า **"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) - -### Skapa en bot - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Starta en terminal och kör följande kommando. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Byt namn på filen `.env.example` till `.env` och infoga alla nödvändiga värden. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Du kan ändra vissa data i **config** vid `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Gå till [Discord Developer Portal](https://discord.com/developers/applications) +- Klicka på **"Ny applikation"** och namnge din bot och acceptera reglerna för Discord-policyn. +- ไปที่หน้า **"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) -### Konfigurera Firebase +### 4. ตั้งค่าฐานข้อมูล - Gå till https://firebase.google.com/ och börja konfigurera projektet. - Lägg till ett nytt projekt och följ stegen. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Gå till **skapa > [realtidsdatabas](https://console.firebase.google.com/u/0/project/_/database/data)** för att skapa en lagringsdatabas. -### utveckla +## 🪛 การพัฒนา -- Byt namn på filen `.env.example` till `.env` och infoga alla nödvändiga värden. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Snabb felsökning +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Om du inte kan installera paket **sodium** , installera **libsodium-wrappers** istället. +## 🍵 ใช้งานจริง -```bat -npm installera ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Om du inte kan spela din musik eller om kommandon för musikuppspelning inte fungerar, installera [ffmpeg](https://ffmpeg.org/download.html) **(rekommenderas)** eller installera paketet **ffmpeg-static** och försök igen. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Förbättra Översätt + sh start.sh || sudo sh start.sh -och många andra intressanta funktioner... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## kreditera +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Du kan hjälpa oss att översätta ett befintligt språk eller ett språk som för närvarande inte är tillgängligt på [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Tack till alla originalskapare för att ni tillåter användningen av dessa underbara verk. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +och många andra intressanta funktioner... ## hittade ett problem -Avatarteckning av: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.tr.md b/documents/README.tr.md index c973f52a..da138fb3 100644 --- a/documents/README.tr.md +++ b/documents/README.tr.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -İyi sunucu asistanınız, sunucunuzun daha canlı görünmesine yardımcı olacaktır. `/help` yazarak farklı komutların detaylı bilgilerini bulabileceğiniz birçok şey yapabilir.Shioru'yu[buraya](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ - Sunucu bildirimi özelleştirme desteği - `@Shioru` yazarak ve ardından iletmek istediğiniz mesajı yazarak konuşabilirsiniz. - Uygulama komutu (/) kullanılabilir. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard ve diğer birçok ilginç özellik... ## Önkoşullar -- [Node.js](https://nodejs.org/) v18.0.0 veya üstü -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [git](https://git-scm.com/downloads) -## Hızlı Kurulum Kılavuzu +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Discord Geliştirici Portalına Git -- **"New Application"** tıklayın ve botunuza bir isim verin ve Discord politika kurallarını kabul edin. -- Sayfa **"Bot"** gidin ve bölüm **Privileged Gateway Intent** ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-privileged-gateway-intents.png) -- Sayfa **giderek botunuzu sunucuya davet edin OAuth2 > URL Oluşturucu** seçin `bot` ve `apps.commands` seçin `Yönetici` sonra bağlantıyı kopyalayın ve tarayıcınızın adresine yapıştırın. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/discord-developer-portal-scopes.png) - -### ตั้งค่าบอท - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Bir terminal başlatın ve aşağıdaki komutu çalıştırın. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- `.env.example` dosyasını `.env` olarak yeniden adlandırın ve gerekli tüm değerleri ekleyin. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- **config** bazı verileri `./source/config.js`değiştirebilirsiniz. +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Discord Geliştirici Portalına Git +- **"New Application"** tıklayın ve botunuza bir isim verin ve Discord politika kurallarını kabul edin. +- Sayfa **"Bot"** gidin ve bölüm **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) -### Firebase'i kurun +### 4. ตั้งค่าฐานข้อมูล - https://firebase.google.com/ adresine gidin ve projeyi kurmaya başlayın. - Yeni bir proje ekleyin ve adımları izleyin. - **Web Sitesi ile ilk uygulamanızı ekleyin** İsteğe bağlı olarak uygulamanızı adlandırın **"Bu uygulama için Firebase Barındırma'yı da kurun"** ve uygulamayı kaydedin. ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase size yapılandırma hakkında bilgi verecektir. Bu değerleri `.env.example`dosyasına uygulayın +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Bir depolama veritabanı oluşturmak için ** > [gerçek zamanlı veritabanı oluştur](https://console.firebase.google.com/u/0/project/_/database/data)** seçeneğine gidin. -### geliştirmek +## 🪛 การพัฒนา -- `.env.example` dosyasını `.env` olarak yeniden adlandırın ve gerekli tüm değerleri ekleyin. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Hızlı Sorun Giderme +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- **sodyum** paketini kuramazsanız, bunun yerine **libsodium-wrappers** kurun. +## 🍵 ใช้งานจริง -```bat -npm sodyum kaldır -npm kurulum libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Müziğinizi çalamıyorsanız veya müzik çalma komutları çalışmıyorsa, [ffmpeg](https://ffmpeg.org/download.html) **(önerilen)** kurun veya **ffmpeg-static** paketini kurun ve tekrar deneyin. +- บน Linux หรือ MacOS -```bat -npm kurulum ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Çeviriyi İyileştir + sh start.sh || sudo sh start.sh -Mevcut bir dili veya şu anda [Crowdin](https://crowdin.com/project/shioru-bot)bulunmayan bir dili çevirmemize yardımcı olabilirsiniz. + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## kredi +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Bu harika çalışmalarınızın kullanılmasına izin verdiğiniz için tüm orijinal yaratıcılara teşekkür ederiz. +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Avatar çizimi yapan: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +Mevcut bir dili veya şu anda [Crowdin](https://crowdin.com/project/shioru-bot)bulunmayan bir dili çevirmemize yardımcı olabilirsiniz. ## bir sorun bulundu -Herhangi bir sorunla karşılaşırsanız şu anki işinizden Bu deponun [sayı](https://github.com/Maseshi/Shioru/issues) sekmesinden bize bildirebilirsiniz. +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.uk.md b/documents/README.uk.md index b6a7f525..b7ebc783 100644 --- a/documents/README.uk.md +++ b/documents/README.uk.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -[EN](https://github.com/Maseshi/Shioru/blob/main/documents/README.en.md) | [TH](https://github.com/Maseshi/Shioru/blob/main/documents/README.th.md) | [JA](https://github.com/Maseshi/Shioru/blob/main/documents/README.ja.md) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,99 +43,134 @@ - Підтримка налаштування сповіщень сервера - Ви можете говорити, ввівши `@Shioru` , а потім повідомлення, яке хочете надіслати. - Можна використовувати команду програми (/). +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## передумови -- [Node.js](https://nodejs.org/) версії 18.0.0 або новішої -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Посібник із швидкого налаштування +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- Перейдіть на [портал розробників Discord](https://discord.com/developers/applications) -- Натисніть **«Нова програма»** , назвіть свого бота та прийміть правила політики 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) - -### Налаштувати бота - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - Запустіть термінал і виконайте таку команду. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Перейменуйте файл `.env.example` на `.env` і вставте всі необхідні значення. -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- Ви можете змінити деякі дані в **конфігурації** у `./source/config.js` +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- Перейдіть на [портал розробників Discord](https://discord.com/developers/applications) +- Натисніть **«Нова програма»** , назвіть свого бота та прийміть правила політики 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) -### Налаштуйте Firebase +### 4. ตั้งค่าฐานข้อมูล - Перейдіть на сторінку https://firebase.google.com/ і почніть налаштування проекту. - Додайте новий проект і виконайте вказівки. - เพิ่มแอปพลิเคชันแรกของคุณด้วย **เว็บไซต์** ตั้งชื่อแอปของคุณโดยไม่จำเป็นต้องเลือกตัวเลือก **"ตั้งค่า Firebase Hosting สำหรับแอปนี้ด้วย"** และลงทะเบียนแอป ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - Перейдіть до **створити > [базу даних у реальному часі](https://console.firebase.google.com/u/0/project/_/database/data)** , щоб створити базу даних для зберігання. -### розвивати +## 🪛 การพัฒนา -- Перейменуйте файл `.env.example` на `.env` і вставте всі необхідні значення. -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## Швидке усунення несправностей +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- Якщо ви не можете встановити пакет **sodium** , замість цього встановіть **libsodium-wrappers**. +## 🍵 ใช้งานจริง -```bat -npm uninstall sodium -npm install libsodium-wrappers@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- Якщо ви не можете відтворити музику або команди відтворення музики не працюють, інсталюйте [ffmpeg](https://ffmpeg.org/download.html) **(рекомендовано)** або інсталюйте пакет **ffmpeg-static** і повторіть спробу. +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## Покращити Перекладач + sh start.sh || sudo sh start.sh -та багато інших цікавих функцій... + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## кредит +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -Ви можете допомогти нам перекласти існуючу мову або мову, яка зараз недоступна на [Crowdin](https://crowdin.com/project/shioru-bot). +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -Дякуємо всім оригінальним творцям за те, що дозволили використовувати ці ваші чудові роботи. +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +та багато інших цікавих функцій... ## знайшов проблему -Намалював аватар: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.vi.md b/documents/README.vi.md index f09e29a3..732d92cf 100644 --- a/documents/README.vi.md +++ b/documents/README.vi.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,19 +43,24 @@ - 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. +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard และคุณสมบัติที่น่าสนใจอื่นๆ อีกมากมาย... ## đ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 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## Hướng dẫn cài đặt nhanh +## การติดตั้ง +<<<<<<< HEAD ทดสอบแล้วบนระบบ Mac, Linux และ Windows <<<<<<< Updated upstream @@ -98,13 +103,116 @@ sudo apt-get install libtool-bin ``` - Khởi chạy một thiết bị đầu cuối và chạy lệnh sau. +======= +### 1. ติดตั้ง **Build Tools** + +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ + +- สำหรับระบบปฏิบัติการ Linux และ MacOS + +```sh +sudo apt update +sudo apt install build-essential +``` + +- สำหรับระบบปฏิบัติการ Windows + +```sh +npm install --global --production --add-python-to-path windows-build-tools +``` + +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + +- Khởi chạy một thiết bị đầu cuối và chạy lệnh sau. + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- Đổi tên tệp `.env.example` thành `.env` và chèn tất cả các giá trị cần thiết. + + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) + +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- 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) + +### 4. ตั้งค่าฐานข้อมูล + +- 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` +- Đế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ữ. + +## 🪛 การพัฒนา + +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น + +## ☕ จำลอง + +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ + +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน + +## 🍵 ใช้งานจริง + +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: + +- บน Linux หรือ MacOS + + ```sh + # with command file (recommend) + + sh start.sh || sudo sh start.sh + + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker + +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) + +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` + +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง +>>>>>>> 7cd9c5100281cee9c71d556039e6a723965221fa ```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install +npm run emulators ``` +<<<<<<< HEAD - Bạn có thể sửa đổi một số dữ liệu trong **config** at `./source/config.js` ### Thiết lập căn cứ hỏa lực @@ -151,3 +259,12 @@ Cảm ơn tất cả những người sáng tạo ban đầu đã cho phép sử ## tìm thấy một vấn đề Avatar vẽ bởi: [夏月 まりな (NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +======= +## ปรับปรุงการแปลภาษา + +và nhiều tính năng thú vị khác... + +## tìm thấy một vấn đề + +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ +>>>>>>> 7cd9c5100281cee9c71d556039e6a723965221fa diff --git a/documents/README.zh-CN.md b/documents/README.zh-CN.md index 17bc8b50..63b556e2 100644 --- a/documents/README.zh-CN.md +++ b/documents/README.zh-CN.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -您的好服务器助手将帮助您的服务器看起来更生动。 她可以做很多事情,您可以通过键入 `/help` 您可以从[here](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - 支持服务器通知自定义 - 您可以通过键入 `@Shioru` 以及您想要交流的消息来进行交谈。 - 可以使用应用程序命令 (/)。 +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard 和许多其他有趣的功能...... ## 先决条件 -- [Node.js](https://nodejs.org/) v18.0.0 或更高版本 -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## 快速设置指南 +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- 转到 [Discord 开发人员门户](https://discord.com/developers/applications) -- 单击 **“新应用程序”** 并为您的机器人命名并接受 Discord 策略规则。 -- 转到第 **页“Bot”** 并启用 **节“特权网关意图** ![](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) - -### 设置一个机器人 - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - 启动终端并运行以下命令。 + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- 将文件 `.env.example` 重命名为 `.env` 并插入所有必要的值。 -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- 可以修改 **config** at `./source/config.js`中的一些数据 +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- 转到 [Discord 开发人员门户](https://discord.com/developers/applications) +- 单击 **“新应用程序”** 并为您的机器人命名并接受 Discord 策略规则。 +- 转到第 **页“Bot”** 并启用 **节“特权网关意图** ![](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) -### 设置火力地堡 +### 4. ตั้งค่าฐานข้อมูล - 转到 https://firebase.google.com/ 并开始设置项目。 - 添加一个新项目并按照步骤操作。 - 添加您的第一个应用程序 **网站** 可选地命名您的应用程序 **“同时为此应用程序设置 Firebase 托管”** 并注册该应用程序。 ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase 将为您提供有关配置的信息。 将这些值应用到文件 `` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - 转到 **create > [realtime database](https://console.firebase.google.com/u/0/project/_/database/data)** 创建存储数据库。 -### 发展 +## 🪛 การพัฒนา -- 将文件 `.env.example` 重命名为 `.env` 并插入所有必要的值。 -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## 快速故障排除 +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- 如果您无法安装 package **sodium** ,请安装 **libsodium-wrappers**。 +## 🍵 ใช้งานจริง -```bat -npm 安装 ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- 如果您无法播放音乐或音乐播放命令不起作用,请安装 [ffmpeg](https://ffmpeg.org/download.html) **(推荐)** 或安装 **ffmpeg-static** 包并重试。 +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## 改进翻译 + sh start.sh || sudo sh start.sh -您可以帮助我们翻译一种现有语言或一种当前在 [Crowdin](https://crowdin.com/project/shioru-bot)不可用的语言。 + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## 信用 +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -感谢所有原创者允许使用您的这些精彩作品。 +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -头像绘制者: [夏月まりな(NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お着替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +您可以帮助我们翻译一种现有语言或一种当前在 [Crowdin](https://crowdin.com/project/shioru-bot)不可用的语言。 ## 发现问题 -如果您遇到任何问题从你现在的工作您可以通过此存储库的 [issue](https://github.com/Maseshi/Shioru/issues) 选项卡让我们知道。 +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้ diff --git a/documents/README.zh-TW.md b/documents/README.zh-TW.md index 460a44af..8aad2ee6 100644 --- a/documents/README.zh-TW.md +++ b/documents/README.zh-TW.md @@ -1,8 +1,8 @@
- +

Shioru

-

ผู้ช่วยภายในเซิร์ฟเวอร์ Discord จะช่วยทำให้เซิร์ฟเวอร์ของคุณน่าอยู่ขึ้น

+

เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น

@@ -25,7 +25,7 @@ [เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) -您的好服務器助手將幫助您的服務器看起來更生動。 她可以做很多事情,您可以通過鍵入 `/help` 您可以從[here](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) +เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
@@ -43,98 +43,134 @@ - 支持服務器通知自定義 - 您可以通過鍵入 `@Shioru` 以及您想要交流的消息來進行交談。 - 可以使用應用程序命令 (/)。 +- จำลองระบบฐานข้อมูลสำหรับทดสอบ +- รองรับการทำงานบน Shard 和許多其他有趣的功能...... ## ข้อกำหนดเบื้องต้น -- [Node.js](https://nodejs.org/) v18.0.0 或更高版本 -- [Python](https://www.python.org/downloads/) v2.0.0 หรือมากกว่า -- [Firebase](https://firebase.google.com/) +- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า +- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า +- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) หรือ[ติดตั้งด้วยตัวเอง](#1-ติดตั้ง-build-tools) +- [Firebase Tools](https://firebase.google.com/docs/cli) - [FFmpeg](https://www.ffmpeg.org/download.html) - [Git](https://git-scm.com/downloads) -## 快速設置指南 +## การติดตั้ง -ทดสอบแล้วบนระบบ Mac, Linux และ Windows +### 1. ติดตั้ง **Build Tools** -### เพิ่มบอทไปยังเซิร์ฟเวอร์ +ทำการติดตั้ง **Build tools** โดยรันคำสั่งดังต่อไปนี้ตามระบบปฏิบัติการของคุณ -- 轉到 [Discord 開發人員門戶](https://discord.com/developers/applications) -- 單擊 **“新應用程序”** 並命名您的機器人並接受 Discord 策略規則。 -- 轉到第 **頁“Bot”** 並啟用第 **節“特權網關意圖** ![](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) - -### ตั้งค่าบอท - -เนื่องจากเราใช้ [sodium](https://www.npmjs.com/package/sodium) ในการเข้ารหัสและถอดรหัส เราจึงจำเป็นต้องติดตั้งส่วนประกอบเพิ่มเติมต่อไปนี้: - -```bat -@REM บน Windows -npm install -g windows-build-tools -``` +- สำหรับระบบปฏิบัติการ Linux และ MacOS ```sh -# บน MacOS (Darwin) -brew install libtool autoconf automake +sudo apt update +sudo apt install build-essential ``` +- สำหรับระบบปฏิบัติการ Windows + ```sh -# บน Linux -sudo apt-get install libtool-bin +npm install --global --production --add-python-to-path windows-build-tools ``` +> **💡 ทริป**: คุณสามารถข้ามขั้นตอนนี้ผ่านตัวติดตั้ง Node.js ดังภาพต่อไปนี้ ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) + +### 2. โคลนบอทและติดตั้งส่วนประกอบ + - 啟動終端並運行以下命令。 + ```bat + git clone https://github.com/Maseshi/Shioru.git + cd Shioru + npm install + ``` +- 將文件 `.env.example` 重命名為 `.env` 並插入所有必要的值。 -```bat -git clone https://github.com/Maseshi/Shioru.git -cd Shioru -npm install -``` + > **💡 หมายเหตุ:** คุณสามารถแก้ไขข้อมูลบางอย่างใน **config** ที่ [./source/configs/data.js](../source/configs/data.js) -- 可以修改 **config** at `./source/config.js`中的一些數據 +### 3. ตั้งค่าบอทและเชิญเข้าร่วม + +- 轉到 [Discord 開發人員門戶](https://discord.com/developers/applications) +- 單擊 **“新應用程序”** 並命名您的機器人並接受 Discord 策略規則。 +- 轉到第 **頁“Bot”** 並啟用第 **節“特權網關意圖** ![](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) -### Firebase 將為您提供有關配置的信息。 +### 4. ตั้งค่าฐานข้อมูล - 轉到 https://firebase.google.com/ 並開始設置項目。 - เพิ่มโครงการใหม่และทำตามขั้นตอนต่างๆ - 添加您的第一個應用程序 **網站** 可選地命名您的應用程序 **“同時為此應用程序設置 Firebase 託管”** 並註冊該應用程序。 ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/firebase-setup-web-application.png) -- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env.example` +- Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env` - 轉到 **create > [realtime database](https://console.firebase.google.com/u/0/project/_/database/data)** 創建存儲數據庫。 -### 發展 +## 🪛 การพัฒนา -- 將文件 `.env.example` 重命名為 `.env` 並插入所有必要的值。 -- ไปที่เทอร์มินัลแล้วรันคำสั่ง `npm run dev` สำหรับการพัฒนาและ `npm start` สำหรับการใช้งานจริง > **หมายเหตุ**: เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` > **💡 หมายเหตุ:** เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น -## 快速故障排除 +## ☕ จำลอง -- หากคุณพบปัญหาระหว่างการติดตั้งคอมโพเนนต์ซึ่งบนเทอร์มินัลระบุว่า `gyp ERR! stack Error: not found: make` ปัญหานี้อาจเกิดจาก **Build tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขคือดาวน์โหลดเวอร์ชันล่าสุดของ [Node.js](https://nodejs.org/) และทำเครื่องหมายที่ส่วนนี้ภายในขั้นตอนการติดตั้ง +ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ - ![](https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/images/node-js-tools-for-native-modules.png) +- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** +- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` > **💡 หมายเหตุ:** คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน -- 如果您無法安裝 package **sodium** ,請安裝 **libsodium-wrappers**。 +## 🍵 ใช้งานจริง -```bat -npm 安裝 ffmpeg-static@latest --save -``` +สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้: -- 如果您無法播放音樂或音樂播放命令不起作用,請安裝 [ffmpeg](https://ffmpeg.org/download.html) **(推薦)** 或安裝 **ffmpeg-static** 包並重試。 +- บน Linux หรือ MacOS -```bat -npm install ffmpeg-static@latest --save -``` + ```sh + # with command file (recommend) -## 改進翻譯 + sh start.sh || sudo sh start.sh -您可以幫助我們翻譯一種現有語言或一種當前在 [Crowdin](https://crowdin.com/project/shioru-bot)不可用的語言。 + # or with call command + + npm start + ``` + +- บน Windows + + ```bat + @REM with command file (recommend) + + ./start.bat + + @REM or with call command + + npm start + ``` + +### 🐳 ทำงานบน Docker -## 信用 +การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/) -感謝所有原創者允許使用您的這些精彩作品。 +- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด +- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน > **💡 หมายเหตุ:** คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` -頭像繪製者: [夏月まりな(NATSUKI MARINA)](https://www.pixiv.net/en/users/482462)/[お著替え中](https://www.pixiv.net/en/artworks/76075098) +## แก้ไขปัญหาอย่างรวดเร็ว + +### `gyp ERR! stack Error: not found: make` + +ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools) + +### `@firebase/firestore: Firestore (10.6.0): GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` + +เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง + +```bat +npm run emulators +``` + +## ปรับปรุงการแปลภาษา + +您可以幫助我們翻譯一種現有語言或一種當前在 [Crowdin](https://crowdin.com/project/shioru-bot)不可用的語言。 ## 發現問題 -如果您遇到任何問題從你現在的工作您可以通過此存儲庫的 [issue](https://github.com/Maseshi/Shioru/issues) 選項卡讓我們知道。 +หากคุณพบปัญหาใดๆ จากการทำงานปัจจุบันของคุณ คุณสามารถแจ้งให้เราทราบได้ผ่านแท็บ [issues](https://github.com/Maseshi/Shioru/issues) ของพื้นที่เก็บนี้ได้