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

בקטע הזה מתוארים התנהגויות ומגבלות שצריך להבין כשעורכים מסמכים באמצעות 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 קיים. לדוגמה, אי אפשר להוסיף טקסט באינדקס ההתחלה של טבלה.
  • לא ניתן להוסיף תמונות להערת שוליים או משוואה.
  • מידע נוסף זמין במאמר הוספת תמונות בגוף ההודעה.

עיצוב הטקסט

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

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

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

מחיקת הטקסט

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

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

    • מחיקה של יחידת קוד אחת של זוג זמני אימות (surrogate).

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

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

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

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

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