# Description of Changes
This pull request introduces dynamic document meta tag management and
improves URL routing and tool metadata handling in the frontend. The
most significant changes are the addition of a custom hook to update
document meta tags (including OpenGraph tags) based on the selected
tool, enhancements to the tool selection context for better URL
synchronization, and enrichment of the `Tool` type and tool registry
with more metadata.

**Dynamic document meta management:**

* Added a new `useDocumentMeta` hook that updates the page's `<title>`,
description, and OpenGraph meta tags based on the currently selected
tool, and restores the original values on cleanup.
(`frontend/src/hooks/useDocumentMeta.ts`)
* Integrated `useDocumentMeta` into `HomePageContent` so the document's
meta tags dynamically reflect the selected tool's metadata, improving
SEO and social sharing. (`frontend/src/pages/HomePage.tsx`)
[[1]](diffhunk://#diff-85c26b21681286c20e97a26a4912f0b91812776c9d4d0c54aa541fded2565c7eR2-R8)
[[2]](diffhunk://#diff-85c26b21681286c20e97a26a4912f0b91812776c9d4d0c54aa541fded2565c7eR17)
[[3]](diffhunk://#diff-85c26b21681286c20e97a26a4912f0b91812776c9d4d0c54aa541fded2565c7eR28-R37)

**Tool metadata and context improvements:**

* Enhanced the `Tool` type and tool registry to include `title` and
`description` fields, which are now translated and used throughout the
UI and meta tags. (`frontend/src/types/tool.ts`,
`frontend/src/hooks/useToolManagement.tsx`)
[[1]](diffhunk://#diff-0b557df7bd27ac90cd2f925ddd8ef8096ea2decfaee9a5c12a94dc7a03c64bfaR46)
[[2]](diffhunk://#diff-57f8a6b3e75ecaec10ad445b01afe8fccc376af6f8ad4d693c68cf98e8863273L116-R118)
* Updated the `ToolWorkflowContext` to use the new `Tool` type for
`selectedTool`, replacing the previous `ToolConfiguration` type.
(`frontend/src/contexts/ToolWorkflowContext.tsx`)
[[1]](diffhunk://#diff-9b36e2c06dddbcfba6cb66fd0b303b7860f88ca8b562bb2534af1ab50390d385L6-R8)
[[2]](diffhunk://#diff-9b36e2c06dddbcfba6cb66fd0b303b7860f88ca8b562bb2534af1ab50390d385L72-R72)

**URL routing and synchronization:**

* Implemented logic in `ToolWorkflowContext` to synchronize the selected
tool with the browser URL, initialize tool selection from the URL on
load, and handle browser navigation (back/forward) for tool selection.
(`frontend/src/contexts/ToolWorkflowContext.tsx`)
---

## 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.
This commit is contained in:
Anthony Stirling
2025-08-14 15:52:38 +01:00
committed by GitHub
parent 22db7bec76
commit 8149cb157c
103 changed files with 845 additions and 574 deletions
+14 -14
View File
@@ -347,7 +347,7 @@
"title": "Girar",
"desc": "Gire facilmente seus PDFs."
},
"imageToPdf": {
"imageToPDF": {
"title": "Imagem para PDF",
"desc": "Converter uma imagem (PNG, JPG, GIF) em PDF."
},
@@ -371,7 +371,7 @@
"title": "Alterar Permissões",
"desc": "Alterar as permissões do seu PDF."
},
"removePages": {
"pageRemover": {
"title": "Remover Páginas",
"desc": "Excluir páginas indesejadas do seu PDF."
},
@@ -383,7 +383,7 @@
"title": "Desproteger PDF",
"desc": "Descriptografar o PDF realizando a remoção da senha."
},
"compressPdfs": {
"compress": {
"title": "Comprimir",
"desc": "Comprimir PDFs para reduzir o tamanho do arquivo."
},
@@ -479,7 +479,7 @@
"title": "Pipeline",
"desc": "Executar várias ações em PDFs seguindo scripts de operações."
},
"add-page-numbers": {
"addPageNumbers": {
"title": "Adicionar Números de Página",
"desc": "Adicionar números de página no documento, em um local definido."
},
@@ -487,7 +487,7 @@
"title": "Renomeação Automática do PDF",
"desc": "Renomeia automaticamente o PDF com base no cabeçalho detectado."
},
"adjust-contrast": {
"adjustContrast": {
"title": "Ajuste Visual do PDF",
"desc": "Ajustar Contraste, Saturação e Brilho de um PDF."
},
@@ -499,7 +499,7 @@
"title": "Divisão Automática de Páginas",
"desc": "Dividir automaticamente um PDF digitalizado utilizando um separador de páginas físico com QR Code."
},
"sanitizePdf": {
"sanitizePDF": {
"title": "Higienizar",
"desc": "Remover scripts, links, metadados e outros elementos de um PDF."
},
@@ -523,11 +523,11 @@
"title": "Obter Informações de um PDF",
"desc": "Obtém informações (metadata) de um PDF."
},
"extractPage": {
"pageExtracter": {
"title": "Extrair Página(s)",
"desc": "Extrair determinadas páginas de um PDF."
},
"PdfToSinglePage": {
"pdfToSinglePage": {
"title": "PDF para Página Única",
"desc": "Combina todas as páginas de um PDF em uma única página."
},
@@ -543,11 +543,11 @@
"title": "Ocultação de Texto Manual",
"desc": "Ocultação de texto manual baseada em um texto selecionado, desenho de formas ou/e páginas selecionadas."
},
"tableExtraxt": {
"PDFToCSV": {
"title": "PDF para CSV",
"desc": "Extração de tabelas de um PDF convertendo para CSV."
},
"autoSizeSplitPDF": {
"split-by-size-or-count": {
"title": "Divisão Manual do PDF",
"desc": "Divida um PDF em vários, com base no tamanho, contagem de páginas ou contagem de documentos."
},
@@ -563,11 +563,11 @@
"title": "Adicionar Carimbo ao PDF",
"desc": "Adicione texto ou carimbos de imagem em locais definidos."
},
"removeImagePdf": {
"removeImage": {
"title": "Remover Imagem",
"desc": "Remova imagens do PDF para reduzir o tamanho do arquivo."
},
"splitPdfByChapters": {
"splitByChapters": {
"title": "Divide PDF por Capítulos",
"desc": "Divide um PDF em vários arquivos baseado na sua estrutura de capítulos."
},
@@ -575,7 +575,7 @@
"title": "Verificar Assinatura com Certificado",
"desc": "Verifica assinatura digital e certificado em um PDF."
},
"replaceColorPdf": {
"replace-color": {
"title": "Substitui e Inverte Cores",
"desc": "Substitui cor do texto e plano de fundo de um PDF e/ou inverte a toda cor do PDF para reduzir o tamanho."
}
@@ -1558,4 +1558,4 @@
}
}
}
}
}