¿Estás visitando desde Perú?
Ingresá a Linware Perú ⯈
Continuar en Linware Perú ⯈
×
¿Qué estás buscando?
BUSCAR!
BLOG
HTML en documentation.suse.com – ¡Déle forma!
Publicada el 09/06/2022

¿Ha visitado recientemente documentation.suse.com ? ¿Y desprotegió un documento HTML? Entonces habrás notado que algo ha cambiado.

¿La apariencia es diferente? ¡Absolutamente correcto! Recientemente, se presento el nuevo diseño basado en columnas. Las columnas HTML se utilizan para organizar el contenido de una manera muy organizada. Y al mismo tiempo, permiten mucha más flexibilidad sobre dónde va el contenido.

Diseño de tres columnas

Los manuales y guías ahora cuentan con un diseño de tres columnas. Encontrará la navegación principal del manual completo en la columna de la izquierda. Al hacer clic en la flecha en la esquina superior izquierda de esta columna, accederá a una navegación desde donde podrá acceder directamente a todos los diferentes manuales y guías para el producto respectivo. Esto proporciona una guía y orientación claras a lo largo de todo el documento.

La columna de la derecha alberga la navegación dentro del capítulo. Y los documentos más cortos, como inicios rápidos o artículos, vienen solo con una tabla de contenido de estructura plana a la derecha, para una navegación simple y rápida.

En la parte superior de las páginas de contenido HTML, encontrará una ruta de navegación. Esto facilita el cambio entre los manuales de un producto sin tener que volver a navegar a las páginas principales.

Opciones de comentarios

Una ventaja importante del diseño basado en columnas es que ofrece una estructura clara, gracias a la cual puede acceder rápidamente a herramientas adicionales, complementos o enlaces para visitar. Independientemente del tipo de documento que mire en la salida HTML, siempre encontrará opciones para proporcionar sus comentarios en la columna de la derecha:

  • Usando el enlace "Informar un problema", puede abrir Problemas de Bugzilla o GitHub para informar un error de documentación o solicitar cambios.
  • Usando el enlace "Editar documento fuente", puede acceder directamente a la fuente de documentación respectiva en GitHub para editar el contenido usted mismo y enviar una solicitud de extracción al equipo de documentación.
  • Además, con un simple clic en un botón, ahora puede compartir fácilmente la documentación que está leyendo actualmente en las redes sociales y puede imprimir las páginas respectivas.
  • También se está trabajando en un mecanismo de calificación para las páginas de documentación.

En este punto, se implementa el diseño basado en columnas para toda la documentación del producto. Las mejores prácticas y la documentación de referencia técnica de SUSE seguirán su ejemplo en unas pocas semanas. Tenga en cuenta que podríamos adaptar la implementación actual con el tiempo, de acuerdo con los requisitos futuros.

¡Y ahora es su turno! Envíe un correo electrónico a doc-team@suse.com.

Ir al Blog