새 테마 적용하기 > 2권 · 웹사이트 설치

이제 새 화면을 켭니다. 그누보드의 테마를 바꾸는 것과 똑같습니다.

테마 바꾸기

1. 최고관리자로 로그인해 관리자 화면으로 갑니다.
2. 환경설정 → 테마설정 을 엽니다.
3. 목록에서 Next.js Default 를 찾아 테마적용 을 누릅니다.

적용이 끝나면 사이트 첫 화면을 새로고침해 보세요. 새 화면이 보이면 성공입니다.

웹서버 규칙은 어떻게 되나요

새 화면은 /free, /shop 같은 주소를 새 테마로 보내는 주소 규칙(rewrite) 이 필요합니다. 웹서버 종류에 따라 할 일이 다릅니다.

Apache (대부분의 웹 호스팅)

할 일이 없습니다. 테마를 적용하는 순간 루트의 .htaccess 에 있는 그누보드 주소 규칙 부분이 새 테마에 맞게 자동으로 바뀝니다. 영카트가 있으면 shop/.htaccess 도 함께 맞춰집니다. 그 부분 밖에 직접 넣어 둔 줄은 건드리지 않습니다.

테마를 적용할 때 아래처럼 알림이 뜨면, 서버가 .htaccess 를 고칠 권한이 없는 경우입니다.

테마는 적용했지만 .htaccess 를 쓸 수 없어 짧은 주소 규칙을 갱신하지 못했습니다.

이때는 환경설정 → 기본환경설정 → 짧은 주소 설정 에 보이는 Apache 설정 코드 를 복사해, 루트의 .htaccess 에 직접 붙여 넣으세요.

nginx

nginx 는 .htaccess 를 읽지 않아서, 규칙을 서버 설정에 직접 넣어야 합니다.

1. 환경설정 → 기본환경설정 → 짧은 주소 설정 에서 Nginx 설정 코드 를 복사합니다. (테마를 Next.js Default 로 바꾼 뒤에 복사해야 새 테마 규칙이 들어 있습니다.)
2. 사이트의 nginx server { … } 설정 안에 붙여 넣고 nginx 를 다시 불러옵니다(nginx -t 로 검사 후 reload).
3. 서버 설정을 직접 고칠 수 없다면 호스팅 업체에 이 코드를 전달해 반영을 요청하세요.

nextjs-install/nginx/ 폴더의 파일은 보안 헤더 · 요청 수 제한 같은 추가 설정의 참고용입니다. 기본 동작에는 짧은 주소 설정의 코드만 있으면 됩니다.

nginx 에서 주의 /_next/static/ 을 alias 나 try_files 로 테마 폴더에서 직접 내보내지 마세요. 새 화면의 파일은 연결 부품(브리지)을 거쳐야 올바른 주소로 바뀌어 나갑니다. 직접 내보내면 화면은 떠도 링크가 깨집니다.

원래 화면으로 되돌리려면

같은 곳(환경설정 → 테마설정)에서 원래 쓰던 테마(예: basic)를 다시 적용하면 됩니다. Apache 는 .htaccess 규칙도 원래대로 자동으로 돌아갑니다. nginx 는 짧은 주소 설정의 코드를 다시 복사해 넣으세요.

확인표

• ☐ 관리자 → 환경설정 → 테마설정에서 Next.js Default 를 적용했다
• ☐ (Apache) 적용할 때 .htaccess 경고가 뜨지 않았다, 또는 떴다면 설정 코드를 직접 넣었다
• ☐ (nginx) 짧은 주소 설정의 Nginx 설정 코드를 서버 설정에 넣고 다시 불러왔다
• ☐ 첫 화면이 새 화면으로 바뀌었다