Uso de fragmentos

Fragmentos es un conjunto predefinido de bloques de contenido que el administrador de contenido o el autor utiliza como contenido reutilizable. El contenido del fragmento puede variar desde texto o frases simples hasta párrafos largos, tablas, imágenes y más. En Document360, los fragmentos se almacenan en una biblioteca y puede insertarlos fácilmente en los artículos durante la edición con solo hacer clic en un botón.

NOTA

El fragmento aparecerá como contenido normal para el lector en el sitio de la base de conocimientos. El lector no sabrá que el contenido se renderizó a través de Snippet.

Creación de un fragmento de código

Para crear un fragmento:

1. Navegue hasta Documentación () en la barra de navegación izquierda en el Portal de la base de conocimientosarchivo .

2. En el panel de navegación izquierdo, vaya a Herramientas de contenido > Reutilización de contenidos > Fragmentos.

   Aparece la Fragmentos página. Si ha agregado fragmentos anteriormente, puede verlos enumerados aquí.

3. Haga clic en Crear fragmentos en la parte superior para seleccionar fragmentos específicos del idioma (global, inglés, francés, etc.) agregados a su proyecto.

4. Introduzca el nombre del fragmento.

   NOTA

   El nombre del fragmento puede incluir letras, números, guiones y guiones bajos, con una longitud máxima de 30 caracteres.

5. El valor del código de combinación será el nombre del fragmento que aparece con la etiqueta de fragmento en el editor.

   Por ejemplo, si el nombre del fragmento es Descargo de responsabilidad, el valor del código de combinación sería {{fragmento. Descargo de responsabilidad}}.

6. En el menú desplegable Selección de idioma , la selección predeterminada es Global (disponible en todos los idiomas). Sin embargo, si es necesario, puede elegir el idioma disponible que desee para crear un fragmento específico del idioma.

7. En el campo Contenido , introduzca el contenido del fragmento.

   De forma predeterminada, el editor de fragmentos será WYSIWYG (HTML). Sin embargo, puede cambiar al editor de Markdown si es necesario.

NOTA

Cambiar a Markdown:

1. Haga clic en Cambiar a Markdown.

2. Haga clic en Continuar en el mensaje de confirmación de cambio .

Perderá el contenido WYSIWYG cuando cambie a Markdown.

7. Una vez hecho esto, haz clic en Crear fragmento.

WYSIWYG

Las siguientes opciones de formato están disponibles para el contenido del fragmento en WYSIWYG:

• Están disponibles las opciones básicas de formato de texto, como Negrita, Cursiva, Tachado y Subrayado .

• Las opciones de formato adicionales incluyen Tamaño de fuente, Familia de fuentes, Color del texto, Color de fondo, Subíndice, Superíndice y Formato claro.

• Puede crear listas ordenadas y no ordenadas para listar artículos.

• Insertar imagen te permite insertar una imagen desde una URL, un almacenamiento local o Drive.

• Insertar enlace le permite agregar un hipervínculo desde una URL proporcionada o un enlace a un artículo de la base de conocimientos.

• Puede utilizar llamadas de inserción como Información, Advertencia, Error y Correcto.

• Insertar látex le permite agregar expresiones y ecuaciones:

  • Haga clic en la opción Insertar látex y aparecerá el panel Insertar expresión de látex .

  • Escriba la sintaxis de Latex que desee y haga clic en Insertar.

  • Lea este artículo para conocer los comandos básicos de Latex utilizados en la sintaxis de Latex.

• Insertar tabla le permite crear una tabla seleccionando el número requerido de filas y columnas.

• Insertar bloque de código le permite agregar bloques de código.

  • Haga clic en Insertar bloque de código y seleccione el idioma del código deseado en el menú desplegable.

  • Agregue código en el campo Inserte su código y haga clic en Insertar.

• Puede obtener una vista previa del fragmento de código en la vista de código (HTML). Haga clic en Vista de código para ver la vista previa. Si desea volver a la vista del editor, vuelva a hacer clic en Vista de código .

Descuento

Markdown es útil cuando hay texto significativo y medios mínimos involucrados en el fragmento. Puede utilizar la sintaxis de Markdown manualmente mientras escribe o da formato al texto mediante la barra de herramientas de Markdown.

Por ejemplo, puede hacer que un texto aparezca en negrita escribiendo la sintaxis respectiva o utilizando el icono Negrita () en la barra de herramientas de Markdown.

• Están disponibles las opciones básicas de formato de texto, como negrita, cursiva y tachado .

• La cita en bloque le permite agregar citas en bloque.

• Línea le permite insertar una línea horizontal.

• La lista ordenada y la lista desordenada están disponibles para listar artículos.

• Insertar tabla le permite crear una tabla seleccionando el número requerido de filas y columnas.

• Insertar imagen te permite insertar una imagen desde una URL, un almacenamiento local o Drive.

• Insertar bloque de código le permite agregar bloques de código:

  • Haga clic en Insertar bloque de código y escriba el código deseado dentro del bloque de código.

  • Ejemplo: `code`.

• Puede utilizar llamadas de inserción como Información, Advertencia, Error y Correcto.

• Insertar látex le permite agregar expresiones y ecuaciones.

  • Haga clic en la opción Insertar látex y aparecerá un ejemplo de sintaxis de látex ().

  • Escriba la sintaxis que desee.

  • La sintaxis debe comenzar y terminar con $.

NOTA

Al agregar látex, no incluya un espacio entre $ la sintaxis y. Para obtener más información, lea este artículo para conocer los comandos básicos de látex.

• Insertar enlace le permite agregar un hipervínculo desde una URL proporcionada o un enlace a un artículo de la base de conocimientos.

• El glosario te permite agregar términos del glosario a tu fragmento.

Insertar un fragmento en el artículo

Hay dos métodos mediante los cuales puedes agregar un fragmento a tu artículo.

Puede insertar un fragmento en los artículos de dos métodos:

Método 1: Usar la sintaxis (editor de Markdown)

Método 2: Desde la barra de herramientas (Markdown, editor WYSIWYG y editor WYSIWYG avanzado)

Método 3: Usar el comando de barra diagonal (/)

Página de fragmentos

Puede ver, editar o eliminar un fragmento de Fragmentos la página.

1. Navegue hasta Documentación () en la barra de navegación izquierda en el Portal de la base de conocimientosarchivo .

2. En el panel de navegación izquierdo, vaya a Herramientas de contenido > Reutilización de contenidos > Fragmentos.

   Aparecerá la Fragmentos página donde puedes encontrar la lista de fragmentos que ya has añadido.

1. Idiomas: Para filtrar el fragmento en Global o en un idioma específico.

2. Buscar fragmentos: busque en la lista de fragmentos en función del nombre.

3. Se utiliza en: Si no se agrega un fragmento a ninguna página de artículo/categoría, el estado sería -. Si se agrega un fragmento a cualquier página de artículo/categoría, puede hacer clic en el botón Ver para ver la lista de páginas de artículos/categorías que contienen el fragmento.  

4. Idioma: el idioma deseado de cada fragmento.

5. Última modificación: la última vez que se actualizó el contenido del fragmento.

6. Vista previa: haga clic en el nombre del fragmento y podrá ver el contenido del fragmento.

7. Progreso: haz clic en el icono del globo terráqueo para ver el progreso del fragmento en varios idiomas.

8. Icono Editar (): Para editar el contenido del fragmento.

9. Icono Eliminar (): Para eliminar el fragmento.

Ver dependencia de la página de artículo/categoría

En la Fragmentos página, puede encontrar la columna Usado en .

1. En la columna Usado en , haga clic en el botón Ver .

   Aparecerá el panel Ver referencias , donde puede ver la lista de artículos/páginas de categorías a las que se ha agregado el fragmento.

2. Haga clic en el artículo para ampliar la sección.

3. Puede encontrar la siguiente información:

   • La versión del artículo.

   • El espacio de trabajo y el idioma del proyecto.

   • El nombre de la cuenta del equipo y la foto de perfil que ha agregado el fragmento.

   • El artículo dice (Publicado, Borrador, Nuevo artículo).

   • La información de fecha y hora en la que se insertó el fragmento en la página del artículo o la categoría.

Edición de un fragmento existente

1. Navegue hasta Documentación () en la barra de navegación izquierda en el Portal de la base de conocimientosarchivo .

2. En el panel de navegación izquierdo, vaya a Herramientas de contenido > Reutilización de contenidos > Fragmentos.

   Aparece la Fragmentos página. Puede encontrar la lista de fragmentos que ya ha agregado.

3. Coloque el cursor sobre el fragmento deseado y haga clic en el icono Editar ().

4. Después de completar la edición del contenido, haga clic en el botón Actualizar .

NOTA

Al actualizar un fragmento de código en la biblioteca, los cambios se reflejan automáticamente en todos los artículos y páginas de categorías que lo utilizan. Esto incluye los artículos publicados, que se actualizarán sin necesidad de volver a publicarlos.

Eliminación de un fragmento de código

1. Navegue hasta Documentación () en la barra de navegación izquierda en el Portal de la base de conocimientosarchivo .

2. En el panel de navegación izquierdo, vaya a Herramientas de contenido > Reutilización de contenidos > Fragmentos.

   Aparecerá la página Fragmentos . Puede encontrar la lista de fragmentos que ya ha agregado.

3. Coloque el cursor sobre el fragmento deseado y haga clic en el icono Eliminar ().

4. Haga clic en Sí en el mensaje de confirmación.

Para eliminar varios fragmentos de código de forma masiva

Seleccione varios fragmentos deseados de la página Fragmentos y haga clic en la opción Eliminar en la parte superior de la lista.

Traducción de fragmentos

Puede crear y administrar fragmentos en varios idiomas. Esto garantiza que, cuando se traduzcan sus artículos, los fragmentos coincidan con el idioma del artículo, lo que proporciona una experiencia de usuario coherente y localizada.

NOTA

Los fragmentos globales no se pueden traducir.

Traducción de nuevos fragmentos

1. Navegue hasta Documentación () en la barra de navegación izquierda en el Portal de la base de conocimientosarchivo .

2. En el panel de navegación izquierdo, vaya a Herramientas de contenido > Reutilización de contenidos > Fragmentos.

3. Haz clic en Crear fragmento.

4. En el menú desplegable Idioma , seleccione el idioma deseado.

5. Introduzca el nombre del fragmento y el contenido del fragmento en inglés (o en su idioma predeterminado).

6. Haga clic en Cambiar a Markdown para cambiar el editor de contenido de WYSIWYG al editor de Markdown.

7. Para traducir el contenido a otros idiomas, haga clic en el menú desplegable Traducir a otros idiomas .

8. Seleccione los idiomas deseados en el menú desplegable y haga clic en Traducir.

NOTA

• El idioma predeterminado se marcará como Principal.

• Los idiomas traducidos se indicarán con una marca verde para indicar que la traducción está completa. Si es necesario, puede navegar a los idiomas no traducidos y completar su traducción.

7. Una vez completadas las traducciones, haga clic en Crear fragmento para guardar el fragmento junto con sus traducciones.

Por ejemplo, si crea un fragmento para un mensaje de bienvenida en inglés, puede usar la función de traducción para agregar el mismo mensaje en francés, español, holandés, etc.

Traducción de fragmentos de código existentes

1. Haga clic en el fragmento existente que desee traducir.

2. Vaya a Traducir a otros idiomas y seleccione el idioma deseado para el que se debe traducir el fragmento.

3. Haga clic en Traducir.

4. Si es necesario, puede navegar a otros idiomas y volver a traducir a esos idiomas.

5. Para volver a traducir el contenido, haga clic en Traducir de nuevo. Esto sobrescribirá la traducción existente por una nueva.

6. Si necesitas eliminar el fragmento traducido de un idioma específico, haz clic en Eliminar idioma.

   Puede volver a traducir el contenido en cualquier momento si es necesario.

Solución de problemas

Los fragmentos no aparecen en el menú del editor

Este problema suele producirse cuando se crea un fragmento en un idioma, pero se utiliza en un artículo escrito en un idioma diferente. En Document360, los fragmentos de código son específicos del idioma, a menos que se creen en la configuración de idioma global .

Pasos para resolverlo:

• Asegúrate de que el fragmento esté creado en el mismo idioma que el artículo en el que estás trabajando.

• Si el fragmento se creó en un idioma diferente, use la opción Traducir a otros idiomas disponible en la sección Reutilización de contenido.

• Una vez traducido, cambie al idioma deseado en el editor de artículos. El fragmento debería aparecer ahora cuando intente insertarlo en el artículo.

NOTA

Los fragmentos creados en un idioma específico solo aparecerán en artículos escritos en ese mismo idioma.

Si los fragmentos siguen sin aparecer después de seguir los pasos anteriores, póngase en contacto support@document360.com con los siguientes detalles:

• Captura de pantalla del fragmento de código en la sección Reutilización de contenido.

• Una captura de pantalla que muestra el fragmento que no aparece en el editor de artículos.