Add docs of installing anki (#3506)

Signed-off-by: Carson Yang <[email protected]>

docs/4.0/docs/examples/others/install-anki.md

@@ -0,0 +1,143 @@
+# Quick Installation of a Custom Anki Sync Server
+
+Anki is a spaced repetition flashcard program. Essentially, it is a card sorting tool that **actively tests users on custom card content, allows users to self-grade their responses, and then uses an algorithm to reschedule cards based on the judgments to optimize long-term retention**.
+
+The so-called "cards" are technically called flash cards. They are small cards with a question or prompt on one side and the answer on the reverse side. You first read the question/prompt, try to recall the answer mentally, then flip the card to verify against the answer provided.
+
+The core principle of flashcard creation is:**one knowledge point per card**. As such, Anki is well-suited for learning languages, memorizing historical dates, formulas, etc.
+
+Anki's official sync server is hosted overseas and is a personal project with limited bandwidth. Syncing is very slow. To sync learning progress and new cards across multiple clients would be extremely painful.
+
+To address this, we need to deploy a custom sync server and have the clients connect to it instead.
+
+## Deploying an Anki Sync Server
+
+Since the February 2023 release of Anki 2.1.57 for desktop, Anki on desktop, Android, and iOS now support custom sync servers without needing to install plugins. Anki users no longer need to worry about sync issues. The longstanding sync problem has finally been completely solved.
+
+Currently, the only project that supports the latest Anki versions is [anki-sync-server-rs](https://github.com/ankicommunity/anki-sync-server-rs). Other sync server projects are now mostly obsolete. This Rust project tracks progress on Anki's official sync server and also uses sqlite as the backend data store.
+
+Below we will deploy anki-sync-server-rs on Sealos and configure it.
+
+First, enter the URL https://cloud.sealos.io/ in your browser to access the Sealos desktop. Then open "App Launchpad":
+
+![](../images/2023-06-26-11-54-EIVahX.jpg)
+
+Click "Create Application":
+
+![](../images/2023-06-26-11-55-NDkuEg.jpg)
+
+Enter the application name and image name. The exposed container port is `27701`. Enable external network access:
+
+![](../images/2023-06-26-11-59-FxJE12.png)
+
+Scroll down and expand "Advanced Configuration". Click "Edit Environment Variables":
+
+![](../images/2023-06-26-12-01-DKect7.png)
+
+Paste the following into the environment variable input box:
+
+```
+bash
+Copy code
+
+ANKISYNCD_USERNAME=<USERNAME>  
+ANKISYNCD_PASSWORD=<PASSWD>
+```
+
+Replace `<USERNAME>` with your username and `<PASSWD>` with your password.
+
+![](../images/2023-06-26-12-05-CWczxm.png)
+
+Click "Add Storage Volume":
+
+![](../images/2023-06-26-12-06-lvv6ms.png)
+
+Set the mount path to `/app` and confirm:
+
+![](../images/2023-06-26-12-07-s8W7iu.png)
+
+Finally, click "Deploy Application" in the top right corner.
+
+After deployment, click "Details" to enter the application details screen.
+
+![](../images/2023-06-26-12-09-RslDGj.png)
+
+Here you can see the instance status. Wait until the status shows as "running" before proceeding. If it stays pending for a while, click "Details" to check the failure reason:
+
+![](../images/2023-06-26-13-09-Vs9ccy.png)
+
+Once deployed successfully, you can monitor metrics like CPU and memory usage. Click the external URL to directly access the sync server's web interface.
+
+![](../images/2023-06-26-13-09-YFHPYc.png)
+
+If you see the following screen, the deployment succeeded:
+
+![](../images/2023-06-26-13-09-FwsbfW.png)
+
+Viewing logs is also straightforward - click the "three dots" on the instance panel and select "Logs":
+
+![](../images/2023-06-26-13-09-hdHfxP.png)
+
+![](../images/2023-06-26-13-09-nwrxrv.png)
+
+## Client Configuration
+
+### Desktop
+
+To configure the desktop client (macOS/Windows/Linux):
+
+1. Open "Preferences"
+
+   ![](../images/2023-06-26-12-24-QHYKZt.png)
+
+2. Click "Network" and look for the "self-hosted sync server" section. Enter your server's address:
+
+   ![](../images/2023-06-26-12-26-HYOaBJ.png)
+
+3. Restart Anki and click "Sync":
+
+   ![](../images/2023-06-26-12-28-ccnUOj.png)
+
+4. A prompt will appear asking for username and password. Enter what you configured earlier:
+
+   ![](../images/2023-06-26-12-29-z5E9gi.png)
+
+5. Click OK and syncing will begin.
+
+### Android
+
+On Android, directly configure via "Settings -> Advanced -> Custom sync server":
+
+<img style="width: 400px;"  src="../images/2022-04-10-14-31-vrNHJU.png">
+
+Also enter username and password:
+
+> Settings -> Basic -> AnkiWeb Account
+
+This completes the configuration. All card decks should sync over:
+
+<table><tr> <td><img style="width: 400px;" src="../images/2022-04-10-14-32-ADfk8T.png"></td>   <td><img style="width: 400px;" src="../images/2022-04-10-14-32-1iudM0.png"></td> </tr></table>
+
+The official app version is quite old. For the latest community version, download the Beta here:
+
+- https://github.com/ankidroid/Anki-Android/releases
+
+The **arm64-v8a** version is recommended.
+
+After installing, the sync server can be configured under "Settings -> Sync -> Custom sync server":
+
+<img style="width: 400px;" src="../images/2023-06-26-12-39-1jsF0t.jpeg">
+
+Also enter the username and password:
+
+> Settings -> Sync -> AnkiWeb Account
+
+### iOS
+
+AnkiMobile also supports syncing with a custom server. At least version Ankimobile 2.0.90(20090.2) seems to work based on [reports in the Anki forums](https://forums.ankiweb.net/t/ankimobile-self-sync-server-failure-the-one-bundled-in-version-2-1-60-qt6/27862).
+
+If you encounter sync issues after configuring, try toggling "Allow Anki to access local network" off and on in iOS settings per Anki's docs:
+
+> If you're using AnkiMobile and are unable to connect to a server on your local network, please go into the iOS settings, locate Anki near the bottom, and toggle "Allow Anki to access local network" off and on again.
+
+The tip above is excerpted from the [Anki tutorial](https://docs.ankiweb.net/sync-server.html#client-setup).

docs/4.0/i18n/zh-Hans/examples/others/install-anki.md

@@ -0,0 +1,144 @@
+# 快速安装 Anki 自定义同步服务器
+
+Anki 是一个辅助记忆软件，其本质是一个卡片排序工具--**即依据使用者对卡片上的自定义内容进行主动测试、自我评判后，其内部算法根据评判结果更改每张卡片下次测试时间的排序工具。**
+
+所谓的卡片，专业说法叫 Flash Card（抽认卡或闪卡），是一小块纸片，分为正反两面，将问题和提示写在一面，将答案写在另一面。使用方法就是先看正面的问题与提示，在脑中回想答案，然后翻出反面进行对照验证。
+
+闪卡的核心制作原则就是：**一个知识点一张卡**。因此非常适合用来学习英文，也可以用来记忆历史事件时间、公式等等。
+
+Anki 的同步服务器在国外，还是一个个人项目，带宽很小，同步速度很慢，如果我们想在多个客户端之间同步学习进度和新增的知识点，那将非常痛苦。
+
+为了解决这个问题，我们需要部署一个自定义的同步服务器，然后让客户端去使用这个同步服务器。
+
+## Anki 同步服务器部署
+
+自从 2023 年 2 月份，Anki 发布了 PC 端 2.1.57 版本以后，Anki 的 PC 端，安卓端，iOS 端用户都可以自定义同步服务器了，并且不再需要安装插件。从此 Anki 小伙伴再也不用担心 Anki 同步的问题了，困扰 Anki 用户多年的同步问题终于得到彻底解决。
+
+社区目前只有 [anki-sync-server-rs](https://github.com/ankicommunity/anki-sync-server-rs) 这个项目支持最新的 Anki 版本，其他的同步服务器项目基本上都失效了。这个项目是用 Rust 写的，追踪 [Anki 官方](https://github.com/ankitects/anki) 同步服务端的进度，它们都是基于sqlite c 作为数据存储后端。
+
+下面我们将在 Sealos 中部署并配置  anki-sync-server-rs。
+
+首先在浏览器地址栏输入网址 [https://cloud.sealos.io/](https://cloud.sealos.io/) 进入 Sealos 桌面。然后打开「应用管理」：
+
+![](../images/2023-06-26-11-54-EIVahX.jpg)
+
+点击「新建应用」：
+
+![](../images/2023-06-26-11-55-NDkuEg.jpg)
+
+依次输入应用名和镜像名，容器暴露端口是 `27701`，并开启外网访问：
+
+![](../images/2023-06-26-11-59-FxJE12.png)
+
+继续向下，展开「高级配置」，点击「编辑环境变量」：
+
+![](../images/2023-06-26-12-01-DKect7.png)
+
+将以下内容粘贴到环境变量输入框中：
+
+```bash
+ANKISYNCD_USERNAME=<USERNAME>
+ANKISYNCD_PASSWORD=<PASSWD>
+```
+
+请将 `<USERNAME>` 替换为你自己的用户名，将 `<PASSWD>` 替换为你自己的密码。
+
+![](../images/2023-06-26-12-05-CWczxm.png)
+
+点击「新增存储卷」：
+
+![](../images/2023-06-26-12-06-lvv6ms.png)
+
+挂载路径填入 `/app`，然后点击确认：
+
+![](../images/2023-06-26-12-07-s8W7iu.png)
+
+最后点击右上角的部署应用即可。
+
+部署完成后点击「详情」进入应用详情界面。
+
+![](../images/2023-06-26-12-09-RslDGj.png)
+
+这里可以看到实例的运行状态，一定要等到状态是 running 才算是部署成功。如果一段时间以后状态还不是 running，可以点击「详情」查看故障原因：
+
+![](../images/2023-06-26-13-09-Vs9ccy.png)
+
+部署成功后，可以看到应用的运行情况，包括 CPU 占用、内存占用等。点击外网地址即可通过外网域名直接打开同步服务器的 Web 界面。
+
+![](../images/2023-06-26-13-09-YFHPYc.png)
+
+如果出现以下的界面，则表示部署成功：
+
+![](../images/2023-06-26-13-09-FwsbfW.png)
+
+查看日志的方法也很简单，直接点击实例右侧的「三个点」，然后点击「日志」即可查看日志：
+
+![](../images/2023-06-26-13-09-hdHfxP.png)
+
+![](../images/2023-06-26-13-09-nwrxrv.png)
+
+## 客户端设置
+
+### 桌面端
+
+桌面客户端（macOS/Windows/Linux）配置方法如下：
+
+1. 先打开「首选项」
+
+   ![](../images/2023-06-26-12-24-QHYKZt.png)
+
+2. 点击「**网络**」，往下看，可以看到标有 `self-hosted sync server(自定义同步服务器)` 的方框，在里面填写您的服务端的地址：
+
+   ![](../images/2023-06-26-12-26-HYOaBJ.png)
+
+3. 重启 Anki，然后点击「**同步**」：
+
+   ![](../images/2023-06-26-12-28-ccnUOj.png)
+
+4. 这时候会弹出一个输入框让你输入用户名和密码，你需要将你之前设置的用户名和密码输入进去：
+
+   ![](../images/2023-06-26-12-29-z5E9gi.png)
+
+5. 点击确认后，就会开始同步了。
+
+
+### 安卓端
+
+安卓端也是直接配置即可，我的 AnkiDroid 版本是 `2.15.6`。你可以通过「设置 -> 高级设置 -> 自定义同步服务器」找到配置页面。
+
+<img style="width: 400px;" src="https://jsdelivr.icloudnative.io/gh/yangchuansheng/imghosting3@main/uPic/2022-04-10-14-31-vrNHJU.png">
+
+再填写用户名和密码：
+
+> 设置 -> 常用设置 -> AnkiWeb账户
+
+这样就算配置完成了，所有的牌组都同步过来了。
+
+<table><tr>
+<td><img style="width: 400px;" src="../images/2022-04-10-14-32-ADfk8T.png"></td>
+<td><img style="width: 400px;" src="../images/2022-04-10-14-32-1iudM0.png"></td>
+</tr></table>
+
+官方的版本比较旧，如果你想使用更激进的社区版本，可以到这个页面下载最新的 Beta 版：
+
++ [https://github.com/ankidroid/Anki-Android/releases](https://github.com/ankidroid/Anki-Android/releases)
+
+建议下载 **arm64-v8a** 版本。
+
+安装完成后，可以通过「设置 -> 同步 -> 自定义同步服务器」找到配置页面：
+
+<img style="width: 400px;" src="../images/2023-06-26-12-39-1jsF0t.jpeg">
+
+再填写用户名和密码：
+
+> 设置 -> 同步 -> AnkiWeb账户
+
+### iOS 端
+
+AnkiMobile 也已经支持和自建的同步服务器同步了。至少对于版本 Ankimobile 2.0.90(20090.2) 来说，似乎是可行的，这是一位 iOS 系统用户[在 Anki 论坛报告的](https://forums.ankiweb.net/t/ankimobile-self-sync-server-failure-the-one-bundled-in-version-2-1-60-qt6/27862)。
+
+如果设置完成后发现不能同步可以参考下面的内容再试一次：
+
+> If you're using AnkiMobile and are unable to connect to a  server on your local network, please go into the iOS settings, locate  Anki near the bottom, and toggle "Allow Anki to access local network"  off and then on again.
+
+上面的内容摘自 [ANki tutorial](https://docs.ankiweb.net/sync-server.html#client-setup)