时隔多年, 重新拾一下blog, 因为修改了一些主题的文件, 不备份一下下次配置时又要重头开始了, 浪费时间.

当前版本用到的插件:

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

"hexo": "^6.3.0",
"hexo-deployer-git": "^3.0.0",
"hexo-generator-archive": "^2.0.0",
"hexo-generator-category": "^2.0.0",
"hexo-generator-feed": "^3.0.0",
"hexo-generator-index": "^3.0.0",
"hexo-generator-sitemap": "^3.0.1",
"hexo-generator-tag": "^2.0.0",
"hexo-helper-live2d": "^3.1.1",
"hexo-renderer-ejs": "^2.0.0",
"hexo-renderer-marked": "^6.0.0",
"hexo-renderer-stylus": "^2.1.0",
"hexo-server": "^3.0.0"

hexo config文件:

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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site
title: 学会忍受孤独
subtitle: 他人笑我太疯癫, 我笑他人看不穿
description:
author: lixxu
language: zh-CN
timezone: Asia/Shanghai

# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://lixxu.github.io
root: /
permalink: ":year/:month/:day/:title/"
permalink_defaults:
pretty_urls:
  trailing_index: false # Set to false to remove trailing 'index.html' from permalinks
  trailing_html: false # Set to false to remove trailing '.html' from permalinks

# Directory
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:
# Scroll percent label in b2t button
scrollpercent: true

# Writing
new_post_name: :year-:month-:day-:title.md
default_layout: post
titlecase: false # Transform title into titlecase
external_link:
  enable: true # Open external links in new tab
  field: site # Apply to the whole site
  exclude: ""

filename_case: 0
render_drafts: false
post_asset_folder: true
relative_link: false
future: true
highlight:
  enable: true
  line_number: true
  auto_detect: false
  tab_replace: ""
  wrap: true
  hljs: false
prismjs:
  enable: false
  preprocess: true
  line_number: true
  tab_replace: ""

# Home page setting
# path: Root path for your blogs index page. (default = '')
# per_page: Posts displayed per page. (0 = disable pagination)
# order_by: Posts order. (Order by date descending by default)
index_generator:
  path: ""
  per_page: 10
  order_by: -date

# Category & Tag
default_category: uncategorized
category_map:
tag_map:

# Metadata elements
## https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta
meta_generator: true
# Date / Time format
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## http://momentjs.com/docs/#/displaying/format/
date_format: YYYY-MM-DD
time_format: HH:mm:ss
## updated_option supports 'mtime', 'date', 'empty'
updated_option: "mtime"

# Pagination
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
# theme: landscape
theme: BlueLake
stylus:
  compress: true

# json local search
jsonContent:
  meta: false
  pages: false
  posts:
    title: true
    date: true
    path: true
    text: true
    raw: false
    content: false
    slug: false
    updated: false
    comments: false
    link: false
    permalink: false
    excerpt: false
    categories: false

tags: true
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: https://github.com/lixxu/lixxu.github.io
  branch: master

live2d:
  enable: true
  scriptFrom: local
  pluginRootPath: live2dw/
  pluginJsPath: lib/
  pluginModelPath: assets/
  tagMode: false
  log: false
  model:
    use: live2d-widget-model-wanko
  display:
    width: 300
    height: 600
    position: right
    hOffset: 0
    vOffset: -20
  mobile:
    show: true
    scale: 0.5
  react:
    opacityDefault: 0.7
    opacityOnHover: 0.2

主题配置文件:

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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178

##########################
## Site Config Settings ##
##########################

# Theme version
version: 3.0.0

# Theme tone
dark: true # true/false
favicon: /favicon.png
banner: "images/banner.jpg"
banner-dark: "images/banner-dark.jpg"

# Header
menu:
  - page: home
    directory: .
    icon: fa-home
  - page: archive
    directory: archives/
    icon: fa-archive
  - page: about
    directory: about/
    icon: fa-user
  - page: rss
    directory: atom.xml
    icon: fa-rss

# RSS & Sitemap plugins
Plugins: hexo-generator-feed
  hexo-generator-sitemap

# Sitemap
sitemap:
  path: sitemap.xml

# Content
excerpt_link: 阅读更多
excerpt:
  depth: 10
  excerpt_excludes: []
  more_excludes: []
  hideWholePostExcerpts: true

fancybox: true
copyright:
  enable: true # display article copyright information, true/false.
  content: "转载请注明出处."

# Date_formats
date_formats:
  post: "YYYY年MM月DD日"
  idStr: "YYYYMMDDHHmmss"

# Sidebar
sidebar: right # right/left/bottom
widgets:
  - recent_posts
  - tagcloud
  - category
  - archive
  - tag
  # - links

# Widget behavior
archive_type: "yearly" # 'yearly','monthly'
archive_format: "YYYY年" # 'YYYY年','YYYY年MM月'
show_count: true
recent_posts_limits: 5

# Toc
toc:
  enable: false
  list_number: false

# Article share
share:
  local_share: true
  baidu_share: false

# Miscellaneous
busuanzi: false ## If you want to use Busuanzi page views please set the value to true.
baidu_analytics:
google_analytics:
gauges_analytics:

# MathJax support
mathjax:
  enable: false # true/false.
  cdn: //cdn.bootcss.com/mathjax/2.7.1/latest.js?config=TeX-AMS-MML_HTMLorMML

# Reward
reward:
  enable: false # true/false 是否开启 打赏功能
  wechat: "/css/images/wechat-pay.jpg"
  alipay: "/css/images/alipay-pay.jpg"
  buttonTxt: "打赏"
  title: "“感谢你的支持，我会继续努力！”"
  content: "扫码打赏，感谢支持"

# About page
about:
  photo_url: https://avatars2.githubusercontent.com/u/264487?s=256&u=04c0bc38daccfed43fc513efe5ac8440891e6029&v=4 ## Your photo e.g. /themeauthor.jpg
  items:
    - label: email
      url: mailto:xuzenglin@gmail.com ## Your email with mailto: e.g.  mailto:chaoles@foxmail.com
      title: xuzenglin@gmail.com ## Your email e.g.  chaoles@foxmail.com
    - label: github
      url: https://github.com/lixxu ## Your github'url e.g.  https://github.com/chaooo
      title: lix ## Your github'name e.g.  chaooo
    # - label: weibo
    #   url: ## Your weibo's url e.g.  http://weibo.com/zhengchaooo
    #   title: ## Your weibo's name e.g.  秋过冬漫长

# Gitalk comment
gitalk:
  enable: true
  owner: lixxu ## Your GitHub ID, e.g. username
  repo: lixxu.github.io ## The repository to store your comments, make sure you're the repo's owner, e.g. gitalk.github.io
  client_id: ## GitHub client ID, e.g. 75752dafe7907a897619
  client_secret: ## GitHub client secret, e.g. ec2fb9054972c891289640354993b662f4cccc50
  admin: ## Github repo owner and collaborators, only these guys can initialize github issues.
  language: "zh-CN" ## Language
  pagerDirection: last # Comment sorting direction, available values are last and first.

# giteement评论（基于Gitee issues）【！！！慎用，Gitee接口调用时好像有次数限制，导致后面无法调试，若要使用请自行研究】
giteement:
  enable: false
  owner: #'chaoo'  # 你的码云账号英文名
  repo: #'blog-comments' # 存储评论的仓库的仓库名称(需要在码云仓库创建公开仓库)
  redirect_uri: #'https://chaoo.gitee.io'   # 应用回调地址(请和配置的第三方应用保持一致)
  client_id: #4ec96c34e83a4767d762a5a321ae15d9b8456d552c146afda829b815d51abfd2 ## GitHub client ID, e.g. 75752dafe7907a897619
  client_secret: #d2cf268817c7099b010f4ff7053f79dca3e32105da449318d8ae87f82782d531 ## GitHub client secret, e.g. ec2fb9054972c891289640354993b662f4cccc50

# Valine comment. https://valine.js.org
valine:
  enable: false # if you want use valine,please set this value is true
  appId: # leancloud application app id
  appKey: # leancloud application app key
  notify: false # valine mail notify (true/false) https://github.com/xCss/Valine/wiki
  verify: false # valine verify code (true/false)
  pageSize: 10 # comment list page size
  avatar: mm # gravatar style https://valine.js.org/#/avatar
  lang: zh-cn # i18n: zh-cn/en
  placeholder: Just go go # valine comment input placeholder(like: Please leave your footprints )
  guest_info: nick,mail,link #valine comment header info

# Changyan comment. 畅言
changyan:
  enable: false
  appid: ## changyan appid
  appkey: ## changyan appkey

# Other comments
comment:
  disqus: ## disqus_shortname
  livere: ## 来必力(data-uid)
  uyan: ## 友言(uid)
  cloudTie: ## 网易云跟帖(productKey)
  utterances:
    enable: true
    repo: lixxu/lixxu.github.io
    issue_term: pathname # pathname, url, title, og:title [ISSUE NUMBER] or [SPECIFIC TERM]
    theme: github-light


auto_excerpt:
  enable: true
  lines: 5

# Friend Links widget. Empty links will hide widget.
links:
  - title: site-name1
    url: http://www.example1.com/
  - title: site-name2
    url: http://www.example2.com/
  - title: site-name3
    url: http://www.example3.com/

自动添加 read more 修改的文件:

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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

<article id="<%= post.layout %>-<%= post.slug %>" class="h-entry article article-type-<%= post.layout %>" itemprop="blogPost" itemscope itemtype="https://schema.org/BlogPosting">
  <div class="article-inner">
    <%- partial('post/gallery') %>
    <% if (post.link || post.title){ %>
      <header class="article-header">
        <%- partial('post/title', {class_name: 'p-name article-title'}) %>
      </header>
    <% } %>
    <div class="article-meta">
      <% if (post.top){ %>
        <span class='article-top'>【<%- __('topped') %>】</span>
      <% } %>
      <%- partial('post/date', {class_name: 'article-date', date_format: theme.date_formats.post }) %>
      <%- partial('post/category') %>
      <% if (!index){ %>
        <%- partial('post/views-count') %>
      <% } %>
      <%- partial('post/comments-count') %>
    </div>
    <div class="e-content article-entry" itemprop="articleBody">
      <% var show_all_content = true %>
      <% if (index){ %>
        <% if (post.excerpt){ %>
          <% show_all_content = false %>
          <%- post.excerpt %>
        <% } else if (theme.auto_excerpt.enable && index) { %>
          <% var br_pos = 0 %>
          <% for (var br_count = 0; br_count < theme.auto_excerpt.lines; br_count++) { %>
            <% br_pos = post.content.indexOf('\n',br_pos + 1) %>
            <% if(br_pos < 0) { break } %>
          <% } %>
          <% if(br_pos > 0) { %>
            <% show_all_content = false %>
            <p><%- post.content.substring(0, br_pos + 1) %><p>
          <% } %>
        <% } %>
      <% } else { %>
        <%- post.content %>
        <% if (!index){ %>
            <div id="toc-article">
                <%- partial('post/toc') %>
            </div>
        <% } %>
        <% if (theme.copyright.enable){ %>
          <blockquote id="copyright">
              <p><%= __("copyright_link") %>: <a href="<%- url_for(config.url +'/'+ page.path) %>"><%- url_for(config.url +'/'+ page.path) %></a></p>
              <p><%= __("copyright_notice") %>: <%= theme.copyright.content %></p>
          </blockquote>
        <% } %>
      <% } %>
    </div>
    <footer class="article-footer">
      <% if (!show_all_content || (post.excerpt && index && theme.excerpt_link)){ %>
        <%- partial('post/tag') %>
        <p class="article-more-link">
          <a href="<%- url_for(post.path) %>#more"><%= theme.excerpt_link %></a>
        </p>
      <% } else { %>
        <div class="article-tag-wrap">
          <%- partial('post/reward') %>
          <%- partial('post/tag') %>
          <%- partial('post/share') %>
        </div>
      <% } %>
      <% if (!index){ %>
        <%- partial('post/nav') %>
      <% } %>
      <% if (!index){ %>
        <%- partial('post/comments') %>
      <% } %>
    </footer>
  </div>
</article>

about文件

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

<article id="<%= post.layout %>-<%= post.slug %>" class="h-entry article article-type-<%= post.layout %>" itemprop="blogPost" itemscope itemtype="https://schema.org/BlogPosting">
  <div class="article-inner">
    <%- partial('post/gallery') %>
    <% if (post.link || post.title){ %>
      <header class="article-header">
        <%- partial('post/title', {class_name: 'p-name article-title'}) %>
      </header>
    <% } %>
    <div class="e-content article-entry" itemprop="articleBody">
      <div class="author-page">
        <div class="photo"><img src="<%= theme.about.photo_url %>"></div>
        <div class="author">
          <div><i class="fa fa-user">name：</i><%= config.author %></div>
          <% theme.about.items.forEach(function(item, i){ %>
            <div>
              <i class="fa fa-<%= item.label %>"><%= item.label %>：</i>
              <a href="<%= item.url %>" target="_blank"><%= item.title %></a>
            </div>
          <% }) %>
        </div>
        <%- post.content %>
      </div>
      <% if (!index && post.comments){ %>
        <%- partial('post/comments') %>
      <% } %>
    </div>
  </div>
</article>

utterances评论修改的文件:

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

<% if (post.comments){ %>
<a href="<%- url_for(post.path) %>#comments" class="article-comment-link">
  <% if (!index){ %>
    <% if (theme.valine.enable && theme.valine.appId && theme.valine.appKey){ %>
      <span class="post-comments-count valine-comment-count" data-xid="<%- url_for(post.path) %>" itemprop="commentCount"></span>
    <% } %>
    <% if (theme.comment.disqus){ %>
      <i class="disqus-comment-count" data-disqus-identifier="<%- url_for(post.path) %>"></i>
    <% } %>
    <% if (theme.comment.utterances){ %>
      <a href="<%- url_for(post.path) %>" id="utterances_count_unit"></a>
    <% } %>
    <% if (theme.comment.uyan){ %>
      <a href="<%- url_for(post.path) %>" id="uyan_count_unit"></a>
    <% } %>
    <% if (theme.comment.cloudTie){ %>
      <i class="cloud-tie-join-count">
        <i class="join-count"></i>
      </i>
    <% } %>
    <% if (theme.changyan.enable && theme.changyan.appid && theme.changyan.appkey){ %>
      <i id="changyan_count_unit" data-xid="<%- url_for(post.path) %>"></i>
    <% } %>
  <% } %>
  <i class="fa fa-commt"></i>
  <%= __('guestbook') %>
</a>
<% } %>

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
34
35

<% if (theme.gitalk.enable && theme.gitalk.client_id && theme.gitalk.client_secret){ %>
  <div id="comments"></div>
<% } %>
<% if (theme.giteement.enable && theme.giteement.client_id && theme.giteement.client_secret){ %>
  <div id="comments"></div>
<% } %>
<% if (theme.valine.enable && theme.valine.appId && theme.valine.appKey){ %>
  <section id="comments" class="vcomment"></section>
<% } %>
<% if (theme.comment.disqus){ %>
  <div id="comments"><div id="disqus_thread"></div></div>
<% } %>
<% if (theme.comment.livere){ %>
  <div id="comments"><div id="lv-container" data-uid="<%= theme.comment.livere %>" data-id="city"></div></div>
<% } %>
<% if (theme.comment.uyan){ %>
  <div id="comments"><div id="uyan_frame"></div></div>
<% } %>
<% if (theme.comment.cloudTie){ %>
  <div id="comments"><div id="cloud-tie-wrapper" class="cloud-tie-wrapper"></div></div>
<% } %>
<% if (theme.changyan.enable && theme.changyan.appid && theme.changyan.appkey){ %>
  <div id="comments"><div id="SOHUCS" sid="<%= page.path %>"></div></div>
<% } %>
<% if (theme.comment.utterances.enable && theme.comment.utterances.repo && theme.comment.utterances.issue_term){ %>
  <div id="comments" class="comments">
    <script src="https://utteranc.es/client.js"
        repo="<%= theme.comment.utterances.repo %>"
        issue-term="<%= theme.comment.utterances.issue_term %>"
        theme="<%= theme.comment.utterances.theme %>"
        crossorigin="anonymous"
        async>
    </script>
  </div>
<% } %>

自定义评论主题css

1
2
3
4

.utterances
  max-width: none

先就这样吧.

今天在 蟒周刊 里看到使用了 utterances 作为评论系统, 网上查了一下, 原来是基于 github 的. 于是我也跟风配置了一下, 就不用 disqus 了, 毕竟只能用梯子才能访问.

由于我用的是 BlueLake, 里面的模板用的是 Jade, 根本不熟悉 (好像新版用 pug 代替 Jade 了). 在 SO看到传递参数的语法是 #{variable_name}.

最后, 总算搞定了.

1. 在文件 themes\BlueLake\layout\_partial\comments.jade 的最后添加

   1 2 3 4

   if theme.comment.utterances.enable #comments.comments script(type="text/javascript",src="https://utteranc.es/client.js",charset="utf-8",repo="#{theme.comment.utterances.repo}",issue-term="#{theme.comment.utterances.issue_term}",theme="#{theme.comment.utterances.theme}",crossorigin="anonymous",async=true)

2. 打开主题评论的配置选项:

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

   comment: duoshuo: #chaooo ## duoshuo_shortname disqus: ## disqus_shortname livere: ## 来必力(data-uid) uyan: ## 友言(uid) cloudTie: ## 网易云跟帖(productKey) utterances: enable: true repo: owner/repo issue_term: pathname # pathname, url, title, og:title [ISSUE NUMBER] or [SPECIFIC TERM] theme: github-light changyan: ## 畅言需在下方配置两个参数，此处不填。 appid: ## 畅言(appid) appkey: ##畅言(appkey)

看着比较烦人, 网上有解决方案 https://github.com/pypa/pip/pull/6147#issuecomment-457910432.

具体做法是:
新建一个 PYTHONWARNINGS 的环境变量, 值设为 ignore:DEPRECATION::pip._internal.cli.base_command, Windows 下两边没有双引号, 其他平台可能需要.

重新启动命令行, 再跑一下, 应该就没有了.

1. jquery 3.3.1
2. chosen 1.8.7
3. bootstrap 3.4.1

在使用 chosen 时, 在给选择框加错误提示时, 边框的颜色没有变:

研究了一下, 最后参考 SO 上的答案, 在自定义的 CSS 文件里加入以下几行:

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

.chosen-container-single .chosen-single {
  height: 38px;
  line-height: 38px;
}
.chosen-container-single .chosen-single div b {
  background: url(chosen-sprite.png) no-repeat 0 8px;
}
.chosen-container-single .chosen-search input[type=text] {
  min-height: 36px;
}

div.form-group.has-error div div a.chosen-single {
  border-color: #b94a48;
}

最后的显示算是正常了:

注意: 这个方法在 bootstrap4 上无效.

换到新 https://sm.ms/ 了, 只能传图片, 暂时先这样吧, 后续有时间再折腾其他.

文章来自于: https://stackoverflow.com/questions/5343068/is-there-a-way-to-skip-password-typing-when-using-https-on-github

You can also have Git store your credentials permanently using the following:

git config credential.helper store

Note: While this is convenient, Git will store your credentials in clear text in a local file (.git-credentials) under your project directory (see below for the “home“ directory). If you don’t like this, delete this file and switch to using the cache option.

If you want Git to resume to asking you for credentials every time it needs to connect to the remote repository, you can run this command:

git config --unset credential.helper
To store the passwords in .git-credentials in your %HOME% directory as opposed to the project directory: use the --global flag

git config --global credential.helper store

Windows 平台下可以使用 https://github.com/Microsoft/Git-Credential-Manager-for-Windows, 在第一次需要输入密码时会弹窗, 输入后下次就不用输入了.

2015-04-15
2015-04-16
2015-04-22
2015-04-29
2015-04-30
2015-06-01
2015-06-08
2015-08-31
2015-10-05
2017-03-29
2017-06-04
2018-10-01
end

有的时候我们对一个表不会加唯一性限制, 而是在插入数据时进行检查. 但有的时候程序里的 bug 导致还是有重复的记录被插入到数据库中了, 这时候如何快速地删除重复行呢?

显然, 用程序来删除会比较耗时, 尤其是记录比较多的时候.
以下的方法只适用于 PostgreSQL, 因为不是标准的 SQL 语法.

1
2
3

DELETE FROM table USING table alias
  WHERE table.field1 = alias.field1 AND table.field2 = alias.field2 AND
    table.max_field < alias.max_field

比如, 有一个用户表, email 字段本该是唯一的, 需要删除重复的 email 记录.

1
2

DELETE FROM user_accounts USING user_accounts ua2
WHERE user_accounts.email = ua2.email AND user_accounts.id < ua2.id;

Quake-III 代码里神奇的浮点开方函数

Quake-III Arena (雷神之锤3) 是90年代的经典游戏之一. 该系列的游戏不但画面和内容不错, 而且即使计算机配置低, 也能极其流畅地运行. 这要归功于它3D引擎的开发者约翰-卡马克(John Carmack).

事实上早在90年代初DOS时代, 只要能在PC上搞个小动画都能让人惊叹一番的时候, John Carmack 就推出了石破天惊的Castle Wolfstein, 然后再接再励, doom, doomII, Quake…每次都把 3-D 技术推到极致. 他的3D引擎代码极度高效, 几乎是在压榨PC机的每条运算指令. 当初MS的 Direct3D 也得听取他的意见, 修改了不少API.

最近, QUAKE的开发商 ID SOFTWARE 遵守GPL协议, 公开了QUAKE-III的原代码, 让世人有幸目睹Carmack传奇的3D引擎的原码. 这是QUAKE-III原代码的下载地址:
http://www.fileshack.com/file.x?fid=7547

(下面是官方的下载网址, 搜索 quake3-1.32b-source.zip 可以找到一大堆中文网页的
ftp://ftp.idsoftware.com/idstuff/source/quake3-1.32b-source.zip)

我们知道, 越底层的函数, 调用越频繁. 3D引擎归根到底还是数学运算. 那么找到最底层的数学运算函数 (在 game/code/q_math.c), 必然是精心编写的. 里面有很多有趣的函数, 很多都令人惊奇, 估计我们几年时间都学不完.

在 game/code/q_math.c 里发现了这样一段代码. 它的作用是将一个数开平方并取倒, 经测试这段代码比 (float)(1.0/sqrt(x)) 快4倍:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

float Q_rsqrt( float number )
{
    long i;
    float x2, y;
    const float threehalfs = 1.5F;

    x2 = number * 0.5F;
    y   = number;
    i   = * ( long * ) &y;   // evil floating point bit level hacking
    i   = 0x5f3759df - ( i >> 1 ); // what the fuck?
    y   = * ( float * ) &i;
    y   = y * ( threehalfs - ( x2 * y * y ) ); // 1st iteration
    // y   = y * ( threehalfs - ( x2 * y * y ) ); // 2nd iteration, this can be removed

    #ifndef Q3_VM
    #ifdef __linux__
     assert( !isnan(y) ); // bk010122 - FPE?
    #endif
    #endif
    return y;
}

函数返回 1/sqrt(x), 这个函数在图像处理中比 sqrt(x) 更有用. 注意到这个函数只用了一次叠代! (其实就是根本没用叠代, 直接运算). 编译, 实验, 这个函数不仅工作的很好, 而且比标准的 sqrt() 函数快4倍! 要知道, 编译器自带的函数, 可是经过严格仔细的汇编优化的啊!

这个简洁的函数, 最核心, 也是最让人费解的, 就是标注了 what the fuck? 的一句
i = 0x5f3759df - ( i >> 1 ); 再加上 y = y * ( threehalfs - ( x2 * y * y ) ); 两句话就完成了开方运算! 而且注意到, 核心那句是定点移位运算, 速度极快! 特别在很多没有乘法指令的RISC结构CPU上, 这样做是极其高效的.

算法的原理其实不复杂, 就是牛顿迭代法, 用 x-f(x)/f'(x) 来不断的逼近 f(x)=a的根.

简单来说比如求平方根, f(x)=x^2=a, f'(x)= 2*x, f(x)/f'(x)=x/2, 把f(x)代入
x-f(x)/f'(x) 后有 (x+a/x)/2, 现在我们选 a=5, 选一个猜测值比如2, 那么我们可以这么算 5/2 = 2.5; (2.5+2)/2 = 2.25; 5/2.25 = xxx; (2.25+xxx)/2 = xxxx ... 这样反复迭代下去, 结果必定收敛于 sqrt(5).

没错, 一般的求平方根都是这么算的. 但是卡马克(quake3作者)真正牛B的地方是他选择了一个神秘的常数 0x5f3759df 来计算那个猜测值. 就是我们加注释的那一行, 那一行算出的值非常接近 1/sqrt(n),这样我们只需要2次牛顿迭代就可以达到我们所需要的精度.

好吧, 如果这个还不算NB, 接着看:

普渡大学的数学家Chris Lomont看了以后觉得有趣, 决定要研究一下卡马克弄出来的
这个猜测值有什么奥秘. Lomont也是个牛人, 在精心研究之后从理论上也推导出一个
最佳猜测值, 和卡马克的数字非常接近, 0x5f37642f. 卡马克真牛, 他是外星人吗？

传奇并没有在这里结束. Lomont计算出结果以后非常满意, 于是拿自己计算出的起始
值和卡马克的神秘数字做比赛, 看看谁的数字能够更快更精确的求得平方根. 结果是
卡马克赢了… 谁也不知道卡马克是怎么找到这个数字的.

最后 Lomont怒了, 采用暴力方法一个数字一个数字试过来, 终于找到一个比卡马克数
字要好上那么一丁点的数字, 虽然实际上这两个数字所产生的结果非常近似, 这个暴
力得出的数字是 0x5f375a86.

Lomont为此写下一篇论文, "Fast Inverse Square Root".

论文下载地址:

http://www.math.purdue.edu/~clomont/Math/Papers/2003/InvSqrt.pdf
http://www.matrix67.com/data/InvSqrt.pdf

参考: <IEEE Standard 754 for Binary Floating-Point Arithmetic><FAST INVERSE SQUARE ROOT>

最后, 给出最精简的 1/sqrt() 函数:

1
2
3
4
5
6
7
8
9

float InvSqrt(float x)
{
    float xhalf = 0.5f*x;
    int i = *(int*)&x; // get bits for floating VALUE
    i = 0x5f375a86- (i>>1); // gives initial guess y0
    x = *(float*)&i; // convert bits BACK to float
    x = x*(1.5f-xhalf*x*x); // Newton step, repeating increases accuracy
    return x;
}

大家可以尝试在PC机、51、AVR、430、ARM、上面编译并实验, 惊讶一下它的工作效率.

前兩天有一則新聞, 大意是說 Ryszard Sommefeldt 很久以前看到這麼樣的一段 code (可能出自 Quake III 的 source code):

1
2
3
4
5
6
7
8
9

float InvSqrt (float x) {
    float xhalf = 0.5f*x;
    int i = *(int*)&x;
    i = 0x5f3759df - (i>>1);
    x = *(float*)&i;
    x = x*(1.5f - xhalf*x*x);
    return x;

}

他一看之下驚為天人, 想要拜見這位前輩高人, 但是一路追尋下去卻一直找不到人; 同時間也有其他人在找, 雖然也沒找到出處, 但是 Chris Lomont 寫了一篇論文 (in PDF) 解析這段 code 的演算法 (用的是 Newton’s Method, 牛頓法; 比較重要的是後半段講到怎麼找出神奇的 0x5f3759df 的).

PS. 這個 function 之所以重要, 是因為求 開根號倒數 這個動作在 3D 運算 (向量運算的部份) 裡面常常會用到, 如果你用最原始的 sqrt() 然後再倒數的話, 速度比上面的這個版本大概慢了四倍吧… XD

PS2. 在他們追尋的過程中, 有人提到一份叫做 MIT HACKMEM 的文件, 這是 1970 年代的 MIT 強者們做的一些筆記 (hack memo), 大部份是 algorithm, 有些 code 是 PDP-10 asm 寫的, 另外有少數是 C code (有人整理了一份列表).

附: 牛顿迭代法快速寻找平方根

下面这种方法可以很有效地求出根号a的近似值: 首先随便猜一个近似值x, 然后不断令x等于 x 和 a/x 的平均数, 迭代个六七次后 x 的值就已经相当精确了. 例如, 我想求根号 2 等于多少. 假如我猜测的结果为4, 虽然错的离谱, 但你可以看到使用牛顿迭代法后这个值很快就趋近于根号2了:

1
2
3
4
5

(       4   + 2/   4     ) / 2 = 2.25
(     2.25   + 2/   2.25   ) / 2 = 1.56944..
( 1.56944..+ 2/1.56944..) / 2 = 1.42189..
( 1.42189..+ 2/1.42189..) / 2 = 1.41423..
....

这种算法的原理很简单, 我们仅仅是不断用 (x, f(x)) 的切线来逼近方程 x^2-a=0的根. 根号a实际上就是 x^2-a=0的一个正实根, 这个函数的导数是2x. 也就是说, 函数上任一点 (x,f(x))处的切线斜率是2x. 那么, x-f(x)/(2x) 就是一个比 x 更接近的近似值. 代入 f(x)=x^2-a 得到 x-(x^2-a)/(2x), 也就是 (x+a/x)/2.

原因:

1
2
3
4
5
6
7
8
9
10

Traceback (most recent call last):
  File "main.py", line 10, in <module>
  File "zipextimporter.pyo", line 82, in load_module
  File "utils.pyo", line 10, in <module>
  File "zipextimporter.pyo", line 82, in load_module
  File "psutil\__init__.pyo", line 138, in <module>
  File "zipextimporter.pyo", line 82, in load_module
  File "psutil\_pswindows.pyo", line 16, in <module>
  File "zipextimporter.pyo", line 98, in load_module
ImportError: MemoryLoadLibrary failed loading _psutil_windows.pyd

解决办法:

1. http://stackoverflow.com/questions/20930173/how-to-include-components-of-psutil-in-py2exe-that-py2exe-cant-find

dll_excludes 至少添加这几项: "IPHLPAPI.DLL", "NSI.dll", "WINNSI.DLL", "WTSAPI32.dll"

2. http://sourceforge.net/p/py2exe/bugs/130/

options 里的 bundle_files 改成 3, 不过打包出来的文件会有很多个.

1. 下载 marrow.mailer 压缩包, 解压, 用上面的大法安装

1

python setup.py install_lib

2. 同上, 依次安装 marrow.util, marrow.interface, futures

3. 程序里类似这样的

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

#!/usr/bin/env python
#-*- coding: utf-8 -*-

from __future__ import unicode_literals

from marrow.mailer.manager import futures
from marrow.mailer.transport import smtp
from marrow.mailer import Mailer, Message

host = 'localhost'
mailer = Mailer({'manager.use': futures.FuturesManager,
                 'transport.use': smtp.SMTPTransport,
                 'transport.host': host,
                 })
mailer.start()
author = (('Sender', 'no-reply@example.com'))
msg = Message(author=author)
msg.subject = 'Subject'
msg.to = ['aaa@example.com']
msg.plain = 'plain mail'
msg.rich = 'rich html'

mailer.send(msg)
mailer.stop()

备注:

由于 marrow.mailer 的 bug: https://github.com/marrow/marrow.mailer/issues/36 , 导致 manager.use, transport.use 要写成上面的格式, 看了源码才发现.当然这种写法在不需要打包时是不需要的:

1
2
3
4
5
6
7
8
9
10
11

# ...
if not isinstance(Manager, IManager):
    raise TypeError("Chosen manager does not conform to the manager API.")

# ...
if not isinstance(Transport, ITransport):
    raise TypeError("Chosen transport does not conform to the transport API.")

# ...

越来越觉得 SourceTree 启动慢, 我都尽量在命令行下使用 git 了 (这样才是正道吧).
每次的推送都要输入用户名和密码, 用了 _netrc 大法也不管用, 隐约记得之前可以的, 是人品越来越好了吗?

总感觉不甘心, 就翻看 http://stackoverflow.com/questions/6031214/git-how-to-use-netrc-file-on-windows-to-save-user-and-password, 看到 git-credential-winstore 这里, 就进去看看, 下载安装, 很小巧的东西, 才十几K.

接着再推送时, 弹出对话框, 输入用户名和密码, 就可以了. 看这个窗口的架势, 是在系统的密码管理里面, 进去一看, 果不其然, 在通用安全里, 静静地躺着刚刚保存的密码.
没有安装 git-credential-winstore (https://gitcredentialstore.codeplex.com/) 的同学可以手动添加试试, 此法仅限于 http 方式的验证, 不适合 ssh 模式.

顺便换上了 度娘 的CDN, 还用上了雅黑字体:

1
2

<script src="http://libs.baidu.com/jquery/1.9.1/jquery.min.js"></script>

还有 渣浪 和 小斗士 的:

1
2
3
4

<script src="http://lib.sinaapp.com/js/jquery/1.9.1/jquery-1.9.1.min.js"></script>

<script src="http://libs.useso.com/js/jquery/1.9.1/jquery.min.js"></script>

接着就手动复制粘贴, 贴了几篇感觉太枯燥, 就琢磨着如何使用 requests 和 BeautifulSoup 来提取文本.

很少使用 BeautifulSoup, 所以临时去看了一下文档, 开始走起.

1. 先用浏览器的 审查元素 获取分页的页面结构, 这里我们只需要 标题 和 链接地址 即可

2. 分析页面内容抓取 标题 和 链接地址, 还一并抓取当前的章节, 否则就没法知道顺序了

3. 根据获取的链接抓取全文

4. 分析全文, 在 entry 下面的 p 和 span 里, 一开始我以为都在 p 结构里, 结果最后发现有的章节是空的, 看了下空的章节的结构, 原来用的是 <div><span>...</span></div> 的结构

   

5. 这些都确定了后就可以开工了, 当然我是逐步确定的. 我的流程是: 按章节写到单独的文件里, 最后再合并. 好了, Talk is cheap, show me the code.:

   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 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63

   #!/usr/bin/env python #-*- coding: utf-8 -*- import os import os.path import requests from bs4 import BeautifulSoup import re digit_re = re.compile('(\d+-?\d*)') url = r'http://blog.jobbole.com/tag/%E7%A0%81%E5%86%9C%E6%95%85%E4%BA%8B/page/{}/' if not os.path.exists('coder_story'): os.makedirs('coder_story') os.chdir('coder_story') for page in (1, 2, 3): r = requests.get(url.format(page)) # soup = BeautifulSoup(r.content) # lxml未安装时用这行 soup = BeautifulSoup(r.content, 'lxml') for meta_title in soup.find_all('a', class_='meta-title'): # 我们要的都必须有title if 'title' not in meta_title.attrs: continue # 不是这个小说不要 if u'老码农原创小说' not in meta_title['title']: continue print(meta_title) # 打印一下标题 href = meta_title.get('href') # 获取文章链接 # 获取章节序号 found = digit_re.findall(meta_title['title']) if not found: continue # 个位数章节前补0, 为了后面的合并 page_no = found[0] if int(page_no.split('-')[0]) < 10: page_no = '0' + page_no # 获取文章的内容 r2 = requests.get(href) # s2 = BeautifulSoup(r2.content) # lxml未安装时用这行 s2 = BeautifulSoup(r2.content, 'lxml') entry = s2.find('div', class_='entry') with open('{}.txt'.format(page_no), 'w') as f: # 内容在 <p>...</p> 或 <div><span>...</span></div>里 for p in entry.find_all(['p', 'span']): # copyright-meta部分, 跳过 if p.get('class'): continue # 空白行, 文件里写两行空白, 便于阅读 text = p.get_text() if not text: f.write('\r\n\r\n') continue f.write(text.encode('utf-8') + '\r\n') # "待续" 的地方, 接着就是另一章了, 插入空行 if text.endswith(u'<\u5f85\u7eed>'): f.write('\r\n')

6. 合并到一个文件, 用 Python 碰到编码错误, 时间紧, 就用批处理好了, 还简单

   1	copy *.txt 码农故事.txt

7. 打完收工.

后记:

就在合并时, 看到最后的一句话, 马上吐出一升老血:

不过, 在 kindle 上还是 txt 的效果好一些, pdf 转换的有些乱码, 不完美.

附下载地址:

1. 码农故事.txt
2. 码农故事.pdf

上一篇介绍使用了 net time 来同步系统时间, 后来突然想到如果没有服务器可供同步时间或电脑无法直接连接到服务器怎么办?

就去找了下使用 Python 设置时间的例子, 还真有: http://stackoverflow.com/questions/12081310/python-module-to-change-system-date-and-time

直接贴在这里:

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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

import sys
import datetime

time_tuple = (2012, # Year
                 9, # Month
                 6, # Day
                 0, # Hour
                38, # Minute
                 0, # Second
                 0, # Millisecond
              )

def _win_set_time(time_tuple):
    import pywin32
    # http://timgolden.me.uk/pywin32-docs/win32api__SetSystemTime_meth.html
    # pywin32.SetSystemTime(year, month, dayOfWeek, day, hour, minute, second, millseconds)
    dayOfWeek = datetime.datetime(time_tuple).isocalendar()[2]
    pywin32.SetSystemTime(time_tuple[:2] + (dayOfWeek,) + time_tuple[2:])


def _linux_set_time(time_tuple):
    import ctypes
    import ctypes.util
    import time

    # /usr/include/linux/time.h:
    #
    # define CLOCK_REALTIME                     0
    CLOCK_REALTIME = 0

    # /usr/include/time.h
    #
    # struct timespec
    #  {
    #    __time_t tv_sec;            /* Seconds.  */
    #    long int tv_nsec;           /* Nanoseconds.  */
    #  };
    class timespec(ctypes.Structure):
        _fields_ = [("tv_sec", ctypes.c_long),
                    ("tv_nsec", ctypes.c_long)]

    librt = ctypes.CDLL(ctypes.util.find_library("rt"))

    ts = timespec()
    ts.tv_sec = int(time.mktime(datetime.datetime(*time_tuple[:6]).timetuple()))
    ts.tv_nsec = time_tuple[6] * 1000000 # Millisecond to nanosecond

    # http://linux.die.net/man/3/clock_settime
    librt.clock_settime(CLOCK_REALTIME, ctypes.byref(ts))


if sys.platform=='linux2':
    _linux_set_time(time_tuple)

elif  sys.platform=='win32':
    _win_set_time(time_tuple)

可是没有可供同步用的服务器, 那时间怎么来呢?

1. 跑一个 web, 可以返回一个 json 的数据, 如:

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

   #!/usr/bin/env python #-*- coding: utf-8 -*- from __future__ import unicode_literals from datetime import datetime from flask import Flask, jsonify app = Flask(__name__) @app.route('/api/get-time/') def get_time(): return jsonify(time=tuple(datetime.utcnow().timetuple())) if __name__ == '__main__': app.run(debug=True, host='0.0.0.0')

   客户端可以这样来获取和同步时间 (假设是 Windows 平台), 上面的 set_time.py 需要改一下:

   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 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55

   import sys import datetime def _win_set_time(time_tuple): '''time_tuple: year, month, day, hour, minute, second, day_of_week, day_of_year, is_dist ''' import pywin32 # http://timgolden.me.uk/pywin32-docs/win32api__SetSystemTime_meth.html # pywin32.SetSystemTime(year, month, dayOfWeek, day, hour, minute, second, millseconds) tt = list(time_tuple) tt.insert(2, tt[6]) # add day_of_week tt.insert(7, 0) # set miliseconds pywin32.SetSystemTime(*tt[:8]) def _linux_set_time(time_tuple): import ctypes import ctypes.util import time # /usr/include/linux/time.h: # # define CLOCK_REALTIME 0 CLOCK_REALTIME = 0 # /usr/include/time.h # # struct timespec # { # __time_t tv_sec; /* Seconds. */ # long int tv_nsec; /* Nanoseconds. */ # }; class timespec(ctypes.Structure): _fields_ = [("tv_sec", ctypes.c_long), ("tv_nsec", ctypes.c_long)] librt = ctypes.CDLL(ctypes.util.find_library("rt")) ts = timespec() ts.tv_sec = int(time.mktime(datetime.datetime(*time_tuple[:6]).timetuple())) ts.tv_nsec = time_tuple[6] * 1000000 # Millisecond to nanosecond # http://linux.die.net/man/3/clock_settime librt.clock_settime(CLOCK_REALTIME, ctypes.byref(ts)) def set_time(time_tuple): if sys.platform=='linux2': _linux_set_time(time_tuple) elif sys.platform=='win32': _win_set_time(time_tuple)

   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

   #!/usr/bin/env python #-*- coding: utf-8 -*- from __future__ import unicode_literals import time from datetime import datetime, timedelta import requests import set_time2 URL = 'http://a.b.c.d:5000/api/get-time/' offset = time.timezone if (time.localtime().tm_isdst == 0) else time.altzone LOCAL_TZ = offset / 60 / 60 * -1 def get_time(): r = requests.get(URL) json = r.json() return json['time'] def sync_time(tz, ts): ts = get_time() to_time = datetime(*ts[:6]) + timedelta(hours=LOCAL_TZ) set_time2.set_time(to_time.timetuple()) if __name__ == '__main__': sync_time()

   注意: 以上代码未经测试, 可能有错误.

2. 如果无法直接连接到提供时间的服务器呢?
   比如有两个网络, 一个是测试电脑的内部网, 服务器在测试的通用网络.

   可以使用一个可以连通两个网络的电脑上作为交换数据的中间人, 具体的是使用文件交换还是像 socket 之类的网络接口服务交换就随你的喜好了.

拙见.

1
2
3
4
5
6

sync_time:
net time \\a.b.c.d /set /y

sleep 3600
goto sync_time

但在使用的过程中出现了这个 service 吃掉许多 CPU 的问题.
按道理说在 sleep 后应该会进入休眠状态, 不应该再占用 CPU.
不清楚什么原因, 就使用 Python 重写了.

1. 主程序 main.py

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
34
35
36
37
38
39
40
41
42

#!/usr/bin/env python
#-*- coding: utf-8 -*-

from __future__ import unicode_literals
import subprocess
import time
import click

__version__ = '0.1'
DEFAULT_SERVERS = 'server_a,server_b'
IP_MAPS = dict(server_a='a.b.c.d', server_b='a.b.c.e')
CMD = r'net time \\{} /set /y'


def run_cmd(server):
    status = subprocess.call(CMD.format(server))
    if status == 0:
        return True

    ip = IP_MAPS.get(server)
    if ip:
        return subprocess.call(CMD.format(ip), shell=True) == 0

    return False


@click.command()
@click.option('--servers', default=DEFAULT_SERVERS,
              help='servers name or IP list, seperated by ","')
@click.option('--sleep', default=600,
              help='sleep seconds till next run, default is 600s (10 minutes)')
def sync_time(servers, sleep):
    while 1:
        for server in servers.split(','):
            if run_cmd(server.strip()):
                break

        time.sleep(sleep)

if __name__ == '__main__':
    sync_time()

2. 使用 py2exe 或其他工具打包 main.py 为可执行文件, 比如 SyncTimer.exe

3. 然后是安装/删除 service 的批处理:

3.1 install.bat

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

@echo off
set service=SyncTimer
echo %PROCESSOR_ARCHITECTURE% | find /i "x86" > nul
if %errorlevel%==0 (
    set nssm=nssm32.exe
) else (
    set nssm=nssm64.exe
)

%nssm% install "%service%" "%~dp0SyncTimer.exe"

net start %service%

sleep 5

3.2 remove.bat

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

@echo off
set exename=SyncTimer
net stop %exename%

echo %PROCESSOR_ARCHITECTURE% | find /i "x86" > nul
if %errorlevel%==0 (
    set nssm=nssm32.exe
) else (
    set nssm=nssm64.exe
)

%nssm% remove "%exename%" confirm
sleep 5

当然了, 你需要到 http://nssm.cc/download 下载 nssm 的执行程序.
分别把 32 位和 64 位的执行文件和你的 EXE 文件放到一起, 并改名为 nssm32.exe 和 nssm64.exe. 在安装 service 后也不能删除这些文件, 因为 service 关联的程序是 nssm.

这里有个注意的地方:
nssm 的文档上说使用命令行安装时如果不想弹出确认对话框, 可以写成这样的:

1

%nssm% install "%service%" "%~dp0SyncTimer.exe" confirm

但是这样安装的 service 始终处于 paused 状态, 一度让我以为是程序里 sleep 导致的. 但在使用对话框安装时却一点问题都没有.
后来看了下系统日志, 发现是路径的问题. 后面就使用 exe 的绝对路径并且把后面的 confirm 给去掉了才算正常.

本来打算写如何使用 Python 设置系统时间的怎么变成 nssm 了?

用了之后出现问题了: python manage.py runserver 使用的是默认的 wsgi 服务器, 而我在 windows 下一直使用 gevent 调试的.
看了下文档, 差不多就是这样:

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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

#!/usr/bin/env python
#-*- coding: utf-8 -*-

from __future__ import unicode_literals
import os
import os.path

from app import create_app, db
from app.models import User
from flask.ext.script import Manager, Shell
from flask.ext.migrate import Migrate, MigrateCommand

if os.path.isfile('app.env'):
    # print('importing environment from app.env...')
    with open('app.env') as f:
        for line in f:
            if not line.lstrip().startswith('#') and '=' in line:
                items = line.strip().split('=', 1)
                os.environ[str(items[0].strip())] = str(items[1].strip())

app = create_app(os.getenv('APP_ENV') or 'default')
manager = Manager(app)
migrate = Migrate(app, db)


def make_shell_context():
    return dict(app=app, db=db, User=User)

manager.add_command('shell', Shell(make_context=make_shell_context))
manager.add_command('db', MigrateCommand)


@manager.command
def deploy():
    from flask.ext.migrate import upgrade

    upgrade()


@manager.command
def rungevent():
    import werkzeug.serving
    from werkzeug.debug import DebuggedApplication
    from gevent.wsgi import WSGIServer

    @werkzeug.serving.run_with_reloader
    def run():
        app.debug = True
        dapp = DebuggedApplication(app, evalex=True)
        ws = WSGIServer(('', 5000), dapp)
        ws.serve_forever()

    run()

if __name__ == '__main__':
    manager.run()

然后使用下面的命令就可以了:

1

python manage.py rungevent

可是在 rungevent 里, 无论怎么传参数控制是否处在 debug 状态, 始终是 autoreload, 这可能是 app.env 里我设定了开发模式导致的.

不过, 算了, 生产环境我是用 uwsgi 的, 用不到这个玩意.

距上次发布软件包过去了很久, 都忘了操作步骤了, 今天碰巧发布一个小包, 放狗搜了一下, 记下来备忘:

来源: http://peterdowns.com/posts/first-time-with-pypi.html

基本操作:

1. 准备好 setup.py, 提供一下 setup.cfg

1
2

[metadata]
description-file = README.md

2. 注册:

1

python setup.py register -r pypi

按提示做选择就可以了:

3. 上传, 一串字符滚过之后看到 200 就 OK 了

1

python setup.py upload -r pypi