THINKER-NAMING(7)

NAME

thinker-naming(7) - 本站借用 Unix manual page 的名字

SYNOPSIS

thinker(7) 不是系统命令。

它也不是版本号。

它是一条网页内部的文档约定。

DESCRIPTION

Unix manual page 使用 name(section) 标记条目。

man-pages(7) 把 synopsis 写作 man [section] title。

例如 printf(1) 通常表示用户命令。

passwd(5) 通常表示文件格式。

signal(7) 通常表示概念、惯例或杂项说明。

本站借用这个语法，把自己命名为 THINKER(7)。

这里的 thinker 是条目名。

这里的 7 表示它更接近概念说明，而不是命令、库函数、配置文件或管理工具。

WEB

本站每次构建都生成 thinker.7，打包在首页 FILES 的 man.tar.gz 里。

把它解开到 manpath 中的目录，就可以运行：

man 7 thinker

但这不是本站的主要目标。

因为读者通过网页访问本站。

真正重要的是网页自己把约定讲清楚。

于是 THINKER(7) 首先是一个可见的文档身份，其次才是 man database 中的实体。

它告诉读者：

这个站点不是动态应用。

也不是现代博客主题。

它更像一组可以长期保存、直接检查、安静阅读的本地手册。

SECTION 7

选择 7 是因为它的语义最接近本站。

man-pages(7) 将 section 7 概括为 “Overview, conventions, and miscellaneous”。

本站不提供一个 shell 命令。

所以不是 thinker(1)。

本站不定义一个文件格式。

所以不是 thinker(5)。

本站不管理系统。

所以不是 thinker(8)。

它记录的是系统、约束、写作惯例和一些持续变化的想法。

所以它更接近 thinker(7)。

NOTES

thinker.7 已经存在，这个暗喻在 Unix 系统里也成立了。

macOS 的默认 manpath 不含 $HOME，解开 man.tar.gz 时改用已在其中的目录，例如 /opt/homebrew/share/man。

但对本站来说，更重要的不是 man 命令本身。

更重要的是约定不悬空。

读者看见 THINKER(7)，应该知道这是本站对自己的定义：

一个关于 thinker 的第七节手册条目。

SOURCES

关于 manual section 的传统定义，本文参考 man-pages(7) - Linux manual page (external)。

其中 section 7 被定义为概览、惯例、协议、字符集标准、文件系统布局和杂项说明。

SEE ALSO