Skip to content

标题映射配置管理

概述

title-mapping.json 文件用于管理App内嵌模式下特定FAQ页面的设备型号标题映射。当App通过URL参数引用FAQ页面时，系统会根据设备型号自动替换页面标题，同时移除导航栏和侧边栏。

当前支持的FAQ页面

  1. 设备离线问题 - /faq/offline/device/
  2. 传感器数据不准确问题 - /faq/measure/inaccurate-monitoring-data/

文件结构

{
    "device_titles": {},
    "page_titles": {
        "offline_device": {
            "h5lite": "My H5Lite is Offline. What should I Do?",
            "h5pro": "My H5Pro is Offline. What should I Do?",
            "ns1": "My NS1 is Offline. What should I Do?"
        },
        "measure_inaccurate": {
            "st5": "My ST5 Sensor is inaccurate. What should I do?",
            "ms1": "My MS1 Sensor is inaccurate. What should I do?",
            "st6": "My ST6 Sensor is inaccurate. What should I do?",
            "st8": "My ST8 Sensor is inaccurate. What should I do?",
            "st9": "My ST9 Sensor is inaccurate. What should I do?",
            "ls3": "My LS3 Sensor is inaccurate. What should I do?"
        }
    }
}

如何添加新设备型号

为现有FAQ页面添加新设备

在相应的页面类型下添加新设备型号：

"page_titles": {
    "offline_device": {
        "h5lite": "My H5Lite is Offline. What should I Do?",
        "h5pro": "My H5Pro is Offline. What should I Do?",
        "ns1": "My NS1 is Offline. What should I Do?",
        "new_device": "My New Device is Offline. What should I Do?"  // 新增
    },
    "measure_inaccurate": {
        "st5": "My ST5 Sensor is inaccurate. What should I do?",
        "ms1": "My MS1 Sensor is inaccurate. What should I do?",
        "new_sensor": "My New Sensor is inaccurate. What should I do?"  // 新增
    }
}

如何添加新FAQ页面

1. 在 page_titles 中添加新页面类型

"page_titles": {
    "offline_device": { /* ... */ },
    "measure_inaccurate": { /* ... */ },
    "new_faq_page": {
        "h5pro": "My H5Pro New Issue Title",
        "h5lite": "My H5Lite New Issue Title",
        // ... 其他设备
    }
}

2. 更新JavaScript代码

在 extra.js 的 getTitleForPage 函数中添加页面路径检测：

// 根据页面路径确定页面类型（仅两处FAQ）
if (pagePath.includes('/faq/offline/device/')) {
    pageType = 'offline_device';
} else if (pagePath.includes('/faq/measure/inaccurate-monitoring-data/')) {
    pageType = 'measure_inaccurate';
} else if (pagePath.includes('/faq/new-page/')) {  // 新增
    pageType = 'new_faq_page';
}

使用示例

App内嵌模式URL格式

设备离线问题页面：

https://doc.mocreo.com/faq/offline/device/?app=true&hub=h5pro
https://doc.mocreo.com/faq/offline/device/?app=true&hub=h5lite
https://doc.mocreo.com/faq/offline/device/?app=true&hub=ns1

传感器数据不准确问题页面：

https://doc.mocreo.com/faq/measure/inaccurate-monitoring-data/?app=true&hub=st5
https://doc.mocreo.com/faq/measure/inaccurate-monitoring-data/?app=true&hub=ms1
https://doc.mocreo.com/faq/measure/inaccurate-monitoring-data/?app=true&hub=st6

支持的参数

  • app=true - 启用App内嵌模式（移除顶部导航栏、侧边栏和页脚）
  • hub=<device_type> - 指定设备型号

正常访问（无参数）

直接访问原链接保持完整界面和原标题：

https://doc.mocreo.com/faq/offline/device/
https://doc.mocreo.com/faq/measure/inaccurate-monitoring-data/

维护建议

  1. 设备型号命名：使用小写字母，与产品型号保持一致
  2. 标题格式：保持一致的格式
  3. 设备离线："My [Device] is Offline. What should I Do?"
  4. 传感器不准确："My [Device] Sensor is inaccurate. What should I do?"
  5. 测试：添加新设备后，使用相应的URL参数测试标题是否正确显示
  6. 备份：修改前建议备份配置文件

故障排除

如果标题没有正确显示：

  1. 检查设备型号是否在配置文件的对应页面类型中存在
  2. 检查页面路径是否完全匹配（注意路径末尾的斜杠）
  3. 查看浏览器控制台是否有JavaScript错误
  4. 确认配置文件格式是否正确（JSON格式）
  5. 确认URL参数格式：?app=true&hub=<device_type>

当前限制

  • 仅支持两个特定的FAQ页面
  • 需要手动在JavaScript中添加新页面的路径检测
  • 设备型号需要在配置文件中预先定义