TextConverter

Control de Script del TextConverter

Todas las acciones y funciones para el procesamiento y la conversión de archivos de texto que se pueden usar a través de la interfaz gráfica de usuario del TextConverter también se pueden controlar a través de la línea de comando. Con esto, es posible controlar el TextConverter a través de scripts y automatizar tareas de conversión de texto.

En este tutorial, le mostramos cómo puede controlar el TextConverter a través de los parámetros y qué parámetros están disponibles para convertir archivos y el contenido de las carpetas. Además, también puede echar un vistazo al tutorial sobre el control del script del TextEncoder para el TextConverter. El tutorial de TextEncoder coloca un mayor enfoque en leer y cambiar el tipo de codificación y el tipo de salto de línea de los archivos de texto, mientras que este tutorial se centra más en las acciones para cambiar el contenido de los archivos. Todos los parámetros presentados en el tutorial de TextEncoder también se pueden utilizar con el TextConverter. Para las funciones presentadas en este tutorial, necesita el TextConverter en la versión TextConverter Pro CL.

El tutorial se divide en las siguientes secciones:

Conceptos Básicos Generales del Control de Script del TextConverter

Para poner el TextConverter en modo por lotes, usamos el parámetro -cl. Este parámetro siempre se pasa como primer parámetro en todos los siguientes ejemplos. Si no pasamos este parámetro, el TextConverter comenzará con la interfaz gráfica de usuario y no habrá una conversión automática de los archivos que se pasan. En cambio, los archivos que se pasan como parámetros se mostrarán en la lista de archivos después del inicio del programa. De la misma manera, se comporta con las carpetas pasadas, qué contenido se cargará en la lista de archivos del TextConverter. Por supuesto, esta función también puede ser útil si desea iniciar el TextConverter con ciertos archivos.

Básicamente, tenemos 3 formas diferentes de decir al TextConverter qué conversiones deben llevarse a cabo: podemos pasar acciones individuales como parámetros, podemos pasar listas de acciones en forma de archivos que pueden contener múltiples acciones o podemos pasar archivos de configuración que además a las acciones también pueden contener otras configuraciones, como configuraciones de almacenamiento, por ejemplo. Además, hay algunos parámetros disponibles para las opciones de almacenamiento, la codificación, el tipo de salto de línea y para buscar archivos en las carpetas pasadas.

Echemos un vistazo a algunos ejemplos simples antes de entrar en detalles en las siguientes secciones. El ejemplo más simple es dejar que el TextConverter ejecute una sola acción. Podemos pasar acciones con el parámetro "a=acción":

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

Esto reemplaza las letras "a" por "b" en el archivo "test.txt". Si queremos aplicar múltiples acciones, podemos pasarlas con la ayuda de los parámetros a1, a2, a3 y así sucesivamente en una fila:

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

Esto elimina todas las ocurrencias de "a" y "b" en el archivo "test.txt". Puede obtener más información sobre eso en la sección sobre la aplicación de acciones individuales.

Si desea aplicar múltiples acciones, no necesariamente tiene que escribirlas en una fila. En cambio, también puede resumir varias acciones en una lista de acciones (archivo de texto con una acción por línea) y solo pasar esta lista de acciones:

TextConverter.exe -cl C:\test.txt al=C:\lista-de-acciones.tcal

Se pueden pasar múltiples listas de acciones con los parámetros al1, al2, al3 y así sucesivamente y luego son procesados a su vez por TextConverter. Puede obtener más información sobre las listas de acciones en la sección sobre la aplicación de listas de acciones.

La tercera forma es pasar archivos de configuración. Los archivos de configuración son los archivos en los que el TextConverter almacena su configuración. Estos archivos siempre tienen la extensión de archivo TCS (Text Converter Settings) y se pueden pasar de la siguiente manera:

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

Esto convierte el archivo "test.txt" de acuerdo con la configuración que se almacena en el archivo de configuración "configuracion.tcs". Puede obtener más información sobre la creación y el uso de archivos de configuración en la sección sobre el uso de archivos de configuración.

En todos nuestros ejemplos anteriores, no hemos influido la ubicación de almacenamiento del archivo convertido (a menos que haya configuraciones correspondientes en el archivo de configuración). Si no hay una declaración sobre una ubicación de almacenamiento diferente, el archivo original se sobrescribe. Si queremos guardar el archivo editado en una ubicación que no sea la del archivo original, hay algunos parámetros disponibles, por ejemplo:

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

Ambas líneas cambian la escritura del texto en el archivo "test.txt". La primera línea convierte todas las letras del archivo en letras minúsculas y almacena el resultado como un nuevo archivo en el archivo C:\lowercase.txt. En la segunda línea, en lugar de una ruta de archivo completa, solo se especifica una carpeta para el almacenamiento. Esto significa que se conserva el nombre del archivo original y el resultado (todas las letras en mayúsculas) en este caso se guarda como un nuevo archivo en C:\uppercase\test.txt. Puede obtener más información sobre las opciones de almacenamiento en la sección sobre los parámetros para el almacenamiento.

Además de los parámetros para el almacenamiento, también hay algunos parámetros disponibles para la codificación y el tipo de salto de línea utilizado para leer y guardar los archivos. Puede ver un ejemplo aquí:

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

En este ejemplo, editamos el archivo "test.txt" nuevamente. Esta vez intercambiamos la primera y la segunda línea del texto en el archivo y guardamos el resultado en el archivo C:\swapped.txt con la codificación UTF-8 y el tipo de salto de línea CRLF (Windows). Además, con "bom=0" indicamos que no se debe escribir ninguna marca de orden de bytes (Byte Order Mark) en el archivo. Si omitimos los parámetros para la codificación y el tipo de salto de línea, se intenta determinar la codificación y el tipo de salto de línea del archivo original automáticamente para usarlos nuevamente para el almacenamiento. Puede obtener más información sobre este tema en la sección sobre los parámetros para la codificación y el tipo de salto de línea. Allí también puede averiguar cómo puede forzar al TextConverter a leer archivos con un cierto tipo de salto de línea o un cierto tipo de codificación. Además, encontrará una lista de todos los códigos y tipos de salto de línea compatibles con el TextConverter en la descripción general de los formatos compatibles del TextConverter.

Por supuesto, todos los parámetros presentados hasta ahora también se pueden combinar entre ellos. En qué orden se procesan y ejecutan los parámetros y acciones, especialmente si hay varias configuraciones en competencia, se pueden encontrar en la sección sobre el uso combinado de acciones, listas de acciones, archivos de configuración y parámetros.

Hasta ahora, solo hemos trabajado en un archivo al mismo tiempo. Sin embargo, también es posible editar varios archivos a la vez. Por ejemplo, entregando múltiples archivos o una carpeta completa:

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

Con la primera línea eliminamos todos los atributos de los archivos XML "test1.xml" y "test2.xml". La segunda línea procesa todos los archivos CSV en la carpeta "C:\carpeta" y agrega el valor 1 en cada celda de la tabla CSV. Puede obtener más información sobre este tema y otras opciones de filtro para carpetas en las secciones sobre el procesamiento de archivos individuales o múltiples y el procesamiento del contenido de las carpetas.

Aplicar Acciones individuales

Si solo desea realizar uno o unos pocos cambios en los archivos, puede pasar acciones individuales directamente a través de parámetros sin tener que crear una lista de acciones o un archivo de configuración. Puede ver un ejemplo de esto aquí:

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

Con esta llamada reemplazamos la letra "a" con "b" en el archivo "test.txt". Primero colocamos el TextConverter en el modo por lotes con el parámetro "-cl". Luego entregamos el archivo que queremos editar. Con el parámetro "a" podemos definir una acción (en este caso "REPLACE a b"), que el TextConverter luego ejecuta.

Si queremos que el TextConverter aplique varias acciones, podemos usar a1, a2, a3 y así sucesivamente. Aquí hay un ejemplo:

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

Con esta llamada editamos todos los archivos de la carpeta "C:\carpeta". Primero eliminamos todos los espacios dobles, luego eliminamos las primeras cinco líneas de cada archivo. Múltiples acciones siempre se llevan a cabo en el orden de los parámetros. Incluso si escribe "a2" frente a "a1", el primer parámetro (aquí "a2") siempre se lleva a cabo primero.

Si no sabe qué acciones están disponibles y cómo se ve la sintaxis de las acciones, puede iniciar el TextConverter y crear sus acciones deseadas utilizando "Listas de Acciones > Nueva Acción" a través de la interfaz gráfica de usuario. Si cambia de la vista de lista a la vista de texto en la lista de acciones, verá la sintaxis y puede copiar y usar sus acciones directamente. Para obtener más información, consulte la introducción del uso de listas de acciones en el TextConverter.

Aplicar Listas de Acciones

Las listas de acciones son archivos de texto que pueden contener una o más acciones. Esto significa que las listas de acciones ofrecen la oportunidad de resumir varias acciones y usarlas en una agrupación. Dentro de una lista de acciones, cada acción está escrita en una nueva línea. Así por ejemplo:

REPLACE Hola "Buen Día"
DELETE_IN_LINES 10-20 [0-9] -r
SORT_LINES 4-7 DOWN
WRITE UPPERCASE_WORDS

Esta lista de acciones inicialmente reemplaza "Hola" con "Buen Día". Luego, todos los números de las líneas 10 a 20 se eliminan utilizando expresiones regulares (-r), luego las líneas 4 a 7 se clasifican en orden descendente y finalmente la primera letra de todas las palabras de todo el texto está capitalizada.

Si guardamos este texto, respectivamente, esta lista de acciones, por ejemplo, dentro el nombre del archivo "C:\lista-de-acciones.tcal" (la extensión de archivo TCAL significa "Text Converter Action List"), podemos usarla de la siguiente manera:

TextConverter.exe -cl C:\test.txt al=C:\lista-de-acciones.tcal

Primero, colocamos el TextConverter en el modo por lotes utilizando el parámetro "-cl". Pasamos el archivo "test.txt" y usamos el parámetro "al=" para entregar nuestra lista de acciones. Esto significa que el TextConverter aplicará todas las acciones de nuestra lista de acciones "lista-de-acciones.tcal" al archivo "test.txt". Dado que no hemos dado ninguna instrucción sobre una ubicación de almacenamiento diferente, el archivo original "test.txt" se sobrescribirá con el archivo cambiado.

Varias listas de acciones también se pueden pasar y aplicar al mismo tiempo dentro de una llamada:

TextConverter.exe -cl C:\test.txt al1=C:\lista-de-acciones1.tcal al2=C:\lista-de-acciones2.tcal

Con los parámetros al1, al2, al3 y así sucesivamente se pueden pasar varios archivos con listas de acciones en una fila. Independientemente de si está utilizando al1, al2, al o al10 como el primer parámetro, el TextConverter siempre procesará primero la primera lista de acciones pasada. Cuando se termine esta lista de acciones, la próxima lista de acciones pasada se procesará y así sucesivamente.

Si no desea crear sus listas de acciones manualmente, también puede usar la interfaz gráfica de usuario del TextConverter para hacerlo. En todas las áreas que se denominan "Listas de Acciones" encontrará el botón "Nueva Lista de Acciones". Si hace clic en este botón, llegará a un editor con el que puede crear convenientemente acciones y agregarlas a su lista de acciones. Puede copiar y guardar el resultado del editor manualmente o puede dejar la administración y el almacenamiento de las listas de acciones al TextConverter. Las listas de acciones almacenadas por TextConverter se pueden encontrar en la carpeta "actionlists" ubicadas en la carpeta del programa.

Aplicar Archivos de Configuración

Además de pasar acciones individuales o listas de acciones como parámetros, los archivos de configuración también se pueden usar para la conversión de archivos a través del control de script. Los archivos de configuración siempre tienen la extensión de archivo TCS (Text Converter Settings) y pueden contener todas las configuraciones del TextConverter. Por lo tanto, no solo pueden contener acciones individuales como las listas de acciones, sino también, por ejemplo, las opciones de almacenamiento. Puede obtener más información sobre los archivos de configuración en el artículo sobre la carga y el guardado de la configuración.

Los archivos de configuración se pueden crear convenientemente a través de la interfaz gráfica de usuario del TextConverter. Primero, simplemente establezca todas las acciones, opciones y configuraciones de almacenamiento en el TextConverter como si quisiera convertir archivos a través de la interfaz gráfica de usuario. Luego vaya al menú "Configuración > Guardar y Cargar Configuración" y haga clic en el botón "Guardar como Archivo". Recibirá un archivo que contiene todas las configuraciones actuales del TextConverter. Puede pasar este archivo directamente al TextConverter:

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

En este ejemplo, el archivo "test.txt" se convierte de acuerdo con las configuraciones que ha guardado en el archivo "configuracion.tcs". Estas pueden ser acciones, así como opciones de almacenamiento o conversiones de la codificación o el tipo de salto de línea utilizado en el archivo.

Si entrega múltiples archivos de configuración como parámetros, se cargan a su vez y siempre sobrescriben la configuración ya cargada de los otros archivos de configuración. Si mezcla configuraciones, listas de acciones u otros parámetros en los parámetros, los archivos de configuración siempre se cargan primero y, si es necesario, están sobrescriben por los parámetros (más sobre esto aquí).

Si guarda archivos de configuración con el TextConverter, estos archivos contienen mucha más información de la que necesitamos para nuestro control de script. Por ejemplo, los archivos de configuración también pueden contener información sobre el tamaño de la ventana, la posición de la ventana o las columnas de su lista de archivos. El TextConverter utiliza esta información al cargar la interfaz gráfica de usuario. Si el TextConverter se inicia en modo por lotes, esta información no necesaria simplemente se ignora. Por lo tanto, no es necesario "limpiar" los archivos de configuración manualmente, en cambio, simplemente se pueden usar como los guardan por el TextConverter.

Sin embargo, puede haber situaciones en las que tiene sentido adaptar los archivos de configuración manualmente. Puede abrir y editar los archivos de configuración con cualquier editor de texto. Por ejemplo, para crear un archivo de configuración que contenga solo ciertas acciones o solo las opciones de almacenamiento. Luego puede combinar estos archivos de configuración "parciales" como un parámetro con otros archivos de configuración o parámetros, que pueden ser en ciertas situaciones más efectivas que crear su propio archivo de configuración para cada combinación de configuración.

Parámetros para la Ubicación de Almacenamiento y el Nombre del Archivo

Si no decimos explícitamente al TextConverter donde y en qué nombre se deben guardar los archivos convertidos, el archivo original se sobrescribe de forma predeterminada. Un ejemplo de esto sería la siguiente llamada:

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

Con esta llamada, el TextConverter primero leerá el archivo "C:\test.txt", luego moverá la primera línea del archivo al final del archivo y luego guardará el resultado en "C:\test.txt". En otras palabras, esto sobrescribirá el archivo original porque no hemos especificado una ubicación diferente.

En el caso de que no queramos sobrescribir el archivo original, los parámetros save, save-folder, save-name y save-ext están disponibles. A continuación, observamos ejemplos de cada uno de estos parámetros.

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

Con el parámetro "save", se puede especificar una ruta completa para el almacenamiento. En este ejemplo, el archivo "C:\test.txt" se lee primero, luego la letra "a" se reemplaza por "b" y luego el resultado se guarda en el archivo "C:\carpeta\nuevo.dat" . Se conserva el archivo original.

El mismo resultado también se puede lograr con el uso de los parámetros save-folder, save-name y save-ext:

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

El resultado de esta llamada es idéntico al ejemplo anterior. Nuevamente, el resultado de la conversión se guarda en el archivo "C:\carpeta\nuevo.dat". Mientras "save" espera una ruta completa, podemos usar los 3 parámetros save-folder, save-name y save-ext para establecer todos los componentes de la ruta individualmente. El uso de los 3 parámetros individuales es particularmente útil si no queremos establecer cada uno de estos parámetros. Por ejemplo:

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

En este ejemplo, solo establecemos el parámetro "save-folder". Dado que el TextConverter siempre usa el nombre anterior como valor predeterminado, esta llamada lleva a la situación de que el nombre y la extensión del archivo se toman del archivo original. Por lo tanto, el archivo convertido se guarda bajo el nombre "C:\nuevo\test.txt". Este parámetro puede ser particularmente útil si queremos convertir varios archivos o todos los archivos de una carpeta y queremos guardar los resultados en una nueva carpeta.

TextConverter.exe -cl C:\test.txt "a=REPLACE a b" save-name=nuevo
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:\nuevo save-ext=dat

Análogos al último ejemplo son los resultados de estas 3 llamadas. La primera línea solo cambia el nombre del archivo, por lo que se guarda como "C:\nuevo.txt" manteniendo la carpeta y la extensión del archivo. La segunda línea conduce al archivo "C:\test.dat" y en la tercera línea cambiamos la carpeta y la extensión del archivo mientras el nombre se toma por el archivo original, por lo que el resultado es "C:\nuevo\test.dat ".

Además del uso de estos parámetros, hay otra forma de influir la ubicación y el nombre del archivo convertido. Esto es usar archivos de configuración. Sin embargo, el principio es el mismo, ya que los parámetros mencionados aquí también se incluyen dentro de los archivos de configuración. La única diferencia es que los parámetros no tienen que especificarse individualmente, pero solo la ruta al archivo de configuración relevante debe pasar como un parámetro. Puede averiguar cómo puede crear y usar archivos de configuración en la sección sobre los archivos de configuración.

Parámetros para la Codificación y el Tipo de Salto de Línea

Hay otros parámetros disponibles para controlar la codificación y el tipo de salto de línea utilizado para leer y escribir los archivos. Para la lectura, estos son los parámetros lb-read (Line Break Read) y enc-read (Encoding Read), para la escritura podemos usar los parámetros lb (Line Break), enc (Encoding) y bom (Byte Order Mark, Marca de Orden de Bytes). Si no le damos instrucciones al TextConverter, el TextConverter intenta detectar automáticamente el tipo de salto de línea y la codificación del archivo original durante la lectura, y al escribir, se adopta la codificación y el tipo de salto de línea determinado del archivo original.

Echemos un vistazo a tres ejemplos que ilustran esto.

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

Esta llamada cambia la codificación del archivo "test.txt" a UTF-16 Little Endian (utf16le), independientemente de la codificación que el archivo tenía antes. El aditivo "bom=1" asegura que una Marca de Orden de Bytes (Byte Order Mark) se escriba en el archivo. Dado que no tenemos parámetros especificados para el tipo de salto de línea ni para una ubicación para el nuevo archivo, se toma el tipo de salto de línea del archivo original y se sobrescribe el archivo original. Dado que no hemos especificado en que codificación el archivo original debe leerse, se intenta determinar automáticamente la codificación para la lectura.

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

En esta llamada, afirmamos que el archivo original tiene el Windows CodePage 1251 (Cirílico) y el TextConverter debe interpretar los bytes del archivo original en el sentido de esta página de código. Esto es importante para esta codificación, especialmente si está utilizando el TextConverter en un sistema de Windows con un lenguaje diferente, ya que las páginas de códigos ANSI no pueden distinguirse debido a los bytes y son una cuestión de interpretación. Una vez que se lee el archivo, el TextConverter cambia la codificación del archivo a UTF-8 sin marca de orden de bytes y usa el tipo de salto de línea CR LF (Windows), independientemente de qué tipo de salto de línea se usó en el archivo original. El archivo convertido se guarda en "C:\nuevo.txt", se mantiene el archivo original.

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

En los dos primeros ejemplos, solo hemos cambiado la codificación y el tipo de salto de línea del archivo original sin cambiar el contenido del archivo. En esta llamada también realizamos una acción que cambia el contenido del archivo: nos gustaría insertar la palabra "test" en la posición de caracteres 10 en el archivo. Además, solo queremos cambiar el tipo de salto de línea de una longitud de línea fija de 20 caracteres al salto de línea del sistema. Se debe conservar la codificación del archivo original. El tipo de salto de línea del sistema corresponde al salto de línea estándar del sistema en el que se ejecuta actualmente el TextConverter (por ejemplo, CR LF en los sistemas de Windows).

Los parámetros para las acciones, las listas de acciones o los archivos de configuración se pueden escribir en cada posición dentro de la fila de parámetros. En nuestro ejemplo, primero hemos definido la acción, luego "lb-read" y luego "lb". Sin embargo, también podríamos usar cualquier otro orden para obtener el mismo resultado.

Puede ver qué valores puede usar para las diferentes codificaciones y tipos de salto de línea en la descripción general de todos los parámetros disponibles. Puede encontrar más ejemplos en el tutorial para el TextEncoder. Todos los parámetros y valores de parámetros para el TextEncoder explicados allí también se pueden usar con el TextConverter. En particular, las secciones sobre caracteres personalizados para saltos de línea, saltos de línea en múltiples caracteres y la conversión de archivos con una longitud de línea fija va más allá de los ejemplos explicados aquí.

Al igual que los parámetros para la ubicación de almacenamiento y el nombre del archivo, también los parámetros para la codificación y el tipo de salto de línea se pueden entregar alternativamente mediante los archivos de configuración. El procedimiento es el siguiente: la codificación y el tipo de salto de línea se pueden configurar a través de la interfaz gráfica de usuario del TextConverter, estas configuraciones se guardan como un archivo de configuración y este archivo de configuración se pasa al TextConverter en lugar de especificar los parámetros individuales. Para que funcione, las acciones "Codificación" y/o "Tipo de Salto de Línea" deben estar activas. Por lo tanto, no es suficiente cambiar los valores en "Leer como" y "Guardar como" en la interfaz gráfica de usuario, los ganchos también deben estar configurados para "Codificación" y/o "Tipo de Salto de Línea". Si este no es el caso, el valor predeterminado "auto" se usa para leer y el valor predeterminado "keep" se usa para escribir. Si pasa un archivo de configuración, que contiene instrucciones para la codificación y/o el tipo de salto de línea, y también pasa parámetros como "enc" o "lb", los parámetros sobrescribirán los valores del archivo de configuración. Puede obtener más información sobre la creación y el uso de archivos de configuración en la sección sobre los archivos de configuración.

Parámetros para la Fecha del Archivo

Al convertir archivos con el TextConverter, podemos sobrescribir los archivos originales con los archivos convertidos o guardar los archivos convertidos como archivos nuevos especificando una ubicación de almacenamiento o un nombre diferente que el archivo original.

Si el resultado de la conversión se guarda como un archivo completamente nuevo, este archivo lleva automáticamente la marca de tiempo en la que se realizó la conversión después de que se haya guardado. Esto afecta tanto a la fecha de creación como a la fecha de última modificación del archivo. Si, en cambio, sobrescribimos el archivo original, la fecha de creación original seguirá siendo la misma, pero la fecha de modificación del archivo cambiará a la hora de la conversión.

Si no desea este cambio automático de las fechas de archivo, podemos pasar el parámetro "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:\nouveau.txt date=keep

El parámetro "date=keep" tiene el efecto de que se adopta la fecha del archivo original para el archivo convertido. Esto afecta tanto a la fecha de creación como a la fecha de modificación y la fecha del último acceso y se puede utilizar tanto para sobrescribir como para guardar los archivos convertidos como archivos nuevos, como muestra el ejemplo.

Este parámetro corresponde a la opción "Mantener la fecha del archivo original" de las opciones de almacenamiento de la interfaz gráfica de usuario del TextConverter. En consecuencia, esta opción también se puede utilizar pasando archivos de configuración que contienen la configuración adecuada.

Parámetros para activar Marcadores de Posición y Referencias

De forma predeterminada, el reemplazo de marcadores de posición y referencias está deshabilitado en el TextConverter. Si desea utilizar los marcadores de posición o las referencias al controlar el TextConverter a través de un script, debe activar las opciones correspondientes. De lo contrario, los marcadores de posición en cuestión no se reemplazarán. Tiene varias oportunidades para hacerlo.

Si usa archivos de configuración, puede habilitar una o ambas opciones a través de la interfaz gráfica de usuario del TextConverter antes de guardar su archivo de configuración. Puede encontrar ambas opciones en la sección "Acciones > Opciones".

Si no usa archivos de configuración, por ejemplo porque trabaja con acciones individuales o listas de acciones, o si desea sobrescribir los ajustes de los archivos de configuración pasados, puede usar los parámetros "ph" y "ref" para controlar el uso de los marcadores de posición y las referencias. Con "ph=1" puede activar los marcadores de posición, con "ref=1" puede activar las referencias. Si usa un "0" en lugar de un "1", las opciones correspondientes se desactivarán.

Un ejemplo del uso del parámetro "ref" es la siguiente llamada del TextConverter, que establece el contenido del campo A1 (1:1) en el contenido del campo B2 (2:2) en el archivo CSV "C:\data.csv" con la ayuda de una referencia:

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

Usamos la acción "REPLACE_CELLS Campo NuevoContenido". Para que la referencia de celda contenida %ref:cell=1:1% se interprete como tal, le pasamos el parámetro "ref=1". Al llamar a esta llamada de script en Windows, también tenemos que duplicar el carácter "%" para que se reconozca como tal.

Un ejemplo del uso del parámetro "ph" es la siguiente llamada del TextConverter, que reemplaza una fecha arbitraria en el archivo "C:\test.txt" con la fecha actual:

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

Para esto, usamos la función REPLACE (REPLACE Buscar Reemplazar -Parámetros), que se pasa como una sola acción aquí. Esta acción busca cualquier fecha en el formato "número-número-número" con la ayuda de la expresión regular "[0-9]+-[0-9]+-[0-9]+" (-r) y lo reemplaza con el marcador de posición de fecha "%date%", que representa la fecha actual. De nuevo, doblamos el carácter "%" para que se reconozca como tal. Como último parámetro, pasamos "ph=1" y así nos aseguramos de que el marcador de posición también se interprete como tal.

Incluso si solo se activó una de las dos opciones en cada uno de los dos ejemplos, por supuesto, también puede pasar ambos parámetros al mismo tiempo dentro de una llamada y, en consecuencia, usarlos independientemente uno del otro.

En los parámetros para la ubicación de almacenamiento y el nombre de archivo "save", "save-folder", "save-name" así como "save-ext", los marcadores de posición siempre se reemplazan. En consecuencia, la activación de la opción para los marcadores de posición solo es necesaria si utiliza marcadores de posición dentro de sus acciones. No se requiere una activación para usar marcadores de posición en los nombres de archivo.

Aplicación combinada de Acciones, Listas de Acciones, Archivos de Configuración y Parámetros

Acciones individuales, archivos con listas de acciones, archivos de configuración y todos los demás parámetros, como los parámetros para la ubicación de almacenamiento, la codificación o el tipo de salto de línea también se pueden pasar combinados al TextConverter. En este contexto, surge la pregunta, qué interacción pueden desarrollar los diferentes parámetros y en qué orden el TextConverter procesa las configuraciones y las acciones individuales. Esta pregunta es particularmente importante en caso de que las configuraciones individuales complementen o incluso se contradicen.

En general, el TextConverter procesa los parámetros pasados en el siguiente orden:

Echemos un vistazo a algunos ejemplos de la aplicación combinada de acciones, listas de acciones, archivos de configuración y parámetros que ilustran la prioridad y el orden de la aplicación:

TextConverter.exe -cl C:\test.txt a2="DELETE a" al=C:\lista-de-acciones.tcal a1="DELETE b"

En este ejemplo, la acción a2 se aplica primero, después de eso, la lista de acciones se ejecuta y luego se aplica la acción a1. Por lo tanto, el TextConverter sigue estrictamente el orden de los parámetros, independientemente de si se pasan acciones individuales o listas de acciones e independientemente del número de parámetros que entregue las acciones y las listas de acciones.

TextConverter.exe -cl C:\test.txt a="DELETE a" C:\configuracion.tcs al=C:\lista-de-acciones.tcal

En este ejemplo, se agrega un archivo de configuración a las acciones y listas de acciones. Los archivos de configuración siempre se procesan primero, independientemente de qué posición se definan en los parámetros. Entonces, primero se aplica el archivo de configuración, luego la acción única y finalmente la lista de acciones.

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

En este ejemplo, nuevamente, el archivo de configuración se carga primero. Los parámetros save-folder y save-ext luego sobrescriben posibles opciones de almacenamiento del archivo de configuración. Independientemente de qué opciones de almacenamiento se definan en el archivo de configuración, se guarda en la carpeta "C:\nuevo" con la extensión del archivo "dat". Dado que no hemos especificado un parámetro para el nombre del archivo, esta configuración no se sobrescribe y el nombre que está configurado en el archivo de configuración se utilizará para el almacenamiento (si no hay una configuración para el nombre en el archivo de configuración, el nombre del archivo original se utilizará). En este caso, el orden de los parámetros no importa, obtendremos el mismo resultado, independientemente de en qué orden organizamos los parámetros dados.

Convertir Archivos individuales y múltiples

Para procesar un solo archivo con el TextConverter a través de la línea de comandos, simplemente puede pasar la ruta al archivo, como ya hemos visto en muchos otros ejemplos en este tutorial:

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

Con esta llamada reemplazamos la letra "a" con "b" en el archivo "test.txt". En este caso, el archivo original se sobrescribe, ya que no damos instrucciones diferentes para el almacenamiento.

Si no queremos sobrescribir el archivo original, podemos especificar una ruta diferente para el almacenamiento a través del parámetro "save":

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

Con esta llamada, el archivo original "C:\test.txt" permanece y guardamos nuestro resultado en el archivo "C:\nuevo.txt".

Si desea procesar múltiples archivos al mismo tiempo del mismo modo, no es necesario llamar al TextConverter por varias veces. También puede simplemente entregar varias rutas de archivo seguidas:

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

Con esta llamada reemplazamos la letra "a" con "b" en los archivos "test1.txt", "test2.txt" y "test3.txt". También en este ejemplo, los 3 archivos originales se sobrescriben. Si desea mantener los archivos originales, simplemente puede especificar una ubicación diferente o un nombre diferente para los nuevos archivos a través de los parámetros save-folder, save-name y save-ext (especificando una ruta de archivo único para el almacenamiento a través del parámetro "save", no tiene sentido en este momento, ya que tenemos más de un archivo). Así por ejemplo:

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

Con esta llamada editamos los archivos "C:\test1.txt" y "C:\test2.txt" y guardamos el resultado en la carpeta "C:\nuevo". Dado que solo especificamos una nueva carpeta y no hacemos una declaración sobre el nombre del archivo, se toma el nombre del archivo original. Por lo tanto, el resultado de nuestra conversión se guarda en los archivos "C:\nuevo\test1.txt" y "C:\nuevo\test2.txt". Por supuesto, también podemos cambiar el nombre o la extensión del archivo para el nuevo archivo. Por ejemplo:

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

En este ejemplo, solo mantenemos la carpeta de los archivos originales. Por otro lado, cambiamos el nombre y la extensión del archivo a través de los parámetros "save-name" y "save-ext". Como nuevo nombre, nos gustaría adjuntar la fecha actual al nombre anterior. Para esto, utilizamos los marcadores de posición %name% para el nombre anterior y %date% para la fecha actual (tenemos que duplicar el signo de porcentaje para que el sistema operativo no interprete las variables en su sentido). Como una nueva extensión de archivo, nos gustaría usar la extensión de archivo "dat". Puede obtener más información sobre este tema en la sección sobre los parámetros de almacenamiento.

Si desea convertir múltiples archivos, no necesariamente tiene que especificar la ruta para cada archivo individual. En cambio, también puede pasar una o más carpetas para convertir su contenido. En la siguiente sección, descubrirá cómo funciona esto y cómo puede usar filtros para no convertir todos los archivos almacenados en las carpetas entregadas.

Convertir Archivos de las Carpetas

Si desea procesar muchos archivos, puede ser laborioso pasar cada archivo individualmente al TextConverter. En este caso, también puede trabajar con carpetas. Para convertir todos los archivos de una carpeta, simplemente podemos pasar la ruta a la carpeta relevante. La sintaxis es la misma que ya hemos visto al pasar archivos:

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

Con esta llamada, todos los archivos que se almacenan en la carpeta "C:\carpeta" se convierten (la letra "a" se reemplaza en los archivos por la letra "b"). Como no hemos especificado una ubicación de almacenamiento diferente, los archivos originales se sobrescriben en la carpeta. Si nos gustaría mantener los archivos originales, podemos usar los parámetros para el almacenamiento para influir en la ubicación y el nuevo nombre de archivo. Por ejemplo:

TextConverter.exe -cl C:\carpeta "a=REPLACE a b" save-folder=C:\nuevo

Con esta llamada, todos los archivos de la carpeta "C:\carpeta" se convierten y el resultado se guarda en la carpeta "C:\nuevo". Los archivos originales de "C:\carpeta" se conservan y después de la conversión, puede encontrar todos los archivos convertidos en la carpeta "C:\nuevo". Dado que no hemos dado ninguna instrucción diferente con respecto al nombre del archivo (por ejemplo, a través del parámetro "save-name"), se adoptan los nombres de los archivos originales.

También se pueden procesar múltiples carpetas al mismo tiempo:

TextConverter.exe -cl C:\carpeta1 C:\carpeta2 "a=REPLACE a b" save-folder=%%folder%%\nuevo

Con este ejemplo, procesamos todos los archivos de las carpetas "C:\carpeta1" y "C:\carpeta2". No queremos mezclar los archivos convertidos, por lo que queremos guardarlos en 2 carpetas diferentes. Por lo tanto, trabajamos con el parámetro "save-folder" y la variable %folder% que representa la carpeta anterior (tenemos que duplicar el signo de porcentaje para que el sistema operativo no interprete las variables en su sentido). Esta llamada significa que los archivos convertidos de "C:\carpeta1" se guardan en "C:\carpeta1\nuevo" y los archivos convertidos de "C:\carpeta2" se guardan en "C:\carpeta2\nuevo". Si omitamos el parámetro "save-folder" en este ejemplo, todos los archivos originales en ambas carpetas serían sobrescritos por los archivos convertidos.

Por supuesto, también podemos pasar los archivos y las carpetas mezclados juntos:

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

Por un lado, esta llamada convierte el archivo individual "C:\test.txt" y por otro lado todos los archivos de la carpeta "C:\carpeta".

En nuestros ejemplos anteriores, siempre hemos procesado todos los archivos de las carpetas pasadas. Sin embargo, también podemos usar filtros para editar solo los archivos almacenados en las carpetas pasadas que coinciden con el filtro pasado:

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

Estos dos ejemplos muestran el filtro "filter-ext" para la extensión del archivo. Con la primera línea solo procesamos los archivos con la extensión del archivo "txt" de la carpeta "C:\carpeta". Varias terminaciones de archivos se pueden separar con una barra: Con la segunda línea editamos todos los archivos que tienen la extensión del archivo "htm" o "html".

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

Estos 3 ejemplos muestran el filtro "filter-name" para el nombre del archivo. Con la primera línea procesamos todos los archivos que contienen la cadena "[a-f]" en su nombre. Entonces, por ejemplo, "[a-f].txt" o "ab[a-f]cd.txt". En la segunda línea usamos expresiones regulares. Con el parámetro "filter-name-regex=1", le decimos al TextConverter que "filter-name" debe interpretarse como una expresión regular (si omitimos "filter-name-regex", no se interpreta como un regular expresión por defecto). Entonces, esta vez no estamos buscando archivos que contengan la cadena "[a-f]", sino estamos buscando para archivos que contienen una de las letras de "a" a "f". Entonces, por ejemplo, "a.txt", "xb.txt" o "abc.txt" pero no archivos como "gh.txt" o "p.txt". El tercer ejemplo combina "filter-name" con "filter-ext" y demuestra que podemos definir múltiples búsquedas independientes con una barra. Solo queremos editar archivos que contengan la letra "a", "b" o "c" en su nombre y tengan una extensión de archivo "txt". Por ejemplo, "a.txt", "abc.txt" pero no "d.txt", "a.dat" o "b.dat".

Otros filtros son "filter-name-matchcase" (sensibilidad de los casos: ¿debería tener en cuenta la escritura en mayúsculas y minúsculas al filtrarse?), "filter-name-matchall" (¿el nombre completo del archivo debe coincidir con el término de búsqueda?), "filter-hiddenfiles" (¿también deberían incluirse los archivos invisibles?) o "filter-onlytextfiles" (¿solo se deben procesar los archivos de texto?). Se pueden encontrar más explicaciones de los filtros en la lista de todos los parámetros disponibles.

Además de los filtros para el nombre del archivo y la extensión del archivo, también el manejo de subcarpetas se puede controlar mediante parámetros. Para eso, los parámetros "search-subdirs" y "keep-subdirs" están disponibles.

Con el parámetro "search-subdirs", podemos determinar qué archivos dentro de una carpeta deben procesarse: solo los archivos que se almacenan directamente en la carpeta (sin considerar las subcarpetas), o también los archivos que se almacenan debajo de la carpeta en subcarpetas (considerando las subcarpetas). Tenemos 3 opciones:

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

En cada uno de estos ejemplos, se deben procesar los archivos de la carpeta "C:\carpeta". En la primera línea declaramos con "search-subdirs=0" que no se deben procesar archivos que se almacenan en una subcarpeta de "C:\carpeta". Entonces, solo se procesan los archivos que se encuentran directamente en "C:\carpeta", por ejemplo "C:\carpeta\test.txt" pero no archivos como "C:\carpeta\carpeta\test.txt" o "C:\carpeta\1\2\3\test.txt". El efecto de la segunda línea es diferente. Con "search-subdirs=1", establecemos explícitamente que todos los archivos de las subcarpetas también deben procesarse. Con esta llamada, todos los 3 archivos "C:\carpeta\test.txt", "C:\carpeta\carpeta\test.txt" y "C:\carpeta\1\2\3\test.txt" se convertiría. En la tercera línea dejamos de lado el parámetro "search-subdirs". En este caso, el valor predeterminado "1" se usa para "search-subdirs". Entonces, si omitimos el parámetro, nuevamente, se procesarán todos los archivos directamente desde la carpeta, así como todos los archivos de las subcarpetas. Por lo tanto, las líneas 2 y 3 conducen al mismo resultado.

Con el parámetro "keep-subdirs", podemos regular si la estructura de las subcarpetas debe mantenerse o no. "keep-subdirs" puede tener los valores 0 o 1:

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

En estos dos ejemplos nos gustaría convertir los archivos de la carpeta "C:\carpeta" y guardar el resultado en la nueva carpeta "C:\nuevo". En ambas líneas declaramos con "search-subdirs=1" que nos gustaría procesar no solo los archivos almacenados directamente en la carpeta sino también todos los archivos de los subtirectorios. Sin embargo, una vez escribimos "keep-subdirs=0" y una vez usamos "keep-subdirs=1". En la primera línea con "keep-subdirs=0" señalamos al TextConverter que las subcarpetas no deben conservarse. Entonces, todos los archivos convertidos se almacenan directamente en la carpeta "C:\nuevo", independientemente de si los archivos se ubicaron directamente en "C:\carpeta" o en cualquier subcarpeta. La situación es diferente en la segunda línea con "keep-subdirs=1". Aquí le decimos al TextConverver que se debe mantener la estructura de la subcarpetas. En consecuencia, el archivo original "C:\carpeta\test1.txt" se guarda en "C:\nuevo\test1.txt" y el archivo original "C:\carpeta\carpeta\test2.txt" en "C:\nuevo\carpeta\test2.txt". Con "keep-subdirs=0", los archivos se guardarían en "C:\nuevo\test1.txt" y "C:\nuevo\test2.txt". Si dejamos de lado el parámetro "keep-subdirs", esto corresponde a "keep-subdirs=0" y todos los archivos se guardarían directamente en la carpeta de salida sin subcarpetas.

Mostrar Información sobre Archivos

Además de la conversión y la edición de los archivos de texto a través de script, el TextConverter también ofrece la opción de generar propiedades de los archivos y otra información sobre archivos de texto en la línea de comando o en un script. Entre otras cosas, es posible emitir informaciones generales de los archivos, como el tamaño del archivo o las informaciones específicas del archivos de texto, como la codificación, el tipo de salto de línea o el número de palabras, líneas o caracteres de los archivos de texto.

En el tutorial sobre la salida de las informaciones de archivos y las propiedades específicas de los archivos de texto a través de la línea de comando o por script, encontrará explicaciones, llamadas de ejemplo y tablas de los posibles parámetros con respecto a este tema.

Descripción General de todos los Parámetros disponibles

La siguiente tabla enumera todos los parámetros disponibles que puede usar en el modo por lotes del TextConverter. Puede encontrar el nombre del parámetro en la columna "Parámetro". En la columna "Valores", todos los valores que puede tomar el parámetro respectivo se enumeran. Si se llama al TextConverter sin especificar un parámetro específico, se utiliza su valor de la columna "Defecto". La mayoría de los parámetros también se pueden encontrar en los ejemplos dentro de este tutorial.

ParámetroValoresDefectoDescripción
[Archivos]cualquier ruta(s) de archivo- Ruta al archivo a convertir. Puede especificar varios archivos en secuencia para convertir varios archivos al mismo tiempo. Más información y ejemplos en la sección sobre la conversión de archivos.
[Carpetas]cualquier ruta(s) de carpeta- Ruta a una carpeta cuyos contenidos deben ser convertidos. Para evitar convertir todos los archivos de la carpeta, puede usar los parámetros search-subdirs, filter-ext, filter-name, filter-name-matchcase, filter-name-matchall, filter-name-regex, filter-hiddenfiles y filter-onlytextfiles para limitar su búsqueda. Se pueden especificar varias carpetas consecutivamente para convertir simultáneamente el contenido de varias carpetas. Más información y ejemplos en la sección sobre la conversión del contenido de la carpeta.
[Archivos TCS] archivos de configuración con la extensión del archivo *.tcs- Ruta a un archivo de configuración con la extensión de archivo TCS (Text Converter Settings) que puede contener todas las configuraciones del TextConverter, como acciones o opciones de almacenamiento. Los archivos de configuración se pueden combinar y sobrescribir con todos los demás parámetros. Se puede especificar varios archivos de configuración en una fila, que luego se cargan consecutivamente. Se puede encontrar más sobre el uso y la generación de archivos de configuración en la sección sobre la aplicación de archivos de configuración.
a, a1, a2, a3,... acción sola -Con los parámetros a, a1, a2, a3 y así sucesivamente, se puede pasar una sola acción al TextConverter, que el TextConverter aplicará. La sintaxis es a=acción, por lo que, por ejemplo, "a=REPLACE a b" o "a1=DELETE x". Si solo desea pasar una acción como parámetro, puede usar "a". Si desea pasar múltiples acciones como parámetros, puede usar "a1" para la primera acción, "a2" para la segunda acción, "a3" para la tercera acción, etc. Sin embargo, no está vinculado a una numeración correcta. Entonces, también puede comenzar con "a7" y omitir "a1" a "a6". Se pueden encontrar ejemplos de aplicaciones y más información sobre este parámetro en la sección sobre el uso de acciones individuales.
al, al1, al2, al3,...ruta de archivo a una lista de acciones almacenada en un archivo de texto- Con los parámetros al, al1, al2, al3 y así sucesivamente, la ruta a una lista de acciones se puede pasar al TextConverter, que el TextConverter luego aplicará. La sintaxis es al=ruta, por ejemplo, "al=C:\lista-de-acciones.tcal" o "al1=C:\acciones.txt". El archivo pasado puede ser cualquier archivo de texto que contenga una acción por línea. La extensión de archivo típica para las listas de acción para el TextConverter es TCAL (Text Converter Action List). Sin embargo, los archivos pasados también pueden tener cualquier otra extensión de archivo, como TXT. Si solo desea aprobar una lista de acciones como parámetro, puede usar "al". Si desea aprobar múltiples listas de accióones como parámetros, puede usar "al1" para la primera lista de acciones, "al2" para la segunda lista de acciones, "al3" para la tercera lista de acciones, etc. No está vinculado a una numeración correcta. Por lo tanto, también puede comenzar con "al7" y omitir "al1" a "al6". Se pueden encontrar ejemplos de aplicaciones, un ejemplo de una lista de acciones y más información sobre este parámetro en la sección sobre la aplicación de las listas de acciones. En esta sección, también descubrirá cómo puede crear listas de acciones directamente con el TextConverter a través de la interfaz gráfica de usuario.
ph1 o 0-Activa (ph=1) o desactiva (ph=0) los marcadores de posición (placeholders). Más sobre el trasfondo y el uso de este parámetro en esta sección.
ref1 o 0-Activa (ref=1) o desactiva (ref=0) las referencias. Más sobre el trasfondo y el uso de este parámetro en esta sección.
saveRuta de cualquier archivo- Con este parámetro puede guardar el archivo convertido explícitamente con un nombre de archivo que se puede seleccionar libremente. Por ejemplo, especifique save=C:\Carpeta\Archivo.txt para guardar el archivo convertido como C:\Carpeta\Archivo.txt. Si solo desea guardar el archivo convertido en una carpeta diferente manteniendo el nombre y la extensión del archivo, utilice el parámetro save-folder y omita el parámetro save. Además, los parámetros save-name para el nombre y save-ext para la extensión de archivo pueden usarse de la misma manera y combinarse entre sí. Si no especifica ninguno de los parámetros save, save-folder, save-name o save-ext, se sobrescribirá el archivo original. Se puede encontrar más información sobre este parámetro y ejemplos de su uso en la sección sobre los parámetros para el almacenamiento.
save-folderkeep o cualquier textokeepCarpeta en la que se guarda el archivo convertido. Si no especifica este parámetro o si llama a este parámetro con el valor "keep", el archivo se guarda en la carpeta en la que se encuentra el archivo original. Este parámetro se puede combinar con los parámetros save-name y save-ext. Cada uno de estos parámetros es opcional, lo que le permite definir de forma independiente la carpeta, el nombre y la extensión. Si desea guardar el archivo convertido con un nombre de archivo explícito con ruta, nombre y extensión, utilice el parámetro save. Si no especifica ninguno de los parámetros save, save-folder, save-name o save-ext, se sobrescribirá el archivo original. Con el parámetro keep-subdirs, puede controlar cómo lidiar con las subcarpetas dentro de la carpeta. Se puede encontrar más información sobre este parámetro y ejemplos de su uso en la sección sobre los parámetros para el almacenamiento.
save-namekeep o cualquier textokeepNombre sin carpeta y extensión de archivo, con el que se guarda el archivo convertido. Si no especifica este parámetro o si utiliza este parámetro con el valor "keep", el archivo recibe el mismo nombre que el archivo original. Este parámetro se puede combinar con los parámetros save-folder y save-ext. Cada uno de estos parámetros es opcional, lo que le permite definir de forma independiente la carpeta, el nombre y la extensión. Si desea guardar el archivo convertido con un nombre de archivo explícito con ruta, nombre y extensión, utilice el parámetro save. Si no especifica ninguno de los parámetros save, save-folder, save-name o save-ext, se sobrescribirá el archivo original. Se puede encontrar más información sobre este parámetro y ejemplos de su uso en la sección sobre los parámetros para el almacenamiento.
save-extkeep o cualquier textokeepExtensión de archivo con la que se guarda el archivo convertido. Si no especifica este parámetro o si usa este parámetro con el valor "keep", el archivo convertido recibe la extensión de archivo que también tenía el archivo original. Este parámetro se puede combinar con los parámetros save-folder y save-name. Cada uno de estos parámetros es opcional, lo que le permite definir de forma independiente la carpeta, el nombre y la extensión. Si desea guardar el archivo convertido con un nombre de archivo explícito con ruta, nombre y extensión, utilice el parámetro save. Si no especifica ninguno de los parámetros save, save-folder, save-name o save-ext, se sobrescribirá el archivo original. Se puede encontrar más información sobre este parámetro y ejemplos de su uso en la sección sobre los parámetros para el almacenamiento.
enckeep, ascii, latin1, latin2, win-ansi, win-1250, win-1251, win-1252, win-1253, cp437, utf7, utf8, utf16le, utf16be, utf32le o utf32bekeep

Codificación para el archivo convertido. Con "keep" la codificación del archivo original se utiliza para almacenar el archivo convertido, de lo contrario la codificación especificada se usa para el almacenamiento. La codificación "win-ansi" depende de la localización de su versión de Windows. Se utilizará la página de códigos de Windows que coincida con la versión de idioma de Windows. Una descripción general de todos los codificaciónes disponibles se puede encontrar aquí. Se puede encontrar más información sobre este parámetro y ejemplos de su uso en la sección sobre los parámetros para la codificación.

enc-readauto, ascii, latin1, latin2, win-ansi, win-1250, win-1251, win-1252, win-1253, cp437, utf7, utf8, utf16le, utf16be, utf32le o utf32beautoCodificación con la que se lee el archivo. Si este parámetro no se especifica, se intenta detectar automáticamente la codificación. La codificación "win-ansi" depende de la localización de su versión de Windows. Se utilizará la página de códigos de Windows que coincida con la versión de idioma de Windows. Se puede encontrar más información sobre este parámetro y ejemplos de su uso en la sección sobre los parámetros para la codificación.
bom0, 1 o keepkeep¿Debe escribirse una marca de orden de byte (byte order mark) en el archivo? 0 para nunca, 1 para siempre, "keep" para como en el archivo original. Se puede encontrar más información sobre este parámetro y ejemplos de su uso en la sección sobre los parámetros para la codificación.
lbkeep, system, crlf, lf, cr, nl, rnl, lf_ebcdic, eol, gs, rs, us, ff, nel, ls, ps, vt, tab, nochar, customstr-x, customcp-xkeep Tipo de salto de línea para el archivo convertido. "keep" conserva el tipo de salto de línea del archivo original, de lo contrario, el tipo especificado. El valor "system" corresponde al tipo de salto de línea estándar del sistema operativo en el que se está ejecutando el TextConverter actualmente. Así, por ejemplo, crlf para Windows. El constante nochar significa sin carácter. Puede usarlo para eliminar todos los caracteres de rotura de línea de un archivo. Con customstr- y customcp-, los caracteres personalizados pueden definirse como caracteres de rotura de línea a través de texto o puntos de código (la x significa el texto o punto de código definido por el usuario). Se puede encontrar una explicación y ejemplos para el uso y la aplicación de saltos de línea personalizados aquí y aquí (el último enlace se refiere al TextEncoder, pero también se puede usar para el TextConverter). Puede encontrar más información sobre este parámetro y ejemplos de su uso en la descripción general de los diversos tipos de salto de línea que se pueden usar con el TextConverter, así como en la sección sobre los parámetros para el salto de línea.
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 Salto de línea con el que se lee el archivo. Si este parámetro no se especifica o se especifica "auto", se intenta detectar automáticamente el salto de línea. El valor "system" corresponde al tipo de salto de línea estándar del sistema operativo en el que se está ejecutando el TextConverter actualmente. Así, por ejemplo, crlf para Windows. Con fixedlength-, se puede leer un texto con longitud de línea fija (por ejemplo, fixedlength-70 para 70 caracteres por línea). Aquí y aquí se puede encontrar una explicación y ejemplos. Con customstr- y customcp-, los caracteres personalizados para una rotura de línea se pueden definir a través de texto o punto de código para la lectura (la x significa el texto o punto de código definido por el usuario). Aquí y aquí se puede encontrar una explicación y ejemplos. Si tiene archivos con tipos de rupturas de línea mixta, puede usar customstrs- y customcps-. Esto le permite definir múltiples salidas de línea personalizadas separadas por comas a través de texto o puntos de código, por ejemplo, customcps-13,10. Aquí y aquí se puede encontrar una explicación y ejemplos de la solicitud. Puede encontrar más información sobre este parámetro y ejemplos de su uso en la descripción general de los diversos tipos de salto de línea que se pueden usar con el TextConverter, así como en la sección sobre los parámetros para el salto de línea. Algunas de las páginas para explicaciones y ejemplos vinculados aquí conducen al tutorial sobre el control del script del TextEncoder. Los ejemplos y explicaciones que se muestran allí también se aplican al TextConverter.
dateauto o keepautoCon date=keep, cada fecha del archivo original se usa para el archivo cambiado o recién almacenado. Si omite este parámetro o si usa date=auto, la fecha de cambio del archivo depende de la hora de procesamiento y la fecha de creación permanece en la primera hora de creación del archivo.
filter-extcualquier texto-Si solo desea editar archivos con una extensión específica, puede ingresar esta(s) extensión(es) aquí. Por ejemplo, filter-ext=txt para editar solo archivos con la extensión TXT. Las terminaciones múltiples se pueden separar con una barra. Por ejemplo, filter-ext=php/htm/html para editar solo archivos con las extensiones PHP, HTM o HTML. Si omite este parámetro o lo deja vacío, se considerarán los archivos con todas las extensiones de archivo.
filter-namecualquier texto- Si solo desea editar archivos con un nombre específico, puede ingresar un nombre aquí. Se procesan todos los archivos que contienen los caracteres especificados con "filter-name" en su nombre. Se pueden definir varios términos de búsqueda separados por una barra (por ejemplo, filter-name=abc/def para buscar todos los archivos cuyos nombres contengan "abc" o "def"). Con filter-name=ab, por ejemplo, archivos como abc.txt o xab.txt. Si omite este parámetro o lo deja vacío, se tendrán en cuenta los archivos con todos los nombres.
filter-name-matchcase0 o 10¿Debería interpretarse el texto o expresión regular especificado con el parámetro "filter-name" de acuerdo con su escritura en mayúsculas y minúsculas? 0 para no, 1 para si. Si es 1, el texto en el nombre del archivo debe ser el mismo en el mismo caso. Si es 0 se busca sin distinción de mayúsculas y minúsculas.
filter-name-matchall0 o 10¿El texto o la expresión regular especificada con el parámetro "filter-name" debe coincidir con el nombre completo del archivo? 0 para no, 1 para sí. Si es 1, el nombre completo del archivo debe corresponder completamente al término de búsqueda. Si es 0, es suficiente si el término de búsqueda solo aparece en algún lugar del nombre del archivo.
filter-name-regex0 o 10Si el filtro de búsqueda especificado con "filter-name" debe interpretarse como una expresión regular, utilizar 1. Si solo desea buscar el texto especificado, utilizar 0.
filter-hiddenfiles0 o 10¿Desea editar archivos ocultos al convertir una carpeta? Un valor de 0 deja todos los archivos ocultos sin tratar, un valor de 1 también maneja archivos ocultos.
filter-onlytextfiles0 o 11¿Desea editar solo archivos de texto al editar una carpeta? 0 para no, 1 para si. En caso 1, cada archivo se comprueba antes de convertirse para ver si es un archivo binario y, si es así, no se realiza el procesamiento.
search-subdirs0 o 11 ¿Deben editarse los archivos de las subcarpetas al editar una carpeta? 0 para no, 1 para sí. Con el valor 0, solo se procesan los archivos que se almacenan directamente en la carpeta. Con el valor 1, tanto los archivos que se almacenan directamente en la carpeta como todos los archivos que se almacenan en una subcarpeta debajo de la carpeta se procesan. Se pueden encontrar ejemplos y más explicaciones para este parámetro en la sección "Convertir Archivos de las Carpetas".
keep-subdirs0 o 10 Este parámetro controla si la estructura de las carpetas de una carpeta original debe mantenerse en una nueva carpeta o no. Ejemplo de uso: se pasa una carpeta, se debe convertir su contenido. Dentro de esta carpeta hay una o más subcarpetas con un número arbitrario de niveles. Además, los archivos deben almacenarse en una nueva u otra carpeta (definida a través de parámetro save-folder). Con keep-subdirs=1, los archivos se almacenan en la nueva carpeta en la misma estructura de carpetas, ya que se almacenaron dentro de la carpeta original. Con keep-subdirs=0, la estructura de las carpetas de la carpeta original se ignora y todos los archivos se almacenan directamente en la carpeta definida para el almacenamiento. Se pueden encontrar ejemplos y más explicaciones para este parámetro en la sección "Convertir Archivos de las Carpetas".
openfile0 o 10¿Debería abrirse el archivo convertido después de editarlo? openfile=1 abrirá el archivo recién creado.
delfile0 o 10¿Debería eliminarse el archivo original después de la conversión? delfile=1 borra el archivo original. Esta opción solo es útil si los archivos convertidos deben guardarse con un nombre diferente o en una ubicación diferente a la del archivo original y los archivos originales no se deben conservar.
info%enc%, %bom%, %encbom%, %lb%, %lines%, %chars%, %words%, marcadores de posición para el nombre del archivo y la carpeta, marcadores de posición para el tamaño del archivo, marcadores de posición para la fecha y texto arbitrario libremente combinable-Con el parámetro "info", puede obtener información sobre los archivos pasados y los archivos de las carpetas pasadas en la consola. Como valor, puede usar los marcadores de posición %enc% (codificación del archivo), %bom% (¿hay una marca de orden de bytes?), %encbom% (codificación y marca de orden de bytes), %lb% (tipo de salto de línea ), %lines% (número de líneas), %chars% (número de caracteres) asi como %words% (número de palabras) y cualquier texto arbitrario. Además, los marcadores de posición para el nombre del archivo, la carpeta, el tamaño del archivo y la fecha se pueden utilizar. Entonces, por ejemplo, "info=%enc%" para mostrar solo la codificación, "info=%encbom% %lb%" para mostrar codificación, marca de orden de bytes y tipo de salto de línea o "info=El archivo %filename% tiene %lines% líneas, %chars% caracteres y %words% palabras." para generar esta oración para un archivo. Se puede encontrar una explicación detallada y más ejemplos en el tutorial sobre la salida de las informaciones de los archivos a través del script.

En principio, todos los parámetros enumerados se pueden combinar y usar juntos dentro de una llamada del TextConverter. Puede averiguar qué papel juega el orden de los parámetros y cómo interactúan los diferentes parámetros - especialmente en el caso, si los parámetros individuales se contradicen entre sí - en la sección sobre el uso combinado de acciones, listas de acciones, archivos de configuración y parámetros. Si se llama al TextConverter sin definir un cierto parámetro, el valor de la columna "Defecto" se usa para este parámetro. Si el valor "-" se especifica como valor predeterminado de un parámetro, esto significa que el parámetro en cuestión está vacío de forma predeterminada.

Control de Script de la Versión anterior del Programa

La versión anterior del programa del TextConverter no conocía ninguna acción o lista de acciones. También hubo muchos de los parámetros de hoy, como los parámetros para la codificación y el tipo de salto de línea utilizado para leer y guardar, así como los parámetros para las opciones de almacenamiento no disponibles. En cambio, casi todas las configuraciones tuvieron que pasar a través de archivos de configuración con la extensión de archivo TKG en ese momento.

Si desea averiguar sobre las antiguas posibilidades o si todavía usa la versión anterior del TextConverter, encontrará la introducción de la funcionalidad por lotes del antiguo TextConverter Pro CL aquí.