Saltar a contenido

Banco de pruebas de contenido compartido

Esta sección se incluye con el fin de verificar el contenido compartido proporcionado desde este repositorio para su uso en el resto de la documentación de BeeWare. El «contenido compartido» se refiere a documentos o secciones de documentos que son comunes a varios otros repositorios. Se almacenan aquí para su inclusión en todos esos repositorios. Esto significa que hay una única fuente cuando se requieren actualizaciones, y que el cambio se propagará a todos los repositorios que utilicen ese contenido compartido.

Si está actualizando contenido existente, los siguientes pasos no son necesarios. Simplemente puede crear el sitio de prueba y ver cómo se muestran sus actualizaciones.

Si está creando un nuevo archivo de documentación compartida en el directorio shared-content, que NO está destinado a incluirse en el directorio how-to, complete lo siguiente:

  1. Cree un archivo en content_test_bed con el mismo nombre que su nuevo archivo de contenido, añadiendo «_include» al final.
    • Para style_guide.md, añadirías style_guide_include.md.
  2. Utilizando la sintaxis de fragmentos, añada el nombre del archivo a filename_include.md. La sintaxis de fragmentos para incluir contenido es -8<- "filename.md".
    • Para style_guide.md, añadirías -8<- "style_guide.md" a style_guide_include.md.
  3. Actualiza la sección Shared content test bed en /docs/SUMMARY.md para incluir el nuevo archivo _include y la ruta, con el mismo nivel de sangría que los demás elementos de esa sección.
    • Para style_guide_include.md, añadirías - [Style guide](content_test_bed/style_guide_include.md).

Una vez completados estos pasos, puede crear el sitio de prueba y ver su nueva documentación renderizada.