Ho Tsamaisoa Le Inthaneteng
i18n.site e amohela moralo oa ts'ebeliso ea leqephe le le leng , mme leqephe la ho kena webosaeteng le litaba tsa webosaete li tsamaisoa ka boikemelo.
Ka mor'a ho sebelisa phetolelo e ka holimo, li-directory htm le v li tla hlahisoa tlas'a md/out/dev directory.
Mona, dev e bolela hore e hahiloe ho latela faele .i18n/htm/dev.yml ea tlhophiso.
dev directory :
htm directory ke leqephe la ho kena webosaeteng.
Lenane la v le na le litaba tsa sebaka sa marang-rang tse nang le linomoro tsa mofuta.
Ponahalo ea lehae ha e tsotelle nomoro ea mofuta mme e tla kopitsa lifaele tsohle bukeng ea out/dev/v/0.1.0 .
Bakeng sa tokollo ea semmuso, lifaele tse fetotsoeng li tla kopitsoa bukeng ea nomoro ea mofuta o mocha.
Hlalosa Faele Ea Tlhophiso Ka -c
Lifaele tse fapaneng tsa tlhophiso li tla theha li-directory tse tsamaellanang bukeng ea out .
Mohlala, .i18n/htm/main.yml e tla theha out/main directory.
dev.yml le main.yml ke litlhophiso tsa kamehla.
dev ke khutsufatso ea development , e bonts'ang tikoloho ea nts'etsopele, e sebelisetsoang tlhahlobo ea lehae, hape ke faele ea kamehla ea tlhophiso.
ol ke khutsufatso ea online , e bonts'ang tikoloho ea inthaneteng, e sebelisetsoang tokollo ea semmuso Hape ke faele e hlophisitsoeng ea kamehla ha u sebelisa li-parameter tsa mola oa taelo -n ho isa ho npm ho lokolla.
U ka boela ua theha lifaele tse ling tsa tlhophiso Sebelisa --htm_conf moleng oa taelo ho hlakisa lebitso la faele eo u lokelang ho e sebelisa.
ka mohlala:
i18n.site --htm_conf dist --save
Mona --save e emela nomoro ea tokollo ea ntlafatso.
Phatlalatsa litaba ho npmjs.com
Ho phatlalatsa litaba ho npmjs.com
npm Kena & Poso
Kenya nodejs , kena ka npm login .
Fetola md/.i18n/htm/main.yml me u fetole boleng ba md: YOUR_NPM_PACKAGE joalo ka lebitso la sephutheloana sa hau se sa npm se npmjs.com etsoa.
Ebe u fetola md/.i18n/htm/main.package.json
Matha i18n.site --npm kapa i18n.site -n bukeng ea md ho fetolela le ho phatlalatsa.
Haeba u sebelisa tikoloho e tsoelang pele ea ho kopanya ho phatlalatsa, ha ho hlokahale ho kenya nodejs Feela kopitsa tumello ea ho kena le ho hatisa ~/.npmrc tikolohong.
Haeba u fetola lebitso la sephutheloana sa v: ho main.yml , ka kopo etsa bonnete ba hore u hlakola .i18n/v/main pele ebe u e phatlalatsa.
Seva Ea Moemeli E Phatlalalitsoeng Ke npm
Haeba basebelisi ba naha ea China ba kopana le mathata a marang-rang 'me ba sa khone ho phatlalatsa liphutheloana npm , ba ka beha phetoho ea tikoloho https_proxy ho lokisa seva sa proxy.
Ka ho nka hore boema-kepe ba hau ba proxy ke 7890 , u ka ngola:
https_proxy=http://127.0.0.1:7890 i18n.site -n
Boiketsi Ba Dikahare
Haeba u batla ho iketsetsa litaba, qala ka ho hlophisa md/.i18n/htm/main.yml 'me u fetole v: //unpkg.com/i18n.site ho sehlomathiso sa URL ea hau, joalo ka v: //i18n-v.xxx.com .
Kenya md directory ebe u matha
i18n.site --htm_conf ol --save
kapa kgutsufatso
i18n.site -c ol -s
Ebe, lokisa litaba tse bukeng ea md/out/main/v ho tsela ea URL e behiloeng ho v: .
Qetellong, lokisa nako ea cache ea tsela e qetellang ka /.v ho 1s , ho seng joalo litaba tse sa tsoa lokolloa li ke ke tsa fumaneha hang-hang.
Nako ea cache ea litsela tse ling e ka beoa selemo se le seng kapa ho feta ho fokotsa likopo tse sa hlokahaleng.
Ba Amohela Litaba Tsa s3
Ho iketsetsa litaba, ntle le ho sebelisa CDN sa hau, khetho e 'ngoe e tloaelehileng ke ho sebelisa S3 + .
U ka sebelisa rclone ho kena ho S3 seva, ebe u sheba le ho fetola script e latelang, 'me u kopitse liphetoho tse ntseng li eketseha ho S3 bakeng sa tokollo e' ngoe le e 'ngoe.
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/"
Hopola ho lokisa CDN e le hore nako ea cache ea tsela e qetellang ka /.v ke 1s , ho seng joalo litaba tse sa tsoa lokolloa li ke ke tsa fumanoa hang-hang.
Phatlalatsa Websaeteng
Webosaete e ka romelloa kae kapa kae, github page me cloudflare page ke likhetho tse ntle.
Hobane sebaka sa marang-rang se sebelisa moralo oa ts'ebeliso ea leqephe le le leng , hopola ho ngola bocha litsela tsa URL tse se nang . ho isa ho index.html .
Leqephe la ho kena sebakeng sa marang-rang le hloka ho romelloa hang feela, 'me ha ho na tlhoko ea ho khutlisetsa leqephe la ho kena webosaeteng bakeng sa lintlafatso tsa litaba tse latelang.
Kenya Leqephe La github
Tlanya mona pele github Ho theha mokhatlo Lebitso le latelang ke i18n-demo e le mohlala.
Ebe u theha ntlo ea polokelo i18n-demo.github.io tlasa mokhatlo ona (ka kopo tlosa i18n-demo ka lebitso la mokhatlo leo u le thehileng):
Ha u phatlalatsa litaba tse hlahang sehloohong se fetileng, out/main/htm e entsoe ka kopo, kenya bukana ena 'me u e tsamaise :
ln -s index.html 404.html
Hobane github page ha e tšehetse ho ngola bocha ha tsela ea URL, ho sebelisoa 404.html ho fapana le hoo.
Ebe u tsamaisa taelo e latelang bukeng ea htm (hopola ho nkela i18n-demo/i18n-demo.github.io.git sebaka ka aterese ea hau ea polokelo) :
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
Ka mor'a ho sutumetsa khoutu, emela hore ho romelloa ha github page ho sebetsa ka katleho (joalokaha ho bontšitsoe ka tlase) pele u ka e fumana.
Bakeng sa leqephe la demo ka kopo bona:
https://i18n-demo.github.io
E Sebelisa Leqepheng La cloudflare
Ha cloudflare page bapisoa le github page , e fana ka mokhoa oa ho ngola hape 'me e na le botsoalle ho naha ea China mme e fumaneha habonolo.
Ho romelloa ha cloudflare page hangata ho ipapisitse le ho romelloa ha github page ka holimo.
Theha morero 'me u tlamelle ntlo ea polokelo i18n-demo.github.io ka holimo.
Mokhoa ona o bontšoa setšoantšong se ka tlase:
Ka kopo, tobetsa Add Account ho fana ka monyetla oa ho kena mokhatlong i18n-demo .
Haeba u tlamme ntlo ea polokelo ea mokhatlo o mong, u ka 'na ua hloka ho tobetsa Add Account habeli ho fana ka tumello habeli pele mokhatlo o mocha o tla hlahisoa.
E latelang, khetha ntlo ea polokelo i18n-demo.github.io , ebe u tobetsa Begin setup , 'me u sebelise litekanyetso tsa kamehla bakeng sa mehato e latelang.
Kamora ho tlama lekgetlo la pele, o hloka ho ema metsotso e seng mekae pele o ka fihlella.
Kamora ho romelloa, o ka tlama lebitso la domain name.
Kamora ho tlama lebitso la domain name, ka kopo e-ea ho domain name ho hlophisa mokhoa oa ho ngola hape oa ts'ebeliso ea leqephe le le leng, joalo ka ha ho bonts'itsoe ka tlase:
Melao e setšoantšong se ka holimo ke i18n.site latelang.
(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")
)
Ho phaella moo, ka kopo, lokisa melao ea cache, joalokaha ho bontšitsoe ka tlase, 'me u behe nako ea nako ea cache ho khoeli e le' ngoe.
Ka kopo fetola lebitso la domain name le ts'oanang mohatong oa bobeli setšoantšong se kaholimo ho lebitso la sebaka seo u se tlamileng.
Ho Ntlafatsa Phepelo Ea Webosaete Naheng Ea China
Haeba u batla ho fumana ts'ebetso e betere ea phihlello tikolohong ea marang-rang ea China, ka kopo ngodisa lebitso la domain pele.
Joale, sebelisa polokelo ea lintho tsa barekisi ba maru naheng ea + CDN Kenya litaba tse latelang out/main/htm .
U ka sebelisa komporo ea moeli ho ngola tsela ea ho ikamahanya le lits'ebetso tsa leqephe le le leng Ka mohlala, Baidu Smart Cloud CDN e ka hlophisoa tjena:
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
// Lihlooho tsa likarabo li ka hlophisoa hore li fane ka tlhahiso ea bothata, joalo ka out.XXX = 'MSG';
})
Hobane rekoto ea MX le rekoto ea CNAME e ke ke ea phela hammoho, haeba u batla ho fumana li-imeile tsa mabitso a marang-rang ka nako e le 'ngoe, u hloka ho sebelisana le lengolo CNAME cname_flatten rekota A .
Ntle le moo, hobane litefiso tsa sephethe-phethe tsa mose ho maoatle tsa barekisi ba maru naheng ea China li batla li le turu, haeba u batla ho ntlafatsa litšenyehelo, u ka sebelisa DNS ea mahala ea Huawei Cloud le lebitso la domain la Cloudflare for SaaS (joalo ka ha ho bonts'itsoe ka tlase) ho fihlela phaposo ea sephethephethe──Tsela ea sephethephethe naheng ea China Baidu Cloud CDN , sephethephethe sa machaba se ea cloudflare .
Litharollo tsena tsa ntlafatso ea thomello li rarahane haholoanyane 'me li tla hlahisoa likhaolong tse fapaneng nakong e tlang.
Tlosa Sebaka Sa Marang-Rang Sa Generic
Haeba u sebelisa i18n.site ho hlahisa sebaka sa marang-rang e le sebaka sa hau sa marang-rang se ka sehloohong, hangata ho hlokahala hore u lokise mokhoa oa ho tsamaisa sebaka sa marang-rang, ke hore, ho tsamaisa phihlello ho *.xxx.com (ho kenyeletsoa www.xxx.com ) ho ea ho xxx.com .
Tlhokahalo ena e ka finyelloa ka thuso ea Alibaba Cloud CDN EdgeScript ( tokomane ea Senyesemane / Tokomane ea Sechaena )
Kenya lebitso la domain ho Alibaba Cloud CDN me u supe lebitso la domain *.xxx.com ho ea ho CNAME ho Alibaba Cloud CDN .
Mohlala, sebopeho sa "pan-domain name redirection" ea *.i18n.site setšoantšong se kaholimo ke ka tsela e latelang:
rewrite(concat('https://i18n.site',$uri), 'redirect',301)
E Tsamaisa Ka nginx
Ka kopo, eketsa tlhophiso e ts'oanang le /root/i18n/md/out/main/htm latelang serapeng sa server sa nginx out/main/htm
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;
}
}
E Ipapisitse Le github action Kopanyo E Tsoelang Pele
U ka sheba tse latelang ho hlophisa github action ea hau:
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 }}
Joalokaha ho ka bonoa tlhophisong, ts'ebetso ena ea ts'ebetso e hlahisoa ha e sutumelletsa lekaleng la main le lekala dist .
Mosebetsi o tla sebelisa faele ea tlhophiso e lumellanang le lebitso la lekala ho hatisa tokomane Mona, .i18n/htm/main.yml le .i18n/htm/dist.yml li tla sebelisoa e le tlhophiso ea khatiso ka ho latellana.
Re khothaletsa mekhoa e latelang e metle bakeng sa ts'ebetso ea tokollo ea tokomane:
Ha liphetoho li sutumelletsoa lekaleng la main , tokomane e hlohlelletsoa ho hahuoa le ho romelloa seteisheneng sa ponelopele (seteishene sa ponelopele se teng github page ).
Ka mor'a ho netefatsa hore tokomane e nepahetse setšeng sa ponelopele, khoutu e tla kopanngoa ebe e sutumelletsoa lekaleng dist , 'me mohaho oa molao le ho tsamaisoa o tla kena Inthaneteng.
Ehlile, ho kenya tšebetsong ts'ebetso e kaholimo ho hloka ho ngola litlhophiso tse ngata.
U ka sheba projeke ea github.com/fcdoc/doc nete bakeng sa scripting ea mosebetsi.
secrets.I18N_SITE_TOKEN le secrets.NPM_TOKEN ho tlhophiso li hloka hore u lokise mefuta-futa ea lekunutu sebakeng sa khoutu.
I18N_SITE_TOKEN i18n.site/token
NPM_TOKEN ke lets'oao la phatlalatso la sephutheloana npm ho tlhophiso, npmjs.com me u thehe lets'oao le nang le tumello ea ho phatlalatsa (joalo ka ha ho bonts'itsoe ka tlase).
Sebopeho Sa Bukana
public
Lifaele tse tsitsitseng tsa sebaka sa marang-rang, joalo ka favicon.ico , robots.txt , joalo-joalo.
Lifaele tsa setšoantšo mona li ka hlahisoa ka realfavicongenerator.net
.i18n
Tlas'a bukana ea .i18n ho na le lifaele tsa tlhophiso, cache ea phetolelo, joalo-joalo ea i18n.site Sheba khaolo e latelang "Configuration" bakeng sa lintlha.
en
Bukana ea puo ea mohloli, e tsamaellanang le en ho fromTo ho faele .i18n/conf.yml ea litlhophiso
i18n:
fromTo:
en: zh
Ka kopo sheba tlhophiso ea phetolelo i18