Windows安装Sphinx+Github+Readthedocs创建开源电子书


Gitbook在国内无法使用,只能采用其他的平台写电子书了。

本文介绍了如何使用Sphinx创建电子书,用VS Code编辑文档,实时查看文件的网页效果,将电子书托管到Github上,并在Readthedocs平台发布。

安装各类必要工具

安装Git

https://git-scm.com/download/win

安装完成后,用Windows Terminal测试

git --version

安装python

https://www.python.org/downloads/

安装完成后,测试

python -V

pip3 --version

安装sphinx

pip3 install sphinx doc8 sphinx-autobuild

创建文档

安装Github Desktop

登录账号,创建一个项目TestBook,选择合适的License,publish到Github网站上(KX上网),选择公开项目,不需要private。

Current repository 
TestBook 
Changes 
O changed files 
Current branch 
mam 
History 
Publish repository 
Publish this repositoryto GitHub 
No local changes 
There are no uncommitted changes in this repository. Here are some friendly 
suggestions for what to do next. 
Publish ymar repository to GitHub 
This repository is currently only available on your local machine. By 
publishing it on GitHub you can share it, and collaborate with others. 
Always available in the toolbar for local repositories or Ctrl P 
blish reposito 
Open the repository in pur external editor 
Select your editor in Options 
Repository menu or Ctrl Shift A 
View the files of your repository in Explorer 
Repository menu or Ctrl Shift F 
Open in Visual Studio Code 
Show in Explorer

在本地TeskBook目录中初始化

进入TestBook目录,右键“在此打开Terminal”,键入

sphinx-quickstart

填写必要的项目信息后,即初始化成功。

其中第一个选项,可以选择yes,使目录保持各自独立,有source和build两个文件夹。

编辑文档

安装VS Code,及其插件reStructuredText。

打开TestBook目录,在source目录中新建一个文件夹和文件,编辑。

EXPLORER 
> OPEN EDITORS 
v SMARTPARK 
> .vscode 
> build 
> _build 
> _static 
) _templates 
2021 
conf.py 
index.rst 
.gitattributes 
make. bat 
M Makefile

然后编辑index.rst,将新文件加入到目录中

9 
le 
111 
12 
14 
15 
16 
17 
19 
21 
toctree: : 
:maxdepth: 2 
:caption: 188: 
2021/ 
Indices and tables 
* 
* 
* 
: ref: genindex• 
modindex• 
: ref: 
: ref: search

回到Terminal中,生成html文件查看

make html

在build/html目录中直接打开网页文件,查看效果。

实施预览

也可以在VS Code中实时预览正在编辑的rst文件,点击预览的按钮。

index.rst M X 
source) Z- index.rst ) 
1 
2 
3 
4 
5 
61 
7 
8 
9 
10 
Ill 
12 
13 
14 
15 
16 
17 
18 
19 
21 
documentation master file, crea ed b} 
sphinx-quickstart on Mon Jul 5 2021 
You can adapt this file completely to yo r lil 
contain the root 'toctree' directive. 
Preview index.rst x 
Indices and tables 
toctree: : 
: maxdepth : 
: caption : 
2021/ 
2 
Indices 
* : ref: 
* : ref: 
* : ref: 
and tables 
genindex 
modindex 
search

托管到Readthedocs平台

使用Github Desktop commit和push到Github网站上,也可以用命令行。

https://readthedocs.org/ 网站用github注册账号,可以看到刚建的TestBook项目。

在网站上构建电子书后,即可查看电子书了。

latest 
main 
maun 
Build version
https://smartpark.readthedocs.io/en/main/ 
Navigation 
Contents: 
Quick search 
Welcome to IN X 's 
documentation! 
Contents: 
Indices and tables 
• Index 
• Module Index 
• Search Page

大功告成!

Windows安装Sphinx+Github+Readthedocs创建开源电子书 was originally published on 蛰思园

绕过TPM2.0和UFEI升级Windows11


现状:

2011年购置的戴尔T7500工作站,主板无UFEI启动和TPM模块,升级Windows11。

Windows 
Windows 11 
jLlX Windows Windows 10 
Windows.

参考:

准备:

1.Windows10安装文件:

cn_windows_10_consumer_editions_version_21h1_x64_dvd_1baf479d

2.Windows11安装文件:

21996.1.210529-1541.co_release_CLIENT_CONSUMER_x64FRE_en-us

3.序列号和激活工具。

升级:

分别解压缩Windows10和Window11的安装文件,将Windows11/sources/install.wim复制到Windows10/sources/install.wim覆盖,然后运行Windows10/setup.exe即可开始安装。

解释:

Install.wim为安装的系统文件,其他的是引导,利用Windows10的引导来安装Windows11的文件,绕过UFEI和TPM2.0.

测试:

目前以利用Hyper-V的虚拟机测试通过。

问题:

目前实体机升级,无法保存个人设置和已安装的应用,因为原先的Windows10是中文版,而现在的Windows11暂时还是英文版。。。只能等到Windows11推出中文版的时候升级了。

绕过TPM2.0和UFEI升级Windows11 was originally published on 蛰思园

20210627 建党100年


周四资本公司举办了表彰大会和文艺汇演,我负责后台和背景视频。前段时间排练的时候,他们的耳麦一直都说有问题,但我坚信这并不是设备的问题,而是配戴方式的问题。

但是领导们,或者年龄大的人,在遇到问题的时候,习惯性的会认为是设备不好,要买最好的设备,却不会去考虑操作和使用问题,这也许是因为当年的生产设备操作比较简单,这种惯性思维,可以看作是一种落后的思维习惯。

毕竟现在的任何设备都是包含软件的,操作比以前要复杂很多。同样的东西放在不同的人手上,可能发挥出来的效果千差万别。同样用的Windows系统,有的人卡,有的人顺,也是这个原因了。。

正式演出那天,即25号周四,我提前跟诗朗诵的6个人逐一检查设备的配戴情况。所幸最后情况都还很好。

在我看来,这就像一个轮回,有些年,我们重视细节,过些年,我们又重视抽系性的会局,认为细节不重要。那么我们正处于的时期是抽象到细节了吗?

20210627 建党100年 was originally published on 蛰思园

20210627 随便写点


写文字,真的是一种不错的整理思维的方法。但使用WordPress以来一直有一种割裂感。

第一种情况,使用拼音打字的时候,大脑中所想的思考,按照习惯是手直接变成文字,但在电脑上的话,得增加多个步骤,将其转换为拼音,然后还要思考键盘中字母的位置,打出来后,还需要选择第几个字或单词。自此大脑刚才所思考的问题彼打断了。每一个词或句子却会重复这个打断的过程,直到不会产生思想的火花而终弃写作。

但这个过程,利用英语写作就不会存在,因为脑海中蹦出的就是单词和字母。

第二种情况,使用手写输入。

1.半屏手写输入框太小,只能连续写入2个字。

2.使用全屏手写,左手拿着手机要一直对抗右手写字的力量,非常累。

3.手写出来的字比以前在书本上写的字要大很多,无形中消耗更大。

4.全屏手写,选字较慢和标点符号识别不准。

尽管全屏手写有这么多的缺点,但其依然比拼音好,因为其不会打断思维。

我想这说不定,在一定程度上造就了很多垃圾文章,而也是短视频崛起的一个内因,即思维的连贯性。

这也会成为机器人的一个优势,至少是短期内的。思维的优劣不是以快慢决定的,而是联想和决策。

20210627 随便写点 was originally published on 蛰思园