תגי עיצוב של Translation API

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

אם אתם מפרסמים תוצאות של Cloud Translation API ללא שינוי ומאפשרים חיפוש שלהן באינטרנט, אתם נדרשים לציין שהטקסט המתורגם הוא תוכן שמתורגם על ידי מכונה. לדוגמה, ל-Google יש הנחיות איכות לגבי תוכן שנוצר באופן אוטומטי והנחיות לגבי מניעת הצגה של תוכן כזה בתוצאות החיפוש.

לקטעים קצרים או לחלקים במסמך HTML

עוטפים את הטקסט המתורגם בתגי <div lang="..."></div> (לבלוקים) או <span lang="..."></span> (למקاطع שורות) ומגדירים את מאפיין lang="" לקוד השפה המתאים, שנוצר באופן הבא:

  • כדי להגדיר את lang="", משתמשים בפורמט הבא: <קוד השפה שאליה תורגם הטקסט>-x-mtfrom-<קוד השפה המקורית>
  • לדוגמה, אם הטקסט המקורי הוא באנגלית והוא תורגם לצרפתית באמצעות תרגום מכונה, תג ה-HTML צריך להיות: <span lang="fr-x-mtfrom-en">Bonjour</span> או <div lang="fr-x-mtfrom-en"> Bonjour </div>

  • אם השפה המקורית או שפת היעד לא ידועות, צריך להשתמש בציון השפה 'und' כדי לציין שפה לא מוגדרת. לדוגמה, <span lang="und-x-mtfrom-und"> … </span> מציין ששפת המקור או שפת היעד לא נקבעו.

  • אפשר גם להוסיף מאפיין lang="" סביב הרכיב שכבר עוטף את הטקסט המתורגם. לדוגמה, אם התוצאות של Cloud Translation API שלא שונו הן בפסקה <p>, צריך להוסיף את lang="" ל-</p> כמו בדוגמה <p lang="ar-x-mtfrom-jp"> לטקסט שתורגם מיפנית לערבית).

למסמכים שלמים או לדפי אינטרנט

אם רוצים להגדיר שפה לדף שלם, כשמסמך המקור לא זמין אונליין או כשכתובת ה-URL של מסמך המקור עדיין לא ידועה, צריך להוסיף את המאפיין lang="" כמו שמתואר בקטע הקודם של האלמנט <html>:

<DOCTYPE HTML>
  <html lang="en-x-mtfrom-fr">
    <head>
      <title>The Bee</title>
        ...

אם המסמך המקורי זמין באינטרנט, מוסיפים את האלמנט <link> לקטע <head> של מסמך ה-HTML, עם המאפיין rel="" שמוגדר כ-"alternate machine-translated-from", המאפיין hreflang="" שמוגדר כקוד השפה המקורית, והמאפיין href="" שמוגדר כדף המקורי, כמו בדוגמה הבאה:

<DOCTYPE HTML>
  <html lang="en-x-mtfrom-fr">
    <head>
      <title>The Bee</title>
      <link rel="alternate machine-translated-from" hreflang="fr"
            href="http://fr.example.com/abeille.html">
    </head>
    <body>
        ...

קוד ה-HTML שלמעלה מציין שהדף הזה תורגם על ידי מכונה מצרפתית לאנגלית, והמסמך המקורי בצרפתית נמצא בכתובת הדמיונית http://fr.example.com/abeille.html.

בהמשך מפורטים קודי השפה: