docs: make Chinese README the default
This commit is contained in:
wehub-resource-sync
@@ -1,24 +1,29 @@
|
||||
Machine Learning Notebooks, 3rd edition
|
||||
<!-- WEHUB_ZH_README -->
|
||||
> [!NOTE]
|
||||
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
|
||||
> [English](./README.en.md) · [原始项目](https://github.com/ageron/handson-ml3) · [上游 README](https://github.com/ageron/handson-ml3/blob/HEAD/README.md)
|
||||
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
|
||||
|
||||
机器学习 Notebook，第 3 版
|
||||
=================================
|
||||
|
||||
This project aims at teaching you the fundamentals of Machine Learning in
|
||||
python. It contains the example code and solutions to the exercises in the third edition of my O'Reilly book [Hands-on Machine Learning with Scikit-Learn, Keras and TensorFlow (3rd edition)](https://homl.info/er3):
|
||||
本项目旨在教你使用 Python 掌握机器学习（Machine Learning）的基础知识。其中包含示例代码，以及我 O'Reilly 著作 [Hands-on Machine Learning with Scikit-Learn, Keras and TensorFlow（第 3 版）](https://homl.info/er3): 第三版练习题的解答。
|
||||
|
||||
<a href="https://homl.info/er3"><img src="https://learning.oreilly.com/library/cover/9781098125967/300w/" title="book" width="150" border="0" /></a>
|
||||
|
||||
**Note**: If you are looking for the second edition notebooks, check out [ageron/handson-ml2](https://github.com/ageron/handson-ml2). For the first edition, see [ageron/handson-ml](https://github.com/ageron/handson-ml).
|
||||
**注意**：如果你在找第二版的 notebook，请查看 [ageron/handson-ml2](https://github.com/ageron/handson-ml2). 第一版请见 [ageron/handson-ml](https://github.com/ageron/handson-ml).
|
||||
|
||||
## Quick Start
|
||||
## 快速开始
|
||||
|
||||
### Want to play with these notebooks online without having to install anything?
|
||||
### 想在线使用这些 notebook，而无需安装任何东西？
|
||||
|
||||
* <a href="https://colab.research.google.com/github/ageron/handson-ml3/blob/main/" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> (recommended)
|
||||
* <a href="https://colab.research.google.com/github/ageron/handson-ml3/blob/main/" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>（推荐）
|
||||
|
||||
⚠ _Colab provides a temporary environment: anything you do will be deleted after a while, so make sure you download any data you care about._
|
||||
⚠ _Colab 提供的是临时环境：你做的任何操作都会在一段时间后消失，因此请务必下载你关心的数据。_
|
||||
|
||||
<details>
|
||||
|
||||
Other services may work as well, but I have not fully tested them:
|
||||
其他服务也可能可用，但我尚未充分测试：
|
||||
|
||||
* <a href="https://homl.info/kaggle3/"><img src="https://kaggle.com/static/images/open-in-kaggle.svg" alt="Open in Kaggle" /></a>
|
||||
|
||||
@@ -28,57 +33,58 @@ Other services may work as well, but I have not fully tested them:
|
||||
|
||||
</details>
|
||||
|
||||
### Just want to quickly look at some notebooks, without executing any code?
|
||||
### 只想快速浏览一些 notebook，而不执行任何代码？
|
||||
|
||||
* <a href="https://nbviewer.jupyter.org/github/ageron/handson-ml3/blob/main/index.ipynb"><img src="https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg" alt="Render nbviewer" /></a>
|
||||
|
||||
* [github.com's notebook viewer](https://github.com/ageron/handson-ml3/blob/main/index.ipynb) also works but it's not ideal: it's slower, the math equations are not always displayed correctly, and large notebooks often fail to open.
|
||||
* [github.com 的 notebook 查看器](https://github.com/ageron/handson-ml3/blob/main/index.ipynb) 也能用，但并不理想：速度较慢，数学公式不一定能正确显示，而且较大的 notebook 经常打不开。
|
||||
|
||||
### Want to run this project using a Docker image?
|
||||
Read the [Docker instructions](https://github.com/ageron/handson-ml3/tree/main/docker).
|
||||
### 想用 Docker 镜像运行本项目？
|
||||
阅读 [Docker 说明](https://github.com/ageron/handson-ml3/tree/main/docker).
|
||||
|
||||
### Want to install this project on your own machine?
|
||||
### 想在自己的机器上安装本项目？
|
||||
|
||||
Start by installing [Anaconda](https://www.anaconda.com/products/distribution) (or [Miniconda](https://docs.conda.io/en/latest/miniconda.html)), [git](https://git-scm.com/downloads), and if you have a TensorFlow-compatible GPU, install the [GPU driver](https://www.nvidia.com/Download/index.aspx), as well as the appropriate version of CUDA and cuDNN (see TensorFlow's documentation for more details).
|
||||
首先安装 [Anaconda](https://www.anaconda.com/products/distribution)（或 [Miniconda](https://docs.conda.io/en/latest/miniconda.html)), [git](https://git-scm.com/downloads),；如果你有兼容 TensorFlow 的 GPU，还需安装 [GPU 驱动](https://www.nvidia.com/Download/index.aspx), 以及相应版本的 CUDA 和 cuDNN（更多细节请参阅 TensorFlow 文档）。
|
||||
|
||||
Next, clone this project by opening a terminal and typing the following commands (do not type the first `$` signs on each line, they just indicate that these are terminal commands):
|
||||
接下来，打开终端并输入以下命令来克隆本项目（不要输入每行开头的 `$` 符号，它们只是表示这些是终端命令）：
|
||||
|
||||
$ git clone https://github.com/ageron/handson-ml3.git
|
||||
$ cd handson-ml3
|
||||
|
||||
Next, run the following commands:
|
||||
然后运行以下命令：
|
||||
|
||||
$ conda env create -f environment.yml
|
||||
$ conda activate homl3
|
||||
$ python -m ipykernel install --user --name=python3
|
||||
|
||||
Finally, start Jupyter:
|
||||
最后，启动 Jupyter：
|
||||
|
||||
$ jupyter notebook
|
||||
|
||||
If you need further instructions, read the [detailed installation instructions](INSTALL.md).
|
||||
如需更多说明，请阅读[详细安装说明](INSTALL.md)。
|
||||
|
||||
# FAQ
|
||||
# 常见问题
|
||||
|
||||
**Which Python version should I use?**
|
||||
**我应该使用哪个 Python 版本？**
|
||||
|
||||
I recommend Python 3.10. If you follow the installation instructions above, that's the version you will get. Any version ≥3.7 should work as well.
|
||||
我推荐 Python 3.10。如果你按照上述安装说明操作，就会得到该版本。任何 ≥3.7 的版本应该也都可以。
|
||||
|
||||
**I'm getting an error when I call `load_housing_data()`**
|
||||
**调用 `load_housing_data()` 时出现错误**
|
||||
|
||||
If you're getting an HTTP error, make sure you're running the exact same code as in the notebook (copy/paste it if needed). If the problem persists, please check your network configuration. If it's an SSL error, see the next question.
|
||||
如果出现 HTTP 错误，请确保你运行的代码与 notebook 中完全一致（如有需要请复制/粘贴）。如果问题仍然存在，请检查你的网络配置。如果是 SSL 错误，请参阅下一个问题。
|
||||
|
||||
**I'm getting an SSL error on MacOSX**
|
||||
**在 MacOSX 上出现 SSL 错误**
|
||||
|
||||
You probably need to install the SSL certificates (see this [StackOverflow question](https://stackoverflow.com/questions/27835619/urllib-and-ssl-certificate-verify-failed-error)). If you downloaded Python from the official website, then run `/Applications/Python\ 3.10/Install\ Certificates.command` in a terminal (change `3.10` to whatever version you installed). If you installed Python using MacPorts, run `sudo port install curl-ca-bundle` in a terminal.
|
||||
你可能需要安装 SSL 证书（参见这个 [StackOverflow 问题](https://stackoverflow.com/questions/27835619/urllib-and-ssl-certificate-verify-failed-error)). 如果你从官网下载了 Python，请在终端中运行 `/Applications/Python\ 3.10/Install\ Certificates.command`（将 `3.10` 改为你安装的版本）。如果你使用 MacPorts 安装 Python，请在终端中运行 `sudo port install curl-ca-bundle`。
|
||||
|
||||
**I've installed this project locally. How do I update it to the latest version?**
|
||||
**我已在本地安装了本项目。如何更新到最新版本？**
|
||||
|
||||
See [INSTALL.md](INSTALL.md)
|
||||
请参阅 [INSTALL.md](INSTALL.md)
|
||||
|
||||
**How do I update my Python libraries to the latest versions, when using Anaconda?**
|
||||
**使用 Anaconda 时，如何将 Python 库更新到最新版本？**
|
||||
|
||||
See [INSTALL.md](INSTALL.md)
|
||||
请参阅 [INSTALL.md](INSTALL.md)
|
||||
|
||||
## Contributors
|
||||
I would like to thank everyone [who contributed to this project](https://github.com/ageron/handson-ml3/graphs/contributors), either by providing useful feedback, filing issues or submitting Pull Requests. Special thanks go to Haesun Park and Ian Beauregard who reviewed every notebook and submitted many PRs, including help on some of the exercise solutions. Thanks as well to Steven Bunkley and Ziembla who created the `docker` directory, and to github user SuperYorio who helped on some exercise solutions. Thanks a lot to Victor Khaustov who submitted plenty of excellent PRs, fixing many errors. And lastly, thanks to Google ML Developer Programs team who supported this work by providing Google Cloud Credit.
|
||||
## 贡献者
|
||||
|
||||
我要感谢所有[为本项目做出贡献的人](https://github.com/ageron/handson-ml3/graphs/contributors),，无论是提供有用的反馈、提交 issue，还是提交 Pull Request。特别感谢 Haesun Park 和 Ian Beauregard，他们审阅了每一个 notebook 并提交了许多 PR，包括在部分练习解答上提供的帮助。还要感谢 Steven Bunkley 和 Ziembla 创建了 `docker` 目录，以及 GitHub 用户 SuperYorio 对部分练习解答的帮助。非常感谢 Victor Khaustov 提交了大量出色的 PR，修复了许多错误。最后，感谢 Google ML Developer Programs 团队通过提供 Google Cloud Credit 支持了这项工作。
|
||||
|
||||
Reference in New Issue
Block a user