日语语法知识库

主题

语法条目编写指南 ​

1. 编写目标 ​

语法条目应帮助读者回答：

  1. 它表达什么含义？
  2. 如何接续？
  3. 在什么语境下使用？
  4. 与相似表达有什么区别？
  5. 如何在真实句子中识别和使用它？

2. 推荐结构 ​

markdown
---
id: example-pattern
title: 〜例の文型
reading: れいのぶんけい
jlpt: N3
category: example-category
tags:
  - 用法
forms:
  - 动词辞书形
related: []
status: draft
---

# 〜例の文型

## 核心含义
用简洁语言说明主要意义，必要时拆分不同用法。

## 接续
列出接续形式，并说明活用或语域限制。

## 例句
例句由结构化例句数据渲染，不在正文中手写（见下文"例句与假名标注"）。

## 相似表达
关联条目列表由组件根据 `related` 渲染，本节只写差异说明，不手写链接。

## 使用注意
说明常见误用、语境限制或正式程度。

3. 解释原则 ​

  • 先给核心含义，再补充语用差异。
  • 不要把一个表达简单压缩成一个中文词；必要时说明上下文影响。
  • 区分语法形式、语义、语用与语域。
  • 比较近义表达时，给出可解释差异的例句。
  • 如果不同教材或语境有分类差异，应注明分类口径。
  • 不确定时标注待核实，不要把猜测写成定论。

4. 例句原则 ​

  • 优先使用自然、简洁、能体现目标语法的句子。
  • 中文释义应表达原句意思，不要求逐词硬译。
  • 必要时注明说话人、场景、礼貌程度或上下文。
  • 不要从教材、付费题库或网站整段复制例句集合。
  • 引用他人内容时遵循许可与署名要求。

5. 例句与假名标注 ​

例句一律通过结构化例句数据（JSON，见《内容数据规范》project-docs/CONTENT_SCHEMA.md 第 5 节）提供，不在 Markdown 正文中手写例句或用 <ruby> 标注：假名开关与音频播放都依赖结构化数据，<ruby><rt> 只是组件渲染例句时的输出格式，不是贡献者的书写入口。

furigana 字段只为确实需要标注的词提供读音。不要仅凭汉字外观推断读音；注意熟字训、音训、送假名与语境。

6. 标签与分类 ​

  • category 使用仓库已定义的分类 ID。
  • tags 选择已有标签，确有必要时再提出新标签。
  • 标签描述可交叉检索的主题，不重复写完整句子。
  • 不要把 JLPT 等级写入 tags；等级只通过 jlpt 字段维护，页面等级徽章与索引中的等级维度由构建自动生成。

7. 提交前自查 ​

  • [ ] ID 唯一且稳定。
  • [ ] JLPT 等级和分类 ID 合法。
  • [ ] 接续与含义清楚。
  • [ ] 至少有一个准确例句及中文释义。
  • [ ] related 关联 ID 有效。
  • [ ] 读音与假名标注正确。
  • [ ] 来源与版权问题已确认。