Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning임포트 가능 확장자 설정을 위한 editor.import.extensions 키는 status

Status
colourYellow
title릴리즈

2

3.

8

3.

0

2602 이상

에서만 제공합니다.
Warning

  

'editor.import.extensions' 키를 사용해 임포트 가능한 문서 확장자를 설정할 수 있습니다.

Code Block
js
languagetitle사용 시 유의사항

임포트한 원본 문서와 익스포트된 문서 간의 표현 및 품질이 동일함을 보장하지는 않습니다.

웹 에디터 환경의 구조적 특성으로 인해 원본 문서 양식과의 1:1 매칭이 어려우며, 이로 인해 일부 객체가 누락되거나 비정상적으로 표시될 수 있습니다.

임포트 모듈 적용

문서를 익스포트하는 기능을 사용하기 위해서는 에디터 패키지 externals 폴더 아래에 포함된 임포트/익스포트 모듈인 SEDocModelParser를 적용해야 합니다.

Code Block
languagexml
themeEmacs
titlesynapeditor.config.js
{   // 이전 버전의 기본값
    'editor.import.extensions' : ['docx', 'doc', 'hwp', 'hml', 'html', 'htm', 'txt', 'xls', 'xlsx', 'odt'],

    // 2.18.0 이상 버전의 기본값
    'editor.import.extensions' : ['docx', 'doc', 'hwp', 'hwpx', 'hml', 'html', 'htm', 'txt', 'xls', 'xlsx', 'odt'],

    // 3.0.0 이상 버전의 기본값
    'editor.import.extensions' : ['docx', 'doc', 'hwp', 'hwpx', 'hml', 'html', 'htm', 'txt', 'xls', 'xlsx', 'odt', 'ppt', 'pptx'],

    // 설정 예시
    'editor.import.extensions' : ['docx', 'hwpx', 'xlsx', 'pptx'],
}

  

'editor.upload.image.extensions' 키를 사용해 업로드 가능한 이미지 파일 확장자를 설정할
<!-- 임포트/익스포트 모듈 -->
<script src="externals/SEDocModelParser/SEDocModelParser.min.js"></script>


툴바 설정

에디터 툴바설정에 'export'추가 시 내보내기 다이얼로그를 사용할 수 있습니다.

Code Block
languagejs
themeEmacs
titlesynapeditor.config.js
{
  // 기본값 	'editor.upload.image.extensionstoolbar': ['jpg'..., 'gif', 'png', 'jpeg'],

    // 설정 예시
	'editor.upload.image.extensions': ['jpg', 'png'],
}

  

'editor.upload.video.extensions' 키를 사용해 업로드 가능한 비디오 파일 확장자를 설정할 수 있습니다.

Code Block
languagejs
themeEmacs
titlesynapeditor.config.js
{   // 기본값
	'editor.upload.video.extensions': ['mp4', 'ogg', 'webm'],

    // 설정 예시
	'editor.upload.video.extensions': ['mp4'],
}

  

'editor.upload.file.extensions' 키를 사용해 업로드 가능한 일반 파일의 확장자를 설정할 수 있습니다.

Warning

주의가 필요한 파일 형식
1. 문서 계열 (doc, docx, ppt, pptx, xls, xlsx, pdf, rtf, odt, ods, odp, hwp, hwpx 등)
 - 매크로나 스크립트가 포함될 수 있음
 - 임포트시에만 허용하는 것을 권장

2. 마크업 / 스타일 언어 (xml, css, svg, textile, html 등)
 - XSS나 스크립트 삽입 위험이 있음

3. 실행 파일 / 임베디드 파일 (swf, eof 등)
 - 직접 실행될 수 있거나 안전하지 않음

  

Code Block
languagejs
themeEmacs
titlesynapeditor.config.js
{   // 이전 버전의 기본값
	'editor.upload.file.extensions': [
        'bmp', 'css', 'csv', 'diff', 'doc', 
        'docx', 'eof', 'gif', 'jpeg', 'jpg', 
        'json', 'mp3', 'mp4', 'm4a', 'odp', 
        'ods', 'odt', 'ogg', 'otf', 'patch', 
        'pdf', 'png', 'ppt', 'pptx', 'rtf', 
        'svg', 'swf', 'textile', 'tif', 'tiff',
        'ttf', 'txt', 'wav', 'webm', 'woff',
        'xls', 'xlsx', 'xml', 'md', 'vtt', 
        'hwp', 'hml', 'html'
    ],

    // 3.2.2509, 2.20.2509 이상 버전의 기본값
	'editor.upload.file.extensions': [
        'bmp', 'gif', 'jpeg', 'jpg', 'png', 'tif', 'tiff', 'webp',
        'mp3', 'mp4', 'm4a', 'ogg', 'wav', 'webm',
        'txt'
    ],

    // 설정 예시
	'editor.upload.file.extensions': [
        'tif', 'tiff', 'webp', 'mp3', 'mp4', 'wav', 'webm'
    ]
}
    

관련기능

  • Export API
  • 익스포트 설정base64 이미지 사용
  • 익스포트 설정FormData의 File Field Name 설정
    export', ...]
    }


    익스포트 UI 다이얼로그

    Image Added

    항목설명
    파일형식

    파일 포맷을 지정합니다.

    Note

    공식 지원 포맷은 hwpx입니다.
    그 외 포맷(hwp, docx)은 변환 과정에서 일부 제한이 있을 수 있습니다.


    HWPX(default)

    HWP

    DOCX

    용지방향

    용지 방향을 설정합니다.

    A4 세로(default)

    A4 가로

    파일이름

    저장할 파일명을 입력합니다.

    문자열

    (미입력 시: untitled)

    내보내기 시 생성된 파일은 사용 중인 브라우저의 기본 다운로드 경로에 저장됩니다.