Tiện ích: Đề xuất

Bạn có thể sử dụng phần tử tuỳ chỉnh <devsite-recommendations> để đề xuất nội dung cho độc giả. Bạn có thể để hệ thống tạo các đề xuất, tự đưa ra đề xuất rõ ràng hoặc bạn có thể gói các phần đề xuất hiện có trong tài liệu của mình để trình bày nhất quán, số liệu thống kê về lượt nhấp và một giao diện người dùng đa dạng (bao gồm cả nội dung mô tả và hình ảnh).

Cách sử dụng

Để sử dụng tiện ích này, hãy tạo một phần tử <devsite-recommendations>. Nếu bạn muốn đưa ra đề xuất một cách rõ ràng, hãy thêm một số đường liên kết trong phần tử đó. Hiện tại, các đề xuất do hệ thống tạo sẽ được cung cấp khi phần tử này trống. Tuy nhiên, các tác phẩm trong tương lai sẽ cho phép tác giả thử nghiệm các đề xuất được tạo khi các đề xuất rõ ràng được cung cấp, cũng như sử dụng chúng làm dữ liệu đầu vào cho thuật toán.

Nếu bạn đang đưa ra đề xuất rõ ràng, hãy cung cấp một số mã đánh dấu trong phần tử đó. Mọi thẻ <a> được phát hiện khi phần tử được kết nối sẽ được trích xuất và sử dụng các thuộc tính href cho các đề xuất.

Nếu bạn cung cấp nhiều hơn 3 đề xuất, hệ thống sẽ lựa chọn ngẫu nhiên một lựa chọn. Tuy nhiên, thứ tự của các đề xuất vẫn sẽ giống như thứ tự đầu vào, vì vậy, các đề xuất có mức độ ưu tiên cao hơn sẽ luôn hiển thị ở ngoài cùng bên trái.

Nếu không muốn một số đề xuất cụ thể xuất hiện trong kết quả được tạo, bạn có thể tạo một phần tử <devsite-recommendations> trống bằng tập hợp <link rel="disallow" href="/path">. Hệ thống sẽ tự động phát hiện những thẻ <link> có rel=disallow và thuộc tính href và loại bỏ những thẻ đó khỏi các đề xuất đã tạo.

Nếu chỉ muốn nhận nội dung đề xuất từ một nhóm nhỏ các trang cụ thể, bạn có thể sử dụng các thẻ Danh mục trong trường query để lọc kết quả. Cú pháp là k:category:value. Ví dụ: k:language:typescript. Danh sách thẻ có thể là danh sách được phân tách bằng dấu phẩy (k:language:typescript,k:language:swift) để bao gồm những trang chứa bất kỳ thẻ nào trong số các thẻ đó.

Các phần sau đây mô tả mã đánh dấu, cách thẻ hiển thị trong điều kiện bình thường và cách thẻ hiển thị với máy hoặc các tác nhân người dùng đơn giản.

Markup (note: đây là tên ứng dụng)

<devsite-recommendations>
<p>Note: link text is displayed when JavaScript is off</p>
<ul>
  <li><a href="/maps/documentation">Maps docs</a></li>
  <li><a href="/analytics">Analytics</a></li>
  <li><a href="/machine-learning/crash-course">MLCC</a></li>
</ul>
</devsite-recommendations>

Kết quả

Tác nhân người dùng đơn giản

Lưu ý: văn bản có đường liên kết sẽ hiện khi JavaScript tắt

Ví dụ về lượt không cho phép

Markup (note: đây là tên ứng dụng)

<devsite-recommendations>
  <link rel="disallow" href="/maps/documentation">
  <link rel="disallow" href="/analytics">
  <link rel="disallow" href="/machine-learning/crash-course">
</devsite-recommendations>

Kết quả

Vì kết quả phụ thuộc vào các đề xuất và có thể thay đổi, nên kết quả sẽ giống với kết quả từ mô hình đề xuất.

Bao bọc nội dung hiện có

Phần tử này có thể nâng cao dần mã đánh dấu hiện có trên các trang, vì vậy, bạn có thể nâng cấp các đường liên kết hiện có bằng cách gói chúng bằng <devsite-recommendations>.

Các đường liên kết mới sẽ áp dụng tất cả chức năng và chính sách của nền tảng đề xuất, chẳng hạn như trang tổng quan về thử nghiệm và thu thập dữ liệu. Tuy nhiên, nội dung cũng sẽ được thay thế bằng siêu dữ liệu phong phú bao gồm nội dung mô tả và hình ảnh, đồng thời có thể loại trừ một số đường liên kết (ví dụ: trang được kiểm soát quyền truy cập hoặc trang không có siêu dữ liệu).

Markup (note: đây là tên ứng dụng)

<devsite-recommendations>
<h2>Example communities</h2>
<p>Note: All markup here will be replaced with the recommendation UI.</p>
<p>
  For more information on Google Developers, check out our <a href="/community/experts">GDEs</a>. If
  you are looking to form a community, take a look at <a href="/community/gdg">GDGs</a>. Lastly, if
  you're currently studying, don't miss our <a href="/community/dsc">DSCs</a>.
</p>
</devsite-recommendations>

Kết quả

Ví dụ về cộng đồng

Lưu ý: Tất cả mã đánh dấu ở đây sẽ được thay thế bằng giao diện người dùng đề xuất.

Để biết thêm thông tin về Google Developers, hãy xem GDE của chúng tôi. Nếu bạn muốn tạo một cộng đồng, hãy xem GDG. Cuối cùng, nếu bạn hiện đang học, đừng bỏ lỡ DSC của chúng tôi.

Cách sử dụng trong tệp Markdown

Trong tệp Markdown (.md), hãy đảm bảo phần tử tuỳ chỉnh được gói bằng một phần tử HTML chuẩn, chẳng hạn như <section> hoặc <div>:

Nội dung hỗn hợp

## Markdown section

* Markdown list
* [Markdown link](/foo)

## HTML section

<div>
<devsite-recommendations>
  <p>Note: link text is displayed when JavaScript is off</p>
  <h2>Sample heading</h2>
  <a href="/recommended">Recommended</a>
</devsite-recommendations>
</div>

Mục Markdown

Phần HTML

Lưu ý: văn bản có đường liên kết sẽ hiện khi JavaScript tắt

Tiêu đề mẫu

Đề xuất

Đánh dấu thuần tuý

<pre><devsite-recommendations>
## Sample heading

* Note: link text is displayed when JavaScript is off
* [Maps documentation](/maps/documentation)

</devsite-recommendations><pre>

Kết quả

Tiêu đề mẫu

Thuộc tính hệ thống

Hiện tại, các thuộc tính duy nhất được hỗ trợ là để kiểm soát hành vi của hệ thống và người dùng thông thường không cần đến.

yield (không bắt buộc) Nếu được cung cấp, phần tử này sẽ nhường chỗ cho mọi phần tử đề xuất không mang lại lợi nhuận khác trên trang. Thường thì trang web này sử dụng chức năng này để tự động đặt các đề xuất trên một trang, nhưng chỉ hiển thị khi không có trường hợp nào khác.

Lọc theo danh pháp

Markup (note: đây là tên ứng dụng)

<devsite-recommendations query="k:language:typescript">
</devsite-recommendations>

Kết quả