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
• Convertir le Contenu des Dossiers
• Lire des Fichiers en utilisant un Format spécifique
• Caractères personnalisés pour les Sauts de Ligne
• Convertir des Fichiers avec une longueur de Ligne fixe
• Sauts de Ligne à plusieurs Caractères
• Paramètres et Fichiers de Paramètres
• Sortie des Informations sur les Fichiers
• Vue d’ensemble de tous les Paramètres disponibles

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.

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.