HTMLBook 多語言出版實(shí)戰(zhàn)80 語言本地化配置從零開始【免費(fèi)下載鏈接】HTMLBookLets write books in HTML!項(xiàng)目地址: https://gitcode.com/gh_mirrors/ht/HTMLBookHTMLBook 是一個用 HTML 寫書的開放出版標(biāo)準(zhǔn)基于 XHTML5 精簡而來讓你用最熟悉的網(wǎng)頁標(biāo)記語言完成從寫作、校驗(yàn)到 EPUB、PDF 多格式出版的全流程。而最讓人驚喜的是它的多語言出版能力項(xiàng)目內(nèi)置 80 語言的本地化文件目錄、章節(jié)標(biāo)題、圖表編號、提示框等出版元素會自動翻譯成目標(biāo)語言。本文就從零開始帶你一步步完成 HTMLBook 本地化配置讓一本書輕松走向全球讀者。HTMLBook 是什么用 HTML 寫書的出版利器HTMLBook 的核心理念只有一句話Lets write books in HTML!它把所有 HTML5 元素按書的語義重新組織——章節(jié)、前言、附錄、索引、交叉引用、代碼清單、側(cè)欄、警告框全部用你熟悉的section、nav、figure等標(biāo)簽表達(dá)。這意味著什么寫作門檻極低、單一數(shù)據(jù)源、輸出格式豐富。同一個 HTML 源文件既能生成網(wǎng)頁版也能通過配套樣式表輸出 EPUB、Mobi、PDF。詳細(xì)規(guī)范見 specification.html入門樣張可以直接參考 samples/htmlbook.html。80 語言本地化文件藏在哪這是多語言出版的基石。HTMLBook 內(nèi)置了一整套從 DocBook XSL 項(xiàng)目同步來的語言包存放在項(xiàng)目的htmlbook-xsl/localizations/目錄下共 74 個 XML 文件覆蓋 80 多種語言與方言含簡體中文、繁體中文、巴西葡萄牙語、拉丁塞爾維亞語等方言變體。語言文件語言文件簡體中文zh_cn.xml日語ja.xml繁體中文zh_tw.xml韓語ko.xml英語en.xml法語fr.xml德語de.xml西班牙語es.xml俄語ru.xml阿拉伯語ar.xml每個文件長這樣一系列g(shù)entext鍵值對把ChapterFigureTable of Contents等出版術(shù)語翻譯成對應(yīng)語言。以 zh_cn.xml 為例Chapter被映射為章TableofContents被映射為目錄Warning被映射為警告。本地化配置核心原理book-language 怎么選HTMLBook 的本地化機(jī)制非常聰明——無需任何命令行參數(shù)語言自動識別。核心邏輯寫在 param.xsl 中引擎會先檢查源文件html或body元素上的lang屬性讀到合法的語言代碼如zh_cn、fr就去localizations/目錄加載對應(yīng)的 XML 語言包找不到對應(yīng)文件或未聲明lang時(shí)自動回退到英文en.xml。也就是說你只需要在 HTML 源文件的根元素上寫一行l(wèi)angzh_cn整本書的目錄、章節(jié)標(biāo)簽、圖表標(biāo)題、警告框文字就會全部變成中文。語言匹配與取值邏輯位于 common.xsl 的get-localization-value模板中。這張圖來自 HTMLBook 樣張 samples/htmlbook.html展示了一本書內(nèi)嵌圖片的標(biāo)準(zhǔn)寫法——figure標(biāo)簽配合data-type語義多語言出版時(shí)同樣能被正確編號和引用。從零開始一鍵切換語言的實(shí)戰(zhàn)步驟準(zhǔn)備好倉庫后git clone https://gitcode.com/gh_mirrors/ht/HTMLBook按下面 4 步就能完成多語言配置。第一步在根元素聲明語言打開你的書稿 HTML在html標(biāo)簽上添加lang屬性html xmlnshttp://www.w3.org/1999/xhtml langzh_cn第二步確認(rèn)語言包存在檢查htmlbook-xsl/localizations/下是否有對應(yīng)文件。中文用zh_cn.xml日語用ja.xml絕大多數(shù)主流語言都已內(nèi)置。第三步運(yùn)行轉(zhuǎn)換用項(xiàng)目自帶的 XSL 樣式表如htmlbook-xsl/htmlbook.xsl處理你的書稿目錄、標(biāo)簽、標(biāo)題編號會自動采用目標(biāo)語言。第四步驗(yàn)證輸出轉(zhuǎn)換后檢查生成文檔的html lang屬性是否正確。項(xiàng)目還提供了自動化測試?yán)?lang-declarations-htmlbook.xspec專門驗(yàn)證不同lang聲明場景下的輸出結(jié)果。語言代碼速查表別再寫錯 lang 屬性本地化文件命名遵循 IETF 語言標(biāo)簽慣例寫錯代碼會靜默回退到英文務(wù)必對照下表目標(biāo)語言lang 值目標(biāo)語言lang 值簡體中文zh_cn英語en繁體中文zh_tw德語de法語fr西班牙語es日語ja韓語ko俄語ru葡萄牙語pt意大利語it荷蘭語nl注意方言寫法巴西葡萄牙語是pt_br拉丁塞爾維亞語是sr_Latn孟加拉語印度變體是bn_in——全部使用下劃線連接而不是連字符。語言包不夠用怎么辦自定義本地化內(nèi)置 80 語言覆蓋了絕大多數(shù)場景但如果你的讀者使用小語種比如低地德語nds、世界語eo、拉丁語la這些其實(shí)也內(nèi)置了或者你想調(diào)整某些術(shù)語的譯法完全可以自定義復(fù)制一個現(xiàn)有語言包比如en.xml改名為你的語言代碼修改l:l10n根元素的language和english-language-name屬性逐條改寫gentext的text值把文件放回htmlbook-xsl/localizations/目錄即可生效。想控制語言包加載路徑還可以通過localizations-dir參數(shù)指定自定義目錄默認(rèn)值就是localizations/見 param.xsl。多語言出版常見問題排錯Q1明明寫了 lang輸出卻還是英文先檢查lang值是否與文件名完全一致大小寫敏感再確認(rèn)語言包文件是否存在于localizations/目錄最后確認(rèn)lang寫在了html或body上——寫在其他元素上不會被識別。Q2轉(zhuǎn)換后lang屬性丟失了新版 htmlbook.xsl 會自動在輸出文檔的html上補(bǔ)充lang與xml:lang屬性若你的版本較舊可手動補(bǔ)寫。Q3能否一本書同時(shí)出多種語言完全可以。同一份內(nèi)容維護(hù)多個語言版本每個版本聲明各自的lang分別轉(zhuǎn)換即可樣式與結(jié)構(gòu)完全復(fù)用?？偨Y(jié)從寫作到全球發(fā)行的最短路徑HTMLBook 把用 HTML 寫書和多語言出版這兩件事做到了極致簡單不需要額外配置工具鏈不需要逐字翻譯界面文字只要聲明lang屬性80 語言的本地化能力即刻生效。無論你想出版中文技術(shù)手冊、英文專著還是多語種電子書HTMLBook 都是一條從寫作到全球發(fā)行的高效路徑?，F(xiàn)在就克隆倉庫動手寫你的第一本多語言書籍吧【免費(fèi)下載鏈接】HTMLBookLets write books in HTML!項(xiàng)目地址: https://gitcode.com/gh_mirrors/ht/HTMLBook創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考