一个命令行微博客(ipelago), 可订阅 RSS，可自定义模板发布静态网站

[SuperMild]

iPelago: CLI personal microblog (命令行个人微博客)

纯命令行操作，包括两方面功能：

1. 写微博客并生成静态网站 (HTML 和 RSS)
2. 订阅别人的 RSS

ipelago 之名

ipelago 源于群岛的英文 archipelago, 如果我们每一个人是一座孤岛，那么当我们搭建自己的微博客，大家的微博客聚在一起就可以形成群岛。

主要功能 (写微博客、订阅 RSS)

写自己的微博客

• 多种方式方便写博文（包括命令行输入、获取剪贴板内容、获取文件内容、通过简陋的 GUI 窗口输入）。
• 可生成静态网站 (包括 HTML 和 RSS), 这些静态文件可通过 GitHub Pages 或类似的免费服务搭建你的私人微博客供别人浏览、订阅。
• 生成 HTML 的模板、样式可以自定义（自带一个只有 62 行的简单模板）。
• 可区分公开消息与隐私消息，只有公开消息才会对外发布，隐私消息只能本地浏览。
• 有简单的 #标签 功能与搜索功能。

订阅别人的微博客

• 可通过 RSS 订阅别人的微博客。
• 只支持微博客（一条消息只有一两句话），不支持正常博客（长文章），因此数据库体积不会暴涨，长期使用也能一直保持很小的体积。
• 有限订阅（意思是不保存全部订阅消息，看到特别喜欢的内容可执行收藏命令，收藏的消息才会永久保存）。有限订阅可避免储存大量无用信息，避免数据库体积暴涨，减少信息焦虑。
• 可设置 proxy, 方便与翻墙软件搭配使用。

减少烦躁和焦虑

一般通过 App 或网页浏览消息时，会一目十行，快速上下滑动消息列表，这种操作有可能使烦躁和焦虑感变得更严重。

ipelago 也可一次列举多条消息，但更提倡使用逐条浏览功能，每次只显示一条消息，并且可以记住位置，随时离开去做别的事情，回头继续从上次中断的地方接着阅读。

因此，有助于减少烦躁与焦虑。

安装与初始化

安装非常简单，只要 pip install ipelago 即可。

安装后，第一次正式使用前，必须执行 'ago init name' 进行初始化，其中 name 是你的微博客名称，对外发布时别人可以看到。

常用命令示例

帮助

• ago -h (查看帮助消息)
• ago post -h (每个子命令也有详细的帮助消息)

初始化

• ago init 别有洞天 (初始化，设定微博客名称为“别有洞天”)

写博文

• ago post Hello World! (写一条公开消息, 可通过 HTML 及 RSS 对外发布)
• ago post -pri My password is abcd (写一条隐私消息, 仅本地可见)
• ago post -g (弹出一个简陋的 GUI 窗口方便输入)

Timeline (阅读自己微博客)

• ago tl (阅读下一条消息, 完全等同于 ago tl -next)
• ago tl -first (阅读最新一条消息)
• ago tl -next (阅读下一条消息)
• ago tl -today (阅读今天的消息)
• ago tl -yesterday (阅读昨天的消息)

订阅 RSS

• ago news -follow https://douchi.space/@mtfront.rss (订阅长毛象)
• ago news -follow https://v2ex.com/feed/create.xml -p HasTitle (订阅 V 站的“分享创造”节点)
• ago news -follow https://geeknote.net/Rei/feed.atom -p HasSummary (订阅 geeknote)
• ago news -l (查看已订阅的 RSS 列表)

默认每个源每 24 小时只能更新一次，可使用 '-force' 参数强制更新，但为了尊重源站节约资源及减少焦虑，建议不要频繁更新。

• ago news (阅读下一条消息, 完全等同 ago news --next)
• ago news -first (阅读最新一条消息)
• ago news -next (阅读下一条消息)
• ago like [id] (收藏指定 id 的消息)

发布微博客

使用 'ago publish' 命令可生成 HTML 文件及 RSS 文件，通过 GitHub Pages 或类似的免费服务即可创建你的个人微博客网站。

第一次发布时，需要填写微博客名称、作者名称等信息。

• ago publish -info (显示微博客信息)
• ago publish -g (打开 GUI 窗口填写微博客信息)
• ago publish (默认输出静态文件到当前目录的 'public' 文件夹，默认每页 50 条消息)
• ago publish -out /path/to/dir -n 25 (输出静态文件到指定文件夹, 每页显示 25 条消息)
• ago publish --templates ./templates (使用自定义模板)

源码

常用命令如上所示，更详细的说明以及源码请看 https://github.com/ahui2016/pypelago

我的微博客

我用这个程序生成的微博客，采用自带的极简模板（我实在不擅长前端，但懂前端的人可自定义模板）: https://blog.ai42.xyz/i/

[Tink]

还不错，支持一下

[SuperMild]

@Tink 感谢！

[SuperMild]

我又忘了提醒要 py301, 因为使用了 Python 3.10 的新特性，比如 type union operator, pattern matching 等，因此，如果你的系统中未安装 Python 3.10, 推荐使用 [pyenv]( https://github.com/pyenv/pyenv) 或 [miniconda]( https://docs.conda.io/en/latest/miniconda.html) 来安装最新版本的 Python 。

例如，安装 miniconda 后，可以这样创建 3.10 环境：

```sh
$ conda create --name py310 python=3.10
$ conda activate py310
```

另外，源码里还使用了 https://github.com/rustedpy/result 即类似于 Rust 的 Result, 我感觉很好用！推荐大家看看这个库。

[peterchen26]

cool

[xinyana]

挺有意思的