# 人人都能用英语

中文 | [English](README.en-US.md)

## 目录

- [简介](./book/README.md)
- [第一章：起点](./book/chapter1.md)
- [第二章：口语](./book/chapter2.md)
- [第三章：语音](./book/chapter3.md)
- [第四章：朗读](./book/chapter4.md)
- [第五章：词典](./book/chapter5.md)
- [第六章：语法](./book/chapter6.md)
- [第七章：精读](./book/chapter7.md)
- [第八章：叮嘱](./book/chapter8.md)
- [后记](./book/end.md)

---

# 一千小时

本地阅读

```
yarn install
yarn dev:1000h
```

---

# Enjoy App

[![Test](https://github.com/xiaolai/everyone-can-use-english/actions/workflows/test-enjoy-app.yml/badge.svg)](https://github.com/xiaolai/everyone-can-use-english/actions/workflows/test-enjoy-app.yml)
[![Release](https://github.com/xiaolai/everyone-can-use-english/actions/workflows/release-enjoy-app.yml/badge.svg)](https://github.com/xiaolai/everyone-can-use-english/actions/workflows/release-enjoy-app.yml)

## \* 开发者

### 本地启动

```bash
yarn install
yarn start:enjoy
```

### 编译

```bash
yarn make:enjoy
```

## \* 普通小白用户

方法一：**最直接简单的方法**是去 [releases 页面](https://github.com/xiaolai/everyone-can-use-english/tags)下载相应的安装文件。

> 如果你需要**详细下载操作指导**[点这里](find-compatible-software-version.md)

> [!TIP]
> 如果你是普通用户，并不想为本项目提供代码，按上面的操作就可以正常使用 Enjoy APP ！

方法二：如果想要随时**试用更新版本**的话，请按以下步骤操作。

### MacOS 用户

1. 打开命令行工具 Terminal

2. 安装 Homebrew（请参阅这篇文章：《[从 Terminal 开始…](https://github.com/xiaolai/apple-computer-literacy/blob/main/start-from-terminal.md)》）

3. 安装 `nodejs` 以及 `yarn`：

   ```bash
   brew install nvm
   nvm install 20.5.1
   brew install yarn
   brew install ffmpeg
   ```

4. 设置 yarn 环境变量以及 Node.js 配置

   ```bash
   export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
   corepack enable
   ```

5. 克隆此仓库至本地，而后安装、启动：

   ```bash
   cd ~
   mkdir github
   cd github
   git clone https://github.com/xiaolai/everyone-can-use-english
   cd ~/github/everyone-can-use-english
   yarn install
   yarn start:enjoy
   ```

6. 以后重新启动用 Terminal

   ```bash
   cd ~/github/everyone-can-use-english
   git pull
   yarn install
   yarn start:enjoy
   ```

### Windows 用户

系统要求：Windows 10 22H2 以上版本、 [Windows PowerShell 5.1](https://aka.ms/wmf5download) 以上版本、互联网网络连接正常。

1. 将鼠标移至任务栏的 “Windows 徽标” 上单击右键，选择 “PowerShell”

   > tips 1 ：在最新的 Windows 11 上，你看不到 “PowerShell” 选项，只有 “终端”
   >
   > tips 2 ：不能用管理员权限运行 PowerShell ，否则会导致 Scoop 安装失败

2. 在弹出的 PowerShell 窗口中依次执行运行以下命令，安装 Scoop：

   ```powershell
   # 设置 PowerShell 执行策略
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   # 下载安装脚本
   irm get.scoop.sh -outfile 'install.ps1'
   # 执行安装, --ScoopDir 参数指定 Scoop 安装路径
   .\install.ps1 -ScoopDir 'C:\Scoop'
   ```

   如果出现下面的错误：

   > <span style="color:red">irm : 未能解析此远程名称: 'raw.githubusercontent.com'</span>

   说明你的**网络连接**有问题，请自行研究解决：

3. 安装 Nodejs 和 yarn 以及其他依赖环境 ：

   ```powershell
   scoop install nodejs
   scoop install git
   npm install yarn -g
   ```

4. 设置 yarn 环境变量以及 Node.js 配置

   ```powershell
   $env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
   corepack enable
   ```

5. 克隆此仓库至本地，而后安装 Enjoy APP：

   ```powershell
   cd ~
   mkdir github
   cd github
   git clone https://github.com/xiaolai/everyone-can-use-english
   cd everyone-can-use-english
   yarn install
   ```

   出现 `“YN0000: · Done …… ” ` 类似字样说明安装成功！

6. 运行 Enjoy APP ，在终端执行下列命令：

   ```powershell
   yarn start:enjoy
   ```

### 更新 Enjoy

更新并使用最新版本的 Enjoy：

1. 将仓库最新内容拉取到本地，在命令行工具中执行：

   ```bash
   git pull
   ```

   结果显示为：

   ```shell
   Already up to date.
   ```

   若非如此，那么意味着代码有所更新，那么就要运行以下命令：

   ```bash
   yarn install
   ```

2. 运行 Enjoy APP：

   ```shell
   yarn start:enjoy
   ```

## FAQ（常见问题）

**Q: 我该下载哪个版本？**

> A: [点这里](find-compatible-software-version.md) 有详细说明。

**Q: 还有 bug，怎么办？**

> A: 可以提 [Issue](https://github.com/xiaolai/everyone-can-use-english/issues/new)，也可以 Mixin 开发者（Mixin ID: 1051445）。

**Q: 很多解决不了的问题，怎么办？**

其实，可能还有很多其它问题，比如，本软件安装、OpenAI（注册、支付）、美国线路……

> A: 1）文本生成，可以暂时用各种翻译工具，比如 Google Translate，或者其它的替代方案；2）语音生成，可以暂时用开源免费的 [Edge-TTS-record](https://github.com/LuckyHookin/edge-TTS-record)