PWA, Windows 및 Linux용 Kiwix JS(Electron, NWJS, UWP)

데모: [ 데스크톱에 PWA 설치 ] [ 설치 및 사용: Android ] [ 설치 및 사용: Firefox Android ] [ 아카이브 폴더 선택 ] [ 파일 처리(데스크톱) ] [ 모든 OPFS 기능 데모 ] [ Edge 사이드바에 앱 추가 ]

Kiwix는 Wikipedia, Project Gutenberg, TED Talks, Wikivoyage, Stackexchange 및 기타 여러 사이트와 리소스를 위한 오프라인 브라우저입니다. 인터넷 접속이 제한되거나 없는 사람들이 다양한 언어로 지식을 이용할 수 있도록 해줍니다. 소프트웨어와 콘텐츠는 누구나 무료로 사용할 수 있습니다. 앱을 다운로드하고 원하는 오프라인 콘텐츠(인앱에서 무료로 다운로드할 수 있는 ZIM 아카이브)를 다운로드하세요. 다양한 주제와 주제에 대해 선택할 수 있는 수백 개의 다국어 아카이브가 있습니다. 오프라인 지식의 전체 디지털 라이브러리를 구축하세요!

Kiwix 제품군에 속하는 이 앱은 거의 모든 최신 브라우저 및 장치에서 오프라인으로 설치 가능한 프로그레시브 웹 앱(PWA)으로 사용 가능하거나 다양한 Windows 및 Linux 운영 체제용 앱 패키지로 사용 가능합니다. 자세한 내용은 Kiwix JS를 참조하세요. 윈도우와 리눅스 . Mac 및 iOS 의 경우 오프라인 PWA를 사용하세요.

또한 Kiwix의 WikiMed (완전한 의학 백과사전)와 Kiwix의 Wikivoyage (완전한 여행 가이드) 영어 패키지 앱도 있습니다. 추가 다운로드가 필요하지 않습니다! (그러나 이 앱에서는 다른 언어를 다운로드할 수 있습니다.)

Windows 10 또는 11을 사용하는 경우 Microsoft Store에서 세 가지 앱인 Kiwix JS UWP , WikiMed by Kiwix 및 Wikivoyage by Kiwix를 모두 편리하게 사용할 수 있습니다. 새 패키지가 출시되면 자동으로 업데이트됩니다. Linux를 사용하는 경우 Kiwix JS의 Electron AppImage 패키지도 (선택적으로) 설치 가능한 Windows Electron 패키지와 마찬가지로 자동 업데이트됩니다. 업데이트가 가능해지면 다른 앱에서도 알려줍니다.

유니버설 프로그레시브 웹 앱

상점이나 패키지가 마음에 들지 않습니까? 우리가 도와드리겠습니다! 지금 바로 pwa.kiwix.org 에서 브라우저에 설치 가능하고 오프라인이 가능한 PWA(프로그레시브 웹 앱)를 열어 이 앱을 즉시 실행하세요. 이는 Service Worker를 지원하는 모든 브라우저(최신 Chrome, Edge, Firefox 및 Safari)에서 작동합니다. (iOS 장치에서는 Apple이 i-장치의 다른 브라우저에서 Service Worker 사용을 금지하므로 Safari를 사용해야 합니다.)

앱의 구성 페이지에서 PWA와 함께 사용할 무료 ZIM 아카이브를 얻거나 다운로드하기 전에 library.kiwix.org에서 ZIM을 미리 볼 수 있습니다. PWA를 설치하거나 북마크에 추가하거나 홈 화면에 추가하면 장치가 완전히 오프라인 상태일 때도 작동합니다! PWA를 설치하는 것이 얼마나 빠르고 쉬운지 보여주는 데모를 살펴보세요.

Wikipedia 전체를 오프라인으로 전환하려면 어떻게 해야 하나요?

이미지와 함께 다운로드하려면 대용량 다운로드라는 점에 유의하세요. 영어 버전은 약 97GB입니다! 천문학, 화학, 수학, 물리학 등과 같은 훨씬 더 작은 테마의 아카이브 중 하나를 사용하여 먼저 시도해 보는 것이 좋습니다. 앱 내에서 언어와 테마를 선택할 수 있는 편리한 드롭다운을 찾을 수 있습니다. 을 클릭한 다음 다운로드하세요. 아카이브가 브라우저에 다운로드됩니다.

이미지가 포함된 전체 영어 Wikipedia를 정말로 원한다면 오픈 소스 앱인 qBittorrent를 사용하여 디스크 공간이 충분한 PC에 다운로드할 것을 적극 권장합니다. 먼저 qBittorrent를 설치하세요. 그런 다음 앱에서 다운로드할 대용량 아카이브를 선택하면 토렌트 링크가 제공됩니다. 링크를 클릭하고 브라우저에서 토렌트 파일을 다운로드하고 열 수 있도록 허용하세요. 이 작은 파일은 qBittorrent에서 열리며 다운로드하려는 아카이브를 어디에 저장할 것인지 묻는 메시지가 표시됩니다. 생각보다 훨씬 쉽습니다!

Zimit(웹 아카이브) 형식은 어떻습니까?

Zimit은 모든 웹사이트를 ZIM으로 보관할 수 있게 해주는 서비스입니다. 하지만 사전에 크롤링된 Zimit 기반 ZIM을 사용할 수 있는 흥미로운 ZIM이 많이 있습니다(아래 참조). 직접 만들어보고 싶다면 https://youzim.it/에서 사용해 보세요. Kiwix JS PWA 및 Electron 앱은 오픈 소스 Replay Web Archive 리더를 사용하여 v.2.8.5부터 Zimit 기반 아카이브를 완벽하게 지원하며 곧 출시될 Zimit v2 형식을 이미 지원합니다. 대부분의 Zimit 아카이브에는 매우 동적인 콘텐츠로 인해 ServiceWorker 모드가 필요합니다.

Kiwix 다운로드 라이브러리(앱 내에서 사용 가능)는 Ready.Gov 재해 대비 사이트 , 매력적인 Low-Tech 잡지 , CIA World Factbook , Harmony Project 라이브러리 등 매우 유용한 여러 참고 사이트를 Zimit 파일 형식으로 게시합니다. 악보, 인터넷 철학 백과사전 등이 있습니다. 인앱 라이브러리에서 Zimit 디렉토리를 열면 됩니다.

브라우저 지원

이 앱의 중요한 대상 고객이 오래된 소프트웨어가 설치된 오래된 장치에만 액세스할 수 있는 개발 도상국의 사용자로 구성되어 있다는 점을 고려하면, 우리는 오래된 브라우저와 플랫폼에 대한 지원을 유지하는 것에 자부심을 느낍니다. 우리는 이전 브라우저와 운영 체제에서 앱을 자주 테스트합니다. 앱은 일반적으로 특정 브라우저에서 작동하지 않는 기능을 감지하여 해당 기능을 비활성화하거나 해결합니다. 그러나 일부 경우(예: Firefox <= 59) 앱은 자체적으로 서비스 워커 모드로 설정되지만 이 모드는 자동으로 실패합니다. 영향을 받는 경우 앱을 제한 모드로 전환해 보세요(구성의 콘텐츠 삽입 모드 참조).

공식적으로 지원됨

Linux, Windows, Android, iOS, macOS의 PWA(프로그레시브 웹 앱):

Google Chrome / Chromium >= 59(및 Chromium 기반의 많은 브라우저(예: Opera, Samsung Internet))
Microsoft Edge(Chromium) >= 79
Mozilla Firefox >= 68(그러나 Android * 에 대한 참고 사항 참조)
iOS 및 macOS용 Apple Safari >= 11.3(전체 텍스트 검색은 iOS 15 이상에서만 작동함)
Microsoft Edge 레거시 18(Windows에만 해당)

다음 프레임워크로 구현된 애플리케이션:

Electron >= 1.8.0(Ubuntu, Debian, Fedora, OpenSUSE, AppImage, Windows): GitHub 릴리스
UWP(유니버설 Windows 플랫폼) >=10.0.10240: Microsoft Store 앱 또는 GitHub 릴리스 - Windows 10/11(Electron), Windows on ARM, Xbox, Windows 10 Mobile
NWJS >= 0.23.0(Windows 7/8/10/11): GitHub 릴리스
NWJS 0.14.7(Windows XP/Vista 전용): GitHub 릴리스

* Android용 Firefox 에서는 Origin 프라이빗 파일 시스템에 저장된 파일에만 앱을 사용할 수 있습니다. 사용자에게 표시되는 파일 시스템에서 ZIM 아카이브 전체를 열 경우 브라우저가 전체 ZIM 아카이브를 메모리로 읽으려고 시도하는 Firefox 버그가 있습니다.

더 이상 사용되지 않음

더 이상 사용되지 않지만, 실용적인 한 지원을 계속할 것입니다.

Internet Explorer 11(제한 모드만 해당, PWA 오프라인 사용 불가)
Edge Legacy <= 17(제한된 모드만 해당, PWA 오프라인 사용 불가)
Firefox 45-67(일부 버전에서는 사용자가 수동으로 제한 모드로 전환해야 하며 일부 버전에서는 WebP 이미지를 표시할 수 없습니다)
Chromium 49-58(일부 버전은 제한 모드에서만 실행됨)

버그 보고 및 기술 지원

소프트웨어에서 발견한 버그를 보고하려면 이 저장소의 문제 추적기를 사용하십시오. 새 티켓을 엽니다(식별한 문제에 이미 티켓이 없는지 확인한 후). 사용 중인 버전 번호(앱 구성 페이지 상단)와 사용 중인 브라우저 또는 플랫폼을 명확하게 명시해 주세요.

소프트웨어 사용에 어려움이 있거나 새로운 기능을 보고 싶다면 티켓을 열어주세요. 또는 문제에 대한 기술 지원을 받는 다른 방법을 알아보려면 앱의 정보 페이지에 있는 피드백 섹션을 참조하세요. 피드백을 제공하고 싶다면 언제든지 연락해 주세요(앱 정보 페이지 참조). 스토어에서 앱을 구입했다면 리뷰를 남겨주세요. 앱이 마음에 드셨다면 이 저장소에 별표를 표시해 주세요(상단 참조)!

기술정보

이 리포지토리는 PWA, Electron, NWJS 및 Windows 10/11 Universal Windows Platform(UWP)용 Kiwix JS 앱 개발을 위한 것입니다. 최신 코드는 일반적으로 메인 브랜치에 있지만 이는 활성 개발에 사용되며 릴리스에 앞서 몇 가지 커밋이 있을 수 있습니다. Windows(XP/Vista/7/8/10/11) 및 Linux(32비트 및 64비트)용 설치 가능 및 이식 가능한 버전은 릴리스에서 사용할 수 있습니다. Electron 및 NWJS 앱의 불안정한 야간 빌드는 개발 배포와 함께 사용할 수 있지만 코드에 버그가 있고 빠르게 변경될 수 있습니다. 또한 야간 Windows 바이너리는 unsigned 입니다.

코드는 Kiwix 오프라인 리더의 경량 HTML/JavaScript 포트인 Kiwix JS를 기반으로 합니다. 다양한 프레임워크용으로 이 앱을 패키징하고 종종 업스트림으로 백포트되는 일부 기능을 추가하는 데 상당한 개발이 이루어졌습니다. PWA는 최신 Chromium 브라우저에서 열면 완전히 통합된 시스템 앱으로 설치할 수 있으며, 해당 API를 지원하는 브라우저에서 기본과 유사한 환경을 위해 파일 시스템 액세스 API 및 파일 처리 API를 사용합니다. 이러한 API에 대한 자세한 내용은 이 페이지 하단의 파일 시스템 액세스 API 및 파일 처리를 참조하세요.

앱은 WinGet 패키지 관리자에서도 사용할 수 있습니다. 명령 프롬프트 또는 PowerShell 터미널을 열고 winget install kiwix.kiwixjs 입력하여 UWP 버전(Windows 10/11)을 사이드로드할 수 있습니다(이 버전은 자동 업데이트되지 않지만 새 업데이트가 준비되면 알려줍니다). 설치하다). 대체 사이드로딩 지침은 릴리스 정보에서 확인할 수 있습니다. Electron 버전은 winget install kiwix.kiwixjs.electron 사용하거나 릴리스에서 패키지를 다운로드하여 설치할 수 있습니다. 테스트를 위해 Store, Electron 및 NWJS 버전은 Wikipedia 상위 100개 기사(이미지 없이 lede 단락만 포함)의 미니 아카이브와 함께 패키지로 제공됩니다.

일부 ZIM 아카이브는 실제로 매우 크기 때문에 파일 시스템의 기본 제한을 고려할 수 있습니다. exFAT 또는 NTFS로 포맷된 대부분의 저장소 유형(microSD 카드 포함)의 경우 매우 큰 파일도 문제 없이 저장소에 저장할 수 있습니다. 그러나 FAT32 로 포맷된 SD 카드에 ZIM 파일을 저장할 계획이고 4GB보다 큰 아카이브를 사용하려는 경우 ZIM을 분할해야 합니다. 파일 분할 지침을 참조하세요.

이 앱에 대한 많은 개발은 제가 적극적으로 기여하고 있는 Kiwix JS 저장소의 업스트림에서 이루어집니다. Kiwix JS가 없었다면 이 앱은 불가능했을 것입니다. 먼저 Evopedia 앱과 Kiwix HTML5(결국 Kiwix JS가 됨)의 최초 개발자에게 큰 감사를 드립니다. Kiwix JS PWA 및 기타 앱의 포팅 및 추가 개발은 Geoffrey Kantaris가 맡았습니다. 이메일(egk10, cam ac uk)로 연락하실 수 있습니다.

코드 기여

코딩 경험이 있고 이 프로젝트에 기여하는 데 관심이 있다면 업스트림 Kiwix JS 저장소에 기여하는 것부터 시작하는 것이 좋습니다. 거기에 기여된 코드의 대부분은 나중에 이 저장소로 포팅되기 때문입니다. 자세한 내용은 CONTRIBUTING.md를 참조하세요. 특정 Kiwix JS PWA 기능에 기여하고 싶다면 이 저장소에서 기여하려는 기능이나 기타 코드와 이를 수행할 제안 방법을 설명하는 이슈를 열어주세요. PR 작성에 능숙해야 하며 JavaScript에 대한 지식이 풍부해야 합니다. Kiwix JS와 동일한 기여 지침을 따르세요.

이제 이 앱을 ES6 코드로 전환했으며, 이는 Rollup.js 및 Babel에 의해 이전 브라우저와 호환되는 코드로 변환됩니다. 간단한 지침:

이 저장소를 복제하고 npm install 실행하여 노드 종속성을 가져옵니다.
핫 모듈 교체가 포함된 Vite.js로 앱을 제공하려면 npm run serve 실행하세요.
문제 해결 및 개발 아래 구성에서 앱 캐시 우회 옵션을 켜야 합니다. 앱이 불규칙한 방식으로 로드되는 경우 앱이 ServiceWorker 모드에 있는 한(콘텐츠 삽입 모드에서 켜지지 않는 경우) 계속 이 설정에 액세스할 수 있습니다. Ctrl-R을 사용하여 앱을 새로 고칩니다.
Vite는 변경 사항을 관찰하고 변경 사항을 저장하면 앱을 새로 고칩니다.
앱의 번들 버전을 미리 보려면 npm run preview 실행하세요. 그러면 Vite가 앱을 빌드하고 브라우저 창을 열어 번들 버전을 봅니다.
앱을 완전히 빌드하려면 npm run build 실행하세요. 빌드된 앱은 복제된 저장소의 dist 라는 디렉터리에 저장됩니다.
Electron 프레임워크에서 앱을 실행하려면 npm start 사용할 수 있습니다. 그러면 package.json 에 지정된 Electron 버전으로 번들되지 않은 앱이 실행됩니다. package.json 에서 Electron용 앱의 번들 버전을 빌드하기 위한 다양한 스크립트를 참조하세요(Linux 앱은 WSL을 사용하여 Windows에서 빌드할 수 있지만 현재 사용 중인 OS에 대해서만 빌드할 수 있습니다).

기타 기부/기부

이 프로젝트가 마음에 들고 프로젝트를 계속 운영하는 데 재정적으로 기여하고 싶다면 Kiwix 지원 페이지에서 일회성 또는 정기 기부를 할 수 있습니다. 기부금은 서버 비용, 코딩 인증서, 유지 관리 비용 등을 지불하는 데 도움이 됩니다. 돈보다는 시간과 전문 지식을 기부하고 싶고 외국어에 대한 지식이 풍부하다면 Kiwix 프로젝트 번역에 도움을 줄 수 있습니다. 또는 Wikipedia 또는 Wikivoyage 문서를 편집하거나 수정하여 Wikimedia 프로젝트를 개선하는 데 도움을 줄 수 있습니다.

개인 정보 보호 정책

본 개인정보 보호정책은 Kiwix JS 프로그레시브 웹 앱과 Kiwix 서버에 게시된 Electron, NWJS 및 UWP 프레임워크용으로 패키지된 버전과 GitHub의 공식 Kiwix 계정 및 기타 타사 공급업체 스토어("앱 스토어")에 적용됩니다. ).

이 애플리케이션을 설치하면 완전히 오프라인으로 작동할 수 있습니다. 이는 귀하의 개인 데이터를 수집하거나 기록하지 않지만 귀하가 스토어에서 이를 설치한 경우 스토어 운영자는 익명의 사용 데이터를 수집할 수 있습니다(아래 참조). 앱은 세션이 진행되는 동안에만 검색 기록을 기억합니다(이전에 본 페이지로 돌아갈 목적으로). 마지막으로 방문한 페이지를 선택적으로 제외하고 앱을 종료하면 이 기록이 손실됩니다.

보안 웹 서버(예: PWA 서버)에서 이 애플리케이션에 액세스하는 경우 브라우저에서 서비스 워커를 설치할 수 있는 경우에만 오프라인으로 작동합니다. 서비스 워커 모드에서 PWA 버전을 설치하거나 북마크하면 오프라인으로 작동하지만, 설계상 모든 PWA는 다음과 같은 경우 PWA 서버(이 경우 https://pwa.kiwix.org/)를 주기적으로 확인합니다. 업데이트된 서비스 워커를 확인할 수 있습니다.

스토어를 통해 설치되지 않았거나 PWA가 아닌 앱 버전은 시작 시 GitHub 릴리스 API에서 업데이트를 확인하도록 제안하지만 이 기능은 선택 사항이므로 유지하지 않을 수 있습니다. 일부 Electron 앱은 업데이트 확인을 허용하는 경우 선택적으로 (동일한 API를 통해) 자동 업데이트됩니다. 이는 Windows용 설치 프로그램(설정) 버전과 Linux용 AppImage 버전에 적용됩니다. 스토어 버전과 PWA도 자동 업데이트되지만 앱 내에서는 이를 제어할 수 없습니다.

기본적으로 이 애플리케이션은 로컬 저장소 또는 이 장치에서만 액세스할 수 있는 쿠키를 사용하여 세션 사이에 마지막으로 방문한 페이지를 기억합니다. 다음에 이 앱을 열 때 표시하고 싶지 않은 민감한 정보에 액세스하는 경우 구성 옵션에서 이 옵션을 끄는 것이 좋습니다.

이 애플리케이션은 장치에서 명시적으로 선택한 아카이브 파일과 자체 패키지에 포함된 파일만 읽습니다. 다른 파일은 읽을 수 없습니다. 구성 페이지에서 ZIM 아카이브의 다운로드 라이브러리에 액세스하도록 특별히 요청한 경우에만 Kiwix 아카이브 다운로드 서버에 액세스합니다. 앱을 PWA로 실행하면 보안 PWA 서버에서 자체 코드를 캐시한 다음 오프라인에서 사용할 수 있습니다. 일부 ZIM 아카이브에는 드물지만 글꼴과 같은 부수적 파일을 위해 외부 서버에 연결을 시도할 수 있는 활성 콘텐츠(스크립트)가 포함되어 있습니다. 기사에 콘텐츠 보안 정책을 삽입하여 이를 차단하지만 경우에 따라 기사에 이미 CSP가 있는 경우 이를 덮어쓸 수 있습니다. 스크립트는 구성에서 서비스 워커 모드를 활성화한 경우에만 실행됩니다.

귀하의 인터넷 접속이 안전하지 않거나 관찰 또는 검열되고 있다고 생각되는 경우, 애플리케이션을 사용하기 전에 인터넷 접속(데이터 또는 WiFi)을 완전히 종료하는 것이 좋습니다.

또한, 귀하가 공급업체 스토어(확장 프로그램 포함)에서 이 앱을 얻은 경우 스토어 운영자는 익명 제공을 목적으로 귀하의 앱 사용(예: 다운로드, 설치, 제거, 날짜 및 세션 수/기간)을 추적할 수 있습니다. 개발자에게 사용 통계를 집계합니다. 이것이 우려되는 경우 관련 스토어 개인 정보 보호 정책에서 자세한 내용을 확인해야 합니다.

스토어나 온라인 서비스 워커를 사용하지 않는 이 앱의 빌드를 사용할 수 있습니다. 다음을 참조하세요: