리치 텍스트 편집기 플러그인 구성

RTE 기능은 여러 플러그인을 통해 제공되며 각각 기능 속성이 있습니다. 하나 이상의 RTE 기능을 활성화하거나 비활성화하도록 기능 속성을 구성할 수 있습니다. 이 문서에서는 RTE 플러그인을 구체적으로 구성하는 방법에 대해 설명합니다.

다른 RTE 구성에 대한 자세한 내용은 리치 텍스트 편집기 구성을 참조하십시오.

노트

CRXDE Lite 작업 시 모두 저장 옵션을 사용하여 변경 내용을 정기적으로 저장하는 것이 좋습니다.

플러그인을 활성화하고 기능 속성 구성

플러그인을 활성화하려면 다음 단계를 수행합니다. 일부 단계는 해당 노드가 없으므로 처음으로 플러그인을 구성할 때만 필요합니다.

기본적으로 format, link, list, justifycontrol 플러그인과 해당 모든 기능이 RTE에서 활성화됩니다.

노트

이 문서에서 중복을 피하려면 각 rtePlugins 노드를 <rtePlugins-node>이라고 합니다.

  1. CRXDE Lite을 사용하여 프로젝트의 텍스트 구성 요소를 찾습니다.

  2. RTE 플러그인을 구성하기 전에 <rtePlugins-node>의 부모 노드를 만듭니다.

    • 구성 요소에 따라 상위 노드는 다음과 같습니다.

      • config: .../text/cq:editConfig/cq:inplaceEditing/config
      • 대체 구성 노드:.../text/cq:editConfig/cq:inplaceEditing/inplaceEditingTextConfig
      • text: .../text/dialog/items/tab1/items/text
    • 유형:jcr:primaryType cq:Widget

    • 두 속성 모두 다음 속성을 갖습니다.

      • 이름 name
      • 유형 String
      • ./text
  3. 구성할 인터페이스에 따라 노드 <rtePlugins-node>이(가) 없는 경우 노드를 만듭니다.

    • 이름 rtePlugins
    • 유형 nt:unstructured
  4. 아래에서 활성화할 각 플러그인에 대한 노드를 만듭니다.

    • 유형 nt:unstructured
    • 플러그인 이름 필수 플러그인 ID

플러그인을 활성화한 후 다음 지침에 따라 features 속성을 구성합니다.

모든 기능 사용 몇 가지 특정 기능 활성화 모든 기능 비활성화
이름 features features features
유형 문자열 문자열[] (다중 문자열;유형을 문자열로 설정하고 CRXDE Lite에서 멀티를 클릭합니다.) 문자열
* (별표) 피쳐 값을 하나 이상으로 설정합니다. -

finderplace 플러그인 이해

findreplace 플러그인은 구성이 필요하지 않습니다. 그것은 즉시 작동한다.

바꾸기 기능을 사용할 때는 바꿀 대체 문자열을 찾기 문자열과 동시에 입력해야 합니다. 그러나 문자열을 대체하기 전에 찾기를 클릭하여 해당 문자열을 검색할 수 있습니다. 찾기를 클릭한 후 대체 문자열을 입력하면 검색이 텍스트 시작으로 재설정됩니다.

찾기 및 바꾸기 대화 상자는 찾기를 클릭하면 투명하게 되고 바꾸기를 클릭하면 불투명해집니다. 이렇게 하면 작성자가 대체할 텍스트를 검토할 수 있습니다. 사용자가 모두 바꾸기를 클릭하면 대화 상자가 닫히고 교체 횟수를 표시합니다.

붙여넣기 모드 구성

RTE를 사용할 때 작성자는 다음 3가지 모드 중 하나에 컨텐츠를 붙여넣을 수 있습니다.

  • 브라우저 모드:브라우저의 기본 붙여넣기 구현을 사용하여 텍스트를 붙여넣습니다. 원하지 않는 마크업을 추가할 수 있으므로 권장되지 않습니다.

  • 일반 텍스트 모드:클립보드 내용을 일반 텍스트로 붙여넣습니다. 복사한 콘텐트에서 스타일 및 서식 요소의 모든 요소를 제거하고 Experience Manager 구성 요소에 삽입합니다.

  • MS Word 모드:MS Word에서 복사할 때 서식이 적용된 표와 함께 텍스트를 붙여넣습니다. 웹 페이지 또는 MS Excel과 같은 다른 소스에서 텍스트를 복사하고 붙여넣는 것은 지원되지 않으며 부분 서식만 유지합니다.

RTE 도구 모음에서 사용할 수 있는 붙여넣기 옵션 구성

RTE 도구 모음에서 작성자에게 이러한 3가지 아이콘 중 일부, 전체 또는 하나도 제공하지 않을 수 있습니다.

  • 붙여넣기(Ctrl+V):위의 세 가지 붙여넣기 모드 중 하나에 해당하도록 미리 구성할 수 있습니다.

  • 텍스트로 붙여넣기:일반 텍스트 모드 기능을 제공합니다.

  • Word에서 붙여넣기:MS Word 모드 기능을 제공합니다.

필요한 아이콘을 표시하도록 RTE를 구성하려면 다음 단계를 수행합니다.

  1. 구성 요소로 이동합니다(예: /apps/<myProject>/components/text).
  2. 노드 rtePlugins/edit으로 이동합니다. 노드가 없으면 플러그인 활성화를 참조하십시오.
  3. edit 노드에 features 속성을 만들고 하나 이상의 기능을 추가합니다. 모든 변경 내용을 저장합니다.

붙여넣기(Ctrl+V) 아이콘과 단축키의 비헤이비어를 구성합니다.

다음 단계를 사용하여 붙여넣기(Ctrl+V) 아이콘의 동작을 미리 구성할 수 있습니다. 또한 이 구성은 작성자가 컨텐츠를 붙여넣는 데 사용하는 키보드 단축키 Ctrl+V의 동작도 정의합니다.

이 구성을 통해 다음과 같은 3가지 유형의 사용 사례가 허용됩니다.

  • 브라우저의 기본 붙여넣기 구현을 사용하여 텍스트를 붙여넣습니다. 원하지 않는 마크업을 추가할 수 있으므로 권장되지 않습니다. 아래 browser을(를) 사용하여 구성되었습니다.

  • 클립보드 내용을 일반 텍스트로 붙여넣습니다. AEM 구성 요소에 삽입하기 전에 복사한 콘텐트에서 스타일 및 서식 요소의 모든 요소를 제거합니다. 아래 plaintext을(를) 사용하여 구성되었습니다.

  • MS Word에서 복사할 때 서식이 적용된 표와 함께 텍스트를 붙여넣습니다. 웹 페이지 또는 MS Excel과 같은 다른 소스에서 텍스트를 복사하고 붙여넣는 것은 지원되지 않으며 부분 서식만 유지합니다. 아래 wordhtml을(를) 사용하여 구성되었습니다.

  1. 구성 요소에서 <rtePlugins-node>/edit 노드로 이동합니다. 노드가 없으면 노드를 만듭니다. 자세한 내용은 플러그인 활성화를 참조하십시오.

  2. edit 노드에서 다음 세부 정보를 사용하여 속성을 만듭니다.

    • 이름 defaultPasteMode
    • 유형 String
    • 필요한 붙여넣기 모드 browser plaintext 또는 wordhtml중 하나입니다.

컨텐츠를 붙여넣을 때 허용되는 형식을 구성합니다.

Microsoft Word와 같은 다른 프로그램에서 AEM에 붙여넣을 때 허용되는 스타일을 명시적으로 정의할 수 있도록 Microsoft-Word(paste-wordhtml) 붙여넣기 모드를 추가로 구성할 수 있습니다.

예를 들어 AEM에서 붙여넣을 때 굵은체 형식 및 목록만 허용해야 하는 경우 다른 형식을 필터링할 수 있습니다. 이 필터링을 구성 가능한 붙여넣기 필터라고 합니다. 이 필터링을 두 가지 모두에 대해 수행할 수 있습니다.

링크의 경우 자동으로 허용되는 프로토콜을 정의할 수도 있습니다.

다른 프로그램에서 AEM에 텍스트를 붙여넣을 때 허용되는 형식을 구성하려면:

  1. 구성 요소에서 노드 <rtePlugins-node>/edit으로 이동합니다. 노드가 없으면 노드를 만듭니다. 자세한 내용은 플러그인 활성화를 참조하십시오.

  2. edit 노드 아래에 노드를 만들어 HTML 붙여넣기 규칙을 유지합니다.

    • 이름 htmlPasteRules
    • 유형 nt:unstructured
  3. htmlPasteRules 아래에 노드를 만들어 허용되는 기본 형식에 대한 세부 정보를 저장합니다.

    • 이름 allowBasics
    • 유형 nt:unstructured
  4. 허용되는 개별 형식을 제어하려면 allowBasics 노드에서 다음 속성 중 하나 이상을 만드십시오.

    • 이름 bold
    • 이름 italic
    • 이름 underline
    • 이름 anchor (링크와 지정된 앵커 모두에 대해)
    • 이름 image

    모든 속성은 Type Boolean이므로 적절한 Value​에서 확인 표시를 선택하거나 제거하여 기능을 활성화하거나 비활성화할 수 있습니다.

    노트

    명시적으로 정의되어 있지 않으면 true의 기본값이 사용되고 형식이 허용됩니다.

  5. 다른 형식은 htmlPasteRules 노드에도 적용되는 다양한 속성 또는 노드를 사용하여 정의할 수도 있습니다.

속성 유형 설명
allowBlockTags String[]

허용되는 블록 태그 목록을 정의합니다.

몇 가지 가능한 블록 태그는 다음과 같습니다.

  • headlines (h1, h2, h3)
  • paragraphs (p)
  • lists (ol, ul)
  • 표(표)
fallbackBlockTag 문자열

allowBlockTags에 포함되지 않은 블록 태그가 있는 모든 블록에 사용되는 블록 태그를 정의합니다.

대부분의 경우 p가 적당하다.

nt:unstructured

표를 붙여넣을 때의 동작을 정의합니다.

이 노드에는 테이블 붙여넣기가 허용되는지 여부를 정의하려면 allow 속성(Boolean 유형)이 있어야 합니다.

allow이(가) false로 설정된 경우 ignoreMode 속성(유형 String)을 지정하여 붙여넣기한 테이블 컨텐츠가 처리되는 방식을 정의해야 합니다. ignoreMode에 유효한 값은 다음과 같습니다.

  • remove:표 컨텐츠를 제거합니다.
  • paragraph:표 셀을 단락으로 바꿉니다.
list nt:unstructured

목록을 붙여넣을 때의 동작을 정의합니다.

목록 붙여넣기가 허용되는지 여부를 정의하려면 allow 속성(Boolean 유형)이 있어야 합니다.

allow이(가) false으로 설정된 경우 ignoreMode 속성(String 유형)을 지정하여 붙여넣은 목록 컨텐트를 처리하는 방법을 정의해야 합니다. ignoreMode에 유효한 값은 다음과 같습니다.

  • remove:목록 컨텐츠를 제거합니다.
  • paragraph:목록 항목을 단락으로 바꿉니다.

유효한 htmlPasteRules 구조의 예:

"htmlPasteRules": {
    "allowBasics": {
        "italic": true,
        "link": true
    },
    "allowBlockTags": [
        "p", "h1", "h2", "h3"
    ],
    "list": {
        "allow": false,
        "ignoreMode": "paragraph"
    },
    "table": {
        "allow": true,
        "ignoreMode": "paragraph"
    }
}
  1. 모든 변경 내용을 저장합니다.

텍스트 스타일 구성

작성자는 스타일을 적용하여 텍스트 부분의 모양을 변경할 수 있습니다. 스타일은 CSS 스타일 시트에서 미리 정의한 CSS 클래스를 기반으로 합니다. 스타일이 지정된 컨텐츠는 CSS 클래스를 참조하기 위해 class 특성을 사용하여 span 태그로 묶입니다. 예:

<span class=monospaced>Monospaced Text Here</span>

스타일 플러그인이 처음 활성화되면 기본 스타일을 사용할 수 없습니다. 팝업 목록이 비어 있습니다. 작성자에게 스타일을 제공하려면 다음을 수행합니다.

  • 스타일 드롭다운 선택기를 활성화합니다.
  • 스타일 시트의 위치를 지정합니다.
  • 스타일 드롭다운 목록에서 선택할 수 있는 개별 스타일을 지정합니다.

나중에(다시) 구성에서는 스타일을 더 추가하려면 지침을 따라 새 스타일 시트를 참조하고 추가 스타일을 지정합니다.

노트

표 또는 표 셀에 대해 스타일을 정의할 수도 있습니다. 이러한 구성에는 별도의 절차가 필요합니다.

스타일 드롭다운 선택기 목록 활성화

스타일 플러그인을 활성화하면 됩니다.

  1. 구성 요소에서 노드 <rtePlugins-node>/styles으로 이동합니다. 노드가 없으면 노드를 만듭니다. 자세한 내용은 플러그인 활성화를 참조하십시오.

  2. styles 노드에 features 속성을 만듭니다.

    • 이름 features
    • 유형 String
    • * (별표)
  3. 모든 변경 내용을 저장합니다.

노트

스타일 플러그인이 활성화되면 스타일 드롭다운 목록이 편집 대화 상자에 표시됩니다. 하지만 스타일이 구성되지 않아 목록이 비어 있습니다.

스타일 시트 위치 지정

그런 다음 참조할 스타일 시트의 위치를 지정합니다.

  1. 텍스트 구성 요소의 루트 노드(예: /apps/<myProject>/components/text)로 이동합니다.

  2. <rtePlugins-node>의 부모 노드에 속성 externalStyleSheets을 추가합니다.

    • 이름 externalStyleSheets
    • 유형 String[] (multi-string;멀티인 ​CRXDE를 클릭합니다.)
    • 을 포함할 모든 스타일 시트의 경로와 파일 이름입니다. 저장소 경로를 사용합니다.
    노트

    나중에 언제든지 추가 스타일 시트에 대한 참조를 추가할 수 있습니다.

  3. 모든 변경 내용을 저장합니다.

노트

대화 상자에서 RTE 사용(클래식 UI) 리치 텍스트 편집에 최적화된 스타일 시트를 지정할 수 있습니다. 기술적 제한으로 인해 CSS 컨텍스트가 편집기에서 손실되므로 WYSIWYG 환경을 개선하기 위해 이 컨텍스트를 에뮬레이션할 수 있습니다.

리치 텍스트 편집기는 ID가 CQrte인 컨테이너 DOM 요소를 사용하여 보고 편집하기 위해 다른 스타일을 제공하는 데 사용할 수 있습니다.

#CQ td {
// defines the style for viewing
}
#CQrte td {
// defines the style for editing
}

팝업 목록에서 사용 가능한 스타일을 지정합니다.

  1. 구성 요소 정의에서 스타일 드롭다운 선택기 활성화에서 만든 대로 <rtePlugins-node>/styles 노드로 이동합니다.

  2. 노드 styles에서 사용 가능한 목록을 저장할 새 노드(styles라고도 함)를 만듭니다.

    • 이름 styles
    • 유형 cq:WidgetCollection
  3. 개별 스타일을 나타내는 새 노드를 styles 노드 아래에 만듭니다.

    • 이름, 이름을 지정할 수 있지만 스타일에 적합해야 합니다
    • 유형 nt:unstructured
  4. CSS 클래스를 참조하기 위해 속성 cssName을 이 노드에 추가합니다.

    • 이름 cssName
    • 유형 String
    • CSS 클래스의 이름입니다(이전 '.' 없이).;예를 들어 .cssClass 대신 cssClass
  5. 속성 text을 동일한 노드에 추가합니다.선택 상자에 표시되는 텍스트를 정의합니다.

    • 이름 text
    • 유형 String
    • 스타일에 대한 설명;을 클릭합니다.
  6. 변경 사항을 저장합니다.

    필요한 각 스타일에 대해 위 단계를 반복합니다.

일본어에서 최적의 단어 분리를 위해 RTE 구성

AEM을 사용하여 일본어 언어 컨텐츠를 작성하는 작성자는 문자 스타일을 적용하여 나누기가 필요하지 않은 줄 바꿈을 방지할 수 있습니다. 이렇게 하면 작성자가 원하는 위치에서 문장이 나누어질 수 있습니다. 이 기능의 스타일은 CSS 스타일 시트에서 미리 정의된 CSS 클래스를 기반으로 합니다.

노트

이 기능을 사용하려면 AEM 6.5 서비스 팩 1 이상이 필요합니다.

작성자가 일본어 텍스트에 적용할 수 있는 스타일을 만들려면 다음 단계를 수행합니다.

  1. 스타일 노드 아래에 새 노드를 만듭니다. 새 스타일 지정을 참조하십시오.

    • 이름: jpn-word-wrap
    • 유형:'nt:unstructure
  2. CSS 클래스를 참조하기 위해 속성 cssName을 노드에 추가합니다. 이 클래스 이름은 일본어 단어 줄 바꿈 기능에 예약된 이름입니다.

    • 이름: cssName
    • 유형: String
    • 값:jpn-word-wrap(이전 . 없이)
  3. 속성 텍스트를 동일한 노드에 추가합니다. 값은 작성자가 스타일을 선택할 때 보는 스타일의 이름입니다.

    • 이름:text
      *유형:
      String
    • 값: Japanese word-wrap
  4. 스타일시트를 만들고 해당 경로를 지정합니다. 스타일시트의 위치 지정을 참조하십시오. 스타일시트에 다음 컨텐츠를 추가합니다. 원하는 대로 배경색을 변경합니다.

    .text span.jpn-word-wrap {
        display:inline-block;
    }
    .is-edited span.jpn-word-wrap {
        background-color: #ffddff;
    }
    

    작성자가 일본어 단어 감싸기 기능을 사용할 수 있도록 하는 스타일시트

단락 형식 구성

RTE로 제작된 모든 텍스트는 블록 태그 내에 배치됩니다. 기본값은 <p>입니다. paraformat 플러그인을 활성화하면 드롭다운 선택 목록을 사용하여 단락에 할당할 수 있는 추가 블록 태그를 지정할 수 있습니다. 단락 형식은 올바른 블록 태그를 지정하여 단락 유형을 결정합니다. 작성자는 형식 선택기를 사용하여 이러한 형식을 선택하고 할당할 수 있습니다. 예제 블록 태그에는 표준 단락 <p> 및 머리글 <h1>, <h2> 등이 포함됩니다.

주의

이 플러그인은 목록 또는 표와 같이 구조가 복잡한 컨텐츠에 적합하지 않습니다.

노트

<hr> 태그와 같이 블록 태그를 단락에 할당할 수 없는 경우 paraformat 플러그인에 유효한 사용 사례가 아닙니다.

단락 서식 플러그인이 처음으로 활성화되어 있으면 기본 단락 형식을 사용할 수 없습니다. 팝업 목록이 비어 있습니다. 작성자에게 단락 형식을 제공하려면 다음을 수행합니다.

  • 형식 드롭다운 선택기 목록을 활성화합니다.
  • 드롭다운에서 단락 형식으로 선택할 수 있는 블록 태그를 지정합니다.

나중에(다시) 구성을 위해, 더 많은 포맷을 추가하려면 지침 중 관련 부분만 따르십시오.

형식 드롭다운 선택기 사용

먼저 paraformat 플러그인을 활성화합니다.

  1. 구성 요소에서 노드 <rtePlugins-node>/paraformat으로 이동합니다. 노드가 없으면 노드를 만듭니다. 자세한 내용은 플러그인 활성화를 참조하십시오.

  2. paraformat 노드에 features 속성을 만듭니다.

    • 이름 features
    • 유형 String
    • * (별표)
노트

플러그인이 추가로 구성되지 않으면 다음 기본 형식이 활성화됩니다.

  • 단락 ( <p>)
  • 제목 1 ( <h1>)
  • 제목 2 ( <h2>)
  • 제목 3 ( <h3>)
주의

RTE의 단락 형식을 구성할 때 서식 지정 옵션으로 단락 태그 <p>를 제거하지 마십시오. <p> 태그가 제거되면 추가 형식이 구성되어 있더라도 내용 작성자는 단락 형식 옵션을 선택할 수 없습니다.

사용 가능한 단락 형식 지정

다음 방법을 통해 단락 형식을 선택할 수 있습니다.

  1. 구성 요소 정의에서 형식 드롭다운 선택기 활성화에 만든 대로 <rtePlugins-node>/paraformat 노드로 이동합니다.

  2. paraformat 노드 아래에서 새 노드를 만들어 형식 목록을 유지합니다.

    • 이름 formats
    • 유형 cq:WidgetCollection
  3. formats 노드 아래에 새 노드를 만듭니다. 이 노드에는 개별 형식에 대한 세부 정보가 포함됩니다.

    • 이름, 이름을 지정할 수 있지만 형식(예: myparagraph, myheading1)에 적합해야 합니다.
    • 유형 nt:unstructured
  4. 이 노드에 사용된 블록 태그를 정의하는 속성을 추가합니다.

    • 이름 tag

    • 유형 String

    • 형식에 대한 블록 태그입니다.예를 들면 다음과 같습니다.p, h1, h2 등

      구분 각괄호를 입력할 필요가 없습니다.

  5. 같은 노드에 다른 속성을 추가하려면 설명 텍스트가 드롭다운 목록에 표시되도록 합니다.

    • 이름 description
    • 유형 String
    • 이 형식을 설명하는 텍스트입니다.예를 들어 단락, 머리글 1, 머리글 2 등이 있습니다. 이 텍스트는 형식 선택 목록에 표시됩니다.
  6. 변경 사항을 저장합니다.

    각 필수 형식에 대해 단계를 반복합니다.

주의

사용자 정의 형식을 정의하는 경우 기본 형식(<p>, <h1>, <h2><h3>)이 제거됩니다. 기본 형식이므로 <p> 형식을 다시 만듭니다.

특수 문자 구성

표준 AEM 설치에서 misctools 플러그인이 특수 문자(specialchars)에 대해 활성화된 경우 기본 선택 항목을 즉시 사용할 수 있습니다.예를 들어 저작권 및 상표 심볼이 있습니다.

사용자가 직접 선택한 문자를 사용할 수 있도록 RTE를 구성할 수 있습니다.개별 문자를 정의하거나 전체 시퀀스를 정의할 수 있습니다.

주의

고유한 특수 문자를 추가하면 기본 선택 내용이 무시됩니다. 필요한 경우 (다시) 선택한 내용에 이러한 문자를 정의합니다.

단일 문자 정의

  1. 구성 요소에서 노드 <rtePlugins-node>/misctools으로 이동합니다. 노드가 없으면 노드를 만듭니다. 자세한 내용은 플러그인 활성화를 참조하십시오.

  2. misctools 노드에 features 속성을 만듭니다.

    • 이름 features

    • 유형 String[]

    • specialchars

      (또는 이 플러그인에 대한 모든 기능을 적용하는 경우 String / *)

  3. misctools에서 특수 문자 구성을 저장할 노드를 만듭니다.

    • 이름 specialCharsConfig
    • 유형 nt:unstructured
  4. specialCharsConfig 아래에서 문자 목록을 저장할 다른 노드를 만듭니다.

    • 이름 chars
    • 유형 nt:unstructured
  5. chars에서 개별 문자 정의를 저장할 새 노드를 추가합니다.

    • 이름 은 이름을 지정할 수 있지만 문자를 반영해야 합니다.예를 들어, 절반.
    • 유형 nt:unstructured
  6. 이 노드에 다음 속성을 추가합니다.

    • 이름 entity
    • 유형 String
    • 필수 문자의 HTML 표현 값;예를 들어 분수 1/2 &189; 의 경우.
  7. 변경 사항을 저장합니다.

CRXDE에서 속성을 저장하면 표현된 문자가 표시됩니다. 절반 예를 참조하십시오. 작성자가 더 많은 특수 문자를 사용할 수 있도록 하려면 위 단계를 반복합니다.

CRXDE에서 RTE 도구 모음에서 사용할 수 있는 단일 문자

문자 범위 정의

  1. 단일 문자 정의에서 1단계부터 3단계까지 사용합니다.

  2. chars 아래에서 문자 범위의 정의를 저장할 새 노드를 추가합니다.

    • 이름 은 이름을 지정할 수 있지만 문자 범위를 반영해야 합니다.예를 들어 연필
    • 유형 nt:unstructured
  3. 이 노드(특수 문자 범위에 따라 이름 지정)에서 다음 두 속성을 추가합니다.

    • 이름 rangeStart

      유형 Long
      범위 🔗 에서 첫 번째 문자의 유니코드 표현(십진수)입니다.

    • 이름 rangeEnd

      유형 Long
      이 범위 🔗 에서 마지막 문자의 유니코드 표현(십진수)입니다.

  4. 변경 사항을 저장합니다.

    예를 들어 9998 - 10000에서 범위를 정의하면 다음 문자가 제공됩니다.

    CRXDE에서 RTE에서 사용할 수 있도록 설정할 문자 범위를 정의합니다.

    그림:CRXDE에서 RTE에서 사용할 수 있도록 설정할 문자 범위를 정의합니다.

    RTE에서 사용할 수 있는 특수 문자는 팝업 창에서 작성자에게

표 스타일 구성

스타일은 일반적으로 텍스트에 적용되지만 별도의 스타일 세트를 표 또는 일부 표 셀에도 적용할 수 있습니다. 이러한 스타일은 셀 속성 또는 표 속성 대화 상자의 스타일 선택기 상자에서 사용할 수 있습니다. 스타일은 표준 표 구성 요소가 아닌 텍스트 구성 요소(또는 파생) 내의 표를 편집할 때 사용할 수 있습니다.

노트

클래식 UI에 대해서만 표 및 셀의 스타일을 정의할 수 있습니다.

노트

RTE 구성 요소의 표 복사 및 붙여넣기는 브라우저에 따라 다릅니다. 모든 브라우저에서는 기본적으로 지원되지 않습니다. 테이블 구조와 브라우저에 따라 다양한 결과를 얻을 수 있습니다. 예를 들어 클래식 UI 및 터치 UI에서 Mozilla Firefox의 RTE 구성 요소에 표를 복사하여 붙여넣으면 표 레이아웃이 보존되지 않습니다.

  1. 구성 요소 내에서 <rtePlugins-node>/table 노드로 이동합니다. 노드가 없으면 노드를 만듭니다. 자세한 내용은 플러그인 활성화를 참조하십시오.

  2. table 노드에 features 속성을 만듭니다.

    • 이름 features
    • 유형 String
    • *
    노트

    모든 표 기능을 활성화하지 않으려면 features 속성을 다음과 같이 만들 수 있습니다.

    • 유형 String[]
    • 필요에 따라 다음 중 하나 또는 둘 다의 값:
      • table 표 속성을 편집할 수 있습니다.스타일을 포함합니다.
      • cellprops 를 클릭하여 스타일을 포함한 셀 속성을 편집할 수 있습니다.
  3. CSS 스타일 시트의 위치를 정의하여 지정합니다. 텍스트🔗에 대해 스타일을 정의할 때와 동일하게 스타일 시트 위치 지정을 참조하십시오. 다른 스타일을 정의한 경우 위치를 정의할 수 있습니다.

  4. table 노드 아래에서 다음 새 노드를 만듭니다(필요한 경우).

    • 전체 표에 대한 스타일을 정의하려면(표 속성​에서 사용 가능):

      • 이름 tableStyles
      • 유형 cq:WidgetCollection
    • 개별 셀에 대한 스타일을 정의하려면(셀 속성​에서 사용 가능):

      • 이름 cellStyles
      • 유형 cq:WidgetCollection
  5. 개별 스타일을 나타내는 새 노드(해당하는 경우 tableStyles 또는 cellStyles 노드 아래)를 만듭니다.

    • 이름 을 지정할 수 있지만 스타일을 반영해야 합니다.
    • 유형 nt:unstructured
  6. 이 노드에서 속성을 만듭니다.

    • 참조할 CSS 스타일을 정의하려면

      • 이름 cssName
      • 유형 String
      • ​CSS 클래스의 이름을 지정합니다(예: 앞에 .cssClass 대신 .cssClass).
    • 드롭다운 선택기에 표시할 설명 텍스트를 정의하려면

      • 이름 text
      • 유형 String
      • 선택 목록에 표시할 텍스트를 지정합니다.
  7. 모든 변경 내용을 저장합니다.

필요한 각 스타일에 대해 위 단계를 반복합니다.

액세스 가능성에 대한 테이블의 숨겨진 헤더 구성

열의 목적이 다른 열과 열 간의 시각적 관계에 의해 암묵되어 있다고 가정할 때 열 머리글에 시각적 텍스트가 없는 데이터 표를 만들 수 있습니다. 이 경우 다양한 요구 사항이 있는 독자가 열의 목적을 이해하는 데 도움이 되도록 헤더 셀의 셀 내에 숨겨진 내부 텍스트를 제공해야 합니다.

이러한 시나리오에서 액세서빌러티를 향상시키기 위해 RTE는 숨겨진 헤더 셀을 지원합니다. 또한 테이블의 숨겨진 헤더와 관련된 구성 설정을 제공합니다. 이러한 설정을 사용하면 편집 및 미리 보기 모드에서 숨겨진 헤더에 CSS 스타일을 적용할 수 있습니다. 작성자가 편집 모드에서 숨겨진 헤더를 식별하는 데 도움이 되도록 코드에 다음 매개 변수를 포함하십시오.

  • hiddenHeaderEditingCSS:RTE를 편집할 때 숨겨진 헤더 셀에 적용되는 CSS 클래스의 이름을 지정합니다.
  • hiddenHeaderEditingStyle:RTE를 편집할 때 숨겨진 헤더 셀에 적용되는 스타일 문자열을 지정합니다.

코드에서 CSS와 스타일 문자열을 모두 지정하는 경우 CSS 클래스가 스타일 문자열보다 우선하며 스타일 문자열의 구성 변경 사항을 덮어쓸 수 있습니다.

작성자가 미리 보기 모드에서 숨겨진 헤더에 CSS를 적용할 수 있도록 코드에 다음 매개 변수를 포함할 수 있습니다.

  • hiddenHeaderClassName:미리 보기 모드에서 숨겨진 헤더 셀에 적용되는 CSS 클래스의 이름을 지정합니다.
  • hiddenHeaderStyle:미리 보기 모드에서 숨겨진 헤더 셀에 적용되는 스타일 문자열을 지정합니다.

코드에서 CSS와 스타일 문자열을 모두 지정하는 경우 CSS 클래스가 스타일 문자열보다 우선하며 스타일 문자열의 구성 변경 사항을 덮어쓸 수 있습니다.

맞춤법 검사기에 대한 사전 추가

맞춤법 검사 플러그인이 활성화되면 RTE에서는 각 해당 언어에 대한 사전을 사용합니다. 그런 다음 하위 트리의 언어 속성을 가져오거나 URL에서 언어를 추출하여 웹 사이트의 언어에 따라 선택됩니다.예를 들면 다음과 같습니다. /en/ 분기는 영어로 확인되고 /de/ 분기는 독일어로 표시됩니다.

노트

설치되어 있지 않은 언어에 대해 Spell checking failed 메시지가 표시됩니다. 표준 사전은 해당 Readme 파일과 함께 /libs/cq/spellchecker/dictionaries에 있습니다. 파일을 수정하지 마십시오.

표준 AEM 설치에는 미국 영어(en_us) 및 영국 영어(en_gb)에 대한 사전이 포함되어 있습니다. 사전을 추가하려면 다음 단계를 따르십시오.

  1. https://extensions.openoffice.org/ 페이지로 이동합니다.

  2. 선택한 언어 사전을 찾으려면 다음 중 하나를 수행합니다.

    • 원하는 언어 사전을 찾아보십시오. 사전 페이지에서 원본 소스 또는 작성자의 웹 페이지에 대한 링크를 찾습니다. 이러한 페이지에서 v2.x용 사전 파일을 찾습니다.
    • https://wiki.openoffice.org/wiki/User:Khirano/Dictionaries에서 v2.x 사전 파일을 검색합니다.
  3. 철자 정의가 있는 아카이브를 다운로드합니다. 파일 시스템에서 아카이브 컨텐츠를 추출합니다.

    주의

    OpenOffice.org v2.0.1 이하 버전에 대한 MySpell 형식의 사전만 지원됩니다. 사전이 이제 파일을 보관하는 것이므로 다운로드한 후 아카이브를 확인하는 것이 좋습니다.

  4. .aff 및 .dic 파일을 찾습니다. 파일 이름을 소문자로 유지합니다. 예: de_de.affde_de.dic.

  5. /apps/cq/spellchecker/dictionaries의 저장소에서 .aff 및 .dic 파일을 로드합니다.

노트

RTE 맞춤법 검사기는 on-demand로 사용할 수 있습니다. 텍스트를 입력하기 시작하면 자동으로 실행되지 않습니다. 맞춤법 검사기를 실행하려면 도구 모음에서 맞춤법 검사기를 클릭합니다. RTE는 단어의 맞춤법을 검사하고 철자가 틀린 단어를 강조 표시합니다.
맞춤법 검사기에서 제안하는 변경 내용을 포함할 경우 텍스트 상태가 변경되고 맞춤법이 틀린 단어가 더 이상 강조 표시되지 않습니다. 맞춤법 검사기를 실행하려면 맞춤법 검사기 단추를 다시 탭/클릭합니다.

실행 취소 및 다시 실행 작업에 대한 작업 내역 크기 구성

RTE를 사용하면 마지막으로 편집한 내용을 실행 취소하거나 다시 실행할 수 있습니다. 기본적으로 50개의 편집 내용이 내역에 저장됩니다. 필요에 따라 이 값을 구성할 수 있습니다.

  1. 구성 요소 내에서 <rtePlugins-node>/undo 노드로 이동합니다. 이 노드가 없으면 노드를 만듭니다. 자세한 내용은 플러그인 활성화를 참조하십시오.

  2. undo 노드에서 속성을 만듭니다.

    • 이름 maxUndoSteps
    • 유형 Long
    • 작업 내역 에 저장할 실행 취소 단계 수입니다. 기본값은 50입니다. 실행 취소/다시 실행을 완전히 비활성화하려면 0을 사용합니다.
  3. 변경 사항을 저장합니다.

탭 크기 구성

텍스트 내에서 탭 문자를 누르면 사전 정의된 공백 수가 삽입됩니다.기본적으로 3개의 비분리 공백 및 1개의 공백이 있습니다.

탭 크기를 정의하려면

  1. 구성 요소에서 노드 <rtePlugins-node>/keys으로 이동합니다. 노드가 없으면 노드를 만듭니다. 자세한 내용은 플러그인 활성화를 참조하십시오.

  2. keys 노드에서 속성을 만듭니다.

    • 이름 tabSize
    • 유형 String
    • ​변기에 사용할 공백 문자 수를 반환합니다.
  3. 변경 사항을 저장합니다.

들여쓰기 여백 설정

들여쓰기를 활성화하면(기본값) 들여쓰기 크기를 정의할 수 있습니다.

노트

이 들여쓰기 크기는 텍스트의 단락(블록)에만 적용됩니다.실제 목록의 들여쓰기에는 영향을 주지 않습니다.

  1. 구성 요소 내에서 <rtePlugins-node>/lists 노드로 이동합니다. 이 노드가 없으면 노드를 만듭니다. 자세한 내용은 플러그인 활성화를 참조하십시오.

  2. lists 노드에서 identSize 매개 변수를 만듭니다.

    • 이름: identSize
    • 유형: Long
    • :들여쓰기 여백에 필요한 픽셀 수입니다.

편집 가능한 공간 높이 구성

노트

이는 대화 상자에서 RTE를 사용할 때만 해당됩니다(클래식 UI에서는 즉석 편집 작업이 아님).

구성 요소 대화 상자에 표시된 편집 가능한 공간의 높이를 정의할 수 있습니다.

  1. 구성 요소에 대한 대화 상자 정의의 ../items/text 노드에서 새 속성을 만듭니다.

    • 이름 height
    • 유형 Long
    • 편집 캔버스의 높이를 픽셀 단위로 지정합니다.
    노트

    대화 상자 창의 높이는 변경되지 않습니다.

  2. 변경 사항을 저장합니다.

링크에 대한 스타일 및 프로토콜 구성

AEM에서 링크를 추가할 때 다음을 정의할 수 있습니다.

  • 사용할 CSS 스타일
  • 프로토콜이 자동으로 승인됨

다른 프로그램에서 AEM에 링크가 추가되는 방식을 구성하려면 HTML 규칙을 정의합니다.

  1. CRXDE Lite을 사용하여 프로젝트의 텍스트 구성 요소를 찾습니다.

  2. <rtePlugins-node>과 동일한 수준에서 새 노드를 만듭니다. 즉, <rtePlugins-node>의 상위 노드 아래에 노드를 만듭니다.

    • 이름 htmlRules
    • 유형 nt:unstructured
    노트

    ../items/text 노드에는 속성이 있습니다.

    • 이름 xtype
    • 유형 String
    • richtext

    ../items/text 노드의 위치는 대화 상자의 구조에 따라 다를 수 있습니다.두 가지 예는 다음과 같습니다.

    • /apps/myProject>/components/text/dialog/items/text
    • /apps/<myProject>/components/text/dialog/items/panel/items/text
  3. htmlRules 아래에서 새 노드를 만듭니다.

    • 이름 links
    • 유형 nt:unstructured
  4. links 노드 아래에서 필요에 따라 속성을 정의합니다.

    • 내부 링크에 대한 CSS 스타일:

      • 이름 cssInternal
      • 유형 String
      • ​CSS 클래스의 이름을 지정합니다(이전 '.' 없이).;예를 들어 .cssClass 대신 cssClass
    • 외부 링크에 대한 CSS 스타일

      • 이름 cssExternal
      • 유형 String
      • ​CSS 클래스의 이름을 지정합니다(이전 '.' 없이).;예를 들어 .cssClass 대신 cssClass
    • 유효한 프로토콜​의 배열입니다. 지원되는 프로토콜은 http://, https://, file://mailto:입니다.

      • 이름 protocols
      • 유형 String[]
      • 하나 이상의 프로토콜
    • defaultProtocol (String 유형의 속성):사용자가 명시적으로 프로토콜을 지정하지 않은 경우 사용할 프로토콜입니다.

      • 이름 defaultProtocol
      • 유형 String
      • 하나 이상의 기본 프로토콜
    • 링크의 대상 속성을 처리하는 방법에 대한 정의입니다. 새 노드를 만듭니다.

      • 이름 targetConfig
      • 유형 nt:unstructured

      노드 targetConfig에서:필수 속성을 정의합니다.

      • 대상 모드를 지정합니다.

        • 이름 mode

        • 유형 String)

        • :

          • auto:자동 타겟이 선택됨을 의미합니다.

            (외부 링크의 경우 targetExternal 속성으로 지정되거나 내부 링크의 경우 targetInternal 지정).

          • manual:이 컨텍스트에 적용되지 않음

          • blank:이 컨텍스트에 적용되지 않음

      • 내부 링크의 대상:

        • 이름 targetInternal
        • 유형 String
        • 내부 링크에 대한 타겟의 값(모드가 auto인 경우에만 사용)
      • 외부 링크의 대상:

        • 이름 targetExternal
        • 유형 String
        • 외부 링크 에 대한 타겟을 지정합니다(모드가 auto인 경우에만 사용됨).
  5. 모든 변경 내용을 저장합니다.

이 페이지에서는