From bc3422152f6f71c29712a7ee23e20f8cd103aeb8 Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Fri, 5 Oct 2018 21:41:30 +0800 Subject: [PATCH 1/4] PRF:20180920 8 Python packages that will simplify your life with Django.md @belitex --- ...hat will simplify your life with Django.md | 49 +++++++++---------- 1 file changed, 24 insertions(+), 25 deletions(-) diff --git a/translated/tech/20180920 8 Python packages that will simplify your life with Django.md b/translated/tech/20180920 8 Python packages that will simplify your life with Django.md index f242007433..8f914f87e0 100644 --- a/translated/tech/20180920 8 Python packages that will simplify your life with Django.md +++ b/translated/tech/20180920 8 Python packages that will simplify your life with Django.md @@ -1,7 +1,7 @@ 简化 Django 开发的八个 Python 包 ====== -这个月的 Python 专栏将介绍一些 Django 包，它们有益于你的工作，以及你的个人或业余项目。 +> 这个月的 Python 专栏将介绍一些 Django 包，它们有益于你的工作，以及你的个人或业余项目。 ![](https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/water-stone-balance-eight-8.png?itok=1aht_V5V) @@ -11,32 +11,31 @@ Django 开发者们，在这个月的 Python 专栏中，我们会介绍一些 ### 有用又省时的工具集合：django-extensions -[Django-extensions][4] 这个 Django 包非常受欢迎，全是有用的工具，比如下面这些管理命令： +[django-extensions][4] 这个 Django 包非常受欢迎，全是有用的工具，比如下面这些管理命令： - * **shell_plus** 打开 Django 的管理 shell，这个 shell 已经自动导入了所有的数据库模型。在测试复杂的数据关系时，就不需要再从几个不同的应用里做 import 的操作了。 - * **clean_pyc** 删除项目目录下所有位置的 .pyc 文件 - * **create_template_tags** 在指定的应用下，创建模板标签的目录结构。 - * **describe_form** 输出模型的表单定义，可以粘贴到 forms.py 文件中。（需要注意的是，这种方法创建的是普通 Django 表单，而不是模型表单。） - * **notes** 输出你项目里所有带 TODO，FIXME 等标记的注释。 + * `shell_plus` 打开 Django 的管理 shell，这个 shell 已经自动导入了所有的数据库模型。在测试复杂的数据关系时，就不需要再从几个不同的应用里做导入操作了。 + * `clean_pyc` 删除项目目录下所有位置的 .pyc 文件 + * `create_template_tags` 在指定的应用下，创建模板标签的目录结构。 + * `describe_form` 输出模型的表单定义，可以粘贴到 `forms.py` 文件中。（需要注意的是，这种方法创建的是普通 Django 表单，而不是模型表单。） + * `notes` 输出你项目里所有带 TODO、FIXME 等标记的注释。 Django-extensions 还包括几个有用的抽象基类，在定义模型时，它们能满足常见的模式。当你需要以下模型时，可以继承这些基类： + * `TimeStampedModel`：这个模型的基类包含了 `created` 字段和 `modified` 字段，还有一个 `save()` 方法，在适当的场景下，该方法自动更新 `created` 和 `modified` 字段的值。 + * `ActivatorModel`：如果你的模型需要像 `status`、`activate_date` 和 `deactivate_date` 这样的字段，可以使用这个基类。它还自带了一个启用 `.active()` 和 `.inactive()` 查询集的 manager。 + * `TitleDescriptionModel` 和 `TitleSlugDescriptionModel`：这两个模型包括了 `title` 和 `description` 字段，其中 `description` 字段还包括 `slug`，它根据 `title` 字段自动产生。 - * **TimeStampedModel** : 这个模型的基类包含了 **created** 字段和 **modified** 字段，还有一个 **save()** 方法，在适当的场景下，该方法自动更新 created 和 modified 字段的值。 - * **ActivatorModel** : 如果你的模型需要像 **status**，**activate_date** 和 **deactivate_date** 这样的字段，可以使用这个基类。它还自带了一个启用 **.active()** 和 **.inactive()** 查询集的 manager。 - * **TitleDescriptionModel** 和 **TitleSlugDescriptionModel** : 这两个模型包括了 **title** 和 **description** 字段，其中 description 字段还包括 **slug**，它根据 **title** 字段自动产生。 - -Django-extensions 还有其他更多的功能，也许对你的项目有帮助，所以，去浏览一下它的[文档][5]吧！ +django-extensions 还有其他更多的功能，也许对你的项目有帮助，所以，去浏览一下它的[文档][5]吧！ ### 12 因子应用的配置：django-environ -在 Django 项目的配置方面，[Django-environ][6] 提供了符合 [12 因子应用][7] 方法论的管理方法。它是其他一些库的集合，包括 [envparse][8] 和 [honcho][9] 等。安装了 django-environ 之后，在项目的根目录创建一个 .env 文件，用这个文件去定义那些随环境不同而不同的变量，或者需要保密的变量。（比如 API keys，是否启用 debug，数据库的 URLs 等） +在 Django 项目的配置方面，[django-environ][6] 提供了符合 [12 因子应用][7] 方法论的管理方法。它是另外一些库的集合，包括 [envparse][8] 和 [honcho][9] 等。安装了 django-environ 之后，在项目的根目录创建一个 `.env` 文件，用这个文件去定义那些随环境不同而不同的变量，或者需要保密的变量。（比如 API 密钥，是否启用调试，数据库的 URL 等） -然后，在项目的 settings.py 中引入 **environ**，并参考[官方文档的例子][10]设置好 **environ.PATH()** 和 **environ.Env()**。就可以通过 **env('VARIABLE_NAME')** 来获取 .env 文件中定义的变量值了。 +然后，在项目的 `settings.py` 中引入 `environ`，并参考[官方文档的例子][10]设置好 `environ.PATH()` 和 `environ.Env()`。就可以通过 `env('VARIABLE_NAME')` 来获取 `.env` 文件中定义的变量值了。 ### 创建出色的管理命令：django-click -[Django-click][11] 是基于 [Click][12] 的， ( 我们[之前推荐过][13]… [两次][14] Click)，它对编写 Django 管理命令很有帮助。这个库没有很多文档，但是代码仓库中有个存放[测试命令][15]的目录，非常有参考价值。 Django-click 基本的 Hello World 命令是这样写的： +[django-click][11] 是基于 [Click][12] 的，（我们[之前推荐过][13]… [两次][14] Click)，它对编写 Django 管理命令很有帮助。这个库没有很多文档，但是代码仓库中有个存放[测试命令][15]的目录，非常有参考价值。 django-click 基本的 Hello World 命令是这样写的： ``` # app_name.management.commands.hello.py @@ -57,31 +56,31 @@ Hello, Lacey ### 处理有限状态机：django-fsm -[Django-fsm][16] 给 Django 的模型添加了有限状态机的支持。如果你管理一个新闻网站，想用类似于“写作中”，“编辑中”，“已发布”来流转文章的状态，django-fsm 能帮你定义这些状态，还能管理状态变化的规则与限制。 +[django-fsm][16] 给 Django 的模型添加了有限状态机的支持。如果你管理一个新闻网站，想用类似于“写作中”、“编辑中”、“已发布”来流转文章的状态，django-fsm 能帮你定义这些状态，还能管理状态变化的规则与限制。 -Django-fsm 为模型提供了 FSMField 字段，用来定义模型实例的状态。用 django-fsm 的 **@transition** 修饰符，可以定义状态变化的方法，并处理状态变化的任何副作用。 +Django-fsm 为模型提供了 FSMField 字段，用来定义模型实例的状态。用 django-fsm 的 `@transition` 修饰符，可以定义状态变化的方法，并处理状态变化的任何副作用。 -虽然 django-fsm 文档很轻量，不过 [Django 中的工作流（状态）][17] 这篇 GitHubGist 对有限状态机和 django-fsm 做了非常好的介绍。 +虽然 django-fsm 文档很轻量，不过 [Django 中的工作流（状态）][17] 这篇 GitHub Gist 对有限状态机和 django-fsm 做了非常好的介绍。 ### 联系人表单：#django-contact-form -联系人表单可以说是网站的标配。但是不要自己去写全部的样板代码，用 [django-contact-form][18] 在几分钟内就可以搞定。它带有一个可选的能过滤垃圾邮件的表单类（也有不过滤的普通表单类）和一个 **ContactFormView** 基类，基类的方法可以覆盖或自定义修改。而且它还能引导你完成模板的创建，好让表单正常工作。 +联系人表单可以说是网站的标配。但是不要自己去写全部的样板代码，用 [django-contact-form][18] 在几分钟内就可以搞定。它带有一个可选的能过滤垃圾邮件的表单类（也有不过滤的普通表单类）和一个 `ContactFormView` 基类，基类的方法可以覆盖或自定义修改。而且它还能引导你完成模板的创建，好让表单正常工作。 ### 用户注册和认证：django-allauth -[Django-allauth][19] 是一个 Django 应用，它为用户注册，登录注销，密码重置，还有第三方用户认证（比如 GitHub 或 Twitter）提供了视图，表单和 URLs，支持邮件地址作为用户名的认证方式，而且有大量的文档记录。第一次用的时候，它的配置可能会让人有点晕头转向；请仔细阅读[安装说明][20]，在[自定义你的配置][21]时要专注，确保启用某个功能的所有配置都用对了。 +[django-allauth][19] 是一个 Django 应用，它为用户注册、登录/注销、密码重置，还有第三方用户认证（比如 GitHub 或 Twitter）提供了视图、表单和 URL，支持邮件地址作为用户名的认证方式，而且有大量的文档记录。第一次用的时候，它的配置可能会让人有点晕头转向；请仔细阅读[安装说明][20]，在[自定义你的配置][21]时要专注，确保启用某个功能的所有配置都用对了。 ### 处理 Django REST 框架的用户认证：django-rest-auth -如果 Django 开发中涉及到对外提供 API，你很可能用到了 [Django REST Framework][22] (DRF)。如果你在用 DRF，那么你应该试试 django-rest-auth，它提供了用户注册，登录/注销，密码重置和社交媒体认证的 endpoints （是通过添加 django-allauth 的支持来实现的，这两个包协作得很好）。 +如果 Django 开发中涉及到对外提供 API，你很可能用到了 [Django REST Framework][22]（DRF）。如果你在用 DRF，那么你应该试试 django-rest-auth，它提供了用户注册、登录/注销，密码重置和社交媒体认证的端点（是通过添加 django-allauth 的支持来实现的，这两个包协作得很好）。 ### Django REST 框架的 API 可视化：django-rest-swagger -[Django REST Swagger][24] 提供了一个功能丰富的用户界面，用来和 Django REST 框架的 API 交互。你只需要安装 Django REST Swagger，把它添加到 Django 项目的 installed apps 中，然后在 urls.py 中添加 Swagger 的视图和 URL 模式就可以了，剩下的事情交给 API 的 docstring 处理。 +[Django REST Swagger][24] 提供了一个功能丰富的用户界面，用来和 Django REST 框架的 API 交互。你只需要安装 Django REST Swagger，把它添加到 Django 项目的已安装应用中，然后在 `urls.py` 中添加 Swagger 的视图和 URL 模式就可以了，剩下的事情交给 API 的 docstring 处理。 ![](https://opensource.com/sites/default/files/uploads/swagger-ui.png) -API 的用户界面按照 app 的维度展示了所有 endpoints 和可用方法，并列出了这些 endpoints 的可用操作，而且它提供了和 API 交互的功能（比如添加/删除/获取记录）。django-rest-swagger 从 API 视图中的 docstrings 生成每个 endpoint 的文档，通过这种方法，为你的项目创建了一份 API 文档，这对你，对前端开发人员和用户都很有用。 +API 的用户界面按照 app 的维度展示了所有端点和可用方法，并列出了这些端点的可用操作，而且它提供了和 API 交互的功能（比如添加/删除/获取记录）。django-rest-swagger 从 API 视图中的 docstrings 生成每个端点的文档，通过这种方法，为你的项目创建了一份 API 文档，这对你，对前端开发人员和用户都很有用。 -------------------------------------------------------------------------------- @@ -90,7 +89,7 @@ via: https://opensource.com/article/18/9/django-packages 作者：[Jeff Triplett][a] 选题：[lujun9972](https://github.com/lujun9972) 译者：[belitex](https://github.com/belitex) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 @@ -118,4 +117,4 @@ via: https://opensource.com/article/18/9/django-packages [21]: https://django-allauth.readthedocs.io/en/latest/configuration.html [22]: http://www.django-rest-framework.org/ [23]: https://django-rest-auth.readthedocs.io/ -[24]: https://django-rest-swagger.readthedocs.io/en/latest/ \ No newline at end of file +[24]: https://django-rest-swagger.readthedocs.io/en/latest/ From fdb1eef5f559d62deebebfd6343578896805239d Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Fri, 5 Oct 2018 21:43:36 +0800 Subject: [PATCH 2/4] PUB:20180920 8 Python packages that will simplify your life with Django.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit @belitex 恭喜你，完成了第一篇翻译贡献。本文首发地址： https://linux.cn/article-10085-1.html 您的 LCTT 专页地址： https://linux.cn/lctt/belitex 请注册 LCTT 平台领取 LCCN https://lctt.linux.cn/ --- ... 8 Python packages that will simplify your life with Django.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename {translated/tech => published}/20180920 8 Python packages that will simplify your life with Django.md (100%) diff --git a/translated/tech/20180920 8 Python packages that will simplify your life with Django.md b/published/20180920 8 Python packages that will simplify your life with Django.md similarity index 100% rename from translated/tech/20180920 8 Python packages that will simplify your life with Django.md rename to published/20180920 8 Python packages that will simplify your life with Django.md From ada3603a9f3f64f7bce9bd45861279d32c4a3b1c Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Fri, 5 Oct 2018 21:53:52 +0800 Subject: [PATCH 3/4] PRF:20180709 How To Configure SSH Key-based Authentication In Linux.md @LuuMing --- ... Configure SSH Key-based Authentication In Linux.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/translated/tech/20180709 How To Configure SSH Key-based Authentication In Linux.md b/translated/tech/20180709 How To Configure SSH Key-based Authentication In Linux.md index 77a4e03b35..8fb89b943d 100644 --- a/translated/tech/20180709 How To Configure SSH Key-based Authentication In Linux.md +++ b/translated/tech/20180709 How To Configure SSH Key-based Authentication In Linux.md @@ -64,14 +64,14 @@ The key's randomart image is: +----[SHA256]-----+ ``` -如果你已经创建了密钥对，你将看到以下信息。输入 y 就会覆盖已存在的密钥。 +如果你已经创建了密钥对，你将看到以下信息。输入 `y` 就会覆盖已存在的密钥。 ``` /home/username/.ssh/id_rsa already exists. Overwrite (y/n)? ``` -请注意**密码是可选的**。如果你输入了密码，那么每次通过 SSH 访问远程系统时都要求输入密码，除非你使用了 SSH 代理保存了密码。如果你不想要密码（虽然不安全），简单地敲两次回车。不过，我建议你使用密码。从安全的角度来看，使用无密码的 ssh 密钥对不是什么好主意。这种方式应该限定在特殊的情况下使用，例如，没有用户介入的服务访问远程系统。（例如，用 rsync 远程备份……） +请注意**密码是可选的**。如果你输入了密码，那么每次通过 SSH 访问远程系统时都要求输入密码，除非你使用了 SSH 代理保存了密码。如果你不想要密码（虽然不安全），简单地敲两次回车。不过，我建议你使用密码。从安全的角度来看，使用无密码的 ssh 密钥对不是什么好主意。这种方式应该限定在特殊的情况下使用，例如，没有用户介入的服务访问远程系统。（例如，用 `rsync` 远程备份……） 如果你已经在个人文件 `~/.ssh/id_rsa` 中有了无密码的密钥，但想要更新为带密码的密钥。使用下面的命令： @@ -95,7 +95,7 @@ $ ssh-copy-id sk@192.168.225.22 在这里，我把本地（Arch Linux）系统上的公钥拷贝到了远程系统（Ubuntu 18.04 LTS）上。从技术上讲，上面的命令会把本地系统 `~/.ssh/id_rsa.pub` 文件中的内容拷贝到远程系统 `~/.ssh/authorized_keys` 中。明白了吗？非常棒。 -输入 yes 来继续连接你的远程 SSH 服务端。接着，输入远程系统 sk 用户的密码。 +输入 `yes` 来继续连接你的远程 SSH 服务端。接着，输入远程系统用户 `sk` 的密码。 ``` /usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that are already installed @@ -118,7 +118,7 @@ $ ssh-copy-id -f sk@192.168.225.22 ### 在远程系统上禁用基于密码认证的 SSH -你需要在 root 或者 sudo 用户下执行下面的命令。 +你需要在 root 用户或者 `sudo` 执行下面的命令。 禁用基于密码的认证，你需要在远程系统的终端里编辑 `/etc/ssh/sshd_config` 配置文件： @@ -170,7 +170,7 @@ Warning: Permanently added '192.168.225.22' (ECDSA) to the list of known hosts. Permission denied (publickey). ``` -如你所见，除了 CentOS（译注：根据上文，这里应该是 Arch）系统外，我不能通过其它任何系统 SSH 访问我的远程系统 Ubuntu 18.04。 +如你所见，除了 CentOS（LCTT 译注：根据上文，这里应该是 Arch）系统外，我不能通过其它任何系统 SSH 访问我的远程系统 Ubuntu 18.04。 ### 为 SSH 服务端添加更多客户端系统的密钥 From f6f6a0373dec7a75de89d2ea40bacbb6d1ab52dd Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Fri, 5 Oct 2018 21:54:19 +0800 Subject: [PATCH 4/4] PUB:20180709 How To Configure SSH Key-based Authentication In Linux.md @LuuMing @pityonline https://linux.cn/article-10086-1.html --- ...0709 How To Configure SSH Key-based Authentication In Linux.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename {translated/tech => published}/20180709 How To Configure SSH Key-based Authentication In Linux.md (100%) diff --git a/translated/tech/20180709 How To Configure SSH Key-based Authentication In Linux.md b/published/20180709 How To Configure SSH Key-based Authentication In Linux.md similarity index 100% rename from translated/tech/20180709 How To Configure SSH Key-based Authentication In Linux.md rename to published/20180709 How To Configure SSH Key-based Authentication In Linux.md