TextEncoder

Contrôle de Script du TextEncoder

Avec la version du programme TextEncoder Pro CL, vous pouvez modifier le codage et le saut de ligne utilisé des fichiers texte via la ligne de commande. Cela permet de contrôler le TextEncoder via un script. Sur cette page, nous aimerions vous présenter le sujet et vous montrer quelques exemples d’utilisation du TextEncoder pour éditer et convertir des fichiers individuels ou le contenu de dossiers entiers. De plus, au bas de cette page, vous trouverez un aperçu de tous les paramètres que vous pouvez utiliser.

Convertir un ou plusieurs Fichiers

Commençons par un exemple simple. Nous aimerions changer l’encodage d’un seul fichier en UTF-8. Pour cela, nous passons les paramètres suivants:

TextEncoder.exe -cl C:\test.txt enc=utf8

Vous voyez d’abord le paramètre -cl, qui signifie "command line (ligne de commande). Ce paramètre détermine si le TextEncoder est démarré avec une interface utilisateur graphique ou en mode ligne de commande sans interface utilisateur graphique. Nous utilisons toujours ce paramètre si nous voulons contrôler le TextEncoder via la ligne de commande. Si nous omettons ce paramètre, le TextEncoder démarre normalement avec une fenêtre. En tant que paramètre suivant, nous passons le chemin du fichier que nous voulons éditer. Enfin, nous passons enc=utf8. Cela indique que nous souhaitons convertir au codage UTF-8. Au bas de cette page, vous trouverez une liste de tous les encodages que nous pouvons vous remettre ici. Cette commande convertit le fichier C:\test.txt au format UTF-8.

De même, nous contrôlons le changement du type de saut de ligne. L’exemple suivant modifie le saut de ligne du fichier C:\test.txt en CR LF (Windows).

TextEncoder.exe -cl C:\test.txt lb=crlf

Ensuite, nous voulons spécifier explicitement que le marque d’ordre des octets (Byte Order Mark, bom) est écrit dans le fichier. Nous faisons cela avec le paramètre "bom":

TextEncoder.exe -cl C:\test.txt enc=utf8 bom=1

Le paramètre "bom" peut prendre les valeurs "keep", "0" ou "1". Avec "1", la marque d’ordre des octets est toujours écrite dans le fichier, avec "0" jamais. Avec "keep", l’état du fichier d’origine est adopté (si possible). En d’autres termes, si le fichier d’origine a une marque d’ordre d’octet, une marque d’ordre d’octet est également écrite dans le fichier. Si non, pas.

Jusqu’ici, nous avons toujours écrasé le fichier C:\test.txt. Nous voulons maintenant enregistrer le fichier converti en tant que nouveau fichier. Pour cela, nous utilisons le paramètre "save":

TextEncoder.exe -cl C:\test.txt enc=latin1 save=C:\nouveau.txt

Ici, nous modifions l’encodage du fichier C:\test.txt en Latin 1 (ISO 8859-1) et sauvegardons le fichier sous C:\nouveau.txt. Le fichier C:\test.txt reste inchangé.

Lorsque nous enregistrons le résultat de la conversion en tant que nouveau fichier de cette manière, la date de création ainsi que la date de la dernière modification du nouveau fichier sont au moment de la conversion. Si nous ne voulons pas cela et que nous voulons utiliser la date du fichier d'origine à la place, nous pouvons passer "date=keep" comme paramètre:

TextEncoder.exe -cl C:\test.txt enc=utf32be save=C:\nouveau.txt date=keep

Ce paramètre fonctionne également pour l'écrasement des fichiers, mais dans ce cas, il n'affecterait que la date de modification, car la date de création reste inchangée lors de l'écrasement dans tous les cas.

Bien sûr, nous pouvons non seulement éditer des fichiers individuels, mais aussi plusieurs fichiers en même temps, comme le montre l'exemple suivant:

TextEncoder.exe -cl C:\test1.txt C:\test2.txt enc=utf16le

À titre d'exemple, nous convertissons ici les fichiers C:\test1.txt et C:\test2.txt au format UTF16-LE. Vous pouvez spécifier autant de fichiers que vous le souhaitez.

Convertir le Contenu des Dossiers

En plus de spécifier des fichiers individuels, vous pouvez également transmettre le chemin d’accès à un dossier pour en modifier le contenu. La syntaxe est la même que celle utilisée pour éditer des fichiers:

TextEncoder.exe -cl C:\dossier enc=utf8

Cette commande convertit tous les fichiers du dossier C:\dossier au format UTF-8. Si vous ne souhaitez pas écraser le fichier, vous pouvez utiliser l’un des paramètres save-folder, save-name ou save-ext pour modifier le dossier, le nom du fichier ou l’extension du fichier des fichiers modifiés afin que les fichiers modifiés soient sauvegardés en tant que nouveaux fichiers.

TextEncoder.exe -cl C:\dossier enc=utf8 save-folder=C:\nouveaudossier

Dans cet exemple, nous convertissons tous les fichiers du dossier C:\dossier au format UTF-8 et enregistrons le résultat dans le dossier C:\nouveaudossier. Les fichiers d’origine restent inchangés.

TextEncoder.exe -cl C:\dossier enc=utf8 save-folder=C:\nouveau save-name=%%jjjj%%-%%mm%%-%%tt%

Dans cet exemple, nous souhaitons changer non seulement le dossier mais également le nom du fichier. Ici, nous sauvegardons les fichiers du dossier C:\dossier au format UTF-8 dans le nouveau dossier C:\nouveaudossier et modifions le nom du fichier à la date du jour. C’est ce que signifient les espaces réservés utilisés dans le paramètre "save-name". Comme nous n’avons pas défini de nouvelle extension de fichier avec le paramètre "save-ext", l’extension de fichier du fichier d’origine respectif est adoptée.

Si nous ne voulons pas convertir tous les fichiers du dossier, nous pouvons passer des filtres en utilisant des paramètres. Par exemple, pour éditer uniquement les fichiers d’une certaine extension:

TextEncoder.exe -cl C:\dossier enc=utf8 filter-ext=txt

Nous passons ici le paramètre "filter-ext" avec la valeur "txt". Cela signifie que nous voulons uniquement éditer des fichiers avec l’extension TXT. S’il existe des fichiers avec d’autres terminaisons dans le même dossier, ils ne seront pas pris en compte. Plusieurs extensions de fichier peuvent être spécifiées comme suit:

TextEncoder.exe -cl C:\dossier enc=utf8 filter-ext=txt/htm

Ce filtre garantit que seuls les fichiers portant les extensions TXT ou HTM sont convertis à partir du dossier C:\dossier. Plus de filtres et des options de recherche se trouvent au bas de cette page dans la liste de tous les paramètres disponibles.

TextEncoder.exe -cl C:\dossier enc=utf8 search-subdirs=0

De plus, vous pouvez utiliser le paramètre "search-subdirs" pour spécifier si seuls les fichiers directement au premier niveau du dossier spécifié doivent être modifiés ou si tous les sous-dossiers du dossier spécifié doivent également être inclus. Dans cet exemple, nous spécifions search-subdirs=0. Le résultat est que les fichiers qui se trouvent dans les sous-dossiers ne sont pas traités. Si vous omettez ce paramètre ou passez search-subdirs=1, tous les fichiers de tous les sous-dossiers sont également traités. Dans l’exemple, par exemple, les fichiers d’un dossier tel que C:\dossier\dossier1\dossier2.

TextEncoder.exe -cl C:\dossier enc=utf8 save-folder=C:\nouveau keep-subdirs=1

Lorsque tous les fichiers d'un dossier contenant des sous-dossiers sont convertis et les fichiers doivent être stockés dans un autre dossier défini par le paramètre save-folder, la question est comment les fichiers des sous-dossiers doivent être traités. Cela peut être contrôlé via le paramètre keep-subdirs. Avec keep-subdirs=1, la structure des sous-dossiers d'origine reste et les fichiers convertis sont stockés dans les sous-dossiers correspondants dans le nouveau dossier. En dehors de cela, avec keep-subdirs=0, la structure des sous-dossiers est ignorée et tous les fichiers sont stockés directement dans le nouveau dossier sans sous-dossiers. Si nous omettons le paramètre keep-subdirs, la structure de dossier est ignorée (correspond à keep-subdirs=0).

Lire des Fichiers en utilisant un Format spécifique

Normalement, le TextEncoder devine le codage et le saut de ligne des fichiers existants et lit les fichiers sur cette base. Bien sûr, vous pouvez également appliquer un type de codage ou de saut de ligne spécifique lors de la lecture des fichiers. Vous faites cela avec les paramètres enc-read et lb-read.

TextEncoder.exe -cl C:\fichier.txt enc-read=utf8 lb-read=lf

Nous imposons ici que le fichier est lu au format UTF-8 avec le saut de ligne LF (Unix, Linux, macOS) et interprété en conséquence. Si vous omettez l’un des deux paramètres, ou les deux, la valeur enc-read=auto respectivement lb-read=auto est utilisée. Cela signifie que les fichiers sont lus et interprétés en raison de la reconnaissance automatique du codage et du saut de ligne.

Caractères personnalisés pour les Sauts de Ligne

Outre les constantes précédemment utilisées pour des types de sauts de ligne courants tels que CRLF ou LF, vous pouvez également utiliser tous les caractères personalisés définis par l'utilisateur pour un saut de ligne. Ces caractères peuvent être définis à la fois, sous la forme de points de code ou sous forme de texte.

Dans l'exemple suivant, nous lisons un fichier avec le saut de ligne LF et souhaitez enregistrer le fichier avec le saut de ligne CR LF. Au lieu d'utiliser les constantes LF et CRLF, nous utilisons l'écriture au moyen de points de code, donc #0A au lieu de LF et #0D#0A au lieu de la CRLF. Nous devons écrire "customcp-" devant nos définitions de point de code, qui est le préfixe du TextEncoder pour interpréter le texte suivant comme points de code:

TextEncoder.exe -cl C:\test.txt lb-read=customcp-#0A lb=customcp-#0D#0A

Le résultat de la conversion avec cette écriture est bien sûr identique au résultat que nous obtenons avec lb-read=lf lb=crlf. L'appel suivant nous renvoie également le même résultat:

TextEncoder.exe -cl C:\test.txt lb-read=customcp-10 lb=customcp-U+000DU+000A

Cette fois, nous avons défini le saut de ligne LF non hexadécimale (#0A) mais décimale (#0A = 10). La troisième façon de définir les points de code du TextEncoder est la form U+X, car nous avons défini CR LF ici.

Bien que nous n'avions que des types de sauts de ligne typiques écrits comme points de code dans ces exemples, nous pouvons également définir des caractères de saut de ligne non typiques sous la forme d'un ou plusieurs points de code et de l'utiliser pour la lecture ou l'écriture dans le TextEncoder.

Bien que nous puissions définir des points de code avec le préfixe "customcp-", nous pouvons définir n'importe quel caractère ou texte en tant que saut de ligne personnalisée avec le préfixe "customstr-" directement. Un exemple de ceci est l'appel suivant:

TextEncoder.exe -cl C:\test.txt lb-read=customstr-a lb=crlf

Avec cet appel, nous remplaçons chaque apparence de la lettre "a" dans le fichier test.txt avec le saut de la ligne Windows CR LF. Nous interprétons donc la lettre "a" comme un caractère pour un saut de ligne.

En interne, customcp- et customstr- fonctionnent de la même manière, la différence consiste exclusivement sur le côté de l'utilisateur dans la différence d'écriture et le type de définition des caractères. Toutefois, il est conseillé d'utiliser "customstr-" uniquement pour des caractères lisibles tels que "a" de notre exemple, tandis que les caractères "invisibles" peuvent être plus facilement définis via des points de code et l'utilisation de "customcp-".

Convertir des Fichiers avec une longueur de Ligne fixe

Tous les exemples précédents fonctionnent avec des caractères tels que CR ou LF, qui sont interprétés comme une fin de ligne. De plus, avec le TextEncoder, il est également possible de traiter les sauts de ligne sans caractères. Nous parlons de lignes définies par un nombre fixe de caractères.

Dans l'exemple suivant, nous avons un fichier qui ne contient pas de signe pour un saut de ligne. Au lieu de cela, nous savons que 15 caractères appartiennent à une ligne et une nouvelle ligne commence toujours après 15 caractères. Nous voulons convertir ce fichier et insérer en conséquence un caractère pour un saut de ligne (CR LF) tous les 15 caractères:

TextEncoder.exe -cl C:\test.txt lb-read=fixedlength-15 lb=crlf

Nous utilisons le préfixe "fixedlength-" pour la lecture (lb-read) et ajoutons à ce préfixe notre longueur de ligne souhaitée (ici 15). Étant donné que nous voulons enregistrer le fichier avec le saut de ligne CR LF, nous utilisons "lb=crlf" comme autre paramètre.

Bien sûr, nous pouvons également aller dans l'inverse:

TextEncoder.exe -cl C:\test.txt lb=nochar

Avec cet appel, nous supprimons toutes les sauts de ligne du fichier test.txt. Cette fois, nous utilisons uniquement le paramètre "lb" (pour enregister) avec la valeur "nochar" ce qui signifie pas de caractère. Le paramètre "lb-read" pour la lecture est omis ce délai, de sorte que le TextEncoder essaiera de détecter automatiquement le type de saut de ligne utilisée dans le fichier.

Sauts de Ligne à plusieurs Caractères

Normalement, le caractère utilisé pour une fin de ligne est unique dans un fichier. Cela peut être, par exemple, le caractère LF comme d'habitude sur les systèmes macOS, Linux et Unix ou CR LF du Windows. Mais comment pouvons-nous traiter avec des fichiers dans lesquels différents types de saut de ligne sont mélangés? Par exemple, car plusieurs fichiers ont été ajoutés de différents systèmes sans avoir d'abord ajuster leurs sauts de lignes?

Une solution consiste à réparer le type de saut de ligne du fichier. Cela peut être fait avec le TextEncoder à l'aide de sa capacité à lire les sauts de ligne à plusieurs caractères différents en même temps. Un appel peut ressembler à ceci:

TextEncoder.exe -cl C:\test.txt lb-read=customcps-10,13 lb=crlf

Nous utilisons le préfixe "customcps-" derrière lequel nous pouvons définir n'importe quel nombre de points de code. Lors de la lecture du fichier, un saut de ligne est ensuite réalisée sur chacun de ces points de code énumérés. Dans notre exemple, nous voulons diviser le fichier aux deux points de code 10 et 13. Nous pouvons ensuite utiliser tout autre type de saut de ligne pour enregistrer. Dans notre exemple, nous prenons CR LF.

En plus d'une définition des points de code, nous pouvons également définir nos caractères pour un saut de ligne via texte. Pour cela, nous prenons le préfixe "customstr-" au lieu le préfixe "customcps-":

TextEncoder.exe -cl C:\test.txt lb-read=customstrs-a,b,c lb=crlf

Dans cet exemple, nous voulons considérer les caractères a, b et c comme des caractères de saut de ligne, puis enregistrez le fichier avec le nouveau type de saut de ligne CR LF. Ainsi, nous remplaçons simplement l'occurrence des lettres a, b ou c avec le saut de la ligne Windows.

Paramètres et Fichiers de Paramètres

Dans tous les exemples précédents, nous avons transmis les paramètres de l'encodage, du linebreak ou du stockage via des paramètres individuels au TextEncoder, mais il est également possible d'utiliser un ou plusieurs fichiers de paramètres et de remettre le chemin d'accès à ces fichiers au lieu de travailler avec les paramètres tels que "lb", "enc" ou "save".

Les fichiers de paramètres peuvent être créés directement dans le TextEncoder. Pour ce faire, d'abord, ajustez simplement tous les paramètres via l'interface utilisateur. Vous pouvez ensuite enregistrer ces paramètres dans un fichier de paramètres via le menu "Paramètres > Enregistrer ou Charger les Paramètres > Sauver comme Fichier". Le résultat est un fichier avec l'extension de fichier TES, qui contient tous vos paramètres actuels pour les sauts de ligne, le codage et les options de stockage. Vous pouvez en savoir plus sur les fichiers de paramètres dans l'article "Enregistrer et Charger les Paramètres".

Après avoir créé un fichier de paramètres, vous pouvez simplement le passer en tant que paramètre:

TextEncoder.exe -cl C:\test.txt C:\settings.tes

Avec cet appel, vous convertissez le fichier "test.txt" conformément aux paramètres qui sont stockés dans le fichier "settings.tes".

Bien sûr, une combinaison de fichiers de paramètres avec des paramètres est également possible. Voici un exemple:

TextEncoder.exe -cl C:\test.txt C:\settings.tes enc=utf8 save-ext=txt

Avec cet appel, initialement tous les paramètres du fichier "settings.tes" sont chargés. L'encodage pour la sauvegarde est ensuite écrasé via le paramètre "enc" et l'extension de fichier utilisée pour le fichier stocké via le paramètre "save-ext". Les paramètres restants tels que le nom ou le dossier du nouveau fichier ou les paramètres du type de saut de ligne proviennent du fichier "settings.tes".

Si plusieurs fichiers de paramètres sont passés, l'ordre est crucial. Tout d'abord, le premier paramètre avec un fichier de paramètres est chargé, puis le deuxième paramètre avec un fichier de paramètres et ainsi de suite. Si tous les fichiers de paramètres sont chargés quelle que soit leur position de paramètre, les paramètres supplémentaires sont évalués et peuvent ensuite écraser les paramètres précédemment chargés à partir des fichiers de paramètres. Bien sûr, vous pouvez également modifier les fichiers de paramètres manuellement avec n'importe quel éditeur de texte, par exemple pour supprimer certains paramètres et, par exemple, pour conserver certains paramètres. Le TextEncoder utilisera les valeurs par défaut pour tous les paramètres manquants dans les fichiers de paramètres.

Sortie des Informations sur les Fichiers

En plus de modifier l'encodage ou le type de saut de ligne des fichiers, le TextEncoder peut également être utilisé pour produire des informations sur les fichiers texte dans la ligne de commande ou dans un script. Cela comprend à la fois des informations générales sur les fichiers tels que la taille des fichiers ainsi que les propriétés de fichiers texte tels que leur encodage, leur type de saut de ligne ou le nombre de caractères, de lignes ou de mots.

Plus d'information sur ce sujet ainsi qu'une explication des possibilités, des exemples et un aperçu de tous les paramètres que vous pouvez utiliser peuvent être trouvés dans le didacticiel sur la sortie des informations générales de fichiers et des informations spécifiques au fichier de texte via la ligne de commande ou script.

Vue d’ensemble de tous les Paramètres disponibles

Le tableau suivant répertorie tous les paramètres disponibles que vous pouvez utiliser dans le TextEncoder. Dans les exemples sur cette page nous avons déjà présenté certains des paramètres.

ParamètreValeursDéfautDescription
[Fichiers]tout chemin(s) de fichier
-Chemin du fichier à convertir. Vous pouvez spécifier plusieurs fichiers en séquence pour convertir plusieurs fichiers en même temps.
[Dossiers]tout chemin(s) de dossier
-Chemin d’accès à un dossier dont le contenu doit être converti. Pour éviter de convertir tous les fichiers du dossier, vous pouvez utiliser les paramètres search-subdirs, filter-ext, filter-name, filter-name-matchcase, filter-name-matchall, filter-name-regex, filter-hiddenfiles et filter-onlytextfiles pour affiner votre recherche. Plusieurs dossiers peuvent être spécifiés consécutivement pour convertir simultanément le contenu de plusieurs dossiers.
[Fichiers TES]fichiers de paramètres avec l'extension de fichier *.tes-Chemin vers un fichier de paramètres avec l'extension de fichier TES qui peut contenir des paramètres pour la conversion et l'emplacement de stockage. Les fichiers de paramètres peuvent être combinés et écrasés avec tous les autres paramètres. Plusieurs fichiers de paramètres peuvent être spécifiés dans une ligne, qui sont ensuite chargés consécutivement. Plus sur l'utilisation et la génération de fichiers de paramètres peuvent être trouvés dans la section "Paramètres et Fichiers de Paramètres".
lbkeep, system, crlf, lf, cr, nl, rnl, lf_ebcdic, eol, gs, rs, us, ff, nel, ls, ps, vt, tab, nochar, customstr-x, customcp-x
keepType de saut de ligne pour le fichier converti. "keep" conserve le type de saut de ligne du fichier d’origine, sinon le type spécifié. La valeur "system" correspond au type de saut de ligne standard du système d’exploitation sur lequel le TextEncoder est en cours d’exécution. Ainsi, par exemple, crlf pour Windows. Le constant nochar signifie sans caractère. Vous pouvez l'utiliser pour supprimer tous les caractères de saut de ligne d'un fichier. Avec customstr- et customcp-, les caractères personnalisés peuvent être définis comme des caractères de saut de ligne via texte ou points de code (le x représente le texte ou le point de code défini par l'utilisateur). Ici, une explication et des exemples peuvent être trouvés. Ici, vous trouverez un aperçu des différents types de saut de ligne.
lb-readauto, system, crlf, lf, cr, nl, rnl, lf_ebcdic, eol, gs, rs, us, ff, nel, ls, ps, vt, tab, fixedlength-x, customstr-x, customstrs-x, customcp-x, customcps-xautoSaut de ligne avec lequel le fichier est lu. Si ce paramètre n’est pas spécifié ou "auto" est spécifié, une tentative est faite pour détecter automatiquement le saut de ligne. La valeur "system" correspond au type de saut de ligne standard du système d’exploitation sur lequel le TextEncoder est en cours d’exécution. Ainsi, par exemple, crlf pour Windows. Avec fixedlength-, un texte avec une longueur de ligne fixe peut être lu (par exemple, fixedlength-70 pour 70 caractères par ligne). Une explication et des exemples peuvent être trouvés ici. Avec customstr- et customcp-, les caractères personnalisés pour un saut de ligne peuvent être définis via texte ou code points pour la lecture (le x représente le texte ou le code point défini par l'utilisateur). Une explication et des exemples peuvent être trouvés ici. Si vous avez des fichiers avec des types de sauts de ligne mixtes, vous pouvez utiliser customstrs- et customcps-. Cela vous permet de définir plusieurs sauts de ligne personnalisées séparées par des virgules via texte ou points de code, par exemple customcps-13,10. Une explication et des exemples de l'application peuvent être trouvés ici.
enckeep, ascii, latin1, latin2, win-ansi, win-1250, win-1251, win-1252, win-1253, cp437, utf7, utf8, utf16le, utf16be, utf32le ou utf32be
keepEncodage pour le fichier converti. "keep" utilise le codage du fichier d’origine, sinon le codage spécifié. Le codage "win-ansi" dépend de la localisation de votre version de Windows. La page de code Windows correspondant à votre version linguistique de Windows sera utilisée. Vous trouverez un aperçu de tous les encodages disponibles ici.
enc-readauto, ascii, latin1, latin2, win-ansi, win-1250, win-1251, win-1252, win-1253, cp437, utf7, utf8, utf16le, utf16be, utf32le ou utf32beautoCodage avec lequel le fichier est lu. Si ce paramètre n’est pas spécifié, une tentative est faite pour détecter automatiquement le codage. Le codage "win-ansi" dépend de la localisation de votre version de Windows. La page de code Windows correspondant à votre version linguistique de Windows sera utilisée.
bom0, 1 ou keep
keepUne marque d’ordre de byte (byte order mark) doit-elle être écrite dans le fichier? 0 pour jamais, 1 pour toujours, "keep" comme dans le fichier d’origine.
dateauto ou keepautoAvec date=keep, chaque date du fichier original est utilisée pour le fichier modifié ou nouvellement stocké. Si vous omettez ce paramètre ou si vous utilisez date=auto, la date de changement du fichier dépend du temps du traitement et la date de création reste à la première heure de création du fichier.
saveChemin d'un fichier
-Avec ce paramètre, vous pouvez enregistrer explicitement le fichier converti sous un nom de fichier que vous pouvez sélectionner librement. Par exemple, spécifiez save=C:\Dossier\Fichier.txt pour enregistrer le fichier converti en tant que C:\Dossier\Fichier.txt. Si vous souhaitez uniquement enregistrer le fichier converti dans un autre dossier tout en conservant le nom du fichier et son extension, utilisez le paramètre save-folder et omettez le paramètre save. De plus, les paramètres save-name pour le nom et save-ext pour l’extension de fichier peuvent être utilisés de la même manière et combinés entre eux. Si vous ne spécifiez aucun des paramètres save, save-folder, save-name ou save-ext, le fichier d’origine sera écrasé.
save-folderkeep ou tout texte
keepDossier dans lequel le fichier converti est enregistré. Si vous ne spécifiez pas ce paramètre ou si vous appelez ce paramètre avec la valeur "keep", le fichier est enregistré dans le dossier dans lequel se trouve le fichier d’origine. Ce paramètre peut être combiné avec les paramètres save-name et save-ext. Chacun de ces paramètres est facultatif, vous permettant de définir indépendamment le dossier, le nom et l’extension. Si vous souhaitez enregistrer le fichier converti sous un nom de fichier explicite avec chemin, nom et extension, utilisez le paramètre save. Si vous ne spécifiez aucun des paramètres save, save-folder, save-name ou save-ext, le fichier d’origine sera écrasé. Avec le paramètre keep-subdirs, vous pouvez contrôler comment traiter les sous-dossiers dans le dossier.
save-namekeep ou tout texte
keepNom sans dossier ni extension de fichier, avec lequel le fichier converti est enregistré. Si vous ne spécifiez pas ce paramètre ou si vous utilisez ce paramètre avec la valeur "keep", le fichier reçoit le même nom que le fichier d’origine. Ce paramètre peut être combiné avec les paramètres save-folder et save-ext. Chacun de ces paramètres est facultatif, vous permettant de définir indépendamment le dossier, le nom et l’extension. Si vous souhaitez enregistrer le fichier converti sous un nom de fichier explicite avec chemin, nom et extension, utilisez le paramètre save. Si vous ne spécifiez aucun des paramètres save, save-folder, save-name ou save-ext, le fichier d’origine sera écrasé.
save-extkeep ou tout texte
keepExtension de fichier avec laquelle le fichier converti est enregistré. Si vous ne spécifiez pas ce paramètre ou si vous utilisez ce paramètre avec la valeur "keep", le fichier converti reçoit l’extension de fichier qui contenait également le fichier d’origine. Ce paramètre peut être combiné avec les paramètres save-folder et save-name. Chacun de ces paramètres est facultatif, vous permettant de définir indépendamment le dossier, le nom et l’extension. Si vous souhaitez enregistrer le fichier converti sous un nom de fichier explicite avec chemin, nom et extension, utilisez le paramètre save. Si vous ne spécifiez aucun des paramètres save, save-folder, save-name ou save-ext, le fichier d’origine sera écrasé.
search-subdirs0 ou 11Les sous-dossiers doivent-ils être recherchés lors de la modification d'un dossier? 0 pour non, 1 pour oui. Une valeur de 0 n'édite que les fichiers du premier niveau du dossier.
keep-subdirs0 ou 10Ce paramètre contrôle si la structure de dossiers d'un dossier origine doit être conservée dans un nouveau dossier ou non. Exemple d'utilisation: un dossier est passé, son contenu doit être converti. Dans ce dossier, il y a un ou plusieurs sous-dossiers avec un nombre arbitraire de niveaux. De plus, les fichiers doivent être stockés dans un nouveau dossier ou un autre dossier (défini via le paramètre parámetro save-folder). Avec keep-subdirs=1, les fichiers sont stockés dans le nouveau dossier dans la même structure de dossiers, car ils ont été stockés dans le dossier d'origine. Avec keep-subdirs=0, la structure de dossiers du dossier origine est ignorée et tous les fichiers sont stockés directement dans le dossier défini pour le stockage.

Exemple: Le fichier C:\dossier\sous-dossier\fichier.txt est converti.
Cas A: Avec "TextEncoder.exe -cl C:\dossier enc=utf8 save-folder=C:\nouveau keep-subdirs=0" le nouveau fichier est stocké sous "C:\nouveau\fichier.txt".
Cas B: Avec "TextEncoder.exe -cl C:\dossier enc=utf8 save-folder=C:\nouveau keep-subdirs=1" le nouveau fichier est stocké sous "C:\nouveau\sous-dossier\fichier.txt".
filter-exttout texte
-Si vous voulez seulement éditer des fichiers avec une extension spécifique, vous pouvez entrer cette extension(s) ici. Par exemple, filter-ext=txt permet de ne modifier que les fichiers portant l’extension TXT. Les fins multiples peuvent être séparées par une barre oblique. Par exemple, filter-ext=php/htm/html permet de modifier uniquement les fichiers portant les extensions PHP, HTM ou HTML. Si vous omettez ce paramètre ou laissez-le vide, les fichiers avec toutes les extensions de fichier seront pris en compte.
filter-nametout texte
-Si vous souhaitez uniquement modifier des fichiers portant un nom spécifique, vous pouvez entrer un nom ici. Tous les fichiers contenant les caractères spécifiés avec "filter-name" sont traités. Avec filter-name=ab, par exemple, des fichiers tels que abc.txt ou xab.txt. Plusieurs termes de recherche peuvent être définis séparés par une barre oblique (par exemple filter-name=abc/def pour rechercher tous les fichiers dont les noms contiennent "abc" ou "def"). Si vous omettez ce paramètre ou le laissez vide, les fichiers avec tous les noms sont pris en compte.
filter-name-matchcase0 ou 10Le texte ou expression régulière spécifié avec le paramètre "filter-name" doit-il être interprété en fonction de sa casse (écriture majuscule et minuscule)? 0 pour non, 1 pour oui. Si 1, le texte du nom du fichier doit être identique dans la même cas et orthographe. Si 0, la recherche est insensible à la casse.
filter-name-matchall0 ou 10Le texte ou l'expression régulière spécifié avec le paramètre "filter-name" doit-il correspondre au nom complet du fichier? 0 pour non, 1 pour oui. Si 1, le nom complet du fichier doit correspondre entièrement au terme de recherche. Si 0, il suffit que le terme de recherche apparaisse seulement quelque part dans le nom du fichier.
filter-name-regex0 ou 10Si le filtre de recherche spécifié sous "filter-name" doit être interprété comme une expression régulière, utilisez 1. Si vous souhaitez uniquement rechercher le texte spécifié, 0.
filter-hiddenfiles0 ou 10Voulez-vous éditer des fichiers cachés lors de la conversion d’un dossier? 0 pour non, 1 pour oui. Une valeur de 0 laisse tous les fichiers cachés sans traitement, une valeur de 1 gère également les fichiers cachés.
filter-onlytextfiles0 ou 11Voulez-vous éditer uniquement les fichiers texte lors de l’édition d’un dossier? 0 pour non, 1 pour oui. Si 1, chaque fichier est vérifié avant d’être converti pour voir s’il s’agit d’un fichier binaire et le traitement n’est pas exécuté si c’est le cas.
openfile0 ou 10Le fichier converti doit-il être ouvert après l'édition? openfile=1 ouvrira le fichier nouvellement créé.
delfile0 ou 10Le fichier d’origine doit-il être supprimé après la conversion? delfile=1 supprime le fichier d’origine. Cette option est utile uniquement si les fichiers convertis doivent être enregistrés sous un nom ou un emplacement différent de celui du fichier d’origine et que les fichiers d’origine ne doivent pas être conservés.
info%enc%, %bom%, %encbom%, %lb%, %lines%, %chars%, %words%, espaces réservés pour le nom de fichier et le dossier, espaces réservés pour la taille du fichier, espaces réservés pour la date et texte arbitraire librement combinable-Avec le paramètre "info", vous pouvez produire des informations sur les fichiers passés et les fichiers des dossiers passés dans la console. Comme valeur, vous pouvez utiliser les espaces réservés %enc% (codage du fichier), %bom% (y a-t-il une marque de ordre d'octets?), %encbom% (codage et marque de ordre d'octets), %lb% (type de saut de ligne ), %lines% (nombre de lignes), %chars% (nombre de caractères) et %words% (nombre de mots) et tout texte arbitraire. De plus, les espaces réservés du TextConverter pour le nom de fichier, le dossier, la taille du fichier et la date peuvent être utilisées. Ainsi, par exemple "info=%enc%" pour afficher uniquement le codage, "info=%encbom% %lb%" pour afficher le codage, la marque de ordre d'octets et le type de saut de ligne ou "info=Le fichier %filename% a %lines% lignes, %chars% caractères et %words% mots." pour produire cette phrase pour un fichier. Une explication détaillée et d'autres exemples peuvent être trouvés dans le tutoriel sur la sortie des informations des fichiers via le script. Même si les exemples de ce didacticiel se réfèrent au TextConverter, tous les exemples peuvent également être utilisés avec le TextEncoder de la même manière.

En principe, tous ces paramètres peuvent être combinés les uns avec les autres et utilisés ensemble. Si vous ne définissez pas de paramètre, la valeur par défaut spécifiée est utilisée pour ce paramètre (le - indique que ce paramètre est vide par défaut). Dans la colonne "Valeurs", vous pouvez voir toutes les valeurs que ce paramètre peut avoir.