Python(3) Cheatsheet

项目地址在这里： https://tldr.sh/ 官方版本似乎是基于 NodeJS 的，但我安装失败了然后改用了 Rust 版本的 tealdeer 。想尝试其它版本的可以在 https://github.com/tldr-pages/tldr/wiki/tldr-pages-clients 找到其它版本。

《星》：一些感想

2021-01-12 21:52 (更新 2020-12-27 21:52)

阿瑟•克拉克《星》

阿瑟•克拉克的《星》 1 说不定是很适合圣诞节读的一篇小说。（笑）但无论是在 Ent 豆瓣上翻译的评论区还是 Goodreads 的书评里，读来多是一阵火药味。我表达能力并不算好，但还是希望能传达一些《星》给我的思考和感动。

1: 这个翻译版本的《星》搬运自 Ent 的 Douban

注意

剧透警告

[翻譯] ChangeMyView 規則

2021-01-11 11:27

規則

1. 規則A - 不要解釋觀點

解釋您觀點背後的原因，而不要僅僅解釋觀點本身是什麼（需要 500 字以上）。

2. 規則B - 第三方/“惡魔代言”/演說

您個人必須持有相應的觀點，並展示出您願意改變這種觀點。您不能代表其它人來發表帖子，不能扮作“惡魔的代言人” 1 或者扮作任何其它不與您相同的實體，也不能“演說”。

1: 指的是爲了找出現有思維的毛病而專門反對現有多數人的看法的行爲。

3. 規則C - 不清晰的/不適宜的標題

發表的帖子的標題必須能夠適當地總結您的觀點，並且以 CMV: 開頭。具有誤導性、或是過於簡化、或是含有劇透的標題有可能會導致帖子被移除。

4. 規則D - 中立/對特定人的傷害/推廣/套娃

帖子不能表達一個中立的立場，或是提倡對特定人的傷害，或是自我推廣（？），或是對這個論壇本身的討論（請到 /r/ideasforcmv 來進行這樣的討論）。

5. 規則E - 3小時內沒有來自樓主的回覆

只有在你願意和回覆的人對話，並且有着3小時的空閒時間能夠持續這麼做時，才發表帖子。如果您在3小時內沒有回覆，您的帖子將會被移除。

6. 規則1 - 沒有質疑樓主的觀點（只針對第一級回覆）

System Message: WARNING/2 (<string>, line 33)

Title underline too short.

6. 規則1 - 沒有質疑樓主的觀點（只針對第一級回覆）
===============================

對於 CMV 帖子的直接回覆至少需要質疑樓主的觀點的一方面（無論這方面多麼小），除非樓主問了一個澄清性的問題。

7. 規則2 - 粗魯/敵意的評論

不要對其它用戶粗魯或展現敵意。就算剩餘部分十分有說服力，您的評論還是會被移除。“是TA們先開始的”不是藉口。您應該匯報（flag）先開始的評論不是回應這種評論。

8. 規則3 - 指控不講誠信

不要指控樓主或其它任何人不願改變觀點或是在不講誠信地辯論。如果您不確信某人說的，就詢問一些澄清性的問題（參見：蘇格拉底方法）。如果你認爲TA們還是在展現不恰當的行爲，請與我們聯繫。

9. 規則4 - 濫用/誤用DELTA或是應該頒發DELTA

如果您承認您的觀點有改變，請頒發DELTA。請不要將DELTA用作其它目的。在頒發DELTA時，您必須附上對您的改變的解釋，讓我們知道這種改變是真的。DELTA的濫用包括諷刺的DELTA、玩笑的DELTA、超級點讚的DELTA等等。

10. 規則5 - 不有意義的參與

評論必須有意義地參與到對話中。只包含鏈接、玩笑或是手動點讚的評論將會被移除。幽默或是贊同的肯定可以被包含在更實在的評論之中。

DELTA系統

無論您是不是樓主，請回覆對您的觀點有任何改變的用戶，並在您的評論裏包含一個 DELTA（操作請見下方），並且附上一段對改變的解釋。

輸入 DELTA 的方法
方法	針對
複製粘貼⇨ Δ	所有系統
Unicode⇨ &#8710	所有系統
Option/Alt+J	Mac
Ctrl+Shift+u2206	Linux
!delta	在您無法使用 Δ 時使用

DELTA系統（詳細版）

概覽

匯報

爲什麼是 DELTA？

System Message: WARNING/2 (<string>, line 83)

Title underline too short.

爲什麼是 DELTA？
==============

Delta機器人代碼

Pleroma 从入门到精通（误）

2021-01-03 11:11

现在暂时在这里放一个写作大纲:

所以这算是什么？
Pleroma 从安装到管理迁移
划掉
Linux 从入门到后端运维
划掉
计算机网络从入门到精通
划掉
操作系统原理
划掉
计算机文化基础及硬件组成
划掉
……
总结：
Pleroma 教程从大纲到放弃

因为实在是太多内容了，打算建一个 wiki 来分页面放：

现在维基页面搭在这里。（是的，我买了新域名啦！但是因为想把新域名用到更公共的内容上，所以还是把这个博客赖在 qoto.io 上。）

暂定是使用 DokuWiki，配合 Markdown 插件（方便编辑）、Git 插件（数据公开存档）、RSS 插件（可以做个长毛象更新 bot？）。大家也可以来写一写？（版权（CC-BY-SA 等等）得说好了。）

大纲

计算机是什么？
- CPU、内存、硬盘
- VPS 是什么？
网络是什么？
- 端口是什么？
- IP 是什么？域名又是什么？
- SSL/TLS 是什么？证书又是什么？
联邦宇宙、Mastodon、Pleroma 是什么？
Linux 简明教程：
1. 各个发行版？
2. 用户是怎么回事？
  1. 所谓的多用户系统，以及用户权限问题。
3. 命令行基本逻辑以及语法。
  - Shell
4. $EDITOR 已死，$EDITOR 万岁！（VIM 已死，Nano 万岁！）
5. 服务器是什么？Nginx 是什么？为什么服务器还能套服务器还能套服务器？
  - 所谓反向代理
  - Cloudflare 是怎么回事？
    - Cloudflare 的 TLS 设置 flexible 与 Let’s Encrypt
6. Swap 呀 swapfile
Pleroma 安装
1. 域名选购
  - 给个其它大佬的外链
2. 服务器选购
  1. 对服务器配置的要求
3. Docker 是什么？我要不要用 docker？
  - 因为本人不会（ can’t ）用 docker，所以教程使用手动安装
4. Cloudflare 是什么？
Pleroma 管理
1. 配置：存在文件上还是在数据库里？
2. 备用域名？基于 Cloudflare Workers 的代理

域名选购

我是在 porkbun.com 购买域名的，因为似乎便宜一些。可以参考 BGME 的域名选购的注意事项，引用 BGME 的总结::: 不要使用中国国内的域名注册商注册域名，也不要注册域名注册局位于中国的域名。

大概率在这里不更新了

大概会放到 wiki 上。

MOD tracker 游玩（？）

2021-01-01 18:31

最开始是因为 absturztaube 写的 pleroma 的 mod 了解到 MOD 以及 tracker 这种东西的。

Module file (MOD music, tracker music) is a family of music file formats originating from the MOD file format on Amiga systems used in the late 1980s. —Module file, Wikipedia

大致说来就是一种比较古来的音乐文件形式，而 tracker 是用来创作这样的音乐的。

似乎还挺有趣的样子，后来有空了就去下了个 tracker OpenMPT 来玩一玩。

Licenses 笔记以及主题实现

2021-01-01 09:10

反应过来主题应该还要加上个显示 license 的功能，但同时又不想把 license 仅仅局限于 Creative Commons 类的，所以稍微查了一下，在这里记录一下各种适用于文字作品的 license。

主要来源请见 Various Licenses and Comments about Them. 中文版：各类许可证及其评论.

许可证摘选

这里只摘录与 GPL / FDL 兼容的那些许可证吧。

自由文档许可证

这里的文档真的就指的是专门的文档，例如软件的使用手册、课本、字典等。可能可以应用到个人写作中，但是似乎还是直接用实用作品的许可证会好一些。

GNU Free Documentation License (FDL)
FreeBSD Documentation License (FreeBSDDL)

实用作品的许可证

GNU General Public License (GPLOther)
GNU Free Documentation License (FDLOther)
CC0
Creative Commons Attribution 4.0 license (a.k.a. CC BY) (ccby)

主题计划的 license

实现思路很简单： 1. conf.py 里需要设置一个默认的 license 选项； 2. 在 Metadata 里面有 license=XX 的就显示相应的许可证，没有就默认； 3. 有些许可证可以附加所有者自行指定的条款，这个就随便留个 license-mod=YY 的设置？

License 选项

首先应该有个 none 选项。

然后 CC 类的基本所有 license 都要能够兼容吧，但这里有个问题就是选项的文字怎么选。比如是 ccby 呢还是 cc-by 呢？可能其实我都要是最好的选项，然后又得去学 Python / Mako 的 swtich 语句了……

其次是上面列举的所有与 GPL / FDL 兼容的许可证，这个时候真的还是要纠结选项的文字。

License 显示

CC 类的证书都有图标，看起来观感会不错。但是其它的许可证似乎都没有？这大概只能随便显示一下了 :P

reStructuredText Intro

2020-12-31 10:07

我看着 reStructuredText 的文档绝望极了，真的比 markdown 复杂多了 T_T。我尝试着在这里做点笔记。

小心

推荐几个好得多的博文都来自于同一个博客：《从 Markdown 到 reStructuredText》： https://macplay.github.io/posts/cong-markdown-dao-restructuredtext/ 《从 Markdown 到 reStructuredText（二）》： https://macplay.github.io/posts/cong-markdown-dao-restructuredtexter/ 《从 Markdown 到 reStructuredText（三）》： https://macplay.github.io/posts/cong-markdown-dao-restructuredtextsan/ 写得比我详细得多得多得多，还讲到了 reStructuredText 的其它很多很厉害的功能（例如方便的 CSV 表格、Admonition 等等）

与 markdown 的比较

reStructuredText 对中文的体验极其不友好，
因为它很多结构（表格/标题）要求宽度对应，但是中文毕竟和英文跨度不同，
很多编辑器甚至处理器可能都有不同的处理方式……
不爽。
所以下面的表格用英文了。

相邻的两个块之间要用空行隔开。

/	Markdown	reStructuredText
Title	`# h1` `## h2` `### h3` etc.	========== h1 ========== or: h2 ---------- Must be wider than the text # * = - ^ ” could be used 1
Bold	`bold`	`bold`
Italic	`italic`	`italic`
Blockquote	> quote1 > quote2	not blockquote here indent and you get one another line nested another
Inline Code	`code`	``code``
Block Code	``` code ```	:: code
Footnote 2		`[1]_` and later the page: .. [1] footnote could be indented
Link 2	`[name](link)`	`link` or `name <link>`_
In-page links 2		`target_` or `target`_ where target could be titles, footnote, definitions, etc.
Lists	:: one two bullet and - * + could be used	same, same.
Images	`![alttext](link)`	.. image:: link :alt: alttext

1

Python 传统上的习惯是：

一级标题（书的一部/一集/part）:
```
########
  part
########
```
二级标题（书的一章/chapter）:
```
***********
  chapter
***********
```
三/四/五/六级标题（一节/一小节/一小小节/段落）:
```
 title
=======
```
三/四/五/六级分别使用：= / - / ^ / "

2

超链接由两部分构成，一个是显示的文字，一个是链接地址。 reStructuredText 里这个可以拆开，比如：Python_ 这样是定义了显示的文字，而对应的链接地址可以在另外的地方这样给出:

.. _Python: http://www.python.org/

另外，脚注也可以看作是这种格式的延伸。脚注有一些其它格式： [#name]_ 这样配合:

:: [#name] 自动编号的脚注

会生成自动编号的脚注。

其它

生成目录

使用：

.. contents:: 目录标题
    :depth: 2

表格

一个方便的编辑表格的方法是使用 CSV 表格：

.. csv-table::

    "第一行第一列","示范一个内嵌代码块：

    .. code:: python

        a = [1, 2, 3]
        print(""No Python"")"

显示出来就是这个样子：

第一行第一列

示范一个内嵌代码块：

a = [1, 2, 3]
print("No Python")

在 Nikola 的特殊用法

因为我用的是 Nikola 这个静态博客生成系统，而在博客相关的功能方面它提供了一些特殊语法。

TEASER_END

.. TEASER_END

博客对每个页面的预览默认是不会缩短页面内容的，所以在主页等页面看到的页面预览就是完整的页面。有时页面太长了，预览最好缩短一下，这个语法标志着预览的结束（预览从页面开头一路到这个标志）。

TeXmacs 笔记

2020-12-30 19:44

暂时是这个嘟文的存档，之后可能不时补充一下。

阿瑟•克拉克《星》

規則

1. 規則A - 不要解釋觀點

2. 規則B - 第三方/“惡魔代言”/演說

3. 規則C - 不清晰的/不適宜的標題

4. 規則D - 中立/對特定人的傷害/推廣/套娃

5. 規則E - 3小時內沒有來自樓主的回覆

6. 規則1 - 沒有質疑樓主的觀點（只針對第一級回覆）

7. 規則2 - 粗魯/敵意的評論

8. 規則3 - 指控不講誠信

9. 規則4 - 濫用/誤用DELTA或是應該頒發DELTA

10. 規則5 - 不有意義的參與

DELTA系統

DELTA系統（詳細版）

概覽

匯報

爲什麼是 DELTA？

Delta機器人 代碼

大纲

域名选购

大概率在这里不更新了

许可证摘选

自由文档许可证

实用作品的许可证

主题计划的 license

License 选项

License 显示

与 markdown 的比较

其它

生成目录

表格

在 Nikola 的特殊用法

TEASER_END

Delta機器人代碼