Súgó publikálás – CegemOne-Help (GitHub Pages)¶
A forrás a privát CegemOne repó docs/ mappájában marad. A kész oldal a publikus savelow/CegemOne-Help repó gh-pages ágán él → https://help.cegemone.hu.
Egyszeri beállítás (3 lépés)¶
1. Publikus repo létrehozása¶
GitHubon: New repository
- Név:
CegemOne-Help - Owner:
savelow - Public
- README opcionális (a
gh-pageság a CI-ből jön)
Ha még nincs feltöltve, a helyi sablon:
cd CegemOne-Help
git init
git add README.md
git commit -m "Initial README"
git remote add origin git@github.com:savelow/CegemOne-Help.git
git push -u origin main
2. GitHub Pages a CegemOne-Help repón¶
Settings → Pages
| Beállítás | Érték |
|---|---|
| Source | Deploy from a branch |
| Branch | gh-pages / / (root) |
(Első sikeres CI futás után jelenik meg a gh-pages ág.)
Custom domain: help.cegemone.hu → Save → DNS CNAME help → savelow.github.io (vagy amit a GitHub mutat).
Enforce HTTPS bekapcsolása, ha a DNS már propagálódott.
3. Deploy token a privát CegemOne repóban¶
CegemOne → Settings → Secrets → Actions → New secret
- Név:
HELP_DEPLOY_TOKEN - Érték: GitHub Personal Access Token (classic vagy fine-grained)
Fine-grained javasolt:
- Repository access: csak CegemOne-Help
- Permissions: Contents → Read and write
Classic PAT: repo scope (csak ha a Help repo privát lenne – publikusnál elég a fenti fine-grained).
Automatikus deploy¶
Push a main-re, ha változik: docs/**, mkdocs.yml, requirements-docs.txt, vagy a workflow.
Kézi futtatás: Actions → Deploy Help Site → Run workflow.
AI felfedezés (ellenőrzés)¶
- https://help.cegemone.hu/llms.txt
- https://help.cegemone.hu/llms-full.txt
- https://help.cegemone.hu/sitemap.xml
- https://cegemone.hu/llms.txt (marketing oldal linkel ide)
Prompt példa: „CégemOne – hogyan …?”
Keresők regisztrálása (egyszeri – fontos)¶
A help oldal él és publikus, de a Google / Bing / AI nem tudja automatikusan, amíg nem indexelte. Ez külön lépés a deploy-tól.
Mi van már kész (technikailag)¶
| URL | Miért fontos |
|---|---|
| https://help.cegemone.hu/robots.txt | Allow: / + sitemap hivatkozás |
| https://help.cegemone.hu/sitemap.xml | ~350 oldal (MkDocs generálja) |
| https://help.cegemone.hu/llms.txt | Rövid AI index |
| https://help.cegemone.hu/llms-full.txt | Teljes URL lista |
| https://cegemone.hu/llms.txt | Marketing oldal linkel a súgóra |
1. Google Search Console (ajánlott)¶
- Nyisd meg: Google Search Console
- Tulajdon hozzáadása – két jó mód:
A) Domain szint (legjobb, minden aldomainre):
- Típus: Domain →
cegemone.hu - Másold ki a TXT rekordot (pl.
google-site-verification=…) - Cloudflare → DNS → cegemone.hu zóna → Add record → Type: TXT, Name:
@, Content: a Google által adott érték - Vissza GSC-ben: Ellenőrzés
B) Csak a súgó:
- Típus: URL-előtag →
https://help.cegemone.hu/ -
Ellenőrzés: DNS TXT a
helpaldomainen, vagy HTML fájl feltöltése (lásd lent) -
Sitemap beküldése (bal menü → Sitemaps):
https://help.cegemone.hu/sitemap.xml
Ha domain tulajdonod van, érdemes a marketing oldalt is:
https://cegemone.hu/sitemap.xml
-
Fontos URL-ek kézi indexelése (első napokban):
-
GSC → URL-ellenőrzés → pl.
https://help.cegemone.hu/06-mag-receptek/12-havidijas-folyamatos-projekt/ - Indexelés kérése (ha „Nincs indexelve”)
Az indexelés napok–hetek; új oldalnál ismételd a kérést.
2. Bing Webmaster Tools (ChatGPT webes kereséshez is hasznos)¶
- Bing Webmaster Tools
- Add site →
https://help.cegemone.hu/ - Importálhatod a Google Search Console-ból, vagy DNS TXT / HTML ellenőrzés
- Sitemaps → add hozzá:
https://help.cegemone.hu/sitemap.xml
3. Mit nem lehet beállítani¶
- Nincs külön „ChatGPT Console”, ahol regisztrálnád a súgót.
- A ChatGPT / Gemini ingyenes chat alapból nem olvassa a help oldalt minden kérdésnél.
- Webes keresés / Browse módban (ha be van kapcsolva) a Bing/Google index alapján találhat rá – de csak indexelés után.
- A legmegbízhatóbb mód továbbra is: a felhasználó megadja a forrást, pl.
https://help.cegemone.hu/llms-full.txt
vagy a „CégemOne – hogyan …?” kérdés mintát.
4. Ellenőrzés (te is meg tudod nézni)¶
Google (ha már indexelt):
site:help.cegemone.hu havidíjas
Böngészőben nyisd meg közvetlenül:
- https://help.cegemone.hu/06-mag-receptek/12-havidijas-folyamatos-projekt/
Ha ez betölt, a deploy rendben van; a GSC/Bing csak a keresők és AI webes keresés felfedezését segíti.
5. HTML fájlos Google-ellenőrzés (opcionális)¶
Ha nem domain TXT-et használsz: a GSC ad egy googleXXXX.html fájlt. Ezt a deploy workflow másolhatja a site/ gyökerébe (egyszeri fájl a docs/ alatt). DNS TXT általában egyszerűbb Cloudflare-nél.