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

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

עיצוב הטקסט

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

יצירת תבליטים בפסקה

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

מחיקת הטקסט

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

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

    • מחיקת יחידת קוד אחת של זוג חלופי.

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

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

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

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

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