TUTORIAL-DRAW-AND-PLAY.txt,中英双语纯文本,1305 行 / 64 KB。
内容按真实界面元素写(对照 web/index.html 与 web/js/app.js 的实际按钮 / 交互):
- A 开始之前:三件必须做完的事(连接设备 / 挂载镜像 / 手机在手边)
- B 界面总览:四块区域 + 三个最关键按钮
- C 地图操作:平移缩放全览、切换底图、快速定位到坐标
- D 三种造轨迹方式
D1 折线绘制(点击加点、双击或 Esc 结束、至少 2 点)
D2 途经点 + OSRM 路线规划(拖拽排序、双击改坐标、改完要重新加载)
D3 导入 GPX
- E 编辑:撤销 / 删除 / 移动 / 排序
- F 出行模式(驾车/骑行/步行/飞行)与播放倍速(0.1x-50x)的区别
- G 真实感参数逐个讲解:漂移 / 速度浮动 / 节奏抖动 / 位移推算速度 / 粗差跳点
- H 开始播放:前置检查清单 + 逐步现象 + 失败提示对照
- I 播放中控制:暂停 / 继续 / 拖动跳转 / 停止 的区别
- J 结束与恢复真实定位(三种方式 + 恢复不了的例外)
- K 保存复用(localStorage 与 GPX 的区别)
- L 快捷键总表
- M 常见问题(含错误提示原文对照)
- N 参数速查表
编码:UTF-8 with BOM + CRLF(记事本友好),.gitattributes 锁定 eol=crlf。
README.md / README.en.md 加入口,Location.spec 随 Windows 包一起装到安装目录。
63 lines
2.1 KiB
Plaintext
63 lines
2.1 KiB
Plaintext
# 统一换行符,避免 Windows 与 macOS 互相污染。
|
||
#
|
||
# 背景:本仓库现在同时支持 macOS 与 Windows。
|
||
# Windows 上 core.autocrlf=true 时,若没有本文件,Shell 脚本会被写成 CRLF ——
|
||
# 而 CRLF 的 .sh 在 macOS/Linux 上会直接报
|
||
# `bad interpreter: /bin/bash^M: no such file or directory`
|
||
# 反过来,PowerShell 脚本写成 LF 虽然多数情况能跑,但保持一致更省事。
|
||
#
|
||
# 注意:本文件**只影响之后新增/修改的文件**,不会重写历史。不要执行
|
||
# `git add --renormalize .`,那会把整个仓库的换行符翻一遍,产生巨大无意义 diff。
|
||
|
||
# 默认:交给 git 自动判断,并在仓库里统一存成 LF
|
||
* text=auto
|
||
|
||
# 本文件自身
|
||
.gitattributes text eol=lf
|
||
|
||
# Shell 脚本必须 LF(macOS / Linux 直接执行)
|
||
*.sh text eol=lf
|
||
*.bash text eol=lf
|
||
|
||
# PowerShell 脚本用 CRLF(Windows PowerShell 5.1 的习惯)
|
||
# ⚠️ scripts/*.ps1 是 **UTF-8 with BOM**:PowerShell 5.1 只有看到 BOM 才按 UTF-8
|
||
# 解析,否则会按系统 ANSI 代码页读,中文乱码并直接语法报错。
|
||
# 编辑这两个文件时务必保留 BOM。git 不会动 BOM,这里只锁换行符。
|
||
*.ps1 text eol=crlf
|
||
|
||
# Python / 前端 / 文档:LF
|
||
*.py text eol=lf
|
||
*.js text eol=lf
|
||
*.css text eol=lf
|
||
*.html text eol=lf
|
||
*.json text eol=lf
|
||
*.md text eol=lf
|
||
*.txt text eol=lf
|
||
*.yml text eol=lf
|
||
*.yaml text eol=lf
|
||
|
||
# 面向 Windows 用户「直接用记事本打开」的纯文本说明:CRLF + UTF-8 BOM。
|
||
# git 不碰 BOM;这里只锁换行符。(后面的规则覆盖前面的,所以放在 *.txt 之后。)
|
||
USAGE.txt text eol=crlf
|
||
|
||
# 安装包脚本:CRLF
|
||
*.iss text eol=crlf
|
||
*.isl text eol=crlf
|
||
*.nsi text eol=crlf
|
||
*.bat text eol=crlf
|
||
*.cmd text eol=crlf
|
||
|
||
# 二进制:不要做任何换行转换
|
||
*.icns binary
|
||
*.ico binary
|
||
*.png binary
|
||
*.jpg binary
|
||
*.jpeg binary
|
||
*.dmg binary
|
||
*.dll binary
|
||
*.exe binary
|
||
*.zip binary
|
||
*.plist binary
|
||
*.trustcache binary
|
||
TUTORIAL-DRAW-AND-PLAY.txt text eol=crlf
|