قواعد وسلوك التعديل الهيكلي

يصف هذا القسم السلوكيات والقيود التي يجب فهمها عند تعديل المستندات باستخدام واجهة برمجة تطبيقات "مستندات Google".

وبشكل عام، لا يمكنك تنفيذ التعديلات التي تتسبب في عدم صلاحية العناصر في المستند. راجِع كل طريقة من طرق طلب documents.batchUpdate للاطّلاع على القيود والقواعد التي تنطبق على هذه الطلبات.

تلخّص الأقسام التالية القواعد الأساسية لهذه الطرق.

إدراج نص

  • ويؤدي إدراج حرف جديد ضمنيًا إلى إنشاء رمز Paragraph في هذا الفهرس. يتم نسخ نمط الفقرة للفقرة الجديدة من الفقرة في فهرس الإدراج الحالي، بما في ذلك القوائم والتعداد النقطي.
  • يجب إدراج النص داخل حدود Paragraph حالية. على سبيل المثال، لا يمكن إدراج النص في فهرس بداية الجدول. يجب إدراج النص في الفقرة السابقة.
  • قد تعدّل واجهة برمجة التطبيقات الموقع الجغرافي ضمنيًا لمنع عمليات الإدراج ضمن مجموعات الرسومات البيانية في يونيكود. عندما يحدث هذا، يتم إدراج النص بعد مجموعة الرسم البياني مباشرةً.
  • يتم تحديد أنماط النص للنص المدرج تلقائيًا، مما يؤدي بشكل عام إلى الحفاظ على نمط النص المجاور. عادةً ما يتطابق نمط النص للنص المدرج مع النص قبل فهرس الإدراج مباشرةً.
  • تتم إزالة بعض أحرف التحكّم (U+0000-U+0008, U+000C-U+001F) والأحرف من المساحة الخاصة التي يستخدمها نموذج يونيكود الأساسي المتعدد اللغات (U+E000-U+F8FF) من النص المدرَج.
  • لمزيد من المعلومات، يُرجى الاطّلاع على المقالة إدراج النص وحذفه ونقله.

إدراج صور مضمَّنة

  • يجب أن يكون حجم الصورة أقل من 50 ميغابايت، ولا يمكن أن يتجاوز 25 ميغا بكسل، ويجب أن تكون بأحد التنسيقات التالية: PNG أو JPEG أو GIF.
  • يجب أن يكون معرّف الموارد المنتظم (URI) المقدّم متاحًا للجميع، ولا يزيد حجمه عن 2 كيلوبايت.
  • يجب إدراج الصورة ضمن حدود Paragraph حالية. على سبيل المثال، لا يمكن إدراج النص في فهرس بداية الجدول.
  • ولا يمكن إدراج الصور داخل حاشية سفلية أو معادلة.
  • لمزيد من المعلومات، يُرجى الاطّلاع على إدراج صور مضمَّنة.

تنسيق النص

  • عند تطبيق التنسيق على مستوى الفقرة على نطاق، يتم تطبيق التنسيق على أي فقرة تتداخل جزئيًا أو كليًا مع هذا النطاق.
  • ويمكن توسيع النطاق ليشمل سطورًا جديدة مجاورة.
  • إذا كان النطاق يحتوي بالكامل على فقرة تنتمي إلى قائمة، فسيتم أيضًا تحديث التعداد النقطي للفقرة بنمط النص المطابق.
  • لمعرفة مزيد من المعلومات، يُرجى الاطّلاع على تنسيق النص.

إنشاء التعداد النقطي للفقرات

  • تنشئ رموزًا نقطية لكل الفقرات التي تتداخل مع النطاق المحدّد.
  • يتم تحديد مستوى التداخل لكل فقرة من خلال عدد علامات التبويب البادئة قبل كل فقرة.
  • تتم إزالة علامات التبويب البادئة عند إنشاء الرموز النقطية، مما قد يؤدي إلى تغيير فهارس أجزاء النص.
  • إذا أضفت التعداد النقطي للفقرات التي تتطابق مع تلك الموجودة في القائمة قبل الفقرة المستهدفة مباشرة، فسيتم ضم الفقرة إلى القائمة.
  • لمزيدٍ من المعلومات، يُرجى الاطّلاع على العمل باستخدام القوائم.

حذف النص

  • قد يؤدي حذف النص الذي يتخطى حدود الفقرة إلى حدوث تغييرات في أنماط الفقرات والقوائم والكائنات ذات الموضع والإشارات المرجعية عند دمج الفقرتين.

  • لا يُسمح بعمليات الحذف التي تتسبب في بنية مستند غير صالحة. تتضمن بعض الأمثلة على طلبات الحذف غير الصالحة ما يلي:

    • حذف وحدة رمز واحدة لزوج بديل.

    • حذف آخر حرف سطر جديد من Body أو Header أو Footer أو Footnote أو TableCell أو TableOfContents.

    • حذف بداية أو نهاية Table أوTableOfContents أو Equation بدون حذف العنصر بالكامل.

    • حذف حرف السطر الجديد قبل Table أو TableOfContents أو SectionBreak بدون حذف العنصر.

    • حذف صفوف أو خلايا فردية من الجدول. يُسمح بحذف المحتوى الموجود في خلية الجدول.

  • لمزيد من المعلومات، يُرجى الاطّلاع على المقالة إدراج النص وحذفه ونقله.