Skip to content

wangyouworld/AdminLTE_CN

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

欢迎使用 AdminLTE 文档!

  • 翻译采用第三方翻译工具和人工复核的方式进行。
  • 尽可能的信、达、雅; 但由于英文水平有限,翻译内容会偏离原内容。
  • 目前已经完成,AdminLTE-2.3.11、2.4.x、3.1、4.0.x 翻译工作

你可以直接在发布页下载文档。目录结构与官方提供的一致。 也可以直接在演示页查看。


当然,你也可以参与其中(请邮件:ramble AT 3vshej.cn):

【4.0.x】

基于 Bootstrap 5,该版本使用 astro 管理页面和文档。但字典格式与 2.x 一样

字典文件名 说明
astro_dict.txt 示例页面
md_dict.txt readme.md 文件
mdx_dict.txt 使用文档
  • AdminLTE 4 文档使用了 astro

如果有需要本地配置的,参见 astro 教程

使用时很简单,只需要使用以下命令:

# 安装依赖包
npm install

# 执行翻译
php bat_trans.php -c=start

# 调试运行
npm run dev

# 打包发布
npm run compile
  • 已知不同于官方的内容

链接外部的 JS、CSS,均修改为本地引用。 如果你不想使用,可以在 astro_dict.txt 中删除相关项。

【3.x】

该版本有很大变化,因此,PHP 处理程序也做了很大调整。但字典格式与 2.x 一样

字典文件名 说明
dict.txt 示例页面
dict_js.txt 示例页面的JS文件
docs_dict.txt HTML 模板文档页面
docs_md_dict.txt 文档 md 文件
docs_yml_dict.txt 文档 yml 配置文件

替换时,对字典从长到短排序,并依次替换。 对于单词,只是一个单词,单词的替换规则,是完全匹配,注意是完全匹配

  • 将各种类型字典进行了拆分
字典文件名 说明
dict.txt 示例页面
dict_js.txt 示例页面的JS文件
docs_dict.txt HTML 模板文档页面
docs_md_dict.txt 文档 md 文件
docs_yml_dict.txt 文档 yml 配置文件
  • bat_trans.php 支持命令行和任务配置
参数 说明
runPath 运行目录
dictFile 字典文件名
extFile 待处理的文件扩展名
ignorePath 忽略的目录

GET 方式: 为项目目录绑定域名,并通过域名访问:

/bat_trans.php?command=start

命令行方式: 需要 PHP 环境,建议 <=7.1,并加入环境变量。

命令行示例:

php bat_trans.php -c=执行方式 -t=[类型] -f=[文件]

cd /d E:\stay_check_lte3\lte3\AdminLTE\AdminLTE-3.x
php bat_trans.php -c=start>trans.log
-c 参数 说明
backup 运行并备份
start 执行任务
restore 还原更改,backup 后使用
test 测试替换
debug 调试输出
help 帮助

-t 参数 处理类型:传递,则仅对该类型文件翻译,值有:html、js、docs_md、docs_html、docs_yml。

-f 参数: 文件名:传递,则仅对该文件翻译。

  • AdminLTE 3 文档使用了 Ruby jekyll

如果有需要本地配置的,参见 Ruby jekyll 安装

  • 已知不同于官方的内容

文档链接地址,谷歌字体使用本地,及插件使用中文展示、其他版本文档地址等。 如果你不需要这些,在字典中删除相应项,并重新生成,即可。

dict.txt

/AdminLTE/AdminLTE-3.x/docs

/AdminLTE/AdminLTE-3.x/dist/css/google.css

/AdminLTE/AdminLTE-3.x/plugins/datatables/Chinese.json

jsgrid/i18n/jsgrid-zh-cn.js

/plugins/fullcalendar/locales/zh-cn.js

docs_dict.txt

/AdminLTE/AdminLTE-3.x/dist/css/google.css

/AdminLTE/AdminLTE-2.4/

/AdminLTE/AdminLTE-2.3.11/

/dist/css/AdminLTE.min.css

文件改名为:adminlte.min.css

生成你的文档时,更新 docs/_config.yml,如:

baseurl: /AdminLTE/AdminLTE-3.x/docs

url: https://3vshej.cn

【2.x】

项目中: bat_trans.php 为处理 html文件的程序。 dict.txt 为其字典文件。 同理,bat_trans_js.php 为处理 js文件的程序,js_dict.txt 为字典文件。

字典文件规则很简单,奇数行为源内容,偶数行为翻译的内容。程序执行方式很简单,只将,奇数行内容替换为偶数行内容。

举例:

<title>AdminLTE 2 | Dashboard</title>
<title>AdminLTE 2 | 仪表盘</title>

像这种形式,程序会先搜索是否存在内容,存在则替换,不存在,判断下一个。 找到,

<title>AdminLTE 2 | Dashboard</title>

直接替换为

<title>AdminLTE 2 | 仪表盘</title>

对于单词,只是一个单词,那么,你编辑词典时,要注意了,这个单词,要向后放,否则会造成,某些特殊项被替换掉。另外,对于单词的替换规则,是完全匹配,注意是完全匹配

同理,js 文件的替换也是这样。不同处是筛选的文件类型不同,使用的字典文件不同。

好了,就这些。


你可以在本项目分支中找到,也可以直接访问地址:

https://gitee.com/3Vshej/AdminLTE_CN/releases

或者,线上查看: http://3vshej.cn/AdminLTE/


对了,如果你使用 Apache,执行程序时,你需要修改 Apache 配置项,增加或编辑,

Timeout  86400

即,超时时间为 1天。