כללים והתנהגות עריכה מבניים

בקטע הזה מתוארים התנהגויות ומגבלות שחשוב להבין כשעורכים מסמכים באמצעות Google Docs API.

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

בקטעים הבאים מפורט סיכום של כללי המפתחות בשיטות האלה.

הוספת טקסט

  • הוספת תו של שורה חדשה יוצרת באופן משתמע את הערך Paragraph באותו אינדקס. סגנון הפסקה של הפסקה החדשה מועתק מהפסקה שמופיעה במדד ההוספה הנוכחי, כולל רשימות ותווי כוכב.
  • צריך להוסיף טקסט בתוך גבולות של Paragraph קיים. לדוגמה, אי אפשר להוסיף טקסט באינדקס ההתחלה של טבלה. צריך להוסיף את הטקסט לפסקה הקודמת.
  • ה-API עשוי לשנות את המיקום באופן משתמע כדי למנוע הוספה של תוכן בתוך אשכולות של גרפימות ב-Unicode. במקרה כזה, הטקסט מוכנס מיד אחרי אשכול הגרפמות.
  • סגנונות הטקסט של הטקסט שהוכנס נקבעים באופן אוטומטי, בדרך כלל תוך שמירה על סגנון הטקסט הסמוך. בדרך כלל, סגנון הטקסט של הטקסט שנוסף תואם לטקסט שמופיע מיד לפני מדד ההוספה.
  • תווי בקרה מסוימים (U+0000-U+0008, U+000C-U+001F) ותווים מתחום השימוש הפרטי של מישור Unicode הבסיסי הרב-לשוני (U+E000-U+F8FF) מוסרים מהטקסט שהוכנס.
  • מידע נוסף זמין במאמר הוספה, מחיקה והעברה של טקסט.

הוספת תמונות מוטבעות

  • התמונה צריכה להיות בגודל של עד 50MB, לא יכולה לחרוג מ-25 מגה-פיקסל וצריך להיות לה אחד מהפורמטים הבאים: PNG,‏ JPEG או GIF.
  • ה-URI שסופק צריך להיות גלוי לכולם באורך של עד 2KB.
  • צריך להוסיף את התמונה בתוך גבולות של Paragraph קיים. לדוגמה, אי אפשר להוסיף טקסט באינדקס ההתחלה של טבלה.
  • אי אפשר להוסיף תמונות בתוך הערה שוליים או בתוך משוואה.
  • מידע נוסף זמין במאמר הוספת תמונות בתוך הטקסט.

עיצוב הטקסט

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

יצירת תבליטים של פסקאות

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

מחיקת הטקסט

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

  • אסור לבצע מחיקה שגורמת למבנה מסמך לא תקין. דוגמאות לבקשות מחיקה לא חוקיות:

    • מחיקה של יחידת קוד אחת מצמד חלופי.

    • מחיקת התו האחרון של שורת ההתחלה של Body,‏ Header,‏ Footer,‏ Footnote,‏ TableCell או TableOfContents.

    • מחיקת ההתחלה או הסוף של Table,‏ TableOfContents או Equation בלי למחוק את הרכיב כולו.

    • מחיקת התו של שורת חדשה לפני Table,‏ TableOfContents או SectionBreak בלי למחוק את הרכיב.

    • מחיקה של שורות או תאים ספציפיים בטבלה. מותר למחוק את התוכן בתא בטבלה.

  • מידע נוסף זמין במאמר הוספה, מחיקה והעברה של טקסט.