跳到主内容 / Skip to content
Materin

首页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:40Pages 构建完成(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 OfficeObsidian 中读写 Office 文件(docx / xlsx / pptx / xls / doc / ppt)/projects/materin-office/
Materin ViewOpenAPI / Swagger 的 knife4j 风格文档视图与请求调试/projects/materin-view/
Materin CtxJSON / 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

PurposeAddress
Organization sitehttps://materin-tech.github.io/
About (this page)https://materin-tech.github.io/about/
Static asset rootRepository root = domain root. E.g. https://materin-tech.github.io/assets/img/favicon.svg can be referenced by any project
Organization profilegithub.com/materin-tech

Conventions

ConventionRationale
One directory, one repositoryEach project gets its own repository named after its directory, with no cross-coupling
Static-firstThe site is pure static, build-free and dependency-free — pushing to main publishes it
Org site is the asset rootThe root of materin-tech.github.io is the root of the domain
Docs decoupled from sourceIntro pages live under /projects/<repo>/ to avoid colliding with future project-level Pages (/<repo>/)
Public-firstOn the Free plan, GitHub Pages only supports public repositories
BilingualIntroductions ship in Chinese and English; toggle in the top-right corner

Initialization log

Time (UTC)Event
2026-09-25 00:20Organization materin-tech created — Free plan, initial member leapord (admin)
2026-09-25 00:38Organization site repository materin-tech.github.io created (public)
2026-09-25 00:39First commit 2ee6467 pushed; GitHub Pages enabled automatically
2026-09-25 00:40Pages build finished (within 20s); site live with HTTPS enforced
2026-09-25 00:43Site gained bilingual content, this About page and the Materin plugin intro pages
2026-09-25 00:48Organization 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

ProjectDescriptionIntro page
Materin OfficeRead, edit and save Office files in Obsidian (docx / xlsx / pptx / xls / doc / ppt)/projects/materin-office/
Materin ViewA knife4j-style documentation view and request debugger for OpenAPI / Swagger/projects/materin-view/
Materin CtxA 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.