hexo-submit-urls-to-search-engine: Dokumentace k pluginu

Úvod

Po použití pluginu hexo-submit-urls-to-search-engine v Hexu můžete aktivně odesílat nové odkazy na blogu Hexo na platformy pro webmastery vyhledávačů Google, Bing a Baidu, abyste zlepšili kvalitu a rychlost indexování webových stránek. Tento plugin vám umožňuje odesílat požadavky na indexování čistě přírodními, rostlinami krmenými vyhledávačům, jednou provždy.

Například, můj článek je někdy dohledatelný na Bingu do 5 minut po zveřejnění (to je nejlepší případ, nezaručuje se dlouhodobá stabilita). Vidíte, to je síla hexo-submit-urls-to-search-engine. Baidu a Google jsou o něco pomalejší.

Tři hlavní vyhledávače již zaujímají 97 % celosvětového trhu s vyhledávači (včetně metavyhledávačů Dogpile, Duckduckgo atd.; Yahoo a Ecosia používají index Bing).

Upozornění

Neodborné používání jiného podobného kódu pro odesílání může vést k nebezpečným vedlejším účinkům, včetně, ale nejen, bezpečnostních nedostatků, nadbytečného kódu, znovuobjevování kola, nutnosti číst dokumentaci, pochybností o životě, depresí, bolestí hlavy a dokonce smrti, rozpadu duše a zániku.

Adresa Github

Oficiální komunikační skupina QQ a skupina Telegram již nejsou v provozu. Pro diskuzi prosím přejděte na stránku Github issue.

Kroky operace

Rychlý start:

Získejte klíče od jednotlivých platforem pro webmastery
Nainstalujte a nakonfigurujte plugin hexo-submit-urls-to-search-engine
hexo clean && hexo g && hexo d a ověřte výsledky odeslání
Pokud je odeslání úspěšné, přejděte na adresu Github a kliknutím na tlačítko Star podpořte projekt
Mimochodem, sledujte projekt na Githubu, abyste dostávali upozornění na aktualizace pluginu
Můžete také kliknout sem a darovat

Získání klíčů platforem pro webmastery

Všechny „zaznamenané“ klíče v této části se vyplňují do _config.yml Hexo, formát je uveden dále.

O ověření webové stránky: Některá témata Hexo podporují přidání ověřovacích HTML tagů platformy pro webmastery, po vyplnění relevantních nastavení stačí hexo g && hexo d pro ověření. Podrobný obecný postup si prosím sami vyhledejte na Googlu: hexo platforma pro webmastery ověření

Baidu

Baidu je čínský vyhledávač. Pokud si v Číně nevyřídíte složité formality pro registraci webových stránek, bude obtížné webovou stránku indexovat.

Pokud se váš webový server nachází mimo Čínu, je téměř nemožné vyřídit si registraci webových stránek.

Podívejte se na starou dokumentaci, kde se dozvíte, jak odeslat odkazy na Baidu

Bing

Platforma pro webmastery Bingu se dělí na novou a starou.

Zaregistrujte se a přihlaste se do nové platformy pro webmastery Bingu Nástroje pro webmastery Bing
Přidejte web
Vstupte na stránku správy webu, nastavení, přístup k API, klíč API, poznamenejte si klíč API

Získání klíče API z nové platformy pro webmastery Bingu

~~(Nedávno byla platforma pro webmastery Bing aktualizována a server a vzhled jsou nestabilní, pokud se token nezobrazí, zkuste to znovu za nějakou dobu)~~ Nyní byla aktualizována na novou platformu pro webmastery.

Toto je schematický diagram získaný ze staré platformy pro webmastery Bingu:

Získání klíče API správce webu Bingu ze staré platformy pro webmastery Bingu

Google

Pokud se váš server nachází v Číně, mějte na paměti, že váš server musí mít přístup k mezinárodnímu internetu, aby bylo možné provádět odesílání do Googlu.

Platforma pro webmastery Google se také dělí na starou a novou, ale vztah mezi nimi není tak dobře vyřešen jako u Bingu. Kromě toho Google Indexing API, které používáme, není poskytováno platformou pro webmastery, ale patří do platformy pro vývojáře Google. Během procesu si můžete pro konfiguraci přečíst oficiální dokumentaci (dostupnou v pevninské Číně).

Kroky použití:

Otevřete oficiální dokumentaci a podle pokynů vytvořte projekt a účet služby. Stačí podle pokynů provést konfigurační operace na webových stránkách, není nutné provádět následné operace, jako je získání přístupového tokenu.
Pouhé přidání e-mailové adresy oprávnění v novém „Vyhledávacím konzoli“ Google podle oficiální dokumentace Google vám stále zobrazí „Nemáte oprávnění“. Přejděte prosím do starého nástroje pro webmastery, klikněte na svůj web a přidejte e-mailovou adresu do něj. Nyní stačí odeslat přímo v nové platformě pro webmastery.
Umístěte získaný soubor JSON s klíčem do kořenového adresáře Hexo (stejné místo jako soubor _config.yml Hexo)

Starý nástroj pro webmastery Google:

Kromě toho je v oficiální dokumentaci následující upozornění, rozhodněte se prosím, zda aktivujete funkci odesílání odkazů do Googlu podle skutečné situace:

V současné době lze Indexing API použít pouze pro procházení webových stránek, které obsahují JobPosting nebo BroadcastEvent (vnořený v VideoObject). Pro webové stránky, které obsahují mnoho krátkodobých webových stránek (například informace o pracovních nabídkách nebo živá videa), Indexing API udržuje obsah ve výsledcích vyhledávání aktuální tím, že odesílá aktualizace pro různý obsah samostatně.

Rychlý start s Indexing API | Centrum vyhledávání Google | Google pro vývojáře

Já jsem to každopádně odeslal. Jak má Google procházet webové stránky a vědět, že vaše webová stránka neobsahuje informace o pracovních nabídkách nebo živá videa? Když už ji prohledal, i když nenašel informace o pracovních nabídkách nebo živá videa, jaký by byl důvod plýtvat zdroji a vyhazovat již prohledané informace? Když už je používáme, dosáhli jsme svého cíle. Při skutečném používání se zdá, že Google za to nestanovil žádný downgrade. Možná Google zapomněl aktualizovat dokument? V současné době jsem v této dokumentaci našel dvě závažné chyby, které nebyly roky opraveny.

Konfigurace Hexo

Instalace tohoto pluginu

Spusťte jej v kořenovém adresáři Hexo:

Samozřejmě je rychlejší stahování pomocí cnpm v oblasti Velké Číny

npm install --save hexo-submit-urls-to-search-engine

Tento plugin také podporuje instalaci yarn:

yarn add hexo-submit-urls-to-search-engine

Úprava _config.yml Hexo

hexo-submit-urls-to-search-engine

Nakonfigurujte plugin hexo-submit-urls-to-search-engine a vložte níže uvedené do _config.yml Hexo.

Tip

Samozřejmě můžete použít proměnné prostředí k nastavení záznamu klíčů, takže i když je zdrojový kód umístěn ve veřejném úložišti, nedojde k úniku klíčů.

hexo_submit_urls_to_search_engine:
  submit_condition: count # Podmínka pro odeslání odkazů, volitelné hodnoty: count | period Podporuje pouze count
  count: 10 # Odeslat nejnovějších 10 odkazů
  period: 900 # Odeslat odkazy, jejichž čas úpravy je kratší než 900 sekund
  google: 0 # Odeslat do Google, volitelné hodnoty: 1 | 0 (0: Ne; 1: Ano)
  bing: 1 # Odeslat do Bingu, volitelné hodnoty: 1 | 0 (0: Ne; 1: Ano)
  baidu: 1 # Odeslat do Baidu, volitelné hodnoty: 1 | 0 (0: Ne; 1: Ano)
  txt_path: submit_urls.txt ## Název textového dokumentu, do tohoto textového dokumentu se uloží odkazy, které se mají odeslat
  baidu_host: https://cjh0613.github.io ## Doména registrovaná na platformě Baidu pro webmastery
  baidu_token: Postupujte podle pokynů v dokumentaci a získejte ## Pamatujte, že toto je váš klíč, proto jej prosím nezveřejňujte přímo ve veřejném úložišti!
  bing_host: https://cjh0613.github.io ## Doména registrovaná na platformě Bing pro webmastery
  bing_enable_indexnow: false # Zda odeslat odkaz do Bingu pomocí indexNow: true (Ano) | false (Ne). Tuto funkci lze povolit pouze u verzí 2.1.1 a vyšších.
  bing_token: Postupujte podle pokynů v dokumentaci a získejte ## Pamatujte, že toto je váš klíč, proto jej prosím nezveřejňujte přímo ve veřejném úložišti!
  google_host: https://cjh0613.github.io ## Doména registrovaná na platformě Google pro webmastery
  google_key_file: Project.json # Soubor JSON, který obsahuje klíč Google, umístěte jej do kořenového adresáře webu (stejné místo jako soubor _config.yml Hexo), nezveřejňujte obsah souboru JSON přímo ve veřejném úložišti!
  google_proxy: http://127.0.0.1:8080 # Systémové HTTP proxy používané pro odesílání adres URL do Google, zadejte 0, aby se nepoužívalo
  replace: 0  # Zda nahradit část řetězce v odkazech, volitelné hodnoty: 1 | 0 (0: Ne; 1: Ano)
  find_what: http://cjh0613.github.io/blog
  replace_with: https://cjh0613.com

Důsledky zveřejnění klíče

Vaši „nepřátelé“, umělá inteligence s vlastním uvědoměním, teroristé mohou pomocí vašeho klíče odesílat odkazy na neexistující stránky vyhledávačům. Nejenže vyčerpají vaši kvótu a znemožní vám normální odesílání, ale také sníží váhu webu z důvodu odeslání nefunkčních odkazů

Poznámky

submit_condition: Podporuje dva způsoby určení, zda odeslat odkaz, tj. count | period. Použijte konfigurační položky count | period níže
period: Časový interval, v sekundách, pokud je rozdíl mezi časem aktualizace článku a časem spuštění tohoto pluginu menší než tato hodnota, bude odeslán jeho odkaz. Například: existují dva soubory a.html a b.html, které odpovídají https://yoursite.com/a.html a https://yoursite.com/b.html. Rozdíl mezi jejich časem aktualizace a časem spuštění tohoto pluginu je 800 s a 1000 s (pole period je nastaveno na 900), pak bude odesláno https://yoursite.com/a.html a https://yoursite.com/b.html nebude odesláno
google_proxy: Systémové HTTP proxy používané pro odesílání adres URL do Google, formát: http://proxyhost:port, stačí upravit proxyhost a port; Pokud je Hexo nasazen mimo zemi, můžete zadat 0, aby se nepoužívalo. Pokud používáte software pro vědecké procházení internetu, proxyhost je obvykle 127.0.0.1 a port lze zobrazit v nastavení softwaru, obvykle 8080. Ve Windows 10 můžete zkontrolovat v Nastavení -> Proxy
replace: Některé odkazy nemusí být vygenerovány správně (například doména v čínštině, domovská stránka se nachází v http://cjh0613.github.io/blog a podobně). Jedná se o jednoduchou a hrubou funkci nahrazení, která nahradí určený řetězec ve všech vygenerovaných odkazech. V příkladu se http://cjh0613.github.io/blog nahradí za https://cjh0613.com. Můžete také nahradit doménu v čínštině za doménu po transkódování.

Aktualizace poznámek této části 12. 7. 2020, děkuji liuyib za návrh Přidáno google_proxy 12. 5. 2021

Po dokončení výše uvedené konfigurace se při spuštění příkazu hexo generate v kořenovém adresáři Hexo vygeneruje soubor .txt pro uložení odkazů, které mají být odeslány.

Můžete otevřít tento soubor a zkontrolovat, zda jsou odkazy správné, pokud nejsou správné, přejděte prosím do _config.yml Hexo a nakonfigurujte je. Můžete také ručně upravit tento soubor .txt před odesláním odkazů.

deploy

Pokud jste dříve nepřidali konfigurační položku deploy:, stačí vložit níže uvedené do _config.yml Hexo a přepsat výchozí konfigurační položku deploy:.

deploy:
- type: cjh_google_url_submitter
- type: cjh_bing_url_submitter
- type: cjh_baidu_url_submitter

Po dokončení tohoto kroku můžete při spuštění příkazu hexo deploy automaticky odesílat odkazy do vyhledávačů.

Pro spuštění odeslání musíte spustit příkaz hexo deploy nebo hexo d, ať už jste tento příkaz pro nasazení použili dříve nebo ne.

Předtím samozřejmě musíte spustit hexo generate pro vygenerování nejnovějšího souboru .txt pro uložení odkazů, které se mají odeslat.

Pokud můžete úspěšně odeslat, prosím, podpořte to hvězdičkou v úložišti Github , děkuji!

Pokud jste již nastavili konfigurační položku deploy:, přímé vložení výše uvedeného bloku kódu zobrazí konflikt konfigurace, stačí přidat přímo do stávající konfigurační položky deploy:. Například:

deploy:
- type: git
  repo: 
    coding: git@xxx
  branch: master 
  
  #Přidání konfigurační položky tohoto pluginu:
- type: cjh_google_url_submitter
- type: cjh_bing_url_submitter
- type: cjh_baidu_url_submitter

Poznámka: Před každým type: výše je -

Podpora kontinuální integrace

Tato část poskytuje referenci pro způsob nasazení, kdy je Hexo uložen ve veřejném úložišti a je kompilován a publikován pomocí CI (Continuous Integration, například Github action, travis, coding-ci, netlify atd.).

Baidu a Bing mohou používat proměnné prostředí k zaznamenávání klíčů, Google má jiná řešení, viz níže

Upozorňujeme, že pokud používáte automatické nasazení CI, musíte do Front-matter (oblast oddělená --- v horní části souboru .md, která se používá k určení proměnných jednotlivých souborů) každé stránky přidat updated:, abyste Hexu sdělili, aby opravil „čas poslední úpravy článku“, například:

---
title: Hello World
date: 2013/7/13 20:46:25
updated: 2020-08-25 9:36:00
---

Je tomu tak proto, že když jsou soubory umístěny v místním počítači, pokud není zadáno updated:, Hexo načte atributy souboru a použije „čas poslední úpravy souboru“ jako „čas poslední úpravy článku“, může správně posoudit a odeslat 10 nejnovějších odkazů; a při automatickém nasazení CI, protože zdroje Hexo byly právě naklonovány na server, pokud není přidáno updated:, Hexo také načte atributy souboru, ale v tomto okamžiku je čas poslední úpravy atributů stejný jako čas git clone, Hexo získá nesprávný „čas poslední úpravy článku“ a nemůže správně posoudit a odeslat nejnovější odkazy.

Nejprve vyplňte 0 do konfiguračních položek baidu_token: a bing_token: v hexo_submit_urls_to_search_engine:
Nastavte proměnné prostředí BAIDU_TOKEN, BING_TOKEN a jejich hodnoty jako získané tokeny
Pokud používáte Github Action, musíte také nastavit proměnné prostředí v souboru yml, příklad je uveden níže
hexo clean && hexo generate && hexo deploy a užívejte si života

Reference:

hexo_submit_urls_to_search_engine:
  submit_condition: count # Podmínka pro odeslání odkazů, volitelné hodnoty: count | period Podporuje pouze count
  count: 10 # Odeslat nejnovějších 10 odkazů
  period: 900 # Odeslat odkazy, jejichž čas úpravy je kratší než 900 sekund
  google: 1 # Odeslat do Google, volitelné hodnoty: 1 | 0 (0: Ne; 1: Ano)
  bing: 1 # Odeslat do Bingu, volitelné hodnoty: 1 | 0 (0: Ne; 1: Ano)
  baidu: 1 # Odeslat do Baidu, volitelné hodnoty: 1 | 0 (0: Ne; 1: Ano)
  txt_path: submit_urls.txt ## Název textového dokumentu, do tohoto textového dokumentu se uloží odkazy, které se mají odeslat
  baidu_host: https://en.cjh0613.com ## Doména registrovaná na platformě Baidu pro webmastery
  baidu_token: 0 ## Pamatujte, že toto je váš klíč, proto jej prosím nezveřejňujte přímo ve veřejném úložišti!
  bing_host: https://en.cjh0613.com ## Doména registrovaná na platformě Bing pro webmastery
  bing_token: 0 ## Pamatujte, že toto je váš klíč, proto jej prosím nezveřejňujte přímo ve veřejném úložišti!
  google_host: https://en.cjh0613.com ## Doména registrovaná na platformě Google pro webmastery
  google_key_file: Project.json # Soubor JSON, který obsahuje klíč Google, umístěte jej do kořenového adresáře webu (stejné místo jako soubor _config.yml Hexo), nezveřejňujte obsah souboru JSON přímo ve veřejném úložišti!
  google_proxy: 0 # Systémové HTTP proxy používané pro odesílání adres URL do Google, zadejte 0, aby se nepoužívalo
  replace: 0  # Zda nahradit část řetězce v odkazech, volitelné hodnoty: 1 | 0 (0: Ne; 1: Ano)
  find_what: http://cjh0613.github.io/blog
  replace_with: https://cjh0613.com

Github Action, musíte také nastavit proměnné prostředí v souboru yml:

- name: xxxx # Vyplňte libovolně
  env:
    BAIDU_TOKEN: ${{ secrets.BAIDU_TOKEN }} # Všimněte si zde, všechno ostatní je nepodstatné
    BING_TOKEN: ${{ secrets.BING_TOKEN }} # Všimněte si zde, všechno ostatní je nepodstatné
  run: |
    npm i -g hexo-cli # Instalace hexo
    npm i
    ……
    hexo deploy

Co se týče odesílání odkazů do Googlu, je v souboru klíče json tolik informací, kopírování a vkládání a nastavování proměnných prostředí… je to opravdu obtížné. Soubor klíče json jsem umístil do soukromého úložiště, pak jsem jej naklonoval a zkopíroval do kořenového adresáře.

Aktualizace pluginu

Připomenutí aktualizace pluginu

Po instalaci tohoto pluginu prosím sledujte tento projekt na Github , abyste získali připomenutí aktualizací pluginu (vyberte Pouze verze pro získání pouze připomenutí aktualizací, výběrem možnosti Sledování budete také dostávat Issues, Pull requests atd., odesílané e-mailem)

Postup aktualizace

Spusťte jej v kořenovém adresáři Hexo:

Samozřejmě je rychlejší stahování pomocí cnpm v oblasti Velké Číny

npm install --save hexo-submit-urls-to-search-engine@verze

Dříve jsem uvedl jiný příkaz: npm update --save hexo-submit-urls-to-search-engine, ale během mého testování se objevily problémy.

Aktualizace pomocí yarn:

yarn add hexo-submit-urls-to-search-engine@verze

Nezávislá aktualizace

Upozornění

Někdy aktualizace pluginu není zpětně kompatibilní a může být nutné upravit konfigurační položky související s tímto pluginem v _config.yml Hexo nebo provést další úpravy. Tato situace se obvykle vyskytuje, když se první číslice před první desetinnou čárkou v čísle verze zvýší. Například ^1.0.0 se aktualizuje na ^2.0.0.

Aktualizace z 1.x.x na 2.x.x:

Musíte přidat následující tři konfigurační položky do konfigurační položky hexo_submit_urls_to_search_engine::

  replace: 0  # Zda nahradit část řetězce v odkazech, volitelné hodnoty: 1 | 0 (0: Ne; 1: Ano)
  find_what: http://cjh0613.github.io/blog
  replace_with: https://cjh0613.com

Dobře, zjistil jsem, že tato aktualizace je zpětně kompatibilní, i když tyto tři konfigurační položky nejsou, nevyvolá to chybu…

Informace o návratu

Úspěšné informace o odeslání

Bing

Odpověď Bingu:  { d: null }

Google

Odpověď Google:  { urlNotificationMetadata:
   { url:
      'https://cjh0613.github.io',
     latestUpdate:
      { url:
         'https://cjh0613.github.io',
        type: 'URL_UPDATED',
        notifyTime: '2020-06-12T05:37:25.701779228Z' } } }

Jiné

Další odpovědi naleznete v jejich oficiální dokumentaci, ale obvykle, když se odpověď přeloží, dozvíte se důvod.

Někdy je to proto, že vyhledávače umožňují odeslat pouze určitý počet odkazů denně. Můžete se přihlásit na jejich oficiální webové stránky a zeptat se. Poté, co se doména mého webu cjh0613.github.io změnila na cjh0613.com, se kvóta Bingu změnila z 10 na 10 000 po 10 dnech nepřetržitého odesílání.

Pokud odeslání některých odkazů selže, zpracujte je prosím ručně: podle zpětné vazby upravte soubor txt, který obsahuje odkazy k odeslání (obvykle odstraňte odkazy, které byly úspěšně odeslány), a poté spusťte pouze hexo deploy pro opětovné odeslání, není třeba znovu generovat web.

Pokud chcete odesílat odkazy do vyhledávačů každý den, stačí spustit hexo d každý den, nebo můžete nastavit, aby Github Action spouštěl hexo g && hexo d každý den, není třeba znovu vynalézat kolo.

Zobrazení výsledků

Zobrazení indexu

Jako příklad zobrazení indexu tohoto webu otevřete libovolný vyhledávač a zadejte site:doména, zde tj.:

site:cjh0613.github.io

Hledejte.

Může trvat dlouho, než se index nového webu změní z 0 na 1, možná měsíc… buďte prosím trpěliví.

Skutečná rychlost indexování také souvisí s dalšími faktory, existuje spousta online materiálů SEO, ale všechny jsou založeny na oficiálních vysvětleních.

Zobrazení historie odesílání

Bing

Podrobný seznam odeslaných odkazů (aktualizovaný v reálném čase) naleznete po přihlášení do nové platformy pro webmastery Bingu:

https://www.bing.com/webmasters/submiturl?siteUrl=odkaz_na_váš_web

Historie odesílání Bingu a dotaz na zbývající kvótu

Google

Pouze v tabulce „Chyby“ na níže uvedené adrese můžete vidět kumulativní počet odeslaných odkazů a procento neúspěšných odeslání v daném časovém období (maximálně za posledních 30 dní) (aktualizováno v reálném čase), i když je uveden graf dat odeslaných za den, ale je to jako by nic nedával…

https://console.developers.google.com/apis/api/indexing.googleapis.com/metrics?project=

Dotaz na počet odeslaných odkazů do Google

Referenční materiály, které jsem použil při vývoji tohoto pluginu

Podívejte se na starou dokumentaci

Úvod#

Kroky operace#

Získání klíčů platforem pro webmastery#

Baidu#

Bing#

Google#

Konfigurace Hexo#

Instalace tohoto pluginu#

Úprava _config.yml Hexo#

hexo-submit-urls-to-search-engine#

deploy#

Podpora kontinuální integrace#

Aktualizace pluginu#

Připomenutí aktualizace pluginu#

Postup aktualizace#

Nezávislá aktualizace#

Informace o návratu#

Úspěšné informace o odeslání#

Bing#

Google#

Jiné#

Zobrazení výsledků#

Zobrazení indexu#

Zobrazení historie odesílání#

Bing#

Google#

Referenční materiály, které jsem použil při vývoji tohoto pluginu#

Úvod

Kroky operace

Získání klíčů platforem pro webmastery

Baidu

Bing

Google

Konfigurace Hexo

Instalace tohoto pluginu

Úprava _config.yml Hexo

hexo-submit-urls-to-search-engine

deploy

Podpora kontinuální integrace

Aktualizace pluginu

Připomenutí aktualizace pluginu

Postup aktualizace

Nezávislá aktualizace

Informace o návratu

Úspěšné informace o odeslání

Bing

Google

Jiné

Zobrazení výsledků

Zobrazení indexu

Zobrazení historie odesílání

Bing

Google

Referenční materiály, které jsem použil při vývoji tohoto pluginu