قوانین و رفتار ویرایش ساختاری

این بخش رفتارها و محدودیت‌هایی را توضیح می‌دهد که باید هنگام ویرایش اسناد با استفاده از Google Docs API درک کنید.

به طور کلی، شما نمی توانید ویرایش هایی را که باعث ساختار نامعتبر عناصر در یک سند می شود، اجرا کنید. هر روش درخواست documents.batchUpdate را برای محدودیت‌ها و قوانین اعمال شده برای آن درخواست‌ها بررسی کنید.

بخش‌های زیر قوانین کلیدی این روش‌ها را خلاصه می‌کند.

درج متن

  • درج یک کاراکتر خط جدید به طور ضمنی یک Paragraph در آن شاخص ایجاد می کند. سبک پاراگراف پاراگراف جدید از پاراگراف در نمایه درج فعلی، شامل لیست ها و گلوله ها، کپی می شود.
  • متن باید در محدوده یک Paragraph موجود درج شود. به عنوان مثال، متن را نمی توان در فهرست شروع جدول درج کرد. متن باید در پاراگراف قبل درج شود.
  • API ممکن است به طور ضمنی مکان را برای جلوگیری از درج در خوشه‌های گرافی یونیکد تنظیم کند. هنگامی که این اتفاق می افتد، متن بلافاصله بعد از خوشه نمودار درج می شود.
  • سبک های متن برای متن درج شده به طور خودکار تعیین می شوند و به طور کلی سبک متن همسایه را حفظ می کنند. به طور معمول، سبک متن برای متن درج شده با متن بلافاصله قبل از نمایه درج مطابقت دارد.
  • برخی از نویسه‌های کنترلی ( 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 بدون حذف عنصر.

    • حذف ردیف ها یا سلول های جداگانه یک جدول. حذف محتوا در سلول جدول مجاز است.

  • برای اطلاعات بیشتر، درج، حذف، و انتقال متن را ببینید.