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 蛰思园

Windows Terminal添加配置Profiles


需求

Windows Terminal的界面非常棒,相较于原先使用的MobaXterm来说,既免费,UI美观,虽然不能完全替代MobaXterm的功能,但日常使用足以。

添加配置文件的方法

生成guid

打开PowerShell,输入new-guid命令即可

添加配置文件

在list单元下,添加

{

"guid": "{57b0d165-dd14-4194-bc87-454cf5551ffd}",

"hidden": false,

"name": "SSH",

"commandline": "ssh richard@192.168.0.1",

},

这种方式是直接登录远程ssh server,并且输入密码的方式。

用密钥远程登录

在Ubuntu服务器生成密钥

ssh-keygen

将公钥添加到认证文件

cat id_rsa.pub >> authorized_keys

通过sftp下载id_rsa私钥文件

在属性中禁用继承

然后添加,选择主体,输入本机用户,确定即可。否则会提示id_rsa文件权限too open。

将如下命令添加到配置文件中

ssh -i D:\\id_rsa richard@192.168.0.1

                "guid": "{c0a2a471-5b4e-419b-8d7b-bd8b9acb2bea}",

                "hidden": false,

                "name": "SSH",

                "commandline": "ssh -i D:\\id_rsa richard@192.168.0.1",

测试

连接成功。

大功告成!

问题

由于配置文件时json格式,所以ssh命令后面的id_rsa目录应如下

ssh -i E:/Onedrive/id_rsa richard@192.168.0.1

而不是

ssh -i E:\Onedrive\id_rsa richard@192.168.0.1

同时目录不能有中文。

 

Windows Terminal添加配置Profiles was originally published on 蛰思园

20210215 部署RSS server


以前一直使用Feedly和Innoreader,但却都有问题。

Feedly需要付费,虽然操作很流程,但是只能订阅100多个源,并不是太方便,而且在我的Poke2上未对墨水屏优化。另一个缺点时需要科学上网。

Innoreader很不错,但在Poke2上无法通过摇晃变更api地址,也就无法直接连接了。如果不修改api地址,则需要使用科学上网。

这两天趁春节,测试了Tiny RSS、Fresh RSS和Nextcloud News,最终选择了Nextcloud News。

Tiny RSS自从2021年后,停止了自定义部署,只能使用docker,而我的云平台时免费的AWS单核1G的服务器,升级到Ubuntu20.04后,docker版的tinyrss直接把CPU占满,完全不能使用。

FreshRSS,界面非常简单,有时候提取的文章不完全,反而提取了不需要的正文。

Nextcloud News,界面友好,Android端需要付费2.99USD,果断入手。

20210215 部署RSS server was originally published on 蛰思园

自制V2ray订阅源,实现多设备同步


需求:

多台设备需要科学上网,以前对每个设备都添加了6个订阅源,每次每台设备都需要更新测试,是在麻烦。

现在想在一台电脑T7500上定期测试别人发布的源地址的速度和有效性,然后自制订阅源,让其他设备更新即可

参考:

自制V2ray订阅源,实现多设备同步

步骤:

  1. 将测试锅的源导出至剪贴板
  1. 进入网站将其转换成Base64格式

Base64转换

  1. 将其存到Onedrive的某个文件中,比如v2ray.list中保存
  2. 将v2ray.list分享,复制链接。
  1. 打开网站,将链接转换为永久直链,此地址去掉最后的”.mp3″,即为订阅源地址。

直链转换

使用:

将订阅源地址添加到其他设备的v2ray的订阅设置中即可。

问题:

手机端的v2ray每次更新后,不会删除原来保存的那些服务器,必须手动删除,而PC端的可以更新。

其他

无。

自制V2ray订阅源,实现多设备同步 was originally published on DormanthinkZ.C

用FreeFileSync实现数据库异地备份


参考:

https://www.ioperat.com/news/operation/30.html

配置备份策略,生成脚本

比较策略:文件时间和大小

比 较 
一 亠 文 件 时 和 大 小 
新 过 打 开 保 存 存 为 一 
同 步 设 凿 
0 [ 最 茜 话 ] 
比 〔 F6 ) 过 痣 器 〔 F7 ) 同 步 〔 F8 ) 
0 数 据 库 备 份 
据 爸 分 
文 件 时 间 和 大 小 
以 比 鲛 彦 改 孬 《 仁 大 小 宗 识 相 文 
文 件 内 容 
囗 包 多 占 符 号 讠 S ) : 
忽 略 时 河 恽 商 分 ] 
0 直 〔 D ) 
例 如 : 1 , 2 , 4 : 30

过滤策略:

C:\Users\vAdmini: 
帮 助 〔 H 〕 
比 较 
一 一 文 件 时 和 大 小 
新 建 打 开 保 存 存 为 · 
同 步 设 凿 
0 [ 最 茜 话 ] 
比 〔 F6 ) 过 痣 器 〔 F7 ) 同 步 〔 F8 ) 
雲 分 
0 
数 库 爸 分 
\ 巨 动 份 
\WyglD8XSC*bak 
\System Volume Information\

同步策略+历史版本,相当于增量备份。

# 〔 F 〕 〔 剖 二 (T) 鼕 新 〔 H 〕 
新 过 打 开 保 存 存 为 · 
0 [ 最 茜 话 ] 
雲 哐 分 
数 库 爸 f 分 
文 件 要 
0 比 〔 F6 ) 
吏 新 > 
自 定 义 
0 叵 收 站 〔 R ) 
永 久 〔 刁 
比 较 
二 亠 、 文 件 时 和 大 小 
同 步 设 凿 
过 痣 器 〔 F7 ) 步 〔 F8 ) 
囗 裣 被 移 的 文 仁 更 昼 信 巨 
移 文 仁 到 一 个 用 F 定 义 的 文 仁 荚 
/ 烁 凵 虻r@1g2. 16 & 1 . 15g / 卜 。 me 烁 凵 虻 r / 历 史 0 “ 54 = NjLJ2M v 浏 览 
0 名 规 则 : 时 河 致 苡 仁 ] v 
丘 x 天 : 动 最 小 : 大 
巨 二 日 [ 《 二 引 《 二 日 
@ 历 史 颛 本 〔 切 
、 艾 , # 奕 、 艾 , 生 d 曼 曼 曼 引 轟 一 DD h 的 、 s.d 
顶 目 
大 小 
囗 发 送 
*FreeFileSync%Ekä 
《 ] 囗 盖 默 讠 丿 上 志 路 径 0 · 
C:\Users\Administrator\AppData\Roaming\FreeFileSync\Logs

将当前策略另存为批处理作业

配置计划任务

设置一个每天的备份计划,于凌晨3点。

新 视 国 数 据 库 备 份 届 性 ( 本 地 计 算 机 ) 
规 崆 发 器 犀 作 景 # 设 岩 历 史 记 录 〔 已 禁 ) 
创 建 任 时 , 可 以 指 定 发 泫 任 的 景 # 。 
在 每 天 的 0 : 30 一 崆 发 茜 在 05 : [ ℃ : 0 〔 》 期 河 每 隔 1 小 时 短 一 
已 启 用

操作为

Files\FreeFil 
c\FreeFileSync.exe• 
tc h

如此即可。

在CentOS里面配置计划删除10天前的备份文件

建立一个xsc.sh文件,删除10天前备份目录里面的文件

#!/bin/sh

find /home/ftpuser/xsc备份 -mtime +10 -name “*.*” -exec rm -rf {} \;

赋予执行权限

chmod +x xsc.sh

将sh文件加入到/etc/crontab中

  0  1  *  *  * root /root/xscdelete.sh

Done

用FreeFileSync实现数据库异地备份 was originally published on DormanthinkZ.C