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

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

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

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

إدراج نص

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

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

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

تنسيق النص

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

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

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

حذف النص

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

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

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

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

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

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

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

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