mirror of https://github.com/Stirling-Tools/Stirling-PDF.git synced 2025-06-06 09:12:02 +00:00

Fix Tibetan locale code to bo_CN and update translation ignore configurations (#3614 )

# Description of Changes

## This PR also serves as a test for PR #3615.

### PR #3615 must first be merged to complete the test.

---

- **What was changed**  
- Replaced Tibetan locale code in README (`README.md`) from `zh_BO` to
`bo_CN`.
- Renamed resource file `messages_zh_BO.properties` to
`messages_bo_CN.properties` and updated its internal keys/translations.
- Updated the HTML fragment (`templates/fragments/languages.html`) to
reference `bo_CN` instead of `zh_BO`.
- Added a `[bo_CN]` section in `scripts/ignore_translation.toml` and
expanded ignore rules across multiple language sections to cover
additional codes.
- Enhanced `counter_translation.py` error handling: now catches
`ValueError` as `e` and logs file path and line number for easier
debugging.

- **Why the change was made**  
- The proper locale identifier for Tibetan is `bo_CN`, aligning with
[Localizely’s standard](https://localizely.com/locale-code/bo-CN/).
- Ensures consistency across code, resources, and templates so the
Tibetan translation loads correctly.
- Expanded ignore lists prevent false positives in translation coverage
checks, and improved error logging aids maintenance of the translation
scripts.

---

## Checklist

### General

- [x] I have read the [Contribution
Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md)
- [x] I have read the [Stirling-PDF Developer
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/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/HowToAddNewLanguage.md)
(if applicable)
- [x] I have performed a self-review of my own code
- [x] 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/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/DeveloperGuide.md#6-testing)
for more details.

2025-05-31 12:24:02 +01:00

9.5 KiB

Raw Blame History

Stirling-PDF

Stirling-PDF is a robust, locally hosted web-based PDF manipulation tool using Docker. It enables you to carry out various operations on PDF files, including splitting, merging, converting, reorganizing, adding images, rotating, compressing, and more. This locally hosted web application has evolved to encompass a comprehensive set of features, addressing all your PDF requirements.

All files and PDFs exist either exclusively on the client side, reside in server memory only during task execution, or temporarily reside in a file solely for the execution of the task. Any file downloaded by the user will have been deleted from the server by that point.

Homepage: https://stirlingpdf.com

All documentation available at https://docs.stirlingpdf.com/

Features

50+ PDF Operations
Parallel file processing and downloads
Dark mode support
Custom download options
Custom 'Pipelines' to run multiple features in a automated queue
API for integration with external scripts
Optional Login and Authentication support (see here for documentation)
Database Backup and Import (see here for documentation)
Enterprise features like SSO see here

PDF Features

Page Operations

View and modify PDFs - View multi-page PDFs with custom viewing, sorting, and searching. Plus, on-page edit features like annotating, drawing, and adding text and images. (Using PDF.js with Joxit and Liberation fonts)
Full interactive GUI for merging/splitting/rotating/moving PDFs and their pages
Merge multiple PDFs into a single resultant file
Split PDFs into multiple files at specified page numbers or extract all pages as individual files
Reorganize PDF pages into different orders
Rotate PDFs in 90-degree increments
Remove pages
Multi-page layout (format PDFs into a multi-paged page)
Scale page contents size by set percentage
Adjust contrast
Crop PDF
Auto-split PDF (with physically scanned page dividers)
Extract page(s)
Convert PDF to a single page
Overlay PDFs on top of each other
PDF to a single page
Split PDF by sections

Conversion Operations

Convert PDFs to and from images
Convert any common file to PDF (using LibreOffice)
Convert PDF to Word/PowerPoint/others (using LibreOffice)
Convert HTML to PDF
Convert PDF to XML
Convert PDF to CSV
URL to PDF
Markdown to PDF

Security & Permissions

Add and remove passwords
Change/set PDF permissions
Add watermark(s)
Certify/sign PDFs
Sanitize PDFs
Auto-redact text

Other Operations

Add/generate/write signatures
Split by Size or PDF
Repair PDFs
Detect and remove blank pages
Compare two PDFs and show differences in text
Add images to PDFs
Compress PDFs to decrease their filesize (using qpdf)
Extract images from PDF
Remove images from PDF
Extract images from scans
Remove annotations
Add page numbers
Auto-rename files by detecting PDF header text
OCR on PDF (using Tesseract OCR)
PDF/A conversion (using LibreOffice)
Edit metadata
Flatten PDFs
Get all information on a PDF to view or export as JSON
Show/detect embedded JavaScript

📖 Get Started

Visit our comprehensive documentation at docs.stirlingpdf.com for:

Installation guides for all platforms
Configuration options
Feature documentation
API reference
Security setup
Enterprise features

Supported Languages

Stirling-PDF currently supports 40 languages!

Language	Progress
Arabic (العربية) (ar_AR)
Azerbaijani (Azərbaycan Dili) (az_AZ)
Basque (Euskara) (eu_ES)
Bulgarian (Български) (bg_BG)
Catalan (Català) (ca_CA)
Croatian (Hrvatski) (hr_HR)
Czech (Česky) (cs_CZ)
Danish (Dansk) (da_DK)
Dutch (Nederlands) (nl_NL)
English (English) (en_GB)
English (US) (en_US)
French (Français) (fr_FR)
German (Deutsch) (de_DE)
Greek (Ελληνικά) (el_GR)
Hindi (हिंदी) (hi_IN)
Hungarian (Magyar) (hu_HU)
Indonesian (Bahasa Indonesia) (id_ID)
Irish (Gaeilge) (ga_IE)
Italian (Italiano) (it_IT)
Japanese (日本語) (ja_JP)
Korean (한국어) (ko_KR)
Norwegian (Norsk) (no_NB)
Persian (فارسی) (fa_IR)
Polish (Polski) (pl_PL)
Portuguese (Português) (pt_PT)
Portuguese Brazilian (Português) (pt_BR)
Romanian (Română) (ro_RO)
Russian (Русский) (ru_RU)
Serbian Latin alphabet (Srpski) (sr_LATN_RS)
Simplified Chinese (简体中文) (zh_CN)
Slovakian (Slovensky) (sk_SK)
Slovenian (Slovenščina) (sl_SI)
Spanish (Español) (es_ES)
Swedish (Svenska) (sv_SE)
Thai (ไทย) (th_TH)
Tibetan (བོད་ཡིག་) (bo_CN)
Traditional Chinese (繁體中文) (zh_TW)
Turkish (Türkçe) (tr_TR)
Ukrainian (Українська) (uk_UA)
Vietnamese (Tiếng Việt) (vi_VN)
Malayalam (മലയാളം) (ml_IN)

Stirling PDF Enterprise

Stirling PDF offers an Enterprise edition of its software. This is the same great software but with added features, support and comforts. Check out our Enterprise docs

🤝 Looking to contribute?

Join our community:

9.5 KiB Raw Blame History