كيفية تدوير صفحات PDF باستخدام Rest API في Ruby

كيفية قلب صفحات PDF باستخدام Rest API في Ruby

دعونا نستكشف السيناريوهات المتعلقة بالتناوب في وثائق PDF. يمكنك تدوير جميع الصفحات أو صفحات PDF معينة برمجيًا باستخدام Ruby في تطبيقاتك. سنستعرض سيناريوهات تدوير صفحات PDF التالية بمساعدة أمثلة بسيطة لميزات تدوير PDF. في هذه المقالة ، سوف نتعلم كيفية تدوير صفحات PDF باستخدام REST API في Ruby.

سيتم تناول الموضوعات التالية في هذه المقالة:

واجهة برمجة تطبيقات استدارة صفحات PDF و Ruby SDK

يمكنك تدوير الصفحات بتعيين زوايا دوران مثل 90 أو 180 أو 270 درجة باستخدام GroupDocs.Merger API. لتدوير ملفات PDF ، سأستخدم Ruby SDK of GroupDocs.Merger Cloud API. يسمح لك بتقسيم ودمج وإزالة وإعادة ترتيب صفحة واحدة أو مجموعة من الصفحات من تنسيقات المستندات المدعومة من Word ، Excel ، PDF ، [PowerPoint] 7 و HTML إلخ. يمكنك تثبيت GroupDocs.Merger Cloud SDK على تطبيق Ruby الخاص بك باستخدام الأمر التالي في الجهاز:

gem install groupdocs_conversion_cloud

يرجى الحصول على معرف العميل والسرية من لوحة التحكم قبل اتباع الخطوات المذكورة أدناه. بمجرد حصولك على المعرف والسرية ، أضف ما يلي في الكود كما هو موضح أدناه:

# قم بتحميل الأحجار الكريمة https://github.com/groupdocs-merger-cloud/groupdocs-merger-cloud-ruby في تطبيق Ruby لـ http://api.groupdocs.cloud
require 'groupdocs_merger_cloud'

# احصل على client_id و client_secret من https://dashboard.groupdocs.cloud بعد التسجيل المجاني.
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

بمجرد تكوين API بنجاح ، يمكنك استخدام التعداد التناوب لتحديد قيمة مناسبة للدوران في اتجاه عقارب الساعة.

قم بتدوير كل صفحات مستند PDF باستخدام Ruby

يمكنك تدوير صفحات PDF في مستند PDF برمجيًا على السحابة باتباع الخطوات الواردة أدناه. أولاً ، تحميل ملف PDF إلى السحابة وملف PDF الذي تم تحميله سيكون متاحًا في قسم الملفات من لوحة القيادة على السحابة. قد يكون هناك العديد من حالات الاستخدام التي تحتاج فيها إلى تدوير ملفات PDF. يمكنك تدوير جميع صفحات ملف PDF باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيل لـ PagesApi
  • بعد ذلك ، قم بإنشاء مثيل لـ RotateOptions
  • ثم قم بإنشاء مثيل FileInfo
  • قم بتوفير مسار مستند إدخال PDF ومسار ملف الإخراج
  • بعد ذلك ، قم بتعيين تدوير الصفحة المطلوب مثل Rotate90
  • بعد ذلك ، قم بإنشاء RotateRequest باستخدام RotateOptions كوسيطة
  • أخيرًا ، قم باستدعاء طريقة rotate() واحفظ مستند PDF الناتج

يوضح مقتطف الشفرة التالي كيفية تدوير جميع صفحات ملف PDF باستخدام REST API في Ruby:

# يوضح مثال الرمز هذا كيفية تدوير كل الصفحات في مستند PDF.
# قم بإنشاء مثيل جديد من PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# تهيئة RotateOptions
@options = GroupDocsMergerCloud::RotateOptions.new
@options.file_info = GroupDocsMergerCloud::FileInfo.new
@options.file_info.file_path = 'flip_pages/pdf-pages.pdf'
@options.output_path = "flip_pages/rotate90-pages.pdf"
# اضبط تدوير الصفحة المطلوب على 90 أو 180 أو 270 درجة.
@options.mode = "Rotate90"

# قم بتدوير الصفحات في ملف PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated all pages in PDF file using Rest API.")

أخيرًا ، سيحفظ نموذج الكود أعلاه ملف PDF المحدث على السحابة.

قم بتدوير صفحات معينة من ملف PDF باستخدام Ruby

يتم تطبيق التدوير في مستند PDF على مستوى الصفحة. لذلك ، يمكنك أيضًا تدوير صفحات معينة من ملف PDF وفقًا لمتطلباتك. ما عليك سوى اختيار رقم الصفحة التي تريد تطبيق التدوير عليها. توضح الخطوات أدناه كيفية تدوير صفحات معينة من ملف PDF:

  • أولاً ، أنشئ مثيلاً لـ PagesApi
  • بعد ذلك ، قم بإنشاء مثيل لـ RotateOptions
  • ثم قم بإنشاء مثيل FileInfo
  • قم بتوفير مسار مستند إدخال PDF ومسار ملف الإخراج
  • قم بتعيين أرقام الصفحات الدقيقة باستخدام مجموعة الصفحات
  • قم بتعيين تدوير الصفحة المطلوب مثل Rotate90 أو Rotate180 أو Rotate270
  • بعد ذلك ، قم بإنشاء RotateRequest باستخدام RotateOptions كوسيطة
  • أخيرًا ، قم باستدعاء طريقة rotate() واحفظ مستند PDF الناتج

يوضح مقتطف الشفرة التالي كيفية تدوير صفحات معينة أو معينة في مستند PDF باستخدام Ruby:

# يوضح مثال الكود هذا كيفية تدوير الصفحات في ملفات PDF.
# تهيئة مثيل جديد لـ PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# تهيئة RotateOptions
@options = GroupDocsMergerCloud::RotateOptions.new
@options.file_info = GroupDocsMergerCloud::FileInfo.new
@options.file_info.file_path = 'flip_pages/pdf-pages.pdf'
@options.output_path = "flip_pages/rotate180-pages.pdf"
# قم بتوفير أرقام الصفحات الدقيقة بدءًا من 1 عبر مجموعة الصفحات
@options.pages = [1, 7]
@options.mode = "Rotate180"

# قم بتدوير الصفحات في ملف PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated PDF specific pages using Rest API.")

أخيرًا ، سيحفظ نموذج الكود أعلاه ملف PDF الناتج على السحابة.

قم بتدوير صفحات PDF عن طريق توفير رقم الصفحة باستخدام Ruby

يمكنك أيضًا تدوير صفحات PDF حسب رقم الصفحة. تحتاج إلى توفير رقم صفحة البداية ورقم صفحة النهاية لتطبيق التدوير. توضح الخطوات أدناه كيفية تدوير صفحات PDF حسب أرقام الصفحات لملف PDF:

  • أولاً ، أنشئ مثيلاً لـ PagesApi
  • بعد ذلك ، قم بإنشاء مثيل لـ RotateOptions
  • ثم قم بإنشاء مثيل FileInfo
  • قم بتوفير مسار مستند إدخال PDF ومسار ملف الإخراج
  • تعيين رقم صفحة البداية وقيم رقم صفحة النهاية ؛
  • قم بتعيين تدوير الصفحة المطلوب مثل Rotate270
  • بعد ذلك ، قم بإنشاء RotateRequest باستخدام RotateOptions كوسيطة
  • أخيرًا ، قم باستدعاء طريقة rotate() واحفظ مستند PDF الناتج

يوضح مقتطف الشفرة أدناه كيفية تدوير الصفحات في مستند PDF عن طريق توفير أرقام الصفحات باستخدام Ruby Rest API:

# يوضح مثال الكود هذا كيفية تدوير مستندات PDF.
# تهيئة مثيل جديد لـ PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# تهيئة RotateOptions
@options = GroupDocsMergerCloud::RotateOptions.new
@options.file_info = GroupDocsMergerCloud::FileInfo.new
@options.file_info.file_path = 'flip_pages/pdf-pages.pdf'
@options.output_path = "flip_pages/rotate270-pages.pdf"
# حدد نطاق الصفحات أرقام البداية والنهاية
@options.start_page_number = 1
@options.end_page_number = 5
@options.mode = "Rotate270"

# قم بتدوير الصفحات في ملف PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated 270 degree PDF document using Rest API.")

سيحفظ مثال الرمز أعلاه مستند PDF الناتج على السحابة.

قم بتدوير صفحات PDF عن طريق ضبط وضع النطاق باستخدام Ruby

يمكنك تدوير الصورة في مستند PDF أثناء إضافة أو إدراج الصورة في ملف PDF. يمكن أن يكون مفيدًا عندما تريد تحديث أو تغيير اتجاه الصورة. يمكنك اتباع هذه الخطوات لتدوير الصورة على صفحة PDF:

  • أولاً ، أنشئ مثيلاً لـ PagesApi
  • بعد ذلك ، قم بإنشاء مثيل لـ RotateOptions
  • ثم قم بإنشاء مثيل FileInfo
  • قم بتوفير مسار مستند إدخال PDF ومسار ملف الإخراج
  • قم بتعيين تدوير الصفحة المطلوب مثل Rotate180
  • بعد ذلك ، قم بتعيين رقم صفحة البداية وقيم رقم صفحة النهاية ؛
  • الآن ، اضبط وضع النطاق على EvenPages أو OddPages أو AllPages
  • بعد ذلك ، قم بإنشاء RotateRequest باستخدام RotateOptions كوسيطة
  • أخيرًا ، قم باستدعاء طريقة rotate() واحفظ مستند PDF الناتج

يوضح الكود التالي كيفية تدوير الصورة أو الصورة في مستند PDF برمجيًا باستخدام Ruby:

# يوضح مثال الرمز هذا كيفية تدوير الصفحات في مستند PDF.
# تهيئة مثيل جديد لـ PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# تهيئة RotateOptions
@options = GroupDocsMergerCloud::RotateOptions.new
@options.file_info = GroupDocsMergerCloud::FileInfo.new
@options.file_info.file_path = 'flip_pages/pdf-pages.pdf'
@options.output_path = "flip_pages/rotate180-pages.pdf"
@options.mode = "Rotate180"
# احصل فقط على الصفحات الزوجية أو الفردية من نطاق الصفحات المحدد عن طريق تعيين خاصية range_mode.
@options.start_page_number = 1
@options.end_page_number = 10
# اضبط وضع النطاق على "AllPages" أو "OddPages" أو "EvenPages"
@options.range_mode = "EvenPages"

# قم بتدوير الصفحات في مستند PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated Even PDF pages using Rest API.")

أخيرًا ، سيؤدي مقتطف الشفرة أعلاه إلى حفظ مستند PDF الناتج على السحابة.

قم بتدوير صفحات PDF عبر الإنترنت مجانًا

يرجى تجربة [أداة الإنترنت المجانية] التالية 18 لتدوير صفحات مستندات PDF ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه.

تلخيص لما سبق

لقد تعلمت في هذا المقال:

  • كيفية تدوير جميع الصفحات في مستند PDF باستخدام Ruby ؛
  • كيفية تدوير بعض ملفات PDF باستخدام Ruby ؛
  • كيفية تدوير صفحات PDF حسب رقم الصفحة باستخدام Ruby ؛
  • كيفية تدوير صفحات PDF حسب وضع النطاق باستخدام Ruby ؛

بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول GroupDocs.Merge Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. علاوة على ذلك ، تقوم groupdocs.cloud بكتابة منشورات مدونة جديدة حول مواضيع أخرى مثيرة للاهتمام. لذلك ، يرجى البقاء على اتصال للحصول على تحديثات منتظمة.

طرح سؤال

إذا كانت لديك أي استفسارات بخصوص تدوير صفحات pdf ، فلا تتردد في سؤالنا على منتدى الدعم المجاني

أنظر أيضا