首页Home / 关于 MaterinAbout Materin
关于 MaterinAbout Materin
名字取自「格物」:先把事看清,再把话说清。
Named after 格物 — understand it first, explain it plainly.
Materin 是什么
Materin 是这个站点的名字,取自「格物」—— 把一件事追到底。《礼记·大学》讲「致知在格物」:先弄清楚,才有真知。
换到今天的话:面对新东西不急着表态,先弄清它是什么、能做什么、边界在哪、说法和事实差多少,再写成不必懂行也能读懂的说明。
内容与代码由 GitHub 组织 materin-tech 承载;所有内容先在这里讲清楚,出处放在最后。
现在发布的内容
目前站上发布的是三个 Obsidian 插件(Materin Office / View / Ctx),每个都有一页站内说明。
三个插件是同一个系列,产品定位就落在这一点上:共用一套 UI —— 颜色跟随用户主题、形状与间距固定、变量统一。规范与令牌文件见 Materin UI。
新的题目在写,写法和它们一样:先弄明白,再写下来。
组织与载体
Materin 是一个以「静态优先、仓库自治」为组织方式的项目集合。每个项目在自己的仓库里独立演进,不互相耦合;本站统一承担门面、资源分发与说明页的职责。
设立初衷
- 项目介绍散落在各个仓库的 README 里,缺少稳定、可分享的统一入口;
- 图标、样式、示例文件等静态资源在各项目之间反复复制;
- 需要长期稳定的域名来承载项目介绍、文档与下载指引。
站点与资源
| 用途 | 地址 |
|---|---|
| 组织站点 | https://materin-tech.github.io/ |
| 组织说明(本页) | https://materin-tech.github.io/about/ |
| 静态资源根 | 仓库根目录 = 域名根目录。例如 https://materin-tech.github.io/assets/img/favicon.svg 可被任意项目直接引用 |
| 组织主页 | github.com/materin-tech ↗ (外部链接)(external) |
结构约定
| 约定 | 说明 |
|---|---|
| 一个目录一个仓库 | 一个项目一个独立仓库,目录与仓库同名,互不耦合 |
| 静态优先 | 站点纯静态、零构建、零依赖,推送到 main 即发布 |
| 组织站点即资源根 | materin-tech.github.io 仓库的根目录就是域名根目录 |
| 介绍页与源码分离 | 项目介绍页挂在 /projects/<repo>/,避免与未来的项目级 Pages(/<repo>/)路径冲突 |
| 公开优先 | 免费计划下 GitHub Pages 仅支持 public 仓库 |
| 双语 | 介绍与说明同时提供中文与英文,页面右上角一键切换 |
初始化记录
| 时间 (UTC) | 事项 |
|---|---|
| 2026-09-25 00:20 | 组织 materin-tech 创建,Free 计划,初始成员 leapord(admin) |
| 2026-09-25 00:38 | 创建组织站点仓库 materin-tech.github.io(public) |
| 2026-09-25 00:39 | 首个提交 2ee6467 推送,GitHub Pages 自动启用 |
| 2026-09-25 00:40 | Pages 构建完成(20 秒内),站点上线,HTTPS 强制开启 |
| 2026-09-25 00:43 | 站点新增中英双语、本说明页,以及 Materin 插件系列介绍页 |
| 2026-09-25 00:48 | 创建组织档案仓库 materin-tech/.github,组织主页展示双语简介 |
目录布局
materin-tech/
├── .github/ 组织档案仓库(组织主页简介)
├── materin-tech.github.io/ 组织站点仓库(本域名的全部内容)
│ ├── index.html 首页
│ ├── about/ 组织说明(本页)
│ ├── projects/ 项目介绍页
│ │ ├── materin-office/
│ │ ├── materin-view/
│ │ └── materin-ctx/
│ ├── data/projects.json 项目清单
│ └── assets/ 静态资源(CSS / JS / 图标)
└── <project>/ 其他项目各自独立成库
项目
| 项目 | 说明 | 介绍页 |
|---|---|---|
| Materin Office | Obsidian 中读写 Office 文件(docx / xlsx / pptx / xls / doc / ppt) | /projects/materin-office/ |
| Materin View | OpenAPI / Swagger 的 knife4j 风格文档视图与请求调试 | /projects/materin-view/ |
| Materin Ctx | JSON / YAML 的原生手感编辑器 | /projects/materin-ctx/ |
Materin 系列插件的源码目前位于个人账号 leapord 下,介绍页已挂载到本组织站点;后续可按需转移仓库到组织,届时只需更新介绍页与清单中的链接。
联系
通过 站点仓库的 Issue 联系。
What Materin is
Materin is the name of this site, taken from 格物 (géwù) — following a thing to the bottom. The Book of Rites has it as "knowledge comes from investigating things": get it straight first, then you know.
In today's terms: when something new appears, don't rush to a verdict. First establish what it is, what it can do, where its edges are, and how far the claims are from the facts — then write it down so that no background is needed.
Content and code live under the GitHub organization materin-tech; everything is explained here first, sources last.
What's published today
The site publishes three Obsidian plugins (Materin Office / View / Ctx), each with its own in-site page.
They are one series, and that is where the product positioning sits: one shared UI — colours follow the user's theme, shape and spacing are fixed, variables are unified. The spec and token file are at Materin UI.
New pieces are being written, following the same rule: understand it first, write it down after.
The organization behind it
Materin is a collection of projects organized around two principles: static-first and repository autonomy. Every project evolves independently in its own repository with no cross-coupling, while this site serves as the single facade, the asset host and the home of documentation.
Why it exists
- Project descriptions were scattered across individual repository READMEs, with no stable, shareable entry point;
- Static assets (icons, styles, sample files) were copied between projects over and over;
- A long-lived stable domain was needed to host project introductions, docs and download pointers.
Site and assets
| Purpose | Address |
|---|---|
| Organization site | https://materin-tech.github.io/ |
| About (this page) | https://materin-tech.github.io/about/ |
| Static asset root | Repository root = domain root. E.g. https://materin-tech.github.io/assets/img/favicon.svg can be referenced by any project |
| Organization profile | github.com/materin-tech |
Conventions
| Convention | Rationale |
|---|---|
| One directory, one repository | Each project gets its own repository named after its directory, with no cross-coupling |
| Static-first | The site is pure static, build-free and dependency-free — pushing to main publishes it |
| Org site is the asset root | The root of materin-tech.github.io is the root of the domain |
| Docs decoupled from source | Intro pages live under /projects/<repo>/ to avoid colliding with future project-level Pages (/<repo>/) |
| Public-first | On the Free plan, GitHub Pages only supports public repositories |
| Bilingual | Introductions ship in Chinese and English; toggle in the top-right corner |
Initialization log
| Time (UTC) | Event |
|---|---|
| 2026-09-25 00:20 | Organization materin-tech created — Free plan, initial member leapord (admin) |
| 2026-09-25 00:38 | Organization site repository materin-tech.github.io created (public) |
| 2026-09-25 00:39 | First commit 2ee6467 pushed; GitHub Pages enabled automatically |
| 2026-09-25 00:40 | Pages build finished (within 20s); site live with HTTPS enforced |
| 2026-09-25 00:43 | Site gained bilingual content, this About page and the Materin plugin intro pages |
| 2026-09-25 00:48 | Organization profile repository materin-tech/.github created; the org page shows the bilingual profile |
Directory layout
materin-tech/
├── .github/ Org profile repository (GitHub org page)
├── materin-tech.github.io/ Org site repository (everything served here)
│ ├── index.html Home
│ ├── about/ About (this page)
│ ├── projects/ Project intro pages
│ │ ├── materin-office/
│ │ ├── materin-view/
│ │ └── materin-ctx/
│ ├── data/projects.json Project manifest
│ └── assets/ Static assets (CSS / JS / icons)
└── <project>/ Every other project lives in its own repository
Projects
| Project | Description | Intro page |
|---|---|---|
| Materin Office | Read, edit and save Office files in Obsidian (docx / xlsx / pptx / xls / doc / ppt) | /projects/materin-office/ |
| Materin View | A knife4j-style documentation view and request debugger for OpenAPI / Swagger | /projects/materin-view/ |
| Materin Ctx | A native-feeling JSON / YAML editor | /projects/materin-ctx/ |
The Materin plugin sources currently live under the personal account leapord, with their intro pages hosted here. Repositories can be transferred to the organization later; only links in the intro pages and the manifest would need updating.
Contact
Reach us through an issue on the site repository.