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:
- Cree un archivo en
content_test_bedcon el mismo nombre que su nuevo archivo de contenido, añadiendo «_include» al final.- Para
style_guide.md, añadiríasstyle_guide_include.md.
- Para
- 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"astyle_guide_include.md.
- Para
- Actualiza la sección
Shared content test beden/docs/SUMMARY.mdpara incluir el nuevo archivo_includey 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).
- Para
Una vez completados estos pasos, puede crear el sitio de prueba y ver su nueva documentación renderizada.