Question 1

Firefox에서는 **로 감싼 Markdown 굵은 텍스트가 굵게 표시되지 않지만 Chrome에서는 작동하는 문제를 어떻게 고치나요?

Accepted Answer

이 문제는 2018 버전 materialize.min.css를 사용하는 프로젝트(예: Wikidocs, Wikidocs 자체의 버그가 아님)에 영향을 줍니다: 이 스타일시트는 Markdown **bold** 구문으로 생성된 태그를 font-weight: 500으로 설정합니다. Firefox는 501 이상의 font weight만 굵게 렌더링하는 반면, Chrome은 500 이상의 weight를 굵게 처리합니다. 수정 옵션: 1. 권장: 사용자 지정 스타일시트(예: Wikidocs의 styles/styles-custom.css)에 다음 규칙을 추가하거나

Question 2

Wikidocs 사이드바에서 긴 하위하위 페이지 제목이 왜 보이지 않나요?

Accepted Answer

이는 template.inc.php의 공백 문자 때문에 길고 끊기지 않은 subsub_index 제목에 강제 줄 바꿈이 생기기 때문입니다. 문제가 PR #270에서 수정된 Wikidocs 1.0.82 이상으로 업그레이드하세요. 버전 1.0.76–1.0.78에서의 임시 해결 방법으로, template.inc.php를 편집하고 subsub_index 제목을 렌더링하는 템플릿 마크업을 찾은 다음, 원치 않는 줄 바꿈을 일으키는 추가 공백 문자를 제거하세요.

Question 3

Hiawatha 웹서버에서 WikiDocs에 로그인하거나 편집할 때 404 오류를 어떻게 해결하나요?

Accepted Answer

로그인/편집 라우트(예: `/homepage?auth`)의 404 오류는 WikiDocs가 Apache 스타일 `.htaccess` URL rewrite 규칙에 의존해 요청을 `index.php`로 라우팅하는데, Hiawatha가 이를 기본적으로 지원하지 않기 때문에 발생합니다. 해결 단계: 1. Hiawatha의 공식 URL rewrite 가이드를 참고하세요: https://hiawatha.leisink.net/howto/url_rewrite_rules 2. 다음 기본 WikiDocs Apache mod_rewrite 규칙을 Hiawatha 설정 구문으로 변환하세요: RewriteEngine On # 루트 도메인 설치에는 /를 사용하고, 해당되는 경우 /subfolder/를 실제 하위 디렉터리 경로로 바꾸세요 RewriteBase /subfolder/ # 직접 .md 파일 요청을 루트로 리디렉션 RewriteCond %{REQUEST_URI} \.md$ [NC] RewriteRule ^.*$ /subfolder/ [R=301,L] # 존재하지 않는 모든 파일 요청을 index.php로 라우팅 RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php?doc=$1 [NC,L,QSA] 더 쉬운 우회 방법: 기본 rewrite 규칙을 별도 설정 없이 지원하는 Apache, Nginx 또는 Docker로 WikiDocs를 배포하세요.

Question 4

custom domain을 사용하는 nginx reverse proxy 뒤에서 Wikidocs가 http://wikidocs/homepage?auth로 리디렉션되는 문제를 어떻게 해결하나요?

Accepted Answer

리디렉션은 컨테이너 이름을 사용합니다. 왜냐하면 nginx가 공개 도메인 대신 업스트림 Host(wikidocs)를 전달하고, Wikidocs에 원래 요청이 HTTPS였음을 알리지 않기 때문입니다. nginx location 블록을 업데이트하세요: location / { proxy_pass http://wikidocs:80; proxy_set_header Host $host; proxy_set_header X-Forwarded-Proto https; proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Port 443; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; client_max_body_size 0; } nginx를 검증하고 다시 로드하세요. 예: docker exec nginx -t docker exec nginx -s reload 그런 다음 https://wiki.mydomain.com을 통해 로그인하세요. 서비스 이름 wikidocs는 Docker/DNS 업스트림 이름으로 남아 있어도 됩니다. 외부에서 생성되는 링크에 사용되어서는 안 됩니다. 리디렉션 헤더를 여전히 재작성해야 한다면, 임시 해결 방법으로 proxy_redirect http://wikidocs/ https://wiki.mydomain.com/;를 추가하세요.

Question 5

Ubuntu에서 Nginx로 WikiDocs를 설치할 때 누락된 php-mbstring 종속성 문제를 어떻게 해결하나요?

Accepted Answer

Ubuntu에 필요한 PHP 확장을 설치하세요:

sudo apt update
sudo apt install php-mbstring

그 후 PHP-FPM과 Nginx를 재시작하세요. 예를 들어:

sudo systemctl restart php8.1-fpm
sudo systemctl restart nginx

설정 스크립트를 사용하여 필요한 모든 PHP 종속성을 확인하세요. Nginx 문서 섹션에서 이를 명시적으로 언급하지 않을 수 있기 때문입니다.

공식 Docker 이미지에는 이미 mbstring이 포함되어 있습니다.

WikiDocs

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트