Translation Remarks
Terminology is a contract: one concept keeps one word on every screen and in every locale. Five
locales ship together — en, zh-Hant, zh-Hans, vi and ja — and the English bundle is the
schema the other four are typed against, so a key missing from any of them is a type error under
npm run lint and a lint finding that stops npm run build. The readings below are the ones the
zh-Hant bundle ships. The vi and ja readings are not listed here; the i18n folder's README gives
the Vietnamese and the Japanese of the terms its vocabulary table rules on.
Tool House and Mechanism Terms
Anchor 錨點
Tool 刀具
Cutter 刀具本體
- Insert-End Cutter 刀片式刀具本體
Holder 刀把
- Cylindroid Holder 柱狀刀把
- Freeform Holder 任意形刀把
Shank 刀柄
Fixture 夾具
Clamping 夾持
- Setup Angle 安裝角
Milling Cutter 銑刀
Freeform Remover 任意移除工具
Flute 刀刃
- Flute Profile 刃包絡形
- Flute Contours 刃雕
- Baseline Contour 基準刃雕
- Side Contour 側向刃雕
- Bottom Contour 底部刃雕
- Flute Offset Angle 刃偏移角
Upper Beam 夾持柱
Inner Beam 刃中芯
Integral Mode 刀頭形式
- Solid End 一體式
- Insert End 刀片式
Preset 預設
- Datum Preset 基準點預設
General Config 一般組態 — the mission tree's label for the
presettingcommand kindMeshed Geometry 網格幾何
Machining Resolution 加工解析度
NC Terms
The NC words the Block Info panel uses are the words on every screen and in the engine messages, and the coordinate system the step fields name keeps one name wherever a field or a chart shows it:
- Work Coordinates 工件座標系 — the G54… table and its node, 工件座標系 (G54…)
- Subprogram 副程式
- Tool ID 刀號
- Word 字語 — an address letter with its value (
T1,H01,D2), after a letter or an axis too: T 字語, 軸字語 - Tool Running Coordinate 刀具行進座標系 — with its 系;
TRin the step fields' short names
Words That Carry More Than One Sense
Contour is the sharpest case: in the cutter namespace it is 刃雕 (Flute Contours 刃雕, Baseline
Contour 基準刃雕), and in the spindle-capability namespace it is 等值線 (Power Contours 功率等值線,
Torque Contours 扭矩等值線). Each sense keeps its own entry rather than one compromise word.
Setup Angle 安裝角 belongs to the clamping: how far the cutter is turned in the holder about the
tool axis, and it lives on the tool's Clamping node. Where a flute sits on the cutter body is a
different sense with its own word — the flute-contour field Flute Offset Angle 刃偏移角 — and 安裝角
is never written on that field: a cutter's flute offset angles travel with its design, while its
setup angle changes every time it is re-clamped.
Fluting is a cutter's whole set of flute contours — one shared baseline or one per flute — and
translates as 刃雕構型: Uniform Fluting 對稱刃雕構型, Free Fluting 自由刃雕構型.
Program is the UI-layer word and does translate: 程式 in zh-Hant, 程序 in zh-Hans. Control in
the frontend names the Control Tree UI, 控制樹, and never takes 程式.
Select is two words in zh-Hant, judged by sense. Selecting a thing on the screen, and the state it
leaves, is 選取 (選取一步, 未選取步, 已選取:…); choosing one of several options — a type, a file, a
property — is 選擇. The same English word takes either: the editor column's hint, Select an item in
the Control Tree to edit it here, reads 選取, while the file dialog's Select button, which
chooses a file, reads 選擇. An NC selection picks an option and keeps 選擇 (平面選擇), as M01's 選擇性停止 does.
A Deflection, the tool bending under its load, is 撓曲 — the step fields' 底刃撓曲, 最大刀尖撓曲 and
刀尖撓曲變動幅度 — and a Deviation, such as the geometry difference between the machined workpiece and
the ideal one, is 偏差. A deflection is never written 偏差.
The Tool House is 刀具庫, the product's library of tools. A machine's tool magazine, the rack its tool
changer takes from, is another thing and keeps 刀庫.
Rapid, a G00 move, is 快移; the Rapid Feedrate a controller table or the NC optimization settings
hold is 快速進給率. Cutter Radius Compensation (G41 / G42, RL / RR) is 刀具半徑補正, never a bare
半徑補正 nor 刀徑補正; the Compensation Radius it applies is 補正半徑, a quantity of the function rather
than the function.
Never Translate
HiNC · hincproj · SoftNc · MachiningStep · brand names (Fanuc, Heidenhain, Mazak, Siemens,
Syntec) · NC codes (G54, M128, CYCLE800, TRAORI, RTCP, TCPM) · file extensions and
MIME-ish strings (STL, *.hincproj) · units (mm, rpm, mm/min, N, Nm, kW, KB, MB,
GB) · the keyboard shortcuts embedded in tooltip sentences · route names, enum keys,
localStorage keys and series identifiers — anything a machine compares. Language self-names
(English, 简体中文, 繁體中文, Tiếng Việt, 日本語) stay in their own language in every locale. The full list
lives with the bundles, in the i18n folder's README.
A Choice That Carries No Label
The cutter's integral mode reaches the web application as the integralMode datum rather than as a
named field: it decides whether the Tool House material section offers a separate shank material,
and shows no label of its own. A term with no visible string is still part of the contract — it has
to be settled before anything renders a value derived from it.
Source Code Path
See HiNC App Anatomy for git repository links.
wwwroot-src/src/i18n/en/toolhouse.tsandwwwroot-src/src/i18n/zh-Hant/toolhouse.ts— the Tool House control-tree node names and editor labels: Cutter, Holder, Flute Profile, Flute Contours, Upper Beam, Inner Beam, and the cutter and holder types.wwwroot-src/src/i18n/en/mech.tsandwwwroot-src/src/i18n/zh-Hant/mech.ts— the Equipment page's rendering flags and the anchor labels.wwwroot-src/src/i18n/en/tree.tsandwwwroot-src/src/i18n/zh-Hant/tree.ts— the shared control-tree node names and the mission command kinds.wwwroot-src/src/i18n/zh-Hant/mission.ts— the PreSetting command fields, including Machining Resolution and the meshed-geometry file picker.wwwroot-src/src/i18n/zh-Hant/softNc.ts— the runner's Datum Preset and Datum Shift rows and the datum table behind them.wwwroot-src/src/i18n/zh-Hant/execution.ts— the Execution rendering flags, where Meshed Geometry and Fixture appear together, and the Block Info panel's rows: Tool ID, cutter radius compensation, work coordinates, a rapid move and the subprogram level.wwwroot-src/src/i18n/zh-Hant/engineMessages.ts— the engine messages, which write the NC word, the subprogram, the cutter radius compensation and its compensation radius in the same words.wwwroot-src/src/i18n/zh-Hant/explorer.ts— the file dialog, whose Select button chooses a file and whose selection state is 已選取 / 未選取.wwwroot-src/src/i18n/index.ts—createI18n(),applyLocale()andSUPPORTED_LOCALES, the only place a locale switch happens.wwwroot-src/src/i18n/schema.ts— the English bundle as the schema that types the other four.wwwroot-src/src/i18n/glossary.yaml— the term list, never imported by the application: Chinese values harvested from the legacy corpus by.ai/harvest-i18n.pywith an adjudicated head term per concept, the rulings held in the script's tables rather than in the file — a harvest since retired, which needs the legacy repositories cloned back to run again; the step-field entries and the Vietnamese and Japanese values, kept in the file by hand; and the source the server's step-field catalogsStepPresentCatalog/catalog.{zh-Hant,zh-Hans,vi,ja}.jsonare generated from (harvest-i18n.py --present-catalog), so a step-field name is changed here, not in a catalog.scripts/lint-glossary.mjs— the per-locale tables of the forms a bundle or a step-field catalog may not carry; the zh-Hant table names the word that replaces each, among them 字語 for 字組 and a bare 軸字, 撓曲 for 刀尖偏差 / 底刃偏差, 刀具庫 for 刀庫, 已選取 / 未選取 for 已選擇 / 未選擇, and 降伏 for 屈服, the zh-Hans word for yielding.
See Also
- Language Selection SubMenu — the sub-menu that switches the locale these terms are written for
- Internationalization — the bundle layout these terms are written into, and the lint that holds them to it