josharsh/md-pdf-md

Add more helpful error messages for common CLI mistakes

開放

#2 建立於 2025年10月30日

在 GitHub 查看
 (0 則留言) (0 個反應) (0 位負責人)TypeScript (2 個分叉)auto 404
clienhancementgood first issuehelp wanted

倉庫指標

星標
 (7 顆星)
PR 合併指標
 (30 天內沒有已合併 PR)

描述

Make error messages more user-friendly when users make common mistakes.

Tasks:

  • Add specific error when file doesn't exist
  • Add hint when Ollama is not running (for PDF→MD)
  • Add suggestion when wrong file type is provided
  • Improve error formatting with colors (using chalk)

Files to modify:

  • src/cli.ts
  • src/converters/pdf-to-markdown.ts

Good First Issue: Simple TypeScript changes with clear requirements!

貢獻者指南

研究方向
檢查 src/cli.ts 和 src/converters/pdf to markdown.ts，找出生成錯誤訊息的位置。添加具體檢查：檔案存在性、Ollama 運行狀態、檔案類型驗證。使用 chalk 進行彩色輸出。
技術棧
typescript
領域
cli
議題類型
功能
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
2
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-3 小時
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
新近可參與
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
清晰
前置要求
GitTypeScript
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
85