설정 방법 1 / 3

파일을 하나씩 싣고, 옵션은 페이지 코드에 적습니다

에디터 코어와 쓸 플러그인 파일을 <script> 로 하나씩 싣고, new WebEditor() 에 옵션을 직접 적는 가장 기본적인 방법입니다. 모든 버전에서 같고, 실리는 파일과 켜지는 기능을 개발자가 정확히 정합니다.

new WebEditor('#editor', { plugins: [...], toolbar: [...] })

준비할 파일

  • dist/webeditor.min.css — 에디터 스타일
  • dist/webeditor.min.js — 코어(내장 플러그인 11종 포함: 서식 · 그림 · 표 · 링크 · 이모지 · 동영상 · HTML 소스 · 삽입 · 찾기 · 문서 배경 · 도형)
  • dist/plugins/*-native.min.js — 쓸 선택 플러그인만(이 예제는 Word 가져오기 wordimport-native.min.js)

적용 순서

  1. CSS 를 <head> 에 싣습니다.
  2. 코어 번들을 싣습니다.
  3. 쓸 플러그인 파일을 코어 다음에 싣습니다.
  4. new WebEditor('#editor', 옵션) 으로 만듭니다. plugins 에 실은 플러그인 이름을 넣습니다.

좋은 점

  • 실리는 파일 · 켜지는 기능을 정확히 정할 수 있습니다.
  • 버전이 바뀌어도 쓰는 법이 같습니다.
  • 서버 템플릿 · 번들러에 넣기 쉽습니다.

주의할 점

  • 플러그인을 더할 때 <script> 와 plugins 배열을 함께 고쳐야 합니다.
  • 설정을 바꾸려면 페이지 코드를 고쳐 다시 배포합니다.
  • license: 'WED2-PMRH-AIR2-EJ3W-KIRM-EJSC-EOS3-EJ3X-O5ZO-MRSX-Q5DF-MRUX-I33S-FZRW-63JC-FQRG-IZLW-FZSG-K6DU-ONXW-Y5LU-NFXW-4LTD-N5WS-ELBC-O53X-OLTE-MV4H-I43P-NR2X-I2LP-NYXG-G33N-EJOS-YITF-EI5D-ALBC-OQRD-UITQ-MVZG-2IRM-EJRS-EORC-MRSX-Q5BC-PULU-NEPL-C4RG-LUX5-AC4H-TLSY-QTPJ-MBCV-VGHG-PVXP-ATQQ-XARS-VCZP-PDWE-HYHW-MUSO-2KH6-QH45-ZPBZ-USBK-EFFR-ABPB-USSS-UETX-LJ2U-DOAV-A' 은 localhost 전용 키입니다. 운영에서는 도메인 키로 바꿉니다.

실행 화면

아래 에디터는 이 칸에 들어 있는 예제 코드(아래 「복사해 쓸 코드」와 같음)로 떠 있습니다. 머리글 · 안내는 데모 화면일 뿐 예제에 들어가지 않습니다.

복사해 쓸 코드

빈 HTML 파일에 붙여 넣으면 그대로 동작합니다. dist/ 경로는 에디터 파일을 둔 위치에 맞게 고칩니다.

<!DOCTYPE html>
<html lang="ko">
<head>
  <meta charset="UTF-8">
  <title>설정 방법 1 — 기존 방식</title>
    <link rel="stylesheet" href="dist/webeditor.min.css">
</head>
<body>
  <div id="editor"></div>

  <!-- ① 코어 번들 -->
  <script src="dist/webeditor.min.js"></script>
  <!-- ② 쓸 플러그인 파일을 하나씩(여기서는 Word 가져오기 하나) -->
  <script src="dist/plugins/wordimport-native.min.js"></script>
  <script>
    // ③ 옵션을 페이지 코드에 직접 적는다
    var editor = new WebEditor('#editor', {
      license: 'WED2-PMRH-AIR2-EJ3W-KIRM-EJSC-EOS3-EJ3X-O5ZO-MRSX-Q5DF-MRUX-I33S-FZRW-63JC-FQRG-IZLW-FZSG-K6DU-ONXW-Y5LU-NFXW-4LTD-N5WS-ELBC-O53X-OLTE-MV4H-I43P-NR2X-I2LP-NYXG-G33N-EJOS-YITF-EI5D-ALBC-OQRD-UITQ-MVZG-2IRM-EJRS-EORC-MRSX-Q5BC-PULU-NEPL-C4RG-LUX5-AC4H-TLSY-QTPJ-MBCV-VGHG-PVXP-ATQQ-XARS-VCZP-PDWE-HYHW-MUSO-2KH6-QH45-ZPBZ-USBK-EFFR-ABPB-USSS-UETX-LJ2U-DOAV-A',          // localhost 전용 키 — 운영에서는 도메인 키로 바꾼다
      height: '360px',
      plugins: ['format', 'image', 'table', 'link', 'wordimport'],
      toolbar: [['undo', 'redo', '|', 'bold', 'italic', 'underline', '|', 'insertTable', 'insertImage', 'insertLink', '|', 'importDocument']]
    });
  </script>
</body>
</html>

세 방법 비교

① 기존 방식② 한 줄 설정③ 설정 파일
페이지에 싣는 파일CSS · 코어 · 쓸 플러그인 파일을 하나씩CSS · 코어 둘만설정 파일 → CSS · 코어(선택 플러그인은 ① · ② 처럼)
옵션을 적는 곳new WebEditor() 의 옵션preset: 'full' + 필요한 옵션dee-editor.config.js (페이지 코드에는 없음)
켜지는 기능plugins 에 적은 것만문서 가져오기 6종 · 마크다운 · 글자 인식 · 차트 · 메뉴바까지 전부설정 파일에 고른 대로
설정을 바꿀 때페이지 코드를 고쳐 다시 배포페이지 코드를 고쳐 다시 배포관리자가 도구로 파일만 바꿔 올림
이럴 때 알맞음실을 파일을 정확히 정하고 싶을 때 · 기존 화면빠르게 전부 켜서 쓰고 싶을 때여러 화면의 설정을 한 곳에서 관리할 때

더 알아보기

안내서: 문서/01_시작하기/설정방법_1_기존방식

다음: ② 한 줄 설정 →