Número de ficheros HTML
| Sigla | HTML |
| Aspecto | «Tamaño» |
| Se mide en | módulo, proyecto |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumHTMLFilesModule, NumHTMLFilesProject |
En pocas palabras
Cuenta los ficheros HTML de un módulo o de todo el proyecto. Sirve para saber cuánto del proyecto son páginas, plantillas o documentación en HTML y no código Java o Kotlin.
Qué mide
El peso del HTML en número de ficheros. En un proyecto Java el HTML suele ser plantillas de la capa web, páginas estáticas, documentación generada o recursos de test. Las métricas de código no lo ven, y una parte de la lógica de presentación vive ahí.
Cómo se calcula
Se cuenta 1 por cada fichero que el IDE reconoce como de tipo HTML dentro del ámbito analizado. No importan ni el tamaño ni el contenido; para eso están las «líneas de HTML».
Cómo interpretarla
No tiene valor bueno ni malo y no tiene umbrales. Compara:
- con el «número de ficheros» y el de «ficheros Java», para ver qué parte del módulo es presentación;
- entre módulos, para localizar los que son sobre todo recursos web;
- en el tiempo, para ver si crece la parte de plantillas.
El HTML generado (informes, documentación de la API) infla el recuento sin ser trabajo del equipo cuando queda dentro de lo analizado, por ejemplo en un directorio que no se ha marcado como excluido. Mira de dónde viene antes de sacar una conclusión.
Relación con otras métricas
- «Líneas de HTML» (
L(HTML)): el mismo censo medido en líneas. - «Número de ficheros» (
FILES): el total del que esta métrica es una parte. - «Número de ficheros XML» (
XML), «Java» (J) y «Kotlin» (KT): los otros recuentos por tecnología.
En las herramientas
Stau Metro (NumHTMLFilesModule, NumHTMLFilesProject). Cuenta los ficheros de tipo HTML del IDE, que por
defecto son los de extensión .html, .htm, .sht, .shtm y .shtml; los .xhtml son de otro tipo y no
cuentan. El criterio es el tipo de fichero y no el contenido: entre dos .xml, un .html, un .java y un fichero
de extensión desconocida, el valor es 1. Valen las reglas de «FILES» sobre qué ficheros recorre el
análisis.
Referencias
- IntelliJ Platform, registro de los tipos de fichero HTML (
htm;html;sht;shtm;shtml) y XHTML (xhtml), en el código fuente de la plataforma.