Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cuixiaorui/earthworm
Learning English through the method of constructing sentences with conjunctions
https://github.com/cuixiaorui/earthworm
Last synced: 4 days ago
JSON representation
Learning English through the method of constructing sentences with conjunctions
- Host: GitHub
- URL: https://github.com/cuixiaorui/earthworm
- Owner: cuixiaorui
- Created: 2023-09-24T07:27:43.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-02-02T02:29:54.000Z (about 1 year ago)
- Last Synced: 2025-02-16T22:41:25.741Z (5 days ago)
- Language: TypeScript
- Homepage: https://earthworm.cuixueshe.com
- Size: 55 MB
- Stars: 218
- Watchers: 5
- Forks: 51
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# earthworm
Learning English through the method of constructing sentences with conjunctions
## Start
Start the project based on the following steps
Note that this project depends on docker, so make sure that docker is installed first.
1. install project dependencies
```shell
pnpm install
```2. start application
```shell
pnpm docker:start
```3. stop application
```shell
pnpm docker:stop
```4. init data of database (It only needs to be executed the first time the database is created)
```shell
pnpm db:init
```## 当发现数据有问题时 如何修改
目前课程的数据是基于 pdf 解析得到的 json 文件, 所以在解析的过程中必然会出现一些小问题
那么当遇到这些小问题的时候 大家可以通过修改 json 文件来做出对 earthworm 的贡献
以下是贡献步骤:
1. 找到当前课程所对应的 json 文件
json 文件在 scripts/courses 里面
注意 courseId 和 json 名称不是对齐的,需要手动查看确定要修改的 json 文件(TODO 这里是个优化点)
2. 找到 json 文件中的错误语句
可以直接在当前的 json 文件中搜索即可, 一个对象对应一个 statement
3. 修改 json 后提交 pr
在 pr 中可以介绍下修改的原因
### 数据的更新
后续我会在合并完 pr 后更新线上数据库上的数据完成更新
## 常见问题
### ReferenceError: Request is not defined
使用 `pnpm dev` 或 `pnpm start` 命令启动项目时,可能会出现 `ReferenceError: Request is not defined` 的错误
```
earthworm\node_modules\.pnpm\[email protected]_biqbaboplfbrettd7655fr4n2y\node_modules\next\dist\server\web\spec-extension\request.js:28
class NextRequest extends Request {
^ReferenceError: Request is not defined
```这是由于 `Node.js` 版本较低导致的:
> What version of Node.js do you use? If it is 16.x, or less, then you should set it to 18.x, assuming that none of the packages you are using, require lower Node.js versions.
详情参见这里:[ReferenceError: Request is not defined · vercel/next.js · Discussion #47648](https://github.com/vercel/next.js/discussions/47648)
升级到 `18.x` 及以上即可解决问题
### 贡献指北
由于本地调试、修改项目时需要使用到 mysql 服务,这里我们可以只用 docker 跑个 mysql 服务
```shell
docker compose -f docker-compose-dev.yaml up -d# 老版本 docker 兼容命令
docker-compose -f docker-compose-dev.yaml up -d# 或者可以通过 package.json 的命令来启动
pnpm docker:mysql
```然后顺序执行下列命令即可
```shell
pnpm install
pnpm db:init
pnpm dev
```