- Co to robi
- Co nie robi
- Instalacja
- Stosowanie
- Zaawansowane użycie
- Wyłączenie wyjścia <title>
- Informacje o autorze
- Dostosowywanie wyjścia JSON-LD
- Dostosowywanie obrazu wyjściowego
- Ustawianie domyślnego obrazu
- Tytuły SmartyPants
Wtyczka Jekyll do dodawania tagów metadanych dla wyszukiwarek i sieci społecznościowych w celu lepszego indeksowania i wyświetlania treści witryny.
Co to robi
Tag Jekyll SEO dodaje do Twojej witryny następujące tagi meta:
Chociaż teoretycznie możesz dodać niezbędne znaczniki metadanych, Tag Jekyll SEO zapewnia sprawdzony w walce szablon najlepszych praktyk crowdsourcingu.
Co nie robi
Tag Jekyll SEO jest przeznaczony do wyświetlania odczytywalnych maszynowo metadanych dla wyszukiwarek i sieci społecznościowych do indeksowania i wyświetlania. Jeśli szukasz czegoś do przeanalizowania struktury i zawartości witryny Jekyll (np. Bardziej tradycyjnej optymalizacji SEO), spójrz na The Jekyll SEO Gem .
Tag Jekyll SEO nie został zaprojektowany, aby pomieścić wszystkie możliwe przypadki użycia. Powinien on działać w przypadku większości witryn po wyjęciu z pudełka i bez listy opcji konfiguracyjnych dla pralni, które służą tylko do dezorientacji większości użytkowników.
Instalacja
- Dodaj następujące elementy do pliku Gemfile swojej witryny:
klejnot „jekyll-seo-tag”
- Dodaj następujące elementy do _config.yml swojej witryny:
klejnoty: - jekyll-seo-tag
- Dodaj bezpośrednio przed </head> szablonem (-ami) swojej witryny:
{% seo%}
Stosowanie
Tag SEO będzie respektował następujące elementy, jeśli zostanie uwzględniony w _config.yml Twojej witryny (i po prostu ich nie uwzględni, jeśli nie są zdefiniowane):
- title - Tytuł Twojej witryny (np. niesamowita strona Bena, Blog GitHub itp.)
- opis - krótki opis (np. blog poświęcony recenzowaniu gify kota)
- url - pełny adres URL do Twojej witryny. Uwaga: domyślnie będzie używany site.github.url.
- autor - globalne informacje o autorze (patrz poniżej)
- twitter: nazwa użytkownika - uchwyt serwisu Twitter. Będziesz chciał to tak opisać:
twitter: nazwa użytkownika: benbalter
- facebook - Dostępne są następujące właściwości:
- facebook: app_id - identyfikator aplikacji na Facebooku dla spostrzeżeń na Facebooku
- facebook: publisher - adres URL strony na Facebooku lub identyfikator podmiotu publikującego
- facebook: admins - identyfikator użytkownika Facebooka dla statystyk domen powiązanych z kontem osobistym
Będziesz chciał opisać jedną lub więcej takich rzeczy:
facebook: app_id: 1234 wydawca: 1234 administratorów: 1234
- logo - URL do logo całej witryny (np. /assets/your-company-logo.png)
- social - For określanie profili społecznych . Dostępne są następujące właściwości:
- nazwa - jeśli nazwa użytkownika lub organizacji różni się od nazwy witryny
- linki - Tablica linków do profili mediów społecznościowych.
- date_modified - Ręcznie określ pole dateModified w wyjściu JSON-LD, aby zastąpić własną datę Jekyll Zmodyfikowano. To pole będzie przyjmować pierwszeństwo dla wyjścia DataModified JSON-LD. Jest to przydatne, gdy znacznik czasu pliku nie jest zgodny z rzeczywistym czasem modyfikacji zawartości. Użytkownik może również zainstalować Ostatnia modyfikacja At który zaoferuje alternatywny sposób dostarczania pola DataModified.
social: nazwa: Ben Balter linki: - https://twitter.com/BenBalter - https://www.facebook.com/ben.balter - https://www.linkedin.com/in/BenBalter - https: / /plus.google.com/+BenBalter - https://github.com/benbalter - https://keybase.io/benbalter `` `*` google_site_verification` do weryfikacji własności za pomocą narzędzi Google dla webmasterów * Alternatywnie, sprawdź własność za pomocą kilku usługi naraz przy użyciu następującego formatu: `` `yml webmaster_verifications: google: 1234 bing: 1234 alexa: 1234 yandex: 1234
- lang - Ustawienia regionalne, w których te znaczniki są zaznaczone. Format language_TERRITORY. Domyślnie jest to en_US.
Tag SEO będzie respektował następującą sprawę YAML, jeśli będzie zawarty w poście, stronie lub dokumencie:
- title - Tytuł posta, strony lub dokumentu
- opis - Krótki opis zawartości strony
- image - URL do obrazu związanego z postem, stroną lub dokumentem (np. /assets/page-pic.jpg)
- autor - informacje o autorze strony, postu lub dokumentu (patrz poniżej)
- lang - Informacje językowe dotyczące stron, postów lub dokumentów
Zaawansowane użycie
Tag Jekyll SEO został zaprojektowany, aby domyślnie wdrażać najlepsze praktyki SEO i być odpowiedni dla większości witryn zaraz po wyjęciu z pudełka. Jeśli z jakiegoś powodu potrzebujesz większej kontroli nad wydrukiem, przeczytaj:
Wyłączenie wyjścia <title>
Jeśli z jakiegoś powodu nie chcesz, aby wtyczka wyświetlała tagi <title> na każdej stronie, po prostu wywołaj wtyczkę w swoim szablonie w następujący sposób:
{% seo title = false%}
Informacje o autorze
Informacje o autorze służą do propagowania pola twórcy kart podsumowania na Twitterze. Powinien to być specyficzny dla autora, a nie lokalny uchwyt Twittera (nazwa użytkownika dla całej witryny powinna być przechowywana jako site.twitter.username).
TL; DR: W większości przypadków umieść autora: [twój uchwyt Twittera] w pierwszej części dokumentu, na stronach z wieloma autorami. Jeśli potrzebujesz czegoś bardziej skomplikowanego, czytaj dalej.
Istnieje kilka sposobów przekazania informacji specyficznych dla autora. Informacje o autorze znajdują się w następującej kolejności:
- Obiekt autora, w przedniej części dokumentów, np .:
autor: twitter: benbalter
- Obiekt autora w _config.yml witryny, np .:
autor: twitter: benbalter
- site.data.authors [autor], jeśli autor jest określony w przedniej części dokumentu, a odpowiadający mu klucz istnieje w site.data.authors. Np. W przedniej części dokumentu masz następujące informacje:
autor: benbalter
I masz następujący wpis w _data / autorzy.yml:
benbalter: zdjęcie: /img/benbalter.png twitter: jekyllrb potus: zdjęcie: /img/potus.png twitter: whitehouse
W powyższym przykładzie uchwyt Twittera benbaltera autora zostanie przetłumaczony na @jekyllrb. Pozwala to na scentralizowanie informacji o autorze w jednym pliku _data / author dla witryny zawierającej wielu autorów, które wymagają czegoś więcej niż tylko nazwy użytkownika autora.
Pro-tip: Jeśli autorzy są obecni w przedniej części dokumentu jako tablica (a autor nie jest), wtyczka użyje pierwszego wymienionego autora, ponieważ Twitter obsługuje tylko jednego autora.
- Autor w pierwszej części dokumentu (najprostszy sposób), np .:
autor: benbalter
- Autor w _config.yml witryny, np .:
autor: benbalter
Dostosowywanie wyjścia JSON-LD
Dla każdej konkretnej strony można ustawić następujące opcje. Chociaż domyślne opcje mają służyć większości użytkowników w najczęstszych okolicznościach, mogą zaistnieć sytuacje, w których konieczna jest bardziej precyzyjna kontrola.
- seo
- name - Jeśli nazwa rzeczy, którą reprezentuje strona, różni się od tytułu strony. (tj .: „Frank's Café” vs „Welcome to Frank's Café”)
- type - rodzaj rzeczy reprezentowanych przez stronę. To musi być Schema.org typ i prawdopodobnie będzie to zazwyczaj coś takiego BlogPosting , Artykuł informacyjny , Osoba , Organizacja itd.
- links - Tablica innych adresów URL reprezentujących to samo, co ta strona reprezentuje. Na przykład strona bio Jane może zawierać linki do profili Jane GitHub i Twitter.
Dostosowywanie obrazu wyjściowego
Dla większości użytkowników ustawienie obrazu: [ścieżka do obrazu] na stronę powinno być wystarczające. Jeśli potrzebujesz większej kontroli nad sposobem prezentacji obrazów, właściwość obrazu może być również obiektem z następującymi opcjami:
- ścieżka - względna ścieżka do obrazu. Tak samo jak obrazek: [ścieżka do obrazu]
- height - Wysokość obrazu Open Graph (og: image)
- width - Szerokość obrazu Open Graph (og: image)
Możesz użyć dowolnej z powyższych, opcjonalnych właściwości, takich jak:
image: path: /img/twitter.png wysokość: 100 szerokość: 100
Ustawianie domyślnego obrazu
Możesz zdefiniować domyślny obraz za pomocą Domyślnie Front Matter , aby dostarczyć domyślną kartę Twitter lub obraz OGP do wszystkich Twoich postów i stron.
Oto bardzo prosty przykład: zachęcamy Cię do dostosowania się do swoich potrzeb:
defaults: - scope: path: "" values: image: /assets/images/default-card.png
Tytuły SmartyPants
Tytuły będą przetwarzane przy użyciu Inteligentny filtr Jekylla . Spowoduje to użycie SmartyPants do przetłumaczenia zwykłej interpunkcji ASCII na „inteligentną” interpunkcję typograficzną. Nie spowoduje to renderowania ani rozbierania żadnej marży, której możesz użyć w tytule strony.