Docusaurus

Sync do shuíomh doiciméadaíochta Docusaurus isteach i mbunachar eolais AI SmartTalk. Foghlaimeoidh do AI ó gach leathanach i do shíntíre—foirfe do bhóithre tacaíochta a fhreagraíonn ceisteanna teicniúla.

---

Forbhreathnú

Cuireann an comhtháthú Docusaurus ar chumas duit:

• Allmhairiú gach leathanach ó do shíntíre go huathoibríoch
• Coinnigh doiciméid comhoiriúnaithe nuair a fhoilsíonn tú nuashonruithe
• Freagair ceisteanna faoi do doiciméadachtaí go comhoibritheach
• Laghdaigh an t-ualach tacaíochta trí ligean don AI déileáil le ceisteanna coitianta

Fíric spraíúil: Úsáideann doiciméadachtaí AI SmartTalk féin Docusaurus, agus cuireann an comhtháthú seo tacaíocht dár chatbot tacaíochta!

---

Réamhchoinníollacha

Sula dtosaíonn tú, déan cinnte go bhfuil:

• Cuntas AI SmartTalk gníomhach
• Suíomh Docusaurus le sitemap.xml bailí
• Caithfidh do shuíomh a bheith inrochtana go poiblí (nó soláthar aitheantais)

---

Socrú Céim ar Céim

Céim 1: Faigh Do Shíntíre

Cruthaíonn Docusaurus síntíre go huathoibríoch. Faigh é ag:

https://your-docs-site.com/sitemap.xml

Déan cinnte go luchtóidh sé i do bhrabhsálaí agus go bhfuil do leathanacha doiciméadachta ann.

Céim 2: Cuir leis an gComhtháthú Docusaurus

1. Logáil isteach i do chuntas AI SmartTalk
2. Téigh chuig Socruithe → Comhtháthachtaí
3. Faigh Docusaurus agus cliceáil Conect
4. Cuir isteach URL do do shíntíre
5. Cliceáil Déan Dearbhú

Céim 3: Conairí Socruithe Allmhairiú

Tar éis dearbhaithe, socraigh do allmhairiú:

Socrú	Cur Síos
URL Síntíre	URL iomlán do do sitemap.xml
Patrún a Áireamh	Níor chóir ach leathanacha a shioncrónú a comhoibríonn le patrúin (roghnach)
Patrún a Eisiamh	Seachain leathanacha nó codanna ar leith (roghnach)

Céim 4: Tosaigh an tAllmhairiú

1. Cliceáil Allmhairiú Leathanach
2. Crawlfaidh AI SmartTalk gach URL i do shíntíre
3. Extractófar an t-ábhar agus cuirfear leis an mbunachar eolais
4. Fan go mbeidh an t-allmhairiú críochnaithe (tá dul chun cinn le feiceáil)

Céim 5: Déan Dearbhú ar an tAllmhairiú

1. Téigh chuig Eolas i AI SmartTalk
2. Ba chóir go mbeadh do leathanacha doiciméadachta le feiceáil
3. Tástáil do AI trí cheisteanna a chur faoi do doiciméadachtaí

---

Cad a Shioncrónítear

Ábhar	Conas a Próiseáiltear é
Teideal Leathanach	Úsáidtear mar aitheantóir doiciméad
Ábhar Leathanach	Téacs iomlán a extractófar ó HTML
Ceannteidil	Coimeádtar le haghaidh struchtúir
Bloic Chóid	Cuimsítear mar atá
Táblaí	Convertaíodh go formáid inléite
URLs	URL leathanach stóráilte le haghaidh tagartha

Extractú Ábhar

Extractóidh AI SmartTalk an príomhlimistéar ábhair agus déanfaidh sé neamhaird ar:

• Conairí nascleanúna
• Barraí taobh
• Bunáiteanna
• Scripts agus stíleanna

---

Iompar Sync

Iompór Láimhe

Cliceáil Iompór sna socruithe comhoibrithe chun:

• An sitemap is déanaí a fháil
• Leathanaigh nua a chur leis
• Leathanaigh a d'athraigh a nuashonrú
• Leathanaigh a scriosadh

Coinneáil Doiciméid Nua

Chun doiciméid atá i gcónaí reatha a choinneáil:

1. Athnuachan láimhe: Cliceáil Iompór tar éis nuashonruithe a fhoilsiú
2. Sync sceidealaithe: Úsáid SmartFlow chun iompórtálacha a uathoibriú

Iompór Sceidealaithe SmartFlow

Workflow: Docusaurus Auto-Sync
Trigger: Scheduled (Daily at 3:00 AM)
Actions:
  - Sync Connector:
      Type: Docusaurus
      Sitemap: https://docs.example.com/sitemap.xml

---

Patrógaí URL

Patrógaí a Áireamh

Níl ach roinnt codanna áirithe a shyncáil:

Patrón	Éifeacht
/docs/api/*	Doiciméadú API amháin
/docs/guides/*	Rannóg treoracha amháin
/blog/*	Postanna blag amháin

Patrógaí a Eisiamh

Skoip leathanach áirithe:

Patrón	Éifeacht
/docs/internal/*	Skoip doiciméid inmheánacha
/changelog	Skoip leathanach changelog
*/draft-*	Skoip leathanacha dréachta

---

Cásanna Úsáide

Bot Tacaíochta Teicniúil

Sync do doiciméid táirgí:

• "Conas a shuiteáilim an SDK?"
• "Cad iad na teorainneacha ráta API?"
• "Taispeáin dom sampla de fhíorú"

Doiciméadú Forbróirí

Sync tagarmhairc agus treoracha API:

• "Cad iad na paraiméadair a ghlacann an pointe /users?"
• "Conas a láimhseáilim webhooks?"
• "Cad é an difríocht idir API v1 agus v2?"

Bunachar Eolais Inmheánach

Sync wikis agus nósanna imeachta na cuideachta:

• "Cad é an próiseas chun PTO a iarraidh?"
• "Conas a leagaim mo thimpeallacht forbartha?"
• "Cá háit a bhfaighidh mé na treoirlínte branda?"

---

Réiteach Fadhbanna

Fadhbanna Sitemap

Fadhb	Réiteach
"Sitemap neamhbhailí"	Déan cinnte go dtuigeann an URL XML bailí
"Níl leathanach ar fáil"	Seiceáil an bhfuil iontrálacha <url> sa sitemap
"Rochtain diúltaithe"	Déan cinnte go bhfuil an sitemap inrochtana go poiblí

Fadhbanna Iompórtála

Fadhb	Réiteach
Leathanaigh ar iarraidh	Seiceáil na patrógaí a áireamh/eisiamh
Iompórta gafa	Tógann suíomhanna móra am; fan nó iompórtáil i grúpaí
Ábhar sean	Ath-iompórta chun na leaganacha is déanaí a fháil

Cáilíocht Ábhair

Fadhb	Réiteach
Ábhar mícheart a bhaint	Tuairiscigh an fhadhb—d'fhéadfadh go mbeadh gá le baint as
Bloic chód ar iarraidh	Déan cinnte go bhfuil an cód i gclónna caighdeánacha <pre><code>
Téacs míshocraithe	Seiceáil códúcháin an leathanach (UTF-8 molta)

---

Bainistíocht an Comhoibrithe

Gníomh	Conas
Ath-iompórtaigh gach rud	Cliceáil Iompór sna socruithe comhoibrithe
Athraigh sitemap	Nuashonraigh an URL agus ath-iompórtaigh
Bain ábhar	Déan an comhoibriú a dhícheangal nó scrios ó Eolas
Dícheangal	Socruithe → Comhoibrithe → Docusaurus → Dícheangal

---

Cleachtais is Fearr

1. Ábhar cáilíochta: Doiciméid a scríobhadh go maith = freagraí AI níos fearr
2. Struchtúr soiléir: Úsáid teidil, liostaí, agus táblaí
3. Teidil tuairisciúla: Cabhraíonn teidil leathanach le AI tuiscint a fháil ar an gcomhthéacs
4. Comhoibriú rialta: Coinnigh AI nuashonraithe leis an doiciméadacht is déanaí
5. Tástáil go hiomlán: Iarr ceisteanna coitianta chun cruinneas AI a fhíorú

---

Leideanna Configuraíochta Docusaurus

Optimigh le haghaidh Tógála AI

I do docusaurus.config.js:

module.exports = {
  // Ensure sitemap is generated
  plugins: ['@docusaurus/plugin-sitemap'],
  
  // Use descriptive page titles
  title: 'Your Product Docs',
  
  // Include metadata
  themeConfig: {
    metadata: [{
      name: 'description',
      content: 'Documentation for Your Product'
    }],
  },
};

Eisceachtaí a dhéanamh ar Leathanaigh ón Sitemap

Chun cosc a chur ar leathanach áirithe ó bheith comhoibrithe:

// In page frontmatter
---
title: Internal Page
sitemap:
  exclude: true
---

---

Doiciméadacht Gaolmhar

• Forbhreathnú ar Chomhoibrithe
• Bainistíocht Bunachar Eolais
• Comhoibriú le RSS Feed — Do ábhar blag/nótaí
• Tosaíochtaí Sceidealaithe SmartFlow — Uathoibriú allmhairí