Optimize 69 Watermark Java pages

.github/workflows/production.yml

@@ -26,23 +26,25 @@ jobs:
 
     # Steps represent a sequence of watermark that will be executed as part of the job
     steps:
-      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
-            submodules: true  # Fetch Hugo themes
-            fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
+            submodules: true
+            fetch-depth: 0
       - name: Checkout theme repo
-        uses: actions/checkout@main
+        uses: actions/checkout@v4
         with:
           repository: groupdocs/tutorials-theme
           token: ${{ secrets.REPO_TOKEN }}
           fetch-depth: 0
           path: themes/tutorials-theme
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
       - name: Install Theme Dependencies
         run: npm install
-        working-directory: ./themes/tutorials-theme      
-      # Step 2 - Sets up the latest version of Hugo
+        working-directory: ./themes/tutorials-theme
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v3
         with:
@@ -54,7 +56,6 @@ jobs:
         run:  npm install -D --save postcss-cli
       - name: Install Dependicies3
         run:  npm install -D postcss
-      # Also specifies the theme we want to use
       - name: Build
         run: hugo --configDir config/watermark --environment production --minify
 

.github/workflows/staging.yml

@@ -39,7 +39,11 @@ jobs:
           token: ${{ secrets.REPO_TOKEN }}
           ref: beta
           fetch-depth: 0
-          path: themes/tutorials-theme      
+          path: themes/tutorials-theme 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
       # Step 2 - Sets up the latest version of Hugo
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v2

content/arabic/java/pdf-document-watermarking/add-watermarks-pdf-pages-groupdocs-java/_index.md

@@ -0,0 +1,205 @@
+---
+date: '2026-05-22'
+description: تعلم كيفية وضع علامة مائية على ملفات PDF عن طريق إضافة علامات مائية نصية
+  وصورية إلى صفحات محددة باستخدام GroupDocs.Watermark للـ Java. اتبع هذا الدليل خطوة
+  بخطوة لحماية PDF فعّالة.
+keywords:
+- how to watermark pdf
+- add image watermark pdf
+- add text watermark pdf
+- add watermark pdf pages
+- apply watermark first page
+schemas:
+- author: GroupDocs
+  dateModified: '2026-05-22'
+  description: Learn how to watermark PDF files by adding text and image watermarks
+    to specific pages using GroupDocs.Watermark for Java. Follow this step‑by‑step
+    guide for effective PDF protection.
+  headline: 'How to Watermark PDF: Add Text and Image Watermarks to Specific Pages
+    Using GroupDocs.Watermark for Java'
+  type: TechArticle
+- description: Learn how to watermark PDF files by adding text and image watermarks
+    to specific pages using GroupDocs.Watermark for Java. Follow this step‑by‑step
+    guide for effective PDF protection.
+  name: 'How to Watermark PDF: Add Text and Image Watermarks to Specific Pages Using
+    GroupDocs.Watermark for Java'
+  steps:
+  - name: Verify Maven or JDK installation.
+    text: Verify Maven or JDK installation.
+  - name: Import the required classes into your Java source file.
+    text: Import the required classes into your Java source file.
+  - name: '**Create the `TextWatermark`** – define the text, font, size, and color.'
+    text: '**Create the `TextWatermark`** – define the text, font, size, and color.'
+  - name: '**Configure page selection** – use `PdfArtifactWatermarkOptions` to target
+      page 1.'
+    text: '**Configure page selection** – use `PdfArtifactWatermarkOptions` to target
+      page 1.'
+  - name: '**Add the watermark** – call `watermarker.add(textWatermark, options)`.'
+    text: '**Add the watermark** – call `watermarker.add(textWatermark, options)`.'
+  - name: '**Save the result** – `watermarker.save("output.pdf")`.'
+    text: '**Save the result** – `watermarker.save("output.pdf")`.'
+  - name: '**Create the `ImageWatermark`** – supply the image file path and optional
+      dimensions.'
+    text: '**Create the `ImageWatermark`** – supply the image file path and optional
+      dimensions.'
+  - name: '**Set page filter** – `PdfArtifactWatermarkOptions.setPageNumber(3)` targets
+      page 3.'
+    text: '**Set page filter** – `PdfArtifactWatermarkOptions.setPageNumber(3)` targets
+      page 3.'
+  - name: '**Apply and save** – add the watermark via `watermarker.add` and persist
+      the document.'
+    text: '**Apply and save** – add the watermark via `watermarker.add` and persist
+      the document.'
+  type: HowTo
+- questions:
+  - answer: Yes, call `watermarker.add` for each watermark type with the same page
+      filter; they will be layered in the order added.
+    question: Can I add both text and image watermarks to the same page?
+  - answer: Absolutely. Pass the password to `PdfLoadOptions` when constructing the
+      `Watermarker`.
+    question: Does GroupDocs.Watermark work with password‑protected PDFs?
+  - answer: The library handles PDFs up to **2 GB** without loading the entire file
+      into memory, thanks to its streaming architecture.
+    question: What is the maximum file size I can process?
+  - answer: Set the opacity property on the watermark object (e.g., `textWatermark.setOpacity(0.5)`).
+    question: Is there a way to make the watermark semi‑transparent?
+  - answer: Java 8, 11, and 17 are fully supported; newer LTS releases work as well.
+    question: Which Java versions are supported?
+  type: FAQPage
+title: 'كيفية وضع علامة مائية على PDF: إضافة علامات مائية نصية وصورية إلى صفحات محددة
+  باستخدام GroupDocs.Watermark للـ Java'
+type: docs
+url: /ar/java/pdf-document-watermarking/add-watermarks-pdf-pages-groupdocs-java/
+weight: 1
+---
+
+# كيفية وضع علامة مائية على PDF: إضافة علامات مائية نصية وصورية إلى صفحات محددة باستخدام GroupDocs.Watermark للغة Java
+
+في بيئة الرقمية سريعة الحركة اليوم، **كيفية وضع علامة مائية على pdf** للملفات بأمان هي مصدر قلق رئيسي للمطورين ومالكي المحتوى. سواء كنت بحاجة إلى توثيق الملكية، أو الإشارة إلى حالة مسودة، أو حماية البيانات السرية، فإن إضافة علامات مائية إلى صفحات PDF المختارة يمنحك تحكمًا دقيقًا دون تعديل المستند بالكامل. يشرح هذا الدليل كيفية إضافة كل من العلامات المائية النصية والصورية إلى صفحات محددة باستخدام GroupDocs.Watermark للغة Java.
+
+## إجابات سريعة
+- **هل يمكنني استهداف صفحات فردية؟** نعم، يمكنك تطبيق العلامات المائية على أي فهرس صفحة تحدده.  
+- **ما أنواع العلامات المائية المدعومة؟** العلامات المائية النصية والصورية مدعومة بالكامل.  
+- **هل أحتاج إلى ترخيص للتطوير؟** ترخيص تجريبي مجاني يعمل للاختبار؛ الترخيص المدفوع مطلوب للإنتاج.  
+- **ما نسخة Java المطلوبة؟** Java 8 أو أعلى؛ يُنصح باستخدام Maven لإدارة الاعتمادات.  
+- **هل يمكن وضع علامة مائية على ملفات PDF الكبيرة؟** GroupDocs.Watermark يعالج الملفات حتى 2 GB دون تحميل المستند بالكامل في الذاكرة.
+
+## ما هو “كيفية وضع علامة مائية على pdf”؟
+إنها عملية تضمين علامات مرئية أو غير مرئية—مثل سلاسل النص أو الصور—برمجيًا في صفحات PDF لتأكيد الملكية، أو الإشارة إلى حالة مسودة، أو تقييد الاستخدام. يمكن وضع هذه العلامات على صفحات فردية أو على المستند بأكمله، ويمكن تخصيصها من حيث النمط، والشفافية، والموقع.
+
+“كيفية وضع علامة مائية على pdf” تشير إلى عملية تضمين علامات مرئية أو غير مرئية—مثل سلاسل النص أو الصور—برمجيًا في صفحات PDF لتأكيد الملكية أو نقل قيود الاستخدام.
+
+## المتطلبات المسبقة
+- **GroupDocs.Watermark for Java** (الإصدار 24.11 أو أحدث).  
+- Maven أو استيراد JAR يدوي إلى مشروعك.  
+- معرفة أساسية بـ Java وبيئة تطوير (IntelliJ IDEA، Eclipse، إلخ).  
+- ملف PDF ترغب في حمايته.
+
+## إعداد GroupDocs.Watermark للغة Java
+
+### معلومات التثبيت
+
+Add the GroupDocs.Watermark repository and dependency to your `pom.xml`:
+
+```xml
+<repositories>
+   <repository>
+      <id>repository.groupdocs.com</id>
+      <name>GroupDocs Repository</name>
+      <url>https://releases.groupdocs.com/watermark/java/</url>
+   </repository>
+</repositories>
+
+<dependencies>
+   <dependency>
+      <groupId>com.groupdocs</groupId>
+      <artifactId>groupdocs-watermark</artifactId>
+      <version>24.11</version>
+   </dependency>
+</dependencies>
+```
+
+### التحميل المباشر
+
+يمكنك أيضًا تنزيل أحدث ملفات JAR من صفحة الإصدارات الرسمية: [إصدارات GroupDocs.Watermark للغة Java](https://releases.groupdocs.com/watermark/java/).
+
+### الحصول على الترخيص
+
+ابدأ برخصة تجريبية مجانية أو مؤقتة لاستكشاف الـ API. للاستخدام في الإنتاج، اشترِ رخصة كاملة هنا: [صفحة شراء GroupDocs](https://purchase.groupdocs.com/temporary-license).
+
+### التهيئة الأساسية والإعداد
+
+1. تحقق من تثبيت Maven أو JDK.  
+2. استورد الفئات المطلوبة إلى ملف المصدر Java الخاص بك.
+
+## كيفية إضافة علامة مائية نصية إلى الصفحة الأولى من PDF؟
+حمّل ملف PDF باستخدام Watermarker، أنشئ كائن TextWatermark، اضبط PdfArtifactWatermarkOptions لاستهداف الصفحة 1، أضف العلامة المائية عبر `watermarker.add`، واحفظ المستند. هذه السلسلة تضيف تغطية نصية مرئية فقط إلى الصفحة الأولى دون التأثير على الصفحات الأخرى.
+
+`Watermarker` هو الفئة الأساسية لتحميل المستندات وتطبيق العلامات المائية.  
+`TextWatermark` يمثل تغطية نصية يمكن تنسيقها بالخط، واللون، والدوران، والشفافية.  
+`PdfArtifactWatermarkOptions` يحدد الإعدادات لتطبيق العلامات المائية على صفحات PDF محددة.
+
+### دليل خطوة بخطوة
+1. **إنشاء `TextWatermark`** – حدد النص، الخط، الحجم، واللون.  
+2. **تهيئة اختيار الصفحة** – استخدم `PdfArtifactWatermarkOptions` لاستهداف الصفحة 1.  
+3. **إضافة العلامة المائية** – استدعِ `watermarker.add(textWatermark, options)`.  
+4. **حفظ النتيجة** – `watermarker.save("output.pdf")`.
+
+> **نصيحة احترافية:** اضبط `PdfLoadOptions.setReadOnly(true)` إذا كنت تحتاج فقط إلى إضافة العلامات المائية دون تعديل المحتوى الأصلي.
+
+## كيفية إضافة علامة مائية صورية إلى صفحة PDF محددة؟
+حمّل ملف PDF باستخدام Watermarker، أنشئ كائن ImageWatermark يشير إلى ملف الصورة، اضبط PdfArtifactWatermarkOptions إلى رقم الصفحة المطلوب (مثلاً، الصفحة 3)، أضف العلامة المائية عبر `watermarker.add`، واحفظ الملف. هذا يضيف تغطية صورة عالية الدقة فقط على الصفحة المختارة.
+
+`ImageWatermark` يضم صورة (PNG، JPEG، BMP) لتُوضع كعلامة مائية على صفحات PDF.  
+`PdfArtifactWatermarkOptions` يحدد الإعدادات لتطبيق العلامات المائية على صفحات PDF محددة.
+
+### خطوات التنفيذ
+1. **إنشاء `ImageWatermark`** – قدم مسار ملف الصورة والأبعاد الاختيارية.  
+2. **تعيين مرشح الصفحة** – `PdfArtifactWatermarkOptions.setPageNumber(3)` يستهدف الصفحة 3.  
+3. **التطبيق والحفظ** – أضف العلامة المائية عبر `watermarker.add` واحفظ المستند.
+
+```java
+import com.groupdocs.watermark.Watermarker;
+import com.groupdocs.watermark.options.PdfLoadOptions;
+import com.groupdocs.watermark.options.PdfArtifactWatermarkOptions;
+import com.groupdocs.watermark.watermarks.Font;
+import com.groupdocs.watermark.watermarks.TextWatermark;
+
+// Create a new instance of PdfLoadOptions
+PdfLoadOptions loadOptions = new PdfLoadOptions();
+
+// Initialize the Watermarker with your PDF file path and load options
+Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf\
+```
+
+## المشكلات الشائعة والحلول
+- **العلامة المائية لا تظهر:** تأكد من أن PDF غير محمي بكلمة مرور أو مشفر؛ قدم كلمة المرور عند التحميل إذا لزم الأمر.  
+- **تشويه الصورة:** اضبط `scaleFactor` أو قدم صورة مصدر ذات دقة أعلى.  
+- **الأداء على الملفات الكبيرة:** استخدم `PdfLoadOptions.setStreamSize(… )` لتمكين البث وتقليل استهلاك الذاكرة.
+
+## الأسئلة المتكررة
+
+**س: هل يمكنني إضافة كل من العلامات المائية النصية والصورية إلى نفس الصفحة؟**  
+ج: نعم، استدعِ `watermarker.add` لكل نوع علامة مائية مع نفس مرشح الصفحة؛ سيتم تراكبها بترتيب الإضافة.
+
+**س: هل يعمل GroupDocs.Watermark مع ملفات PDF المحمية بكلمة مرور؟**  
+ج: بالطبع. مرّر كلمة المرور إلى `PdfLoadOptions` عند إنشاء `Watermarker`.
+
+**س: ما هو الحد الأقصى لحجم الملف الذي يمكنني معالجته؟**  
+ج: المكتبة تتعامل مع ملفات PDF حتى **2 GB** دون تحميل الملف بالكامل في الذاكرة، بفضل بنية البث.
+
+**س: هل هناك طريقة لجعل العلامة المائية شبه شفافة؟**  
+ج: اضبط خاصية الشفافية على كائن العلامة المائية (مثلاً، `textWatermark.setOpacity(0.5)`).
+
+**س: ما إصدارات Java المدعومة؟**  
+ج: Java 8، 11، و17 مدعومة بالكامل؛ الإصدارات LTS الأحدث تعمل أيضًا.
+
+**آخر تحديث:** 2026-05-22  
+**تم الاختبار مع:** GroupDocs.Watermark 24.11 للغة Java  
+**المؤلف:** GroupDocs
+
+## دروس ذات صلة
+
+- [كيفية إضافة علامات مائية نصية وصورية إلى ملفات PDF في Java باستخدام GroupDocs.Watermark](/watermark/java/pdf-document-watermarking/groupdocs-watermark-java-pdf-watermarks/)
+- [كيفية إضافة علامة مائية نصية إلى تعليقات صور PDF باستخدام GroupDocs.Watermark للغة Java](/watermark/java/pdf-document-watermarking/add-text-watermark-pdf-annotations-java/)
+- [كيفية إضافة علامة مائية صورية في Java باستخدام GroupDocs.Watermark: دليل خطوة بخطوة](/watermark/java/image-watermarks/add-image-watermark-java-groupdocs/)