# قالب جدول التوطين

جدول نصوص يستطيع المترجمون العمل عليه: صف لكل مفتاح، مع سياقه وحد طوله والنص الإنجليزي المصدر وأربع ترجمات، ومعه مسرد ودليل أسلوب لكل لغة. نزّله ملف .zip: الجدول ملف CSV (بترميز UTF-8 وقيم مفصولة بفواصل)، والباقي بصيغة Markdown، وتُستورد المجموعة كلها إلى Nodary حيث يصبح ملف CSV ورقة يمكنك استخدامها جدول ترجمة.

مجاني، بلا حساب وبلا بريد إلكتروني. استخدمه وعدّله وشاركه.

[نزّل القالب (.zip)](https://nodary.ai/downloads/qalib-jadwal-altawtin.zip)

## اقرأ كل ملف قبل التنزيل

تشرح النظرة العامة الأعمدة، وطريقة تسمية المفاتيح، والعناصر النائبة، وحالات الترجمة. ويضم الجدول 13 نصًا نموذجيًا من Saltmarrow، اللعبة النموذجية التي يستخدمها هذا الموقع في كل مكان؛ وفيه خليتان خاطئتان عمدًا لتُظهرا ما تكشفه عمليات التحقق.

- جدول التوطين: كيف يعمل الجدول: الأعمدة، وتسمية المفاتيح، والعناصر النائبة، وحالات الترجمة، والملفات المجاورة.
- النصوص: الجدول: صف لكل نص، مع سياقه وحد طوله، والمصدر الإنجليزي وأربع ترجمات.
- المسرد: الكلمات التي تُترجم بطريقة واحدة في كل مكان، والأسماء التي لا تُترجم أبدًا.
- دليل الأسلوب: كيف تتكلم اللعبة في كل لغة: صوتها، وكيف تخاطب اللاعب، والطباعة، والطول، وصيغ الجمع.

### جدول التوطين

_طريقة الاستخدام: الأسطر المائلة إرشادات. استبدلها بكلماتك ثم احذفها. القيم بين الأقواس المربعة تملؤها أنت. والجدول نفسه هو ملف CSV المجاور لهذه الصفحة._

#### الملفات

- [النصوص](https://nodary.ai/ar/templates/localization-string-table#doc-strings): الجدول نفسه، صف لكل نص وعمود لكل لغة
- [المسرد](https://nodary.ai/ar/templates/localization-string-table#doc-glossary): الكلمات التي تُترجم بالطريقة نفسها في كل مكان، والأسماء التي لا تُترجم أبدًا
- [دليل الأسلوب](https://nodary.ai/ar/templates/localization-string-table#doc-style): كيف تتكلم اللعبة في كل لغة

#### الأعمدة

| العمود | ما يحويه |
| --- | --- |
| key | اسم فريد للنص، لا يُعرض على اللاعبين أبدًا |
| context | أين يظهر النص ومن يقوله: ما لا يستطيع المترجم تخمينه |
| max_length | أقصى عدد من الحروف يشغله النص على الشاشة |
| en | النص المصدر |
| fr, de, es, pl | عمود لكل لغة، اسمه رمز اللغة |

#### تسمية المفاتيح

_سمِّ المفاتيح حسب مكان النص، من العام إلى الخاص، كي تتجاور النصوص المترابطة عند الترتيب._

- النمط: [الشاشة].[العنصر].[التفصيل]، مثل menu.play أو hud.tide.warning
- حروف صغيرة، ونقاط بين الأجزاء، وبلا مسافات
- لا تُعِد استخدام مفتاح لنص مختلف: أضف مفتاحًا جديدًا

#### العناصر النائبة والوسوم

_القيم التي تملؤها اللعبة تبقى بين قوسين معقوصين، مثل {count}؛ وتحتفظ كل ترجمة بكل عنصر نائب في مصدرها. ووسوم التنسيق، مثل وسم الخط العريض في item.crystal.desc، تبقى حول الكلمات التي تَسِمها._

#### حالات الترجمة

```mermaid
flowchart LR
  n0["مفقودة"]
  n1["مسودة"]
  n2["مراجَعة"]
  n3["نهائية"]
  n4["قديمة"]
  n0 --> n1
  n1 --> n2
  n2 --> n3
  n3 --> n4
  n4 --> n1
```
_حالة الترجمة: تغيّر المصدر يجعلها قديمة، فيُعاد التحقق منها_

_مثال (Saltmarrow، لعبة نموذجية): في المثال خليتان خاطئتان عمدًا. ترجمة menu.settings الألمانية، Einstellungen، فيها 13 حرفًا والزر يتسع لعشرة، فيرفع فحص الطول تنبيهًا عليها؛ وتحية أمين الأرشيف لا ترجمة بولندية لها بعد، فتُعد مفقودة._

_هذا القالب حر الاستخدام والتعديل والمشاركة. وهو من_ [Nodary](https://nodary.ai/ar)_، حيث تُستورد هذه الملفات خريطةً من المستندات المترابطة، وملف CSV ورقةً._

### النصوص

| key | context | max_length | en | fr | de | es | pl |
| --- | --- | --- | --- | --- | --- | --- | --- |
| menu.play | زر في القائمة الرئيسية | 12 | Play | Jouer | Spielen | Jugar | Graj |
| menu.settings | زر في القائمة الرئيسية؛ يتسع الزر لعشرة حروف | 10 | Settings | Paramètres | Einstellungen | Ajustes | Ustawienia |
| menu.quit | زر في القائمة الرئيسية | 12 | Quit | Quitter | Beenden | Salir | Wyjdź |
| hud.tide.warning | يظهر في واجهة اللعب قبل انقلاب المد بدقيقتين؛ {minutes} عدد | 40 | The tide turns in {minutes} min | La marée tourne dans {minutes} min | Gezeitenwechsel in {minutes} Min. | La marea cambia en {minutes} min | Zmiana pływu za {minutes} min |
| hud.salt.count | عدّاد في واجهة اللعب؛ {count} عدد | 20 | Salt: {count} | Sel : {count} | Salz: {count} | Sal: {count} | Sól: {count} |
| dialogue.archivist.greet | أمين الأرشيف الغريق، اللقاء الأول. هادئ ورسمي: يخاطب اللاعب بصيغة الاحترام | 120 | You came down with the tide. Most who do, stay. | Vous êtes descendu avec la marée. La plupart de ceux qui le font restent. | Sie sind mit der Flut herabgestiegen. Die meisten, die das tun, bleiben. | Ha bajado con la marea. La mayoría de quienes lo hacen se quedan. |  |
| item.crystal.name | اسم الغرض، في الحقيبة وفي المتجر | 24 | Memory crystal | Cristal de mémoire | Erinnerungskristall | Cristal de memoria | Kryształ pamięci |
| item.crystal.desc | وصف الغرض؛ <b> يحدد الكلمة المطلوب إبرازها | 140 | Holds one <b>memory</b> of the drowned city. Sells well in the village. | Contient un <b>souvenir</b> de la cité engloutie. Se vend bien au village. | Enthält eine <b>Erinnerung</b> an die versunkene Stadt. Verkauft sich gut im Dorf. | Guarda un <b>recuerdo</b> de la ciudad sumergida. Se vende bien en el pueblo. | Zawiera jedno <b>wspomnienie</b> zatopionego miasta. Dobrze się sprzedaje w wiosce. |
| quest.horn.title | عنوان المهمة في السجل | 32 | Before the horn | Avant la corne | Vor dem Horn | Antes del cuerno | Zanim zabrzmi róg |
| quest.horn.goal | هدف المهمة في السجل؛ {count} عدد | 60 | Crystals to bring up before the horn: {count} | Cristaux à remonter avant la corne : {count} | Kristalle, die vor dem Horn nach oben müssen: {count} | Cristales que subir antes del cuerno: {count} | Kryształy do wyniesienia, zanim zabrzmi róg: {count} |
| ui.save.done | رسالة بعد الحفظ، تظهر لثانيتين | 40 | Game saved | Partie sauvegardée | Spiel gespeichert | Partida guardada | Gra zapisana |
| ui.tide.low | تسمية مؤشر المد | 16 | Low tide | Marée basse | Ebbe | Marea baja | Odpływ |
| ui.tide.high | تسمية مؤشر المد | 16 | High tide | Marée haute | Flut | Marea alta | Przypływ |

### المسرد

**المسؤول:** [الاسم] · **الحالة:** مسودة · **آخر مراجعة:** [التاريخ]

_أضف مصطلحًا في أول مرة يسأل عنه مترجم. الكلمة المترجمة بطريقتين تربك اللاعبين وتضاعف أسئلة الدعم._

#### المصطلحات

| المصطلح (en) | fr | de | es | pl | ملاحظات |
| --- | --- | --- | --- | --- | --- |
| tide | marée | Gezeiten | marea | pływ | منسوب الماء الذي يحرك كل الأنظمة |
| salt | sel | Salz | sal | sól | المورد الشائع |
| memory crystal | cristal de mémoire | Erinnerungskristall | cristal de memoria | kryształ pamięci | الاسم الكامل دائمًا، وليس «بلورة» وحدها في المتجر أبدًا |
| horn | corne | Horn | cuerno | róg | الإشارة قبل انقلاب المد بدقيقتين |
| [مصطلح] | [...] | [...] | [...] | [...] | [...] |

#### لا يُترجم أبدًا

- Saltmarrow، اسم اللعبة
- [أسماء الشخصيات والأماكن التي تبقى كما هي]
- [أسماء المنصات والعلامات التجارية]

مستندات ذات صلة: [جدول التوطين](https://nodary.ai/ar/templates/localization-string-table#doc-overview) · [النصوص](https://nodary.ai/ar/templates/localization-string-table#doc-strings) · [دليل الأسلوب](https://nodary.ai/ar/templates/localization-string-table#doc-style)

### دليل الأسلوب

**المسؤول:** [الاسم] · **الحالة:** مسودة · **آخر مراجعة:** [التاريخ]

#### الصوت

_ثلاث كلمات تصف صوت اللعبة، وما لا تبدو عليه أبدًا._

- الصوت: [...]
- أبدًا: [...]

_مثال (Saltmarrow، لعبة نموذجية): هادئ وعتيق قليلًا، كصوت حارس أرشيف. جمل قصيرة. بلا عامية حديثة._

#### لغةً لغة

| اللغة | مخاطبة اللاعب | الطباعة | ملاحظات |
| --- | --- | --- | --- |
| الفرنسية (fr) | [tu أو vous] | مسافة غير منكسرة قبل : ; ! ? وداخل « » | [...] |
| الألمانية (de) | [du أو Sie] | „علامات تنصيص“، والأسماء بحرف كبير | غالبًا أطول من الإنجليزية: تحقق من max_length أولًا |
| الإسبانية (es) | [tú أو usted] | علامتا ¿ و¡ في البداية | [...] |
| البولندية (pl) | [ty، أو Pan وPani] | „علامات تنصيص”، وثلاث صيغ للجمع | تتغير الكلمات حول اسم اللاعب بحسب الجنس |
| [اللغة] | [...] | [...] | [...] |

#### الطول

_اترك مساحة: الترجمات عن الإنجليزية أطول غالبًا، حتى الثلث في بعض اللغات. حدّد max_length من المساحة على الشاشة، لا من النص الإنجليزي._

#### الجمع والأعداد

_تعدّ اللغات بطرق مختلفة: للبولندية ثلاث صيغ جمع وللإنجليزية صيغتان. ضع العدد بعد تسمية (الملح: {count}) أو استخدم نظام الجمع في محرك لعبتك، ونسّق الأعداد والتواريخ لكل لغة._

مستندات ذات صلة: [جدول التوطين](https://nodary.ai/ar/templates/localization-string-table#doc-overview) · [المسرد](https://nodary.ai/ar/templates/localization-string-table#doc-glossary) · [النصوص](https://nodary.ai/ar/templates/localization-string-table#doc-strings)

## كيف تستخدمه

### استبدل النصوص النموذجية

أبقِ الأعمدة وطريقة تسمية المفاتيح، وضع نصوصك. أعطِ كل نص سياقًا وحدًا للطول قبل أن يذهب إلى مترجم.

### اكتب المسرد مبكرًا

أضف كل مصطلح في أول مرة يسأل عنه مترجم، مع ترجمته في كل لغة. الكلمة المترجمة بطريقتين تربك اللاعبين وتضاعف أسئلة الدعم.

### اتفقوا على أسلوب كل لغة

قرّروا قبل بدء الترجمة كيف تخاطب كل لغة اللاعب وما قواعدها في الطباعة. وتغيير ذلك لاحقًا يعني إعادة قراءة كل نص.

### جمّد المصدر قبل إرساله

أرسل النصوص للترجمة حين تصبح صيغتها الإنجليزية نهائية. وإذا تغيّر مصدر بعد ذلك، وجب التحقق من ترجماته من جديد.

## استورده إلى Nodary واستخدمه جدول ترجمة

Nodary مساحة عمل مبنية للذكاء الاصطناعي، تترابط فيها مستندات الفريق بدل أن تتكدس. استورد ملف .zip فيصل ملف CSV ورقةً تحت النظرة العامة، والمسرد ودليل الأسلوب بجانبها. وعلى الورقة يقرأ «جدول الترجمة» الأدوار من رؤوس الأعمدة (key وcontext وmax_length وعمود لكل لغة)، ثم يتحقق من طول كل ترجمة ومن عناصرها النائبة، ويعطي كل ترجمة حالتها، ويَسِم الترجمة بأنها قديمة حين يتغير مصدرها، ويصدّر ملفات لـ Unity وUnreal وGodot: CSV وJSON وgettext .po وXLIFF.

1. افتح خريطة مشروع واختر «استيراد».
2. اختر تبويب «مجلد أو ZIP»، ثم «اختيار ملف ZIP»، وحدّد الملف واستورد.
3. افتح «النصوص»، واختر «جدول الترجمة»، وتحقق من الأدوار المقروءة من رؤوس الأعمدة، ثم اختر «استخدام كجدول ترجمة».

تتسع الخطة المجانية لعشرة مستندات في كل مساحة عمل، بما فيها صفحة المشروع نفسه: وتتسع ملفات القالب الأربعة بسهولة. عمود المصدر هو الإنجليزية: إن كانت لعبتك مكتوبة بلغة أخرى، فاجعل ذلك العمود هو المصدر حين يعرض Nodary الأدوار.

## الحفاظ على جدول نصوص يستطيع المترجمون العمل عليه

يفشل جدول النصوص حين يضطر المترجمون إلى تخمين معنى سطر أو المساحة المتاحة له، أو حين يتغير نص بعد ترجمته ولا يلاحظ أحد. وهذه العادات تمنع الحالات الثلاث.

### أعطِ كل نص سياقًا

من يقوله، وأين يظهر، وعلامَ يرد. كلمة «Open» فعل على باب وصفة على متجر: والسياق وحده يحسم.

### حدّد الطول من الشاشة

قِس عدد الحروف التي يتسع لها الزر أو السطر أو فقاعة الحوار، واكتب ذلك الحد، لا طول النص الإنجليزي.

### لا تبنِ الجمل من قطع

لصق «وجدتَ» و«3 بلورات» في الشيفرة يكسر ترتيب الكلمات والقواعد في معظم اللغات. أعطِ كل جملة مفتاحها الخاص، مع عناصر نائبة.

### حافظ على العناصر النائبة كاملة

تحتفظ كل ترجمة بكل {عنصر نائب} وكل وسم في مصدرها. وضياع {count} يُري اللاعبين فراغًا، أو يُسقط اللعبة.

### مفتاح واحد لمعنى واحد

لا تُعِد استخدام مفتاح لنص مختلف. أضف مفتاحًا جديدًا، واحذف القديم حين لا يعود شيء يستخدمه.

### جمّد المصدر قبل إرساله

ترجم نصًا نهائيًا. وإذا تغيّر مصدر رغم ذلك، فَسِم ترجماته بأنها قديمة كي يُعاد التحقق منها.

## أسئلة عن جداول التوطين

### ما جدول التوطين؟

جدول النصوص يحوي كل نص تعرضه اللعبة، صفًا لكل نص: مفتاح تستخدمه الشيفرة، والنص المصدر، وملاحظات للمترجمين، وحد للطول، وعمود لكل لغة. وتحمّل اللعبة النص بمفتاحه بلغة اللاعب، فيمكن تغيير النص وترجمته دون لمس الشيفرة.

### ما الأعمدة التي يحتاجها جدول النصوص؟

على الأقل المفتاح والنص المصدر، ثم عمود لكل لغة. ويوفّر عمود السياق وعمود الطول الأقصى معظم الأسئلة التي كان المترجمون سيطرحونها. وفي هذا القالب الأنواع الخمسة كلها، بالإنجليزية مصدرًا ومعها الفرنسية والألمانية والإسبانية والبولندية.

### كيف أسمّي مفاتيح النصوص؟

حسب مكان النص، من العام إلى الخاص، مثل menu.play أو hud.tide.warning: بحروف صغيرة ونقاط بين الأجزاء. فتتجاور النصوص المترابطة عند الترتيب، ويدل المفتاح على مكان البحث في اللعبة.

### كيف أتعامل مع صيغ الجمع؟

تعدّ اللغات بطرق مختلفة: للإنجليزية صيغتان، وللبولندية ثلاث، وللعربية ست فئات بين المفرد والمثنى والجمع. إما أن تضع العدد بعد تسمية، مثل «الملح: {count}»، وإما أن تستخدم نظام الجمع في محرك لعبتك مع نص لكل صيغة.

### كيف أفتح ملف CSV في Excel؟

تفتحه Google Sheets وLibreOffice Calc وNumbers وNodary كما هو. أما Excel فلا يفتحه بنقرة مزدوجة إلا إذا كان فاصل القوائم في إعدادات الحاسوب فاصلة؛ وإن كان فاصلة منقوطة، كما في الإعدادات الفرنسية أو الألمانية، فإن كل صف يقع في عمود واحد. عندها استورد الملف: من تبويب «البيانات» اختر الاستيراد من نص/CSV، وحدّد الملف، واضبط أصل الملف على UTF-8 والمحدِّد على الفاصلة، ثم حمّله.

### هل تقرأ Unity أو Unreal أو Godot ملف CSV هذا؟

ملف CSV في القالب مصنوع لبرامج الجداول ولاستيراد Nodary. ولكل محرك صيغته: فمن الجدول نفسه يصدّر جدول الترجمة في Nodary ملف CSV لـ Godot وUnity، وgettext .po لـ Unreal وGodot، وJSON لمعظم المحركات، وXLIFF لأدوات الترجمة.

### هل أستطيع إضافة لغات؟

نعم. أضف عمودًا اسمه رمز اللغة، مثل ar أو pt-BR. ويتعرّف Nodary على الرموز وأسماء اللغات في رؤوس الأعمدة، ويستطيع جدول الترجمة فيه أيضًا إضافة عمود للغة.

الصفحة: https://nodary.ai/ar/templates/localization-string-table