{"id":29630932,"url":"https://github.com/timcsy/twbible","last_synced_at":"2025-10-16T01:06:35.299Z","repository":{"id":298543794,"uuid":"1000024261","full_name":"timcsy/twbible","owner":"timcsy","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-11T17:20:23.000Z","size":10905,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-11T18:01:09.673Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timcsy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-11T06:42:46.000Z","updated_at":"2025-06-11T17:20:27.000Z","dependencies_parsed_at":"2025-06-11T18:01:13.760Z","dependency_job_id":"61a50ee9-33d7-4093-a41e-ea36064f6f12","html_url":"https://github.com/timcsy/twbible","commit_stats":null,"previous_names":["timcsy/twbible"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/timcsy/twbible","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timcsy%2Ftwbible","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timcsy%2Ftwbible/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timcsy%2Ftwbible/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timcsy%2Ftwbible/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timcsy","download_url":"https://codeload.github.com/timcsy/twbible/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timcsy%2Ftwbible/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266287824,"owners_count":23905461,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-21T11:07:15.593Z","updated_at":"2025-10-16T01:06:30.266Z","avatar_url":"https://github.com/timcsy.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 台語聖經朗讀\n\n一個現代化的台語聖經線上閱讀與朗讀應用程式。\n\n## 功能特色\n\n- 📖 **多版本對照**：白話字、台語羅馬字、台語漢字、和合本\n- 🎵 **智慧音頻系統**：優先使用本地音檔，自動切換線上音檔\n- 📱 **響應式設計**：完美適配桌面、平板、手機\n- 🌙 **主題切換**：支援淺色/深色主題\n- 🔖 **書籤管理**：儲存和管理喜愛的經文\n- ⌨️ **快捷鍵導航**：方便的鍵盤操作\n- 🎛️ **浮動播放器**：緊湊的音頻控制介面，優化按鈕響應式設計\n- 📍 **章節導航**：便捷的章節和經文切換\n- 🔄 **A-B重複播放**：設定區間重複播放，方便學習和記憶\n\n## 快速開始\n\n### 1. 下載聖經資料 (首次使用)\n\n需要先安裝 [V 語言](https://vlang.io/)\n\n```bash\n# 下載指定書卷 (例如馬太福音)\nv run crawler.v 太\n\n# 下載所有書卷\nv run crawler.v\n```\n\n### 2. 啟動網頁應用\n\n```bash\n# 方法一：Python 3\npython3 -m http.server 8000\n\n# 方法二：Node.js (需要安裝 serve)\nnpx serve -p 8000\n\n# 方法三：PHP\nphp -S localhost:8000\n```\n\n然後在瀏覽器開啟：`http://localhost:8000`\n\n## 使用爬蟲下載資料\n\n### 下載單一書卷\n```bash\nv run crawler.v 太    # 下載馬太福音\nv run crawler.v 詩    # 下載詩篇\nv run crawler.v 創    # 下載創世記\n```\n\n### 下載所有書卷\n```bash\nv run crawler.v       # 下載全部66卷書\n```\n\n### 常用書卷代碼\n- **新約**: 太、可、路、約、徒、羅、林前、林後、加、弗、腓、西、帖前、帖後、提前、提後、多、門、來、雅、彼前、彼後、約一、約二、約三、猶、啟\n- **舊約**: 創、出、利、民、申、書、士、得、撒上、撒下、王上、王下、代上、代下、拉、尼、斯、伯、詩、箴、傳、歌、賽、耶、哀、結、但、何、珥、摩、俄、拿、彌、鴻、哈、番、該、亞、瑪\n\n## 檔案結構\n\n### 核心檔案\n- `index.html` - 主要 HTML 檔案\n- `vue-app.js` - Vue.js 應用程式邏輯\n- `data-loader.js` - 聖經資料載入器\n- `styles.css` - 樣式表\n\n### 爬蟲工具\n- `crawler.v` - V 語言聖經爬蟲 \n\n### 資料目錄\n- `bible_data/` - 聖經資料和音頻檔案\n  - `{書卷}/chapter_{章節}.json` - 經文資料\n  - `audio/{書卷}/chapter_{章節}.mp3` - 音頻檔案\n\n## 技術規格\n\n- **前端**: Vue.js 3 (CDN)\n- **爬蟲**: V 語言\n- **樣式**: 現代 CSS (Grid, Flexbox)\n- **音頻**: Web Audio API\n- **資料格式**: JSON\n\n## 開發說明\n\n1. 爬蟲從 [信望愛聖經網](https://bible.fhl.net/) 下載資料\n2. 支援四種台語聖經版本及和合本\n3. 自動建立目錄結構並儲存 JSON 格式資料\n4. 包含延遲機制避免伺服器負載過重\n5. **智慧音頻載入系統**：\n   - 🎯 優先載入本地下載的音檔（`bible_data/audio/` 目錄）\n   - 🌐 如果本地音檔不存在，自動切換到線上音檔\n   - 📡 線上音檔來源：`https://media.fhl.net/wutai/{book_id}/{book_id}_{chapter:03d}.mp3`\n   - 🔄 播放失敗時會自動重新嘗試載入和播放\n   - 🎛️ 優化的浮動播放器設計，防止按鈕壓縮\n   - 📱 完全響應式的音頻控制介面\n\n## 系統需求\n\n- [V 語言](https://vlang.io/) - 用於運行爬蟲\n- 現代網頁瀏覽器 - 支援 ES6+ 和 Web Audio API\n- 本地 HTTP 伺服器 - Python、Node.js 或 PHP\n\n## 參考資料\n\n- [信望愛聖經閱讀](https://bible.fhl.net/new/read.php?chineses=%E5%A4%AA\u0026strongflag=0\u0026SSS=0\u0026nodic=0\u0026VERSION1=unv\u0026VERSION16=bklcl\u0026VERSION27=tghg\u0026VERSION32=bklcl\u0026VERSION33=bklhl\u0026TABFLAG=1\u0026nodic=0\u0026chap=1)\n- [台語台南腔有聲聖經](https://bkbible.fhl.net/new/audio_hb.php?version=15)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimcsy%2Ftwbible","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimcsy%2Ftwbible","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimcsy%2Ftwbible/lists"}