Kev Xa Tawm Thiab Hauv Online
i18n.site txais yuav ib nplooj ntawv thov architecture, thiab lub vev xaib nkag thiab cov ntsiab lus hauv lub vev xaib raug xa tawm ntawm nws tus kheej.
Tom qab khiav cov lus txhais saum toj no, cov npe htm thiab v yuav raug tsim nyob rau hauv md/out/dev phau ntawv.
Ntawm no, dev txhais tau tias nws yog tsim los ntawm .i18n/htm/dev.yml configuration file.
dev npe :
Lub htm directory yog nplooj ntawv nkag lub vev xaib.
v phau ntawv teev npe muaj cov ntsiab lus hauv lub vev xaib nrog tus lej version.
Kev saib ua ntej hauv zos tsis quav ntsej txog tus lej version thiab yuav luam tag nrho cov ntaub ntawv mus rau out/dev/v/0.1.0 phau ntawv.
Rau kev tso tawm, cov ntaub ntawv hloov pauv yuav raug theej mus rau tus lej tshiab ntawm phau ntawv teev npe.
Qhia Cov Ntaub Ntawv Configuration Nrog -c
Cov ntaub ntawv configuration sib txawv yuav tsim cov npe sib xws hauv out directory.
Piv txwv li, .i18n/htm/main.yml yuav tsim out/main phau ntawv teev npe.
dev.yml thiab main.yml yog lub neej ntawd configurations.
dev yog cov ntawv luv ntawm development , qhia txog kev txhim kho ib puag ncig, siv rau kev saib ua ntej hauv zos, thiab tseem yog cov ntaub ntawv teeb tsa.
ol yog cov ntawv luv luv ntawm online , qhia qhov chaw hauv online, uas yog siv rau kev tso tawm nws kuj yog cov ntaub ntawv teeb tsa thaum siv cov kab hais kom ua -n txog npm tso tawm.
Koj tuaj yeem tsim lwm cov ntaub ntawv teeb tsa Siv --htm_conf ntawm kab hais kom ua kom paub meej cov ntaub ntawv teeb tsa lub npe siv:
piv txwv:
i18n.site --htm_conf dist --save
Ntawm no --save sawv cev rau qhov hloov tshiab tso tawm version naj npawb.
Tshaj tawm cov ntsiab lus rau npmjs.com
Kev tshaj tawm cov ntsiab lus rau npmjs.com
npm Nkag Mus & Post
Nruab nodejs , nkag mus nrog npm login .
Kho kom raug md/.i18n/htm/main.yml thiab hloov tus nqi ntawm md: YOUR_NPM_PACKAGE raws li koj tus kheej lub npe npm pob lub npmjs.com yuav ua.
Tom qab ntawd hloov kho md/.i18n/htm/main.package.json
Khiav i18n.site --npm lossis i18n.site -n hauv md phau ntawv txhais lus thiab tshaj tawm.
Yog tias koj siv ib puag ncig kev koom ua ke txuas ntxiv mus tshaj tawm, tsis tas yuav nruab nodejs Tsuas yog luam cov ntawv nkag nkag thiab luam tawm kev tso cai ~/.npmrc rau ib puag ncig.
Yog tias koj hloov kho lub npe pob ntawm v: hauv main.yml , thov nco ntsoov tshem tawm .i18n/v/main ua ntej thiab tom qab ntawd luam tawm nws.
Proxy Server Luam Tawm Los Ntawm npm
Yog tias cov neeg siv hauv Suav teb loj ntsib teeb meem hauv network thiab tsis tuaj yeem tshaj tawm npm pob khoom, lawv tuaj yeem teeb tsa qhov chaw hloov pauv https_proxy los teeb tsa lub npe server.
Piv txwv tias koj lub npe neeg rau zaub mov chaw nres nkoj yog 7890 , koj tuaj yeem sau:
https_proxy=http://127.0.0.1:7890 i18n.site -n
Self-Hosted Cov Ntsiab Lus
Yog tias koj xav ua tus tswv tsev cov ntsiab lus, thawj zaug hloov md/.i18n/htm/main.yml thiab hloov v: //unpkg.com/i18n.site rau koj qhov URL ua ntej, xws li v: //i18n-v.xxx.com .
Nkag mus rau md directory thiab khiav
i18n.site --htm_conf ol --save
los yog sau ntawv
i18n.site -c ol -s
Tom qab ntawd, teeb tsa cov ntsiab lus hauv md/out/main/v phau ntawv teev npe mus rau qhov URL prefix kab teeb hauv v: .
Thaum kawg, teeb tsa lub sijhawm cache ntawm txoj hauv kev xaus hauv /.v txog 1s , txwv tsis pub cov ntsiab lus tawm tshiab tuaj yeem nkag tsis tau tam sim ntawd.
Lub sijhawm cache rau lwm txoj hauv kev tuaj yeem teem rau ib xyoos lossis ntau dua los txo cov kev thov tsis tsim nyog.
Host Cov Ntsiab Lus Rau s3
Txhawm rau tswj hwm tus kheej cov ntsiab lus, ntxiv rau kev CDN koj tus kheej server, lwm qhov kev xaiv yog siv S3 + .
Koj tuaj yeem siv rclone txhawm rau nkag mus rau S3 tus neeg rau zaub mov, tom qab ntawd xa mus thiab hloov kho cov ntawv hauv qab no, thiab tsuas yog luam cov kev hloov pauv ntxiv rau S3 rau txhua qhov kev tso tawm.
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/"
Nco ntsoov teeb tsa CDN kom lub sijhawm cache ntawm txoj kev xaus rau hauv /.v yog 1s , txwv tsis pub cov ntsiab lus tawm tshiab tuaj yeem nkag tsis tau tam sim ntawd.
Luam Tawm Lub Vev Xaib
Lub vev xaib tuaj yeem xa mus rau txhua qhov chaw github page thiab cloudflare page yog qhov kev xaiv zoo.
Vim tias lub vev xaib siv ib nplooj ntawv thov architecture, nco ntsoov rov sau URL txoj hauv kev uas tsis muaj . txog index.html .
Nplooj ntawv nkag lub vev xaib tsuas yog yuav tsum tau xa tawm ib zaug, thiab tsis tas yuav rov siv lub vev xaib nkag mus rau cov ntsiab lus txuas ntxiv.
Deploy on github page
Ua ntej nyem qhov no i18n-demo github tsim ib lub koom haum .
Tom qab ntawd tsim warehouse i18n-demo.github.io nyob rau hauv lub koom haum no (thov hloov i18n-demo nrog lub koom haum lub npe koj tsim):
Thaum tshaj tawm cov ntsiab lus nyob rau hauv tsab xov xwm dhau los, out/main/htm tau raug tsim tawm Thov sau cov npe no thiab khiav :
ln -s index.html 404.html
Vim github page tsis txhawb URL txoj kev rov sau dua, 404.html yog siv hloov.
Tom qab ntawd khiav cov lus txib hauv qab no hauv htm phau ntawv teev npe (nco ntsoov hloov i18n-demo/i18n-demo.github.io.git nrog koj tus kheej chaw nyob hauv tsev khaws khoom) :
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
Tom qab thawb tus lej, tos rau kev xa tawm ntawm github page kom ua tiav (raws li qhia hauv qab no) ua ntej koj tuaj yeem nkag mus rau nws.
Rau nplooj ntawv demo thov saib:
https://i18n-demo.github.io
Deploy Ntawm cloudflare Nplooj
cloudflare page Piv nrog rau github page , nws muab txoj hauv kev rov sau dua thiab yog tus phooj ywg zoo dua rau Suav teb av loj thiab pom zoo siv.
Kev xa tawm ntawm cloudflare page feem ntau yog raws li kev xa tawm ntawm github page saum toj no.
Tsim ib qhov project thiab khi lub i18n-demo.github.io warehouse saum toj no.
Cov txheej txheem tau qhia hauv daim duab hauv qab no:
Thov nias Add Account kom tso cai nkag mus rau lub koom haum i18n-demo .
Yog tias koj tau khi lub warehouse ntawm lwm lub koom haum, koj yuav tau nyem Add Account ob zaug kom tso cai ob zaug ua ntej lub koom haum tshiab yuav tshwm sim.
Tom ntej no, xaiv warehouse i18n-demo.github.io , ces nyem Begin setup , thiab siv lub neej ntawd qhov tseem ceeb rau cov kauj ruam tom ntej.
Tom qab khi thawj zaug, koj yuav tsum tau tos ob peb feeb ua ntej koj tuaj yeem nkag mus rau nws.
Tom qab kev xa tawm, koj tuaj yeem khi lub npe sau npe.
Tom qab khi txoj cai sau npe, thov mus rau lub npe sau npe los teeb tsa txoj kev rov sau dua ntawm daim ntawv thov ib nplooj ntawv, raws li qhia hauv qab no:
Cov cai hauv daim duab saum toj no yog raws li hauv qab no Thov hloov i18n.site hauv thawj kab hauv qab no nrog lub npe sau koj khi.
(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")
)
Tsis tas li ntawd, thov teeb tsa cov cai cache, raws li qhia hauv qab no, thiab teeb tsa lub sijhawm cache rau ib hlis.
Thov hloov lub npe sau npe sib piv nyob rau theem ob hauv daim duab saum toj no rau lub npe sau npe koj khi.
Optimizing Lub Vev Xaib Xa Tawm Hauv Suav Teb Av Loj
Yog tias koj xav kom tau txais kev nkag tau zoo dua hauv kev sib txuas hauv network ntawm Tuam Tshoj mainland, thov sau npe sau npe ua ntej.
Tom qab CDN , siv cov khoom cia ntawm cov neeg out/main/htm khoom huab hauv Suav teb av loj +
Koj tuaj yeem siv ntug kev suav sau rov qab txoj hauv kev los hloov mus rau ib nplooj ntawv thov Piv txwv li, Baidu Smart Cloud CDN tuaj yeem teeb tsa zoo li no:
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
// Teb headers tuaj yeem teem rau debug cov zis, xws li out.XXX = 'MSG';
})
Vim tias cov ntaub ntawv MX thiab cov ntaub ntawv CNAME tsis tuaj yeem sib koom ua ke, yog tias koj xav tau txais email npe nyob rau tib lub sijhawm, koj yuav tsum koom tes nrog cov cname_flatten sau rau qib CNAME rau hauv cov ntaub ntawv A .
Tsis tas li ntawd, vim tias cov nqi tsheb thauj mus los txawv teb chaws ntawm cov neeg muag khoom huab hauv Suav teb tseem pheej yig, yog tias koj xav kom zoo dua cov nqi, koj tuaj yeem siv Huawei Cloud 's dawb daws teeb DNS Cloudflare for SaaS tsheb diversion ── Traffic routing nyob rau hauv mainland Tuam Tshoj Baidu huab CDN , thoob ntiaj teb tsheb mus cloudflare .
Cov kev daws teeb meem kev ua kom zoo tshaj plaws no yog qhov nyuaj dua thiab yuav raug qhia hauv tshooj cais yav tom ntej.
Generic Sau Npe Redirection
Yog tias koj siv i18n.site los tsim lub vev xaib raws li koj lub vev xaib tseem ceeb, feem ntau koj yuav tsum tau teeb tsa pan-domain redirection, uas yog, hloov mus rau *.xxx.com (xws li www.xxx.com ) rau xxx.com .
Qhov kev xav tau no tuaj yeem ua tiav nrog kev pab los ntawm Alibaba Cloud CDN EdgeScript ( English document / Chinese document )
Ntxiv lub npe *.xxx.com CNAME CDN Alibaba Huab CDN
Piv txwv li, pan-domain name redirection configuration ntawm *.i18n.site nyob rau hauv daim duab saum toj no yog raws li nram no:
rewrite(concat('https://i18n.site',$uri), 'redirect',301)
Deploy Nrog nginx
Thov ntxiv ib qho kev /root/i18n/md/out/main/htm tsa zoo ib yam li cov hauv qab no hauv server out/main/htm lus ntawm 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;
}
}
Raws Li github action Kev Koom Ua Ke Txuas Ntxiv
Koj tuaj yeem xa mus rau cov hauv qab no los teeb tsa koj qhov github action :
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 }}
Raws li tuaj yeem pom hauv kev teeb tsa, qhov kev ua haujlwm no tau tshwm sim thaum thawb mus rau ceg main thiab ceg dist .
Cov txheej txheem ua haujlwm yuav siv cov ntaub ntawv teeb tsa sib raug rau lub npe ceg los tshaj tawm cov ntaub ntawv Ntawm no, .i18n/htm/main.yml thiab .i18n/htm/dist.yml yuav raug siv los ua kev tshaj tawm kev teeb tsa.
Peb pom zoo cov kev coj ua zoo tshaj plaws hauv qab no rau cov txheej txheem tso tawm cov ntaub ntawv:
Thaum cov kev hloov pauv raug thawb mus rau ceg main , cov ntaub ntawv raug tsim los tsim thiab xa mus rau qhov chaw saib ua ntej (qhov chaw saib ua ntej yog muaj github page ).
Tom qab lees paub tias cov ntaub ntawv yog qhov tseeb ntawm qhov chaw saib ua ntej, cov cai yuav raug muab sib koom ua ke thiab thawb mus rau ceg dist , thiab kev tsim kho thiab xa tawm yuav mus online.
Tau kawg, kev siv cov txheej txheem saum toj no yuav tsum tau sau ntau qhov kev teeb tsa.
Koj tuaj yeem xa mus rau qhov project tiag github.com/fcdoc/doc rau kev ua haujlwm scripting.
secrets.I18N_SITE_TOKEN thiab secrets.NPM_TOKEN hauv kev teeb tsa xav kom koj teeb tsa cov kev hloov pauv tsis pub lwm tus paub hauv lub hauv paus code.
I18N_SITE_TOKEN i18n.site/token
NPM_TOKEN yog qhov kev tshaj tawm token ntawm pob npm hauv kev teeb tsa Mus ntsib npmjs.com
Directory Structure
public
Cov ntaub ntawv zoo li qub ntawm lub vev xaib, xws li favicon.ico , robots.txt , thiab lwm yam.
Cov ntaub ntawv icon ntawm no tuaj yeem tsim nrog realfavicongenerator.net
.i18n
Hauv qab .i18n phau ntawv teev npe yog cov ntaub ntawv teeb tsa, kev txhais lus cache, thiab lwm yam ntawm i18n.site Saib tshooj tom ntej "Configuration" kom paub meej.
en
Cov npe ntawm cov lus qhia, sib xws rau en ntawm fromTo hauv .i18n/conf.yml cov ntaub ntawv teeb tsa
i18n:
fromTo:
en: zh
Thov xa mus rau lub configuration ntawm kev txhais lus i18