Imscaradh Agus Ar Líne

i18n.site glacann sé ailtireacht feidhmchláir aon leathanach , agus déantar leathanach iontrála an tsuímh Ghréasáin agus ábhar an tsuímh Ghréasáin a imscaradh go neamhspleách.

Tar éis an t-aistriúchán thuas a rith, ginfear eolairí htm agus v faoin eolaire md/out/dev .

Anseo, ciallaíonn dev go bhfuil sé tógtha bunaithe ar an gcomhad cumraíochta .i18n/htm/dev.yml .

dev eolaire :

Is é an t-eolaire htm ná leathanach iontrála an tsuímh Ghréasáin.

Tá ábhar an tsuímh Ghréasáin le huimhreacha leagan san eolaire v .

Is cuma le réamhamharc áitiúil faoin uimhir leagain agus déanfaidh sé gach comhad a chóipeáil chuig an eolaire out/dev/v/0.1.0 .

Le haghaidh eisiúint oifigiúil, déanfar comhaid athraithe a chóipeáil chuig an eolaire uimhreacha leagan nua.

Sonraigh an Comhad Cumraíochta Le -c

Cruthóidh comhaid chumraíochta éagsúla eolairí comhfhreagracha san eolaire out .

Mar shampla, cruthóidh .i18n/htm/main.yml an t-eolaire out/main .

Is iad dev.yml agus main.yml na cumraíochtaí réamhshocraithe.

Is é dev an giorrúchán de development , a léiríonn an timpeallacht forbartha, a úsáidtear le haghaidh réamhamharc áitiúil, agus is é an comhad cumraíochta réamhshocraithe é freisin. Is é ol an giorrúchán de online , rud a léiríonn an timpeallacht ar líne, a úsáidtear le haghaidh scaoileadh oifigiúil Is é freisin an comhad cumraíochta réamhshocraithe nuair a úsáidtear paraiméadair na n-orduithe -n go npm le scaoileadh.

Is féidir leat comhaid cumraíochta eile a chruthú freisin Úsáid --htm_conf ar an líne ordaithe chun ainm an chomhaid chumraíochta a shonrú:

mar shampla:

i18n.site --htm_conf dist --save

Seo --save seasann an uimhir leagain eisiúna nuashonraithe.

Foilsigh ábhar chuig npmjs.com

Is é an réiteach réamhshocraithe npmjs.com ábhar a fhoilsiú (féach Ard-Infhaighteacht ag an gceann tosaigh ).

npm Logáil Isteach & Post

Suiteáil nodejs , logáil isteach le npm login .

Cuir md/.i18n/htm/main.yml in eagar agus athraigh luach md: YOUR_NPM_PACKAGE npmjs.com ainm do npm phacáiste féin.

Ansin modhnaigh md/.i18n/htm/main.package.json

Rith i18n.site --npm nó i18n.site -n san eolaire md chun aistriú agus foilsiú.

Má úsáideann tú timpeallacht chomhtháthaithe leanúnach chun foilsiú, ní gá nodejs a shuiteáil. Ní gá ach na ceadanna logáilte isteach agus foilsithe ~/.npmrc a chóipeáil chuig an gcomhshaol.

Má athraíonn tú ainm an phacáiste v: in main.yml , bí cinnte go scriosann tú .i18n/v/main ar dtús agus ansin foilsigh é.

Seachfhreastalaí Arna Fhoilsiú Ag npm

Má bhíonn fadhbanna líonra ag úsáideoirí ar mhórthír na Síne agus nach bhfuil siad in ann npm pacáiste a fhoilsiú, is féidir leo athróg timpeallachta https_proxy a shocrú chun an seachfhreastalaí a chumrú.

Ag glacadh leis gurb é 7890 port do sheachfhreastalaí, is féidir leat scríobh:

https_proxy=http://127.0.0.1:7890 i18n.site -n

Ábhar Féin-Óstáilte

Más mian leat an t-inneachar féin a óstáil, cuir md/.i18n/htm/main.yml in eagar ar dtús agus athraigh v: //unpkg.com/i18n.site go dtí do réimír URL, mar v: //i18n-v.xxx.com .

Cuir isteach an t-eolaire md agus rith

i18n.site --htm_conf ol --save

nó giorrúchán

i18n.site -c ol -s

Ansin, cumraigh an t-ábhar san eolaire md/out/main/v go dtí an chonair réimír URL atá socraithe in v: .

Ar deireadh, cumraigh am taisce an chosáin a chríochnaíonn i /.v go 1s , nó ní féidir teacht ar an ábhar nua-eisithe láithreach.

Is féidir an t-am taisce le haghaidh cosáin eile a shocrú go bliain amháin nó níos mó chun iarratais nach bhfuil gá leo a laghdú.

Ábhar an Óstaigh Chuig s3

Chun inneachar a óstáil féin, chomh maith le do fhreastalaí féin a úsáid, is rogha choitianta CDN é S3 +

Is S3 leat úsáid a bhaint S3 rclone

i18n.site -c ol -s
s3=your-s3
bucket=your-bucket
ver=$(head -1 .i18n/v/main/v.hash | cut -c 2-)
rclone copy --overwrite-dir out/main/htm/v/$ver $s3:/$bucket/$ver
rclone copy out/main/v/.v "$s3:/$bucket/"

Cuimhnigh CDN a chumrú ionas gurb é 1s am taisce an chosáin a chríochnaíonn in /.v , nó ní féidir teacht ar an ábhar nua-eisithe láithreach.

Láithreán Gréasáin a Fhoilsiú

Is féidir an suíomh Gréasáin a imscaradh áit ar bith, is roghanna maithe cloudflare page github page

Toisc go n-úsáideann an láithreán gréasáin ailtireacht feidhmchláir aon leathanach , cuimhnigh ar chonairí URL nach bhfuil idir . agus index.html iontu a athscríobh.

Ní gá leathanach iontrála an tsuímh Ghréasáin a imscaradh ach uair amháin, agus ní gá leathanach iontrála an tsuímh Ghréasáin a ath-imscaradh le haghaidh nuashonruithe ábhair ina dhiaidh sin.

Imscaradh Ar Leathanach github

Ar dtús cliceáil anseo github chun eagraíocht a chruthú i18n-demo

Ansin cruthaigh stóras i18n-demo.github.io faoin eagraíocht seo (cuir ainm na heagraíochta a chruthaigh tú in ionad i18n-demo le do thoil):

Agus an t-ábhar san alt roimhe seo á fhoilsiú, tá out/main/htm ginte Cuir isteach an t-eolaire seo agus rith :

ln -s index.html 404.html

Toisc nach dtacaíonn github page le hathscríobh cosán URL, úsáidtear 404.html ina ionad sin.

Ansin rith an t-ordú seo a leanas san eolaire htm (cuimhnigh do sheoladh stórais féin a chur in ionad i18n-demo/i18n-demo.github.io.git ) :

git init
git branch -M main
git remote add origin [email protected]:i18n-demo/i18n-demo.github.io.git
git push -u origin main -f

Tar éis duit an cód a bhrú, fan ar imscaradh github page a rith go rathúil (mar a thaispeántar thíos) sular féidir leat rochtain a fháil air.

Le haghaidh leathanach taispeána féach le do thoil:

https://i18n-demo.github.io

Imscaradh Ar Leathanach cloudflare

cloudflare page gcomparáid le github page , soláthraíonn sé athscríobh cosáin agus tá sé níos cairdiúla don mhórthír na Síne agus tá sé níos inrochtana.

De ghnáth bíonn imscaradh cloudflare page bunaithe ar imscaradh github page thuas.

Cruthaigh tionscadal agus ceangail an stóras i18n-demo.github.io thuas.

Léirítear an próiseas san fhigiúr thíos:

Cliceáil Add Account le do thoil chun rochtain a thabhairt don eagraíocht i18n-demo .

Má tá stóras eagraíochta eile faoi cheangal agat, seans go mbeidh ort cliceáil ar Add Account faoi dhó chun údarú a fháil faoi dhó sula dtaispeánfar an eagraíocht nua.

Ansin, roghnaigh stóras i18n-demo.github.io , ansin cliceáil Begin setup , agus úsáid na luachanna réamhshocraithe le haghaidh céimeanna ina dhiaidh sin.

Tar éis ceangailteach den chéad uair, ní mór duit fanacht cúpla nóiméad sula bhféadfaidh tú rochtain a fháil air.

Tar éis imscaradh, is féidir leat ainm fearainn saincheaptha a cheangal.

Tar éis duit an t-ainm fearainn saincheaptha a cheangal, téigh go dtí an t-ainm fearainn chun athscríobh cosán an fheidhmchláir aon-leathanaigh a chumrú, mar a thaispeántar thíos:

Is iad seo a leanas na i18n.site sa phictiúr thuas.

(http.host in {"i18n.site"}) and not (
substring(http.request.uri.path,-3) in {".js" ".gz"} or
substring(http.request.uri.path,-4) in {".htm" ".rss" ".css" ".svg" ".ico" ".png" ".xml" ".txt"} or
substring(http.request.uri.path,-5) in {".html" ".avif" ".json"} or
ends_with(http.request.uri.path,".webmanifest")
)

Ina theannta sin, cumraigh le do thoil na rialacha taisce, mar a thaispeántar thíos, agus socraigh fad an taisce go dtí mí amháin.

Athraigh an t-ainm fearainn atá ag teacht leis an dara céim sa phictiúr thuas go dtí an t-ainm fearainn a cheangail tú.

Imscaradh Láithreán Gréasáin a Bharrfheabhsú Ar Mhórthír Na Síne

Más mian leat feidhmíocht inrochtaineachta níos fearr a fháil i dtimpeallacht líonra mórthír na Síne, cláraigh ainm fearainn ar dtús.

Ansin, bain úsáid as stóráil réad na ndíoltóirí scamall sa tSín + CDN Imscaradh an t-ábhar seo a leanas out/main/htm .

Is féidir leat ríomhaireacht chiumhais a úsáid chun an cosán a athscríobh chun oiriúnú d’fheidhmchláir aon-leathanaigh Mar shampla, is féidir Baidu Smart Cloud CDN a chumrú mar seo:

const uri = r.uri, p = uri.lastIndexOf(".");
if (
  p < 0 ||
  !"|js|css|htm|html|md|avif|json|ico|xml|rss|gz|mp4|png|svg|txt|webmanifest|".includes(
    "|" + uri.slice(p + 1) + "|",
  )
) {
  const ua = r.headersIn["User-Agent"].toLowerCase()
  if (/facebookexternalhit|slurp|bot|spider|curl/.test(ua)) {
    r.return(
      302,
      (/baidu|yisou|sogou|360|byte/.test(ua) ? "/zh" : "/en") + r.uri + ".htm",
    )
  } else {
    r.uri = "/index.html"
  }
}

r.respHeader(() => {
  const t = [], out = r.headersOut;
  ["Content-MD5", "Age", "Expires", "Last-Modified"].forEach(
    i => delete out[i]
  )
  r.rawHeadersOut.forEach(i => {
    const key = i[0].toLowerCase()
    if (key.startsWith("x-") || key.startsWith("ohc-")) {
      delete out[key]
    }
  })
  out["Cache-Control"] = "max-age=" + 9e5
  // Is féidir ceanntásca freagartha a shocrú d'aschur dífhabhtaithe, mar shampla out.XXX = 'MSG';
})

Toisc nach féidir taifead MX agus taifead CNAME a bheith ar aon dul, A CNAME leat ríomhphoist ainm fearainn a fháil ag an am céanna, ní mór duit comhoibriú leis an script cname_flatten

Ina theannta sin, toisc go bhfuil táillí tráchta thar lear díoltóirí scamall sa tSín mórthír sách costasach, más mian leat costais a bharrfheabhsú, is féidir leat úsáid a bhaint as réiteach geografach saor in aisce Huawei Cloud DNS agus ainm fearainn saincheaptha Cloudflare for SaaS (mar a thaispeántar thíos). atreorú tráchta── Ródú tráchta sa tSín mórthír Baidu Cloud CDN , téann trácht idirnáisiúnta cloudflare .

Tá na réitigh bharrfheabhsaithe imlonnaithe seo níos casta agus tabharfar isteach iad i gcaibidlí ar leith amach anseo.

Atreorú Cineálach Ainm Fearainn

Má úsáideann tú i18n.site chun suíomh Gréasáin a ghiniúint mar do phríomhshuíomh Gréasáin, de ghnáth ní mór duit atreorú uile-fhearainn a chumrú, is é sin, rochtain a atreorú chuig *.xxx.com (lena n-áirítear www.xxx.com ) go xxx.com .

Is féidir an riachtanas seo a bhaint amach le cabhair ó Alibaba Cloud CDN EdgeScript ( doiciméad Béarla / doiciméad Sínis )

Cuir an t-ainm fearainn in Alibaba Cloud CDN agus cuir an t-ainm fearainn *.xxx.com CNAME in Alibaba Cloud CDN .

Mar shampla, is é seo a leanas an chumraíocht atreoraithe ainm uile-fhearainn de *.i18n.site sa phictiúr thuas:

rewrite(concat('https://i18n.site',$uri), 'redirect',301)

Imscaradh Le nginx

Cuir cumraíocht cosúil leis an /root/i18n/md/out/main/htm seo out/main/htm leanas leis san alt server de nginx

location / {
  root  /root/i18n/md/out/main/htm;
  add_header Cache-Control "max-age=9999999";
  if ($uri !~* \.(avif|css|html|ico|js|json|png|svg|txt|webmanifest|xml)$) {
     rewrite ^ /index.html last;
  }
}

Bunaithe Ar github action Comhtháthú Leanúnach

Is féidir leat tagairt a dhéanamh dóibh seo a leanas chun do github action a chumrú:

name: i18n.site

on:
  workflow_dispatch:
  push:
    branches:
      - main
      - dist

jobs:
  i18n:

    permissions:
      repository-projects: write
      contents: write

    runs-on: ubuntu-latest

    steps:
      - name: checkout
        uses: actions/checkout@v4

      - name: https://i18n.site
        uses: i18n-site/github-action-i18n.site@main
        with:
          I18N_SITE_TOKEN: ${{ secrets.I18N_SITE_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

Mar atá le feiceáil sa chumraíocht, spreagtar an sreabhadh oibre seo nuair a bhrúitear go brainse main agus brainse dist .

Úsáidfidh an sreabhadh oibre an comhad cumraíochta a fhreagraíonn don ainm brainse chun an doiciméad a fhoilsiú Anseo, úsáidfear .i18n/htm/main.yml agus .i18n/htm/dist.yml mar chumraíocht foilsitheoireachta faoi seach.

Molaimid na cleachtais is fearr seo a leanas don phróiseas scaoileadh doiciméad:

Nuair a bhrúitear athruithe go brainse main , spreagtar an doiciméad le tógáil agus le himscaradh chuig an stáisiún réamhamhairc (tá an stáisiún réamhamhairc ar fáil github page ).

Tar éis a dhearbhú go bhfuil an doiciméad ceart ar an suíomh réamhamhairc, déanfar an cód a chumasc agus a bhrú go brainse dist , agus rachaidh an tógáil agus an t-imscaradh oifigiúil ar líne.

Ar ndóigh, éilíonn cur chun feidhme an phróisis thuas níos mó cumraíochtaí a scríobh.

Is féidir leat tagairt a dhéanamh don tionscadal iarbhír github.com/fcdoc/doc le haghaidh scriptithe sreabhadh oibre.

Éilíonn secrets.I18N_SITE_TOKEN agus secrets.NPM_TOKEN sa chumraíocht duit athróga rúnda a chumrú sa bhonn cód.

I18N_SITE_TOKEN i18n.site/token

Is é NPM_TOKEN comhartha foilsitheoireachta phacáiste npm sa chumraíocht. Tabhair cuairt ar npmjs.com

Struchtúr Eolaire

public

Comhaid statacha an láithreáin ghréasáin, mar shampla favicon.ico , robots.txt , etc.

Is féidir na comhaid deilbhín anseo a ghiniúint le realfavicongenerator.net

.i18n

Faoin eolaire .i18n tá na comhaid cumraíochta, taisce aistriúcháin, srl. de i18n.site Féach an chéad chaibidil eile "Cumraíocht" le haghaidh sonraí.

en

Eolaire teanga foinse, a fhreagraíonn do en as fromTo in .i18n/conf.yml comhad cumraíochta

i18n:
  fromTo:
    en: zh

Déan tagairt le do thoil do chumraíocht an aistriúcháin i18