下面以姿态估计主题为例，指导如何阅读与主题相关的研究论文。

1、 收集针对主题的资源集。资源形式可包括：研究论文、Medium文章、博文、视频、GitHub库等。

谷歌搜索“姿态估计”，将显示包含主题相关信息的一流资源。第一步的目标是整理所有相关资源，如YouTube视频、实施文档以及研究论文。在这一阶段，收集自己认为重要的资源，没有数量限制，但是请确保为有用的论文、视频和文章创建一个“候选名单”。

2、 深入挖掘自己认为与主题相关的资源。记录对于每个候选资源的理解，这一点至关重要。吴恩达建议根据自己对资源的理解程度绘制一个表格，如下所示。

Richmond Alake创建的资源理解等级表

添加到列表中的每篇文章至少要浏览10-20%内容，以确保在已标识的资源中了解到足够多的介绍性内容，并能准确地评估其相关性。

对于已标识更具相关性的论文/资源，建议更深一步理解。最后得到一些自己完全理解的合适资源。

你可能会问自己：“阅读多少论文/资源才够？”

笔者也不知道答案，但是吴恩达知道。

据吴恩达说，理解5-20篇论文即可展现出对主题的基本理解，也许足以推动技术的实施。

阅读50-100篇论文可以很好的理解该领域。

在浏览资源并提取重要信息后，表格可能变成这样：

Richmond Alake创建的资源理解等级表（更新后）

3、 这是笔者观察到的一个快速技巧，在理解研究论文时很有用。该步骤是进行结构性注释，用自己的话总结论文中的关键发现、结果和技术。

下列步骤将集中于如何阅读一篇研究论文。

阅读一篇研究论文

只通读一遍论文内容不能实现理解的目的。吴恩达认为，一次性从头到尾逐字阅读一篇论文并非形成理解的最佳方式。

要想很好的理解内容，至少要将论文通读三遍。

4、 第一遍，阅读文中以下部分：题目、摘要和图片。

5、 第二遍，先阅读以下部分：引言、结论、图片（再次阅览），然后浏览论文剩余部分。

论文的引言和结论部分包含了对文章总体内容清晰简明的介绍和对发现的总结。这几节通常只提供包括关键信息，而无补充信息。作为读者，这是有益的，因为能抓到阅读论文其他部分所需的关键信息。

6、 第三遍，阅读全文，但是跳过所有陌生复杂的数学计算或技术公式。还可跳过不理解或不熟悉的术语和技术。

7、 对某个领域进行深入研究的论文可以多阅读几遍。这些额外遍数将主要专注在对文中数学、技术以及陌生术语的理解。

对于那些通常出于信息和工程目的阅读研究论文的人，深入研究可能是非常耗时的，特别是在还有20篇论文要阅读的时候。

笔者通过介绍LeNet卷积神经网络的原始论文来展开本文的介绍过程，并总结了笔记中的关键内容，然后将其转换为一系列Medium文章。

问自己一些问题

吴恩达提出一套在阅读论文时询问自己的问题。这些问题通常会令读者明白论文中的关键信息。笔者通常使用如下问题，以防止自己偏离理解重要信息的目标。

问题如下：

1、描述论文作者旨在实现，或已经实现的成果。

2、如果论文介绍了一个新方法/技术，它的关键要素是什么？

3、文中哪些内容对你有用？

4、你还想了解什么？

1. Nginx配置域名ACME

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

load_module /usr/lib/nginx/modules/ngx_stream_module.so;
pid /home/path/nginx.pid;
worker_processes auto;
events {
    worker_connections  1024;
    accept_mutex on;
  }
error_log /var/log/nginx/error.log;
http {
  include mime.types;
  default_type application/octet-stream;
  server {
    server_name www.xxx.com;
    listen 443 ssl http2;
    ssl_certificate /etc/letsencrypt/live/xxx.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/xxx.com/privkey.pem;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;
    listen 80;
    include /home/webpath/letsencrypt-acme-challenge.conf;
    if ($scheme = http) {
      return 301 https://$host:443$request_uri;
      }
    location / {
      proxy_pass http://localhost:3000/;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header X-Forwarded-Host $http_host;
      proxy_set_header X-Forwarded-Port $server_port;
      proxy_set_header X-Forwarded-Proto $scheme;
    }
  }
}

其中需要特别注意的是这三行：

1
2
3
4
5

listen 80;
include /home/path/letsencrypt-acme-challenge.conf;
if ($scheme = http) {
  return 301 https://$host:443$request_uri;
}

第一行设置监听80端口（HTTP默认端口，ACME验证需要使用）；第二行设置ACME路径；第三行设置其他正常HTTP请求跳转HTTPS。

letsencrypt-acme-challenge.conf内容如下：

1
2
3
4
5
6
7
8
9

location ^~ /.well-known/acme-challenge/ {
    default_type "text/plain";
    root         /home/nginxWebUI;
    break;
}

location = /.well-known/acme-challenge/ {
    return 404;
}

2. 使用Certbot申请证书

Certbot的安装方式不再赘述，网上有很多。

安装完成之后，使用命令：

1

sudo certbot certonly --webroot -w /home/webpath -d www.xxx.cn -d xxx.cn

使用了--webroot子命令后需要使用-w参数指定网站路径，笔者由于使用了docker版的nginx，并将用户/home某目录挂载到了容器中的网站路径下，所以跟一般nginx默认路径不同。请注意要将letsencrypt-acme-challenge.conf文件放在对应路径下。

每一个子域名可以使用-d参数来指定，当前子域名个数限制为每周最多申请50个。具体请见Let’s Encrypt官网。

3. 使用申请好的证书

在第一段中的Nginx配置中有如下几行：

1
2
3
4

listen 443 ssl http2;
ssl_certificate /etc/letsencrypt/live/xxx.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/xxx.com/privkey.pem;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;

中间证书的路径需要改成对应的证书路径。

4. 更新证书

直接运行命令

1

sudo certbot renew

会自动更新所有证书，可以将上述语句放入crontab中，目前证书有效期为90天。

证书更新后nginx需要reload。

配置环境：
　　操作系统：Ubuntu 18.04 LTS
　　配置域名：kobeyoung81.cn

具体步骤

1、获取certbot

不同的操作系统对于certbot的安装方式不尽相同，我这里直接使用了官方源中的包。

2、开始申请证书

sudo certbot -d “*.kobeyoung81.cn” –manual –preferred-challenges dns-01 certonly

3、根据提示设置ACME TXT

在DNS服务商解析规则中增加TXT类型的解析，域名是_acme-challenge.kobeyoung81.cn，值按照certbot提示输入

4、生成证书

回车后成功生成证书

简单！

runlike使用

1

runlike <container-name>

增加参数 -p 可以输出经过美化的命令，例如

1
2
3
4
5
6
7
8
9
10
11
12

$ runlike -p redis

docker run \
    --name=redis \
    -e "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" \
    -e "REDIS_VERSION=2.8.9" \
    -e "REDIS_DOWNLOAD_URL=http://download.redis.io/releases/redis-2.8.9.tar.gz" \
    -e "REDIS_DOWNLOAD_SHA1=003ccdc175816e0a751919cf508f1318e54aac1e" \
    -p 0.0.0.0:6379:6379/tcp \
    --detach=true \
    myrepo/redis:7860c450dbee9878d5215595b390b9be8fa94c89 \
    redis-server --slaveof 172.31.17.84 6379

runlike安装

本节介绍如何不安装运行runlike( :-P )。
runlike 已经被制成了docker镜像: assaflavie/runlike.
直接运行：

1
2

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
    assaflavie/runlike YOUR-CONTAINER

也可以将下列同义词放入 ~/.profile 或 ~/.bashrc

1

alias runlike="docker run --rm -v /var/run/docker.sock:/var/run/docker.sock assaflavie/runlike"

然后就可以直接使用本地命令行:

1

runlike YOUR-CONTAINER

RESTFul简述

REST 是 “表现层状态转移（Representational state transfer）”的缩写。

它意味着我们不会将真的对象通过网络发送给另一方，而只会传输对象的表现层状态。而表现层状态通常是通过JSON、XML、HTML或者文本等其他格式传输的。

我们通过使用无状态协议和标准REST操作（比如GET, HEAD, POST, PUT, PATCH, DELETE, CONNECT, OPTIONS 和 TRACE）来创建高性能、可靠的微服务或API。

资源为核心

所有的REST原则和架构都以资源（Resource）为核心。通过一系列架构风格定义了创建API/服务/微服务的范例。
任何一个REST URI都应该遵循一套语义规则、准确定义资源位置，使得其他人可以通过网络访问该资源。
下面是一些最佳实践。

URL 结构 及 API URL 命名规范

URL 要有较高的可读性

好的URL具有统一性，能够让大家很容易发现和理解

下面是一个比较好的 URL 示例:

1

https://api.thecodebuzz.com/v1.0/orders/{order-id}

下面是一个不太友好的 URL 示例:

1

https://api.thecodebuzz.com/GetOrder/OMS/BDS/{order-id}

我们接下来详细分析一下URL的命名。

URL中应使用名词，避免使用CURD等动词

URL应该只包含名词而不应该使用向GetData、UpdateData这样的动词。

不建议采用的URL:

1
2
3

https://api.thecodebuzz.com/v1.0/GetOrders/{order-id}

https://api.thecodebuzz.com/v1.0/DeleteOrders/{order-id}

推荐的URL：

1
2
3

https://api.thecodebuzz.com/v1.0/orders/{order-id}

https://api.thecodebuzz.com/v1.0/orders/{order-id}

请注意上面的推荐的例子中，查询订单和删除订单的URL是一样的。这是因为这两个URL都操作了同一个资源，而查询和删除的操作是通过标准REST操作来区分的，如果我们使用curl程序来调用接口，那么查询、修改和删除操作的命令如下所示：

1
2
3
4
5

curl GET https://api.thecodebuzz.com/v1.0/orders/123

curl PUT https://api.thecodebuzz.com/v1.0/orders/123

curl DELETE https://api.thecodebuzz.com/v1.0/orders/123

使用名词复数

地址中推荐使用名词复数

示例：

1
2
3

https://api.thecodebuzz.com/v1.0/orders/{order-id}

https://api.thecodebuzz.com/v1.0/payments/{pay-id}

URL中使用短横线 (-)

与下划线等其他分隔符相比，短横线（-）更能提升可读性。如果遇到较长的名字，请使用短横。
示例：

1
2
3

https://api.thecodebuzz.com/v1.0/books-management/north-america/orders/{order-id}

https://api.thecodebuzz.com/v1.0/books-management/north-america/payments/{payment-id}

URL中不应使用下划线(_)

下划线可读性不佳，经常跟其他行混淆；

一些DNS不支持含有下划线的URL；

为了避免不必要的冲突，如果遇到较长的名字，请使用短横线。

不建议的URL：

1

https://api.thecodebuzz.com/v1.0/books_management/north_america/orders/{order-id}

推荐：

1

https://api.thecodebuzz.com/v1.0/books-management/north-america/orders/{order-id}

API URL 长度限制

As per RFC 7230,
按照RFC 7230的要求，

HTTP请求中不存在预先定义的长度上限。[…] 服务器收到超过预期长度上限的请求必须回复“414(URI Too Long)”状态码。

另一方面，现有部分服务确实无法处理超过2048个字符长度的URL。

URL长度超长通常伴随着含有较多参数的HTTP GET方法出现，需要引起注意。

更多示例

HTTP GET

1
2
3
4
5
6
7
8

//获取所有书籍
HTTP GET  http://api.thecodebuzz.com/books-agencies/agencies/books

//获取某一出版社的书籍
HTTP GET  http://api.thecodebuzz.com/books-agencies/agencies/{agency-id}/books

//获取某一出版社的特定书籍
HTTP GET  http://api.thecodebuzz.com/books-agencies/agencies/{agency-id}/books/{book-id}

HTTP POST

1
2

//新增一本书
http://api.thecodebuzz.com/books-agencies/agencies/books  

HTTP PUT

1
2

//更新所有出版社的某一本书
HTTP PUT http://api.thecodebuzz.com/books-agencies/agencies/books/{book-id} 

HTTP DELETE

1
2
3
4

//删除所有出版社的同一本书
HTTP DELETE http://api.thecodebuzz.com/books-agencies/agencies/books/{book-id}  
//删除指定出版社的指定书籍
HTTP DELETE http://api.thecodebuzz.com/books-agencies/agencies/{agency-id}/books/{book-id}  

上面示例中的命名都遵循了通用的规范，可以很容易的用来构建新的RESTFul服务。

总结

资源是REST理念、标准和架构的核心。基于REST的URI应该遵循相应的语义规则和标准来标识API中的资源。亲爱的读者如果有任何的问题，欢迎在下方留言。

1. 尝试安装npm install windows-build-tools。

这个没有走通，原因是可以联网的机器是一台Linux机器，扑街。

2. 尝试手动安装BuildTools和Python。

安装成功了，然后按照node-sass和node-gyp页面上的说明进行了尝试，编译失败，报错大致如下：

1
2

error MSB4019: The imported project "E:\Microsoft.Cpp.Default.props" was not found. Confirm that the path in the <Import> declaration is correct, and that the file exists on disk.
error MSB4019: 未找到导入的项目"E:\Microsoft.Cpp.Default.props"。请确认<Import>声明中的路径正确，且磁盘上存在该文件。

再次扑街。

正确姿势

3. 直接为安装脚本提供二进制文件

其实事情的缘起就是node-sass在安装时的一个脚本install.js在断网状态无法获取相应编译好的二进制。然后安装脚本就展开了通过源码进行编译的作死行为。

1
2
3
4
5
6
7

> node-sass@4.6.1 install /src/node_modules/node-sass
> node scripts/install.js

Downloading binary from https://github.com/sass/node-sass/releas…
Cannot download "https://github.com/sass/node-sass/releas…":

HTTP error 404 Not Found

经过查看相应的安装脚本scripts/install.js后，发现在lib/extensions.js中有这么一段注释：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

/**
 * Determine the URL to fetch binary file from.
 * By default fetch from the node-sass distribution
 * site on GitHub.
 *
 * The default URL can be overridden using
 * the environment variable SASS_BINARY_SITE,
 * .npmrc variable sass_binary_site or
 * or a command line option --sass-binary-site:
 *
 *   node scripts/install.js --sass-binary-site http://example.com/
 *
 * The URL should to the mirror of the repository
 * laid out as follows:
 *
 * SASS_BINARY_SITE/
 *
 *  v3.0.0
 *  v3.0.0/freebsd-x64-14_binding.node
 *  ....
 *  v3.0.0
 *  v3.0.0/freebsd-ia32-11_binding.node
 *  v3.0.0/freebsd-x64-42_binding.node
 *  ... etc. for all supported versions and platforms
 *
 * @api public
 */

function getBinaryUrl() {
........

原来可以通过设置环境变量覆盖默认的github下载路径，刚好手边就有现成的http服务器，将相应的xxx_binding.node文件扔上去，然后在要安装node-sass机器上设置SASS_BINARY_SITE环境变量就可以了。

注意：如果http文件服务器是 http://XXX.XXX.XX:8080/YYY，则设置 SASS_BINARY_SITE=http://XXX.XXX.XX:8080/YYY 。接下来需要在相应目录下创建版本号文件夹，然后将相应的XXX_binding.node放上去。完整的下载路径应该类似于 http://XXX.XXX.XX:8080/YYY/v4.14.1/win32-x64-83_binding.node。

之后正常安装npm install node-sass即可。总算搞定了。

除过设置SASS_BINARY_SITE环境变量，还可以指定二进制的存放位置，将文件直接放在那个路径中即可。我心累了，请大家自行查看https://github.com/sass/node-sass/blob/master/lib/extensions.js 文件。

Goproxy 中国完全实现了 Go 的模块代理协议。并且它是一个由中国备受信赖的云服务提供商七牛云支持的非营利性项目。目标是为中国和世界上其他地方的 Gopher 们提供一个免费的、可靠的、持续在线的且经过 CDN 加速的模块代理。

愉快地编码吧，Gopher 们！;-)

用法

macOS 或 Linux

打开你的终端并执行：

1

$ export GOPROXY=https://goproxy.cn

或者

1

$ echo "GOPROXY=https://goproxy.cn" >> ~/.profile && source ~/.profile

完成。

Windows

打开你的 PowerShell 并执行：

1

C:\> $env:GOPROXY = "https://goproxy.cn"

或者

1. 打开“开始”并搜索“env”

2. 选择“编辑系统环境变量”

3. 点击“环境变量…”按钮

4. 在“<你的用户名> 的用户变量”章节下（上半部分）

5. 点击“新建…”按钮

6. 选择“变量名”输入框并输入“GOPROXY”

7. 选择“变量值”输入框并输入“https://goproxy.cn”

8. 点击“确定”按钮

重启命令行或者PowerShell

请多指教！