TextConverter

Contrôle de Script du TextConverter

Toutes les actions et fonctions pour le traitement et la conversion des fichiers texte qui peuvent être utilisées via l'interface utilisateur graphique du TextConverter peuvent également être contrôlées via la ligne de commande. Avec cela, il est possible de contrôler le TextConverter via des scripts et d'automatiser les tâches de conversion de texte.

Dans ce tutoriel, nous vous montrons comment vous pouvez contrôler le TextConverter via des paramètres et quels paramètres sont disponibles pour convertir les fichiers et le contenu des dossiers. De plus, vous pouvez également consulter le tutoriel sur le contrôle du script du TextEncoder pour le TextConverter. Le tutoriel du TextEncoder met plus d'accent sur la lecture et la modification du type de codage et du saut de ligne des fichiers texte, tandis que ce didacticiel est davantage axé sur les actions pour modifier le contenu des fichiers. Tous les paramètres présentés dans le tutoriel du TextEncoder peuvent également être utilisés avec le TextConverter. Pour les fonctions présentées dans ce tutoriel, vous avez besoin du TextConverter dans la version TextConverter Pro CL.

Le tutoriel est divisé en les sections suivantes:

Bases Générales du Contrôle de Script du TextConverter

Pour mettre le TextConverter en mode batch, nous utilisons le paramètre -cl. Ce paramètre est toujours passé comme premier paramètre dans tous les exemples suivants. Si nous ne transmettons pas ce paramètre, le TextConverter commencera par l'interface utilisateur graphique et il n'y aura pas de conversion automatique des fichiers qui sont passés. Au lieu de cela, les fichiers remis en tant que paramètres seront affichés dans la liste des fichiers après le début du programme. De la même manière, il se comporte avec des dossiers passés, quel contenu sera chargé dans la liste des fichiers du TextConverter. Bien sûr, cette fonction peut également être utile si vous souhaitez démarrer le TextConverter avec certains fichiers.

Fondamentalement, nous avons 3 façons différentes de dire au TextConverter quelles conversions doivent être effectuées: nous pouvons transmettre des actions individuelles en tant que paramètres, nous pouvons passer des listes d'actions sous la forme de fichiers qui peuvent contenir plusieurs actions ou nous pouvons transmettre des fichiers de configuration qui en plus aux actions peuvent également contenir d'autres paramètres tels que les paramètres de stockage, par exemple. En plus, certains paramètres sont disponibles pour les options de stockage, le codage, le type de saut de ligne et la recherche de fichiers dans les dossiers passés.

Jetons un coup d'œil à quelques exemples simples avant d'entrer dans les détails dans les sections suivantes. L'exemple le plus simple est de faire le TextConverter d'exécuter une seule action. Nous pouvons transmettre des actions avec le paramètre "a=action":

TextConverter.exe -cl C:\test.txt "a=REPLACE a b"

Cela remplace les lettres "a" par "b" dans le fichier "test.txt". Si nous voulons appliquer plusieurs actions, nous pouvons les transmettre à l'aide des paramètres a1, a2, a3 et ainsi de suite dans une ligne:

TextConverter.exe -cl C:\test.txt "a1=DELETE a" "a2=DELETE b"

Cela supprime toutes les occurrences du "a" et "b" dans le fichier "test.txt". Vous pouvez en savoir plus à ce sujet dans la section sur l'application des actions individuelles.

Si vous souhaitez appliquer plusieurs actions, vous n'avez pas nécessairement à les écrire dans une ligne. Au lieu de cela, vous pouvez également résumer plusieurs actions dans une liste d'actions (fichier texte avec une action par ligne) et passer uniquement cette liste d'actions:

TextConverter.exe -cl C:\test.txt al=C:\liste-d-actions.tcal

Plusieurs listes d'actions peuvent être passées avec les paramètres al1, al2, al3 et ainsi de suite et sont ensuite traités à leur tour par le TextConverter. Vous pouvez en savoir plus sur les listes d'action dans la section sur l'application des listes d'actions.

La troisième façon est de remettre les fichiers de paramètres. Les fichiers de paramètres sont les fichiers dans lesquels le TextConverter stocke ses paramètres. Ces fichiers ont toujours l'extension de fichier TCS (Text Converter Settings) et peuvent être passés comme suit:

TextConverter.exe -cl C:\test.txt C:\parametres.tcs

Cela convertit le fichier "test.txt" en fonction des paramètres qui sont stockés dans le fichier de paramètres "parametres.tcs". Vous pouvez en savoir plus sur la création et l'utilisation de fichiers de paramètres dans la section sur l'utilisation des fichiers de paramètres.

Dans tous nos exemples précédents, nous n'avons pas influencé l'emplacement de stockage du fichier converti (sauf s'il existe des paramètres correspondants dans le fichier de paramètres). S'il n'y a pas de déclaration sur un emplacement de stockage différent, le fichier d'origine est écrasé. Si nous souhaitons enregistrer le fichier modifié dans un emplacement autre que le fichier d'origine, certains paramètres sont disponibles, par exemple:

TextConverter.exe -cl C:\test.txt "a=WRITE LOWERCASE" save=C:\lowercase.txt
TextConverter.exe -cl C:\test.txt "a=WRITE UPPERCASE" save-folder=C:\uppercase

Les deux lignes modifient l'écriture du texte dans le fichier "test.txt". La première ligne convertit toutes les lettres du fichier en lettres minuscules et stocke le résultat en tant que nouveau fichier dans le fichier C:\lowercase.txt. Dans la deuxième ligne, au lieu d'un chemin de fichier complet, seulement un dossier de stockage est spécifié. Cela signifie que le nom du fichier d'origine est conservé et que le résultat (toutes les lettres en majuscules) dans ce cas est enregistré en tant que nouveau fichier sous C:\upperase\test.txt. Vous pouvez en savoir plus sur les options de stockage dans la section sur les paramètres de stockage.

En plus des paramètres du stockage, certains paramètres sont également disponibles pour l'encodage et le type de saut de ligne utilisé pour lire et enregistrer les fichiers. Vous pouvez voir un exemple ici:

TextConverter.exe -cl C:\test.txt "a=SWAP_LINES 1 2" save=C:\swapped.txt enc=utf8 bom=0 lb=crlf

Dans cet exemple, nous modifions à nouveau le fichier "test.txt". Cette fois, nous échangeons la première et la deuxième ligne du texte dans le fichier et nous enregistrons le résultat dans le fichier C:\swapped.txt avec le codage UTF-8 et le type de saut de ligne CRLF (Windows). De plus, avec "bom=0", nous indiquons qu'aucune marque d’ordre d’octets (Byte Order Mark) doit être écrite dans le fichier. Si nous omettons les paramètres pour le codage et le type de saut de ligne, une tentative est faite pour déterminer le codage et le type de saut de ligne du fichier d'origine automatiquement afin de l'utiliser à nouveau pour le stockage. Vous pouvez en savoir plus sur ce sujet dans la section sur les paramètres du codage et le type de saut de ligne. Là, vous pouvez également découvrir comment vous pouvez forcer le TextConverter à lire des fichiers avec un certain type de saut de ligne ou un certain type d'encodage. De plus, vous trouverez une liste de tous les encodages et types de saut de ligne pris en charge par le TextConverter dans l'aperçu des formats pris en charge du TextConverter.

Bien sûr, tous les paramètres présentés jusqu'à présent peuvent également être combinés avec les autres. Dans quel ordre les paramètres et les actions sont traité et exécuté, en particulier si plusieurs paramètres concurrents sont passés, se trouvent dans la section sur l'utilisation combinée des actions, des listes d'action, des fichiers et des paramètres de paramètres.

Jusqu'à présent, nous n'avons travaillé sur un seul fichier qu'en même temps. Cependant, il est également possible de modifier plusieurs fichiers à la fois. Par exemple en remettant plusieurs fichiers ou un dossier entier:

TextConverter.exe -cl C:\test1.xml C:\test2.xml "a=DELETE_ATTRIBUTES ALL"
TextConverter.exe -cl C:\dossier filter-ext=csv "a=CALC_IN_CELLS ALL ADD 1"

Avec la première ligne, nous supprimons tous les attributs des fichiers XML "test1.xml" et "test2.xml". La deuxième ligne traite tous les fichiers CSV dans le dossier "C:\dossier" et ajoute la valeur 1 dans chaque cellule de la table CSV. Vous pouvez en savoir plus sur ce sujet et d'autres options de filtre pour les dossiers en les sections sur le traitement des fichiers individuels ou multiples et le traitement du contenu des dossiers.

Appliquer des Actions individuelles

Si vous souhaitez seulement apporter une ou quelques modifications aux fichiers, vous pouvez transmettre des actions individuelles directement via des paramètres sans avoir à créer une liste d'actions ou un fichier de paramètres. Vous pouvez en voir un exemple ici:

TextConverter.exe -cl C:\test.txt "a=REPLACE a b"

Avec cet appel, nous remplaçons la lettre "a" par "b" dans le fichier "test.txt". D'abord, nous mettons le TextConverter en mode batch avec le paramètre "-cl". Ensuite, nous remettons le fichier que nous voulons modifier. Avec le paramètre "a" Nous pouvons définir une action (dans ce cas "REPLACE a b"), que le TextConverter exécute ensuite.

Si nous voulons que le TextConverter applique plusieurs actions, nous pouvons utiliser a1, a2, a3 et ainsi de suite. Voici un exemple:

TextConverter.exe -cl C:\dossier "a1=REWRITE REMOVE_DOUBLE_SPACES" "a2=DELETE_LINES 1-5"

Avec cet appel, nous modifions tous les fichiers du dossier "C:\dossier". D'abord, nous supprimons tous les espaces doubles, puis nous supprimons les cinq premières lignes de chaque fichier. Plusieurs actions sont toujours effectuées dans l'ordre des paramètres. Même si vous écrivez "a2" devant "a1", le premier paramètre (ici "a2") est toujours effectué en premier.

Si vous ne savez pas quelles actions sont disponibles et à quoi ressemble la syntaxe des actions, vous pouvez démarrer le TextConverter et créer vos actions souhaitées en utilisant "Listes d'Actions > Nouvelle Action" via l'interface utilisateur graphique. Si vous passez de la vue de la liste dans la vue du texte en la liste d'actions, vous verrez la syntaxe et vous pouvez copier et utiliser vos actions directement. Pour plus d'informations, consultez l'introduction de l'utilisation des listes d'actions dans le TextConverter.

Appliquer des Listes d’Actions

Les listes d'actions sont des fichiers texte qui peuvent contenir une ou plusieurs actions. Cela signifie que les listes d'actions offrent la possibilité de résumer plusieurs actions et de les utiliser dans un regroupement. Dans une liste d'actions, chaque action est écrite dans une nouvelle ligne. Ainsi, par exemple:

REPLACE Bonjour "Bonne Journée"
DELETE_IN_LINES 10-20 [0-9] -r
SORT_LINES 4-7 DOWN
WRITE UPPERCASE_WORDS

Cette liste d'actions remplace initialement "Bonjour" par "Bonne Journée". Ensuite, tous les nombres des lignes 10 à 20 sont supprimés à l'aide d'expressions régulières (-r), puis les lignes 4 à 7 sont triées par ordre décroissant et enfin la première lettre de tous les mots de l'ensemble du texte est capitalisée.

Si nous enregistrons ce texte respectivement cette liste d'actions, par exemple, sous le nom de fichier "C:\liste-d-actions.tcal" (l'extension de fichier TCAL signifie "Text Converter Action List"), nous pouvons l'utiliser comme suit:

TextConverter.exe -cl C:\test.txt al=C:\liste-d-actions.tcal

Tout d'abord, nous mettons le TextConverter en mode batch en utilisant le paramètre "-cl". Nous passons le fichier "test.txt" et utilisons le paramètre "al=" pour remettre notre liste d'actions. Cela signifie que le TextConverter appliquera toutes les actions de notre liste d'actions "liste-d-actions.tcal" au fichier "test.txt". Étant donné que nous n'avons donné aucune instruction sur un emplacement de stockage différent, le fichier d'origine "test.txt" sera écrasé avec le fichier modifié.

Plusieurs listes d'actions peuvent également être passé et appliquées en même temps dans un seul appel:

TextConverter.exe -cl C:\test.txt al1=C:\liste-d-actions1.tcal al2=C:\liste-d-actions2.tcal

Avec les paramètres al1, al2, al3 et ainsi de suite, plusieurs fichiers contenant listes d'actions peuvent être passés dans une ligne. Que vous utilisiez al1, al2, al ou al10 comme premier paramètre, le TextConverter toujours traitera la première liste d'actions passé en premier. Une fois cette liste d'actions terminée, la prochaine liste d'actions passée sera traitée et ainsi de suite.

Si vous ne souhaitez pas créer vos listes d'actions manuellement, vous pouvez également utiliser l'interface utilisateur graphique du TextConverter pour le faire. Dans tous les sections nommés "Listes d'Actions", vous trouverez le bouton "Nouvelle Liste d'Actions". Si vous cliquez sur ce bouton, vous arriverez à un éditeur avec lequel vous pouvez créer des actions commodément et les ajouter à votre liste d'actions. Vous pouvez soit copier et enregistrer le résultat de l'éditeur manuellement, soit laisser la gestion et le stockage des listes d'action au TextConverter. Les listes d'action stockées par le TextConverter se trouvent dans le dossier "actionlists" situé dans le dossier du programme.

Appliquer des Fichiers de Configuration

En plus de passer des actions individuelles ou des listes d'actions en tant que paramètres, les fichiers de configuration peuvent également être utilisés pour la conversion des fichiers via le contrôle du script. Les fichiers de configuration ont toujours l'extension de fichier TCS (Text Converter Settings) et peuvent contenir tous les paramètres du TextConverter. Ainsi, ils peuvent non seulement contenir des actions individuelles telles que les listes d'actions, mais aussi, par exemple, les options de stockage. Vous pouvez en savoir plus sur les fichiers de configuration dans l'article sur le chargement et l'enregistrement des paramètres.

Les fichiers de configuration peuvent être créés commodément via l'interface utilisateur graphique du TextConverter. Tout d'abord, définissez simplement toutes les actions, options et paramètres de stockage dans le TextConverter comme si vous souhaitez convertir des fichiers via l'interface utilisateur graphique. Accédez ensuite au menu "Paramètres > Enregistrer et Charger les Paramètres" et cliquez sur le bouton "Sauver comme Fichier". Vous recevrez un fichier qui contient tous les paramètres actuels du TextConverter. Vous pouvez transmettre ce fichier directement à TextConverter:

TextConverter.exe -cl C:\test.txt C:\parametres.tcs

Dans cet exemple, le fichier "test.txt" est converti en fonction des paramètres que vous avez enregistrés dans le fichier "parametres.tcs". Ils peuvent être d'actions ainsi que d'options de stockage ou de conversions du codage ou du type de saut de ligne utilisé dans le fichier.

Si vous remettez plusieurs fichiers de configuration sous forme de paramètres, ils sont chargés à leur tour et écrasent toujours les paramètres déjà chargés à partir des autres fichiers de paramètres. Si vous mélangez des paramètres, des listes d'actions ou d'autres paramètres dans les paramètres, les fichiers de configuration sont toujours chargés en premier et, si nécessaire, écrasés par les paramètres (en savoir plus ici).

Si vous enregistrez des fichiers de configuration avec le TextConverter, ces fichiers contiennent beaucoup plus d'informations que nous avons besoin pour notre contrôle de script. Par exemple, les fichiers de configuration peuvent également contenir des informations sur la taille de la fenêtre, la position de la fenêtre ou les colonnes de votre liste de fichiers. Le TextConverter utilise ces informations lors du chargement de l'interface utilisateur graphique. Si le TextConverter est lancé en mode batch, ces informations non nécessaires sont simplement ignorées. Il n'est donc pas nécessaire de "nettoyer" les fichiers de configuration manuellement, ils peuvent simplement être utilisés comme ils sont enregistrés par le TextConverter.

Néanmoins, il peut y avoir des situations dans lesquelles il est logique d'adapter manuellement les fichiers de configuration. Vous pouvez ouvrir et modifier les fichiers de configuration avec n'importe quel éditeur de texte. Par exemple, pour créer un fichier de configuration qui ne contient que certaines actions ou uniquement les options de stockage. Vous pouvez ensuite combiner ces fichiers de configuration "partiels" en tant que paramètres avec d'autres fichiers de configuration ou paramètres, qui peuvent être plus efficaces dans certaines situations que la création de fichiers de configuration individuels pour chaque combinaison de paramètres.

Paramètres pour l’Emplacement de Stockage et le Nom du Fichier

Si nous ne disons pas explicitement au TextConverter où et sous quel nom les fichiers convertis doivent être enregistrés, le fichier d'origine est écrasé par défaut. Un exemple de cela serait l'appel suivant:

TextConverter.exe -cl C:\test.txt "a=MOVE_LINES 1 -1"

Avec cet appel, d'abord le TextConverter lira le fichier "C:\test.txt", puis déplacera la première ligne du fichier à la fin du fichier, puis sauvera le résultat sous "C:\test.txt". En d'autres termes, cela écrasera le fichier d'origine car nous n'avons pas spécifié d'emplacement différent.

Dans le cas où nous ne voulons pas écraser le fichier d'origine, les paramètres save, save-folder, save-name et save-ext sont disponibles. Dans ce qui suit, nous examinons des exemples de chacun de ces paramètres.

TextConverter.exe -cl C:\test.txt "a=REPLACE a b" save=C:\dossier\nouveau.dat

Avec le paramètre "save", un chemin entier peut être spécifié pour le stockage. Dans cet exemple, le fichier "C:\test.txt" est d'abord lu, puis la lettre "a" est remplacée par "b", puis le résultat est enregistré dans le fichier "C:\dossier\nouveau.dat" . Le fichier d'origine est conservé.

Le même résultat peut également être obtenu avec l'utilisation des paramètres save-folder, save-name et save-ext:

TextConverter.exe -cl C:\test.txt "a=REPLACE a b" save-folder=C:\dossier save-name=nouveau save-ext=dat

Le résultat de cet appel est identique à l'exemple précédent. De nouveau, le résultat de la conversion est enregistré dans le fichier "C:\dossier\nouveau.dat". Alors que "save" attend un chemin entier, nous pouvons utiliser les 3 paramètres save-folder, save-name et save-ext pour définir tous les composants du chemin individuellement. L'utilisation des 3 paramètres individuels est particulièrement utile si nous ne voulons pas définir chacun de ces paramètres. Par exemple:

TextConverter.exe -cl C:\test.txt "a=REPLACE a b" save-folder=C:\nouveau

Dans cet exemple, nous ne définissons que le paramètre "save-folder". Étant donné que le TextConverter utilise toujours le nom précédent comme valeur par défaut, cet appel mène à la situation que le nom et l'extension de fichier sont adopté du fichier d'origine. Le fichier converti est donc enregistré sous le nom "C:\nouveau\test.txt". Ce paramètre peut être particulièrement utile si nous voulons convertir plusieurs fichiers ou tous les fichiers à partir d'un dossier et nous voulons enregistrer les résultats dans un nouveau dossier.

TextConverter.exe -cl C:\test.txt "a=REPLACE a b" save-name=nouveau
TextConverter.exe -cl C:\test.txt "a=REPLACE a b" save-ext=dat
TextConverter.exe -cl C:\test.txt "a=REPLACE a b" save-folder=C:\nouveau save-ext=dat

Les résultats de ces 3 appels sont analogues au dernier exemple. La première ligne seulement modifie le nom du fichier, il est donc enregistré comme "C:\nouveau.txt" en maintenant le dossier et l'extension de fichier. La deuxième ligne mène au fichier "C:\test.dat" et dans la troisième ligne, nous modifions le dossier et l'extension du fichier tandis que le nom du fichier est repris par le fichier d'origine, donc le résultat est "C:\nouveau\test.dat".

En plus de l'utilisation de ces paramètres, il existe un autre moyen d'influencer l'emplacement et le nom du fichier converti. Il s'agit d'utiliser des fichiers de configuration. Cependant, le principe est le même, car les paramètres mentionnés ici sont également inclus dans les fichiers de configuration. La seule différence est que les paramètres ne doivent pas être spécifiés individuellement, mais seul le chemin du fichier de configuration pertinent doit être passé comme paramètre. Vous pouvez découvrir comment créer et utiliser des fichiers de configuration dans la section sur les fichiers de configuration.

Paramètres pour l’Encodage et le Type de Saut de Ligne

D'autres paramètres sont disponibles pour contrôler l'encodage et le type de saut de ligne utilisés pour lire et écrire les fichiers. Pour la lecture, ce sont les paramètres lb-read (Line Break Read) et enc-read (Encoding Read), pour l'écriture, nous pouvons utiliser les paramètres lb (Line Break), enc (Encoding) et bom (Byte Order Mark, Marque d’Ordre d’Octets). Si nous donnons aucune instruction au TextConverter, le TextConverter essaie de détecter automatiquement le type de saut de ligne et l'encodage du fichier d'origine pendant la lecture, et lors de l'écriture, le type de saut de ligne et l'encodage déterminé du fichier d'origine sont adoptés.

Jetons un coup d'œil à trois exemples qui illustrent cela.

TextConverter.exe -cl C:\test.txt enc=utf16le bom=1

Cet appel modifie le codage du fichier "test.txt" en UTF-16 Little Endian (utf16le), quel que soit le codage du fichier auparavant. L'additif "bom=1" garantit qu'une Marque d’Ordre d’Octets (Byte Order Mark) est écrite dans le fichier. Étant donné que nous n'avons ni paramètres spécifiés pour le type de saut de ligne ni pour un emplacement pour le nouveau fichier, le type de saut de ligne du fichier original est adopté et le fichier d'origine est écrasé. Étant donné que nous n'avons pas spécifié dans lequel codage le fichier d'origine doit être lu, une tentative est faite pour déterminer automatiquement l'encodage pour la lecture.

TextConverter.exe -cl C:\test.txt enc-read=win-1251 enc=utf8 bom=0 lb=crlf save=C:\nouveau.txt

Dans cet appel, nous indiquons que le fichier original a le Codepage Windows 1251 (Cyrillique) et que le TextConverter doit interpréter les octets du fichier original dans le sens de cette page de code. Ceci est important pour ce codage, particulièrement si vous utilisez le TextConverter sur un système Windows avec une langue différente, car les pages de code ANSI ne peuvent pas être distinguées en raison des octets et sont une question d'interprétation. Une fois le fichier lu, le TextConverter modifie le codage du fichier en UTF-8 sans marque d’ordre d’octets et utilise le type de saut de ligne CR LF (Windows), quel que soit le type de saut de ligne utilisé dans le fichier d'origine. Le fichier converti est enregistré sous "C:\nouveau.txt", le fichier d'origine est conservé.

TextConverter.exe -cl C:\test.txt a="INSERT test 10" lb-read=fixedlength-20 lb=system

Dans les deux premiers exemples, nous n'avons changé que l'encodage et le type de saut de ligne du fichier d'origine sans modifier le contenu du fichier. Dans cet appel, nous effectuons également une action qui modifie le contenu du fichier: nous aimerions insérer le mot "test" en position de caractère 10 dans le fichier. De plus, nous voulons seulement basculer le type de saut de ligne d'une longueur de ligne fixe de 20 caractères au saut de ligne du système. L'encodage du fichier d'origine doit être préservé. Le type de saut de ligne système correspond au saut de ligne standard du système sur lequel le TextConverter est actuellement exécuté (par exemple CR LF sur les systèmes Windows).

Les paramètres pour les actions, les listes d'actions ou les fichiers de configuration peuvent être écrits à chaque position dans la ligne de paramètres. Dans notre exemple, nous avons d'abord défini l'action, puis "lb-read", puis "lb". Cependant, nous pourrions également utiliser n'importe quel autre ordre pour obtenir le même résultat.

Vous pouvez voir quelles valeurs vous pouvez utiliser pour les différents codages et types de saut de ligne dans l'aperçu de tous les paramètres disponibles. Vous pouvez trouver plus d'exemples dans le tutoriel pour le TextEncoder. Tous les paramètres et valeurs de paramètres pour le TextEncoder expliqués là, peuvent également être utilisé avec le TextConverter. En particulier, les sections sur les caractères personnalisés pour les sauts de ligne, les sauts de ligne à plusieurs caractères et la conversion de fichiers avec une longueur de ligne fixe vont au-delà des exemples expliqués ici.

Comme les paramètres de l'emplacement de stockage et le nom du fichier, également les paramètres de l'encodage et du type de saut de ligne peuvent être alternativement remis via les fichiers de configuration. La procédure est la suivante: le type de codage et le type de saut de ligne peuvent être configuré via l'interface utilisateur graphique du TextConverter, ces paramètres sont enregistrés en tant que fichier de configuration et ce fichier de configuration est ensuite passé à TextConverter au lieu de spécifier les paramètres individuels. Afin de le faire fonctionner, les actions "Encodage" et/ou "Type de Saut de Ligne" doivent être actives. Il ne suffit donc pas de simplement modifier les valeurs sous "Lire comme" et "Sauver sous" dans l'interface utilisateur graphique, les crochets doivent également être définis pour "Encodage" et/ou "Type de Saut de Ligne". Si ce n'est pas le cas, la valeur par défaut "auto" est utilisée pour la lecture et la valeur par défaut "keep" est utilisée pour l'écriture. Si un fichier de configuration est passé, qui contient des instructions pour le type de codage et/ou le type de saut de ligne, et vous passez en outre des paramètres tels que "enc" ou "lb", les paramètres écraseront les valeurs du fichier de configuration. Vous pouvez en savoir plus sur la création et l'utilisation de fichiers de paramètres dans la section sur les fichiers de configuration.

Paramètres pour la Date du Fichier

Lors de la conversion des fichiers avec le TextConverter, nous pouvons soit écraser les fichiers d'origine avec les fichiers convertis, soit enregistrer les fichiers convertis en tant que nouveaux fichiers en spécifiant un emplacement de stockage ou un nom différent de celui du fichier d'origine.

Si le résultat de la conversion est enregistré dans un tout nouveau fichier, ce fichier porte automatiquement l'horodatage sur lequel la conversion a eu lieu après son enregistrement. Cela affecte à la fois la date de création et la date de dernière modification du fichier. Si nous écrasons le fichier d'origine à la place, la date de création d'origine restera la même, mais la date de modification du fichier sera remplacée par l'heure de la conversion.

Si vous ne souhaitez pas ce changement automatique des dates de fichier, nous pouvons passer le paramètre "date=keep":

TextConverter.exe -cl C:\test1.txt "a=REPLACE a b" save=C:\test1.txt date=keep
TextConverter.exe -cl C:\test2.txt "a=REPLACE c d" save=C:\nuevo.txt date=keep

Le paramètre "date=keep" a pour effet que la date du fichier d'origine est adoptée pour le fichier converti. Cela affecte à la fois la date de création ainsi que la date de modification et la date du dernier accès et peut être utilisé à la fois pour écraser et pour enregistrer les fichiers convertis en tant que nouveaux fichiers, comme le montre l'exemple.

Ce paramètre correspond à l'option "Garder la date du fichier original" des options de sauvegarde de l'interface utilisateur graphique du TextConverter. Par conséquent, cette option peut également être utilisée en transmettant des fichiers de paramètres contenant les paramètres appropriés.

Paramètres pour activer les Espaces Réservés et les Références

Par défaut, le remplacement des espaces réservés et des références est désactivé dans le TextConverter. Si vous souhaitez utiliser des espaces réservés ou des références lors du contrôle du TextConverter via un script, vous devez donc activer les options correspondantes, sinon les espaces réservés concernés ne seront pas remplacés. Vous avez plusieurs occasions de le faire.

Si vous utilisez des fichiers de configuration, vous pouvez activer une ou les deux options via l'interface utilisateur graphique du TextConverter avant d'enregistrer votre fichier de configuration. Vous pouvez trouver les deux options dans la section "Actions > Options".

Si vous n'utilisez pas des fichiers de configuration, par exemple parce que vous travaillez avec des actions individuelles ou des listes d'actions, ou si vous souhaitez écraser les réglages des fichiers de configuration passés, vous pouvez utiliser les paramètres "ph" et "ref" pour contrôler l'utilisation d'espaces réservés et de références. Avec "ph=1" vous pouvez activer les espaces réservés, avec "ref=1" vous pouvez activer les références. Si vous utilisez un "0" au lieu d'un "1", les options correspondantes seront désactivées.

Un exemple d'utilisation du paramètre "ref" est l'appel suivant du TextConverter, qui définit le contenu du champ A1 (1:1) sur le contenu du champ B2 (2:2) dans le fichier CSV "C:\data.csv" à l'aide d'une référence:

TextConverter.exe -cl C:\data.csv "a=REPLACE_CELLS 2:2 %%ref:cell=1:1%%" ref=1

Nous utilisons l'action "REPLACE_CELLS Champ NouveauContenu". Pour que la référence de cellule contenue %ref:cell=1:1% soit interprétée comme telle, nous passons le paramètre "ref=1". Lors de l'appel de cet appel de script sous Windows, nous devons également doubler le caractère "%" pour qu'il soit reconnu comme tel.

Un exemple d'utilisation du paramètre "ph" est l'appel suivant du TextConverter, qui remplace une date arbitraire dans le fichier "C:\test.txt" par la date actuelle:

TextConverter.exe -cl C:\test.txt "a=REPLACE [0-9]+-[0-9]+-[0-9]+ %%date%% -r" ph=1

Pour cela, nous utilisons la fonction REPLACE (REPLACE Rechercher Remplacer -Paramètres), qui est passée ici comme une seule action. Cette action recherche n'importe quelle date au format "nombre-nombre-nombre" à l'aide de l'expression régulière "[0-9]+-[0-9]+-[0-9]+" (-r) et le remplace par l'espace réservé de date "%date%", qui représente la date actuelle. Là encore, on double le caractère "%" pour qu'il soit reconnu comme tel. Comme dernier paramètre, nous passons "ph=1" et veillons ainsi à ce que l'espace réservé soit également interprété comme tel.

Même si une seule des deux options était activée dans chacun des deux exemples, vous pouvez bien sûr également passer les deux paramètres en même temps au sein d'un même appel et ainsi les utiliser indépendamment l'un de l'autre.

Dans les paramètres pour l'emplacement de stockage et le nom de fichier "save", "save-folder", "save-name" ainsi que "save-ext", les espaces réservés sont toujours remplacés. Par conséquent, l'activation de l'option d'espace réservé n'est nécessaire que si vous utilisez des espaces réservés dans vos actions. Une activation n'est pas requise pour l'utilisation d'espaces réservés dans les noms de fichiers.

Application combinée des Actions, des Listes d’Actions, des Fichiers de Configuration et des Paramètres

Des actions individuelles, des fichiers avec des listes d'actions, des fichiers de configuration et tous les autres paramètres tels que les paramètres de l'emplacement de stockage, de l'encodage ou du type de saut de ligne peuvent également être transmis combinés à TextConverter. Dans ce contexte, la question se pose, quelle interaction les différents paramètres peuvent se développer et dans lesquels ordre le TextConverter traite les paramètres et les actions individuels. Cette question est particulièrement importante dans le cas où les configurations individuelles complètent ou même contredisent.

Généralement, le TextConverter traite les paramètres passés dans l'ordre suivant:

Jetons un coup d'œil à quelques exemples de l'application combinée des actions, des listes d'action, des fichiers de configuration et des paramètres qui illustrent la priorité et l'ordre de l'application:

TextConverter.exe -cl C:\test.txt a2="DELETE a" al=C:\liste-d-actions.tcal a1="DELETE b"

Dans cet exemple, l'action a2 est appliquée en premier, après que la liste d'action est exécutée, puis l'action a1 est appliquée. Ainsi, le TextConverter suit strictement l'ordre des paramètres, que les actions individuelles ou les listes d'actions soient passées et quel que soit le numéro de paramètre que vous donnez les actions et les listes d'actions.

TextConverter.exe -cl C:\test.txt a="DELETE a" C:\configuration.tcs al=C:\liste-d-actions.tcal

Dans cet exemple, un fichier de configuration est ajouté aux actions et listes d'actions. Les fichiers de configuration sont toujours traités en premier, quelle que soit la position, ils sont définis dans les paramètres. Ainsi, d'abord le fichier de configuration est appliqué, puis l'action unique et enfin la liste d'actions.

TextConverter.exe -cl C:\test.txt save-folder=C:\nouveau save-ext=dat C:\configuration.tcs

Dans cet exemple, encore une fois, le fichier de configuration est chargé en premier. Les paramètres save-folder et save-ext écrasent ensuite les options de stockage possibles à partir du fichier de configuration. Quelle que soit les options de stockage définies dans le fichier de configuration, il est enregistré dans le dossier "C:\nouveau" avec l'extension de fichier "dat". Puisque nous n'avons pas spécifié un paramètre pour le nom du fichier, cette configuration n'est pas écrasé et le nom configuré dans le fichier de configuration sera utilisé pour le stockage (s'il n'y a pas de paramètres pour le nom dans le fichier de configuration, le nom du fichier d'origine sera utilisé). Dans ce cas, l'ordre des paramètres n'a pas d'importance, nous obtiendrons le même résultat, quelle que soit l'ordre dans lequel nous organisons les paramètres donnés.

Convertir Fichiers individuels et multiples

Pour traiter un seul fichier avec le TextConverter via la ligne de commande, vous pouvez simplement transmettre le chemin du fichier, comme nous l'avons déjà vu dans de nombreux autres exemples de ce tutoriel:

TextConverter.exe -cl C:\test.txt "a=REPLACE a b"

Avec cet appel, nous remplaçons la lettre "a" par "b" dans le fichier "test.txt". Dans ce cas, le fichier d'origine est écrasé, car nous ne donnons aucune instruction différente de stockage.

Si nous ne voulons pas écraser le fichier d'origine, nous pouvons spécifier un chemin différent pour le stockage via le paramètre "save":

TextConverter.exe -cl C:\test.txt "a=REPLACE a b" save=C:\nouveau.txt

Avec cet appel, le fichier d'origine "C:\test.txt" reste et nous enregistrons notre résultat dans le fichier "C:\nouveau.text".

Si vous souhaitez traiter plusieurs fichiers en même temps de la même manière, il n'est pas nécessaire d'appeler le TextConverter à plusieurs reprises. Vous pouvez également simplement transmettre plusieurs chemins de fichier dans une ligne:

TextConverter.exe -cl C:\test1.txt C:\test2.txt C:\test3.txt "a=REPLACE a b"

Avec cet appel, nous remplaçons la lettre "a" par "b" dans les fichiers "test1.txt", "test2.txt" et "test3.txt". Également dans cet exemple, les 3 fichiers originaux sont écrasés. Si vous souhaitez conserver les fichiers d'origine, vous pouvez simplement spécifier un emplacement différent ou un nom différent pour les nouveaux fichiers via les paramètres save-folder, save-name et save-ext (spécifiant un seul chemin de fichier pour le stockage via le paramètre "save", n'a aucun sens à ce stade, car nous avons plus d'un fichier). Ainsi, par exemple:

TextConverter.exe -cl C:\test1.txt C:\test2.txt "a=REPLACE a b" save-folder=C:\nouveau

Avec cet appel, nous modifions les fichiers "C:\test1.txt" et "C:\test2.txt" et enregistrez le résultat dans le dossier "C:\nouveau". Puisque nous ne spécifions qu'un nouveau dossier et ne faisons pas de déclaration sur le nom du fichier, le nom du fichier original est adopté. Le résultat de notre conversion est donc enregistré dans les fichiers "C:\nouveau\test1.txt" et "C:\nouveau\test2.txt". Bien sûr, nous pouvons également modifier le nom ou l'extension de fichier pour le nouveau fichier. Par exemple:

TextConverter.exe -cl C:\test1.txt C:\test2.txt "a=REPLACE a b" save-name=%%name%%_%%date%% save-ext=dat

Dans cet exemple, nous seulement conservons le dossier des fichiers d'origine. D'un autre côté, nous modifions le nom et l'extension de fichier via les paramètres "save-name" et "save-ext". En tant que nouveau nom, nous aimerions attacher la date actuelle à l'ancien nom. Pour cela, nous utilisons l'espace réservé %name% pour l'ancien nom et %date% pour la date actuelle (nous devons doubler le signe pour cent afin que le système d'exploitation n'interpréte pas les variables dans son sens). En tant que nouvelle extension de fichier, nous aimerions utiliser l'extension de fichier "dat". Vous pouvez en savoir plus sur ce sujet dans la section sur les paramètres de stockage.

Si vous souhaitez convertir plusieurs fichiers, vous n'avez pas nécessairement à spécifier le chemin pour chaque fichier individuel. Au lieu de cela, vous pouvez également transmettre un ou plusieurs dossiers afin de convertir leur contenu. Dans la section suivante, vous découvrirez comment cela fonctionne et comment vous pouvez utiliser des filtres pour ne pas convertir tous les fichiers stockés dans les dossiers remis.

Convertir Fichiers des Dossiers

Si vous souhaitez traiter beaucoup de fichiers, il peut être laborieux de passer chaque fichier individuellement au TextConverter. Dans ce cas, vous pouvez également travailler avec des dossiers. Afin de convertir tous les fichiers à partir d'un dossier, nous pouvons simplement passer le chemin au dossier pertinent. La syntaxe est la même que nous avons déjà vue à partir de passer des fichiers:

TextConverter.exe -cl C:\dossier "a=REPLACE a b"

Avec cet appel, tous les fichiers stockés dans le dossier "C:\dossier" sont convertis (la lettre "a" est remplacée dans les fichiers par la lettre "b"). Comme nous n'avons pas spécifié d'emplacement de stockage différent, les fichiers d'origine sont écrasés dans le dossier. Si nous souhaitons conserver les fichiers d'origine, nous pouvons utiliser les paramètres pour le stockage pour influencer l'emplacement et le nouveau nom de fichier. Par exemple:

TextConverter.exe -cl C:\dossier "a=REPLACE a b" save-folder=C:\nouveau

Avec cet appel, tous les fichiers du dossier "C:\dossier" sont convertis et le résultat est enregistré dans le dossier "C:\nouveau". Les fichiers d'origine de "C:\dossier" sont conservés et après la conversion, vous pouvez trouver tous les fichiers convertis dans le dossier "C:\nouveau". Étant donné que nous n'avons donné aucune instruction différente concernant le nom de fichier (par exemple via le paramètre "save-name"), les noms des fichiers d'origine sont adoptés.

Plusieurs dossiers peuvent également être traités en même temps:

TextConverter.exe -cl C:\dossier1 C:\dossier2 "a=REPLACE a b" save-folder=%%folder%%\nouveau

Avec cet exemple, nous traitons tous les fichiers des dossiers "C:\dossier1" et "C:\dossier2". Nous ne voulons pas mélanger les fichiers convertis, donc nous voulons les enregistrer dans 2 dossiers différents. Par conséquent, nous travaillons avec le paramètre "save-folder" et le variable %folder% qui représente l'ancien dossier (nous devons doubler le signe pour cent afin que le système d'exploitation n'interpréte pas les variables dans son sens). Cet appel signifie donc que les fichiers convertis de "C:\dossier1" sont enregistrés dans "C:\dossier1\nouveau" et les fichiers convertis de "C:\dossier2" sont enregistrés dans "C:\dossier1\nouveau". Si nous omettons le paramètre "save-folder" dans cet exemple, tous les fichiers d'origine dans les deux dossiers seraient écrasés par les fichiers convertis.

Bien sûr, nous pouvons également passer des fichiers et des dossiers mélangés ensemble:

TextConverter.exe -cl C:\test.txt C:\dossier "a=REPLACE a b"

D'une part, cet appel convertit le fichier individuel "C:\test.txt" et d'autre part tous les fichiers du dossier "C:\dossier".

Dans nos exemples précédents, nous avons toujours traité tous les fichiers des dossiers passés. Cependant, nous pouvons également utiliser des filtres pour modifier uniquement les fichiers stockés dans les dossiers passés qui correspondent au filtre passé:

TextConverter.exe -cl C:\dossier "a=REPLACE a b" filter-ext=txt
TextConverter.exe -cl C:\dossier "a=REPLACE a b" filter-ext=htm/html

Ces deux exemples montrent le filtre "filter-ext" pour l'extension de fichier. Avec la première ligne, nous ne traitons que les fichiers avec l'extension de fichier "txt" du dossier "C:\dossier". Plusieurs terminaisons de fichiers peuvent être séparées par une barre oblique: Avec la deuxième ligne, nous modifions tous les fichiers qui ont l'extension de fichier "htm" ou "html".

TextConverter.exe -cl C:\dossier "a=REPLACE a b" filter-name=[a-f]
TextConverter.exe -cl C:\dossier "a=REPLACE a b" filter-name=[a-f] filter-name-regex=1
TextConverter.exe -cl C:\dossier "a=REPLACE a b" filter-name=a/b/c filter-ext=txt

Ces 3 exemples montrent le filtre "filter-name" pour le nom du fichier. Avec la première ligne, nous traitons tous les fichiers qui contiennent la chaîne "[a-f]" dans leur nom. Ainsi, par exemple "[a-f].txt" ou "ab[a-f]cd.txt". Dans la deuxième ligne, nous utilisons des expressions régulières. Avec le paramètre "filter-name-regex=1", nous disons au TextConverter que "filter-name" doit être interprété comme une expression régulière (si nous omettons "filter-name-regex", il n'est pas interprété comme un régulier expression par défaut). Donc, cette fois, nous ne recherchons pas des fichiers contenant la chaîne "[a-f]", mais des fichiers qui contiennent l'une des lettres de "a" à "f". Ainsi, par exemple "a.txt", "xb.txt" ou "abc.txt" mais pas de fichiers tels que "gh.txt" ou "p.txt". Le troisième exemple combine "filter-name" avec "filter-ext" et démontre que nous pouvons définir plusieurs recherches indépendantes avec une barre oblique. Nous souhaitons uniquement modifier les fichiers contenant la lettre "a", "b" ou "c" dans leur nom de fichier et ayant une extension de fichier "txt". Par exemple, "a.txt", "abc.txt" mais pas "d.txt", "a.dat" ou "b.dat".

Des autres filtres sont "filter-name-matchcase" (sensibilité à la casse: devrait l'écriture en majuscules et en minuscules être prise en compte lors du filtrage?), "filter-name-matchall" (le nom complet du fichier doit-il correspondre au terme de recherche ?), "filter-hiddenfiles" (devrait également les fichiers invisibles être inclus?) ou "filter-onlytextfiles" (devrait seulement être traité des fichiers texte?). Des explications supplémentaires des filtres peuvent être trouvées dans la liste de tous les paramètres disponibles.

En plus des filtres pour le nom de fichier et l'extension de fichier, la gestion des sous-dossiers peut également être contrôlée via des paramètres. Pour cela, les paramètres "search-subdirs" et "keep-subdirs" sont disponibles.

Avec le paramètre "search-subdirs", nous pouvons déterminer quels fichiers à partir d'un dossier doivent être traités: seuls les fichiers qui sont stockés directement dans le dossier (sans considérer les sous-dossiers), ou également les fichiers stockés sous le dossier dans sous-dossiers (considérant les sous-dossiers). Nous avons 3 options:

TextConverter.exe -cl C:\dossier "a=REPLACE a b" search-subdirs=0
TextConverter.exe -cl C:\dossier "a=REPLACE a b" search-subdirs=1
TextConverter.exe -cl C:\dossier "a=REPLACE a b"

Dans chacun de ces exemples, les fichiers du dossier "C:\dossier" doivent être traités. Dans la première ligne, nous indiquons avec "search-subdirs=0" qu'aucun fichier ne doit être traité qui est stocké dans un sous-dossier de "C:\dossier". Ainsi, seuls les fichiers situés directement dans "C:\dossier" sont traités, par exemple "C:\dossier\test.txt" mais pas des fichiers tels que "C:\dossier\dossier\test.txt" ou "C:\dossier\1\2\3\test.txt". L'effet de la deuxième ligne est différent. Avec "search-subdirs=1", nous indiquons explicitement que tous les fichiers des sous-dossiers doivent également être traités. Avec cet appel, toutes les 3 fichiers "C:\dossier\test.txt", "C:\dossier\dossier\test.txt" et "C:\dossier\1\2\3\test.txt" serait converti. Dans la troisième ligne, nous laissons de côté le paramètre "search-subdirs". Dans ce cas, la valeur par défaut "1" est utilisée pour "search-subdirs". Donc, si nous omettons le paramètre, encore une fois, tous les fichiers directement à partir du dossier ainsi que tous les fichiers des sous-dossiers seront traités. Par conséquent, les lignes 2 et 3 conduisent au même résultat.

Avec le paramètre "keep-subdirs", nous pouvons réguler si la structure des sous-dossiers doit être conservée ou non. "keep-subdirs" peut avoir les valeurs 0 ou 1:

TextConverter.exe -cl C:\dossier "a=REPLACE a b" save-folder=C:\new search-subdirs=1 keep-subdirs=0
TextConverter.exe -cl C:\dossier "a=REPLACE a b" save-folder=C:\new search-subdirs=1 keep-subdirs=1

Dans ces deux exemples, nous aimerions convertir les fichiers du dossier "C:\dossier" et enregistrer le résultat dans le nouveau dossier "C:\nouveau". Dans les deux lignes, nous indiquons avec "search-subdirs=1" que nous aimerions traiter non seulement les fichiers directement stockés dans le dossier mais aussi tous les fichiers des sous-répertoires. Cependant, une fois nous écrivons "keep-subdirs=0" et une fois nous utilisons "keep-subdirs=1". Dans la première ligne avec "keep-subdirs=0", nous signalons à TextConverter que les sous-dossiers ne doivent pas être conservés. Ainsi, tous les fichiers convertis sont stockés directement dans le dossier "C:\nouveau", que les fichiers soient situés directement dans "C:\dossier" ou dans un sous-dossier. La situation est différente dans la deuxième ligne avec "keep-subdirs=1". Ici, nous disons au TextConverter que la structure du sous-dossier doit être maintenue. En conséquence, le fichier d'origine "C:\dossier\test1.txt" est enregistré dans "C:\nouveau\test1.txt" et le fichier d'origine "C:\dossier\dossier\test2.txt" dans "C:\nouveau\dossier\test2.txt". Avec "keep-subdirs=0", les fichiers seraient enregistrés sous "C:\nouveau\test1.txt" et "C:\nouveau\test2.txt". Si nous laissons de côté le paramètre "keep-subdirs", cela correspond à "keep-subdirs=0" et tous les fichiers seraient enregistrés directement dans le dossier de sortie sans sous-dossiers.

Affichage des Informations sur les Fichiers

En plus de la conversion et de l'édition des fichiers texte via contrôle du script, le TextConverter offre également la possibilité de sortir des propriétés des fichiers et d'autres informations sur les fichiers texte dans la ligne de commande ou un script. Entre autres choses, il est possible d'émettre des informations générales sur les fichiers telles que la taille du fichier ou des informations spécifiques aux fichiers texte telles que le codage, le type de saut de ligne ou le nombre de mots, de lignes ou de caractères de fichiers texte.

Dans le tutoriel sur la sortie des informations de fichiers et des propriétés spécifiques aux fichiers de texte via la ligne de commande ou par script, vous trouverez des explications, des exemples d'appels et des tables des paramètres possibles concernant ce sujet.

Aperçu de tous les Paramètres disponibles

La table suivante répertorie tous les paramètres disponibles que vous pouvez utiliser dans le mode lot du TextConverter. Vous pouvez trouver le nom du paramètre dans le colonne "Paramètre". Dans la colonne "Valeurs", toutes les valeurs que le paramètre respectif peut prendre sont répertoriées. Si le TextConverter est appelé sans spécifier un paramètre spécifique, sa valeur de la colonne "Défaut" est utilisée. La plupart des paramètres peuvent également être trouvés dans les exemples de ce tutoriel.

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. Plus d'informations et d'exemples dans la section sur la conversion des fichiers.
[Dossiers]tout chemin(s) de dossier- Chemin à 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. Plus d'informations et d'exemples dans la section sur la conversion du contenu du dossier.
[Fichiers TCS] fichiers de paramètres avec l'extension de fichier *.tcs- Chemin vers un fichier de paramètres avec l'extension de fichier TCS (Text Converter Settings) qui peut contenir tous les paramètres du TextConverter tels que des actions ou des options de stockage. Les fichiers de configuration 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 configuration peuvent être trouvés dans la section sur l'application des fichiers de configuration.
a, a1, a2, a3,...une seule action-Avec les paramètres a, a1, a2, a3 et ainsi de suite, une seule action peut être passé à TextConverter, que le TextConverter appliquera ensuite. La syntaxe est a=action, donc par exemple "a=REPLACE a b" ou "a1=DELETE x". Si vous voulez seulement passer une action en tant que paramètre, vous pouvez utiliser "a". Si vous souhaitez transmettre plusieurs actions en tant que paramètres, vous pouvez utiliser "a1" pour la première action, "a2" pour la deuxième action, "a3" pour la troisième action et ainsi de suite. Cependant, vous n'êtes pas lié à une numérotation correcte. Ainsi, vous pouvez également commencer par "a7" et sauter "a1" à "a6". Des exemples d'application et plus d'informations sur ce paramètre peuvent être trouvés dans la section sur l'utilisation des actions individuelles.
al, al1, al2, al3,... chemin de fichier vers une liste d'actions stockée dans un fichier texte -Avec les paramètres al, al1, al2, al3 et ainsi de suite, le chemin à une liste d'actions peut être passé au TextConverter, que le TextConverter appliquera alors. La syntaxe est al=chemin, donc par exemple "al=C:\liste-d-actions.tcal" ou "al1=C:\actions.txt". Le fichier passé peut être n'importe quel fichier texte qui contient une action par ligne. L'extension de fichier typique des listes d'actions pour le TextConverter est TCAL (Text Converter Action List). Cependant, les fichiers passés peuvent également avoir toute autre extension de fichier tel que TXT. Si vous souhaitez passer une seule liste d'actions en tant que paramètre, vous pouvez utiliser "al". Si vous souhaitez transmettre plusieurs listes d'actions en tant que paramètres, vous pouvez utiliser "al1" pour la première liste d'actions, "al2" pour la deuxième liste d'actions, "al3" pour la troisième liste d'actions, etc. Vous n'êtes pas lié à une numérotation correcte. Ainsi, vous pouvez également commencer par "al7" et omettre "al1" à "al6". Des exemples d'application, un exemple de une liste d'actions et plus d'informations sur ce paramètre peuvent être trouvés dans la section sur l'application des listes d'actions. Dans cette section, vous découvrirez également comment vous pouvez créer des listes d'actions directement avec le TextConverter via l'interface utilisateur graphique.
ph1 ou 0-Active (ph=1) ou désactive (ph=0) les espaces réservés (placeholders). Plus d'informations sur le fond et l'utilisation de ce paramètre dans cette section.
ref1 ou 0-Active (ref=1) ou désactive (ref=0) les références. Plus d'informations sur le fond et l'utilisation de ce paramètre dans cette section.
save chemin 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é. Plus d'informations sur ce paramètre et des exemples de son utilisation peuvent être trouvés dans la section sur les paramètres de stockage.
save-folderkeep ou tout textekeepDossier 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. Plus d'informations sur ce paramètre et des exemples de son utilisation peuvent être trouvés dans la section sur les paramètres de stockage.
save-namekeep ou tout textekeepNom 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é. Plus d'informations sur ce paramètre et des exemples de son utilisation peuvent être trouvés dans la section sur les paramètres de stockage.
save-extkeep ou tout textekeepExtension 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é. Plus d'informations sur ce paramètre et des exemples de son utilisation peuvent être trouvés dans la section sur les paramètres de stockage.
enckeep, ascii, latin1, latin2, win-ansi, win-1250, win-1251, win-1252, win-1253, cp437, utf7, utf8, utf16le, utf16be, utf32le ou utf32bekeep

Encodage pour le fichier converti. Avec "keep", le codage du fichier d'origine est utilisé pour stocker le fichier converti, sinon le codage spécifié est utilisé pour le stockage. 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. Plus d'informations sur ce paramètre et des exemples de son utilisation peuvent être trouvés dans la section sur les paramètres de l'encodage.

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. Plus d'informations sur ce paramètre et des exemples de son utilisation peuvent être trouvés dans la section sur les paramètres de l'encodage.
bom0, 1 ou keepkeepUne 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. Plus d'informations sur ce paramètre et des exemples de son utilisation peuvent être trouvés dans la section sur les paramètres de l'encodage.
lbkeep, system, crlf, lf, cr, nl, rnl, lf_ebcdic, eol, gs, rs, us, ff, nel, ls, ps, vt, tab, nochar, customstr-x, customcp-xkeep Type 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 TextConverter 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 rupture de ligne d'un fichier. Avec customstr- et customcp-, les caractères personnalisés peuvent être définis comme des caractères de pause de ligne via texte ou points de code (le x représente le texte ou le point de code défini par l'utilisateur). Une explication et des exemples pour l'utilisation et l'application de sauts de ligne personnalisées peuvent être trouvés ici et ici (le dernier lien fait référence au TextEncoder, mais peut également être utilisé pour le TextConverter). Vous pouvez trouver plus d'informations sur ce paramètre et des exemples de son utilisation dans l'aperçu des différents types de saut de ligne qui peuvent être utilisés avec le TextConverter, ainsi que dans la section sur les paramètres pour le 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-xauto Saut 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 TextConverter 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 et ici. Avec customstr- et customcp-, les caractères personnalisés pour une pause 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 et ici. Si vous avez des fichiers avec des types de pauses de ligne mixtes, vous pouvez utiliser customstrs- et customcps-. Cela vous permet de définir plusieurs pauses 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 et ici. Vous pouvez trouver plus d'informations sur ce paramètre et des exemples de son utilisation dans l'aperçu des différents types de saut de ligne qui peuvent être utilisés avec le TextConverter, ainsi que dans la section sur les paramètres pour le saut de ligne. Certaines des pages d'explications et d'exemples liées ici conduisent au tutoriel sur le contrôle du script du TextEncoder. Les exemples et explications illustrés lá s'appliquent également au TextConverter.
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.
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" en leur nom 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.
search-subdirs0 ou 11 Les fichiers des sous-dossiers devraient-ils être modifiés lors de la modification d'un dossier? 0 pour non, 1 pour oui. Avec la valeur 0, seuls les fichiers stockés directement dans le dossier sont traités. Avec la valeur 1, les fichiers stockés directement dans le dossier ainsi que tous les fichiers stockés dans un sous-dossier sous le dossier sont traités. Des exemples et d'autres explications de ce paramètre peuvent être trouvés dans la section "Convertir des Fichiers des Dossiers".
keep-subdirs0 ou 10 Ce 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. Des exemples et d'autres explications de ce paramètre peuvent être trouvés dans la section "Convertir des Fichiers des Dossiers".
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 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.

En principe, tous les paramètres répertoriés peuvent être combinés et utilisés ensemble dans un seul appel du TextConverter. Vous pouvez découvrir quel rôle l'ordre des paramètres joue et comment les différents paramètres interagissent - en particulier dans le cas, si les paramètres individuels se contredisent - dans la section sur l'utilisation combinée des actions, des listes d'actions, des fichiers de configuration et des paramètres. Si le TextConverter est appelé sans définir un certain paramètre, la valeur de la colonne "Défaut" est utilisée pour ce paramètre. Si la valeur "-" est spécifiée comme valeur par défaut d'un paramètre, cela signifie que le paramètre en question est vide par défaut.

Contrôle de Script de l’ancienne Version du Programme

L'ancienne version du programme du TextConverter ne connaissait pas encore aucune action ou listes d'actions. Il y avait également de nombreux paramètres d'aujourd'hui tels que les paramètres du codage et du type de saut de ligne utilisés pour la lecture et la sauvegarde ainsi que les paramètres des options de stockage non disponibles. Au lieu de cela, presque tous les paramètres ont dû être passés via des fichiers de configuration avec l'extension de fichier TKG à l'époque.

Si vous souhaitez découvrir les anciennes possibilités ou si vous toujours utilisez l'ancienne version du TextConverter, vous trouverez ici l'introduction de la fonctionnalité par lots de l'ancien TextConverter Pro CL.