টেক্সট ফরম্যাট করুন

এই পৃষ্ঠাটি আপনাকে Google ডক্স API ব্যবহার করে টেক্সট ফর্ম্যাট করার উপায় বলে।

বিন্যাস সম্পর্কে

দুটি ভিন্ন ধরনের বিন্যাস রয়েছে যা আপনি আপনার নথির পাঠ্য সামগ্রীতে প্রয়োগ করতে পারেন:

  • আপনি অক্ষর বিন্যাস পরিবর্তন করতে পারেন যেমন ফন্ট, রঙ, বা আন্ডারলাইনিং।
  • আপনি অনুচ্ছেদ বিন্যাস পরিবর্তন করতে পারেন যেমন ইন্ডেনশন বা লাইন স্পেসিং।

অক্ষর বিন্যাস পরিবর্তন

অক্ষর বিন্যাস আপনার নথিতে পাঠ্য অক্ষরের রেন্ডারিং নির্ধারণ করে।

আপনি যে কোনো বিন্যাস প্রয়োগ করেন তা অন্তর্নিহিত অনুচ্ছেদের TextStyle থেকে উত্তরাধিকারসূত্রে পাওয়া ডিফল্ট বিন্যাসকে ওভাররাইড করে। বিপরীতভাবে, যে কোনো অক্ষর যার বিন্যাস আপনি সেট করেন না তা অনুচ্ছেদের শৈলী থেকে উত্তরাধিকার সূত্রে প্রাপ্ত হতে থাকে।

পাঠ্যের অক্ষর বিন্যাস পরিবর্তন করতে, UpdateTextStyleRequest এর সাথে batchUpdate ব্যবহার করুন। আপনাকে একটি রেঞ্জ অবজেক্ট প্রদান করতে হবে যাতে নিম্নলিখিত তথ্য রয়েছে:

  • একটি segmentId যা চিহ্নিত করে কোন শিরোনাম, পাদচরণ, পাদটীকা—অথবা, অনির্দিষ্ট থাকলে, মূল অংশে—পাঠ্য রয়েছে।
  • startIndex এবং endIndex যা ফর্ম্যাট করার জন্য সেগমেন্টের মধ্যে পাঠ্যের পরিসর নির্ধারণ করে।

নিম্নলিখিত উদাহরণটি শিরোনামে থাকা পাঠ্যের উপর বেশ কয়েকটি টেক্সট স্টাইলিং অপারেশন করে:

  • 1-5 অক্ষরের ফন্টকে বোল্ড ইটালিকসে সেট করে।
  • অক্ষরের রঙ 6-10 থেকে blue 14-pt Times New Roman ফন্ট সেট করে।
  • www.example.com এ 11-15 অক্ষর হাইপারলিঙ্ক করে।

এটি করার একটি সহজ উপায় হল অনুরোধগুলির একটি তালিকা তৈরি করা এবং তারপর একটি ব্যাচআপডেট কল ব্যবহার করা:

জাভা

        List<Request> requests = new ArrayList<>();
        requests.add(new Request().setUpdateTextStyle(new UpdateTextStyleRequest()
                .setTextStyle(new TextStyle()
                        .setBold(true)
                        .setItalic(true))
                .setRange(new Range()
                        .setStartIndex(1)
                        .setEndIndex(5))
                .setFields("bold")));

        requests.add(new Request()
                .setUpdateTextStyle(new UpdateTextStyleRequest()
                        .setRange(new Range()
                                .setStartIndex(6)
                                .setEndIndex(10))
                        .setTextStyle(new TextStyle()
                                .setWeightedFontFamily(new WeightedFontFamily()
                                        .setFontFamily("Times New Roman"))
                                .setFontSize(new Dimension()
                                        .setMagnitude(14.0)
                                        .setUnit("PT"))
                                .setForegroundColor(new OptionalColor()
                                        .setColor(new Color().setRgbColor(new RgbColor()
                                                .setBlue(1.0F)
                                                .setGreen(0.0F)
                                                .setRed(0.0F)))))
                        .setFields("foregroundColor,weightedFontFamily,fontSize")));

        requests.add(new Request()
                .setUpdateTextStyle(new UpdateTextStyleRequest()
                        .setRange(new Range()
                                .setStartIndex(11)
                                .setEndIndex(15))
                        .setTextStyle(new TextStyle()
                                .setLink(new Link()
                                        .setUrl("www.example.com")))
                        .setFields("link")));


        BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
        BatchUpdateDocumentResponse response = docsService.documents()
                .batchUpdate(DOCUMENT_ID, body).execute();



পাইথন

    requests = [
        {
            'updateTextStyle': {
                'range': {
                    'startIndex': 1,
                    'endIndex': 5
                },
                'textStyle': {
                    'bold': True,
                    'italic': True
                },
                'fields': 'bold,italic'
            }
        },
        {
            'updateTextStyle': {
                'range': {
                    'startIndex': 6,
                    'endIndex': 10
                },
                'textStyle': {
                    'weightedFontFamily': {
                        'fontFamily': 'Times New Roman'
                    },
                    'fontSize': {
                        'magnitude': 14,
                        'unit': 'PT'
                    },
                    'foregroundColor': {
                        'color': {
                            'rgbColor': {
                                'blue': 1.0,
                                'green': 0.0,
                                'red': 0.0
                            }
                        }
                    }
                },
                'fields': 'foregroundColor,weightedFontFamily,fontSize'
            }
        },
        {
            'updateTextStyle': {
                'range': {
                    'startIndex': 11,
                    'endIndex': 15
                },
                'textStyle': {
                    'link': {
                        'url': 'www.example.com'
                    }
                },
                'fields': 'link'
            }
        }
    ]

    result = service.documents().batchUpdate(
        documentId=DOCUMENT_ID, body={'requests': requests}).execute()

অনুচ্ছেদ বিন্যাস পরিবর্তন

Google ডক্স API আপনাকে অনুচ্ছেদ বিন্যাস আপডেট করতে দেয়, যা নির্ধারণ করে কিভাবে পাঠ্যের ব্লকগুলি আপনার নথিতে রেন্ডার করা হয়, সারিবদ্ধকরণ এবং ইন্ডেন্টেশনের মতো বৈশিষ্ট্যগুলি সহ।

আপনি যে কোনো ফর্ম্যাটিং প্রয়োগ করেন তা অন্তর্নিহিত অনুচ্ছেদ শৈলী থেকে উত্তরাধিকারসূত্রে পাওয়া ডিফল্ট বিন্যাসকে ওভাররাইড করে। বিপরীতভাবে, যে কোনো বিন্যাস বৈশিষ্ট্য যা আপনি সেট করেন না তা অনুচ্ছেদ শৈলী থেকে উত্তরাধিকার সূত্রে প্রাপ্ত হতে থাকে। অনুচ্ছেদ শৈলী এবং উত্তরাধিকার সম্পর্কে আরও জানতে, অনুচ্ছেদ স্টাইল দেখুন।

নীচের উদাহরণ একটি অনুচ্ছেদের জন্য নিম্নলিখিত বিন্যাস নির্দিষ্ট করে:

  • নামযুক্ত শৈলী হিসাবে একটি শিরোনাম
  • উপরে কাস্টম ব্যবধান
  • নীচে কাস্টম ব্যবধান
  • একটি কাস্টম বাম সীমানা

অনুচ্ছেদের বাকি সমস্ত বিন্যাস বৈশিষ্ট্য অন্তর্নিহিত নামযুক্ত শৈলী থেকে উত্তরাধিকার সূত্রে প্রাপ্ত হয়।

জাভা

        List<Request> requests = new ArrayList<>();
        requests.add(new Request().setUpdateParagraphStyle(new UpdateParagraphStyleRequest()
                .setRange(new Range()
                        .setStartIndex(1)
                        .setEndIndex(10))
                .setParagraphStyle(new ParagraphStyle()
                        .setNamedStyleType("HEADING_1")
                        .setSpaceAbove(new Dimension()
                                .setMagnitude(10.0)
                                .setUnit("PT"))
                        .setSpaceBelow(new Dimension()
                                .setMagnitude(10.0)
                                .setUnit("PT")))
                .setFields("namedStyleType,spaceAbove,spaceBelow")
        ));

        requests.add(new Request().setUpdateParagraphStyle(new UpdateParagraphStyleRequest()
                .setRange(new Range()
                        .setStartIndex(10)
                        .setEndIndex(20))
                .setParagraphStyle(new ParagraphStyle()
                        .setBorderLeft(new ParagraphBorder()
                                .setColor(new OptionalColor()
                                        .setColor(new Color()
                                                .setRgbColor(new RgbColor()
                                                        .setBlue(1.0F)
                                                        .setGreen(0.0F)
                                                        .setRed(0.0F)
                                                )
                                        )
                                )
                                .setDashStyle("DASH")
                                .setPadding(new Dimension()
                                        .setMagnitude(20.0)
                                        .setUnit("PT"))
                                .setWidth(new Dimension()
                                        .setMagnitude(15.0)
                                        .setUnit("PT")
                                )
                        )
                )
                .setFields("borderLeft")
        ));

        BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
        BatchUpdateDocumentResponse response = docsService.documents()
                .batchUpdate(DOCUMENT_ID, body).execute();

পাইথন

    requests = [
        {
            'updateParagraphStyle': {
                'range': {
                    'startIndex': 1,
                    'endIndex':  10
                },
                'paragraphStyle': {
                    'namedStyleType': 'HEADING_1',
                    'spaceAbove': {
                        'magnitude': 10.0,
                        'unit': 'PT'
                    },
                    'spaceBelow': {
                        'magnitude': 10.0,
                        'unit': 'PT'
                    }
                },
                'fields': 'namedStyleType,spaceAbove,spaceBelow'
            }
        },
        {
            'updateParagraphStyle': {
                'range': {
                    'startIndex': 10,
                    'endIndex':  20
                },
                'paragraphStyle': {
                    'borderLeft': {
                        'color': {
                            'color': {
                                'rgbColor': {
                                    'blue': 1.0,
                                    'green': 0.0,
                                    'red': 0.0
                                }
                            }
                        },
                        'dashStyle': 'DASH',
                        'padding': {
                            'magnitude': 20.0,
                            'unit': 'PT'
                        },
                        'width': {
                            'magnitude': 15.0,
                            'unit': 'PT'
                        },
                    }
                },
                'fields': 'borderLeft'
            }
        }
    ]

    result = service.documents().batchUpdate(
        documentId=DOCUMENT_ID, body={'requests': requests}).execute()