mirror of
https://github.com/LCTT/TranslateProject.git
synced 2025-03-21 02:10:11 +08:00
heguangzhi
GitHub
commit
d14577dfcd
@ -0,0 +1,137 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: (robsean)
|
||||
[#]: reviewer: (wxy)
|
||||
[#]: publisher: (wxy)
|
||||
[#]: url: (https://linux.cn/article-11774-1.html)
|
||||
[#]: subject: (Open source interior design with Sweet Home 3D)
|
||||
[#]: via: (https://opensource.com/article/19/10/interior-design-sweet-home-3d)
|
||||
[#]: author: (Seth Kenlon https://opensource.com/users/seth)
|
||||
|
||||
Sweet Home 3D 开放源码室内设计
|
||||
======
|
||||
|
||||
> 在你去真实世界购物前，在虚拟世界中尝试家具布局、配色方案等等。
|
||||
|
||||
|
||||
|
||||
这里有关于如何装饰房间的三大流派：
|
||||
|
||||
1. 购买一堆家具，并把它们塞进房间。
|
||||
2. 仔细测量每件家具，计算房间的理论容量，然后把它们全部塞进房间，忽略你在床上放置一个书架的事实。
|
||||
3. 使用一台计算机进行预先可视化。
|
||||
|
||||
之前，我还实践了鲜为人知的第四个方式：不要家具。然而，自从我成为一个远程工作者，我发现家庭办公需要一些便利的设施，像一张桌子和一张椅子，一个用于存放参考书和技术手册的书架等等。因此，我一直在制定一个使用实际的家具来迁移我的生活和工作空间的计划，在该*计划*上强调由实木制作，而不是牛奶箱子(或胶水和锯末板之类的东西)。我最不想做的一件事：从旧货市场淘到得宝贝带回家时，发现其进不了门，或者比另一件家具大很多。
|
||||
|
||||
是时候做专业人士该做的事了，是时候做视觉预览了。
|
||||
|
||||
### 开放源码室内设计
|
||||
|
||||
[Sweet Home 3D][2] 是一个开源的（GPLv2）室内设计应用程序，可以帮助你绘制你的住宅平面图，然后定义、重新调整大小以及安排家具。你可以使用精确的尺寸来完成这些，精确到一厘米以下，而不使用任何数学运算，仅使用简单的拖拽操作就行。当你完成后，你可以以 3D 方式查看结果。在 Sweet Home 3D 中规划你家的室内设计，就和在 Word 程序中创建基本的表格一样简单。
|
||||
|
||||
### 安装
|
||||
|
||||
Sweet Home 3D 是一个 [Java][3] 应用程序，因此它是平台通用的。它运行在任何可以运行 Java 的操作系统上，包括 Linux、Windows、MacOS 和 BSD 。不用理会你的操作系统，你可以从网站[下载][4]该应用程序。
|
||||
|
||||
* 在 Linux 上，[untar][5] 存档文件。在 `SweetHome3D` 文件上右键单击，并选择**属性**。在**权限**选项卡中，授予文件可执行权限。
|
||||
* 在 MacOS 和 Windows 上，展开存档文件并启动应用程序。当系统提示时，你必需授予它权限来在你的系统上运行。
|
||||
|
||||
![Sweet Home 3D permissions][6]
|
||||
|
||||
在 Linux 上，你也可以像一个 Snap 软件包一样安装 Sweet Home 3D ，前提是你已经安装并启用 **snapd**。
|
||||
|
||||
### 成功的测量
|
||||
|
||||
首先：打开你的卷尺。为充分利用 Sweet Home 3D，你必须知道你所计划的生活空间的实际尺寸。你可能需要测量精度到毫米或 1/16 英寸；你可以自己把握对偏差幅度的容忍度。但是你必需获得基本的尺寸，包括测量墙壁和门窗。
|
||||
|
||||
用你最好的判断力来判断常识。例如，当测量门时，包括门框；虽然从技术上讲它不是*门*本身的一部分，但它可能是你不想用家具遮挡的一部分墙壁空间。
|
||||
|
||||
![Measure twice, execute once][7]
|
||||
|
||||
### 创建一间房间
|
||||
|
||||
当你第一次启动 Sweet Home 3D 时，它会以其默认查看模式来打开一个空白的画布，蓝图视图在顶部面板中，3D 渲染在底部面板中。在我的 [Slackware][8] 桌面计算机上，它可以很好地工作，不过我的桌面计算机也是我的视频编辑和游戏计算机，所以它有一个极好的 3D 渲染显卡。在我的笔记本计算机上，这种视图模式是非常慢的。为了最好的性能（尤其是在一台计没有 3D 渲染的专用计算机上），转到窗口顶部的 **3D 视图** 菜单，并选择 **虚拟访问** 。这个视图模式基于虚拟访客的位置从地面视图渲染你的工作。这意味着你可以控制渲染的内容和时机。
|
||||
|
||||
不管你计算机是否强力，切换到这个视图的有意义的，因为地表以上的 3D 渲染不比蓝图平面图向你提供更多有用的详细信息。在你更改视图模式后，你可以开始设计。
|
||||
|
||||
第一步是定义你家的墙壁。使用**创建墙壁**工具完成，可以在顶部工具栏的**手形**图标右侧找到。绘制墙壁很简单：单击你想要墙壁开始的位置，单击以锚定位置，不断单击锚定，直到你的房间完成。
|
||||
|
||||
![Drawing walls in Sweet Home 3D][9]
|
||||
|
||||
在你闭合墙壁后，按 `Esc` 来退出工具。
|
||||
|
||||
#### 定义一间房间
|
||||
|
||||
Sweet Home 3D 在你如何创建墙壁的问题上是灵活的。你可以先绘制你房子的外部边界，然后再细分内部，或者你可以绘制每个房间作为结成一体的“容器”，最终形成你房子所占的空间量。这种灵活性是能做到的，因为在现实生活中和在 Sweet Home 3D 中，墙壁并不总是用来定义一间房间。为定义一间房间，使用在顶部工具栏的**创建墙壁**按钮右侧的**创建房间**按钮。
|
||||
|
||||
如果房间的地板空间是通过四面墙所定义，你需要做的全部的定义是像一间房间一样在四面墙壁内双击来圈占地方。Sweet Home 3D 将定义该空间为一间房间，并根据你的喜好，以英尺或米为单位向你提供房间的面积。
|
||||
|
||||
对于不规则的房间，你必需使用每次单击来手动定义房间的每个墙角。根据房间形状的复杂性，你可能不得不进行试验来发现你是否需要从你的原点来顺时针或逆时针工作，以避免奇怪的莫比斯条形地板。不过，一般来说，定义一间房间的地板空间是简单的。
|
||||
|
||||
![Defining rooms in Sweet Home 3D][10]
|
||||
|
||||
在你给定房间一层地板后，你可以更改到**箭头**工具，并在房间上双击来给予它一个名称。你也可以设置地板、墙壁、天花板和踢脚线的颜色及纹理。
|
||||
|
||||
![Modifying room floors, ceilings, etc. in Sweet Home 3D][11]
|
||||
|
||||
默认情况下，这些都不会在蓝图视图中渲染。为启用在你蓝图面板中的房间渲染，转到**文件**菜单并选择**首选项**。在**首选项**面板中，设置**平面图中房间渲染**为**地板颜色或纹理**。
|
||||
|
||||
### 门和窗
|
||||
|
||||
在你完成基本的地板平面图后，你可以长期地切换到**箭头**工具。
|
||||
|
||||
你可以在 Sweet Home 3D 的左栏中的**门和窗**类别下找到门和窗。你有很多选择，所以选择最接近你家的东西。
|
||||
|
||||
![Moving a door in Sweet Home 3D][12]
|
||||
|
||||
为放置一扇门或窗到你的平面图中，在你的蓝图平面图中的合适的墙壁上拖拽门或窗。要调整它的位置和大小，请双击门或窗。
|
||||
|
||||
### 添加家具
|
||||
|
||||
随着基本平面图完成，这部分工作感觉像是结束了！从这点继续，你可以摆弄家具布置以及其它装饰。
|
||||
|
||||
你可以在左栏中找到家具，按预期的方式来组织每个房间。你可以拖拽任何项目到你的蓝图平面图中，当你的鼠标悬停在项目的区域上时，使用可视化工具控制方向和大小。在任何项目上双击双击来调整它的颜色和成品表面。
|
||||
|
||||
### 查看和导出
|
||||
|
||||
为了看看你未来的家将会看起来是什么样子，在你的蓝图视图中拖拽“人”图标到一个房间中。
|
||||
|
||||
![Sweet Home 3D rendering][13]
|
||||
|
||||
你可以在现实和空间感受之间找到自己的平衡，你的想象力是你唯一的限制。你可以从 Sweet Home 3D [下载页面][4]获取附加的有用的资源来添加到你的家中。你甚至可以使用**库编辑器**应用程序创建你自己的家具和纹理，它可以从该项目的网站下载。
|
||||
|
||||
Sweet Home 3D 可以导出你的蓝图平面图为 SVG 格式，以便在 [Inkscape][14] 中使用，并且它可以导出你的 3D 模型为 OBJ 格式，以便在 [Blender][15] 中使用。为导出你的蓝图，转到**平面图**菜单，并选择**导出为 SVG 格式**。为导出一个 3D 模型，转到 **3D 视图** 菜单并选择**导出为 OBJ 格式**。
|
||||
|
||||
你也可以拍摄你家的"快照，以便于不打开 Sweet Home 3D 而回顾你的想法。为创建一个快照，转到 **3D 视图**菜单并选择**创建照片**。快照是按照蓝图视图中的人的图标的角度展现的，因此按照需要调整，然后在**创建照片**窗口中单击**创建**按钮。如果你对快照满意，单击**保存**。
|
||||
|
||||
### 甜蜜的家
|
||||
|
||||
在 Sweet Home 3D 中有更多的特色。你可以添加一片天空和一片草坪，为你的照片定位光线，设置天花板高度，给你房子添加另一楼层等等。不管你是打算租一套公寓，还是买一套房子，或是（尚）不存在的房子，Sweet Home 3D 是一款简单迷人的应用程序，当你匆忙购买家具时，它可以帮助你快乐地做出更好的购买选择。因此，你终于可以停止在厨房的柜台上吃早餐以及蹲在地上工作了。
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/19/10/interior-design-sweet-home-3d
|
||||
|
||||
作者：[Seth Kenlon][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[robsean](https://github.com/robsean)
|
||||
校对：[wxy](https://github.com/wxy)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://opensource.com/users/seth
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/LIFE_housing.png?itok=s7i6pQL1 (Several houses)
|
||||
[2]: http://www.sweethome3d.com/
|
||||
[3]: https://opensource.com/resources/java
|
||||
[4]: http://www.sweethome3d.com/download.jsp
|
||||
[5]: https://opensource.com/article/17/7/how-unzip-targz-file
|
||||
[6]: https://opensource.com/sites/default/files/uploads/sweethome3d-permissions.png (Sweet Home 3D permissions)
|
||||
[7]: https://opensource.com/sites/default/files/images/life/sweethome3d-measure.jpg (Measure twice, execute once)
|
||||
[8]: http://www.slackware.com/
|
||||
[9]: https://opensource.com/sites/default/files/uploads/sweethome3d-walls.jpg (Drawing walls in Sweet Home 3D)
|
||||
[10]: https://opensource.com/sites/default/files/uploads/sweethome3d-rooms.jpg (Defining rooms in Sweet Home 3D)
|
||||
[11]: https://opensource.com/sites/default/files/uploads/sweethome3d-rooms-modify.jpg (Modifying room floors, ceilings, etc. in Sweet Home 3D)
|
||||
[12]: https://opensource.com/sites/default/files/uploads/sweethome3d-move.jpg (Moving a door in Sweet Home 3D)
|
||||
[13]: https://opensource.com/sites/default/files/uploads/sweethome3d-view.jpg (Sweet Home 3D rendering)
|
||||
[14]: http://inkscape.org
|
||||
[15]: http://blender.org
|
||||
@ -1,6 +1,6 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: (MjSeven)
|
||||
[#]: reviewer: ( )
|
||||
[#]: reviewer: (wxy)
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
[#]: subject: (How to write a Python web API with Django)
|
||||
@ -9,12 +9,14 @@
|
||||
|
||||
如何借助 Django 来编写一个 Python Web API
|
||||
======
|
||||
Django 是 Python API 开发中最流行的框架之一，在这个教程中，我们来学习如何使用它。
|
||||
![拿起 Python 书来学习吧][1]
|
||||
|
||||
> Django 是 Python API 开发中最流行的框架之一，在这个教程中，我们来学习如何使用它。
|
||||
|
||||
|
||||
|
||||
[Django][2] 所有 Web 框架中最全面的，也是最受欢迎的一个。自 2005 年以来，其流行度大幅上升。
|
||||
|
||||
Django 是由 Django 软件基金会维护，并且获得了社区的大力支持，在全球拥有超过 11,600 名会员。在 Stack Overflow 上，Django 约有 191,000 个带标签的问题。Spotify、YouTube 和 Instagram 等都使用 Django 来构建应用程序和数据管理。
|
||||
Django 是由 Django 软件基金会维护，并且获得了社区的大力支持，在全球拥有超过 11,600 名成员。在 Stack Overflow 上，约有 191,000 个带 Django 标签的问题。Spotify、YouTube 和 Instagram 等都使用 Django 来构建应用程序和数据管理。
|
||||
|
||||
本文演示了一个简单的 API，通过它可以使用 HTTP 协议的 GET 方法来从服务器获取数据。
|
||||
|
||||
@ -34,11 +36,11 @@ $ python3 -m venv env
|
||||
$ source env/bin/activate
|
||||
```
|
||||
|
||||
在 Windows 上，使用命令 **env\Scripts\activate** 来激活虚拟环境：
|
||||
在 Windows 上，使用命令 `env\Scripts\activate` 来激活虚拟环境。
|
||||
|
||||
### 安装 Django 和 Django REST framework
|
||||
|
||||
然后，安装 Django 和 Django REST：
|
||||
然后，安装 Django 和 Django REST 模块：
|
||||
|
||||
```
|
||||
$ pip3 install django
|
||||
@ -47,7 +49,7 @@ $ pip3 install djangorestframework
|
||||
|
||||
### 实例化一个新的 Django 项目
|
||||
|
||||
现在你的应用程序已经有了一个工作环境，你必须实例化一个新的 Django 项目。与 [Flask][3] 这样微框架不同的是，Django 有专门的命令来创建（注意第一条命令后的 **.** 字符）。
|
||||
现在你的应用程序已经有了一个工作环境，你必须实例化一个新的 Django 项目。与 [Flask][3] 这样微框架不同的是，Django 有专门的命令来创建（注意第一条命令后的 `.` 字符）。
|
||||
|
||||
```
|
||||
$ django-admin startproject tutorial .
|
||||
@ -55,68 +57,68 @@ $ cd tutorial
|
||||
$ django-admin startapp quickstart
|
||||
```
|
||||
|
||||
Django 使用数据库来管理后端，所以你应该在开始开发之前同步数据库，数据库可以通过 **manage.py** 脚本管理，它是在你运行 **django-admin** 命令时创建的。因为你现在在 **tutorial** 目录，所以使用 **../** 符号来运行脚本，它位于上一层目录：
|
||||
Django 使用数据库来管理后端，所以你应该在开始开发之前同步数据库，数据库可以通过 `manage.py` 脚本管理，它是在你运行 `django-admin` 命令时创建的。因为你现在在 `tutorial` 目录，所以使用 `../` 符号来运行脚本，它位于上一层目录：
|
||||
|
||||
```
|
||||
$ python3 ../manage.py makemigrations
|
||||
No changes detected
|
||||
$ python4 ../manage.py migrate
|
||||
Operations to perform:
|
||||
Apply all migrations: admin, auth, contenttypes, sessions
|
||||
Apply all migrations: admin, auth, contenttypes, sessions
|
||||
Running migrations:
|
||||
Applying contenttypes.0001_initial... OK
|
||||
Applying auth.0001_initial... OK
|
||||
Applying admin.0001_initial... OK
|
||||
Applying admin.0002_logentry_remove_auto_add... OK
|
||||
Applying admin.0003_logentry_add_action_flag_choices... OK
|
||||
Applying contenttypes.0002_remove_content_type_name... OK
|
||||
Applying auth.0002_alter_permission_name_max_length... OK
|
||||
Applying auth.0003_alter_user_email_max_length... OK
|
||||
Applying auth.0004_alter_user_username_opts... OK
|
||||
Applying auth.0005_alter_user_last_login_null... OK
|
||||
Applying auth.0006_require_contenttypes_0002... OK
|
||||
Applying auth.0007_alter_validators_add_error_messages... OK
|
||||
Applying auth.0008_alter_user_username_max_length... OK
|
||||
Applying auth.0009_alter_user_last_name_max_length... OK
|
||||
Applying auth.0010_alter_group_name_max_length... OK
|
||||
Applying auth.0011_update_proxy_permissions... OK
|
||||
Applying sessions.0001_initial... OK
|
||||
Applying contenttypes.0001_initial... OK
|
||||
Applying auth.0001_initial... OK
|
||||
Applying admin.0001_initial... OK
|
||||
Applying admin.0002_logentry_remove_auto_add... OK
|
||||
Applying admin.0003_logentry_add_action_flag_choices... OK
|
||||
Applying contenttypes.0002_remove_content_type_name... OK
|
||||
Applying auth.0002_alter_permission_name_max_length... OK
|
||||
Applying auth.0003_alter_user_email_max_length... OK
|
||||
Applying auth.0004_alter_user_username_opts... OK
|
||||
Applying auth.0005_alter_user_last_login_null... OK
|
||||
Applying auth.0006_require_contenttypes_0002... OK
|
||||
Applying auth.0007_alter_validators_add_error_messages... OK
|
||||
Applying auth.0008_alter_user_username_max_length... OK
|
||||
Applying auth.0009_alter_user_last_name_max_length... OK
|
||||
Applying auth.0010_alter_group_name_max_length... OK
|
||||
Applying auth.0011_update_proxy_permissions... OK
|
||||
Applying sessions.0001_initial... OK
|
||||
```
|
||||
|
||||
### 在 Django 中创建用户
|
||||
|
||||
创建一个名为 **admin**，密码为 **password123** 的初始用户：
|
||||
创建一个名为 `admin`，示例密码为 `password123` 的初始用户：
|
||||
|
||||
```
|
||||
$ python3 ../manage.py createsuperuser \
|
||||
--email [admin@example.com][4] \
|
||||
--username admin
|
||||
--email admin@example.com \
|
||||
--username admin
|
||||
```
|
||||
|
||||
在提示时创建密码。
|
||||
|
||||
### 在 Django 中实现序列化和视图
|
||||
|
||||
为了使 Django 能够将信息传递给 HTTP GET 请求，必须将信息对象转化为有效的响应数据。Django 为此实现了“序列化类”。
|
||||
为了使 Django 能够将信息传递给 HTTP GET 请求，必须将信息对象转化为有效的响应数据。Django 为此实现了“序列化类” `serializers`。
|
||||
|
||||
在你的项目中，创建一个名为 **quickstart/serializers.py** 的新模块，使用它来定义一些序列化器，模块将用于数据展示：
|
||||
在你的项目中，创建一个名为 `quickstart/serializers.py` 的新模块，使用它来定义一些序列化器，模块将用于数据展示：
|
||||
|
||||
```
|
||||
from django.contrib.auth.models import User, Group
|
||||
from rest_framework import serializers
|
||||
|
||||
class UserSerializer(serializers.HyperlinkedModelSerializer):
|
||||
class Meta:
|
||||
model = User
|
||||
fields = ['url', 'username', 'email', 'groups']
|
||||
class Meta:
|
||||
model = User
|
||||
fields = ['url', 'username', 'email', 'groups']
|
||||
|
||||
class GroupSerializer(serializers.HyperlinkedModelSerializer):
|
||||
class Meta:
|
||||
model = Group
|
||||
fields = ['url', 'name']
|
||||
class Meta:
|
||||
model = Group
|
||||
fields = ['url', 'name']
|
||||
```
|
||||
|
||||
Django 中的 [view][5] 是一个接受 Web 请求并返回 Web 响应的函数。响应可以是 HTML、HTTP 重定向、HTTP 错误、JSON 或 XML 文档、图像或 TAR 文件，或者可以是从 Internet 获得的任何其他内容。要创建视图，打开 **quickstart/views.py** 并输入以下代码。该文件已经存在，并且其中包含一些示例文本，保留这些文本并将以下代码添加到文件中：
|
||||
Django 中的[视图][5]是一个接受 Web 请求并返回 Web 响应的函数。响应可以是 HTML、HTTP 重定向、HTTP 错误、JSON 或 XML 文档、图像或 TAR 文件，或者可以是从 Internet 获得的任何其他内容。要创建视图，打开 `quickstart/views.py` 并输入以下代码。该文件已经存在，并且其中包含一些示例文本，保留这些文本并将以下代码添加到文件中：
|
||||
|
||||
```
|
||||
from django.contrib.auth.models import User, Group
|
||||
@ -124,23 +126,23 @@ from rest_framework import viewsets
|
||||
from tutorial.quickstart.serializers import UserSerializer, GroupSerializer
|
||||
|
||||
class UserViewSet(viewsets.ModelViewSet):
|
||||
"""
|
||||
API 允许查看或编辑用户
|
||||
"""
|
||||
queryset = User.objects.all().order_by('-date_joined')
|
||||
serializer_class = UserSerializer
|
||||
"""
|
||||
API 允许查看或编辑用户
|
||||
"""
|
||||
queryset = User.objects.all().order_by('-date_joined')
|
||||
serializer_class = UserSerializer
|
||||
|
||||
class GroupViewSet(viewsets.ModelViewSet):
|
||||
"""
|
||||
API 允许查看或编辑组
|
||||
"""
|
||||
queryset = Group.objects.all()
|
||||
serializer_class = GroupSerializer
|
||||
"""
|
||||
API 允许查看或编辑组
|
||||
"""
|
||||
queryset = Group.objects.all()
|
||||
serializer_class = GroupSerializer
|
||||
```
|
||||
|
||||
### 使用 Django 生成 URL
|
||||
|
||||
现在，你可以生成 URL 以便人们可以访问你刚起步的 API。在文本编辑器中打开 urls.py 并将默认示例代码替换为以下代码：
|
||||
现在，你可以生成 URL 以便人们可以访问你刚起步的 API。在文本编辑器中打开 `urls.py` 并将默认示例代码替换为以下代码：
|
||||
|
||||
```
|
||||
from django.urls import include, path
|
||||
@ -154,19 +156,19 @@ router.register(r'groups', views.GroupViewSet)
|
||||
# 使用自动路由 URL
|
||||
# 还有登录 URL
|
||||
urlpatterns = [
|
||||
path('', include(router.urls)),
|
||||
path('api-auth/', include('rest_framework.urls', namespace='rest_framework'))
|
||||
path('', include(router.urls)),
|
||||
path('api-auth/', include('rest_framework.urls', namespace='rest_framework'))
|
||||
]
|
||||
```
|
||||
|
||||
### 调整你的 Django 项目设置
|
||||
|
||||
这个示例项目的设置模块存储在 **tutorial/settings.py** 中，因此在文本编辑器中将其打开，然后在 **INSTALLED_APPS** 列表的末尾添加 **rest_framework**：
|
||||
这个示例项目的设置模块存储在 `tutorial/settings.py` 中，因此在文本编辑器中将其打开，然后在 `INSTALLED_APPS` 列表的末尾添加 `rest_framework`：
|
||||
|
||||
```
|
||||
INSTALLED_APPS = [
|
||||
...
|
||||
'rest_framework',
|
||||
...
|
||||
'rest_framework',
|
||||
]
|
||||
```
|
||||
|
||||
@ -175,17 +177,17 @@ INSTALLED_APPS = [
|
||||
现在，你可以测试构建的 API。首先，从命令行启动内置服务器：
|
||||
|
||||
```
|
||||
`$ python3 manage.py runserver`
|
||||
$ python3 manage.py runserver
|
||||
```
|
||||
|
||||
你可以通过使用 **curl** 导航至 URL **<http://localhost:8000/users>** 来访问 API：
|
||||
你可以通过使用 `curl` 导航至 URL `http://localhost:8000/users` 来访问 API：
|
||||
|
||||
```
|
||||
$ curl --get <http://localhost:8000/users/?format=json>
|
||||
[{"url":"<http://localhost:8000/users/1/?format=json","username":"admin","email":"admin@example.com","groups":\[\]}\]>
|
||||
$ curl --get http://localhost:8000/users/?format=json
|
||||
[{"url":"http://localhost:8000/users/1/?format=json","username":"admin","email":"admin@example.com","groups":[]}]
|
||||
```
|
||||
|
||||
使用 Firefox 或[开源浏览器][6]：
|
||||
使用 Firefox 或你选择的[开源浏览器][6]：
|
||||
|
||||
![一个简单的 Django API][7]
|
||||
|
||||
@ -197,10 +199,10 @@ Django 的主要优点：
|
||||
|
||||
1. Django 社区的规模正在不断扩大，因此即使你做一个复杂项目，也会有大量的指导资源。
|
||||
2. 默认包含模板、路由、表单、身份验证和管理工具等功能，你不必寻找外部工具，也不必担心第三方工具会引入兼容性问题。
|
||||
3. 用户，循环和条件的简单结构使你可以专注于编写代码。
|
||||
3. 用户、循环和条件的简单结构使你可以专注于编写代码。
|
||||
4. 这是一个成熟且经过优化的框架，它非常快速且可靠。
|
||||
|
||||
Django 的主要缺点是：
|
||||
Django 的主要缺点：
|
||||
|
||||
1. Django 很复杂！从开发人员视角的角度来看，它可能比简单的框架更难学。
|
||||
2. Django 有一个很大的生态系统。一旦你熟悉它，这会很棒，但是当你深入学习时，它可能会令人感到无所适从。
|
||||
@ -214,7 +216,7 @@ via: https://opensource.com/article/19/11/python-web-api-django
|
||||
作者：[Rachel Waston][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[MjSeven](https://github.com/MjSeven)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
校对：[wxy](https://github.com/wxy)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
@ -1,240 +0,0 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: ( )
|
||||
[#]: reviewer: ( )
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
[#]: subject: (Run a server with Git)
|
||||
[#]: via: (https://opensource.com/article/19/4/server-administration-git)
|
||||
[#]: author: (Seth Kenlon https://opensource.com/users/seth/users/seth)
|
||||
|
||||
Run a server with Git
|
||||
======
|
||||
Thanks to Gitolite, you can manage a Git server with Git. Learn how in
|
||||
our series about little-known Git uses.
|
||||
![computer servers processing data][1]
|
||||
|
||||
As I've tried to demonstrate in this series leading up to Git's 14th anniversary on April 7, [Git][2] can do a wide range of things beyond tracking source code. Believe it or not, Git can even manage your Git server, so you can, more or less, run a Git server with Git itself.
|
||||
|
||||
Of course, this involves a lot of components beyond everyday Git, not the least of which is [Gitolite][3], the backend application managing the fiddly bits that you configure using Git. The great thing about Gitolite is that, because it uses Git as its frontend interface, it's easy to integrate Git server administration within the rest of your Git-based workflow. Gitolite provides precise control over who can access specific repositories on your server and what permissions they have. You can manage that sort of thing yourself with the usual Linux system tools, but it takes a lot of work if you have more than just one or two repos across a half-dozen users.
|
||||
|
||||
Gitolite's developers have done the hard work to make it easy for you to provide many users with access to your Git server without giving them access to your entire environment—and you can do it all with Git.
|
||||
|
||||
What Gitolite is _not_ is a GUI admin and user panel. That sort of experience is available with the excellent [Gitea][4] project, but this article focuses on the simple elegance and comforting familiarity of Gitolite.
|
||||
|
||||
### Install Gitolite
|
||||
|
||||
Assuming your Git server runs Linux, you can install Gitolite with your package manager ( **yum** on CentOS and RHEL, **apt** on Debian and Ubuntu, **zypper** on OpenSUSE, and so on). For example, on RHEL:
|
||||
|
||||
|
||||
```
|
||||
`$ sudo yum install gitolite3`
|
||||
```
|
||||
|
||||
Many repositories still have older versions of Gitolite for legacy support, but the current version is version 3.
|
||||
|
||||
You must have passwordless SSH access to your server. You can use a password to log in if you prefer, but Gitolite relies on SSH keys, so you must configure the option to log in with keys. If you don't know how to configure a server for passwordless SSH access, go learn how to do that first (the [Setting up SSH key authentication][5] section of Steve Ovens's Ansible article explains it well). It's an essential part of secure server administration—as well as of running Gitolite.
|
||||
|
||||
### Configure a Git user
|
||||
|
||||
Without Gitolite, if a person requests access to a Git repository you host on a server, you have to provide that person with a user account. Git provides a special shell, the **git-shell** , which is an ultra-specific shell that performs only Git tasks. This lets you have users who can access your server only through the filter of a very limited shell environment.
|
||||
|
||||
That solution works, but it usually means a user gains access to all repositories on your server unless you have a very good schema for group permissions and maintain those permissions strictly whenever a new repository is created. It also requires a lot of manual configuration at the system level, an area usually reserved for a specific tier of sysadmins and not necessarily the person usually in charge of Git repositories.
|
||||
|
||||
Gitolite sidesteps this issue entirely by designating one username for every person who needs access to any repository. By default, the username is **git** , and because Gitolite's documentation assumes that's what is used, it's a good default to keep when you're learning the tool. It's also a well-known convention for anyone who's ever used GitLab or GitHub or any other Git hosting service.
|
||||
|
||||
Gitolite calls this user the _hosting user_. Create an account on your server to act as the hosting user (I'll stick with **git** because that's the convention):
|
||||
|
||||
|
||||
```
|
||||
` $ sudo adduser --create-home git`
|
||||
```
|
||||
|
||||
For you to control the **git** user account, it must have a valid public SSH key that belongs to you. You should already have this set up, so **cp** your public key ( _not your private key_ ) to the **git** user's home directory:
|
||||
|
||||
|
||||
```
|
||||
$ sudo cp ~/.ssh/id_ed25519.pub /home/git/
|
||||
$ sudo chown git:git /home/git/id_ed25519.pub
|
||||
```
|
||||
|
||||
If your public key doesn't end with the extension **.pub** , Gitolite will not use it, so rename the file accordingly. Change to that user account to run Gitolite's setup:
|
||||
|
||||
|
||||
```
|
||||
$ sudo su - git
|
||||
$ gitolite setup --pubkey id_ed25519.pub
|
||||
```
|
||||
|
||||
After the setup script runs, the **git** home's user directory will have a **repositories** directory, which (for now) contains the files **git-admin.git** and **testing.git**. That's all the setup the server requires, so log out.
|
||||
|
||||
### Use Gitolite
|
||||
|
||||
Managing Gitolite is a matter of editing text files in a Git repository, specifically **gitolite-admin.git**. You won't SSH into your server for Git administration, and Gitolite encourages you not to try. The repositories you and your users store on the Gitolite server are _bare_ repositories, so it's best to stay out of them.
|
||||
|
||||
|
||||
```
|
||||
$ git clone [git@example.com][6]:gitolite-admin.git gitolite-admin.git
|
||||
$ cd gitolite-admin.git
|
||||
$ ls -1
|
||||
conf
|
||||
keydir
|
||||
```
|
||||
|
||||
The **conf** directory in this repository contains a file called **gitolite.conf**. Open it in a text editor or use **cat** to view its contents:
|
||||
|
||||
|
||||
```
|
||||
repo gitolite-admin
|
||||
RW+ = id_ed22519
|
||||
|
||||
repo testing
|
||||
RW+ = @all
|
||||
```
|
||||
|
||||
You may have an idea of what this configuration file does: **gitolite-admin** represents this repository, and the owner of the **id_ed25519** key has read, write, and Git administrative privileges. In other words, rather than mapping users to normal local Unix users (because all your users log in using the **git** hosting user identity), Gitolite maps users to SSH keys listed in the **keydir** directory.
|
||||
|
||||
The **testing.git** repository gives full permissions to everyone with access to the server using special group notation.
|
||||
|
||||
#### Add users
|
||||
|
||||
If you want to add a user called **alice** to your Git server, the person Alice must send you her public SSH key. Gitolite uses whatever is to the left of the **.pub** extension as the identifier for your Git users. Rather than using the default key name values, give keys a name indicative of the key owner. If a user has more than one key (e.g., one for her laptop, one for her desktop), you can use subdirectories to avoid file name collisions. For instance, the key Alice uses from her laptop might come to you as the default **id_rsa.pub** , so rename it **alice.pub** or similar (or let the users name the key according to their local user accounts on their computers), and place it into the **gitolite-admin.git/keydir/work/laptop/** directory. If she sends you another key from her desktop, name it **alice.pub** (the same as the previous one) and add it to **keydir/work/desktop/**. Another key might go into **keydir/home/desktop/** , and so on. Gitolite recursively searches **keydir** for a **.pub** file matching a repository "user" and treats any match as the same identity.
|
||||
|
||||
When you add keys to the **keydir** directory, you must commit them back to your server. This is such an easy thing to forget that there's a real argument here for using an automated Git application like [**Sparkleshare**][7] so any change is committed back to your Gitolite admin immediately. The first time you forget to commit and push—and waste three hours of your time and your user's time troubleshooting—you'll see that Gitolite is the perfect justification for using Sparkleshare.
|
||||
|
||||
|
||||
```
|
||||
$ git add keydir
|
||||
$ git commit -m 'added alice-laptop-0.pub'
|
||||
$ git push origin HEAD
|
||||
```
|
||||
|
||||
Alice, by default, gains access to the **testing.git** directory so she can test connectivity and functionality with that.
|
||||
|
||||
#### Set permissions
|
||||
|
||||
As with users, directory permissions and groups are abstracted away from the normal Unix tools you might be used to (or find information about online). Permissions to projects are granted in the **gitolite.conf** file in **gitolite-admin.git/conf** directory. There are four levels of permissions:
|
||||
|
||||
* **R** allows read-only. A user with **R** permissions on a repository may clone it, and that's all.
|
||||
* **RW** allows a user to perform a fast-forward push of a branch, create new branches, and create new tags. More or less, this one feels like a "normal" Git repository to most users.
|
||||
* **RW+** allows Git actions that are potentially destructive. A user can perform normal fast-forward pushes, as well as rewind pushes, do rebases, and delete branches and tags. This may or may not be something you want to grant to all contributors on a project.
|
||||
* **-** explicitly denies access to a repository. This is essentially the same as a user not being listed in the repository's configuration.
|
||||
|
||||
|
||||
|
||||
Create a new repository or modify an existing repository's permissions by adjusting **gitolite.conf**. For instance, to give Alice permissions to administrate a new repository called **widgets.git** :
|
||||
|
||||
|
||||
```
|
||||
repo gitolite-admin
|
||||
RW+ = id_ed22519
|
||||
|
||||
repo testing
|
||||
RW+ = @all
|
||||
|
||||
repo widgets
|
||||
RW+ = alice
|
||||
```
|
||||
|
||||
Now Alice—and Alice alone—can clone the repo:
|
||||
|
||||
|
||||
```
|
||||
[alice]$ git clone [git@example.com][6]:widgets.git
|
||||
Cloning into 'widgets'...
|
||||
warning: You appear to have cloned an empty repository.
|
||||
```
|
||||
|
||||
On her initial push, Alice must use the **-u** option to send her branch to the empty repository (as she would have to do with any Git host).
|
||||
|
||||
To make user management easier, you can define groups of repositories:
|
||||
|
||||
|
||||
```
|
||||
@qtrepo = widgets
|
||||
@qtrepo = games
|
||||
|
||||
repo gitolite-admin
|
||||
RW+ = id_ed22519
|
||||
|
||||
repo testing
|
||||
RW+ = @all
|
||||
|
||||
repo @qtrepo
|
||||
RW+ = alice
|
||||
```
|
||||
|
||||
Just as you can create group repositories, you can group users. One user group exists by default: **@all**. As you might expect, it includes all users, without exception. You can create your own:
|
||||
|
||||
|
||||
```
|
||||
@qtrepo = widgets
|
||||
@qtrepo = games
|
||||
|
||||
@developers = alice bob
|
||||
|
||||
repo gitolite-admin
|
||||
RW+ = id_ed22519
|
||||
|
||||
repo testing
|
||||
RW+ = @all
|
||||
|
||||
repo @qtrepo
|
||||
RW+ = @developers
|
||||
```
|
||||
|
||||
As with adding or modifying key files, any change to the **gitolite.conf** file must be committed and pushed to take effect.
|
||||
|
||||
### Create a repository
|
||||
|
||||
By default, Gitolite assumes repository creation happens from the top down. For instance, a project manager with access to the Git server creates a project repository and, through the Gitolite administration repo, adds developers.
|
||||
|
||||
In practice, you might prefer to grant users permission to create repositories. Gitolite calls these "wild repos" (I'm not sure whether that's commentary on how the repos come into being or a reference to the wildcard characters required by the configuration file to let it happen). Here's an example:
|
||||
|
||||
|
||||
```
|
||||
@managers = alice bob
|
||||
|
||||
repo foo/CREATOR/[a-z]..*
|
||||
C = @managers
|
||||
RW+ = CREATOR
|
||||
RW = WRITERS
|
||||
R = READERS
|
||||
```
|
||||
|
||||
The first line defines a group of users: the group is called **@managers** and contains users **alice** and **bob**. The next line sets up a wildcard allowing repositories that do not yet exist to be created in a directory called **foo** followed by a subdirectory named for the user creating the repo. For example:
|
||||
|
||||
|
||||
```
|
||||
[alice]$ git clone [git@example.com][6]:foo/alice/cool-app.git
|
||||
Cloning into cool-app'...
|
||||
Initialized empty Git repository in /home/git/repositories/foo/alice/cool-app.git
|
||||
warning: You appear to have cloned an empty repository.
|
||||
```
|
||||
|
||||
There are some mechanisms for the creator of a wild repo to define who can read and write to their repository, but they're limited in scope. For the most part, Gitolite assumes that a specific set of users governs project permission. One solution is to grant all users access to **gitolite-admin** using a Git hook to require manager approval to merge changes into the master branch.
|
||||
|
||||
### Learn more
|
||||
|
||||
Gitolite has many more features than what this introductory article covers, so try it out. The [documentation][8] is excellent, and once you read through it, you can customize your Gitolite server to provide your users whatever level of control you are comfortable with. Gitolite is a low-maintenance, simple system that you can install, set up, and then more or less forget about.
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/19/4/server-administration-git
|
||||
|
||||
作者：[Seth Kenlon (Red Hat, Community Moderator)][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[译者ID](https://github.com/译者ID)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://opensource.com/users/seth/users/seth
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/server_data_system_admin.png?itok=q6HCfNQ8 (computer servers processing data)
|
||||
[2]: https://git-scm.com/
|
||||
[3]: http://gitolite.com
|
||||
[4]: http://gitea.io
|
||||
[5]: Setting%20up%20SSH%20key%20authentication
|
||||
[6]: mailto:git@example.com
|
||||
[7]: https://opensource.com/article/19/4/file-sharing-git
|
||||
[8]: http://gitolite.com/gitolite/quick_install.html
|
||||
@ -0,0 +1,65 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: ( )
|
||||
[#]: reviewer: ( )
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
[#]: subject: (Sync files across multiple devices with Syncthing)
|
||||
[#]: via: (https://opensource.com/article/20/1/sync-files-syncthing)
|
||||
[#]: author: (Kevin Sonney https://opensource.com/users/ksonney)
|
||||
|
||||
Sync files across multiple devices with Syncthing
|
||||
======
|
||||
Learn how to sync files between devices with Syncthing in the first
|
||||
article in our series on 20 ways to be more productive with open source
|
||||
in 2020.
|
||||
![Files in a folder][1]
|
||||
|
||||
Last year, I brought you 19 days of new (to you) productivity tools for 2019. This year, I'm taking a different approach: building an environment that will allow you to be more productive in the new year, using tools you may or may not already be using.
|
||||
|
||||
### Syncing files with Synthing
|
||||
|
||||
Setting up a new machine is a pain. We all have our "standard setups" that we copy from machine to machine. And over the years, I've used a lot of ways to keep them in sync between machines. In the old days (and this will tell you how old I am), it was with floppy disks, then Zip disks, USB sticks, SCP, Rsync, Dropbox, ownCloud—you name it. And they never seemed to work right for me.
|
||||
|
||||
Then I stumbled upon [Syncthing][2].
|
||||
|
||||
![syncthing console][3]
|
||||
|
||||
Syncthing is a lightweight, peer-to-peer file-synchronization system. You don't need to pay for a service, you don't need a third-party server, and it's fast. Much faster, in my experience, than many of the "big names" in file synchronization.
|
||||
|
||||
Syncthing is available for Linux, MacOS, Windows, and several flavors of BSD. There is also an Android app (but nothing official for iOS yet). There are even handy graphical frontends for all of the above (although I'm not going to cover those here). On Linux, there are packages available for most distributions, so installation is very straightforward.
|
||||
|
||||
![Installing Syncthing on Ubuntu][4]
|
||||
|
||||
When you start Syncthing the first time, it launches a web browser to configure the daemon. There's not much to do on the first machine, but it is a good chance to poke around the user interface (UI) a little bit. The most important thing to see is System ID under the **Actions** menu in the top-right.
|
||||
|
||||
![Machine ID][5]
|
||||
|
||||
Once the first machine is set up, repeat the installation on the second machine. In the UI, there will be a button on the lower-right labeled **Add Remote Device**. Click the button, and you will be presented with a box to enter a **Device ID and a Name**. Copy and paste the **Device ID** from the first machine and click **Save**.
|
||||
|
||||
You should see a pop-up on the first node asking to add the second. Once you accept it, the new machine will show up on the lower-right of the first one. Share the default directory with the second machine. Click on **Default Folder** and then click the **Edit** button. There are four links at the top of the pop-up. Click on **Sharing** and then select the second machine. Click **Save** and look at the second machine. You should get a prompt to accept the shared directory. Once you accept that, it will start synchronizing files between the two machines.
|
||||
|
||||
![Sharing a directory in Syncthing][6]
|
||||
|
||||
Test it out by copying a file to the default directory (**/your/home/Share**) on one of the machines. It should show up on the other one very quickly.
|
||||
|
||||
You can add as many directories as you want or need to the sharing, which is pretty handy. As you can see in the first image, I have one for **myconfigs**—that's where I keep my configuration files. When I get a new machine, I just install Syncthing, and if I tune a configuration on one, I don't have to update all of them—it happens automatically.
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/20/1/sync-files-syncthing
|
||||
|
||||
作者：[Kevin Sonney][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[译者ID](https://github.com/译者ID)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://opensource.com/users/ksonney
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/files_documents_paper_folder.png?itok=eIJWac15 (Files in a folder)
|
||||
[2]: https://syncthing.net/
|
||||
[3]: https://opensource.com/sites/default/files/uploads/productivity_1-1.png (syncthing console)
|
||||
[4]: https://opensource.com/sites/default/files/uploads/productivity_1-2.png (Installing Syncthing on Ubuntu)
|
||||
[5]: https://opensource.com/sites/default/files/uploads/productivity_1-3.png (Machine ID)
|
||||
[6]: https://opensource.com/sites/default/files/uploads/productivity_1-4.png (Sharing a directory in Syncthing)
|
||||
226
translated/tech/20190406 Run a server with Git.md
Normal file
226
translated/tech/20190406 Run a server with Git.md
Normal file
@ -0,0 +1,226 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: (wxy)
|
||||
[#]: reviewer: ( )
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
[#]: subject: (Run a server with Git)
|
||||
[#]: via: (https://opensource.com/article/19/4/server-administration-git)
|
||||
[#]: author: (Seth Kenlon https://opensource.com/users/seth/users/seth)
|
||||
|
||||
使用 Git 来管理 Git 服务器
|
||||
======
|
||||
|
||||
> 借助 Gitolite，你可以使用 Git 来管理 Git 服务器。在我们的系列中了解这些鲜为人知的 Git 用途。
|
||||
|
||||
![computer servers processing data][1]
|
||||
|
||||
正如我在系列文章中演示的那样，[Git][2] 除了跟踪源代码外，还可以做很多事情。信不信由你，Git 甚至可以管理你的 Git 服务器，因此你可以或多或少地使用 Git 本身运行 Git 服务器。
|
||||
|
||||
当然，这涉及除日常使用 Git 之外的许多组件，其中最重要的是 [Gitolite][3]，该后端应用程序可以管理你使用 Git 的每个细小的配置。Gitolite 的优点在于，由于它使用 Git 作为其前端接口，因此很容易将 Git 服务器管理集成到其他基于 Git 的工作流中。Gitolite 可以精确控制谁可以访问你服务器上的特定存储库以及他们具有哪些权限。你可以使用常规的 Linux 系统工具自行管理此类事务，但是如果在六个用户中只有一个或两个以上的仓库，则需要大量的工作。
|
||||
|
||||
Gitolite 的开发人员做了艰苦的工作，使你可以轻松地为许多用户提供对你的 Git 服务器的访问权，而又不让他们访问你的整个环境 —— 而这一切，你可以使用 Git 来完成全部工作。
|
||||
|
||||
Gitolite 并`不是` 图形化的管理员和用户面板。优秀的 [Gitea][4] 项目可提供这种经验，但是本文重点介绍 Gitolite 的简单优雅和令人舒适的熟悉感。
|
||||
|
||||
### 安装 Gitolite
|
||||
|
||||
假设你的 Git 服务器运行 Linux，则可以使用包管理器安装 Gitolite（在 CentOS 和 RHEL 上为 `yum`，在 Debian 和 Ubuntu 上为 `apt`，在 OpenSUSE 上为 `zypper` 等）。例如，在 RHEL 上：
|
||||
|
||||
```
|
||||
$ sudo yum install gitolite3
|
||||
```
|
||||
|
||||
许多发行版的存储库仍提供的是旧版本的 Gitolite，但当前版本为版本 3。
|
||||
|
||||
你必须具有对服务器的无密码 SSH 访问权限。如果愿意，你可以使用密码登录服务器，但是 Gitolite 依赖于 SSH 密钥，因此必须配置使用密钥登录的选项。如果你不知道如何配置服务器以进行无密码 SSH 访问，请首先学习如何进行操作（Steve Ovens 的 Ansible 文章的[设置 SSH 密钥身份验证][5]部分对此进行了很好的说明）。这是加强服务器管理的安全以及运行 Gitolite 的重要组成部分。
|
||||
|
||||
### 配置 Git 用户
|
||||
|
||||
如果没有 Gitolite，则如果某人请求访问你在服务器上托管的 Git 存储库，则必须向该人提供用户帐户。Git 提供了一个特殊的外壳，即 `git-shell`，这是一个仅执行 Git 任务的特别特定的 shell。这可以让你有个只能通过非常受限的 Shell 环境的过滤器来访问服务器的用户。
|
||||
|
||||
该解决方案可行，但通常意味着用户可以访问服务器上的所有存储库，除非你具有用于组权限的良好模式，并在创建新存储库时严格保持这些权限。这种方式还需要在系统级别进行大量手动配置，这通常是为特定级别的系统管理员保留的区域，而不一定是通常负责 Git 存储库的人员。
|
||||
|
||||
Gitolite 通过为需要访问任何存储库的每个人指定一个用户名来完全回避此问题。 默认情况下，用户名是 `git`，并且由于 Gitolite 的文档假定使用的是它，因此在学习该工具时保留它是一个很好的默认设置。对于曾经使用过 GitLab 或 GitHub 或任何其他 Git 托管服务的人来说，这也是一个众所周知的约定。
|
||||
|
||||
Gitolite 将此用户称为**托管用户**。在服务器上创建一个帐户以充当托管用户（我习惯使用 `git`，因为这是惯例）：
|
||||
|
||||
```
|
||||
$ sudo adduser --create-home git
|
||||
```
|
||||
|
||||
为了控制该 `git` 用户帐户，该帐户必须具有属于你的有效 SSH 公钥。你应该已经进行了设置，因此复制你的公钥（**不是你的私钥**）添加到 `git` 用户的家目录中：
|
||||
|
||||
```
|
||||
$ sudo cp ~/.ssh/id_ed25519.pub /home/git/
|
||||
$ sudo chown git:git /home/git/id_ed25519.pub
|
||||
```
|
||||
|
||||
如果你的公钥不以扩展名 `.pub` 结尾，则 Gitolite 不会使用它，因此请相应地重命名该文件。切换为该用户帐户以运行 Gitolite 的安装程序：
|
||||
|
||||
```
|
||||
$ sudo su - git
|
||||
$ gitolite setup --pubkey id_ed25519.pub
|
||||
```
|
||||
|
||||
安装脚本运行后，`git` 的家用户目录将有一个 `repository` 目录，该目录（目前）包含文件 `git-admin.git` 和 `testing.git`。这就是该服务器所需的全部设置，现在请登出 `git` 用户。
|
||||
|
||||
### 使用 Gitolite
|
||||
|
||||
管理 Gitolite 就是编辑 Git 存储库中的文本文件，尤其是 `gitolite-admin.git`。你不会通过 SSH 进入服务器来进行 Git 管理，并且 Gitolite 也建议你不要这样尝试。你和你的用户存储在 Gitolite 服务器上的存储库是个**裸**存储库，因此最好不要使用它们。
|
||||
|
||||
```
|
||||
$ git clone git@example.com:gitolite-admin.git gitolite-admin.git
|
||||
$ cd gitolite-admin.git
|
||||
$ ls -1
|
||||
conf
|
||||
keydir
|
||||
```
|
||||
|
||||
该存储库中的 `conf` 目录包含一个名为 `gitolite.conf` 的文件。在文本编辑器中打开它，或使用`cat`查看其内容：
|
||||
|
||||
```
|
||||
repo gitolite-admin
|
||||
RW+ = id_ed22519
|
||||
|
||||
repo testing
|
||||
RW+ = @all
|
||||
```
|
||||
|
||||
你可能对该配置文件的功能有所了解：`gitolite-admin` 代表此存储库，并且 `id_ed25519` 密钥的所有者具有读取、写入和 Git 管理权限。换句话说，不是将用户映射到普通的本地 Unix 用户（因为所有用户都使用 `git` 用户托管用户身份），而是将用户映射到 `keydir` 目录中列出的 SSH 密钥。
|
||||
|
||||
`testing.git` 存储库使用特殊组符号为访问服务器的每个人提供了全部权限。
|
||||
|
||||
#### 添加用户
|
||||
|
||||
如果要向 Git 服务器添加一个名为 `alice` 的用户，Alice 必须向你发送她的 SSH 公钥。Gitolite 使用 `.pub` 扩展名左边的任何内容作为该 Git 用户的标识符。不要使用默认的密钥名称值，而是给密钥指定一个指示密钥所有者的名称。如果用户有多个密钥（例如，一个用于笔记本电脑，一个用于台式机），则可以使用子目录来避免文件名冲突。例如，Alice 在笔记本电脑上使用的密钥可能是默认的 `id_rsa.pub`，因此将其重命名为`alice.pub` 或类似名称（或让用户根据其计算机上的本地用户帐户来命名密钥），然后将其放入 `gitolite-admin.git/keydir/work/laptop/` 目录中。如果她从她的桌面发送了另一个密钥，命名为 `alice.pub`（与上一个相同），然后将其添加到 `keydir/home/desktop/` 中。另一个密钥可能放到 `keydir/home/desktop/` 中，依此类推。Gitolite 递归地在 `keydir` 中搜索与存储库“用户”匹配的 `.pub` 文件，并将所有匹配项视为相同的身份。
|
||||
|
||||
当你将密钥添加到 `keydir` 目录时，必须将它们提交回服务器。这是一件很容易忘记的事情，这里有一个使用自动化的 Git 应用程序（例如 [Sparkleshare] [7]）的真正的理由，因此任何更改都将立即提交给你的 Gitolite 管理员。第一次忘记提交和推送，在浪费了三个小时的时间以及用户的故障排除时间之后，你会发现 Gitolite 是使用 Sparkleshare 的完美理由。
|
||||
|
||||
```
|
||||
$ git add keydir
|
||||
$ git commit -m 'added alice-laptop-0.pub'
|
||||
$ git push origin HEAD
|
||||
```
|
||||
|
||||
默认情况下，Alice 可以访问 `testing.git` 目录，因此她可以使用该目录测试连接性和功能。
|
||||
|
||||
#### 设置权限
|
||||
|
||||
与用户一样，目录权限和组也是从你可能习惯的的常规 Unix 工具中抽象出来的（或可从在线信息查找）。在`gitolite-admin.git/conf` 目录中的 `gitolite.conf` 文件中授予对项目的权限。权限分为四个级别：
|
||||
|
||||
* `R` 允许只读。在存储库上具有 `R` 权限的用户可以克隆它，仅此而已。
|
||||
* `RW` 允许用户执行分支的快进推送、创建新分支和创建新标签。对于大多数用户来说，这个或多或少感觉就像一个“普通”的 Git 存储库。
|
||||
* `RW+` 允许可能具有破坏性的 Git 动作。用户可以执行常规的快进推送、回滚推送、变基以及删除分支和标签。你可能想要或不希望将其授予项目中的所有贡献者。
|
||||
* `-` 明确拒绝访问存储库。这与未在存储库的配置中列出的用户相同。
|
||||
|
||||
通过调整 `gitolite.conf` 来创建一个新的存储库或修改现有存储库的权限。例如，授予 Alice 权限来管理一个名为 `widgets.git` 的新存储库：
|
||||
|
||||
```
|
||||
repo gitolite-admin
|
||||
RW+ = id_ed22519
|
||||
|
||||
repo testing
|
||||
RW+ = @all
|
||||
|
||||
repo widgets
|
||||
RW+ = alice
|
||||
```
|
||||
|
||||
现在，Alice（也仅 Alice 一个人）就可以克隆该存储库：
|
||||
|
||||
```
|
||||
[alice]$ git clone git@example.com:widgets.git
|
||||
Cloning into 'widgets'...
|
||||
warning: You appear to have cloned an empty repository.
|
||||
```
|
||||
|
||||
在第一次推送时，Alice 必须使用 `-u` 选项将其分支发送到空存储库（如同她在任何 Git 主机上做的一样）。
|
||||
|
||||
为了简化用户管理，你可以定义存储库组：
|
||||
|
||||
```
|
||||
@qtrepo = widgets
|
||||
@qtrepo = games
|
||||
|
||||
repo gitolite-admin
|
||||
RW+ = id_ed22519
|
||||
|
||||
repo testing
|
||||
RW+ = @all
|
||||
|
||||
repo @qtrepo
|
||||
RW+ = alice
|
||||
```
|
||||
|
||||
正如你可以创建组存储库一样，你也可以对用户进行分组。默认情况下存在一个用户组：`@all`。如你所料，它包括所有用户，无一例外。你也可以创建自己的组：
|
||||
|
||||
```
|
||||
@qtrepo = widgets
|
||||
@qtrepo = games
|
||||
|
||||
@developers = alice bob
|
||||
|
||||
repo gitolite-admin
|
||||
RW+ = id_ed22519
|
||||
|
||||
repo testing
|
||||
RW+ = @all
|
||||
|
||||
repo @qtrepo
|
||||
RW+ = @developers
|
||||
```
|
||||
|
||||
与添加或修改密钥文件一样，对 `gitolite.conf` 文件的任何更改都必须提交并推送以生效。
|
||||
|
||||
### 创建存储库
|
||||
|
||||
默认情况下，Gitolite 假设存储库的创建是从上至下进行。例如，有权访问 Git 服务器的项目经理创建了一个项目存储库，并通过 Gitolite 管理仓库添加了开发人员。
|
||||
|
||||
实际上，你可能更愿意向用户授予创建存储库的权限。Gitolite 称这些为“<ruby>野生仓库（通配仓库）<rt>wild repos</rt></ruby>”（我不确定这是关于仓库的形成方式的描述，还是指配置文件所需的通配符）。这是一个例子：
|
||||
|
||||
```
|
||||
@managers = alice bob
|
||||
|
||||
repo foo/CREATOR/[a-z]..*
|
||||
C = @managers
|
||||
RW+ = CREATOR
|
||||
RW = WRITERS
|
||||
R = READERS
|
||||
```
|
||||
|
||||
第一行定义了一组用户：该组称为 `@managers`，其中包含用户 `alice` 和 `bob`。下一行设置了通配符允许创建尚不存在的存储库，放在名为 `foo` 的目录下的创建存储库的用户名的子目录中。例如：
|
||||
|
||||
```
|
||||
[alice]$ git clone git@example.com:foo/alice/cool-app.git
|
||||
Cloning into cool-app'...
|
||||
Initialized empty Git repository in /home/git/repositories/foo/alice/cool-app.git
|
||||
warning: You appear to have cloned an empty repository.
|
||||
```
|
||||
|
||||
野生仓库的创建者可以使用一些机制来定义谁可以读取和写入其存储库，但是他们是被限定范围的。在大多数情况下，Gitolite 假定由一组特定的用户来管理项目权限。一种解决方案是使用 Git 挂钩授予所有用户对 `gitolite-admin` 的访问权限，以要求管理者批准将更改合并到 master 分支中。
|
||||
|
||||
### 了解更多
|
||||
|
||||
Gitolite 具有比此介绍性文章涵盖的更多功能，因此请尝试一下。其[文档][8]非常出色，一旦你通读了它，就可以自定义 Gitolite 服务器，以向用户提供你喜欢的任何级别的控制。Gitolite 是一种维护成本低、简单的系统，你可以安装、设置它，然后基本上就可以将其忘却。
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/19/4/server-administration-git
|
||||
|
||||
作者：[Seth Kenlon][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[wxy](https://github.com/wxy)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://opensource.com/users/seth/users/seth
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/server_data_system_admin.png?itok=q6HCfNQ8 (computer servers processing data)
|
||||
[2]: https://git-scm.com/
|
||||
[3]: http://gitolite.com
|
||||
[4]: http://gitea.io
|
||||
[5]: Setting%20up%20SSH%20key%20authentication
|
||||
[6]: mailto:git@example.com
|
||||
[7]: https://opensource.com/article/19/4/file-sharing-git
|
||||
[8]: http://gitolite.com/gitolite/quick_install.html
|
||||
@ -1,141 +0,0 @@
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: (robsean)
|
||||
[#]: reviewer: ( )
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
[#]: subject: (Open source interior design with Sweet Home 3D)
|
||||
[#]: via: (https://opensource.com/article/19/10/interior-design-sweet-home-3d)
|
||||
[#]: author: (Seth Kenlon https://opensource.com/users/seth)
|
||||
|
||||
Sweet Home 3D 开放源码室内设计
|
||||
======
|
||||
在你去真实世界购物前，在虚拟世界中尝试家具布局，配色方案等等。
|
||||
![Several houses][1]
|
||||
|
||||
这里有关于如何装饰房间的三大流派：
|
||||
|
||||
1. 购买一堆家具，并把它们塞进房间。
|
||||
2. 仔细测量每件家具，计算房间的理论容量，然后把它们全部塞进房间，忽略你在床上放置一个书架的事实。
|
||||
3. 使用一台计算机进行预先可视化。
|
||||
|
||||
|
||||
|
||||
从历史观点上说，我实践了鲜为人知的第四条原则：没有家具。然而，自从我成为一个远程工作者，我发现家庭办公需要一些便利的设施，像一张桌子和一张椅子，一个用于存放参考书和技术手册的书架等等。因此，我一直在制定一个使用实际的家具来迁移我的生活和工作空间的计划，在 _计划_ 上强调由实木制作，而不是牛奶箱子(或胶水和锯末，或同样的东西)。我最不想做的一件事：从旧货市场淘到得宝贝带回家时，发现其进不了门，或者比另一件家具大很多。
|
||||
|
||||
是时候做专业人士该做的事了。是时候视觉预览了。
|
||||
|
||||
### 开放源码室内设计
|
||||
|
||||
[Sweet Home 3D][2] 是一个开放源码 (GPLv2) 室内设计应用程序，帮助你绘制你的住宅平面图，然后定义，重新调整大小以及安排家具。你可以使用精确的尺寸来完成这些，精确到一厘米以下，而不使用任何数学运算，仅使用简单的拖拽操作。当你完成后，你可以在 3D 中查看结果。如果你可以在一个 word 程序中创建一个基本的表格(不是家具类)，你可以在 Sweet Home 3D 中规划你家的室内设计。
|
||||
|
||||
### 安装
|
||||
|
||||
Sweet Home 3D 是一个 [Java][3] 应用程序，因此它是通用的。它运行在任何可以运行 Java 的操作系统上，包括 Linux ，Windows ，MacOS 和 BSD 。不用理会你的操作系统，你可以从网站 [下载][4] 应用程序。
|
||||
|
||||
* 在 Linux 上，[untar][5] 存档文件。在 SweetHome3D 文件上右键单击，并选择**属性**。在**权限**选项卡中，授予文件可执行权限。
|
||||
* 在 MacOS 和 Windows 上，展开存档文件并启动应用程序。当系统提示时，你必需授予它权限来在你的系统上运行。
|
||||
|
||||
![Sweet Home 3D permissions][6]
|
||||
|
||||
在 Linux 上，你也可以像一个 Snap 软件包一样安装 Sweet Home 3D ，前提是你已经安装并启用 **snapd** 。
|
||||
|
||||
### 成功的测量
|
||||
|
||||
首先：打开你的卷尺。为充分利用 Sweet Home 3D ，你必须知道你计划生活空间的实际尺寸。你可能需要测量到毫米或1/16英寸；你知道你自己对变化幅度的容忍度。但是你必需获得基本的尺寸，包括材料墙壁和门窗。
|
||||
|
||||
用你最好的判断力来判断常识。例如，当测量门时，包括门框；
|
||||
|
||||
虽然从技术上讲它不是 _门_ 本身的一部分，它可能是你不想用家具覆盖的墙壁空间的一部分。
|
||||
|
||||
![Measure twice, execute once][7]
|
||||
|
||||
CC-SA-BY opensource.com
|
||||
|
||||
### 创建一间房间
|
||||
|
||||
当你第一次启动 Sweet Home 3D 时，它会以它的默认查看模式来打开一个空白的画布，蓝图视图在顶部面板中，3D 渲染在底部面板中。在我的 [Slackware][8] 桌面计算机上，这项工作非常友好，但是我的桌面计算机也是我的视频编辑和游戏计算机，所以它有一个极好的 3D 渲染显卡。在我的笔记本计算机上，这种视图模式是非常慢的。为了最好的性能(尤其是在一台计没有 3D 渲染的专用计算机上)，转到窗口顶部的 **3D 视图** 菜单，并选择 **虚拟访问** 。这个视图模式基于虚拟访客的位置从地面视图渲染你的工作。这意味着你可以控制渲染的东西和时机。
|
||||
|
||||
不顾你计算机的功率来切换到这个视图的有意义的，因为地表以上的 3D 渲染不比蓝图平面图向你提供更多有用的详细信息。在你更改视图模式后，你可以开始设计。
|
||||
|
||||
第一步是定义你家的墙壁。使用**创建墙壁**工具完成，在顶部工具栏的右侧找到 **手** 图标。绘制墙壁很简单：单击你想要墙壁开始的位置，单击以锚定位置，不断单击锚定，直到你的房间完成。
|
||||
|
||||
![Drawing walls in Sweet Home 3D][9]
|
||||
|
||||
在你闭合墙壁后，按**Esc**来退出工具。
|
||||
|
||||
#### 定义一间房间
|
||||
|
||||
Sweet Home 3D 在你如何创建墙壁的问题上是灵活的。你可以先绘制你房子的外部边界，然后再细分内部，或者你可以绘制每个房间作为结成一体的"容器"，最终形成你房子所占的空间量。这种灵活性是能做到的，因为在现实生活中和在 Sweet Home 3D 中，墙壁并不总是定义一间房间。为定义一间房间，使用在顶部工具栏的**创建墙壁** 按钮右侧的 **创建房间** 按钮。
|
||||
|
||||
如果房间的地板空间是通过四面墙所定义，你们你需要做的全部的定义是像一间房间一样在四面墙壁内双击来圈占地方。Sweet Home 3D 将定义空间为一间房间，并根据你的喜好，以英尺或米为单位向你提供房间的面积。
|
||||
|
||||
对于不规则的房间，你必需使用每次单击来手动定义房间的每个墙角。根据房间形状的复杂性，你可能不得不进行试验来发现你是否需要从你的原点来顺时针或逆时针工作，以避免奇怪的莫比斯条形地板。不过，一般来说，定义一间房间的地板空间是简单的。
|
||||
|
||||
![Defining rooms in Sweet Home 3D][10]
|
||||
|
||||
在你给定房间一层地板后，你可以更改到 **箭头** 工具，并在房间上双击来给予它一个名称。你也可以设置地板，墙壁，天花板和踢脚板的颜色及纹理。
|
||||
|
||||
![Modifying room floors, ceilings, etc. in Sweet Home 3D][11]
|
||||
|
||||
默认情况下，这些都不会在蓝图视图中渲染。为启用在你蓝图面板中的房间渲染，转到 **文件** 菜单并选择 **首选项** 。在 **首选项** 面板中，设置 **平面图中房间渲染** 为 **地板颜色或纹理** 。
|
||||
|
||||
### 门和窗
|
||||
|
||||
在你完成基本的地板平面图后，你可以长期地切换到 **箭头** 工具。
|
||||
|
||||
你可以在 Sweet Home 3D 的左栏中的 **门和窗** 类别下找到门和窗。你有很多选择，所以选择最接近你家的东西。
|
||||
|
||||
![Moving a door in Sweet Home 3D][12]
|
||||
|
||||
为放置一扇门或窗到你的平面图中，在你的蓝图平面图中的合适的墙壁上拖拽门或窗。为调整它的位置和大小，双击门或窗。
|
||||
|
||||
### 添加家具
|
||||
|
||||
随着基本计划完成，部分工作感觉像 _工作_ 结束了！从这点继续，你可以玩弄家具布置以及其它装饰。
|
||||
|
||||
你可以在左栏中找到家具，按每个计划的房间来组织。你可以拖拽任何项目到你的蓝图平面图中，当你的鼠标悬停在项目的区域上时，使用可视化工具控制方向和大小。在任何项目上双击双击来调整它的颜色和成品表面。
|
||||
|
||||
### 访问和导出
|
||||
|
||||
为了看看你未来的家将会看起来是什么样子，在你的蓝图视图中拖拽"人"图标到一个房间中。
|
||||
|
||||
![Sweet Home 3D rendering][13]
|
||||
|
||||
你可以在现实主义和仅感受空间感之间找到自己的平衡，只要你的想象力是你唯一的限制。你可以从 Sweet Home 3D [下载页面][4] 获取附加的有用的资源来添加到你的家中。你甚至可以使用 **库编辑器** 应用程序创建你自己的家具和纹理，它们可以从项目网站有选择地下载。
|
||||
|
||||
Sweet Home 3D 可以导出你的蓝图平面图为 SVG 格式，以便在 [Inkscape][14] 中使用，并且它可以导出你的 3D 模型为 OBJ 格式，以便在 [Blender][15] 中使用。为导出你的蓝图，转到**平面图**菜单，并选择**导出为 SVG 格式**。为导出一个 3D 模型，转到 **3D 视图** 菜单并选择**导出为 OBJ 格式**。
|
||||
|
||||
你也可以拍摄你家的"快照，以便于不打开 Sweet Home 3D 而参考你的想法。为创建一个快照，转到 **3D视图** 菜单并选择 **创建照片**。快照是按照蓝图视图中的人的图标的角度展现的，因此按照需要调整，然后在 **创建照片** 窗口中单击 **创建** 按钮。 如果你对快照满意，单击 **保存** 。
|
||||
|
||||
### 甜蜜的家
|
||||
|
||||
在 Sweet Home 3D 中有更多的特色。你可以添加一片天空和一片草坪，为你的照片定位光线，设置天花板高度，给你房子添加另一楼层等等。不管你打算租一套公寓，还是买一套房子—或是(还)尚不存在的房子，Sweet Home 3D 是一款简单迷人的应用程序，当你匆忙购买家具时，它可以娱乐并帮助你做出更好的购买选择。因此，你终于可以停止在厨房的柜台上吃早餐以及蹲在地上工作。
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/19/10/interior-design-sweet-home-3d
|
||||
|
||||
作者：[Seth Kenlon][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[robsean](https://github.com/robsean)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://opensource.com/users/seth
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/LIFE_housing.png?itok=s7i6pQL1 (Several houses)
|
||||
[2]: http://www.sweethome3d.com/
|
||||
[3]: https://opensource.com/resources/java
|
||||
[4]: http://www.sweethome3d.com/download.jsp
|
||||
[5]: https://opensource.com/article/17/7/how-unzip-targz-file
|
||||
[6]: https://opensource.com/sites/default/files/uploads/sweethome3d-permissions.png (Sweet Home 3D permissions)
|
||||
[7]: https://opensource.com/sites/default/files/images/life/sweethome3d-measure.jpg (Measure twice, execute once)
|
||||
[8]: http://www.slackware.com/
|
||||
[9]: https://opensource.com/sites/default/files/uploads/sweethome3d-walls.jpg (Drawing walls in Sweet Home 3D)
|
||||
[10]: https://opensource.com/sites/default/files/uploads/sweethome3d-rooms.jpg (Defining rooms in Sweet Home 3D)
|
||||
[11]: https://opensource.com/sites/default/files/uploads/sweethome3d-rooms-modify.jpg (Modifying room floors, ceilings, etc. in Sweet Home 3D)
|
||||
[12]: https://opensource.com/sites/default/files/uploads/sweethome3d-move.jpg (Moving a door in Sweet Home 3D)
|
||||
[13]: https://opensource.com/sites/default/files/uploads/sweethome3d-view.jpg (Sweet Home 3D rendering)
|
||||
[14]: http://inkscape.org
|
||||
[15]: http://blender.org
|
||||
Loading…
Reference in New Issue
Block a user