docfd

Docfd

TUI 여러 줄 퍼지 문서 찾기

텍스트 파일, PDF, DOCX 등에 대한 대화형 grep을 생각해보세요. 그러나 정규식 및 줄 기반이 아닌 단어/토큰 기반이므로 여러 줄을 쉽게 검색할 수 있습니다.

Docfd는 일반적인 텍스트 편집기 및 PDF 뷰어와의 통합을 통해 좋은 UX를 제공하는 것을 목표로 합니다. 따라서 키를 한 번만 누르면 검색 결과로 바로 이동할 수 있습니다.

---

특징

• 멀티스레드 인덱싱 및 검색

• 여러 파일의 여러 줄 퍼지 검색

• 선택한 검색 결과 주변의 조각을 표시하는 콘텐츠 보기 창

• 텍스트 편집기 및 PDF 뷰어 통합

• 편집 가능한 명령 기록 - 텍스트 편집기에서 작업을 다시 작성/계획

• 검색 범위 축소 - 현재 검색 결과를 기반으로 다음 검색 범위를 제한합니다.

• 클립보드 통합

설치

Linux 및 macOS용으로 정적으로 연결된 바이너리는 GitHub 릴리스를 통해 사용할 수 있습니다.

Docfd는 다음 Linux용 플랫폼에도 패키지되어 있습니다.

• 오팜
• kseistrup의 AUR( docfd-bin )
• Chewblacka의 Nix( docfd )

현재 Windows에서 Docfd를 사용하는 유일한 방법은 WSL을 이용하는 것입니다.

패키저 참고 사항 : 빌드용 OCaml 도구 체인 외부(소스에서 패키징하는 경우) Docfd는 전체 기능을 위해 런타임에 다음 외부 도구도 필요합니다.

• PDF 지원을 위한 poppler-utils 의 pdftotext
• .epub , .odt , .docx , .fb2 , .ipynb , .html 및 .htm 파일 지원을 위한 pandoc
• 파일 선택 메뉴의 경우 fzf
• Wayland의 클립보드 지원을 위한 wl-clibpard
• X11의 클립보드 지원을 위한 xclip

기본 사용법

Docfd의 일반적인 사용법은 관심 있는 디렉터리로 cd 하고 docfd 직접 실행하거나 경로를 인수로 지정하는 것입니다.

 docfd [PATH]...

경로 목록에는 디렉터리가 포함될 수 있습니다. 목록의 각 디렉터리는 기본적으로 다음 확장자를 가진 파일을 반복적으로 검색합니다.

• 여러 줄 검색 모드의 경우:
  • .txt , .md , .pdf , .epub , .odt , .docx , .fb2 , .ipynb , .html , .htm
• 단일 행 검색 모드의 경우:
  • .log , .csv , .tsv

--exts 및 --single-line-exts 통해 사용할 파일 확장자를 변경하거나 --add-exts 및 --single-line-add-exts 통해 확장자 목록에 추가할 수 있습니다.

목록 PATH 가 비어 있으면 Docfd는 기본적으로 현재 디렉터리를 검색합니다 . 다음 중 하나가 사용되지 않는 한: --paths-from , --glob , --single-line-glob .

선적 서류 비치

더 많은 예제/요리책 및 기술 세부 사항은 GitHub Wiki를 참조하세요.

제한사항

• PDF 뷰어는 셸을 통해 백그라운드에서 호출되므로 PDF 파일에는 파일 자동 다시 로드가 지원되지 않습니다. 아래 나열된 방법으로 이를 적절하게 지원할 수 있지만 잠재적으로 거의 이득이 없기 때문에 많은 엔지니어링이 필요합니다.

  • Docfd는 다시 시작하기 전에 PDF 뷰어가 완전히 종료될 때까지 기다립니다. 하지만 이로 인해 서로 다른 PDF 뷰어 인스턴스에서 동시에 여러 검색 결과를 볼 수 없습니다.

  • Docfd는 시작된 PDF 뷰어를 완전히 관리하지만 Docfd가 종료되면 이러한 뷰어가 닫힙니다.

  • Docfd는 쉘을 통해 PDF 뷰어를 호출하므로 Docfd가 종료될 때 열려 있습니다. 대신 Docfd는 PDF 뷰어의 프로세스 ID를 통해 여전히 실행 중인지 주기적으로 확인하지만 이를 위해서는 포크 처리가 필요합니다.

  • 파일과 상호 작용하는 PDF 뷰어 인스턴스가 여전히 실행 중인지 추적하는 것 외에도 Docfd는 inotify 통해 또는 주기적으로 파일 수정 시간을 확인하여 파일 업데이트 처리를 설정해야 합니다.

승인

• 많은 UI/UX 토론과 제안에 대해 @lunacookies 및 @jthvai에게 큰 감사를 드립니다.
• 데모 gif와 일부 스크린샷은 vhs를 사용하여 만들어졌습니다.
• ripgrep-all은 텍스트 추출 소프트웨어 선택을 위한 참조로 사용되었습니다.
• 기능을 좁히는 결과에 대한 토론과 영감을 제공한 Marc Coquand(Stitch 저자)
• 검색 구문의 일부가 fzf에서 복사되었습니다.
• 명령 기록 편집 워크플로는 Git 대화형 리베이스 워크플로(예: git rebase -i 에서 영감을 받았습니다.