Con la finalidad de señalar con pulcritud detalles del código web en partes específicas, manejaremos comentarios en documentos HTML. En ocasiones, al intentar optimizar códigos de páginas web de cualquier autor, pasamos horas determinando los motivos por los cuales se usó uno u otro procedimiento. Lo anterior conlleva a la pérdida de un bien invaluable: el tiempo. Por este motivo, identificaremos la forma de agregar comentarios a códigos fuentes de páginas web.

Al momento de construir documentos HTML, es necesario tener como resultado final un código legible, así cualquier programador lo entenderá con facilidad. Uno de los principales beneficios otorgados al mantener una organización en la creación de páginas web, es facilitar la adición de mejoras al código, la inserción de nuevos aplicativos o la eliminación de algunas opciones.

Los comentarios, agregados al documento HTML, son ignorados por el navegador web, por lo tanto, continúa y lee otra línea de código con instrucciones. Para agregar un comentario, se utiliza una etiqueta elaborada de la siguiente forma: se inicia con el signo de menor o llave angular izquierda, luego el de exclamación y, seguidamente, dos signos menos. Para el cierre son dos signos de menos y luego el de mayor o llave angular derecha.

061-01_0304_ilu01. Creación de la etiqueta commentary

En el próximo ejemplo vemos cómo está agregada la etiqueta de comentario, identificada por el color verde, en el editor de texto notepad++. Al ejecutar ese código en el navegador web, observamos cómo la línea de comentario solo se muestra en el código fuente del documento.

061-01_0304_ilu02. Ejecución de la etiqueta commentary

Debido al detalle minucioso de un procedimiento, cuando se necesita una etiqueta de comentario con una información extensa, podemos utilizar saltos de línea sin afectar la etiqueta, a fin de hacer uso del espacio requerido como se muestra en la ilustración.

061-01_0304_cap01. Comentario largo en documento HTML

Independientemente de la fecha de creación del documento, esta opción brinda la posibilidad de editar un código HTML de otro programador o propio,  desaparecer varias líneas de código, sin eliminarlas en su totalidad, debido a la posible utilidad en un futuro de esa información. Por tal motivo, es preferible eliminar líneas de código de esta forma, descartando la opción de borrar por completo información de un documento HTML.

Es necesario tener mucha precaución cuando agregamos etiquetas de comentarios para eliminar códigos fuentes, debido a la posibilidad de cometer el error de abarcar etiquetas de inicio o cierre, donde su correspondiente par se encuentra fuera del texto delimitado por la etiqueta de comentario. En algunos casos. esta etiqueta de comentario largo es utilizada para agregar una firma personal al final del documento HTML, o para crear logos de la empresa desarrolladora de la página web.

061-01_0304_cap02. Ejemplo de firma en etiqueta de comentario

Keynotes

• Al momento de construir documentos HTML, es necesario tener como resultado final un código legible, así cualquier programador lo entenderá con facilidad.
• Uno de los principales beneficios otorgados al manterner una organización en la creación de páginas web, es facilitar la adición de mejoras al código, la inserción de nuevos aplicativos o la eliminación de algunas opciones.
• Los comentarios, agregados al documento HTML, son ignorados por el navegador web, por lo tanto, continúa y lee otra línea de código con instrucciones.
• Debido al detalle minucioso de un procedimiento, cuando se necesita una etiqueta de comentario con una información extensa, podemos utilizar saltos de línea sin afectar la etiqueta, a fin de hacer uso del espacio requerido.
• Es necesario tener mucha precaución cuando agregamos etiquetas de comentarios para eliminar códigos fuentes, debido a la posibilidad de cometer el error de abarcar etiquetas de inicio o cierre, donde su correspondiente par se encuentra fuera del texto delimitado por la etiqueta de comentario.

Sañala con pulcritud 5 explicaciones en diferentes partes de tu documento llamado proyecto01. Los comentarios deben agregarse siguiendo las reglas aprendidas. Además, verifica la recomendación oficial de este lenguaje a fin de cumplir con las indicaciones especificadas. Previamente debate con tus compañeros sobre tu explicación.

¡Comparte el resultado del reto en tu vPages!

Tiempo disponible: entre 15 y 30 minutos.

Con el manejo de comentarios en documentos HTML, optimizamos el tiempo cuando sea necesario determinar los motivos por los cuales se usó uno u otro procedimiento en una página web, a fin de describir correctamente el código. Señalamos con pulcritud detalles del código web en partes específicas, para continuar en el futuro con la idea del proyecto. Con organización y precisión identificaremos correctamente líneas de códigos con lenguaje HTML.