kun-galgame-vue/README.md

119 lines
5.5 KiB
Markdown
Raw Normal View History

2023-10-23 16:35:31 +00:00
![Logo](https://github.com/KUN1007/kun-galgame-vue/blob/layout/src/assets/images/favicon.png)Logo
2023-04-14 13:58:13 +00:00
2023-10-23 16:35:31 +00:00
The image is sourced from the game [Ark Order](https://apps.qoo-app.com/en/app/9593), featuring the character '鲲' (Kun).
2023-07-31 07:58:09 +00:00
2023-10-23 15:09:42 +00:00
# kun-galgame-vue
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
## Introduction
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
This is the frontend for KUN Visual Novel forum, and it is the first version. We have developed it using the `vue` framework.
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
The purpose of creating KUN Visual Novel is to:
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
- Promote genuinely good games so that everyone can access visual data through platforms like VNDB, avoiding the influence of "experts."
- Distance ourselves from the culture of praising one moment and condemning the next in the modern internet, promoting critique as a virtue, among other things.
- Encourage anyone to learn basic computer skills to avoid "superficial experts."
- Construct a forum primarily driven by individual user enjoyment to resist the formation of social hierarchies.
- Many current websites use templates, resulting in a lack of diversity, causing aesthetic fatigue.
- And much more.
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
We believe that "what truly makes a good game is something that makes you feel happy and genuinely laugh."
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
**The backend project for the first version is [kun-galgame-koa](https://github.com/KUN1007/kun-galgame-koa).**
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
## Mission Statement
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
- The world's cutest galgame forum.
- Our mission is to create the best possible atmosphere.
- We will never have advertisements.
- We will never charge users.
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
## Technical Support
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
- Compatible with all modern browsers on both mobile and desktop.
- Responsive design for screens of any size.
- Developed entirely using `Vue3` Composition API and fully supports `Typescript`. The coding style follows the best practices recommended on the [Vue official website](https://chat.openai.com/c/vuejs.org).
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
## Features
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
### Global Website Settings
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
- `I18n` internationalization.
- Custom background images.
- Day/Night mode.
- Font selection for the entire site.
- Adjust website page width.
2023-07-31 07:58:09 +00:00
2023-10-23 16:35:31 +00:00
### Note
2023-04-14 13:58:13 +00:00
2023-10-23 16:35:31 +00:00
- The website refreshes the `token` every 60 minutes, causing a brief white screen. This is done for security reasons.
- The website uses [`vue-quill`](https://github.com/vueup/vue-quill) as the rich text editor. However, this editor employs outdated [API](https://github.com/vueup/vue-quill/issues/409), which may generate console warnings when the editor appears. This is due to the editor's design and is not an error in the website's code. We plan to develop our own rich text editor in the future.
2023-10-23 16:37:21 +00:00
- If you encounter any errors on the website or have suggestions, please [contact us](https://github.com/KUN1007/kun-galgame-vue#contact-us).
2023-05-04 15:36:38 +00:00
2023-10-23 16:35:31 +00:00
To view all the features of the website, please [click here](https://github.com/KUN1007/kun-galgame-vue/blob/V1/docs/en/feat.md).
2023-05-04 15:36:38 +00:00
2023-10-23 16:35:31 +00:00
To explore all the page functionalities, please [click here](https://github.com/KUN1007/kun-galgame-vue/blob/V1/docs/en/pages.md).
2023-05-04 15:36:38 +00:00
2023-10-23 16:35:31 +00:00
## Project Introduction
2023-05-04 15:36:38 +00:00
2023-10-23 16:35:31 +00:00
### Overview
2023-05-06 06:40:45 +00:00
2023-10-23 16:35:31 +00:00
This is a **reconstructed version** of [`KUNGalgame-pure-css`](https://github.com/KUN1007/kungalgame-pure-css). It is developed using `Vite + Vue3 + Vue-router4 + Typescript + SCSS + Pinia` as the frontend technology stack. It does not rely on any UI frameworks, as this project aims to stand out without UI frameworks. The world is already full of sameness, and we want to bring something different. The project does not integrate `ESLint`, `Prettier`, and similar tools because they can be troublesome, and we love to take it easy. We plan to integrate the necessary project configurations when the first version of the project goes live.
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
### Preview
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
##### The repository for the pure HTML + CSS project can be found [here](https://github.com/KUN1007/kungalgame-pure-css).
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
However, during the reconstruction, we added substantial content and switched from `fontawesome` to `iconify` for icons. This may result in a different appearance. Here, we provide a preview of the homepage:
2023-10-23 15:09:42 +00:00
2023-10-23 16:35:31 +00:00
#### Web Browsers
2023-10-23 15:09:42 +00:00
2023-10-23 16:35:31 +00:00
![Light Mode](https://github.com/KUN1007/kun-galgame-vue/blob/V1/docs/images/preview.png)
2023-10-23 15:09:42 +00:00
2023-10-23 16:35:31 +00:00
![Dark Mode](https://github.com/KUN1007/kun-galgame-vue/blob/V1/docs/images/preview-dark.png)
2023-10-23 15:09:42 +00:00
2023-10-23 16:35:31 +00:00
#### Mobile Browsers
2023-10-23 15:09:42 +00:00
2023-10-23 16:35:31 +00:00
![Light Mode](https://github.com/KUN1007/kun-galgame-vue/blob/V1/docs/images/mobile-preview.png)
2023-10-23 15:09:42 +00:00
2023-10-23 16:35:31 +00:00
![Dark Mode](https://github.com/KUN1007/kun-galgame-vue/blob/V1/docs/images/mobile-preview-dark.png)
2023-10-23 15:09:42 +00:00
2023-10-23 16:35:31 +00:00
### Getting Started
2023-10-23 15:09:42 +00:00
2023-10-23 16:35:31 +00:00
- Clone the repository: `git clone https://github.com/KUN1007/kun-galgame-vue`
- Navigate to the project directory: `cd kun-galgame-vue`
- Install dependencies: `pnpm i`
- Start the development server: `vite dev`
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
## Important Notes
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
The upcoming release is only the first version. We had planned the content for versions 2 and 3 from the project's initial design, including:
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
- Analyzing data from websites such as [`VNDB`](https://vndb.org/), [`-エロゲー批評空間-`](https://erogamescape.dyndns.org/), [`bangumi`](https://bangumi.tv/), etc.
- Streaming media publishing (uploading and releasing videos).
- Creating a mobile app version.
- And more. In short, we will do our best to implement anything you can think of.
2023-10-23 16:14:40 +00:00
2023-10-23 16:35:31 +00:00
## Contact Us
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
If you want to join our development or Galgame groups, you can connect with us through the following channels:
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
- [Telegram Group](https://t.me/KUNForum)
- Tencent QQ Group: 872839714
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
The following two groups are Galgame groups for discussions and feedback:
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
- [Telegram Group](https://t.me/kungalgame)
- Tencent QQ Group: 871857690
2023-10-23 15:09:42 +00:00
2023-10-23 16:46:54 +00:00
## Translation
[中文版](https://github.com/KUN1007/kun-galgame-vue/blob/V1/docs/zh/README.md)
Special thanks to `yuyu` for the Chinese translation.
2023-10-23 15:09:42 +00:00
## License
2023-06-06 06:59:07 +00:00
2023-10-23 16:35:31 +00:00
This project follows the `GPL` open-source license.