From 27cf0dc958d8ddc2086c8f09879d0dc6f84c1dd7 Mon Sep 17 00:00:00 2001 From: BigCoke233 Date: Sat, 20 Dec 2025 12:18:17 +0800 Subject: docs: update markdown files (2025-12-20 12:18:17) Former-commit-id: 0c845069cf706f7695dc262153b83096e03ff316 --- content/_drafts/60.md | 75 +++++++++++++++++++++- ...226\271\346\241\210\346\214\207\345\215\227.md" | 2 +- 2 files changed, 74 insertions(+), 3 deletions(-) diff --git a/content/_drafts/60.md b/content/_drafts/60.md index f2bfb207..a6688dc8 100644 --- a/content/_drafts/60.md +++ b/content/_drafts/60.md @@ -29,11 +29,32 @@ toc: true 我也不喜欢菜单里硬塞图标的设计（还有在 PPT 里塞语义模糊、与上下文无关的图标），我认为这种设计本质上是缺少思考的体现，没有考虑设计是否必要，只是想要把空间占满——有些空白就应该留着。 -### +### 开发者应该如何命名工具？ -[你可能好奇却又不知道的 HRV - 少数派](https://sspai.com/post/104402) +> [!note] 📜 +> [Programmers and software developers lost the plot on naming their tools](https://larr.net/p/namings.html) + +作者观察到了一种现象：如今的软件开发者非常喜欢用动物、虚构角色和一些意义不明的名词来命名自己的软件，像 Cobra、Viper 和 Melody，使得整个软件生态变得像是动物园，最大的问题是，这让那些排查依赖问题的开发者很头疼，看着长长的依赖树却根本不知道每个依赖是用来做什么的。作者指出，其他科学领域里不会把这种命名方式视作专业行为——如果一个化学家把一个分子命名为 Steve，仅仅因为 Steve 这个名字很好笑，而且会让他的论文更接地气，这无异于社会性自杀。 + +作者指出，以前的软件名称都有表意作用，比如早期的编程语言名字： + +- FORTRAN（Formula Translation） +- COBOL（Common Business-Oriented Language） +- Lisp（List Processing） + +还有早期的 Emacs 编辑器里的一些名字，dired 是 Directory Editor（目录编辑器）、eshell 是 Emacs Shell；一些命令也是如此，比如 grep 是 Global Regular Expression Print（全局正则表达式打印），sed 是 Stream Editor（流编辑器），cat 是 Concatenate（串联）。 + +作者认为这种命名方式造成认知债务（cognitive tax），使开发者不得不花更多的时间来理解工具的名字。他认为软件开发者应该使用复合词，根据用途来命名软件，至于宣传和接地气的部分，完全可以单独做一个吉祥物，比如 PostgreSQL 的吉祥物是一只名叫 Slonik 的大象——不要把软件的名字当成吉祥物。 + +--- +我其实不能完全认同作者的观点。实话实说，在读这篇文章之前，我完全不知道 grep 的全名是「全局正则表达式打印」而 Emacs 里的 dired 是目录编辑器——这几个东西我都用过，`grep` 还是我最常用的命令之一，然而，它们的名字对我而言，和 Cobra、Viper 之类的没有太多区别。作者可能忽略了，许多人（尤其是非英语母语者）并不在乎一个工具的全名是什么，只要把用途和名字匹配起来就好了——所有程序员都会写 SQL，但除了学校里的老师可能会在 PPT 上写「SQL 的全名是 Structured Query Language，结构化查询语言」之外，还有多少人在乎呢？像 MySQL 和 PostgreSQL 这样的数据库管理系统，明明不是一种 DSL 或者 SQL 的变体，却还是使用了 SQL 的名字，这个词已经变成广义上的关系型数据库的代称了。 +更别提 FORTRAN、COBOL 和 Lisp 了，如果不是真心对这几门语言感兴趣的黑客，谁能一眼看出来他们表示什么意思？作者所提到的认知债务，在这些「具有描述性」的名字中**依然存在**。此外，我也不太能明白为什么作者认为 Go 语言是一个有点蠢的名字，难道必须起一个像 `http-request-validator` 一样的名字，才能算好吗？那同类软件之间要如何做出区分呢？ + +不过，我也要承认，随便拿一个几乎毫无关联的名词做软件的名字，的确不太妥当，但我认为不妥当的点在于自我意识过剩和对作品以及用户不负责，而不是「名称不具有描述性」这个理由。比如，一个开发者很喜欢宝可梦，便把自己开发的一个系统清理工具命名为 Squirtle（杰尼龟），就不太妥当了，因为名称与工具之间几乎没有任何关联，或者说脑回路过于奇特，其他人难以建立起关联。但是，如果把一个用于将网盘挂载（mount）到文件系统中的软件命名为 Pokémount，我认为这不失为在个性和描述性之间的一种平衡。 + +作者在文章提到了一个名为 `libsodium` 的加密库，说自己看到这个名字的时候必须从「解决问题模式」切换到「一探究竟模式」，才能搞清楚这个库为什么叫这个名字——加密往往涉及到「加盐」，而名字中的 Sodium（钠）明显代指「盐」，这个名字实际上还是具有描述性的。我想说的是，开发者完全可以更专注，在解决问题的时候收一收自己的好奇心，就像我在用 `grep` 查看 HTTP 返回信息的时候，只会专注找我想要的内容，而不是纠结 `grep` 里的 g 到底是什么意思。 ## ⁂ · 星群 @@ -64,3 +85,53 @@ Tauri 使用 Rust 语言，而 Wails 使用 Go 语言，两者在前端技术上 ## ↯ · 当下 +### 我加入了 Fediverse + +Fediverse（联邦宇宙）是去中心化的社交网络，所有使用相同协议的实例能够相互通信，使得用户可以在一个服务器上查看整个 Fediverse 中架设于其他服务器上的社交媒体实例上的内容。最常用的协议是 ActivityPub，支持这个协议的软件有 Mastodon 和 Misskey 等微博（Microblogging）平台，像 Ghost 这样的内容管理平台也有支持 ActivityPub 的，也属于联邦宇宙的一部分。 + +相比 Twitter（我不愿意使用 X 这个名字）和 Instagram 这类由某个科技公司提供的社交媒体，Fediverse 更自由，用户可以选择在自己信任的服务器上注册账号（或者自己架设服务器），只需要电子邮箱就能注册，只要在任何一个支持 ActivityPub 协议的服务器上拥有账号，就能在整个 Fediverse 上和其他人交流，而且，在这里没有人想要给你推荐广告、收集和售卖你的数据。 + +我刚开始探索 Fediverse，所以选择了在一个公共实例上注册，未来兴许会自建实例。[@eltrac@c7.io](https://c7.io/@eltrac) 是我的 Mastodon 账号，期待能和你在联邦宇宙上相遇。 + +### 我加入了 IndieWeb + +[indieweb.org](https://indieweb.org/) 是这样介绍自己的： + +> IndieWeb 是专注于人的网络，用于替代「大公司网络」。 +> +> 我们是由独立的个人网站组成的社群，基于这样的原则：拥有你自己的域名，把域名用作你最主要的线上身份，在你自己的网站上优先发表内容（发在其他地方是可选的），并且拥有你的内容。 + +
+ 原文 + +> The IndieWeb is a people-focused alternative to the “corporate web”. +> +> We are a community of independent and personal websites based on the principles of: owning your domain and using it as your primary online identity, publishing on your own site first (optionally elsewhere), and owning your content. + +
+ +之前一直很喜欢 IndieWeb 的概念，但没有深入了解。其实加入 IndieWeb 也很简单，最主要的步骤就是拥有自己的域名和网站，优先在网站上发表内容，之后再同步到其他地方，这件事情我已经在做了。要说别的什么东西，大概就是设置一下 Microformats、配置 IndieAuth 和支持 Webmention。 + +Microformats 是基于 HTML 的一种标记内容和身份的格式，主要用来帮助自动化工具展示作者信息和内容信息，详情可查阅 [IndieWeb Wiki](https://indieweb.org/microformats)。 + +至于 IndieAuth，就是给链接加上 `rel="me"` 属性以声明链接到的个人资料的确属于自己，这个链接可以是 `` 也可以是 ``，以下是我的写法： + +```html + + + +``` + +确保网站上有 `rel="me"` 的内容之后，还需要在以上链接中链接到自己的网站，比如在 GitHub 个人资料中设置个人主页链接。许多 IndieWeb 相关的服务，比如 [webmention.io](https://webmention.io/)，支持 Web Sign-In，只要提前配置好了 IndieAuth，就可以通过自己指定的 GitHub 账号或电子邮箱等方式，以域名拥有者的身份登录。 + +如果你拉到网页最下方，会发现评论按钮旁边多了一个图标为 `@` 的按钮，这就是 Webmention，一个 W3C 标准，你可以以发送 HTTP 请求的方式向支持 Webmention 的网站发送回复、点赞、提及等回应，自己也可以作为接收方接收这种回应，展示在网页上。只要配置得当，在自己的网站中插入链接就能像在社交媒体上用 `@用户名` 的形式提及其他用户一样，不过要完全自动化还是有些麻烦的。 + +我使用 [webmention.io](https://webmention.io/) 提供的服务来接收 Webmention，在 `` 中添加了以下代码来声明我的 Webmention 端口。 + +```html + +``` + +向这个端口发送 Webmention，就会展示在我的网站上。如果你拉到网页最下方，会发现评论按钮旁边多了一个 Webmention 按钮，点开之后可以查看这一页收到的 Webmention，也可以通过表单提交你的网址以手动发送 Webmention，不过发送 Webmention 的前提是你提交的网址中有链接到这个页面，比如在文章中插入超链接。 + +我目前还没有配置自动发送 Webmention，用静态网站生成器还是不太方便做自动化，要自己配置 GitHub Actions，兴许有空了我会尝试一下。 diff --git "a/content/essays/\345\205\263\344\272\216\344\270\200\345\210\207\347\232\204\347\272\257\346\226\207\346\234\254\350\247\243\345\206\263\346\226\271\346\241\210\346\214\207\345\215\227.md" "b/content/essays/\345\205\263\344\272\216\344\270\200\345\210\207\347\232\204\347\272\257\346\226\207\346\234\254\350\247\243\345\206\263\346\226\271\346\241\210\346\214\207\345\215\227.md" index ffda7965..04ffe70e 100644 --- "a/content/essays/\345\205\263\344\272\216\344\270\200\345\210\207\347\232\204\347\272\257\346\226\207\346\234\254\350\247\243\345\206\263\346\226\271\346\241\210\346\214\207\345\215\227.md" +++ "b/content/essays/\345\205\263\344\272\216\344\270\200\345\210\207\347\232\204\347\272\257\346\226\207\346\234\254\350\247\243\345\206\263\346\226\271\346\241\210\346\214\207\345\215\227.md" @@ -41,7 +41,7 @@ graph TD; Mermaid 的优势是，它和 Markdown 的生态系统兼容性很好，很多 Markdown 编辑器和渲染工具，都能够渲染嵌入在代码块里的 Mermaid 图形，你只需要把代码块的语言指定为 `mermaid`， 这个代码块就会被替换为图形。据我所知，Obsidian 是内置这个功能的，而 Hugo 的官方[文档](https://gohugo.io/content-management/diagrams/#mermaid-diagrams)里也提供了在 Hugo 中使用 Mermaid 的教程。 -Mermaid 提供 [JavaScript 库](https://github.com/mermaid-js/mermaid)和[命令行工具](https://github.com/mermaid-js/mermaid-cli)，可以轻易地在网站上使用、在基于 Web 的桌面端软件里使用，或者在本地用纯文本编写，再执行 `mmdc` 命令讲文本转换为指定格式的图形。 +Mermaid 提供 [JavaScript 库](https://github.com/mermaid-js/mermaid)和[命令行工具](https://github.com/mermaid-js/mermaid-cli)，可以轻易地在网站上使用、在基于 Web 的桌面端软件里使用，或者在本地用纯文本编写，再执行 `mmdc` 命令将文本转换为指定格式的图形。 不过，我并没有继续使用 Mermaid，因为它有一个非常明显的缺陷：Mermaid 并不支持完整的 UML 规范。尽管 Mermaid 支持很多类型的图形（甚至包括思维导图、看板、饼图和四象限图），但缺少对用例图、活动图等重要 UML 图的支持。 -- cgit v1.2.3