doiciméid a aistriú ag baint úsáide as Sphinx¶
Is uirlis é Sphinx chun doiciméadú álainn a chruthú. Úsáideann sé comhréir shimplí reStructuredText agus féadann sé aschur a ghiniúint i go leor formáidí. Má tá sampla á lorg agat, tógtar an doiciméadú seo agus é á úsáid freisin. Is é an compánach an-úsáideach chun Sphinx a úsáid ná an tseirbhís Read the Docs, a dhéanfaidh do dhoiciméadú a thógáil agus a fhoilsiú saor in aisce.
Ní dhíreoidh mé ar dhoiciméadú a scríobh é féin, má tá treoir uait leis sin, lean na treoracha ar shuíomh Gréasáin Sphinx. Nuair a bheidh na doiciméid réidh agat, tá sé éasca go leor é a aistriú mar go dtacaíonn Sphinx leis seo agus tá sé clúdaithe go maith ina Internationalization. Is beag treoracha cumraíochta atá ann agus an uirlis sphinx-intl á agairt.
Má tá tú ag baint úsáide as an tseirbhís Léigh na Doiciméid, is féidir leat tosú ag tógáil doiciméadú aistrithe ar an Léigh na Doiciméid. Clúdaíonn a Localization and Internationalization beagnach gach rud atá uait - tionscadal eile a chruthú, a theanga a shocrú agus é a nascadh ón bpríomhthionscadal mar aistriúchán.
Anois níl uait ach an t-ábhar doiciméadaithe a aistriú. Gineann Sphinx comhad PO do gach eolaire nó comhad barrleibhéil, rud a d'fhéadfadh go mbeadh go leor comhaid le haistriú (ag brath ar gettext_compact socruithe). Is féidir leat an index.po a iompórtáil isteach i Weblate mar chomhpháirt tosaigh agus ansin an breiseán Fionnachtain Comhpháirte a chumrú chun gach ceann eile a fháil amach go huathoibríoch.
|
|
|
|
|
|
comhad PO gettext |
|
|
slonn rialta chun comhaid aistriúcháin a mheaitseáil le |
|
Saincheap ainm an chomhpháirt |
|
Sainmhínigh an bunchomhad le haghaidh aistriúcháin nua |
|
Hint
Arbh fhearr leat Sphinx gan ach comhad PO amháin a ghiniúint? Ós rud é Sphinx 3.3.0 is féidir leat é seo a bhaint amach ag baint úsáide as:
gettext_compact = "docs"
Is féidir leat teacht ar roinnt tionscadal doiciméadúcháin á n-aistriú ag baint úsáide as an gcur chuige seo:
Doiciméadúchán gréasáin (tá sé á léamh agat anois)