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éadacht féin a scríobh, más gá treoir duit leis sin, lean na treoracha ar shuíomh gréasáin Sphinx. Nuair a bheidh an doiciméadacht réidh agat, is furasta go leor í a aistriú mar go dtagann tacaíocht leis seo le Sphinx agus tá sé clúdaithe go deas ina Internationalization. Is ceist cúpla treoir chumraíochta agus an uirlis sphinx-intl atá ann.

Más seirbhís Léigh na Doiciméid atá in úsáid agat, is féidir leat tosú ag tógáil doiciméad aistrithe ar Léigh na Doiciméid. Clúdaíonn a Localization and Internationalization beagnach gach rud a theastaíonn uait - tionscadal eile a chruthú, a theanga a shocrú, agus é a nascadh ón bpríomhthionscadal mar aistriúchán.

Anois níl le déanamh agat ach ábhar an doiciméid a aistriú. Gineann Sphinx comhad PO do gach eolaire nó comhad barrleibhéil, rud a d’fhéadfadh a bheith ina chúis le go leor comhad le haistriú (ag brath ar shocruithe gettext_compact). Is féidir leat an index.po a allmhairiú isteach i Weblate mar chomhpháirt tosaigh agus ansin an breiseán Fionnachtain Comhpháirte a chumrú chun na comhaid eile go léir a aimsiú go huathoibríoch.

Cumraíocht na Comhpháirte

Ainm an chomhpháirte

Documentation

Masc comhaid

docs/locales/*/LC_MESSAGES/index.po

Teimpléad le haghaidh aistriúcháin nua

docs/locales/index.pot

Formáid comhaid

comhad PO gettext

Bratacha aistriúcháin

rst-text
Cumraíocht fionnachtana Comhpháirte

slonn rialta chun comhaid aistriúcháin a mheaitseáil le

docs/locales/(?P<language>[^/.]*)/LC_MESSAGES/(?P<component>[^/]*)\.po

Saincheap ainm an chomhpháirt

Documentation: {{ component|title }}

Sainmhínigh an bunchomhad le haghaidh aistriúcháin nua

docs/locales/{{ component }}.pot

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: