GeoStorymap 网站设计#

版本号：V1.0.0 版权所有：深圳市英特吉欧创新科技有限公司 更新日期：2026.03.16

版权与免责声明#

1. 本软件的所有权和相关知识产权均属于深圳市英特吉欧创新科技有限公司单独所有。
2. 用户应通过合法途径获得软件使用权，并按相关约定合法使用。
3. 用户在使用本软件过程中，因非深圳市英特吉欧创新科技有限公司原因发生的侵权或违法行为，由用户自行承担全部法律责任，深圳市英特吉欧创新科技有限公司不承担任何连带责任。
4. 未经深圳市英特吉欧创新科技有限公司书面同意或授权，任何主体不得对本软件进行改编、翻译、注释、整理、汇编、再许可、再授权等任何形式的修改或衍生操作。
5. 本手册内容如有更新或变更，恕不另行通知，深圳市英特吉欧创新科技有限公司对此不承担相关义务。

商标声明#

“深圳市英特吉欧创新科技有限公司”“GeoTwin”“Story Map”等可能为相关主体的商标或产品名称。未经书面同意或授权，不得以任何方式侵犯商标专用权。

1. 新增功能/优化项#

1.1 版本更新内容#

• 新增功能：
  • GeoTwin Story Map（故事地图）初版发布，提供故事条目的创建、检索、预览与编辑能力。
  • 提供区块化编辑能力：支持标题、文本、分割线、图片、照片墙、图片走马灯、视频、Iframe、地图游览、滚动、视差图文等内容编排。
  • 支持主题预设切换与紧凑/默认阅读间距切换。
  • 支持预览/编辑/展示模式切换，便于创作与发布。
  • 支持简体中文、繁体中文、英文三语言界面切换。
• 功能优化：待补充
• 其他变更：待补充

1.2 版本迭代记录#

版本号	更新日期	核心更新内容
V1.0.0	2026.03.16	初版正式发布，支持 Story Map 创作、预览与多语言界面（详见 1.1）

2. 使用须知#

2.1 软件运行要求#

2.1.1 浏览器与操作系统#

• 浏览器：建议使用 Chrome / Edge 的近期版本（Chromium 内核）。
• 操作系统：Windows / macOS / Linux 均可运行（以浏览器支持为准）。

2.1.2 网络要求#

• 需要访问后端接口与静态资源服务；建议在稳定网络环境下使用。
• 若存在统一认证/门户登录，需确保相关域名可访问。

2.2 访问与登录#

1. 通过统一入口访问 GeoTwin 故事板应用地址（https://portal-dev.geotwin.cn/gtstorymap/home）；
2. 若未登录，系统将跳转至统一认证页面完成登录；
3. 登录成功后进入“故事列表（Home）”页面。

2.3 界面偏好（语言/主题/字号）#

• 语言：支持简体中文（zh_CN）、繁体中文（zh_TW）、英文（en_US）。
• 主题：支持浅色/深色/跟随系统。
• 字号：支持大/中/小。

2.4 数据与权限#

• 故事条目通常按账号维度隔离（具体权限策略待补充）。
• 涉及外链（Iframe）与外部媒体时，请遵守目标站点的安全策略与授权要求。

3. 软件概述#

3.1 核心定位#

GeoTwin 故事板（Story Map）是一款面向三维场景/地图应用的网页内容编排工具，用于以“段落/区块”为单位组织图文、视频、嵌入页面与地图游览等内容，并提供预览与展示能力。

3.2 模块构成#

• 故事列表：创建、检索、编辑、删除故事条目，进入预览/编辑。
• 故事编辑器：以区块方式编辑故事内容，支持主题切换与保存。
• 故事预览：以阅读模式展示故事内容，支持紧凑/默认间距。
• 系统操作区：语言、主题、字号、消息与用户菜单等入口（根据部署配置可有所不同）。

3.3 核心优势#

• 结构化编辑：区块类型覆盖标题、文本、图片、视频、Iframe、图表、地图游览等常见叙事组件。
• 主题预设：内置多套主题外观，快速统一风格。
• 多语言界面：支持简中/繁中/英文切换（具体文案覆盖范围以版本为准）。
• 轻量发布：通过链接参数切换预览/展示模式，便于嵌入或分享。

4. 格式支持#

4.1 输入数据格式#

数据类型	支持格式/形态	备注说明
图片文件	JPEG、PNG、GIF、WebP	单文件大小上限默认 5MB（可随部署调整）
视频文件	MP4、WebM、Ogg	单文件大小上限默认 50MB（可随部署调整）
Iframe 嵌入	URL	受浏览器同源/CSP/https 策略影响，部分站点可能无法嵌入
图表数据	内置数据结构	以 X 轴数组 + 多系列数值数组为主
地图游览媒体	图片/视频 URL	可为每个场景配置媒体与内容区块

4.2 输出数据格式#

成果类型	支持格式/形态	备注说明
预览页面	URL（mode=preview）	示例：/{itemId}?mode=preview
编辑页面	URL（mode=edit）	示例：/{itemId}?mode=edit
展示页面	URL（mode=view）	展示模式通常隐藏顶栏（以实现为准）
内容存储	JSON（StoryContent v1.0.0）	由系统存储为故事条目的 option 字段（实现细节随版本变化）

5. 软件介绍#

5.1 核心模块操作#

5.1.1 故事列表（Home）#

• 新增：创建新的故事条目并进入编辑流程。
• 查询：按关键词与时间范围筛选故事列表。
• 查看：进入故事预览页面查看内容效果。
• 编辑：进入故事编辑器修改内容并保存。
• 删除：删除故事条目（权限与回收策略待补充）。

5.1.2 顶栏（TopBar）#

• 返回：回到故事列表。
• 紧凑/默认：在预览模式切换内容间距（compact）。
• 主题：在编辑模式选择主题预设。
• 预览/编辑：在预览与编辑之间切换。
• 保存：保存当前故事内容。

5.1.3 区块类型（Blocks）#

• 标题：支持 1~4 级标题，可选副标题与对齐。
• 文本：支持段落文本、字号、行高与对齐。
• 分割线：支持实线/虚线及颜色、宽度等参数。
• 图片：支持上传/引用图片并设置显示模式与对齐。
• 照片墙：以网格/拼贴形式展示多张图片。
• 图片走马灯：以轮播形式展示多张图片及标题/副标题。
• 视频：支持上传/引用视频并设置封面、尺寸与播放参数。
• Iframe：嵌入网页内容，支持标题、尺寸与 sandbox 等参数。
• 地图游览：按场景组织内容，可绑定媒体与区块内容。
• 滚动：按步骤组织滚动叙事，可配置媒体/iframe。
• 图表：基于内置数据结构展示统计图表。
• 视差图文：支持前景/背景媒体与分段内容面板，形成视差叙事效果。

5.2 关键流程操作#

5.2.1 创建故事#

1. 进入“故事列表（Home）”页面；

   图5-2-1-1：故事列表（Home）页面

2. 点击“新增”按钮；

   图5-2-1-2：新增故事（截图待补充）

3. 输入标题并确认创建；

   图5-2-1-3：填写标题（截图待补充）

4. 在列表中点击封面或“查看”，进入预览页。

5.2.2 进入编辑模式并保存#

1. 在预览页点击“编辑”进入编辑模式；

   图5-2-2-1：进入编辑（截图待补充） 2.（可选）在“主题”下拉中选择主题预设；

   图5-2-2-2：选择主题（截图待补充）

2. 完成编辑后点击“保存”，提示“保存成功”即完成保存。

5.2.3 添加区块内容#

1. 在编辑器中点击“添加区块/段落”入口（位置随布局可能不同）；

   图5-2-3-1：添加区块（截图待补充）

2. 选择区块类型（如：标题/文本/图片等）；

3. 填写区块参数并观察实时预览区域效果；

4. 按内容顺序调整区块位置（若支持拖拽/排序，具体以界面为准）。

5.2.4 上传图片/视频#

1. 新增“图片”或“视频”区块；
2. 点击上传区域选择本地文件；
3. 上传成功后，调整对齐、尺寸与显示模式（object-fit）；
4. 保存并切换到预览确认展示效果。

5.2.5 预览与展示（分享链接）#

1. 点击“预览”切换到阅读模式； 2.（可选）开启“紧凑”间距以获得更紧凑的版式；
2. 使用 URL 参数切换模式：
   • 预览：/{itemId}?mode=preview
   • 编辑：/{itemId}?mode=edit
   • 展示：/{itemId}?mode=view

5.2.6 切换界面语言#

1. 在顶栏操作区点击“语言”图标；

   图5-2-6-1：语言入口（截图待补充）

2. 选择“简中 / 繁中 / English”，界面将即时切换。

5.3 常见问题处理#

• 无法进入应用或频繁跳转登录：检查统一认证状态与 Token 是否有效（待补充登录机制细节）。
• 保存失败：检查网络是否正常、接口是否可用、账号是否具备编辑权限。
• 图片/视频上传失败：检查格式与大小限制（图片默认 5MB、视频默认 50MB），并确认上传服务可达。
• Iframe 空白或报错：目标站点可能设置了禁止嵌入（X-Frame-Options/CSP），或需要 https/登录态。
• 预览间距不符合预期：检查 URL 是否包含 compact=1，或在预览页切换“紧凑/默认”。

6. 相关概念#

术语名称	定义说明
故事（Story）	一份可预览/展示的网页叙事内容，由多个区块按顺序组成
区块（Block）	故事中的最小编辑单元，如标题、图片、视频、Iframe 等
主题（Theme）	预置的视觉风格配置，用于统一页面背景、字体与组件观感
模式（Mode）	通过 URL 参数切换：编辑（edit）/预览（preview）/展示（view）
紧凑布局（compact）	预览模式下的内容间距配置，用于压缩上下留白

7. 技术支持#

• 官网地址：待补充
• 手册下载：待补充
• 联系邮箱：待补充
• 问题反馈：待补充

附录：待确认信息#

1. 软件正式名称、品牌商标、版权归属与免责声明法务措辞。
2. 应用访问地址、统一认证/登录方式、账号权限模型与数据回收策略。
3. 本版本新增功能/优化项与完整迭代记录。
4. 上传服务的实际接口、支持的文件类型/大小是否与默认配置一致。
5. 各流程对应的功能截图文件路径（./images/zh-cn/...）与命名规范（建议 原文件名.{zh_CN|zh_TW|en_US}.png）。