תגי עיצוב של 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.

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