Môi trường thử nghiệm nội dung chia sẻ

Phần này được đưa vào nhằm mục đích xác minh nội dung chung được cung cấp từ kho lưu trữ này để sử dụng trong phần còn lại của tài liệu BeeWare. "Nội dung chung" đề cập đến các tài liệu hoặc các phần của tài liệu được sử dụng chung trong nhiều kho lưu trữ khác. Chúng được lưu trữ tại đây để có thể đưa vào các kho lưu trữ đó. Điều này có nghĩa là khi cần cập nhật, sẽ chỉ có một nguồn duy nhất, và thay đổi đó sẽ được áp dụng đồng bộ trên tất cả các kho lưu trữ sử dụng nội dung chung đó.

Nếu bạn đang cập nhật nội dung hiện có, các bước sau đây là không cần thiết. Bạn chỉ cần tạo trang thử nghiệm và xem các cập nhật của mình được hiển thị.

Nếu bạn đang tạo một tệp tài liệu dùng chung mới trong thư mục shared-content, mà tệp này KHÔNG được dự định đưa vào thư mục how-to, hãy thực hiện các bước sau:

1. Tạo một tệp trong thư mục content_test_bed có tên giống với tệp nội dung mới của bạn, và thêm "_include" vào cuối tên tệp.
   • Đối với style_guide.md, bạn sẽ thêm style_guide_include.md.
2. Sử dụng cú pháp Snippets, hãy thêm tên tệp vào filename_include.md. Cú pháp Snippets để chèn nội dung là -8<- "filename.md".
   • Đối với style_guide.md, bạn sẽ thêm -8<- "style_guide.md" vào style_guide_include.md.
3. Cập nhật phần Shared content test bed trong /docs/SUMMARY.md để thêm tệp _include mới và đường dẫn, với mức thụt lề giống như các mục khác trong phần đó.
   • Đối với style_guide_include.md, bạn sẽ thêm - [Style guide](content_test_bed/style_guide_include.md).

Sau khi hoàn tất các bước này, bạn có thể tạo trang web thử nghiệm và xem tài liệu mới của mình được hiển thị.