Make default output filename suffix configurable (fixes #259)

distribution/doc/release-notes/3.1.0.md

@@ -10,4 +10,5 @@ Packaging-focused release: the fat jar is gone and every supported platform ship
 - **Default hash algorithm is now SHA-256** (was SHA-1) for signing that relies on the implicit default. An explicit or saved `hash.algorithm` is untouched, and SHA-1 stays selectable for the OpenPDF engine.
 - **CLI signatures now append by default**, matching the GUI. Use the new `--overwrite` flag to replace existing signatures; the legacy `--append` / `-a` flag is kept as a no-op.
 - **Signed Windows installers** — the Windows MSI installers are Authenticode-signed via SignPath, so they install without an unknown-publisher warning. Pre-release builds ship unsigned.
+- **Configurable default output suffix** — the `_signed` marker appended to the output file name can now be changed with the new `output.suffix` key in `advanced.properties`, so non-English users can localize it (e.g. `_firmado`). It feeds both GUIs and the default for the CLI `-os` / `--out-suffix` option.
 - **Checksums for every artifact** — a `jsignpdf-<version>-SHA256SUMS.txt` file now covers all published release assets.

engines/api/src/main/java/net/sf/jsignpdf/BasicSignerOptions.java

@@ -427,7 +427,8 @@ public String getOutFile() {
     }
 
     /**
-     * Returns output file name if filled or input file name with default output suffix ("_signed")
+     * Returns output file name if filled or input file name with the configured default output suffix
+     * (the {@code output.suffix} advanced-config key; bundled default {@code "_signed"}).
      *
      * @return
      */
@@ -444,7 +445,7 @@ public String getOutFileX() {
                     tmpExtension = tmpNameBase.substring(tmpBaseLen);
                     tmpNameBase = tmpNameBase.substring(0, tmpBaseLen);
                 }
-                tmpOut = tmpNameBase + Constants.DEFAULT_OUT_SUFFIX + tmpExtension;
+                tmpOut = tmpNameBase + AppConfig.defaultOutSuffix() + tmpExtension;
             }
         }
         return tmpOut;

engines/api/src/main/java/net/sf/jsignpdf/utils/AppConfig.java

@@ -50,6 +50,15 @@ public static String defaultTsaHashAlg() {
         return cfg().getNotEmptyProperty("tsa.hashAlgorithm", "SHA-256");
     }
 
+    /**
+     * Suffix appended to the input file name to build the default output file name (the GUI suggestion and the
+     * fallback for the CLI {@code -osuffix} option), or {@value Constants#DEFAULT_OUT_SUFFIX} when unset. Lets users
+     * localize the {@code _signed} marker (e.g. {@code _signe}, {@code _firmado}, {@code _unterschrieben}).
+     */
+    public static String defaultOutSuffix() {
+        return cfg().getNotEmptyProperty("output.suffix", Constants.DEFAULT_OUT_SUFFIX);
+    }
+
     public static boolean checkValidity() {
         return cfg().getAsBool("certificate.checkValidity", true);
     }

engines/api/src/main/resources/net/sf/jsignpdf/conf/advanced.default.properties

@@ -52,6 +52,12 @@ pdf2image.libraries=jpedal,pdfbox,openpdf
 # (used when the signer options don't override it).
 tsa.hashAlgorithm=SHA-256
 
+# Suffix appended to the input file name to derive the default output file
+# name (e.g. mydocument.pdf -> mydocument_signed.pdf). Used as the GUI
+# suggestion and the fallback for the CLI -osuffix option. Set this to
+# localize the marker (e.g. _signe, _firmado, _unterschrieben).
+output.suffix=_signed
+
 # DSS signing engine (PAdES). These knobs only matter when the 'dss' engine
 # is selected and the requested PAdES level is LT/LTA (which embed revocation
 # data). B and T work fully offline and ignore them.

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages.properties

@@ -237,7 +237,9 @@ hlp.ocsp=enable OCSP certificate validation
 hlp.ocspServerUrl=default OCSP server URL, which will be used in case the signing certificate doesn't contain this information
 hlp.outPath=folder in which the signed documents will be stored. Default value is current folder.
 hlp.outPrefix=prefix for signed file. Default value is empty prefix.
-hlp.outSuffix=suffix for signed filename. Default value is "_signed". (e.g. sign process on file mydocument.pdf will create new file mydocument_signed.pdf)
+# Translators: {0} is the configured default suffix. This value is processed by java.text.MessageFormat,
+# so any literal apostrophe must be doubled ('') or it (and the text after it) will be dropped.
+hlp.outSuffix=suffix for signed filename. Default value is "{0}" (configurable with the output.suffix key in advanced.properties). E.g. sign process on file mydocument.pdf will create new file mydocument{0}.pdf
 hlp.ownerpwd=owner password for encrypted documents (used when -e option is given). Use '-' to read from stdin (requires --enable-stdin-passwords).
 hlp.page=page with visible signature. Default value is 1 (first page). If the provided page number is out of bounds, then the last page is used.
 hlp.posLLX=lower left corner position on X-axis of a visible signature (negative value is subtracted from page width)

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages_cs.properties

@@ -223,7 +223,7 @@ hlp.ocsp=povoluje OCSP validaci certifikátu
 hlp.ocspServerUrl=adresa OCSP serveru, která bude použita v případě, že certifikát tuto informaci neobsahuje
 hlp.outPath=adresář do kterého budou umístěny podepsaná PDF. Výchozím nastavením je současný adresář.
 hlp.outPrefix=prefix podepsaného souboru. Výchozí hodnota je prázdný prefix.
-hlp.outSuffix=suffix (přípona) podepsaného souboru. Výchozí hodnota je "_signed". Např. při podepsání souboru dokument.pdf bude vytvořen soubor dokument_signed.pdf
+hlp.outSuffix=suffix (přípona) podepsaného souboru. Výchozí hodnota je "{0}". Např. při podepsání souboru dokument.pdf bude vytvořen soubor dokument{0}.pdf
 hlp.ownerpwd=heslo vlastníka (owner password) použité je-li zapnuté kódování podepsaného dokumentu (-e). Použijte '-' pro čtení ze standardního vstupu (vyžaduje --enable-stdin-passwords).
 hlp.page=stránka na kterou bude umístěn viditelný podpis. Výchozí hodnota je 1 (první stránka)
 hlp.posLLX=pozice na ose X levého dolního rohu viditelného podpisu (při použití záporné hodnoty je hodnota odečtena od šiřky stránky)

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages_de.properties

@@ -230,7 +230,7 @@ hlp.bgScale=Vergrößerungsverhältnis für das Hintergrundbild der sichtbaren U
 hlp.disableAcro6Layers=deaktiviert die Acrobat 6 Ebeneneinstellungen, was bedeutet, dass alle Signaturebenen erstellt werden. Acrobat 6.0 und höher empfiehlt, nur n2- und n4-Ebenen zu erstellen.
 hlp.enableStdinPasswords=erlaubt das Lesen von Passwortwerten von der Standardeingabe. Wenn gesetzt, bedeutet der Wert '-' einer Passwortoption: eine Zeile von stdin lesen (oder auf einer Konsole abfragen). Mehrere Passwortoptionen dürfen '-' verwenden und werden in fester Reihenfolge gelesen: --keystore-password, --key-password, --owner-password, --user-password, --tsa-cert-password, --tsa-password.
 hlp.encCert=Pfad zur Zertifikatsdatei, die zum Verschlüsseln der Ausgabe-PDF verwendet werden soll (wenn -encryption CERTIFICATE gesetzt ist)
-hlp.outSuffix=Suffix für den signierten Dateinamen. Standardwert ist "_signed" (z. B. wird beim Signieren der Datei mydocument.pdf die neue Datei mydocument_signed.pdf erstellt)
+hlp.outSuffix=Suffix für den signierten Dateinamen. Standardwert ist "{0}" (z. B. wird beim Signieren der Datei mydocument.pdf die neue Datei mydocument{0}.pdf erstellt)
 hlp.tsaHashAlg=Hash-Algorithmus, der für die Anfrage an den Zeitstempel-Server (TSA) verwendet wird; der Standardwert ist {0}
 hlp.outPrefix=Präfix für die signierte Datei. Standardwert ist ein leeres Präfix.
 hlp.page=Seite mit sichtbarer Signatur. Standardwert ist 1 (erste Seite). Wenn die angegebene Seitenzahl außerhalb des zulässigen Bereichs liegt, wird die letzte Seite verwendet.

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages_el.properties

@@ -226,7 +226,7 @@ hlp.ocsp=ενεργοποίησε επαλήθευση πιστοποιητικ
 hlp.ocspServerUrl=προκαθορισμένη διεύθυνση URL OCSP εξυπηρετητή, η οποία θα χρησιμοποιείται σε περίπτωση που το πιστοποιητικό υπογραφής δεν περιέχει αυτή την πληροφορία
 hlp.outPath=φάκελος στον οποίο τα υπογεγραμμένα έγγραφα θα αποθηκεύονται. Προκαθορισμένη τιμή είναι ο τρέχον κατάλογος.
 hlp.outPrefix=πρόθεμα για υπογεγραμμένα αρχεία. Προκαθορισμένη τιμή είναι το κενό πρόθεμα.
-hlp.outSuffix=επίθεμα για υπογεγραμμένα αρχεία. Προκαθορισμένη τιμή είναι "_signed". (π.χ. η υπογραφή του αρχείου mydocument.pdf θα δημιουργήσει ένα νέο αρχείο με το όνομα mydocument_signed.pdf)
+hlp.outSuffix=επίθεμα για υπογεγραμμένα αρχεία. Προκαθορισμένη τιμή είναι "{0}". (π.χ. η υπογραφή του αρχείου mydocument.pdf θα δημιουργήσει ένα νέο αρχείο με το όνομα mydocument{0}.pdf)
 hlp.ownerpwd=κωδικός κατόχου για κρυπτογραφημένα αρχεία (χρησιμοποιείται όταν η επιλογή -e έχει δοθεί). Χρησιμοποιήστε '-' για ανάγνωση από την τυπική είσοδο (απαιτεί --enable-stdin-passwords).
 hlp.page=σελίδα με ορατή υπογραφή. Η προεπιλεγμένη τιμή είναι 1 (πρώτ σελίδα)
 hlp.posLLX=θέση της κάτω αριστερά γωνίας στον άξονα Χ μιας ορατής υπογραφής

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages_es.properties

@@ -279,7 +279,7 @@ gui.vs.bgImgScale.label=Escalado de la imagen de fondo
 hlp.tsaCertPasswd=contraseña utilizada para abrir el archivo PKCS#12 (véase la opción« -tscf») que contiene la clave privada. Use «-» para leer desde la entrada estándar (requiere --enable-stdin-passwords).
 gui.vs.bgImgScale.tooltip=Escribe un valor positivo para multiplicar el tamaño de la imagen con el valor.\nEscribe un valor cero para rellenar todo el fondo (estirándolo).\nEscribe un valor negativo para ajustar las dimensiones sin distorsiones.
 gui.vs.l2TextFontSize.label=Tamaño de la letra de firma
-hlp.outSuffix=sufijo para el nombre del archivo firmado. El valor predeterminado es «_signed». (por ejemplo, el proceso de firma en el archivo «midocumento.pdf» creará un nuevo archivo «midocumento_signed.pdf»)
+hlp.outSuffix=sufijo para el nombre del archivo firmado. El valor predeterminado es «{0}». (por ejemplo, el proceso de firma en el archivo «midocumento.pdf» creará un nuevo archivo «midocumento{0}.pdf»)
 hlp.page=página con firma visible. El valor predeterminado es 1 (la primera página). Si el número de página proporcionado queda fuera de los límites se utiliza la última página.
 hlp.bgPath=ruta de la imagen de fondo para las firmas visibles
 hlp.bgScale=Escala de la imagen de fondo para las firmas visibles. Inserte un valor positivo para multiplicar el tamaño de la imagen con el valor. Inserte un valor cero para llenar todo el fondo con él (estirar). Inserte un valor negativo para ajustar al máximo el tamaño de la imagen.

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages_fr.properties

@@ -209,7 +209,7 @@ hlp.ocsp=Autoriser la validation de certificat par interrogation des serveurs OC
 hlp.ocspServerUrl=Autoriser la validation de certificat par interrogation des serveurs OCSP (équivalent à une liste de révocation).
 hlp.outPath=Répertoire contenant les documents signés
 hlp.outPrefix=Préfixe des documents signés. Par défaut aucun préfix n'est requis. 
-hlp.outSuffix=Suffixe ou extension des documents signés. La valeur par défaut est "_signed" (c.a.d la signature du fichier "MonDocument.pdf" sera nommée MonDocument_signed.pdf"  
+hlp.outSuffix=Suffixe pour le nom du fichier signé. La valeur par défaut est "{0}" (c.-à-d. la signature du fichier MonDocument.pdf créera le nouveau fichier MonDocument{0}.pdf)
 hlp.ownerpwd=Mot de passe pour le chiffrement de documents. Utilisez « - » pour lire depuis l'entrée standard (nécessite --enable-stdin-passwords).
 hlp.page=Page d'insertion de l'attache de signature. La page par défaut est la première page.
 hlp.posLLX=Abscisse du coin inférieur gauche de l'attache de signature inserrée dans le document PDF.

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages_hr.properties

@@ -278,7 +278,7 @@ hlp.keyPwd=lozinka ključa u spremištu ključeva. U većini slučajeva ne mora
 hlp.ksFile=postavlja KeyStore datoteku – kao vrijednost koristi putanju do datoteke s privatnim ključevima (.p12, .pfx, .jks, …). Neka spremišta ključeva nemaju u datoteci spremljene ključeve (npr. Windows spremište ključeva – WINDOWS-MY). U tom slučaju nemoj koristiti ovu opciju.
 hlp.ksPwd=lozinka u KeyStore. Koristi '-' za čitanje sa standardnog ulaza (zahtijeva --enable-stdin-passwords).
 hlp.ksType=postavlja KeyStore vrstu (možeš navesti moguće vrijednosti za ovu opciju -lkt argument)
-hlp.outSuffix=sufiks za potpisano ime datoteke. Zadana vrijednost je „_signed”. (npr. postupak potpisivanja datoteke „mydocument.pdf” stvorit će novu datoteku „mydocument_signed.pdf”)
+hlp.outSuffix=sufiks za potpisano ime datoteke. Zadana vrijednost je „{0}”. (npr. postupak potpisivanja datoteke „mydocument.pdf” stvorit će novu datoteku „mydocument{0}.pdf”)
 hlp.page=stranica s vidljivim potpisom. Standardna vrijednost je 1 (prva stranica). Ako je navedeni broj stranice veći od ukupnog broja stranica, koristi se zadnja stranica.
 hlp.keyIndex=nulti indeks ključa, koji bi se trebao koristiti za potpisivanje dokumenta. Ako ova opcija niti alias nisu zadani, koristi se prvi ključ (index=0) u spremištu ključeva. (Prikaži popis aliasa ključeva koristeći -lk). Ova opcija ima niži prioritet od aliasa.
 hlp.reason=razlog potpisa. Standardno je prazan.

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages_hu.properties

@@ -360,7 +360,7 @@ hlp.ocsp=OCSP tanúsítvány érvényesítés engedélyezése
 hlp.ocspServerUrl=alapértelmezett OCSP szerver URL, amely akkor lesz használva, ha az aláíró tanúsítvány nem tartalmazza ezt az információt
 hlp.outPath=az a mappa, amelybe az aláírt dokumentumok mentésre kerülnek. Alapértelmezett érték az aktuális mappa.
 hlp.outPrefix=előtag az aláírt fájlhoz. Alapértelmezett érték az üres előtag.
-hlp.outSuffix=utótag az aláírt fájlnévhez. Alapértelmezett érték: "_signed". (pl. a mydocument.pdf fájl aláírása létrehozza a mydocument_signed.pdf fájlt)
+hlp.outSuffix=utótag az aláírt fájlnévhez. Alapértelmezett érték: "{0}". (pl. a mydocument.pdf fájl aláírása létrehozza a mydocument{0}.pdf fájlt)
 hlp.ownerpwd=tulajdonosi jelszó titkosított dokumentumokhoz (a -e opció megadása esetén használatos). A '-' használatával a jelszó a szabványos bemenetről olvasható be (szükséges: --enable-stdin-passwords).
 hlp.page=az oldal a látható aláírással. Alapértelmezett érték 1 (első oldal). Ha a megadott oldalszám kívül esik a tartományon, az utolsó oldal lesz használva.
 hlp.posLLX=a látható aláírás bal alsó sarkának pozíciója az X tengelyen (negatív érték az oldalszélességből lesz kivonva)

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages_hy.properties

@@ -345,7 +345,7 @@ hlp.ocsp=միացնել OCSP վկայագրի վավերացումը
 hlp.ocspServerUrl=կանխադրված OCSP սերվերի URL, որը կօգտագործվի այն դեպքում, երբ ստորագրման վկայագիրը չի պարունակում այս տեղեկատվությունը
 hlp.outPath=պանակ, որում կպահվեն ստորագրված փաստաթղթերը։ Կանխադրված արժեքն ընթացիկ պանակն է։
 hlp.outPrefix=ստորագրված ֆայլի նախածանցը։ Կանխադրված արժեքը դատարկ նախածանց է։
-hlp.outSuffix=ստորագրված ֆայլի անվան վերջածանցը։ Կանխադրված արժեքն է "_signed"։ (օր․՝ mydocument.pdf ֆայլի ստորագրումը կստեղծի նոր ֆայլ mydocument_signed.pdf անունով)
+hlp.outSuffix=ստորագրված ֆայլի անվան վերջածանցը։ Կանխադրված արժեքն է "{0}"։ (օր․՝ mydocument.pdf ֆայլի ստորագրումը կստեղծի նոր ֆայլ mydocument{0}.pdf անունով)
 hlp.ownerpwd=սեփականատիրոջ գաղտնաբառը գաղտնագրված փաստաթղթերի համար (օգտագործվում է, երբ տրված է -e տարբերակը)։ Օգտագործեք '-' գաղտնաբառը ստանդարտ մուտքից կարդալու համար (պահանջում է --enable-stdin-passwords):
 hlp.page=տեսանելի ստորագրությամբ էջը։ Կանխադրված արժեքն է 1 (առաջին էջ)։ Եթե տրամադրված էջի համարը սահմաններից դուրս է, ապա օգտագործվում է վերջին էջը։
 hlp.posLLX=տեսանելի ստորագրության ներքևի ձախ անկյան դիրքը X առանցքի վրա (բացասական արժեքը հանվում է էջի լայնությունից)

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages_it.properties

@@ -358,7 +358,7 @@ hlp.ocsp=abilita la validazione del certificato tramite OCSP
 hlp.ocspServerUrl=URL predefinito del server OCSP, che verrà utilizzato qualora il certificato di firma non contenga questa informazione
 hlp.outPath=cartella in cui verranno salvati i documenti firmati. Il valore predefinito è la cartella corrente.
 hlp.outPrefix=prefisso per il file firmato. Il valore predefinito è prefisso vuoto.
-hlp.outSuffix=suffisso per il nome del file firmato. Il valore predefinito è "_signed". (es. la firma del file mydocument.pdf creerà il nuovo file mydocument_signed.pdf)
+hlp.outSuffix=suffisso per il nome del file firmato. Il valore predefinito è "{0}". (es. la firma del file mydocument.pdf creerà il nuovo file mydocument{0}.pdf)
 hlp.ownerpwd=password del proprietario per i documenti crittografati (utilizzata quando è specificata l'opzione -e). Usa '-' per leggere dallo standard input (richiede --enable-stdin-passwords).
 hlp.page=pagina con la firma visibile. Il valore predefinito è 1 (prima pagina). Se il numero di pagina fornito è fuori intervallo, viene utilizzata l'ultima pagina.
 hlp.posLLX=posizione dell'angolo inferiore sinistro sull'asse X di una firma visibile (un valore negativo viene sottratto dalla larghezza della pagina)

engines/api/src/main/resources/net/sf/jsignpdf/translations/messages_ja.properties

@@ -348,7 +348,7 @@ hlp.ocsp=OCSPによる証明書検証を有効にします
 hlp.ocspServerUrl=署名証明書にこの情報が含まれていない場合に使用されるデフォルトの OCSP サーバー URL
 hlp.outPath=署名済み文書を保存するフォルダ。デフォルト値は現在のフォルダです。
 hlp.outPrefix=署名済みファイルのプレフィックス。デフォルト値は空のプレフィックスです。
-hlp.outSuffix=署名済みファイル名のサフィックス。デフォルト値は "_signed" です。（例: mydocument.pdf への署名処理では mydocument_signed.pdf という新しいファイルが作成されます）
+hlp.outSuffix=署名済みファイル名のサフィックス。デフォルト値は "{0}" です。（例: mydocument.pdf への署名処理では mydocument{0}.pdf という新しいファイルが作成されます）
 hlp.ownerpwd=暗号化された文書の所有者パスワード（-e オプション指定時に使用）。'-' を指定すると標準入力から読み込みます (--enable-stdin-passwords が必要)。
 hlp.page=可視署名を表示するページ。デフォルト値は 1（最初のページ）です。指定されたページ番号が範囲外の場合は最後のページが使用されます。
 hlp.posLLX=可視署名の左下隅のX軸位置（負の値はページ幅から減算されます）