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

يوضّح هذا القسم السلوكيات والقيود التي يجب فهمها عند تعديل المستندات باستخدام Google Docs API.

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

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

إدراج نص

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

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

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

تنسيق النص

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

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

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

حذف النص

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

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

    • حذف وحدة رمز واحدة من زوج العناصر البديلة

    • حذف الحرف الأخير لسلسلة جديدة في ملف برمجي من نوع Body، Header، Footer، Footnote، TableCell، أو TableOfContents

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

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

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

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