AdminLTE 3.x 中文文档

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


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


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

【3.x】

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

  • 将各种类型字典进行了拆分
字典文件名说明
dict.txt示例页面
dict_js.txt示例页面的JS文件
docs_dict.txtHTML 模板文档页面
docs_md_dict.txt文档 md 文件
docs_yml_dict.txt文档 yml 配置文件
  • bat_trans.php 支持命令行和任务配置
参数说明
run_path运行目录
dict_file字典文件名
ext_file待处理的文件扩展名
ignore_path忽略的目录
// 设置永不超时
set_time_limit(0);

// 判断是否 CLI 方式
$is_cli = substr(php_sapi_name(), 0, 3) == 'cli' ? TRUE : FALSE;

// 非 CLI 方式下 发送头
if (!$is_cli) header("Content-type: text/html; charset=utf-8");

// 定义任务配置
$jobs_list = [
    'HTML' => ['run_path' => './', 'dict_file' => './dict.txt', 'ext_file' => '.html', 'ignore_path' => '/docs,/plugins'],
    'JS' => ['run_path' => './', 'dict_file' => './dict_js.txt', 'ext_file' => '.js', 'ignore_path' => '/docs,/plugins,/build'],
    'docs_md' => ['run_path' => './', 'dict_file' => './docs_md_dict.txt', 'ext_file' => '.md', 'ignore_path' => ''],
    'docs_html' => ['run_path' => './docs/', 'dict_file' => './docs_dict.txt', 'ext_file' => '.html', 'ignore_path' => ''],
    'docs_yml' => ['run_path' => './docs/', 'dict_file' => './docs_yml_dict.txt', 'ext_file' => '.yml', 'ignore_path' => ''],
];

// 初始化类
$trans = new Transer(['ignore_path' => 'docs,plugins']);

$command = $is_cli ? (isset($argv[1]) ? $argv[1] : '') : (isset($_GET['command']) ? $_GET['command'] : '');
if (empty($command)) die("需要额外参数 backup、start、restore、debug。浏览器使用请传递 command 参数。");

foreach ($jobs_list as $param) {
    // 设置任务参数
    $trans->setConf($param);

    // 开始执行
    // 参数有 backup start restore debug
    $res = $trans->startRun($command, $param['run_path']);

    if ($res['status']) {
        echo implode('', $res['log']);
    } else {
        echo $res['msg'];
    }
    echo $trans->BR.$trans->BR;
}

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

/bat_trans.php?command=start

命令行方式:

需要 PHP 环境,建议 <=7.1,并加入环境变量。

cd /d E:\stay_check_lte3\lte3\AdminLTE\AdminLTE-3.x
php bat_trans.php start>trans.log
参数说明
start执行替换操作
backup执行替换并备份源文件
restore还原备份的文件
debug调试
  • AdminLTE 3 文档使用了 Ruby jekyll

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

  • ionicframework CSS 使用了国内源

ionicframework 替换为了 bootcss。
在 dict.txt 中搜索 ionicframework.com 以进行移除。(移除所在奇数行与偶数行

  • google 字典使用了本地数据

在 dict.txt 中搜索 googleapis.com 以进行移除。(移除所在奇数行与偶数行

  • 演示页面、文档某些链接替换到了本地文件

  • 表格、日历、编辑器插件直接使用本地语言

【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 文件的替换也是这样。不同处是筛选的文件类型不同,使用的字典文件不同。

好了,就这些。


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

GitHub:https://github.com/wangyouworld/AdminLTE_CN/releases

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

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


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

Timeout  86400

即,超时时间为 1天。