오프라인 환경에서 문서 이용하기
인터넷에 접속할 수 없는 오프라인 환경에서 RealGrid2 문서를 이용하시는 고객을 위해
문서 사이트를 오프라인 모드로 제공해드립니다.
사용법
1. 오프라인 모드 다운로드
먼저 오프라인 모드를 다운로드 (opens in a new tab) 해주세요.
2. 웹서버에서 실행하기
웹 서버(apache
등)에서 다운받은 문서 사이트의 컨텐츠를 직접 설정하신 후 실행해주세요.
웹 서버 설정 방법은 각 웹 서버 가이드를 참고하시기 바랍니다.
3. 문제 해결
3.1. 페이지를 리프레시할 경우, 화면이 제대로 표시되지 않는 문제
특정 웹 서버에서는 페이지가 리프레시될 때, 화면이 제대로 표시되지 않을 수 있습니다.
이때는 html 파일의 확장자 처리를 위한 rewrite룰을 추가로 설정해야 합니다.
NGINX 설정 예시
- 웹 서버 설정 파일에서 rewrite 룰 설정
# 설정 파일
server {
...
rewrite ^(/.*)\.html(\?.*)?$ $1$2 permanent; # <= 추가
rewrite ^/(.*)/$ /$1 permanent; # <= 추가
location / {
root /usr/share/nginx/html;
index index.html index.htm;
try_files $uri/index.html $uri.html $uri/ $uri =404; # <= 추가
}
...
}
- 웹 서버 재시작
Apache 설정 예시
- 웹 서버 설정 파일에서
.htaccess
및 rewrite 모듈 활성화
# 설정 파일 (httpd.conf, apache2.conf 등)
<Directory "/usr/local/apache2/htdocs">
...생략
AllowOverride All # <= 확인
</Directory>
...생략
LoadModule rewrite_module modules/mod_rewrite.so # <= 확인
- 문서 컨텐츠 경로에
.htaccess
파일 생성
# remove html file extension https://example.com/page.html
# to https://example.com/page
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^([^\.]+)$ $1.html [NC,L]
- 웹 서버 재시작
3.2. 웹 서버 DocumentRoot
의 하위 경로에 문서컨텐츠를 배포할 경우, 문서가 제대로 표시되지 않는 문제
문서 컨텐츠는 웹 서버의 DocumentRoot
에 배포되었을 경우에 정상적으로 실행됩니다.
하위 경로 배포가 필요할 경우, 해당 하위경로를 DocumentRoot
로 하는 웹서버 가상호스트를 구성하시면 됩니다.
도메인 기반 가상호스트 방식으로 구성할 경우, 해당 도메인용 리얼그리드 라이선스 파일을 별도로 적용해야 합니다. (3.3 참고)
자세한 가상호스트 설정 방법은 각 웹 서버 가이드를 참고하시기 바랍니다.
3.3. 커스텀 도메인에서 리얼그리드 데모가 표시되지 않는 문제
기본적으로 localhost
도메인으로 접속할 경우에만, 가이드의 리얼그리드 데모가 정상적으로 표시됩니다.
커스텀 도메인을 사용할 경우, 문서 컨텐츠 내의 라이선스 파일을 커스텀도메인이 적용된 새 라이선스 파일로 교체한 후 웹서버에 배포하시기 바랍니다.
- 라이선스 파일 위치:
public/realgrid.2.x.x/realgrid-lic.js
(리얼그리드 버전은 최신 버전 지정) - 라이선스 파일은 라이선스 관리 사이트 (opens in a new tab)에서 발급받을 수 있습니다.
참고 사항
- 인터넷을 통해서만 접근할 수 있는
외부링크
는 동작하지 않습니다.