RELIVE
讓旅程，再走一次
把 GPX 與照片放進 Markdown，
在 Obsidian 和網站上，重回沿途的每個片刻。
沿著鴨川，慢慢走
選擇 MapLibre 3D，免金鑰探索立體地形。
按下播放、拖曳時間軸，或點選照片停留。
正在準備旅程。也可以先下載示範 GPX。
真實京都照片，搭配人工編排的鴨川路線與播放時間。這是功能示範，並非一次實際錄製的旅程或導航指引。此播放器使用獨立的 @kywk/react-relive React 套件。
照片有了來時路
河岸、鳥群、淺灘與飛石。
點選一個片刻，看看它在回放中的位置。
旅程，留在你的筆記
原始 GPX 和照片放在自己的 Vault。用一個 relive 區塊，串起路線、拍攝時刻與沿途故事。
同一份內容可以在 Obsidian 回放，也能經 Docusaurus 發布成網站，或用獨立 React 元件加入自己的應用程式。你的文字與檔案始終由你保存。
閱讀完整語法```relive
title: 鴨川散步
gpx: ./ride.gpx
duration: 40
stopDuration: 3
photos:
- src: ./river.jpg
time: '2026-10-29T09:10:00+09:00'
caption: 在河邊停一會兒
```用照片時間或 GPS 配對軌跡，並保留每個停留片刻。
從你的旅程開始
程式採 MIT 開源授權。
目前可從 GitHub Release 取得安裝檔。
在自己的 Vault 回放
下載 main.js、manifest.json、styles.css，放入 Vault 的 .obsidian/plugins/relive/。重新載入 Obsidian，並啟用 Relive。
已收錄於 Obsidian Community，亦可從 GitHub Release 手動安裝。
下載安裝檔把旅行誌發布成網站
從 npm 安裝公開套件，再加入網站設定。
npm install @kywk/relive使用 @kywk/relive/integration，指定公開附件目錄；建置時可選用 gentle 瘦身，Vault 原檔保持不變。
在 React 應用中重走旅程
獨立套件 @kywk/react-relive 支援 Vite、Next.js 等 React 專案，不需要 Docusaurus。可直接從 npm 安裝。
npm install @kywk/react-relive
import {Relive} from '@kywk/react-relive';
import '@kywk/react-relive/styles.css';
<Relive journey={journey} />journey 包含已解析的軌跡、照片與事件。React 元件在瀏覽器掛載地圖，卸載時釋放資源。
讓長軌跡輕一點
下載 kywk-gpx-slim-0.1.0.tgz，以 Node.js 22+ 執行。先比較各種強度，再決定怎麼精簡。
npx --offline --yes \
--package ./kywk-gpx-slim-0.1.0.tgz \
gpx-slim ride.gpx --analyze工具在本機處理 GPX，並拒絕覆寫原檔。
閱讀 CLI 說明出發前，想知道的事
我的照片會被上傳嗎？
Obsidian 中的本機照片不會由 Relive 自動上傳。發布 Docusaurus 網站時，文章引用的公開附件會進入網站產物，請只允許發布專用的 assetRoots。2D 圖磚連線到 OpenStreetMap；3D 底圖與地形連線到 OpenFreeMap、Mapterhorn。
瘦身會改變照片的位置嗎？
精簡會改變軌跡的內插位置與距離統計。只有 GPS 的照片，在停留或重訪同一位置時也可能改變播放時刻。網站建議明確選用 gentle；需要精確順序時，保留拍攝時間或關閉瘦身。
閱讀實測結果3D 地圖需要 API key 嗎？
選擇 MapLibre 3D 即可使用開放底圖、立體地形與建築輪廓，不需要 API key。首次切換才載入 3D 引擎；裝置或網路不支援時會回到 2D。這不是寫實攝影城市。Google 寫實 3D 仍是需自備 key 的選配，官方 demo 不啟用。