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

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

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

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

הוספת טקסט

  • הוספת תו של שורה חדשה יוצרת באופן משתמע את הערך Paragraph באותו אינדקס. סגנון הפסקה של הפסקה החדשה מועתק מהפסקה שבאינדקס ההוספה הנוכחי, כולל רשימות ותווי כוכב.
  • צריך להוסיף טקסט בתוך גבולות של Paragraph קיים. לדוגמה, אי אפשר להוסיף טקסט באינדקס ההתחלה של טבלה. צריך להוסיף את הטקסט לפסקה הקודמת.
  • ה-API עשוי לשנות את המיקום באופן משתמע כדי למנוע הוספה של קוד בתוך אשכולות של גרפימות ב-Unicode. במקרה כזה, הטקסט מוכנס מיד אחרי אשכול הגרפמות.
  • סגנונות הטקסט של הטקסט שהוכנס נקבעים באופן אוטומטי, בדרך כלל תוך שמירה על סגנון הטקסט הסמוך. בדרך כלל, סגנון הטקסט של הטקסט שנוסף תואם לטקסט שמופיע מיד לפני מדד ההוספה.
  • חלק מתווי הבקרה (U+0000-U+0008, U+000C-U+001F) ותווים מתחום השימוש הפרטי של מישור Unicode Basic Multilingual (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 בלי למחוק את הרכיב.

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

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