Actualizado el 14-01-2007
versión para imprimir
Formato de código en html-kit
HTML-kit nos ofrece diversas alternativas para configurar el formato de las etiquetas (Editar|preferencias|format).
Si queremos que el código que inserte nuestro plugin sea formateado segun estas preferencias, debemos especificarlo así al escribir el plugin; veamos primero las posibilidades de formato del editor
- Etiquetas, atributos, valores, entidades, eventos, propiedades
- valor por defecto
- mayusculas: <IMG ALT="bluehalf" SRC="/images/bluehalf.gif" HEIGHT="14" WIDTH="8" />
- minusculas: <img alt="bluehalf" src="/images/bluehalf.gif" height="14" width="8" />
- colores
- por su nombre: white
- en Hex 3: #fff
- en Hex 6: #ffffff
- en RGB: rgb(255,255,255)
- en RGB (porcentaje): rgb(100%,100%,100%)
- por defecto
- signo =
- '='
- ' ='
- '= '
- ' = '
- nueva linea opcional
- valor por defecto
- incluida
- excluida
- nuevo espacio opcional
- valor por defecto
- incluida
- excluida
- comillas
- dobles
- sencillas
- no incluir comillas opcionales
- etiquetas vacias (como br)
- valor por defecto
- sin espacio adicional <input/>
- con espacio adicional <input />
- no incluir token de elemento vacio <input>
- texto que aparece en alt=""
- valor por defecto
- nombre de archivo
- nombre y tamaño de archivo
- vacio
Con estas opciones podemos configurar el código resultante para que aparezca a nuestro gusto. Elegir, por ejemplo, entre <img src = "" alt = "" /> O <IMG SRC="" ALT="">
Sin embargo el código que insertemos a traves de un plugin no seguirá estas preferencias, salvo que lo hayamos especificado asi al crearlo. Para ello necesitamos dos cosas. En primer lugar incluir un modo especial en nuestro plugin (en la funcion hkp_Main) y despues indicar como debe formatear cada parte de nuestro código.
La instrucción a utilizar es
hkp_DataAddInt ( pDataOut, "MODE_PREPROCESS_FORMAT_TAGS", 1 );
Si utilizamos el plugin generator, esta orden se genera automáticamente, desde el momento en que formateamos nuestro código.
hkp_DataAddInt ya nos indica que el valor que ha de pasar es un número entero (int) y como posiblemente sepas, 0 equivale a FALSE y 1 a TRUE, asi que esta instrucción lo que especifica es "procesado de formato de etiquetas = TRUE".
El gráfico de la derecha es el menu format del hkgen. También puedes acceder rápidamente a las opciones de formato desde los iconos de la parte superior derecha del menu. Las instrucciones de formato van precedidas del carácter ^ seguido de una letra:
- ^N texto normal, el texto que siga no será formateado.
- ^T tag: el texto que siga (hasta la siguiente instrucción) será formateado siguiendo los criterios previstos para las etiquetas. <^Tbody^N></^Tbody^N>
- ^A Atributo. <^Tinput^N ^Atype^N
- ^V Valor del atributo. Ejemplo en el elemento siguiente
- ^U Igual (=)
- ^Q Comillas <^Timg^N ^Aalt^N^U^Q^Q ^Aheight^N^U^Q^Q
- ^q Comillas opcionales
- ^E Entidad html ^E&^N
- ^S Evento <^Ta^N ^Sonclick^N^U^Q
- ^P Propiedad
- ^C Color
- ^c Color extendido (RGB)
- ^Z Token de elemento vacio ^Z> (/>)
- ^z Token de elemento vacio (si no está especificado omitirlo en preferencias
- ^o espacio en blanco opcional
- ^l linea en blanco opcional
Como últimas notas añadir que si generas un plugin automáticamente desde un archivo html o xml (File | Insert tags from HTML/XML File ...) el plugins generator directamente las pre-formateará.
Y si no usas el HKgen, hay un plugin que te permite insertar estos códigos si creas tus plugins con html-Kit: avwHKSFormat Tags