Función convertir_txt_to_html()
Etiquetas definidas en g_file_etiquetas [TAG,s 1]
¿Cómo realiza la conversión? [_procesar_archivo]
Script : txt_to_html_4_0.sh
Versión: 4.01
Fecha : 12 diciembre de 2025
Convierte los archivos de texto que se encuentran en una carpeta dada y sus
subdirectorios en archivos html y genera una página inicial con un índice
de los archivos convertidos.
En las sucesivas llamadas sólo se tratarán los archivos que hayan sido modi-
ficados desde la última vez (ver apartado actualización de archivos)
Los parámetros que se le han de pasar a la función convertir_txt_to_html()
son los siguientes:
[$1] Path donde se encuentran los archivos de texto (*.txt) a convertir
Sin crontrabarra final.
[$2] Path donde se crearán los arhivos html sin crontrabara final.
[$3] Archivo que se cargará como cabecera del archivo html que se genera
[$4] Nombre del archivo html que contendrá el índice de documentos genera-
do
[$5] Título del archivo html que contendrá el índice de documentos genera-
do
[$6] Archivo CSS que se debe aplicar, si no se proporcina el archivo que
se cargará como cabecera, deberá contiener la hoja de estilo (css).
[PENDIENTE DE IMPLEMENTAR]
En los texto de los archivos txt no deben emplearse los siguientes símbolos:
< en su lugar usar: <
> en su lugar usar: >
Las etiquetas personalizadas son etiquetas con un formato similar a las de
html, estarán compuesta por letra, simbolos o números peros sin espaciosn
en blanco. Estas etiquetas serán sustituidas por etiquetado html, atendien-
do al momento y forma en el que se produce esta sustitución se definen dos
tipos:
Etiquetas definidas en g_file_etiquetas, su tratamiento se puede se-
guir con la marca [TAG,s 1]
Etiquetas tratadas en [TAG,s 2], son las siguientes:
<lista-o> <lo> Inicio de lista ordenada
<lista-u> <lu> Inicio de lista no ordenada
</lista-o> </lo> Fin de lista ordenada
</lista-u> </lu> Fin de lista no ordenada
Todas las de este tipo deben emplearse en una línea, no pueden combinar-
se en la misma línea con otro texto.
Se puede definir códigos de estilo que afecten a un conjunto de líneas
a sólo a una parte de ella.
Los códigos que afectan a un conjunto de líneas se transforman en
etiquetas <div> y deben abrirse y cerrarse en una línea indepen-
diente al inicio y final:
Por ejemplo:
El texto:
<code>
texto codigo
texto codigo
</code>
Se transforma en:
<div class='codigo'>
<p>linea de texto 1</p>
<p>linea de texto 2</p>
</div>
En la hoja de estilo hay que incluir:
.div.codigo p{
margin-bottom: -10px;
color: #e01b24;
font-style: oblique;
Los códigos que afectan a parte de una línea, como por ejemplo el
color, deben abrirse y cerrarse en la misma línea.
Por ejemplo:
El texto:
Es <rojo>necerario </rojo> y hay que <rojo>prestar atención</rojo> ...
Se transforma en:
<p>Es <span class='rojo'> necerario </span> y hay que <span class='rojo'> prestar atención </span> ...</p>
En la hoja de estilo hay que incluir:
.rojo {
font-weight: bold;
Convierte los archivos de texto en archivos html con las siguentes reglas:
La primera línea no vacía se toma com título <h1>
Las línea en blanco se convierten en <br>
Las lineas precedidas por una línea conteniendo exclusivamente los si-
guientes símbolos y espacios en blanco se le aplicará la etiqueta que
se indica:
/////////////// => h2
============== => h3
-------------- => h4
.............. => h5
Las lineas cuyo primer caracter es "<" y el último es ">"
Puede tratarse de una etiqueta personalizada que se debe tratar especi-
ficamente en este momento [TAG,s -2], este tipo de etiquetas personali-
zadas no estarán definidas en g_file_etiquetas. Si no es una de las
etiquetas personalizadas la línea se pasa tal cual sin hacer ningún ti-
po de tratamiento.
El resto se etiquetan con <p>
En las sucesivas llamadas sólo se tratarán los archivos/directorios que hayan
sido modificados desde la última vez.
En el caso de añadir o eliminar uno o más archivos, se generará una nueva pá-
gina de todos los archivos y la página de índice.
Al finalizar la ejecución se genera un archivo [file.md5sum] en el directo-
rio [l_origen] en el que se encuentran los archivos txt conteniendo el Md5 de
cada uno de ellos.
En la siguiente ejecución este archivo servirá para determinar los archivos
modificados y proceder a tratarlos.
En el caso de no encontrase el archivo [.file.md5sum] con el Md5 de los archi-
vos del directorio, se actualizarán todos.