문제 해결
흔한 문제와 확인할 점입니다.
섬네일 품질이 낮아 보여요
단독 실행 바이너리는 내장 GD 라이브러리로 대체 동작하는데, 이는 품질이 낮은 섬네일을 만들고 지원하는 형식도 적습니다. 더 나은 출력을 얻으려면 빌드 호스트에 ImageMagick과 librsvg를 설치하거나, 이들을 번들로 포함한 Docker 이미지를 사용하세요. 이미지 참고.
검색 상자가 아무 반응이 없어요
검색은 클라이언트 사이드로, SifterSearch를 통해 Wikven에 내장되어 있으며 기본적으로 켜져 있습니다. 상자가 반응하지 않는다면, 검색이 꺼져 있거나(SifterSearchOutputDir가 비어 있음), 번들 경로가 사이트가 제공되는 위치와 맞지 않는 것입니다(하위 디렉터리 배포에서는 SifterSearchBundlePath를 설정하세요). 검색 참고.
사이트에서 문서가 하나 빠져 있어요
문서 가져오기에 하나라도 실패하면 빌드가 중단되며, 파일 이름과 함께 Failed to import N page(s)를 출력합니다. 흔한 원인은 이름이 유효한 제목으로 대응되지 않는 파일입니다. 그런 파일은 이름을 바꾸세요 (이름이 왕복 변환되지 않으면 빌드가 경고합니다). 빌드를 다시 실행하고 실패한 파일에 대한 로그를 읽어 보세요.
HTTPS로 가져오기가 실패해요
위키미디어 공용 이미지와 서드파티 확장 기능이나 스킨을 가져오려면 시스템의 CA 인증서가 필요합니다. 이것이 없는 최소 구성 호스트(단독 실행 바이너리에서 흔함)에서는 배포판의 CA 번들, 예를 들어 ca-certificates 패키지를 설치하세요. 로컬 콘텐츠와 이미지만 있는 사이트는 네트워크 접근이 필요 없습니다.
바이너리가 macOS나 Windows에서 실행되지 않아요
단독 실행 바이너리는 Linux 전용입니다(x86_64와 arm64). macOS나 Windows에서는 대신 Docker 이미지를 사용하세요. 설치 참고.