add translation-review-comment skill and doc review workflow
- skills/translation-review-comment/SKILL.md: 14 rules distilled from 473 Wade editor comments across 3 manuscripts - translate-files/佛法与企业管理/review-comments.dj: manual comment reference for maple's translation (anchored comments not possible via API) - docs/google-docs-comment-journey.dj: full journey log from OAuth setup to discovering Google Drive API's anchor limitation
This commit is contained in:
@@ -0,0 +1,425 @@
|
||||
---
|
||||
name: translation-review-comment
|
||||
description: Editorial polish pass for CN→EN Buddhist translation — voice, flow, readability. Applies patterns distilled from 473 editor comments across 3 manuscripts. Use AFTER translation-review for terminology/accuracy checks.
|
||||
---
|
||||
|
||||
# Translation Review — Comment (Editorial Polish)
|
||||
|
||||
Editorial polish for CN→EN Buddhist translation manuscripts. Focuses on voice, flow,
|
||||
and readability — the layer beyond terminology and accuracy. Distilled from 473
|
||||
editor comments by Wade across 3 manuscripts:
|
||||
|
||||
| Document | Comments | Period |
|
||||
|----------|----------|--------|
|
||||
| 61 人生佛教在当代的弘扬 | 121 | 2026-06-19–20 |
|
||||
| 附录 我的判教观 | 151 | 2026-06-13–16 |
|
||||
| 16 觉醒的艺术 | 201 | 2026-04-17–05-24 |
|
||||
|
||||
## When to Use
|
||||
|
||||
After `translation-review` (terminology, accuracy, line parity). This skill targets the
|
||||
"Pass 3" layer — does the English read as natural prose, or as translationese?
|
||||
|
||||
Apply to `.dj` files with `patch` or to Google Docs comment threads.
|
||||
|
||||
## Core Principles
|
||||
|
||||
Three principles drive all the specific rules below:
|
||||
|
||||
1. **Reader engagement** — the English should invite the reader in. Use "we," active
|
||||
voice, conversational tone. The original is an interview/dialogue; the translation
|
||||
should sound like one.
|
||||
2. **Simplicity over sophistication** — prefer everyday words over academic ones.
|
||||
If a construction feels heavy, stiff, or formal, simplify it.
|
||||
3. **Source faithfulness** — never add content not in the Chinese, and never drop
|
||||
content that is. But restructure freely for natural English flow — don't mirror
|
||||
Chinese word order when it produces awkward English.
|
||||
|
||||
## Rule Checklist
|
||||
|
||||
Apply these in order. Each rule includes the signal (what to look for) and the fix
|
||||
pattern. Examples are drawn from actual editor comments.
|
||||
|
||||
---
|
||||
|
||||
### R1: Active Voice + "We" Subject
|
||||
|
||||
**Signal**: Passive voice, impersonal "one," "it," abstract subjects.
|
||||
|
||||
**Fix**: Use "we" or a concrete human subject.
|
||||
|
||||
```
|
||||
- "the propagation of Buddhism must move toward modernisation"
|
||||
+ "we must bring Buddhism into the modern age"
|
||||
|
||||
- "it becomes even harder to have an environment for further study"
|
||||
+ "students find it even harder to have a place for further study"
|
||||
|
||||
- "One must further develop the mind of renunciation"
|
||||
+ "We must further develop the mind of renunciation"
|
||||
```
|
||||
|
||||
**Check**: Scan for "one" (as pronoun), passive "be + past-participle," and sentences
|
||||
where the subject is an abstract noun phrase. Replace with "we" + active verb.
|
||||
|
||||
---
|
||||
|
||||
### R2: Noun → Verb Conversion
|
||||
|
||||
**Signal**: Heavy noun phrases where a verb would be lighter and clearer.
|
||||
Especially common with: propagation, promotion, engagement, commercialisation,
|
||||
modernisation, adjustment, continuation, cultivation, development.
|
||||
|
||||
**Fix**: Replace the noun with its verb form. Restructure the sentence around a
|
||||
human subject (usually "we").
|
||||
|
||||
```
|
||||
- "the adjustment of focus in" → delete entirely or rephrase
|
||||
- "for the propagation of the Dharma" → "to spread the Dharma"
|
||||
- "the promotion of Humanistic Buddhism" → "as we actively promote..."
|
||||
- "engagement with the worldly realm" → "it engages with worldly affairs"
|
||||
- "commercialisation" → "society has become increasingly commercialized"
|
||||
- "the continuation of" → "flow"
|
||||
```
|
||||
|
||||
**Check**: Search for `tion of`, `ment of`, `isation of`. Try deleting the phrase
|
||||
first — often the sentence flows fine without it.
|
||||
|
||||
---
|
||||
|
||||
### R3: Simplify Vocabulary
|
||||
|
||||
**Signal**: Formal, academic, or literary words that an everyday reader would trip on.
|
||||
|
||||
**Fix**: Replace with the simplest word that preserves the meaning.
|
||||
|
||||
```
|
||||
Academic → Everyday:
|
||||
"provisions" (资粮) → "spiritual resources" or rephrase
|
||||
"constitutes" → "is" / "forms" / "makes up"
|
||||
"cognizes" → "understands"
|
||||
"transient" → "changing" / "impermanent"
|
||||
"ancestral masters" → "great masters"
|
||||
"eminent monks and great masters" → pick one (redundant)
|
||||
"mode of existence" → "way of living"
|
||||
"the degree of this entrapment" → "how tightly we cling"
|
||||
"corresponding" → "proper" / "solid" or delete
|
||||
"uncritically" → delete (accepting covers it)
|
||||
"sublimated" → simpler word
|
||||
"encompassing" → simpler word
|
||||
"inherently unsustainable" → "they will not last"
|
||||
```
|
||||
|
||||
**Check**: For each sentence, ask: would I say this word in conversation? If not,
|
||||
find the everyday equivalent.
|
||||
|
||||
---
|
||||
|
||||
### R4: Break Long Sentences
|
||||
|
||||
**Signal**: Single sentence with 3+ clauses, especially with lists, parallel
|
||||
structures, or multiple "and"/"while"/"with" connectors.
|
||||
|
||||
**Fix**: Split into 2–3 shorter sentences. Each sentence should convey one idea.
|
||||
|
||||
```
|
||||
Before (one sentence):
|
||||
"Influenced by society, many within the Buddhist community have also become
|
||||
enthusiastic about power and economic gain, treating tourism and ritual services
|
||||
as the main focus programme of temples, while neglecting their proper
|
||||
responsibility of carrying on the Buddha's mission."
|
||||
|
||||
After (two sentences):
|
||||
"Influenced by society, some in the Buddhist community have also become
|
||||
enthusiastic about power and money. They make tourism and ritual services the
|
||||
main focus of temple activities, while neglecting their true duty to carry on
|
||||
the Buddha's mission."
|
||||
```
|
||||
|
||||
**Check**: Count clauses. If >2, consider splitting. Especially split:
|
||||
- When a list starts mid-sentence
|
||||
- When "while" / "with" introduces a new subject
|
||||
- When a long parenthetical could stand alone
|
||||
|
||||
---
|
||||
|
||||
### R5: Remove Unnecessary Words
|
||||
|
||||
**Signal**: Modifiers that don't add meaning, filler words, redundant pairs.
|
||||
|
||||
**Fix**: Delete them. The sentence should stand without them.
|
||||
|
||||
```
|
||||
Common deletions:
|
||||
"so-called" — almost always deletable
|
||||
"generally" — deletable unless making a specific contrast
|
||||
"phenomenon" — "this phenomenon" → "this"
|
||||
"fundamentally" — deletable
|
||||
"necessarily" — deletable
|
||||
"solely" — deletable
|
||||
"briefly summarise" — "briefly" is redundant with "summarise"
|
||||
"and influenced" — deletable
|
||||
"the practice of" — often deletable
|
||||
"The development of"— often deletable
|
||||
"and investigating" — if already "studying," drop
|
||||
"practical" (in "practical methods") — "methods" alone covers it
|
||||
```
|
||||
|
||||
**Check**: For each word: does removing it change the meaning? If not, remove it.
|
||||
|
||||
---
|
||||
|
||||
### R6: Conversational / Interview Tone
|
||||
|
||||
**Signal**: Formal register, stiff constructions, academic phrasing in a dialogue
|
||||
context. The Chinese originals are interviews; the English should read as spoken word.
|
||||
|
||||
**Fix**: Imagine you're saying it aloud. Adjust accordingly.
|
||||
|
||||
```
|
||||
Formal → Conversational:
|
||||
"What do you think is the → "Why do you think that is?"
|
||||
reason for this?"
|
||||
"outdated" → "old-fashioned" (in spoken context)
|
||||
"It is summarised in the → Use direct speech
|
||||
famous expression: ..."
|
||||
"the common point of the → "what all these issues have
|
||||
above-mentioned issues" in common"
|
||||
"From the perspective of → "Looking at Buddhist history,"
|
||||
Buddhist history,"
|
||||
"besides remaining grounded → "In the modernisation of Buddhism,
|
||||
in the principle of adapting while we must stay true to..."
|
||||
both to Buddhist teachings
|
||||
and to the needs of the people"
|
||||
```
|
||||
|
||||
**Check**: Read the passage aloud (mentally). Does it flow like speech? If it feels
|
||||
like a lecture transcript, lighten it.
|
||||
|
||||
---
|
||||
|
||||
### R7: No -ly Adverbs
|
||||
|
||||
**Signal**: Adverbs ending in -ly.
|
||||
|
||||
**Fix**: Delete them, or restructure to avoid them. Modern English style avoids
|
||||
adverb clutter.
|
||||
|
||||
```
|
||||
- "briefly summarise" → "summarise"
|
||||
- "fundamentally new" → "new"
|
||||
- "truly able to" → "able to"
|
||||
- "extremely limited" → "very small number" (restructure)
|
||||
- "gradually established" → "established" (ok in context)
|
||||
```
|
||||
|
||||
**Check**: Search for `\w+ly\b`. Evaluate each — most can be dropped.
|
||||
|
||||
---
|
||||
|
||||
### R8: Concrete over Abstract
|
||||
|
||||
**Signal**: Abstract noun phrases that could be expressed more directly.
|
||||
|
||||
**Fix**: Make the idea concrete. Use examples, metaphors, or simpler terms.
|
||||
|
||||
```
|
||||
Abstract → Concrete:
|
||||
"the mistaken identification → "the mistaken belief in a fixed
|
||||
and attachment to the self" self and our clinging to it"
|
||||
"corresponding mental functions" → "the mindset that aligns with them"
|
||||
"discern the universal sequence → "understand how the teachings
|
||||
from shallow to deep" progress from basic to advanced"
|
||||
"mode of existence centered → "a life centered on the Three Jewels"
|
||||
on the Three Jewels"
|
||||
"a field of specialisation" → delete (unnecessary abstraction)
|
||||
"ideological content" → "ideas"
|
||||
```
|
||||
|
||||
**Check**: If a noun phrase has 3+ words and feels like jargon, find a plainer way.
|
||||
|
||||
---
|
||||
|
||||
### R9: Terminology Alignment
|
||||
|
||||
**Signal**: Terms that have established translations in the MPI terms database or
|
||||
prior publications (坐看云起, etc.).
|
||||
|
||||
**Fix**: Use the established translation. Load `terms-search` skill and check:
|
||||
`python3 $MPI_PROJECT_ROOT/terms-search/search.py <term>`
|
||||
|
||||
```
|
||||
Key distinctions from the 3 manuscripts:
|
||||
人生佛教 → "Buddhism of Human Life" (NOT "Humanistic Buddhism")
|
||||
人间佛教 → "Humanistic Buddhism"
|
||||
禅宗 → "Chan" (not "Zen")
|
||||
根机 → "faculties" (not "dispositions", not "root")
|
||||
高僧大德 → pick one: "eminent monks" or "great masters" (not both)
|
||||
假 (三性) → "false" (from emptiness perspective)
|
||||
monks → "monastics" (includes both monks and nuns — 含比丘比丘尼)
|
||||
惑业苦 → "delusion, karma, and suffering" (logical order preserved)
|
||||
出世乐 → keep consistent with "supreme bliss of Nirvana" used earlier
|
||||
戒体 → don't use "precept essence" (hard to understand); expand to
|
||||
"the mind of upholding the precepts"
|
||||
```
|
||||
|
||||
**Check**: For any Buddhist technical term, verify against the terms DB before
|
||||
using a new translation. Consistency across manuscripts matters.
|
||||
|
||||
---
|
||||
|
||||
### R10: Missing Content Detection
|
||||
|
||||
**Signal**: Chinese paragraph has multiple clauses/ideas, but English stops after
|
||||
1–2 sentences. Quoted speech, poems, rhetorical climaxes in CN are absent from EN.
|
||||
|
||||
**Fix**: Flag as "Missing Content." Translate the missing portion.
|
||||
|
||||
```
|
||||
Common patterns:
|
||||
- 中文有4-5个短句,英文只有1-2句 → 漏翻了
|
||||
- CN has a paragraph with quoted speech → EN paragraph ends before the quote
|
||||
- 一些具有相当成就的前辈高僧... → entire passage skipped
|
||||
- 内修与外弘也是同样... → entire paragraph missing
|
||||
- 民众在接受教育期间,无法从教科书上对佛教获得正面了解 → line missing
|
||||
```
|
||||
|
||||
**Check**: Compare CN and EN paragraph lengths. If CN is substantially longer but
|
||||
EN seems complete, re-read the CN carefully — something was likely dropped.
|
||||
|
||||
---
|
||||
|
||||
### R11: Source Faithfulness
|
||||
|
||||
**Signal**: English adds concepts, metaphors, or explanations not present in the
|
||||
Chinese. Or English drops specific details that the Chinese includes.
|
||||
|
||||
**Fix**: Remove additions. Translate dropped content. But restructure freely for
|
||||
natural English — don't mirror Chinese word order if it produces awkward results.
|
||||
|
||||
```
|
||||
Additions to remove:
|
||||
- "this addresses one of the most fundamental philosophical questions"
|
||||
(not in CN → delete)
|
||||
- "preserving the potential for future expression" (not in CN → delete)
|
||||
- "making this school widely known in China" (not in CN → delete)
|
||||
|
||||
Things to preserve:
|
||||
- Quoted speech, idioms, and rhetorical questions — translate fully
|
||||
- Logical connectors between sentences — don't skip them
|
||||
- The speaker's distinctive voice and argument structure
|
||||
- 讲法风格 — the master's teaching style should come through
|
||||
```
|
||||
|
||||
**Check**: For each paragraph, ask: is there content in EN that has no basis in CN?
|
||||
Is there content in CN that has no corresponding EN? Fix both.
|
||||
|
||||
---
|
||||
|
||||
### R12: Sentence Structure Clarity
|
||||
|
||||
**Signal**: English reads as "translationese" — word order follows Chinese,
|
||||
parallel structures are misaligned, logical flow is broken.
|
||||
|
||||
**Fix**: Restructure for natural English. Reorder clauses. Align parallel items.
|
||||
|
||||
```
|
||||
- "Despite different methods, your focus has always been Humanistic Buddhism"
|
||||
→ "Although the methods vary, they all center on Humanistic Buddhism"
|
||||
(methods vs. focus — misaligned comparison)
|
||||
|
||||
- "the root cannot be established"
|
||||
→ "we cannot establish the root" (add human subject)
|
||||
|
||||
- Lists: keep verb forms parallel
|
||||
"First, focus on building... Second, keep liberation at the center...
|
||||
Third, highlight the unique spirit..."
|
||||
(imperative verbs aligned)
|
||||
```
|
||||
|
||||
**Check**: Read each sentence and ask: would a native English speaker structure it
|
||||
this way? If not, reorder.
|
||||
|
||||
---
|
||||
|
||||
### R13: Specific Word Fixes
|
||||
|
||||
**Signal**: Certain English words have wrong connotations for the context.
|
||||
|
||||
**Fix**: Use the recommended replacement.
|
||||
|
||||
```
|
||||
"comeback" → "return" (comeback = return to popularity, not return to roots)
|
||||
"evokes" → "brings" / "gives rise to" (evokes is too formal)
|
||||
"entertain" → "have" (entertain thoughts → have thoughts)
|
||||
"falls" → "fades" (faith falls → faith fades)
|
||||
"reverse" → "transform" (gentler)
|
||||
"escape" → softer word in context
|
||||
"dismantle" → "challenges" / "undoes" (dismantle is too aggressive)
|
||||
"head" → "beginning" (head of the Eightfold Path → beginning)
|
||||
"none" → "not many" (when the claim is "未提供多少" not "none at all")
|
||||
"function" → "purpose" (in non-technical contexts)
|
||||
"object" → "focus" (object of practice → focus of practice)
|
||||
"uncommon" → "unique" / "distinctive" (不共 = not shared with other paths)
|
||||
"conduct and propagate" → "uphold and spread"
|
||||
"attainment of Buddhahood" → "enlightenment" (in some contexts, to avoid
|
||||
Buddha/Buddhahood repetition)
|
||||
"liberation" → "liberation" is fine, but check if context means "解脱" or "出世"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### R14: Positive Feedback — Praise the Translator (随喜)
|
||||
|
||||
**Signal**: A passage reads well — accurate, natural, fluent. Or the translation
|
||||
as a whole shows consistent quality.
|
||||
|
||||
**Action**: Praise the first-pass translator by name. The editor consistently opens
|
||||
or closes review sections with affirmations directed at the translator:
|
||||
|
||||
```
|
||||
"随喜师兄整体翻译还是很好的,前后连贯,清晰"
|
||||
"随喜师兄翻译 准确流畅!"
|
||||
"随喜师兄上段和本段翻译 准确流畅"
|
||||
"随喜师兄查证出处"
|
||||
"整段翻译的很好"
|
||||
"整段翻译还是很棒的"
|
||||
"翻译一气呵成 很精彩"
|
||||
"很赞叹 简洁有力!"
|
||||
"这个功不唐捐翻译的真好"
|
||||
"随喜这个翻译!衔接的很好"
|
||||
"这个翻译很赞!"
|
||||
"这段翻译也很好"
|
||||
"整段翻译的还是很好的"
|
||||
"翻译的意思都表达出来了"
|
||||
"本段翻译的都很好,随喜赞叹!"
|
||||
```
|
||||
|
||||
This matters for three reasons:
|
||||
1. It tells the translator what to preserve — don't accidentally "fix" what works
|
||||
2. It follows the deliberation protocol — rejoicing (随喜) comes first, before
|
||||
any criticism. The translator should feel their effort is seen and valued
|
||||
3. It names the translator explicitly — "随喜师兄" — making the praise personal,
|
||||
not generic. When reviewing, use the translator's name from the document title
|
||||
(e.g. 妙蕊, 法轩, Fiona)
|
||||
|
||||
## Workflow
|
||||
|
||||
```
|
||||
1. Read source.dj + target.dj (full files)
|
||||
2. Apply R1–R13 in order, scanning the English line by line
|
||||
3. For each issue found, apply with patch or write to translation-findings.dj
|
||||
4. Note well-translated passages (R14)
|
||||
5. Final pass: read the full English aloud — does it flow?
|
||||
```
|
||||
|
||||
## Pitfalls
|
||||
|
||||
- Don't apply this skill before `translation-review` — terminology must be correct first.
|
||||
- Don't over-correct: some formal constructions are appropriate for certain passages.
|
||||
Judge per context.
|
||||
- When converting nouns to verbs, keep the meaning intact — don't simplify away
|
||||
doctrinal nuance.
|
||||
- The "we" subject is generally preferred but not absolute. If a passage describes
|
||||
a general principle without a specific agent, passive/impersonal may be correct.
|
||||
- Positive feedback (R14) is not optional fluff — it guides what to preserve.
|
||||
@@ -95,6 +95,7 @@ category of error. Don't try to catch everything in one scan.
|
||||
- Buddhist terminology against the MPI terms DB (see terms-db-alignment below)
|
||||
- Mistranslation of key terms, wrong proper names, garbled text
|
||||
- Mid-paragraph truncation: CN covers 3–5 clauses but EN stops after 1–2 sentences. Signal: CN has quoted speech, poems, or a rhetorical climax absent from EN. Flag as "Missing Content" not "Incomplete."
|
||||
- Use `references/common-issues-taxonomy.md` as a structured checklist for accuracy issues
|
||||
|
||||
**Pass 2 — mechanical/formatting** (also mechanical, but easy to skip):
|
||||
- TOC format: AGENTS.md says TOC must be plain bullet list, no link targets. Strip `[I. Heading](#...)` markdown links if present.
|
||||
@@ -218,12 +219,38 @@ Do not run extraction pipelines until scope is clear.
|
||||
- **Batch terminology lookups** — when checking many terms against the terms DB, run them in one `execute_code` script that loops over a query list and calls `search.py` via `subprocess.run`. One terminal call per term floods the context with repetitive output.
|
||||
- **Proofread ≠ translation review** — when the user says "校对" or "proofread" and the input is a DOCX manuscript with existing English, you are in proofread mode. Do NOT flag translation quality, terminology, or djot formatting. Do NOT apply patches to bilingual.dj unless asked. Write `edit-suggestions.dj` with manuscript-level issues only. If the user later asks for translation review of the same article, write findings to a separate `translation-findings.dj`.
|
||||
|
||||
## Human Review Protocol (审议)
|
||||
|
||||
When giving feedback to human translators — whether in a review team or as an AI
|
||||
assistant flagging issues — follow the Oriental Translation Workshop protocol.
|
||||
See `references/deliberation-protocol.md` for full guidance.
|
||||
|
||||
Key points:
|
||||
- **Rejoice first** (随喜): affirm what works before flagging issues
|
||||
- **Three-tier issues**: Level 1 (spelling/grammar/format) — fix directly. Level 2
|
||||
(omission/mistranslation/wordiness) — suggest or fix with tracked changes. Level 3
|
||||
(citation versions / marginal wording) — discuss with translator
|
||||
- **Tone**: questions, not commands; collaborative inquiry, not correction
|
||||
- **Address translator as 菩萨** (Bodhisattva) — respectful peer
|
||||
|
||||
## Common Issues Taxonomy
|
||||
|
||||
Use `references/common-issues-taxonomy.md` as a structured checklist when reviewing.
|
||||
Categories:
|
||||
|
||||
- **Accuracy**: omission, mistranslation (over-free, over-literal, misunderstanding,
|
||||
wrong word choice), overtranslation, terminology errors
|
||||
- **Readability**: redundancy (long sentences, passive voice, nominalization),
|
||||
poor structure (top-heavy sentences), wrong register, weak transitions
|
||||
|
||||
## References
|
||||
|
||||
- `references/buddhist-terminology.md` — Chinese-English Buddhist term mappings and pitfalls
|
||||
- `references/terms-db-alignment.md` — Batch-aligning glossary terms against the MPI terms database
|
||||
- `references/translation-pitfalls.md` — Recurring CN→EN mistranslation patterns (关爱→compassion, 生生增上, etc.)
|
||||
- `references/proofreading-patterns.md` — DOCX/PDF extraction techniques, block-based pairing, common manuscript issues
|
||||
- `references/deliberation-protocol.md` — Oriental Translation Workshop review protocol: tiers, rejoicing, tone
|
||||
- `references/common-issues-taxonomy.md` — Structured taxonomy of accuracy and readability issues with examples
|
||||
|
||||
## Scripts
|
||||
|
||||
|
||||
@@ -0,0 +1,174 @@
|
||||
# Common Translation Issues Taxonomy
|
||||
|
||||
From 译文常见问题与案例示范 (Common Issues in Translation, 2026-03-30).
|
||||
Categorized by accuracy and readability.
|
||||
|
||||
## Accuracy Issues
|
||||
|
||||
Standard: convey meaning at the content level, not word-by-word correspondence.
|
||||
"Translation is not simply word conversion."
|
||||
"You must understand what thought it is actually trying to express."
|
||||
|
||||
### 1. Omission (漏翻)
|
||||
|
||||
Content present in source but absent from target.
|
||||
|
||||
Example:
|
||||
> 随着黑白牌的运用,象征这部分已能为大家提供系统的学习和训练资料。
|
||||
>
|
||||
> With the help of the Black-and-White Cards, this approach now offers a structured
|
||||
> system of study.
|
||||
>
|
||||
> *Missing:* 学习和训练 (learning and training) — "study" only covers half.
|
||||
> Also: 象征这部分 (symbolizing this aspect) is dropped.
|
||||
|
||||
### 2. Mistranslation (错翻)
|
||||
|
||||
#### a. Over-free translation, weakening the original
|
||||
|
||||
> "道德"一词,人们耳熟能详。即使在道德日渐边缘化的今天,人们依然会用"这人
|
||||
> 很有道德""这么做太缺德了"来评价周遭人事。
|
||||
>
|
||||
> "Morality" is a familiar term, and even in today's world, where it has become
|
||||
> increasingly marginalized, expressions like "immorality" are still commonly used
|
||||
> to describe certain behaviors and individuals.
|
||||
>
|
||||
> *Issue:* The source gives two concrete colloquial expressions ("这人很有道德" /
|
||||
> "这么做太缺德了") — the target collapses them into a single abstract "expressions
|
||||
> like 'immorality'." The vividness and specificity are lost.
|
||||
|
||||
#### b. Over-literal translation, harming comprehension
|
||||
|
||||
> 作为素菜馆,应该尽量提供绿色食品。
|
||||
>
|
||||
> A vegetarian restaurant should strive to offer green food.
|
||||
>
|
||||
> *Issue:* 绿色食品 = "safe and healthy food" (Chinese idiom), not
|
||||
> "green food" (color of food in English). → `safe and healthy options`
|
||||
|
||||
#### c. Misunderstanding the source
|
||||
|
||||
> 政府现在倡导文化自信,习主席提出的"讲仁爱,重民本,守诚信,崇正义,尚和合,求大同"。
|
||||
>
|
||||
> President Xi Jinping has called for a confident embrace of Chinese culture,
|
||||
> highlighting virtues such as...
|
||||
>
|
||||
> *Issue:* Two different subjects: the government advocates cultural confidence;
|
||||
> Xi proposed the six virtues. The target merges both into Xi alone.
|
||||
|
||||
#### d. Wrong word choice causing misunderstanding
|
||||
|
||||
> 提供一些通俗易懂的法宝
|
||||
>
|
||||
> with easy Buddhist materials
|
||||
>
|
||||
> *Issue:* 通俗易懂 means "accessible to a general audience," not "easy/simple."
|
||||
> The Dharma can be accessible but is never "simple." → `accessible`
|
||||
|
||||
### 3. Overtranslation (多翻)
|
||||
|
||||
Adding parentheticals or expansions not in the source.
|
||||
|
||||
> 出家人不仅要对三宝、师长、道友建立没有染污的情感
|
||||
>
|
||||
> Monastics should cultivate pure and untainted emotions not only toward the Three
|
||||
> Jewels (the Buddha, the Dharma, the Sangha), their teachers (The Head Monk and
|
||||
> Abbot), and fellow practitioners...
|
||||
>
|
||||
> *Issue:* Parenthetical expansions like "(the Buddha, the Dharma, the Sangha)"
|
||||
> and "(The Head Monk and Abbot)" are not in the source and should be removed.
|
||||
|
||||
### 4. Terminology Errors
|
||||
|
||||
- 身心 → `body and heart mind` → should be `body and mind`
|
||||
- 甘露别院 → `Ganlu Bieyuan The Amrita Retreat Center` → official: `Amrita Retreat Center`
|
||||
- "六字" → `six characters` → should be `six words`
|
||||
|
||||
### 5. Detail-Level Issues
|
||||
|
||||
- Tone appropriateness
|
||||
- Citation source authority
|
||||
- CN→EN conversion rules: numerals, units, date formats
|
||||
- Proper noun handling: transliteration vs. translation
|
||||
|
||||
## Readability Issues
|
||||
|
||||
Standard: fluent sentences, graceful expression, matching target reader habits.
|
||||
"Conform to what foreign readers find readable."
|
||||
"Concise, clear, accurate, not draggy, meaning clear."
|
||||
|
||||
### 1. Redundancy & Wordiness
|
||||
|
||||
#### a. Long / nested sentences
|
||||
|
||||
Sentences with too many clauses that can't be read in one breath. Split them.
|
||||
|
||||
#### b. Passive voice overuse
|
||||
|
||||
> 如果对肉食消费得少,乃至完全不消费,那么从业者自然随之减少,很多动物就可以摆脱被屠宰、割截的厄运。
|
||||
>
|
||||
> If meat consumption were reduced, or even eliminated entirely, then the number of
|
||||
> businesses involved would naturally be lessened. This way, many animals could be
|
||||
> spared from the adversity of being slaughtered and butchered.
|
||||
>
|
||||
> *Issue:* Three passives in two sentences. Active rewrite is more concise:
|
||||
> *If people consume less meat — or none at all — fewer will work in the industry,
|
||||
> and many animals will be spared the fate of slaughter and dismemberment.*
|
||||
|
||||
#### c. Nominalization (动词名词化)
|
||||
|
||||
> 我们前期倡导的正念禅修,比较重视培养觉知。
|
||||
>
|
||||
> In the early stages of mindfulness practice, we placed greater emphasis on
|
||||
> cultivating awareness.
|
||||
>
|
||||
> *Issue:* "placed greater emphasis on" is nominalized. → `we emphasized`
|
||||
|
||||
### 2. Poor Structure (结构不当)
|
||||
|
||||
Top-heavy sentences — the main clause arrives too late.
|
||||
|
||||
> 没有如法的生活,不能严格要求自己,在今天这个红尘滚滚的时代,我们简直是没希望的。
|
||||
>
|
||||
> Weathering today's deluge of worldly temptation, without a Dharma-aligned lifestyle
|
||||
> and strict self-discipline, we have no hope.
|
||||
>
|
||||
> *Issue:* The condition clauses pile up before the main point. Restructure:
|
||||
> *Without a Dharma-aligned lifestyle and strict self-discipline, we have no hope
|
||||
> of weathering today's deluge of worldly temptations.*
|
||||
|
||||
### 3. Wrong Word Choice (用词不当)
|
||||
|
||||
> 当一个人开始关心生命的大问题时,对小问题自然云淡风轻。
|
||||
>
|
||||
> when we begin to contemplate the profound questions of existence, the banal
|
||||
> iterations of daily life lose their significance.
|
||||
>
|
||||
> *Issue:* "banal iterations" is obscure. Simplify.
|
||||
|
||||
### 4. Weak Flow & Transitions (流畅性 & 连接词)
|
||||
|
||||
> 修行的核心就是止恶行善。为什么某种行为能成为生命的主导?就是因为不断重复。
|
||||
>
|
||||
> The essence of cultivation lies in ceasing unwholesome actions and promoting
|
||||
> wholesome ones. But why do certain behaviors dominate our lives? Because of
|
||||
> constant repetition.
|
||||
>
|
||||
> *Issue:* Adding transition words improves flow. The "But" here creates a false
|
||||
> contrast — the second sentence is explanation, not counterpoint.
|
||||
|
||||
## Detection Checklist
|
||||
|
||||
When reviewing, run through:
|
||||
- [ ] Any missing content? (compare paragraph-by-paragraph)
|
||||
- [ ] Any added content? (parentheticals, expansions not in source)
|
||||
- [ ] Any over-literal renderings that don't work in English? (idioms, set phrases)
|
||||
- [ ] Any over-free renderings that lose specificity? (concrete examples → abstract)
|
||||
- [ ] Subject confusion? (two actors merged into one)
|
||||
- [ ] Buddhist terminology checked against terms DB?
|
||||
- [ ] Sentences too long to read in one breath? (split at natural breaks)
|
||||
- [ ] Passive voice clustering? (3+ in a paragraph)
|
||||
- [ ] Nominalized verbs? ("placed emphasis on" → "emphasized")
|
||||
- [ ] Top-heavy sentence structure? (main clause buried after long preamble)
|
||||
- [ ] Obscure word choices? (would a general reader understand?)
|
||||
- [ ] Missing or misleading transition words?
|
||||
@@ -0,0 +1,90 @@
|
||||
# Deliberation Protocol (审议规程)
|
||||
|
||||
From 东方译场审议手册 (Oriental Translation Review Manual, 2026-03-25).
|
||||
Guidance from Ven. Jiqun on translation review culture and process.
|
||||
|
||||
## Core Standards
|
||||
|
||||
1. **Accuracy (准确性)** — primary. Convey content-level meaning, not word-by-word
|
||||
correspondence. Deepen accuracy iteratively; grasp the "inner spirit" rather than
|
||||
fixating on literal vs free translation.
|
||||
|
||||
2. **Readability (可读性)** — secondary. Fluent sentences, graceful expression. Do
|
||||
not pursue endless revision; what is achievable now is the best for now.
|
||||
|
||||
**Test**: invite 5–10 readers to read aloud and give feedback — is it clear or
|
||||
obscure? Is it concise? Is the meaning clear?
|
||||
|
||||
## Decision-Making
|
||||
|
||||
When opinions differ:
|
||||
- Compare which version is more accurate and more readable
|
||||
- Do NOT cling to your own view (不执着于己见)
|
||||
- If two people cannot decide, invite 5–10 to read and vote
|
||||
- Remember: the translation is for the READERS, not for yourself
|
||||
|
||||
## Core Principle: Rejoice First (随喜)
|
||||
|
||||
Before flagging issues, affirm what is good. Professional translation companies
|
||||
emphasize positive feedback to build translator confidence and good collaboration.
|
||||
Criticism alone — however precise — breeds resistance and harms the final result.
|
||||
|
||||
In the Oriental Translation Workshop, rejoicing in others' merits cultivates
|
||||
sympathetic joy (随喜), compassion, selflessness, and boundless merit — while
|
||||
encouraging others' wholesome efforts.
|
||||
|
||||
**Practice**: develop eyes that SEE the merits in a translation. Rejoice with
|
||||
genuine gladness. Examples:
|
||||
- "So many technical terms and complex logic here — you handled it beautifully!"
|
||||
- "This word choice is exactly right."
|
||||
- "The prose is so clean and fluid!"
|
||||
- "Excellent!" / "Good word choice!"
|
||||
|
||||
## Three Principles for Giving Suggestions
|
||||
|
||||
1. **Lower the self** — use compassionate, gentle, skillful language
|
||||
2. **Be diligent and attentive** — find the actual problems
|
||||
3. **Tier your suggestions** — make clear what MUST change, what COULD improve,
|
||||
and what needs DISCUSSION
|
||||
|
||||
## Three-Tier Issue System
|
||||
|
||||
### Level 1: Spelling, Grammar, Format (拼写、语法、格式)
|
||||
|
||||
**Action**: fix directly, keep tracked changes visible.
|
||||
|
||||
May annotate for translator development:
|
||||
- "MPI format uses American English — `toward` not `towards`."
|
||||
- "Use `Chan` here, not `Zen`."
|
||||
- "MPI format does not use diacritics — `Yogacara` not `Yogācāra`."
|
||||
|
||||
### Level 2: Omission, Mistranslation, Wordiness, Tone, Word Choice
|
||||
(漏翻、错翻、啰嗦、语气问题、用词问题)
|
||||
|
||||
**Action**: preferably flag for translator to fix themselves; may also fix
|
||||
directly with tracked changes.
|
||||
|
||||
Suggested language:
|
||||
- "Did we miss something here?"
|
||||
- "This sentence is quite long — could we split it into 2–3?"
|
||||
- "The translation here differs from the original. It reads as if the teacher
|
||||
is saying X, but I think he means Y. What do you think?"
|
||||
- "This word feels a bit strong here — your thoughts?"
|
||||
- (After direct adjustment) "I tightened this sentence — does this work?"
|
||||
|
||||
### Level 3: Citation Versions, Slightly Awkward Wording, Marginal Readability
|
||||
(引用版本不当、用词稍微不当、阅读体验略差)
|
||||
|
||||
**Action**: flag and discuss with translator.
|
||||
|
||||
Suggested language:
|
||||
- "I found another citation version that may be more concise — which do you prefer?"
|
||||
- "Could we use this word instead? Might fit better."
|
||||
- "Could you take another look at this passage? I feel readability could improve
|
||||
but I'm not sure how — your thoughts?"
|
||||
|
||||
## Tone Guide
|
||||
|
||||
- Address the translator as 菩萨 (Bodhisattva) — respectful peer address
|
||||
- Use questions, not commands: "Could we...?" "What do you think?" "Would this work?"
|
||||
- Frame as collaborative inquiry, not correction
|
||||
+50
-18
@@ -10,25 +10,22 @@ terms DB query, workflows, output format) are in AGENTS.md.
|
||||
|
||||
## Mindfulness Bell Corpus
|
||||
|
||||
Register/style patterns in English Buddhist prose.
|
||||
English Buddhist prose — register/style reference for translation.
|
||||
|
||||
- Location: `/home/user/meta/www.files/public/The Mindfulness Bell/`
|
||||
- 6 issues: MB92–MB97 (2023–2026), each ~84–116 pages
|
||||
- Index: `index.yaml` (article titles, authors, pages)
|
||||
- **Articles**: `~/documents/jingxin-lessons/Mindfulness Bell/articles/MB{92..97}/*.md` — 93 individual markdown files with YAML frontmatter. Read directly with `read_file`.
|
||||
- Extraction script: `/tmp/extract_mb_articles.py` (re-run if PDFs change)
|
||||
- **PDFs + index**: `~/meta/www.files/public/The Mindfulness Bell/` — 6 issues (MB92–MB97, 2023–2026), `index.yaml` lists all articles by author/title/page
|
||||
- **Articles**: `~/documents/jingxin-lessons/Mindfulness Bell/MB{92..97}/*.md` — per-issue markdown files. Read with `read_file`.
|
||||
|
||||
## Register Reference
|
||||
|
||||
Four registers observed, useful as style targets:
|
||||
Four registers, useful as style targets:
|
||||
|
||||
| Register | Example | Key features |
|
||||
|----------|---------|-------------|
|
||||
| Dharma talk | Thầy (MB94 "Roses and Garbage", MB97 "Go as a River") | Short sentences, concrete images, coined terms ("interbeing"), oral address ("It's clear?"), Sanskrit kept with narrative explanation |
|
||||
| Teaching lineage | Sister Đoan Nghiêm (MB93 "Our Patriarch Liễu Quán") | "We" voice, terms explained, cultural bridging ("like Jesus"), dates woven into narrative, still oral |
|
||||
| Personal narrative | Mick McEvoy (MB94 "Touching the True Nature") | First-person, confessional, borrowed Dharma vocabulary, emotional directness, vernacular |
|
||||
| Dharma talk | Thầy (MB94 "Roses and Garbage", MB97 "Go as a River") | Short sentences, concrete images, coined terms ("interbeing"), oral address, Sanskrit with narrative explanation |
|
||||
| Teaching lineage | Sister Đoan Nghiêm (MB93 "Our Patriarch Liễu Quán") | "We" voice, terms explained, cultural bridging ("like Jesus"), dates in narrative |
|
||||
| Personal narrative | Mick McEvoy (MB94 "Touching the True Nature") | First-person, confessional, borrowed Dharma vocabulary, vernacular |
|
||||
| Editorial | Brother Pháp Lưu (MB94 welcome letter) | Polished but warm, conceptual framing, "we" address |
|
||||
|
||||
Quick-find in index: Thầy talks → `"Thích Nhất Hạnh"` + page ≤ 10; teachings → `"Sister"` or `"Brother"`; narratives → first-page articles by non-monastics; lineage → `"Patriarch"` or `"ancestor"`.
|
||||
|
||||
## Translation Principles
|
||||
|
||||
1. **Terms**: Either keep Sanskrit w/ narrative explanation (bodhisattva, Māra) OR coin new English (interbeing, inter-are). Avoid clunky calques.
|
||||
@@ -39,6 +36,16 @@ Four registers observed, useful as style targets:
|
||||
|
||||
## Pitfalls
|
||||
|
||||
### Pre-flight accuracy check
|
||||
|
||||
Before delivering a translation, run through the structured accuracy/readability
|
||||
taxonomy in `skills/translation-review/references/common-issues-taxonomy.md`.
|
||||
Catching these before review saves iteration cycles:
|
||||
- Omission, over-literal renderings, over-free renderings, subject confusion,
|
||||
overtranslation, terminology errors
|
||||
- Long/nested sentences, passive voice clustering, nominalization, top-heavy
|
||||
structure, obscure word choices, weak transitions
|
||||
|
||||
### 1:1 line mapping
|
||||
|
||||
Each physical source line maps to exactly one physical target line. Never merge
|
||||
@@ -79,13 +86,37 @@ opinion they haven't voiced yet. Once they pick, then apply consistently and
|
||||
annotate in the inline `{% %}` comment WHY this rendering was chosen so future
|
||||
editors know it was deliberate, not a slip.
|
||||
|
||||
## Quick-Find in MB Corpus
|
||||
## Polishing (润色)
|
||||
|
||||
Common article types to search for register examples:
|
||||
- Thầy's Dharma talks: search index for "Thích Nhất Hạnh" + page ≤ 10
|
||||
- Sister/brother teachings: search for "Sister" or "Brother" + "DHARMA TEACHING"
|
||||
- Personal narratives: first-person voice, often pages 8–60
|
||||
- Lineage/history: "Patriarch," "ancestor," dates in text
|
||||
After translating, do a deliberate readability pass before submitting for review.
|
||||
Read the English aloud — if a sentence can't be spoken in one breath, fix it.
|
||||
|
||||
These are common patterns (not an exhaustive list). For the full taxonomy with
|
||||
more categories and examples, read
|
||||
`../translation-review/references/common-issues-taxonomy.md`.
|
||||
|
||||
Examples of systematic adjustments:
|
||||
|
||||
1. **Passive → active**. Passive clusters (3+ per paragraph) are the top
|
||||
readability killer in CN→EN translation. `If meat consumption were reduced`
|
||||
→ `If people consume less meat`.
|
||||
2. **Nominalization → verb**. `placed emphasis on cultivating` → `emphasized
|
||||
cultivating`; `the application of` → `applying`.
|
||||
3. **Sentence splitting**. If a sentence has 3+ clauses and runs past one breath,
|
||||
split it. The source's period is not a contract — English readers need
|
||||
shorter breath units than Chinese readers.
|
||||
4. **Academic → plain**. `constitute` → `make up`; `facilitate` → `help`;
|
||||
`endeavor to` → `try to`; `in order to` → `to`. These texts are lectures
|
||||
and conversations, not journal articles.
|
||||
5. **Register match**. Dharma talks and dialogues should sound spoken —
|
||||
contractions, direct address, concrete images. If the English reads like a
|
||||
paper abstract, warm it up. Check against the MB corpus registers for the
|
||||
target genre.
|
||||
|
||||
Do NOT apply these mechanically — each is a judgment call. A passive may be
|
||||
correct when the agent is unknown; a nominalization may be the right technical
|
||||
term. The goal is natural English that matches the source's register, not a
|
||||
formulaic rewrite.
|
||||
|
||||
## Meditation / Mindfulness Content
|
||||
|
||||
@@ -98,3 +129,4 @@ When translating guided meditation scripts, exercise guides, or posture instruct
|
||||
- `references/markdown-to-djot.md` — converting .docx.md to .dj for translation prep
|
||||
- `references/bilingual-format.md` — bilingual.dj layout: source/target adjacent, blank separator between pairs
|
||||
- `references/diacritics-convention.md` — diacritics rules
|
||||
- `../translation-review/references/common-issues-taxonomy.md` (cross-skill) — structured accuracy/readability checklist for pre-flight review
|
||||
|
||||
Reference in New Issue
Block a user