Feature/v2/remove pages (#4445)

# Description of Changes - Addition of the remove pages tool - Addition of the remove blank pages tool --- ## Checklist ### General - [ ] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [ ] I have read the [Stirling-PDF Developer Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md) (if applicable) - [ ] I have read the [How to add new languages to Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md) (if applicable) - [ ] I have performed a self-review of my own code - [ ] My changes generate no new warnings ### Documentation - [ ] I have updated relevant docs on [Stirling-PDF's doc repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/) (if functionality has heavily changed) - [ ] I have read the section [Add New Translation Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags) (for new translation tags only) ### UI Changes (if applicable) - [ ] Screenshots or videos demonstrating the UI changes are attached (e.g., as comments or direct attachments in the PR) ### Testing (if applicable) - [ ] I have tested my changes locally. Refer to the [Testing Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing) for more details.
2026-07-16 03:20:46 +02:00 · 2025-09-18 09:51:55 +01:00
parent 7ff1c66d09
commit 756cbc4780
14 changed files with 626 additions and 20 deletions
@@ -0,0 +1,41 @@
+import { useTranslation } from 'react-i18next';
+import { TooltipContent } from '../../types/tips';
+
+export const useRemoveBlanksTips = (): TooltipContent => {
+  const { t } = useTranslation();
+
+  return {
+    header: {
+      title: t("removeBlanks.tooltip.header.title", "Remove Blank Pages Settings"),
+    },
+    tips: [
+      {
+        title: t("removeBlanks.tooltip.threshold.title", "Pixel Whiteness Threshold"),
+        description: t("removeBlanks.tooltip.threshold.text", "Controls how white a pixel must be to be considered 'white'. This helps determine what counts as a blank area on the page."),
+        bullets: [
+          t("removeBlanks.tooltip.threshold.bullet1", "0 = Pure black (most restrictive)"),
+          t("removeBlanks.tooltip.threshold.bullet2", "128 = Medium gray"),
+          t("removeBlanks.tooltip.threshold.bullet3", "255 = Pure white (least restrictive)")
+        ]
+      },
+      {
+        title: t("removeBlanks.tooltip.whitePercent.title", "White Percentage Threshold"),
+        description: t("removeBlanks.tooltip.whitePercent.text", "Sets the minimum percentage of white pixels required for a page to be considered blank and removed."),
+        bullets: [
+          t("removeBlanks.tooltip.whitePercent.bullet1", "Lower values (e.g., 80%) = More pages removed"),
+          t("removeBlanks.tooltip.whitePercent.bullet2", "Higher values (e.g., 95%) = Only very blank pages removed"),
+          t("removeBlanks.tooltip.whitePercent.bullet3", "Use higher values for documents with light backgrounds")
+        ]
+      },
+      {
+        title: t("removeBlanks.tooltip.includeBlankPages.title", "Include Detected Blank Pages"),
+        description: t("removeBlanks.tooltip.includeBlankPages.text", "When enabled, creates a separate PDF containing all the blank pages that were detected and removed from the original document."),
+        bullets: [
+          t("removeBlanks.tooltip.includeBlankPages.bullet1", "Useful for reviewing what was removed"),
+          t("removeBlanks.tooltip.includeBlankPages.bullet2", "Helps verify the detection accuracy"),
+          t("removeBlanks.tooltip.includeBlankPages.bullet3", "Can be disabled to reduce output file size")
+        ]
+      }
+    ]
+  };
+};
@@ -0,0 +1,34 @@
+import { useTranslation } from 'react-i18next';
+import { TooltipContent } from '../../types/tips';
+
+export const useRemovePagesTips = (): TooltipContent => {
+  const { t } = useTranslation();
+
+  return {
+    header: {
+      title: t("removePages.tooltip.header.title", "Remove Pages Settings"),
+    },
+    tips: [
+      {
+        title: t("removePages.tooltip.pageNumbers.title", "Page Selection"),
+        description: t("removePages.tooltip.pageNumbers.text", "Specify which pages to remove from your PDF. You can select individual pages, ranges, or use mathematical expressions."),
+        bullets: [
+          t("removePages.tooltip.pageNumbers.bullet1", "Individual pages: 1,3,5 (removes pages 1, 3, and 5)"),
+          t("removePages.tooltip.pageNumbers.bullet2", "Page ranges: 1-5,10-15 (removes pages 1-5 and 10-15)"),
+          t("removePages.tooltip.pageNumbers.bullet3", "Mathematical: 2n+1 (removes odd pages)"),
+          t("removePages.tooltip.pageNumbers.bullet4", "Open ranges: 5- (removes from page 5 to end)")
+        ]
+      },
+      {
+        title: t("removePages.tooltip.examples.title", "Common Examples"),
+        description: t("removePages.tooltip.examples.text", "Here are some common page selection patterns:"),
+        bullets: [
+          t("removePages.tooltip.examples.bullet1", "Remove first page: 1"),
+          t("removePages.tooltip.examples.bullet2", "Remove last 3 pages: -3"),
+          t("removePages.tooltip.examples.bullet3", "Remove every other page: 2n"),
+          t("removePages.tooltip.examples.bullet4", "Remove specific scattered pages: 1,5,10,15")
+        ]
+      }
+    ]
+  };
+};