十二月

十二月#

Jekyll Post To Sphinx Document#

#!/usr/bin/sh

cd _posts

for m in *.md; do
    # Delete jekyll meta data delimiter
    sed -i '1d;5d' $m
    sed -i 's/assets\/img/_images/g' $m
    # Markdown to restructedText
    m2r --overwrite --parse-relative-links $m
    r=${m%.md}.rst
    # Convert jekll meta data to ablog meta data and format fixes
    awk -i inplace -f ../conv-meta.awk $r
    # Remove date in filename
    mv $r ${r:11}
done

# Skip empty line
NR==1 {
    next
}

 # Convert document title
/title:/ {
    titlemark="========================================"
    print titlemark;
    $1="";
    print $0;
    print titlemark;
    next
}

# Remove unused page layout
/layout: post/ {
    next
}

# Convert tags and add ablog .. post:: directive
/tags:/ {
    tags=$2
    for (i=3; i<NF; i++) { tags=tags ", " $i }
    printf "\n.. post:: %s\n\
   :tags: %s\n\
   :author: LA\n\
   :language: zh\n\n",
    substr(FILENAME, 0, 10), tags
    next
}

# Convert GFM table of content
/\{:toc\}/ {
    print ".. contents::"
    next
}

# Incompatible
/:target:/ {
    next
}
/\{: width=/ {
    next
}
/:format: html/ {
    next
}

{
    print $0
}

Python 中的 {Class,Instance} Variable#

在修 sphinxnotes-lilypond 的 bug 的时候意外发现新创建的对象的某个值和之前的老对象一样，一度以为自己发现了 Python 3.9 的 UAF bug。

当然对 Python Newbie 来说哪有容易发现 bug，下面是犯错的 case：

class Foo(object):
    bar = []
    def __init__(self):
        self.bar.append('喜')

    x = Foo()
    print(x.bar)
    y = Foo()
    print(y.bar)

输出:

['喜']
['喜', '喜']

官方文档如是说：

Generally speaking, instance variables are for data unique to each instance and class variables are for attributes and methods shared by all instances of the class [1]

两种变了分别是 class 级别和 instance 级别，两者不同然而命名空间却一样，当把 classs variable 当 instance variable 用的时候（因为方便写 type annoation），对 classs variable 的修改就会影响所有其他的 instance（如果它没有覆盖该 variable）的话。

相关文章很多，看来是个常见坑点，怪我见识少 :(，如果还是想用 class variable，请小心谨慎，另把 bar.append('喜') 替换成 bar = bar + ['喜'] 即可 [2] 。

英语通常不使用书名号 `《》`#

英语没有用书名号的传统，通常用斜体来表示。当然书名号也非中国的发明，书名号的首次出现是在一本 1572 年由 Josse Bade 印刷的书中。[3]

尽管如此，在以中文为主的文档里……我还是决定继续用书名号给洋文书括上。

如果你有任何意见，请在此评论。如果你留下了电子邮箱，我可能会通过回复你。

十二月

目录

十二月#

Jekyll Post To Sphinx Document#

Python 中的 {Class,Instance} Variable#

英语通常不使用书名号 《》#

英语通常不使用书名号 `《》`#