Los fragmentos en Document360 se crean y gestionan desde la página de fragmentos en herramientas de contenido. Desde esta página puedes crear nuevos fragmentos, elegir tu editor, usar Eddy AI para refinar contenido, comprobar dónde se usan fragmentos en tu base de conocimientos y editarlos o eliminarlos individualmente o en bloque.
La página de Fragmentos
- Navega a Herramientas de Contenido () en la barra de navegación izquierda.
- Selecciona Recursos de contenido > Fragmentos en el panel de navegación izquierdo.
| Elemento | Descripción |
|---|---|
| Crear | Crea un nuevo fragmento. |
| Detección de contenido duplicado | Identifica el texto duplicado en tu documentación y sugiere convertirlo en fragmentos. |
| Idiomas | Filtra la lista de fragmentos por Global o por un lenguaje específico. |
| Fragmentos de búsqueda | Busca fragmentos por nombre. |
| Caja de selección | Selecciona uno o más fragmentos para eliminar en masa. |
| Nombre | Haz clic en el nombre de un fragmento para previsualizar su contenido. |
| Utilizado en | Muestra dónde se usa el fragmento. Muestra un guion si no se usa. Si se utiliza, haz clic en Ver para ver los artículos o páginas de categorías donde ha sido insertado. |
| Idioma | Indica el idioma asignado al fragmento. |
| Última modificación | Muestra la fecha y hora en que se actualizó por última vez el fragmento. |
| Estado de la traducción | Haz clic en el icono del globo para comprobar el progreso de la traducción. Un tache verde significa que el fragmento ha sido traducido a ese idioma. Una X significa que no lo ha hecho. |
| Edición | Abre el fragmento para editarlo. |
| Borrar | Elimina el fragmento. Para eliminar en masa, selecciona las casillas y haz clic en Borrar en la parte superior. |
Detección de contenido duplicado
El banner de detección de contenido duplicado en la parte superior de la página de Fragmentos te ayuda a identificar y gestionar el texto repetido en toda tu documentación. Esta función está impulsada por Eddy AI. Escanea tu proyecto en busca de párrafos que aparecen varias veces en los artículos, genera un informe que muestra dónde existe contenido duplicado y sugiere convertirlo en fragmentos reutilizables.
- Haz clic en Buscar duplicados en el banner para empezar a escanear tu proyecto.
- Una vez finalizada la exploración, se muestra el número total de bloques de texto duplicados detectados.
- Si ya se ha realizado un escaneo, haz clic en escanear de nuevo para volver a ejecutar el proceso.
- Haz clic en Revisar sugerencias para abrir el informe de Detección de Contenido Duplicado y revisar los hallazgos.
Para más información, consulta la sección de detección de contenido duplicado →
Crea un fragmento
- En la página de Fragmentos , haz clic en Crear en la esquina superior derecha.
- En el cuadro de diálogo Crear nuevo fragmento , configura lo siguiente:
- Nombre: Introduce un nombre de hasta 50 caracteres. Puedes usar letras, números, guiones y guiones bajos.
- Idioma: Selecciona un idioma. El valor por defecto es Global.
- Editor: Expande Advanced y elige Markdown o Advanced WYSIWYG. El valor por defecto depende de la configuración de tu proyecto.
- Haz clic en Crear.
- Introduce tu contenido en el editor.
Editor de Markdown: Utiliza las herramientas de formato para dar formato a tu texto.
Editor avanzado de WYSIWYG: Usa la barra de herramientas o el menú de inserción rápida para formatear tu contenido.
Una vez seleccionas el editor avanzado WYSIWYG, no puedes volver a Markdown. Si empiezas con Markdown, puedes convertir a WYSIWYG avanzado para fines de traducción, ya que Markdown no soporta Translate con Eddy AI. No puedes volver a Markdown después de convertir.
- Para cambiar el idioma del fragmento, utiliza el desplegable de lenguaje en la parte superior del editor.
- Haz clic en Guardar o pulsa
Ctrl + S.
También puedes usar HTML personalizado en la vista de código para formatear. Las etiquetas no soportadas se desinfectarán automáticamente.
Usa Eddy AI en contenido de fragmentos
Mientras redactas un fragmento en el editor avanzado WYSIWYG, pasa el cursor sobre cualquier contenido y utiliza Eddy AI para hacer el texto más largo o más corto, mejorarlo, cambiar el tono, convertir el habla, cambiar la voz, dividir frases o generar elementos como tablas, gráficos circulares y diagramas de flujo.
Ver uso de fragmentos
Antes de editar o eliminar un fragmento, puedes comprobar exactamente qué artículos y páginas de categorías lo usan.
- En la página de Fragmentos , localiza el fragmento en la columna Usado en .
- Haz clic en Ver. Se abre el panel de referencias Vista . Para cada referencia puedes ver la versión del artículo, el espacio de trabajo del proyecto y el lenguaje, el nombre del usuario que añadió el fragmento, el estado del artículo (Borrador o Publicado) y la fecha y hora en que se insertó el fragmento.
- Haz clic en el icono para abrir esa versión del artículo en una nueva pestaña.
Edito un fragmento
- En la página de Fragmentos , pasa el cursor sobre el fragmento y haz clic en el icono Editar ().
- Actualiza el contenido según sea necesario.
- Haz clic en Actualizar.
Cuando actualizas un fragmento, los cambios se reflejan automáticamente en todos los artículos y páginas de categorías donde se utiliza, incluidas las publicadas, sin necesidad de volver a publicarlos.
Eliminar un fragmento
- En la página de Fragmentos , pasa el cursor sobre el fragmento y haz clic en el icono Suprimir ().
- Haz clic en Sí en el cuadro de confirmación.
Para eliminar en masa, selecciona las casillas junto a los fragmentos que quieres eliminar y haz clic en Borrar en la parte superior de la lista.
Cuando eliminas un fragmento, se elimina de todos los artículos donde se hace referencia. El artículo conserva su versión actual. En el sitio de la base de conocimiento, el contenido circundante se ajusta automáticamente y no queda ningún espacio vacío. En el portal, aparece un símbolo de carga en el bloque de contenido donde se eliminó el fragmento. Selecciona este bloque para insertar otro fragmento o elimínalo manualmente.
Limitaciones
| Punto | Detalle |
|---|---|
| Longitud del nombre del fragmento | Máximo 50 caracteres. |
| Personajes de nombres fragmentados | Solo letras, números, guiones y guiones bajos. |
| Nombre del fragmento | No se puede cambiar después de la creación. |
| Tipo de editor | Una vez cambiado a Advanced WYSIWYG, no se puede revertir a Markdown. |
| Fragmentos globales | No se puede traducir. |
| Recuento de fragmentos por proyecto | Hasta 200 fragmentos. Hay fragmentos adicionales disponibles como complemento. |
| Variables dentro de fragmentos | No está soportado. Las variables no se renderizarán correctamente en la vista previa del editor ni en las exportaciones de PDF. |
Mejores prácticas
- Elige cuidadosamente a tu editor al crearlo. Cambiar de Markdown a Advanced WYSIWYG es posible pero irreversible. Usa WYSIWYG avanzado si planeas traducir el fragmento o usar formato enriquecido.
- Nombra fragmentos descriptivos. Utiliza nombres que identifiquen el tipo de contenido y el propósito, por ejemplo
Support_Contact_BlockoAPI_Disclaimer. Esto facilita encontrar y insertar fragmentos sin tener que previsualizar cada uno. - Usa el alcance global por defecto. Configura el idioma en Global a menos que el contenido del fragmento realmente varía según el idioma. Los fragmentos específicos de cada idioma requieren una gestión separada por idioma.
- Comprueba las dependencias antes de borrar. Utiliza Ver en la columna Usado en para confirmar el impacto entre los artículos antes de eliminar un fragmento que pueda ser ampliamente utilizado.
- Prefiero fragmentos a copiar y pegar. Si el mismo bloque de contenido aparece en más de dos artículos, crea un fragmento en lugar de duplicarlo manualmente.