Widgets: Συστάσεις

Το προσαρμοσμένο στοιχείο <devsite-recommendations> μπορεί να χρησιμοποιηθεί για την παροχή προτάσεων περιεχομένου στους αναγνώστες σας. Μπορείτε να αφήσετε το σύστημα να δημιουργήσει προτάσεις , μπορείτε να παρέχετε ρητές προτάσεις μόνοι σας ή μπορείτε να τυλίξετε υπάρχουσες ενότητες προτάσεων του εγγράφου σας για συνεπή παρουσίαση, στατιστικά κλικ και μια πλούσια διεπαφή χρήστη (συμπεριλαμβανομένων περιγραφών και εικόνων).

Χρήση

Για να χρησιμοποιήσετε αυτό το γραφικό στοιχείο, δημιουργήστε ένα στοιχείο <devsite-recommendations> . Εάν θέλετε να παρέχετε ρητά προτάσεις, προσθέστε μερικούς συνδέσμους μέσα στο στοιχείο. Προς το παρόν, οι συστάσεις που δημιουργούνται από το σύστημα θα παρέχονται όταν το στοιχείο είναι κενό, αλλά μελλοντική εργασία θα επιτρέψει στους συγγραφείς να πειραματιστούν με προτάσεις που δημιουργούνται όταν παρέχονται ρητές συστάσεις, καθώς και να τις χρησιμοποιούν ως είσοδο στον αλγόριθμο.

Εάν παρέχετε ρητές συστάσεις, τότε δώστε κάποια σήμανση εντός του στοιχείου. Τυχόν ετικέτες <a> που εντοπίζονται όταν είναι συνδεδεμένο το στοιχείο θα εξάγονται τα χαρακτηριστικά href και θα χρησιμοποιηθούν για τις προτάσεις.

Εάν παρέχετε περισσότερες από τρεις συστάσεις, θα επιλεγεί μια τυχαία επιλογή. Ωστόσο, η σειρά των προτάσεων θα παραμείνει ίδια με τη σειρά εισόδου, επομένως οι προτάσεις υψηλότερης προτεραιότητας θα εμφανίζονται πάντα στο αριστερό μέρος.

Εάν δεν θέλετε να εμφανίζονται συγκεκριμένες προτάσεις στα αποτελέσματα που δημιουργούνται, μπορείτε να δημιουργήσετε ένα κενό στοιχείο <devsite-recommendations> με μια συλλογή από <link rel="disallow" href="/path"> . Τυχόν ετικέτες <link> με rel=disallow και χαρακτηριστικό href θα εντοπιστούν και θα αφαιρεθούν αυτόματα από τις προτάσεις που δημιουργούνται.

Εάν θέλετε μόνο προτάσεις από ένα συγκεκριμένο υποσύνολο σελίδων, μπορείτε να χρησιμοποιήσετε ετικέτες ονοματολογίας σε ένα πεδίο query για να φιλτράρετε τα αποτελέσματα. Η σύνταξη είναι k:category:value . Για παράδειγμα, k:language:typescript. Η λίστα των ετικετών μπορεί να είναι μια λίστα διαχωρισμένη με κόμματα ( k:language:typescript,k:language:swift ) για να περιλαμβάνει σελίδες που περιέχουν οποιαδήποτε από τις ετικέτες.

Παράδειγμα με συνδέσμους

Οι ακόλουθες ενότητες περιγράφουν τη σήμανση, πώς αποδίδεται υπό κανονικές συνθήκες και πώς αποδίδεται σε μηχανήματα ή απλούς πράκτορες χρήστη.

Σήμανση

<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>

Αποτέλεσμα

Απλοί user-agents

Σημείωση: Το κείμενο συνδέσμου εμφανίζεται όταν η JavaScript είναι απενεργοποιημένη

• Έγγραφα χαρτών
• Analytics
• MLCC

Παράδειγμα με τις απαγορεύσεις

Σήμανση

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

Αποτέλεσμα

Δεδομένου ότι τα αποτελέσματα εξαρτώνται από τις συστάσεις, οι οποίες μπορούν να αλλάξουν, η έξοδος θα εμφανίζεται ίδια με την έξοδο από το μοντέλο συστάσεων.

Αναδίπλωση υπάρχοντος περιεχομένου

Το στοιχείο μπορεί να βελτιώσει σταδιακά την υπάρχουσα σήμανση στις σελίδες σας, ώστε να μπορείτε να αναβαθμίσετε υπάρχοντες συνδέσμους τυλίγοντάς τους με <devsite-recommendations> .

Οι νέοι σύνδεσμοι θα υιοθετούν όλες τις λειτουργίες και τις πολιτικές της πλατφόρμας προτάσεων, όπως πίνακες ελέγχου συλλογής δεδομένων και πειραμάτων, αλλά το περιεχόμενο θα αντικατασταθεί επίσης από πλούσια μεταδεδομένα, συμπεριλαμβανομένων περιγραφών και εικόνων, και ενδέχεται να εξαιρεί ορισμένους συνδέσμους (π.χ. ελεγχόμενη πρόσβαση ή σελίδες χωρίς μεταδεδομένα).

Σήμανση

<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>

Αποτέλεσμα

Παραδείγματα κοινοτήτων

Σημείωση: Όλη η σήμανση εδώ θα αντικατασταθεί με τη διεπαφή χρήστη της πρότασης.

Για περισσότερες πληροφορίες σχετικά με το Google Developers, ανατρέξτε στις GDE μας . Αν θέλετε να δημιουργήσετε μια κοινότητα, ρίξτε μια ματιά στα GDG . Τέλος, εάν σπουδάζετε αυτήν τη στιγμή, μην χάσετε τα DSC μας .

Χρήση σε αρχεία Markdown

Σε ένα αρχείο Markdown ( .md ), βεβαιωθείτε ότι το προσαρμοσμένο στοιχείο είναι τυλιγμένο με ένα τυπικό στοιχείο HTML, όπως <section> ή <div> :

Μικτό περιεχόμενο

## 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>

Ενότητα Markdown

• Λίστα Markdown
• Σύνδεσμος Markdown

ενότητα HTML

Καθαρή σήμανση

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

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

</devsite-recommendations><pre>

Αποτέλεσμα

Ιδιότητες συστήματος

Προς το παρόν, τα μόνα χαρακτηριστικά που υποστηρίζονται είναι για τον έλεγχο της συμπεριφοράς του συστήματος και δεν θα πρέπει να χρειάζονται από τους κανονικούς χρήστες.

yield (προαιρετικό) Εάν παρέχεται, το στοιχείο θα υποχωρήσει σε οποιαδήποτε άλλα στοιχεία σύστασης που δεν αποδίδουν στη σελίδα. Αυτό χρησιμοποιείται συνήθως από τον ίδιο τον ιστότοπο για να τοποθετεί αυτόματα προτάσεις σε μια σελίδα, αλλά για να τις εμφανίζει μόνο όταν δεν υπάρχουν άλλες παρουσίες.

Φιλτράρισμα με Ονοματολογία

Σήμανση

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

Αποτέλεσμα