View source for Translating Gramps/he

<div dir="rtl" lang="he" class="mw-content-rtl">
{{languages/he|Translating Gramps}}

עמוד זה יעסוק במספר מונחי יסוד מקובלים ועצות לכול מי שחפץ לתרגם את רכיבי תוכנת גרמפס השונים לשפה העברית או כל שפה אחרת.
למרבה הצער אין 'מקום' אחד בגרמפס שלשם מתנקזים כל מחרוזות המלל שדרושות תרגום, הסיבה לכך נעוצה בעובדה שחקר־היוחסין תלוי במשתנים רבים כמו, סביבה, שפה, תרבות, מסורת, חברה, תקופה (זו כנראה בהחלט רשימה חלקית), נבחן לדוגמה את סוגיית לוח־השנה; ובכן, גם מאלו יש למכביר (סיני, ערבי, גרגוריאני, עברי, יוליאני...) ואם לא די בכך, הם גם משתנים כתלות בשפה (שמות החגים היהודיים נשמעים ונכתבים בעברית באופן שונה מאשר בכל שפה אחרת) ומכן נובע ההכרך לתרגם גם את לוחות השנה השונים למספר שפות.
דומה הדבר בסוגיית יחסי־קירבה, גם במקרה זה ל'דודן מדרגה שלישית' קיים כינוי שונה בכל שפה או שלא קיים כלל.
<br />להלן מספר עמודים לקריאה נוספת:
* העמוד [[Coding_for_translation|קידוד  עבור תרגום]] עשוי לעניין גם מתרגמים.
* [[A Translators Guide to Git|מדריך GIT למתרגמים]]

== תסדיר קובץ Gettext ==

===כותרת===

''msginit'' הוא כלי שירות של GNU, שקורא ספריית /po, ומייצר כותרת לתבנית קובץ gettext:
<br>
<div dir="ltr">
'''gramps.pot'''.
<br>
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2004-12-30 10:52-0500\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=CHARSET\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
</div>

* ''Project-Id-Version'': שם וגרסת החבילה. יש להשלימו אם הוא עדיין לא אוכלס על ידי xgettext.
* ''Report-Msgid-Bugs-To'' :  כבר מאוכלס על ידי xgettext. מכיל כתובת דוא"ל או כתובת אתר שבה ניתן לדווח על תקלים במחרוזות המקור (שלא נועדו לתרגום):
** מחרוזות שאינן משפטים שלמים, נא לעיין בהנחיות המתחזק  – הכנת מחרוזות.
** מחרוזות בהן  נעשה שימוש במונחים לא ברורים או שדורשות הקשר נוסף כדי להבינן.
** מחרוזות המניחות הנחות לא תקניות לגבי סימון תאריך, שעה או כסף.
** בעיות צורת רבים (ריבוי).
** איות שגוי באנגלית.
** תסדיר שגוי.
* ''POT-Creation-Date'': אוכלס על ידי xgettext.
* ''PO-Revision-Date'': יש למלא זאת. יאוכלס על ידי עורך קובץ ה־PO בעת שמירת הקובץ.
* ''Last-Translator'': שם וכתובת הדוא"ל של המתרגם (ללא מרכאות כפולות).
* ''Language-Team'':שם השפה באנגלית וכתובת הדוא"ל או כתובת אתר עמוד הבית של צוות השפה בו אתם משתתפים. 
לפני שמתחילים בתרגום, כדאי ליצור קשר עם צוות התרגום, לא רק כדי לוודא שלא נעשית עבודה כפולה, אלא גם כדי לתאם נושאים לשוניים סבוכים. במיזמי תרגום חופשיים, לכול צוות תרגום רשימת תפוצה משלו משלו. ניתן למצוא את רשימת הצוותים המעודכנת בעמוד [http://translationproject.org/ הבית של מיזם התרגום החופשי], באזור "צוותים".

=== msgid / msgstr / comment / fuzzy ===
<div dir="ltr">
 #: gramps.py:10
 #, fuzzy
 msgid "File not found"
 msgstr "קובץ לא נמצא"
</div>
* המלל שמופיע בעקבות התו ''#'' משמש להערה בגוף הקוד.
** ההפניה לקובץ ומספר השורה בו אחרי התו ''#:''
** הערת קוד או המחרוזת הראשית (''msgid'') אחרי ''#.''
** הערת תרגום (של המתרגם) (''msgstr'') אחרי ''#''
זוהי אפשרות חלופית שנועדה לסייע למתרגם אבל אינה נדרשת לביצוע התרגום.
* ניתן להוסיף ''#, fuzzy'' כאשר המחרוזת אינה עדכנית. כלומר, היה שינוי כלשהו (מחרוזת נוספה, הוסרה או שונתה) ו־''xgettext'' 'ניחש' את התרגום שצריך היה להיות. סביר להניח שהניחוש הזה לא לגמרי מוצלח, אבל לרוב הוא די קרוב.
מחרוזות ''fuzzy'' לא ישמשו בתרגום, במקום זאת יעשה שימוש במחרוזת האנגלית (''msgid'') כברירת מחדל! לכן נדרש לתקן ולאמת את הערכים הלו בעורך התרגום.
* msgid היא המחרוזת נוכחת בקוד של גרמפס
* msgstr היא המחרוזת המתורגמת לשפה הרצויה

==עצות למתרגמים==
===כיצד להתחיל===

# להקפיד לשמור תמיד את התרגומים בקידוד UTF-8 ([http://achilles-keep-moving.blogspot.de/2011/10/msgfmt-fatal-error-with-utf-8-with-bom.html הזהרו משימוש ב־''NotePad''])  ללא  '''[https://en.wikipedia.org/wiki/Byte-order_mark BOM]''' 
# לא לכתוב־על המחרוזות שבאנגלית, התרגום צריך להיות מתחת למחרוזת המקורית
# לשים לב לתווים מיוחדים. הם חייבים להיות באותו מספר וסוג כמו המחרוזת המקורית.
# נא לוודא איות ודקדוק בתרגום.
# להימנע מתרגם "חופשי מדי". התרגום צריך להיות תואם ככל האפשר למקור.
# לא לתרגם מילה במילה, תרגום מילולי עשוי לפגום בשתף השפה ולפגום בהבנת המשתמש את עצם הפעולה או הנושא.
# נא להקפיד על עקביות התרגום ולהקפיד על שימוש עקבי במילה או ביטוי מסוים שתורגם ולהיצמד אליהם לאורך כל התרגום.
# רצוי לנסות את התרגום לפני שליחתו למיזם להפצה כללית

תרגום גרמפס לשפה חדשה פירושו תרגום מחרוזות מאנגלית שמשמשות בנמשק גרמפס. בקיצור, זה מסתכם במספר פעולות:
# השגת קובץ gramps.pot שכולל את המחרוזות אותן יש לתרגום
# יצירת קובץ xx.po מקובץ ה־pot. 
# תרגום המחרוזות שבתבנית לשפה הרצויה
# בדיקת הקובץ המתורגם
# העלאת הקובץ המתורגם למאגר Gramps Git.

מסלול תרגום נוסף הוא תרגום התיעוד. זהו תהליך שונה לחלוטין וארוך הרב יותר שמתואר בעמוד [[תרגום המדריך למשתמש של גרמפס]]. 
בעמוד זה, הדגש הוא על תרגום המנשק בלבד.

===קובץ gramps.pot===
* הורדת <code>gramps.pot</code> ממאגר Gramps Git, נא לעיין בעמוד[[Brief_introduction_to_Git| המבוא ל־Git]]. ניתן להוריד קבצים על ידי גלישה לאתר [https://github.com/gramps-project/gramps ממשק המרשתת של GitHub].
* קובץ <code>gramps.pot</code> יימצא בספריית '''po'''.

===תרגום מסרים===
לתרגום מסרים (מחרוזות) לשפה הרצויה, יש לפעול בהתאם למתואר בנקודות הבאות:
*העתקת קובץ <code>gramps.pot</code> לקובץ בשם <code>lang.po</code>, בהתאם לשפה שאליה מעונינים לתרגם, לדוגמה (<code>fr.po</code> לצרפתית, <code>ru.po</code> לרוסית, <code>he.po</code> לעברית, וכן הלאה)
כל אחד מהכלים הבאים  מיועד לתרגם מסרים ויכול בהחלט לסייע בעבודת התרגום:
(מקצת מהכלים שלהלן אף יבצעו את פעולת המרת קובץ pot. לקובץ po. ולמעשה תיתר את פעולת ההעתקה)

:-[http://gtranslator.sourceforge.net GTtranslator] (גנום, וינדוס), 
:-[http://i18n.kde.org/tools/ KBabel] (KDE), [http://userbase.kde.org/ Lokalize Lokalize] (KDE, וינדוס), 
:-Emacs po-mode, [http://virtaal.translatehouse.org Virtaal] (GNU/לינוקס, מק, וינדוס), 
:-[http://www.poedit.net/ poedit] ( GNU/לינוקס, OSX, וינדוס),
או כל כלי דומה המיועד לתרגום קבצי <code>.po</code>. לחילופין אפשר להשתמש גם בכל עורך מלל  לתרגום מסרים. שימוש בעורך מסוף לדוגמה vim, הגדרה נכונה של אפשרות "langmap" יזרזו משמעותית את עבודת התרגום.
* למרות שגרמפס משתמשת בערכת קידוד UNICODE (UTF-8) עבור ערכת התווים שלה, ניתן להשתמש בערכת תווים מקומית לתרגום. חשוב רק לודא שערכת התווים שבה נעשה שימוש תצויין בשורת <code>Content-Type</code> בקובץ ה־<code>.po</code>. גרמפס תטפל בהמרה ל־UNICODE.
* תווים במחרוזת האנגלית המקורית שאינם ASCII , חייבים להשמר  על ידי העתקתם, ככול שרלוונטי.

===תוים מיוחדים===
gettexe מקבל ומשתמש בעיצוב מחרוזות בסגנון C כדי ליצור מחרוזות חדשות ומעוצבות. המפעיל (אופרטור) "%" משמש לעיצוב קבוצה של משתנים הכלולים ב־"tuple" (רשימה בגודל קבוע), יחד עם מחרוזת תסדיר, המכילה מלל רגיל ועם "מפרטי משתנים", סמלים מיוחדים כמו "%s" ו־"%d".<br>
%s משמש כמציין מיקום עבור ערכי מחרוזת אותה מעונינים להחדיר למחרוזת מעוצבת.<br>
%d משמש כמציין מיקום עבור ערכים מספריים או עשרוניים.

===הקשר===
כהרחבה ל־ettext התקני, מחרוזות בגרמפס מאפשרות שימוש בקידומת הקשר. '''אין''' לתרגם את הקידומת הזו, רק למחק אותה מהמחרוזת המתורגמת. מידע נוסף ודוגמה [[#הקשר התרגום|בהמשך למטה]].

כהקשר מיוחד, ניתן למצוא את ההפניה למדריך בצורה הבאה:
<div dir="ltr">
 'manual|Editing_Dates'
</div>
את המחרוזות הללו יש לתרגם רק אם '''מדריך ויקי למשתמש''' זמין בשפה הרצויה, לדוגמה, התרגום להולנדית אמור להראות כך:
<div dir="ltr">
  'Datums_aanpassen'
</div>
ניתן לראות שקידומת ההקשר הושמטה מהתרגום באופן תקין.

המחרוזת הזו מפנה למקטע, [[Gramps_4.1_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_1#Editing_dates |Editing_Dates]] [[Gramps_4.1_Wiki_Manual_-_Entering_and_editing_Data:_Detailed_-_part_1/de#Daten_bearbeiten|Datums_aanpassen]].

===בדיקת קובץ ה־<code>.po</code>===

{{man warn|לשינוי סביבה|עבור Gramps 4.0, {{stable_branch}} ו־master, נא לעיין ב[[Translation_environment4|סביבה חדשה]].}}

הפעלת  הפקודה: <pre>make</pre> במחיצת <code>po</code> תכשל ותחזיר הודעת שגיאה אם נמצאו ליקויים בקובץ ה־po שתורגם. את השגיאות הללו נדרש לתקן. הבדיקה לא תציף כמובן שגיאות תחביר ,כתיב ודיקדוק בשפה עצמה, שגיאות מסוג זה הן באחריות המתאגם לנפות.<br>
לפעמים יהיה קושי בהבנת השגיאת שהבדיקה מציפה, הרצת הבדיקה הבאה, שעשויה לספק פלט עם מלל רב יותר.

====check_po====
הפעלת הפקודה הבאה במחיצת ה־<code><span dir="ltr">.po</span></code>: 
<div dir="ltr">
 ./check_po --skip-fuzzy lang.po
</div> 
או 
<div dir="ltr">
 python check_po --skip-fuzzy lang.po > lang
</div>
כאשר lang הוא קוד השפה המתורגמת. הצפת שגיאות בתרגום, מידע על ביטויים שתורגמו בצורה גרועה (חוסר תאימות בין מחרוזת המקור לזו שתורגמה), ... הפלט יראה משהו כמו.
<div dir="ltr">
 File:               nl.po
 Template total:     3816
 PO total:           3671
 Fuzzy:              125
 Untranslated:       12
 %s mismatches:      0
 %d mismatches:      2
 %() name mismatches:9
 %() missing s/d:    0
 Runaway context:    0
 XML special chars:  0
 Last character:     15
 Shortcut in msgstr: 16
 PO Coverage:        99.67%
 Template Coverage:  95.89%
 Localized at:       97% (previous gramps.pot)
</div>

מתוך הפלט ניתן להבין שישנן 3,816 מחרוזות לתרגום בקובץ ה־ <code><span dir="ltr">.pot</span></code>אך בקובץ ה־ <code><span dir="ltr">.po</span></code>רק 3,671 מחרוזות, כלומר קובץ ה־ <code><span dir="ltr">.po</span></code> מכסה 96% בקרוב.<br>
קימות עדיין 12 מחרוזות שלא תורגמו וכ־120 מחרוזות "לא ברורות" (fuzzy).<br>
ב־15 מחרוזות אין התאמה ב'תו האחרון' .אי התאמה בערכים ב־9 חרוזות מסוג  <code><span dir="ltr">%()</span></code> וב־2 מחרוזות מסוג "טופל" <code><span dir="ltr">%d</span></code> (ערכים מספריים)

אם  ההודעה ''previous gramps.pot''מוחזרת, המשמעות היא שלא נעשה שימוש בגרסת קובץ ה־''gramps.pot''האחרון, למידע נוסף נא לעיין בסעיף [[#עדכון_התרגום|עדכון התרגום]]. תוכנת גרמפס תתעלם ממחרוזות מסוג ''fuzzy'' ומחרוזות שלא תורגמו, ותשתמש במחרוזות ראשיות בשפה האנגלית.

<div dir="ltr">
 -------- %d mismatches --------------
</div>
2 מחרוזות שמכילות מספרים או מספרים עשוריים אינן תואמות למקור.
<div dir="ltr">
 -------- last character not identical ---------
 msg nr: 98, lineno: 602
 msgid "Could not make database directory: "
 msgstr "Kon geen gegevensbestandsmap aanmaken"
</div>
זהו מידע בעל ערך רב, כי ניתן בקלות יחסית להבחין בבעיות, גם אם לא מבינים את השפה המתורגמת! די ברור שהתו האחרון אמור להיות ":"

====סטטיסטיקה====
הפעלת הפקודה הבאה במחיצת ה־<code><span dir="ltr">.po</span></code>:
<div dir="ltr">
<pre>msgfmt --statistics lang.po</pre>
</div>
או
<div dir="ltr">
<pre>msgfmt.exe --statistics lang.po</pre>
</div>
כאשר lang הוא קוד השפה המתורגמת. 
במקרה זה לא אמורה להתקבל הודעת שגיאה. בעיקרון הפקודה מחזירה מידע בלבד בתסדיר מרוכז: 3533 הודעות מתורגמות, 125 תרגומים לא בררים, 12 הודעות לא תורגמו.

====GNU `gettext' כלי עזר====
[http://www.gnu.org/software/gettext/ כלי עזר של GNU `gettext'] מספקים מגוון תוכניות עצמאיות שנועדו לאפשר טפלול קבוצות מחרוזות מתורגמות או כאלו שטרם תורגמו בדרכים שונות:

  msgattrib - התאמה וטפלול תכונות בקטלוג המסרים
  msgcat - שילוב מספר קטלוגים של המסרים
  msgcmp - השוואה בין קטלוג המסרים והתבנית
  msgcomm - התאמה בין שני קטלוגים של מסרים
  msgconv - המרת ערכת תווים לקטלוג מסרים
  msgen - ייצירת קטלוג מסרים באנגלית
  msgexec - עיבוד התרגום של קטלוג המסרים
  msgfilter - עריכת תרגום של קטלוג המסרים
  msgfmt - הידור קטלוג המסרים לתסדיר בינארי (.po->.mo)
  msggrep - התאמת דפוסים בקטלוג המסרים
  msginit - אתחול קטלוג המסרים
  msgmerge - מיזוג קטלוג המסרים ותבנית
  msgunfmt - ביטול הידור קטלוג המסרים מתסדיר בינארי
  msguniq - איחוד תרגומים כפולים בקטלוג המסרים

לבדיקת תחביר (כותרת, תסדיר, תחום):
<div dir="ltr">
 msgfmt -c nl.po

 msgfmt.exe -c nl.po
</div>
לבדיקת מאיצי מקלדת (קו תחתון):
<div dir="ltr">
 msgfmt --check-accelerators=_ nl.po

 msgfmt.exe --check-accelerators=_ nl.po
</div>

====Gettext lint====
[http://gettext-lint.sourceforge.net/ Gettext lint] הם אוסף של כלים לבדיקת תקפות, עקביות ואיות של PO. מספר תסריטי פייתון לא נתמכים עוד בגרסה האחרונה של expat.

====Pology (KDE)====
[http://pology.nedohodnik.net/ Pology] היא ספריית פייתון ואוסף כלי שורת פקודה לעיבוד מעמיק של קבצי PO, תסדיר קובץ התרגום של תוכנת התרגום  GNU Gettext. היכולות של Pology נעות בין פעולות דיוק על מסרי PO בודדים, לפעולות חוצת קבצים על מקבץ גדול  של קבצי PO. Pology משמשת את צוותי התרגום [http://websvn.kde.org/trunk/l10n-support/pology/ KDE] לבדיקת תחביר.

====ערכת כלי תרגום====
[http://docs.translatehouse.org/en/latest/ ערכת כלי תרגום] הם אוסף כלים שימושיים להמקמה, כולל כלי בדיקה, אימות, מיזוג וחלוץ הודעות מקובצי המקמה.

===שמירה כקובץ .mo===
כשמשתמשים באחד מכלי התרגום המוזכרים מעלה, חשוב לבדוק את תקינות החביר בקובץ ה־.mo.<br>
.mo.לשם כך לאחר סיום תרגום הקובץ נדרש לחולל קובץ בתסדיר

* בתוכנת poedit, ניתן להגדיר להדר תמיד קובץ ''.mo'' בעת שמירת שינויים, מתפריט '''קובץ -> ביצוע הידור ל־m0..." או מתפריט "עריכה -> העדפות''' ובלשונית '''כללי''' במקטע "עריכה" לסמן את '' ביצוע 'הידור ל־mo באופן אוטומטי בעת השמירה''. תיבת דו־שיח תחזיר הודעת אזהרה  אם קיימות שגיאת תחביר בקובץ ה־''.po''.

* Lokalize, GTranslator מספקות גם הן בדיקת תחביר בעת השמירה. אם אירעה שגיאה ניתן לנווט להודעות המכילות שגיאות ןלטפל בהן.

נא להפעיל תכונה זו כדי למנוע שגיאות בתהליך ההידור.

===תסדור (הידור) <code>.po</code> file===
* נכון לעכשיו, [[Coding_for_translation#How_it_works|תסדור  (msgfmt) מבוצע במהלך זמן הבנייה]], לכן אין מה לדאוג לגבי זה. קובץ ה־<code>.po</code> המתורגם הוא למעשה תוצר עבודת התרגום. חשוב [[Translating_Gramps/he#שמירה_כקובץ_.mo|לבדוק תחביר]] לפני כל פעולת קיבוע.

===שליחת קובצי התרגום===
בגמר עבודת התרגום ולאחר בדיקה, מגיע השלב בו צריך 'לדחוף' את התוצרים (קובצי ה־po.) לאתר הפיתוח והתחזוקה של המייזם ב־GitHub . הפעולה הזאת מחייבת הרשאה לדחיפת קבצים, אותה ניתן לקבל יחסית בקלות לאחר יצירת חשבון Git ופניה למנהלן גרמפס באחד מערוצי התקשורת.

התצורה שלהלן מפשטת את פעולת הדחיפה של ענץ, חזרה לשרת הפתוח:
<div dir="ltr">
 $ git config --global push.default upstream
</div>
דרך אחרת היא על ידי 'משיכת' קובצי המייזם מ־Git לכונן  מקומי או 'סיעוף' מאגר גרמפס (מחייב חשבון ב־Github) שמירת התוצרים במחיצות המתאימות ולייצר בקשת 'משיכה' מהמאגר שסועף למאגר הראשי, פעולה שתמזג את התוצרים לתוך המאגר הראשי לאחר סדרת בדיקות תקינות אוטומטיות.

לקריאה נוספת:<br>
אתר גרמפס בגיטהאב 
{{Code Browser}} <br>
[[Brief introduction to Git|מבוא קצר ל־Git]] <br>
[[A Translators Guide to Git|מדריך GIT למתרגמים]]

===עדכון התרגום===
גרמפס הוא מייזם פעיל ביותר, לכן  בהחלט ייתכן שמחרוזות חדשות נוספו או עודכנו בתוכנה או בתופים עם חלוף הזמן. כמו כן לא מין הנמנע שיתגלו שגיאות  תקלדה, כתיב, תחביר או נסוח שיצופו תוך כדי שימוש בתוכנה, למרות ועף על כל הבדיקות שבוצעו במהלך עבודת התרגום. מן הסתם תדרש עבודת עדכן קובצי התרגום שכבר נדחפו לאתר הפיתוח ושולבו בתוכנה.

בהנחה שעץ מקורות הקוד של גרמפס סועפו או הועתקו למחשב מקומי כפי שהוסבר ב[[Brief introduction to Git|מבוא קצר ל־Git]], להלן מספר פעולות לביצוע על מנת לעדכן את התרגום:<br>
* עדכון מקור הקוד מ־Git. ניתן לעשות זאת מתך מסוף ובאמצעות הפקודה 
<div dir="ltr">
<pre>git pull --rebase</pre>
</div>
ממחיצת השורש Gramps. פעולה זו תמשוך קובץ <code>gramps.pot</code> עדכני.
* קובץ התרגום הקודם (שמצריך עדכון) ישמש כבסיס למחרוזות שלא השתנו: 
<div dir="ltr">
<pre>msgmerge lang.po gramps.pot -o newlang.po</pre>
</div>
או
<div dir="ltr">
<pre>msgmerge --no-wrap lang.po gramps.pot - o newlang.po</pre>
</div>
כאשר <code>lang</code> הוא קוד השפה הרצויה. האפשרות <code>--no-wrap</code> תמנע שינויים עקב גלישת מלל אוטומטית, ניתן להשתמש במשתנה זו אם קובץ ה־po הקודם נבנה כך. משתנה <code>--no-wrap</code> תספק הבדלי Git קריאים יותר.
* בדיקת מסרים לא בררים ( fuzzy) ־וכמובן תרגם המסרים שמצריכים תרגום, תיקון טעיות ושגיאות כפי שדובר ברישא ב-<code>newlang.po</code>. לאחר בדיקה ווידוא שהכל תקין, יש לשנת את שם הקובץ <code>newlang.po</code> ל־<code>lang.po</code> ולדחוף אותו ל־Git כפי שנעשה עם הקובץ המקורי.
* אם הפקודה <code>msgmerge</code> אינה זמינה במערכת, יש להתקין  את החבילה <code>gettext</code>. עבור [http://wiki.wxpython.org/index.cgi/Internationalization#How_to_get_get_text_tools_for_Win32 windows וינדוס].
* עדכון תרגום ותרגום לאחור, <abbr title="exempli gratia - ביטוי לטיני שמשמעותו 'לדוגמה'">לדוגמה</abbr>, כדי למזג תרגומי מאסטר של ענף מסויים לענף מוקדם יותר, את הפעולות הללו יש לבצע בענף הקודם (בהנחה שקובץ gramps.pot מעודכן):
<div dir="ltr">
<pre>msgmerge -C lang.po master-lang.po gramps.pot -o newlang.po</pre>
</div>
יש לפתור את סוגיית המסרים הלא ברורים כרגיל.

פקודה נוספת בה ניתן להשתמש היא <code>make target</code> שעושה את הפעולות הבאות:
* יצירת תבני תקובץ <code>gramps.pot</code> חדשה מקובצי קוד המקור
<div dir="ltr">
<pre>
   cd po 
   ./genpot.sh</pre> 
</div>
או
<div dir="ltr">
<pre>python update_po.py -p</pre>
</div>
לקריא נוספת [[Talk:Translation_environment4|השוואה בין הכלים השונים]].
* הפקודה הבאה תעדכן כל אחד מקובצי ה־<code>po</code> בעץ קוד המקור
פעולה מעט מרחיקת לכת לצרכים מקומיים, אבל ניתן להשתמש בה גם כן:
<div dir="ltr">
   cd po
   python update_po -m all
</div>  
יש להריצה ממחיצת <code>po</code>. בהנחה שקוד המקור נמשך או סועף בהצלחה. לתשומת לב, פקודה זו מתעלמת מהמשתנה <code>--no-wrap</code>, כך שהיא לא ממש מעשית להצפת הבדלי Git.

{{man warn|על שינוי סביבה|לגרסת גרמפס 4.0, {{stable_branch}} ו־master, ניתן לקרוא ב[[Translation_environment4|new environment|סביבה חדשה]].}}

===בדיקת העדכונים שבוצעו===
את העדכון ניתן לבדוק בקלות באמצאות הקובץ '''[[#check_po|check po]]'''  להריץ את הפקודה שהוזכר לעיל. בהנחה שהקובץ הזה נמשך כל שנדרש זה:
<div dir="ltr"> 
<pre>python check_po --skip-fuzzy newlang.po</pre>
</div>
אם הכל תקין, פלט הפקודה יראה בערך כך:
<div dir="ltr">
 File:               newlang.po
 Template total:     3075
 PO total:           3075
 Fuzzy:              0
 Untranslated:       0
 %s mismatches:      0
 %d mismatches:      0
 %() name mismatches:0
 %() missing s/d:    0
 Runaway context:    0
 XML special chars:  0
 Last character:     0
 Shortcut in msgstr: 0
 PO Coverage:        100.00%
 Template Coverage:  100.00%
</div>

===התקנת התרגום===

{{man warn|החלפת סביבה|לגרסת גרמפס 4.0, {{stable_branch}} ו־master, נא לעיין ב[[Translation_environment4|סביבה חדשה]].}}

כדי להשתמש בתרגום החדש באופן מיידי, ובכול חלקי המערכת, ניתן להתקין רק את תוכנה של ספריית ה־po, לשם כך נדרש לבנות את המקור תחילה בדרך הבאה:
<div dir="ltr">
 ./autogen.sh
 make
 cd po
 make --prefix=/usr install     #כמשתמש על (שורש)!
</div> 
רצף הפעולות הללו אמורת להתקין את התרגומים  ל־''/usr/share/locale/{lang}/LC_MESSAGES/gramps.mo'', כאשר {lang} היא השפה הרצויה. ניתן כמובן להעתיק את הקבצים באופן ידני למחיצה הזאת, חשוב רק לוודא ששם הקובץ יקרא gramps.mo.

כמו כן, נא לודא שההתקנה נעשיתן רק מתוך ספריית ה־po, אחרת תותקן גרסת הפיתוח של גרמפס, שאינה נתמכת ומיועדת למטרות לבדיקות בלבד!

==== הרצת גרסת ענף master עם התרגום הטרי ====

נתוני [https://en.wikipedia.org/wiki/Internationalization_and_localization i18n] נמצאים לעתים קרובות במחיצה ''../share/locale''  עם קידומת ברירת המחדל.

כך שניתן להשתמש ברצף הפקודות:
<div dir="ltr">
 python setup.py build
 sudo python setup.py install --root=/     #'''!כמשתמש על'''
</div> 
פעולה זו תתקין את קבצי ה־mo. במחיצה ''../share/locale/xx/LC_MESSAGES'', בהתאם לקידומת ברירת המחדל. (xx היא קידומת קוד השפה הרצויה)<br>
או 
<div dir="ltr"> 
 python setup.py build
 python setup.py install --root=/home/שם משתמש/gramps
                         --prefix="/home/שם משתמש/gramps4" 
                         --enable-packager-mode     #כמשתמש רגיל
</div> 
פעולה זו תתקין את גרמפס ואת התרגומים במחיצת ''/home/...'' (מחיצת הבית) של המשתמש.

===== $GRAMPSI18N (המקמה) =====

למעשה אפילו לא צריך להתקין את הקבצים כדי לבדוק אותם. אפשרות זאת שימושית למדי כי ניתן להפעיל את גרמפס מבלי להזדקק להרשאות משתמש־על. צריך זכור שכשמשתמשים בענף מאסטר (master), התהליך בגרמפס i18n מתבצע בערך כך:

* כשמקלידים את פקודת <code>python build</code> בשורש עץ המקור (/home/user/Gramps <abbr title="exempli gratia - ביטוי לטיני שמשמעותו 'לדוגמה'">לדוגמה</abbr>) כל קבצי ה־po/*.po מהודרים לקובצי build/mo/{lang}/*.mo.
* לאחר מכן עם הקלדת הפקודה <code>python install</code> בתוך מחיצת ה־po, קבצי ה־.mo האלה מועתקים ל־{prefix}/share/locale/{lang}/LC_MESSAGES כקבצי gramps.mo.

אבל ניתן לשנות את המקום שבו תוכנת גרמפס מחפשת כברירת מחדל את הקבצים האלה על ידי שינוי משתנה הסביבה $GRAMSI18N. לכן, לחילופין ניתן להגדיר את הסביבה ולהימנע משלב <code>התקנת python setup</code> באופן הבא: (התחביר בשימוש ב־csh או tcsh  יהיה מעת שונה)
<div dir="ltr">
  [user@localhost /home/user/Gramps]$ mkdir -p po/en_GB/LC_MESSAGES
  [user@localhost /home/user/Gramps]$ cp po/en_GB.gmo po/en_GB/LC_MESSAGES/gramps.mo
  [user@localhost /home/user/Gramps]$ cd gramps
  [user@localhost /home/user/Gramps/src]$ GRAMPSI18N=$PWD/../po LANG=en_GB.UTF-8 python gramps.py
</div>
{-}
===== gramps.sh =====

במשגר גרמפס  (מועתק מ־''<code>{prefix}/bin/gramps</code>'')  ניתן להגדיר סביבת עבודה בדרך הבאה:
<div dir="ltr">
 export GRAMPSDIR=/[הנתיב לתקיית גרמפס]
 export GRAMPSI18N=/[הנתיב למחיצת locale gramps]
</div> 
כאשר משתנה הסביבה ''$GRAMPSDIR'' הוא הנתיב לתקיית ''גרמפס''
ומשתנה הסביבה ''$GRAMPSI18N'' הוא הנתיב למחיצת ''locale gramps''.

===== בדיקה מהירה =====
לבדיקה מקומית מהירה, ללא הצורך בהידור כל הקובצים שתורגמו, אפשר פשוט לשמור את קובץ ה־''po.'' כקובץ ''mo.'', או להשתמש בכלי השירות של gettext ''msgfmt'' בתוך תיקיית po/ (תיאור מפורט  [[#GNU_`gettext'_כלי_עזר|בכלי עזר]]):
<div dir="ltr">
 msgfmt -o gramps.mo your_lang.po
</div>
או בסביבת וינדוס
<div dir="ltr">
 msgfmt.exe -o gramps.mo your_lang.po
</div> 
פקודה זו תיצור קובץ ''gramps.mo'', גרסה מהודרת של קובץ ה־ ''.po''.
את הקובץ המהודר יש להעתיק/לשמור בנתיב התרגום (''כפי שתואר מעלה'').

==צרופי־מילים, אימרות ופתגמים, לא קל לתרגם ==
יש דברים שממש קשה לתרגם. להלן כמה מהמקרים הקשים יותר לתרגום, יחד עם מספר הצעות כיצד לטפל בהם.
===מונחי גרמפס===
תוכנת מחשב משתמשות לא אחת במונחים בעלי משמעות מיוחדת. המונחים הם לרוב כתובים במבנה תחבירי מביך באופן יצירתי בשפה האנגלית... רק כדי שהמונח יהיה ייחודי  ובולט יותר במשפט. תרגום מונחים אלו ובכלל באופן מילולי, או החלפת  המושג הבסיסי האנגלי בתרגום חלופי, עשויים שלא להיות ברי ביצוע. ייתכן שיהיה צורך להיות ''יצירתיים'' ולהחליף מונח כזה בתווית מביכה (וקצרה!) בעלת משמעות דומה בשפת היעד.

התוויות בכמה מושגי ליבה או רכיבי מנשק גרמפס טומנים בחובם רמת משמעות גבוהה יותר. חשוב לתרגם אותם באופן עקבי, גם במנשק המשתמש וגם בויקי. (תרגומים לא עקביים רק יגרמו לבילבול נוסף אצל המשתמשים.)

''לדוגמה:'' ה־'''[[Gramps_Glossary#active_person|Active Person]]''' בגרמפס הוא לא אדם שמצטיין בבריאות מעולה כתוצאה מפעילות גופנית נמרצת, או פעיל בתנועת הצופים, המונח הזה בגרמפס בא להגדיר רשומה מסויימת ממצג [[Gramps_5.2_Wiki_Manual_-_Categories/he#סוג־אב_אנשים|[[Gramps_Glossary/he#סוג_אב|סוג־אב]] [[Gramps_Glossary/he#אנשים|אנשים]]]] שהיא מוקד ההתייחסות למטרות מצג, עריכה ושינוי. אין מילון בעולם שידע לתרגם את המונח הזה באופן שיקלע למשמשעות שניתנה לו במסגרת מייזם גרמפס.

[[Gramps Glossary/he|מילון מונחי גרמפס]] הוא משאב טוב להבנת ההקשר והמשמעות של מונחים כאלה. לכן כאשר מתרגמים את מילון המונחים ומסדר את המונחים המתורגמים לפי סדר אלפביתי, חשוב להשאיר גם ID SPAN עם המונח הלא מתורגם באנגלית. דבר זה מאפשר לקישורים חמים מעמודים שטרם תורגמו לעבוד בשיתוף עם קישורים חמים שכבר תורגמו.

במקום שנדרש להיות ''יצירתים'' בתרגום מונח, הוספת עמוד התייחסות [[Translating_Gramps/he#עמודים_יעודיים_לשפות|לשפה מסויימת]] עבור שפה היעד, תסייע למתרגמים אחרים לשמר ולזרום עם הסגנון היצירתי הנדרש.

===LDS מונוחי===
כנסיית ישו המשיח של קדושי אחרית הימים [https://he.wikipedia.org/wiki/מורמונים (מכונים גם מורמונים)] שומרת  הרבה נתונים גנאלוגיים. בארצות הברית, הם כנראה הארגון הלא ממשלתי עם הרישומים המפורטים ביותר שניתן למצוא. חקר־יוחסין מאוד חשוב לכנסייה המורמונית. הם גם אלו שיצרו את הגדרת תסדיר [[GEDCOM]].אחד מאתרי חקר יוחסין המפורסמים ביותר – [https://www.familysearch.org/en/ FamilySearch] – שיך גם הוא לכנסיה.

לכנסיית LDS טרמינולוגיה מסויימת מאוד שעשויה לייצור קושי נוסף בתרגום מעבר לקושי שקיים כפי שהודגם מעלה. קיימות שתי גישות לטיפול במידע.
# אם לכנסיה  נוכחות במדינת שפת היעד, כדאי ליצור קשר עם הכנסיה הקרובה ושאל אותם מהי הטרמינולוגיה המתאימה בשפת היעד
# אם לכנסייה אין נוכחות במדינה, עדיף פשוט לא לתרגם את הביטויים.
זהו פתרון מעט פשטני, במיוחד כאשר מדובר במדינות הגירה בהן לאדם שורשים במדינות רבות ובהתאם לזאת גם מקורות המידע.<br>

להלן מספר ביטויי LDS ייחודיים: 
<div dir="ltr">
# LDS Ordinance names:
#* Sealed to Parents
#* Sealed to Spouse
#* LDS Baptism
#* Endowment
# LDS Status names for Ordinances:
#* Child
#* Cleared
#* Completed
#* Infant
#* Pre-1970
#* Qualified
#* Stillborn
#* Submitted
#* Uncleared
#* BIC (לידה במנזר)
#* DNS (לא לשגר)
#* Canceled
#* DNS/CAN (Do Not Submit/Previous sealing cancelled)
</div>

==סוגיות מתקדמות==
===משתני תסדיר שורה===
'''לא צריך''' לתרגם משתני תסדירי שורה כמו <nowiki>%s</nowiki> ו־<nowiki>%d</nowiki>  סדר התווים במשתנים אמור להשמר כפי שמופיע במסר המקורי ו'''לא להשתנות'''. לדוגמה:

אנגלית:
<div dir="ltr">
    Long widowhood: %s was a widow %d years.
</div>
תרגום לא תקין לעברית (שימו לב כיצד השתנה סדר התווים):
    אלמנות ממושכת: %s אלמנות במשך %d שנים.
<span class="nowrap">
סדר תווים תקין בתרגום לעברית אמור להראות כך: <span div dir="ltr"> %s, %d </span><br>
עקב מגבלות תוכנה בכיווניות שפות שנכתבות מימין לשמאל יש נטיה לתוים במחרוזות מעורבים אנגלית עברית (אך לא רק) להתהפך כלומר סימן ה־% אמור להופיע משמאל לאות הנגלית ללא תלות בשפה.
</span>
<br>
<span class="nowrap">
גם משתני שם בתסדיר שורה כמו <span div dir="ltr"><nowiki>%(something)sו־ %(something)d</nowiki></span> '''לא אמורים''' להיות מתורגמים. ניתן כמובן לשנות את סדר המשתנים הנקובים עצמם לצרכי ניסוח המסר באופן תקין ונכון לשפת היעד. כמו כן, ניתן וכדאי להשתמש ברמזים שמסופקים על ידי משתני  השמות. לדוגמה:
</span>
אנגלית:
<div dir="ltr">
    Baptized before birth: %(male_name)s
            born %(byear)d, baptized %(bapyear)d.
</div>
תרגום (לדוגמה לעברית:
   הטבלה טרום לידה: %(byear)d
            הנולד %(male_name)s, הוטבל ב־%(bapyear)d.

בדוגמה לעיל, הפועל "נולד" מתרגם מאנגלית ללשון זכר (כאשר אין דרך להוסיף שונות למגדר, בתרגום לעברית עדיף להשתמש בלשון נאוטרלית, גם במחיר הפיכת שם פועל לתואר), מכיוון שאין מגדר לשם פעל.

לפעמים אותם תוי <nowiki>%(something)s</nowiki> ממוקמים במלל ללא רווחים, כמו בדוגמה מטה:

אנגלית:
    This person was baptised%(endnotes)s.

תרגום לעברית:
    אדם זה הוטבל<span div dir="ltr" nowiki>%(endnotes)s</span>.

===תרגום תוכן===
במקרים מסוימים, שני מושגים שונים עשויים לקבל ביטוי באנגלית באותה המילה אך בעת התרגום הם דורשים מילים נפרדות. לדוגמה, '''כותרת ספר''' ו'''תואר אצולה''' מתוטאות באנגלית באותה מילת '''Title''', בעוד שבשפות אחרות יש צורך במילים שונות כדי לתאר את 'שם הספר' ואת 'תוארו' של אדם.

כדי לגשר על הפער הזה וסוגיות כאלה, ניתן להשתמש באפשרות ההקשר ולהוסיף הקשר למחרוזת התרגום. מחרוזת מאופשרת־הקשר תופיע עם קו אנכי שמפריד בין ההקשר למחרוזת:
<div dir="ltr">
 book|Title
 person|Title
</div> 
את מילת ההקשר '''לא אמורים לתרגם''' כמו כן אי לכלול את הקו האנכי המפריד תרגום. מילת ההקשר והקו המפריד נועדו כדי לספק לתת למתרגם מושג על משמעות המחרוזת.  '''גם מילת ההקשר וגם הקו המפריד  '''אסור שיופיעו''' במחרוזת המתורגמת כדי לא לפגוע בתרגום.
בתרגום לעברית המחרוזת אמורה להראות כך:

 כותר
 תואר

מתרגמי גרמפס שנזקקים לאיש פתוח שייסיע בהוספת מילות הקשר לקובצי המקור של גרמפס,  יכולים לפנות באמצעות רשימת gramps-devel  ולבקש הוספת הקשרים.
===סוגיות מגדר===
סוגיית המגדר מעלה מספר שאלות במהלך התרגום, שאינן מאתגרות רק משום שתרגום שגוי עשוי לשנות את המשמעות המלל, אלא שהוא עלול להגיע לכדי פגיעה ממשית.
להלן שלוש סוגיות מגדריות עיקריות:

* מגדר דקדוקי: מתייחס למגדר שמוקצה לשמות עצם. ישנן שפות שמתנהגות כך ואילו אחרות לא. שתי בעיות עיקריות מתעוררות בעת תרגום בין שתי מערכות שפות כאלה, כאשר שפת המקור משתמשת בתוית או כינוי מסויים למגדר, אך בשפת היעד אין כאלה. יש מקרים שבהם השימוש המגדרי ב"You" עשוי להיות דקדוקי בלבד, אך קיימים מקרים  שבהם חשוב שה"You" יתייחס לזכר או או נקבה בהתחשב בהקשר המלל. בלאנגלית לדוגמה אין מילה מסויימת למגדר בניגוד לעברית שמבחינה בין 'את' ל'אתה', דבר שמשאיר למתרגם להתמודד עם הסוגיה.<br>במקרה ההפוך, כאשר שפת המקור אין בתוית או כינוי מסויים למגדר, אך בשפת היעד יש כאלה. באנגלית אפשר בפשטות לאמור 'Full Moon' או 'Big Ball', במספר ספות כמו צרפתי או ספרדית מקדימים את המילה ב: "el", "le" או או "la" ובזאת נפתרת בעיית התרגום לספרדית. אבל כאשר שפת המקור אינה מציינת את המגדר באופן מפורש או מרומז מתעוררת בעיה שעלולה לשנות את ההקשר בשפת היעד. העלילה מסתבכת עוד יותר כשמתרגמים לעברית כאשר כל 'עצם' למעשה הוא תלוי מגדר, 'כדור' הוא זכר ואילו 'חמה' היא נקבה. לדוגמה ל־"I eat"; אין מגדר שקשור לכינוי "I" לעומת זאת בשפות רבות, ובפרט בעברית, לא רק שהכינוי חייב להיות מסויים למגדר, אלא שצורת הפועל של "eat" חייב להיות מקושר גם על סמך מגדר (אני אוכל, אני אוכלת).

* מגדר סמנטי: מתייחס לשמות העצם של זכר ונקבה, כפי שהם מובחנים באופן ביולוגי. לכאורה זה נראה מובן מאליו, אך גם כאן מתעוררות בעיות.  באנגלית לדוגמה, חתול מכונה רק  "he" או "she" אם המגדר ידוע, אחרת, החתול מכונה "it". פתרון כזה לא קיים בשפות רבות. הדרך של העברית לטפל בסוגיה היא בבסיס שם העצם, 'חתול' ו'חתולה'. 

*מגדר חברתי: מתייחס למגדר הביולוגי שמניח על סמך השימוש בשם עצם והחברה שבה נעשה בו השימוש. ההבחנה בין מגדר ותפקיד היתה ברורה יותר לפני חמישה או שישה עשורים אך לא עוד. לדוגמה, המילה האנגלית "secretary" רמזה פעם שהתפקיד ממולא בידי גבר,  או 'nurse' שהוא כמובן תפקיד אישה. המצב היום שונה מאוד, גם בעברית לא עלה על הדעת ש'אח' ישמש בתפקיד א'אחות רחמניה'. בחברות מסויימות, לדוגמה למילה "טבח" או "עוזרת" תהיה חלוקה מגדרית ייחודית תלוית תרבות. די ברור שלתפקידים חברתיים – מגדריים רבים שורשים עמוקים, היסטוריים ותרבותיים, ולרוב סטריאוטיפיים מאוד באופיים.

לכללי תטיפול בסוגיה נא לעיין גם בעמוד [[Translation_into_Hebrew#סוגיית־המגדר|המלצות לטיפול בסוגיית המגדר]]

====תרגום תוכן בתויות ממשק המשתמש====
אם קיימת מחרוזת במנשק המשתמש הגרפי Glade GUI (כלומר, בקובץ המקור glade.) שדורש מילת הקשר לצרכי התרגום, לא ניתן לתרגם אותה באופן סטטי. במקרה זה, נדרשת הוספת קוד זמן־ריצה לאתחול הדו־שיח המתאים כדי לעקוף את מחרוזת התווית במלל שהתקבל בקריאה ל־sgettext. להלן סדר הפעולות בהן יש לנקוט:

* יש לודא שליישומון המסויים קיים מזהה משמעותי בקובץ ה־glade. (בניגוד למזהה סתמי שנוצר באופן אוטומטי). לשנות את המזהה במידת הצורך ולודא שאין קוד קיים ששתמש במזהה היישומון הישן! <abbr title="exempli gratia - ביטוי לטיני שמשמעותו 'לדוגמה'">לדוגמה,</abbr>: שינוי המזהה:
<div dir="ltr">
 <object class="GtkLabel" id="label3">
</div>
:למזהה
<div dir="ltr">
 <object class="GtkLabel" id="place_name_label">
</div>
* הוספת מילת הקשר למחרוזת הניתנת לתרגום בקובץ ה־glade. בדרך זו, כאשר מסתכלים על תוכן קובץ POT או קובץ PO שנגזר ממנו, ניתן לראות הפניה למקום הזה, יחד עם המקום בפועל בקבצי py. אשר גם הם בעלי אותה מחרוזת הקשר. <abbr title="exempli gratia - ביטוי לטיני שמשמעותו 'לדוגמה'">לדוגמה</abbr>, שינוי המזהה:
<div dir="ltr">
 <property name="label" translatable="yes">Name:</property>
</div>
:למזהה
<div dir="ltr">
 <property name="label" translatable="yes">place|Name:</property>
</div>
* באתחול הדו־שיח המתאים, נדרש להוסיף קוד להגדרת המחרוזת לתרגום נכון בזמן ריצה, <abbr title="exempli gratia - ביטוי לטיני שמשמעותו 'לדוגמה'">לדוגמה</abbr>:
:באפן כללי בקובץ:
<div dir="ltr">
 PLACE_NAME = _('place|Name:')
</div>
:בשיטת MergePlace.__init__:
<div dir="ltr">
        for widget_name in ('name_btn1', 'name_btn2'):
            self.get_widget(widget_name).set_label(PLACE_NAME)
</div>
: השיטה המדויקת להתחברות לבקר Gtk תשתנה בהתבסס על רכיב מנשק המשתמש הגרפי המושפע בפועל. <abbr title="exempli gratia - ביטוי לטיני שמשמעותו 'לדוגמה'">לדוגמה</abbr>, ל־GtkButton השיטה היא set_label, ואילו ל־GtkLabel היר תהיה set_text.
* לבסוף, חילול קובץ ה־POT מחדש, תרגום מחרוזות ה־PO החדשות שנוספו ובדיקת תוצרי עבודת התרגום.

===צורת רבים===

הדרישה לתמיכה ב[http://www.gnu.org/software/gettext/manual/html_node/gettext_150.html#Plural-forms צורת רבים] עלתה בעבר וטופלה בצורה הבאה:

ראשית, על המתרגם לבדוק ולודא שהמחרוזת ''"Plural-Forms:\n"'',<br>
זמינה בכותרת קובץ ה־po.<br>
([http://docs.translatehouse.org/projects/localization-guide/en/latest/l10n/pluralforms.html טבלת ערכי המידע לפי קודי מדינה])

תאור המחרוזות שנועדו לטפל בצורת רבים, והערכים שהן יכולות לקבל:

# msgid מכילה את מחרוזת צורת היחיד באנגלית
# msgid_plural מכילה את מחרוזת צורת הרבים באנגלית
# msgstr[0] מכילה את הגרסה המתורגמת לצורת היחיד (עבור 1 ולפעמים 0, שמוגדר בכותרת)
# msgstr[1] מכילה את גרסת צורת הרבים (עבור 1 + 1 = 2 )
# msgstr[2] מכילה את צורת הרבים (עבור 2 + 1 = 3)

* בשפות בהן נהוגה שיטת צורה אחת, ללא אבחנה בין יחיד לרבים, (יחיד=רבים, ''צורות רבים: nplurals=1; רבים=0''), כמו סינית, הונגרית או טורקית:
<div dir="ltr">
 msgid "%d second"
 msgid_plural "%d seconds"
 msgstr [0] "%d 秒"
</div> 
* בשפות בהן נהוגה צורת רבים אחת (''Plural-Forms: nplurals=2; plural=n != 1;''), כמו אנגלית או עברית:
<div dir="ltr">
 msgid "%d hour"
 msgid_plural "%d hours"
 msgstr [0] "%d hour"
 msgstr [1] "%d hours"
</div> 
* בשפות בהן נהוגות יותר מצורת רבים אחת, כמו צ'כית:
<div dir="ltr">
 msgid "%d second"
 msgid_plural "%d seconds"
 msgstr [0] "%d sekunda"
 msgstr [1] "%d sekundy"
 msgstr [2] "%d sekund"
</div> 
לסיום וכבדיקה אחרונה, יש לודא שהפקודה הבאה לא מחזריה שגיאות כלשהן:
<div dir="ltr">
 msgfmt -c filename.po
</div>

=== תרגום מקשי סמלים־רומזים (mnemonics) (מקשי קיצורי מקלדת)===
סמלים רומזים  (באנגלית Mnemonics) הם מקשי האצה (מקשי קיצורי־מקלדת) אותם ניתן למוצא בתוויות התפריט לרוחב כל המערכת, ומפעילים אותם על ידי לחיצה על מקש {{man key press|ALT}} יחד עם מקש הסמל הרומז. במלל המקור הם מופיעים עם קו תחתון מקדים, <abbr title="exempli gratia - ביטוי לטיני שמשמעותו 'לדוגמה'">לדוגמה,</abbr>, '_Help' שיתורגם לעברית באופן הבא: '_עזרה' גם כן עם קו תחתון מוביל לאות 'ע'. בתפריטים השונים המילה תוצג כ'<u>ע</u>זרה' עם קו מתחת לאות 'ע'. בלחיצה על מקש {{man key press|ALT|ע}} ניתן לבחור או למקד את הסמן על 'עזרה' (בדגמה זו).
סמלים רומזים לא חייבים להיות ייחודיים במסך או בתפריט, אם כי זה יכול להיות נחמד. כאשר הסמלים הרומזים אינם ייחודיים, המשתמש יצטרך ללחוץ שוב ושוב על {{man key press|ALT|ע}} (בהמשך לדוגמה לעיל) כדי לעבור בין ערכים שונים שמקש ההאצה שלהם היא האות 'ע'. עם זאת, חשוב לשים לב לכלל הבא:
*"כששכפול מקשי האצה בחלון הוא בלתי נמנע, יש בכול זאת להימנע משכפול תקשי האצה לכול אחד מהלחצנים הבאים באותו חלון: {{man button|בסדר}}, {{man button|ביטול}}, {{man button|סגירה}}, {{man button|החלה}} או {{man button|עזרה}}."

לכן צריך לבדוק מהם מקשי ההאצה בשפת היעד לאותם לחצנים, ולהימנע משימוש בתורגם בסימון קו תחתון מוביל לאות זהה בלחצנים הללו.
{{man warn|אזהרה|מספר משפחות גופנים לא מציגות תוי האצה באופן תקין באותיות באנגלית "g", "j", "p", "q" or "y" כיוו שהאות מודפסת על גבי הקו התחתון  מה שמשקשה מאוד להבחין בקו התחתון. באופן דומה כל האותיות הסופיות בעברית שגולשות אל מתחת לשורה כמו 'ף', 'ך', 'ן', 'ץ,' ו־'ק'  יתנהגו ברופן דומה לכן יש להימנע משימוש באותיות אלו כמאיצים. כמו כן כדאי גם להימנע משימוש באותיות 'i', 'ו', 'l', 'ן', 'ם', 'ס' מכיוון שאנשים מתקשים להבחין ביניהם.}}

אין בעיה באותיות רישיות באנגלית, בהדגשת <abbr title="exempli gratia - ביטוי לטיני שמשמעותו 'לדוגמה'">לדוגמה</abbr>, G יעבוד מצוין מכיוון שהאות לא גולשת מהשורה.

===תרגום יחסי־קרבה===
קשרי־קרבה אינם נכללים במסגרת קובצי ה־<code>.po</code>, למעט מחרוזות <code>אב</code> ו<code>אם</code> מזדמנות פה ושם שמופיעות במנשק המשתמש ובדוחות. תרגום קשרי־קרבה הם ייחדיים לשפה או לתרבות מסויימות לכן המנגנון שמטפל בהן נעשה בתוסף 'מחשבון קשרי־קרבה', כך גם התרגום שנכלל בקובצי אותו תוסף.

הצורך בתוסף נובע מחוסר האפשרות לתרגם "בן דוד ראשון מוסט פעמיים" בשפות כגון, <abbr title="exempli gratia - ביטוי לטיני שמשמעותו 'לדוגמה'">לדוגמה</abbr>, גרמנית או רוּסִית. לפרטים על הצורך בתוסף זה וכיצד לייצור אותו בשפה העברית (או שפות אחרות) נא לעיין בעמוד [[Relationship Calculator|קשרי־קירבה]].

===תרגום תאריכים===
הטיפול בתרגום תאריכים לא מתבצע במלואו בתוך קבצי ה־<code>.po</code>. טיפול מלא בתרגום תאריכים לשפה או תרבות מסויימת נעשה בתוך פרקן סדרן תאריכים ייעודי.

הצורך בפרקן נפרד נובע מהדרישות לטיפול בניתוח והצגת תאריכים יעודית לתרבות מסוימת. לדוגמה, סדר החודשים והימים שונים בין רוב מדינות אירופהלאלו הנהוגים בארצות הברית לדוגמה. כמו כן, לכל שפה יש קבוצת מאפיינים מקובלים משלה שמתאימים למצג התאריך: דברים כמו "מ־X ל־Y" או "בין X ל־Y" עשויים להיות בעלי סדר מילים שונה. דומה הדבר לביטויים כמ "בקרוב", "מחושב", "משוער". אם נוסיף ללוח השנה הזה גם שמות חודשים וימים, שמות לוחות שנה (שבעה במספר), והרי הנימוקים לצורך בפרקן ייעודי.  לפרטים על מדוע וכיצד לייצור פרקן כז, נא לעיין בעמוד [[Date Handler|סדרן תאריכים]].

==תרגום עמודי man==

{{man warn|על שינוי סביבה|לגרמפס 4.0, {{stable_branch}} ו־master, נא לעיין ב[[Translation_environment4#Translating_man_pages|סביבה חדשה]].}}

ניתן לתרגם לכול שפה, לרבות לעברית, גם את דפי ה־man.
לשם כך נדרשת לפחות חבילת [https://pypi.org/project/docutils-ast-writer/ docutils] של פייתון, אותה ניתן להתקין, בסביבת לינוקס ממסוף, באמצאות הפקודה <code>pip install docutils-ast-writer</code>.<br>
קובצי המקור הנדרשים כהכנה לעבודת התרגום ימצאו במחיצת ה־data/man של גרסת הפיתוח (ענף master), שם ימצאו הקבצים הבאים:
*conf.py
*gramps.1.in
*update_man.py
*en.rst
*index.rst
*update_man.py
:זאת בנוסף על התיקיות עבור דפי ה־man לשפות שכבר תורגמו (קוד שפה בתסדיר xx) ['sv', 'nl', 'pl', 'cs', 'pt_BR', 'fr', 'xx'].
<br>
<h4>
להלן סדר הפעולות אותן יש לבצע לתרגום דפים אלו:
</h4>
<ol>
<li> תחילה נדרש ליצור תיקייה עבור שפת היעד במחיצה [https://github.com/gramps-project/gramps/tree/master/data/man data/man].</li>
:  לשם כך נדרש להשתמש ב־Git. לקריאה נוספת [[Brief_introduction_to_Git|מבוא ל־Git]]
:במערכות מבוססות לינוקס ניתן לייצור את התיקייה ממסוף באמצעות הפקודה
 <div dir="ltr">
 <code>cd data/man</code>
 <code>mkdir xx</code>
 </div>
:כאשר xx הוא [https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes קוד השפה הרצויה] (fr לצרפתית, sv לשוודית, he לעברית וכן הלאה).
<li>לתוך התקייה שזה עתה נוצרה, יש להעתיק ממחיצת ה־data/man את הקובץ en.rst ולשנות את שמו לקוד שפת היעד, לדוגמה he.rst עבור עברית</li>
<li> לתרגם את כל המחרוזות שמצריכות תרגום בקובץ data/man/xx/xx.rst.</li>
<li>לערוך את הקובץ [https://github.com/gramps-project/gramps/blob/master/data/man/update_man.py data/man/update_man.py] ולחפש את השורה הבאה <code>LANGUAGES = ['sv ', 'nl', 'pl', 'cs', 'pt_BR', 'fr', 'xx']</code> כאשר 'xx' היא שפת היעד החדשה. לשמור את הקובץ (במחיצה המקורית וללא שינוי שמו).</li>
<li> ממסוף לינוקס, הפעלת הפקודה data/man/update_man.py:</li>
 <div dir="ltr">
 <code>$ python update_man.py -m</code>
 </div>
<li>לסיום, יש לקבע את כל השינויים ולדחוף אותם לשרת הפיתוח כפי שמתואר ב[[Brief_introduction_to_Git|מבוא ל־Git]]:</li>
 <div dir="ltr">
 git commit -am "Add man page for xx"
 git push
 </div> 
לצפיה בתוצאות עבודת התרגום בשפת היעד, ניתן להריץ את הפקודה הבאה:

 <div dir="ltr">
 man xx/gramps.1
 </div>

==תרגום מדריך הויקי==
על מנת לשפעל את קישורי העזרה בעת לחיצה על לחצן {{man button|F1}} בתוכנת גרמפס, נדרש קיומו  או עריכתו של המשתנה <code>MANUALS</code> באופן שיכיל את מקומי קוד השפה הרצויה בקובץ:

[https://github.com/gramps-project/gramps/blob/master/gramps/gui/display.py display.py] בגרמפס 4 או גרסאות מאוחרות יותר

או

GrampsDisplay.py לגרסת 3 או מוקדמות יותר


בסביבות שורה 41 בקובץ, ניתן למצוא את המקטע שנראך כך:
<div dir="ltr">

 #list of manuals on wiki, map locale code to wiki extension, add language codes
 #completely, or first part, so pt_BR if Brazilian portugeze wiki manual, and
 #nl for Dutch (nl_BE, nl_NL language code)
 
 MANUALS = {
    'nl' : '/nl',
    'fr':  '/fr',
 }
</div>

ערכים אלה ממפים קוד השפה לתוסף בויקי, כך לדוגמה, כדי להוסיף עברית, נדרש לשנות אתהמקטע ולהוסיף שורה:
<div dir="ltr">
 MANUALS = {
    'nl' : '/nl',
    'fr':  '/fr',
    ''''he':  '/he','''
 }
</div>
*כל ערך '<code>manual|...</code>' בקובץ <code>gramps.pot</code> מתייחס למקטע מסומים במדריך, לכן יש להקפיד להשתמש בכותרות טובות לסעיפים כדי שזה לא ישתנה יותר מדי לאורך הזמן.
לתשומת לב, דוחות וכלים מקושרים למקטע בעמוד המדריך עם שם זהה לשם הדוח בגרמפס.

*ניתן לערוך ישירות את עמודי הויקי במרשתת או לחלופין באמצעות כלים כמו [http://translate.sourceforge.net/wiki/toolkit/txt2po txt2po] או [http://po4a.org/ po4a]. כך גם קובץ gettext הקודם של המדריך ו[http://en.wikipedia.org/wiki/Translation_memory זיכרון תרגום] עשויים לעזור בשדרוג קובצי gettext מיושנים שיצאו משימוש. <abbr title="exempli gratia - ביטוי לטיני שמשמעותו 'לדוגמה'">לדוגמה,</abbr>, מאחסן ערכים קיימים מ־''/usr/share/locale''.

==עמודים יעודיים לשפות==
בקישורים הבאים ניתן לבדוק את העמודים היעודיים למספר היבטי תרגום לשפה מסוימת, כגון מילון המונחים, מדיניות וכללים לתרגום ועוד.
*[[Translation into Finnish|פינית]]
*[[Translation into French|צרפתית (Français)]]
*[[Translation into Russian|רוסית]]
*[[Translation into Hebrew|עברית]]

==תרגום מתקעים ותוספים==

* הנחיות לגבי תוספים ניתן למצוא בעמוד [[Addons_development#Get_translators_to_translate_your_addon_into_multiple_languages|תוספי צד שלישי עבור גרמפס]].

[[Category:He:פיתוח]]
[[Category:He:תרגום]]