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

كتيب الشركة مكتوب في محرر مستندات Google. يمتد المستند على عدة صفحات وقد طُلب من الكاتب الآن إنشاء روابط بحيث ترتبط جميع الإشارات إلى اسم الشركة في المستند بالموقع الرسمي للشركة.

يمكن أن تستغرق هذه المهمة وقتًا طويلاً، ولكن باستخدام Google Apps Script، يمكن ربط كلمات محددة في المستند بشكل مجمّع بنقرة واحدة.

أضف الارتباطات التشعبية في مستندات Google

يوضح هذا المثال كيفية البحث عن كل تكرارات العبارة النصية واستبدالها، واسم الشركة في هذه الحالة، وإضافة روابط إلى موقع ويب معين.

const addLinks = () => {
  const searchPhrase = 'Digital Inspiration';
  const hyperlink = 'https://digitalinspiration.com/';

  const document = DocumentApp.getActiveDocument();
  const body = document.getBody();
  let search = null;

  while ((search = body.findText(searchPhrase, search))) {
    const searchElement = search.getElement();
    const startIndex = search.getStartOffset();
    const endIndex = search.getEndOffsetInclusive();
    searchElement.asText().setLinkUrl(startIndex, endIndex, hyperlink);
  }

  document.saveAndClose();
};

تغيير نص الارتباطات التشعبية في مستندات Google

بالنسبة للإصدار التالي من الكتيب، تم تغيير اسم الشركة ولكن نطاق موقع الويب هو نفسه. يُطلب من الكاتب تغيير كل مثيل لاسم الشركة في المستند ولكن لا ينبغي تعديل الارتباط التشعبي الأساسي.

const changeText = () => {
  const searchText = 'Blue Widgets Inc.';
  const replaceText = 'Orange Inc.';

  const document = DocumentApp.getActiveDocument();
  const body = document.getBody();
  let search = null;

  while ((search = body.findText(searchText, search))) {
    const searchElement = search.getElement();
    const startIndex = search.getStartOffset();
    const endIndex = search.getEndOffsetInclusive();

    const textElement = searchElement.asText();
    const existingLink = textElement.getLinkUrl(startIndex);
    textElement.deleteText(startIndex, endIndex);
    textElement.insertText(startIndex, replaceText);
    textElement.setLinkUrl(startIndex, startIndex + replaceText.length - 1, existingLink);
  }

  document.saveAndClose();
};

تغيير النص والارتباطات التشعبية في مستندات Google

توضح مقتطفات برنامج Apps Script التالية كيفية تغيير جميع مثيلات اسم الشركة وكذلك استبدال عنوان URL للموقع باسم نطاق آخر.

const changeTextWithUrl = () => {
  const searchText = 'Blue Widgets Inc.';
  const replaceText = 'Orange Inc.';
  const replaceUrl = 'https://digitalinspiration.com/';

  const document = DocumentApp.getActiveDocument();
  const body = document.getBody();
  let search = null;

  while ((search = body.findText(searchText, search))) {
    const searchElement = search.getElement();
    const startIndex = search.getStartOffset();
    const endIndex = search.getEndOffsetInclusive();

    const textElement = searchElement.asText();
    textElement.deleteText(startIndex, endIndex);
    textElement.insertText(startIndex, replaceText);
    textElement.setLinkUrl(startIndex, startIndex + replaceText.length - 1, replaceUrl);
  }

  document.saveAndClose();
};