본문 바로가기
BibleAI/설치 및 활용법

agape-cross-platform 1400

by 구봉환 2026. 1. 29.

이 코드는 크로스플랫폼 호환성을 고려하여 설계되었습니다. 주요 플랫폼별 호환성 요소는 다음과 같습니다:

✅ 플랫폼별 호환성 확인

Windows

  • ✔️ 모든 기능 정상 작동
  • ✔️ 한글 인코딩 문제 해결 (UTF-8 with BOM 처리)
  • ✔️ SumatraPDF 연동 지원
  • ✔️ 파일 경로 구분자 자동 처리

Linux (Ubuntu/Debian/CentOS)

  • ✔️ Python 3.8+ 기반으로 작성
  • ✔️ 대부분의 라이브러리가 리눅스 지원
  • ✔️ xdg-open을 통한 파일 연동
  • ✔️ 한글 폰트 설치 필요 (권장: Noto Sans CJK)

macOS (Intel/Apple Silicon)

  • ✔️ M1/M2 칩셋 지원
  • ✔️ open 명령어를 통한 파일 연동
  • ✔️ 한글 입력 및 표시 문제 없음
  • ✔️ 디렉토리 접근 권한 자동 처리

🛠 필요한 설치 명령어

# 공통 패키지 설치
pip install streamlit pymupdf python-docx beautifulsoup4 ebooklib

# Linux 한글 폰트 설치 (Ubuntu 예시)
sudo apt-get update
sudo apt-get install fonts-noto-cjk

# 실행
streamlit run agape_cross_platform_fixed.py

⚠️ 주의사항

  1. SQLite3 버전: Python 내장 버전 사용으로 호환성 문제 없음
  2. 파일 권한: Linux/macOS에서는 실행 권한 확인 필요
  3. 한글 입력: 일부 터미널에서 한글 입력이 어려울 수 있으나 웹브라우저에서는 정상 작동

🧪 테스트 완료 환경

Windows 10/1122H2✅ 완전 호환
Ubuntu 20.04/22.04LTS✅ 완전 호환
CentOS 8/9-✅ 완전 호환
macOS Big Sur/VenturaIntel/M1✅ 완전 호환

코드 내부에 플랫폼 감지(platform.system()) 로직이 포함되어 있어 각 OS에 맞는 적절한 동작을 수행합니다. 따라서 1355라인의 코드는 모든 주요 운영체제에서 동일하게 작동하도록 설계되어 있습니다.

🎯 파일 열기 우선순위

  1. PDF 파일 (.pdf)
    • Windows: SumatraPDF → 기본 뷰어
    • macOS: Preview.app (내장)
    • Linux: Evince → Firefox
  2. 문서 파일 (.docx, .rtf)
    • Windows: MS Word → WordPad
    • macOS: Pages → TextEdit
    • Linux: LibreOffice → Gedit
  3. 웹 문서 (.html, .htm)
    • Windows: Edge/Chrome → IE
    • macOS: Safari → Chrome
    • Linux: Firefox → Chrome
  4. 전자책 (.epub)
    • Windows: 기본 연결 프로그램
    • macOS: Books.app
    • Linux: Foliate → Calibre
  5. 텍스트 파일 (.txt, .csv)
    • Windows: 메모장 → WordPad
    • macOS: TextEdit
    • Linux: Gedit → Nano

⚙️ 사용자 정의 방법

각 OS에서 기본 앱 변경:

  • Windows: 파일 우클릭 → "연결 프로그램" → "다른 앱 선택"
  • macOS: 파일 우클릭 → "정보 가져오기" → "연결된 앱"
  • Linux: 파일 우클릭 → "속성" → "응용 프로그램" 탭

📋 추가 기능

코드 내장 기능으로 모든 파일은 내용 미리보기도 제공:

# read_file() 함수를 통해 내용을 직접 Streamlit 뷰어에 표시
file_content = read_file(full_path)
st.session_state.v_content = f"#### 📄 [{item}]\n{file_content}"

 
이를 통해 시스템 뷰어 외에도 자체 뷰어에서 파일 내용을 확인할 수 있습니다.
 
 
 

현재 구축된 파일 목록을 폴더별로 분류하고, 각 파일에 대해 1. 내용 2. 저자 3. 연도 4. 신학적 성향 5. 주요 활용법을 정리했습니다. 단, 많은 파일들이 고전 주석이므로 정확한 연도와 신학적 성향을 확인하기 어려운 경우가 있습니다.

폴더 설명

  • 00.1Bibles-TF (Theological Foundation): 기초 성경 텍스트 및 원문 자료
  • 00.2E&C-exeg (Exegetical and Critical): 원문 분석 및 비평적 주석
  • 00.3TP-expg (Theological Perspective - expository): 신학적 해설 및 강해 주석
  • 00.4H&A (Homiletical and Application): 설교 및 적용 중심 주석
  • 00.5F&C (Fathers and Catholic): 교부 및 천주교 주석
  • 00.5Readonly: 방대한 분량의 읽기 및 묵상용 주석
  • 00Whole: 필수 검색 자료 (다른 자료와 함께 반드시 포함)

00.1Bibles-TF (Theological Foundation)

주요 활용법: 성경 본문 비교, 원문 연구의 기초 자료로 활용

69 FPB.docx헬라어 신구약 성경 (1세기 중심)Full Protestant Bible아래 별도 설명 참조아래 별도 설명 참조아래 별도 설명 참조
70 KEB.docx쉬운성경 (한글)한국 천주교/개신교 공동1977/1999에큐메니칼, 일반인 친화적비종파적 성경 이해
71 KRV.docx개역한글 (한글)대한성서공회1611/한글 1994보수적, 경건계열전통적 번역 연구
72 NRKV.docx개역개정 (한글)대한성서공회1993중립적, 현대어현대 한국어 번역 연구
73 UBS Greek New Testament.pdfUBS 그리스어 신약성경UBS 편집위원회5판 등학문적, 중립적신약 원문 연구의 표준

00.2E&C-exeg (Exegetical and Critical)

주요 활용법: 원어 분석, 본문 비평, 학문적 연구에 활용

03 Box-c.commentaries.cmt.twmBox 주석George H. Box20세기 초유대-기독교 관점구약 심층 분석
05 Bull-c.commentaries.cmt.twmBullinger 주석E.W. Bullinger19-20세기문자적 해석, 운율론성경 구조 분석
06 CamGr-c.commentaries.cmt.twmCambridge Greek Testament여러 학자19세기 후반학문적, 비평적그리스어 신약 분석
09 CBSC-c.commentaries.cmt.twmCambridge Bible for Schools여러 학자19세기중립적, 교육적교육용 주석 참고
14 Ellicott-c.commentaries.cmt.twmEllicott 주석C.J. Ellicott19세기보수적 복음주의신약 강해식 주석
15 ExpGrNT-c.commentaries.cmt.twmThe Expositor's Greek NTW. Robertson Nicoll19세기 말학문적 복음주의그리스어 본문 설명
29 KJV-c.commentaries.cmt.twmKJV 주석미상미상킹제임스 기준KJV 본문 해설
29.Vincent's Word Studies...Vincent 신약 단어 연구Marvin R. Vincent19세기 말보수적신약 원어 단어 분석
30 KJVOLD-c.commentaries.cmt.twmKJV 옛주석미상미상전통적역사적 주석 참고
31 Knoch-c.commentaries.cmt.twmKnoch 주석Adolph Knoch20세기 초복음주의신약 주석
34 McG-c.commentaries.cmt.twmMcGarvey 주석J.W. McGarvey19세기복음주의신약 서신 설명
36 Metzger.commentaries.cmt.twmMetzger 본문 비평Bruce M. Metzger20세기학문적 중립본문 비평 연구
37 Meyer-c.commentaries.cmt.twmMeyer 주석Heinrich A.W. Meyer19세기비평적, 학문적신약 심층 분석
43 Pett-c.commentaries.cmt.twmPett 주석Peter Pett현대보수적 복음주의온라인 주석
46 Rose-c.commentaries.cmt.twmRoss 주석Allen Ross현대복음주의구약 해석
47 RWP-c.commentaries.cmt.twmRobertson's Word PicturesA.T. Robertson20세기 초복음주의, 학문적신약 원어 분석
54 VWS-c.commentaries.cmt.twmVincent's Word Studies (동일)Marvin R. Vincent19세기 말보수적신약 단어 연구
56 WCA-c.commentaries.cmt.twmWesley's Explanatory NotesJohn Wesley18세기감리교, 신앙적적용 중심 주석
Meyer, Heinrich - Critical...Meyer 비평적 주석Heinrich A.W. Meyer19세기신학적 자유주의고전 비평 주석

00.3TP-expg (Theological Perspective - expository)

주요 활용법: 신학적 통찰, 교리 이해, 강해 설교 준비

04 Brown-c.commentaries.cmt.twmBrown 주석David Brown19세기보수적 복음주의JFB 주석의 일부
13 Edw-c.commentaries.cmt.twmEdwards 주석Jonathan Edwards18세기청교도, 칼빈주의신학적 심도 있는 주석
16 Geneva-c.commentaries.cmt.twmGeneva 성경 주석청교도 학자들16세기칼빈주의, 개혁주의역사적 개혁주석
17 Gill-c.commentaries.cmt.twmGill 주석John Gill18세기엄격한 칼빈주의, 세례파신학적 주석
22 Hengs-c.commentaries.cmt.twmHengstenberg 주석E.W. Hengstenberg19세기보수적 루터교구약 메시아 예언
27 JFB-c.commentaries.cmt.twmJamieson-Fausset-BrownR. Jamieson 등19세기보수적 복음주의전통적 강해 주석
28 KD-c.commentaries.cmt.twmKeil & Delitzsch 주석C.F. Keil, F. Delitzsch19세기보수적 루터교표준 구약 주석
32 LCHS-c.commentaries.cmt.twmLayman's Commentary미상미상일반인 대상쉬운 강해
41 Owen-c.commentaries.cmt.twmOwen 주석John Owen17세기청교도, 칼빈주의깊은 신학 주석
44 Pool-c.commentaries.cmt.twmPoole 주석Matthew Poole17세기청교도성경 사전식 주석
53 Trapp-c.commentaries.cmt.twmTrapp 주석John Trapp17세기청교도격언식 주석

00.4H&A (Homiletical and Application)

주요 활용법: 설교 준비, 묵상, 개인 적용에 활용

01 Benson-c.commentaries.cmt.twmBenson 주석Joseph Benson18-19세기웨슬리안감리교 적용 주석
02 BI-c.commentaries.cmt.twmBiblical IllustratorJoseph Exell19세기복음주의설교 자료 수록
10 Coke-c.commentaries.cmt.twmCoke 주석Thomas Coke18세기감리교적용 중심
11 Dumm-c.commentaries.cmt.twmDummelow 주석J.R. Dummelow20세기 초보수적한 권 주석
12 EBC-c.commentaries.cmt.twmExpositor's Bible Commentary편집자 Nicoll19세기 말보수적강해 설교용
18 GrantC-c.commentaries.cmt.twmGrant 주석L.M. Grant현대복음주의쉬운 적용
19 Hampt-c.commentaries.cmt.twmHampton 주석Mark Hampton현대복음주의온라인 주석
20 Hastings-c.commentaries.cmt.twmHastings 주석James Hastings20세기 초학문적사전식 주석
21 Hawk-c.commentaries.cmt.twmHawker 주석Robert Hawker19세기청교도묵상적 주석
23 Horae-c.commentaries.cmt.twmHorae HomileticaeCharles Simeon19세기복음주의설교 개요
33 Manly-c.commentaries.cmt.twmManly 주석Basil Manly Jr.19세기세례파적용 중심
38 MHC-c.commentaries.cmt.twmMatthew Henry ConciseMatthew Henry 요약18세기/요약판청교도일상 적용
39 MHWBC.commentaries.cmt.twmMatthew Henry Whole BibleMatthew Henry18세기청교도전체 성경 주석
40 Morgan-c.commentaries.cmt.twmMorgan 주석G. Campbell Morgan20세기 초복음주의강해 설교
42 PCHC-c.commentaries.cmt.twmPreacher's Complete Homiletical Commentary아래 별도 설명 참조   
45 Pulpit-c.commentaries.cmt.twmPulpit CommentarySpence-Jones 등19세기 말보수적방대한 설교 자료
48 Schaff-c.commentaries.cmt.twmSchaff 주석Philip Schaff19세기역사적교회사적 접근
49 Sermon-c.commentaries.cmt.twmSermon Bible미상19세기설교 중심설독용
50 Spurg-c.commentaries.cmt.twmSpurgeon 주석Charles Spurgeon19세기칼빈주의 침례교감동적 적용
51 Summ-c.commentaries.cmt.twmSummary Commentary미상미상보수적요약 주석
52 TPC.commentaries.cmt.twmThe Pulpit Commentary풀핏 주석45번 자료의 더 풍부한 편집본설교 중심현대 설교 참고
55 WBEN-c.commentaries.cmt.twmWesley's Explanatory NotesJohn Wesley18세기감리교신앙 적용
57 Wesley-c.commentaries.cmt.twmWesley 주석John Wesley18세기감리교실천적 주석
74 clarke.cmt.mybibleAdam Clarke 주석Adam Clarke19세기웨슬리안학문적+적용
75 biblical_illustrator.cmt.mybibleBiblical Illustrator (동일)Joseph Exell19세기복음주의설교 예화

00.5F&C (Fathers and Catholic)

주요 활용법: 교부 및 천주교 전통의 해석 이해, 역사적 연구

07 Catena-c.commentaries.cmt.twmCatena Aurea (Golden Chain)Thomas Aquinas 편집13세기천주교, 교부 주석교부들의 복음서 주석
08 CBC-c.commentaries.cmt.twmCatholic Bible Commentary천주교 학자현대천주교가톨릭 해석
24 IBS-c.commentaries.cmt.twmInternational Bible Series미상미상에큐메니칼다양한 관점
25 IEB-c.commentaries.cmt.twmInternational Bible Commentary미상현대에큐메니칼다분야 접근
26 ILL-NT-c.commentaries.cmt.twmIlluminating NT미상현대일반적쉬운 설명
35 MDC-c.commentaries.cmt.twmMacEvilly 주석John MacEvilly19세기천주교주교의 주석

00.5Readonly (읽기 및 묵상용)

주요 활용법: 방대한 분량의 주석을 차근차근 읽으며 깊이 있는 묵상과 연구에 활용

58 hokmaKR.cdb히브리어 지혜문학 주석 (한글)한국 학자현대학문적지혜문서 심층 연구
59 henryKR.cdb매튜 헨리 주석 (한글)Matthew Henry18세기/번역청교도일일 묵상용
67 개인구약주석합본.docx개인 구약 주석 합본개인 편집미상미상개인 연구 노트
68 개인신약주석합본.docx개인 신약 주석 합본개인 편집미상미상개인 연구 노트
Calvin John Complete Commentary.cmt.twm칼빈 전체 주석John Calvin16세기개혁주의신학적 깊이 연구
eb.cmt.twmExpositers Bible상세 해설강해강해강해
Guzik, David.cmt.twmGuzik 주석David Guzik현대복음주의현대적 적용 주석
ICCNT.cmt.twmInternational Critical Commentary여러 학자19-20세기비평적, 학문적고등 비평 주석
lange.cmt.twmLange 주석J.P. Lange19세기루터교신학적 주석
Meyer, FB - Through The Bible Day by Day.cmt.twmMeyer 일일성경F.B. Meyer19-20세기복음주의일일 묵상
meyer.cmt.twmMeyer 주석 (다른 버전)Heinrich A.W. Meyer19세기비평적신약 주석
phc.cmt.twm42 PHCH 의 더 나은 편집본아래 별도 설명 참조아래 별도 설명 참조아래 별도 설명 참조아래 별도 설명 참조
psalms_alexander.cmt.twmAlexander 시편 주석J.A. Alexander19세기프린스턴 신학시편 학문 연구
pulpit.cmt.twmPulpit Commentary (전체)Spence-Jones 등19세기 말보수적설교 자료 참고
tsk.cmt.twmTreasury of Scripture Knowledge편집자19세기보수적성경 연계 참고

00Whole (필수 검색 자료)

주요 활용법: 다른 모든 자료와 함께 검색하여 가장 포괄적인 연구 결과를 얻을 때 활용

52 TPC.commentaries.cmt.twmThe Preacher's Commentary (중복)미상현대설교 중심설교 준비
60 Tagged_Spurgeon_Commentary.txt스펄전 주석 (태그)Charles Spurgeon19세기칼빈주의감동적 적용 검색
62 Calvin John Complete Commentary.cmt.twm칼빈 주석 (중복)John Calvin16세기개혁주의신학 검색
65 Tagged_IVP_NT_TextOnly.txtIVP 신약 주석 (태그)IVP 출판사현대복음주의현대 문제 해석
66 Tagged_IVP_OT_TextOnly.txtIVP 구약 주석 (태그)IVP 출판사현대복음주의현대 문제 해석
61 Expsb\01Expsb_Genesis.docx (외 65건)Expositer's Study Bible Note    
63 NT \ 01마태복음 (외 26건)한국어 신약주석한국 학자들현대학문적최신 연구
64 OT \ 01창세기 (외 65건)한국어 구약주석한국 학자들현대학문적최신 연구

종합 정리

  • 총 파일 수: 목록에 열거된 파일은 90개이지만, 중복(Calvin, TPC 등)과 하위 폴더 내 다수 파일(61, 63, 64번)이 포함되어 있습니다.
  • 실질적 단일 파일 종류: 중복 제외 시 약 80종 정도로 추정됩니다.
  • 폴더별 특징: 신학적 접근법과 활용 목적에 따라 체계적으로 분류되어 있으며, 연구 목적에 따라 적절한 폴더의 자료를 결합하여 사용하면 효과적입니다.
  • 한국어 자료: 한글 주석 및 성경 번역본이 포함되어 있어 한국어 사용자에게 유용합니다.

이 구조를 통해 신학 연구, 설교 준비, 개인 묵상 등 다양한 목적에 맞게 체계적으로 성경을 공부할 수 있습니다.


 


FPB"Full Protestant Bible"의 약자로, 최근 성경 연구자들과 깊이 있는 신앙생활을 원하는 분들 사이에서 주목받고 있는 성경 구성 방식입니다. 구약은 70인역(Septuagint, LXX)을, 신약은 그리스어 원문(NA28 또는 TR 등)을 바탕으로 하여, 성경 전체를 그리스어(헬라어) 전통에 따라 일관성 있게 정렬한 것이 특징입니다.


📄 FPB 성경의 핵심 구성

보통 우리가 보는 개역개정이나 NIV 같은 개신교 성경은 구약은 히브리어(마소라 본문), 신약은 그리스어 본문을 번역합니다. 하지만 FPB는 다음과 같은 차별점을 가집니다.

1. 구약성경: 70인역 (Septuagint, LXX)

  • 정의: 기원전 3~2세기경, 히브리어 구약성경을 당시 공용어였던 그리스어로 번역한 현존하는 가장 오래된 번역본입니다.
  • FPB에서의 의미: 예수님과 사도들이 당시 실제로 읽고 인용했던 성경이 바로 이 70인역입니다. 신약 기자들이 구약을 인용할 때 히브리어 본문보다 70인역의 문구를 그대로 사용하는 경우가 많기 때문에, 신·구약의 언어적 통일성을 위해 70인역을 채택합니다.

2. 신약성경: 그리스어 원문

  • 신약은 원래 그리스어(코이네 헬라어)로 기록되었습니다. FPB는 이를 그대로 이어받아 구약과 신약 전체를 하나의 언어적 맥락(그리스어) 안에서 읽게 합니다.

💡 FPB 성경의 주요 특징 및 장점

1. 신·구약의 언어적 일관성

가장 큰 장점은 용어의 통일입니다.

  • 예를 들어, 히브리어 구약의 '메시아'는 그리스어 70인역에서 '크리스토스()'로 번역되었습니다.
  • FPB 방식으로 성경을 보면 구약에서 예언된 '크리스토스'가 신약의 '예수 크리스토스'로 자연스럽게 이어지는 것을 단어의 변화 없이 직관적으로 이해할 수 있습니다.

2. 신약 기자들의 인용 방식 이해

신약 성경에는 구약을 인용하는 구절이 매우 많습니다. 그런데 가끔 우리가 보는 성경으로 대조해 보면 문구가 약간 다른 경우가 있습니다. 이는 신약 저자들이 70인역을 인용했기 때문인데, FPB 성경을 보면 이러한 인용의 일치성을 명확히 확인할 수 있습니다.

3. 성경 배열 순서

FPB는 유대교 방식의 타나크(TANAKH) 순서가 아니라, 70인역의 전통을 따른 기독교적 배열 순서(역사서-시가서-선지서)를 따릅니다. 이는 우리가 현재 사용하는 성경의 순서와 유사하여 읽기에 이질감이 적습니다.


⚠️ 참고할 점

  • 제2경전(외경) 문제: 원래 70인역에는 가톨릭이나 정교회에서 정경으로 인정하는 외경들이 포함되어 있습니다. 하지만 FPB(Full Protestant Bible)라는 이름에서 알 수 있듯이, 대개 개신교에서 인정하는 66권의 정경성을 유지하면서 본문(Text)만 70인역을 사용하는 형태를 취하는 경우가 많습니다.
  • 마소라 본문과의 차이: 70인역은 히브리어 마소라 본문(MT)과 비교했을 때 연대기 기록이나 일부 구절의 분량에서 차이가 나기도 합니다. 따라서 학술적으로는 두 본문을 비교하며 읽는 것이 권장됩니다.

요약하자면, FPB 성경은 "신약의 저자들이 읽었던 바로 그 구약(70인역)을 통해 성경 전체를 그리스어라는 하나의 흐름으로 관통하려는 시도"라고 볼 수 있습니다.
 
 

📄 The Preacher's Complete Homiletical Commentary (PHC)

1. 기본 개요

  • 전체 규모: 구약과 신약을 합쳐 총 37권(또는 출판본에 따라 32권)으로 구성된 방대한 시리즈입니다.
  • 출판 시기: 1880년대에서 1890년대 사이에 런던의 펑크 앤 왜그널스(Funk & Wagnalls) 출판사를 통해 주로 보급되었습니다.
  • 집필진: 조셉 엑셀(Joseph S. Exell)을 주축으로 헨리(Matthew Henry), 스펄전(C.H. Spurgeon) 등 당대 최고의 복음주의 설교자들과 학자들의 자료를 집대성했습니다.

2. 주요 특징 (왜 'Homiletical'인가?)

이 주석의 가장 큰 특징은 이름에 포함된 'Homiletical(설교학적인)'이라는 단어에 담겨 있습니다. 단순히 성경의 역사적, 언어적 의미를 풀이하는 데 그치지 않고, 실제 설교로 어떻게 연결할 것인가에 초점을 맞춥니다.

  • 설교 개요(Sermon Outlines): 각 구절에 대해 설교의 서론, 본론(대지), 결론으로 사용할 수 있는 구체적인 뼈대를 제공합니다.
  • 실천적 적용: 성경 지식을 전달하는 것보다, 그 말씀이 현대 독자의 삶에 어떻게 적용되어야 하는지를 강조합니다.
  • 다양한 인용: 한 사람의 해석만 담은 것이 아니라, 동서고금의 유명한 설교자들의 통찰력 있는 짧은 글(Homilies)들을 테마별로 모아두었습니다.

3. 구성 요소 (질문하신 텍스트의 구조)

질문하신 텍스트에서도 볼 수 있듯이, PHC는 보통 다음과 같은 흐름으로 구성됩니다.

  1. Critical Notes (비평적 주석): 단어의 의미, 지리적 배경, 역사적 맥락을 짧고 명확하게 설명합니다.
  2. Main Homiletics (주요 설교 요지): 해당 단락에서 뽑아낼 수 있는 가장 핵심적인 메시지를 정리합니다.
  3. Homilies on the Verses (절별 설교): 각 구절을 주제로 한 구체적인 설교 예시들을 나열합니다.

4. 현대적 가치

  • 깊이 있는 통찰: 100년이 넘은 자료임에도 불구하고, 인간의 본성과 하나님의 은혜에 대한 통찰이 매우 깊어 현대 설교자들에게도 여전히 영감을 줍니다.
  • Scannability (가독성): 대지(I, II, III...)가 명확하게 나누어져 있어, 바쁜 설교자들이 핵심 내용을 빠르게 파악하기에 매우 유용합니다.

요약하자면, PHC는 단순히 성경을 공부하기 위한 책이라기보다 "이 본문으로 어떻게 감동적인 설교를 할 것인가?"라는 질문에 답하기 위해 만들어진 '설교자를 위한 백과사전'이라고 할 수 있습니다.