소개 파트 구성

org.eclipse.ui.intro.config

3.0

이 확장점은 소개 구성을 등록하는 데 사용됩니다. 이 구성은 지정된 소개 컨트리뷰션에 대한 프리젠테이션 구현 및 컨텐츠를 제공합니다. 소개는 Workbench를 처음 실행할 때 "도움말" 메뉴의 선택사항으로 나타납니다. 이 소개는 일반적으로 Eclipse에 빌드된 제품을 사용자에게 소개하는 데 사용됩니다.

소개는 일반적으로 소개 자료의 특정 카테고리를 반영하는 소개 페이지로 구성되어 있습니다. 예를 들어 새로운 기능 페이지는 이전 버전 다음의 새로운 개념 또는 기능을 소개할 수 있습니다. 한 소개 구성에서 정의한 컨텐츠는 org.eclipse.ui.intro.configExtension 확장점을 사용하여 다른 플러그인에서 참조되고 확장될 수 있습니다.

<!ELEMENT extension (handle? , config+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT config (presentation)>

<!ATTLIST config

introId CDATA #REQUIRED

id      CDATA #REQUIRED

content CDATA #REQUIRED>

구성 요소는 사용자 정의할 수 있는 소개 파트를 구성하는 데 사용될 수 있습니다. 구성 요소는 ID, 소개 ID 및 컨텐츠 파일을 지정해야 합니다. 소개 컨텐츠 파일은 소개에 있는 페이지, 그룹 및 링크 등을 설명하는 XML 파일입니다.



<!ELEMENT presentation (implementation+ , launchBar?)>

<!ATTLIST presentation

home-page-id    CDATA #REQUIRED

standby-page-id CDATA #IMPLIED>

소개 파트 프리젠테이션의 가능한 모든 구현을 정의하는 프리젠테이션 요소. 하나 이상의 구현이 정의될 수 있습니다. 구현의 os/ws 속성에 따라, 시작 시 하나의 구현만 선택됩니다. 그렇지 않으면 os/ws 속성이 정의되지 않은 첫 번째 구현이 선택됩니다.



<!ELEMENT implementation (head?)>

<!ATTLIST implementation

kind  (swt|html)

style CDATA #IMPLIED

os    CDATA #IMPLIED

ws    CDATA #IMPLIED>

상자에서 수용되지 않는 플랫폼의 프리젠테이션에는 두 가지 구현이 있습니다. 하나는 SWT 브라우저에 기초하는 반면, 다른 하나는 UI 양식에 기초합니다. 사용자 정의할 수 있는 소개 파트는 현재 OS 및 WS에 기초하여 이러한 두 개의 프리젠테이션 중 하나를 선택하도록 구성될 수 있습니다. 구현 유형은 swt 또는 html일 수 있습니다.



<!ELEMENT launchBar (handle? , shortcut*)>

<!ATTLIST launchBar

location (left|bottom|right|fastview) "fastview"

bg       CDATA #IMPLIED

fg       CDATA #IMPLIED>

실행 표시줄은 'switchToLaunchBar' 명령과 함께 작동합니다. 명령은 실행될 때 소개를 닫고 기본 창의 트림 영역 중 하나에 실행 표시줄을 작성합니다. 실행 표시줄에는 사용자가 마지막 소개 페이지로 리턴할 수 있는 최소한 하나의 단추가 들어 있습니다. 선택적으로 shortcut 요소를 사용하여 정의되는 추가 단추를 포함할 수 있습니다. 이들 단추를 사용하여 특정 소개 페이지로 빨리 이동할 수 있습니다. 3.1 이후



<!ELEMENT shortcut EMPTY>

<!ATTLIST shortcut

tooltip CDATA #IMPLIED

icon    CDATA #REQUIRED

url     CDATA #REQUIRED>

각 단축키 요소에 대해 단추가 소개 실행 표시줄에 작성됩니다. 단추를 누를 때 해당 단축키에 정의되는 URL이 실행됩니다. 3.1 이후



<!ELEMENT handle EMPTY>

<!ATTLIST handle

close (true | false) "true"

image CDATA #IMPLIED>

실행 표시줄 핸들이 렌더링되는 방법을 제어하는 선택적 요소입니다. 3.1 이후



<!ELEMENT introContent (page+ , group* , extensionContent*)>

introContent 요소에서는 소개 컨텐츠 파일의 본문을 정의합니다. 컨텐츠 파일은 페이지, 여러 페이지에 들어 있을 수 있는 공유 그룹 및 기타 구성에서 정의된 확장점을 앵커하는 확장점으로 구성됩니다.



<!ELEMENT page (group* | link* | text* | head* | img* | include* | html* | title? | anchor* | contentProvider*)>

<!ATTLIST page

url          CDATA #IMPLIED

id           CDATA #REQUIRED

style        CDATA #IMPLIED

alt-style    CDATA #IMPLIED

filteredFrom (swt|html)

content      CDATA #IMPLIED

style-id     CDATA #IMPLIED

shared-style (true | false) >

이 요소를 사용하여 표시할 페이지를 설명합니다. 소개에서는 동적 및 정적 페이지를 모두 표시할 수 있습니다.
동적 페이지의 컨텐츠는 아래 설명된 페이지의 부속 요소에서 생성됩니다. style 또는 alt-style은 프리젠테이션에 따라 적용됩니다. ID 또는 클래스 ID를 참조하여 스타일을 더 향상시킬 수 있습니다.
정적 페이지의 경우 하나의 소개에서 기존 HTML 문서를 재사용할 수 있고 정적 또는 동적 페이지에서 해당 정적 페이지를 링크할 수 있습니다. 정적 페이지는 페이지 요소에서 정의되지 않으며 다른 페이지에서 링크할 수 있는 단순한 html 파일입니다.
ID가 소개 구성 확장점의 프리젠테이션 요소에 지정된 홈 페이지는 정적 페이지임을 표시하는 URL을 포함할 수 있습니다. URL이 지정되지 않은 경우 홈 페이지는 동적 페이지로 가정됩니다. 페이지 요소를 사용하여 설명된 다른 모든 페이지는 동적 페이지입니다.
또한 SWT 프리젠테이션을 사용하고 정적 페이지를 표시하는 경우 외부 브라우저를 실행하여 계속 현재 페이지를 볼 수 있음에 유의하십시오.
동적 페이지에서 사용되는 부속 요소는 다음과 같습니다. group 부속 요소는 관련 컨텐츠를 그룹화하고 그룹화된 컨텐츠에서 스타일을 적용하는 데 사용됩니다. link 부속 요소에서는 정적 또는 동적 페이지에 링크하여 소개 조치/명령을 실행하는 데 사용할 수 있는 링크를 정의합니다. 링크는 보통 페이지 레벨에서 정의되어 기본 페이지와 페이지 내의 링크 사이를 탐색합니다. text 부속 요소는 페이지 레벨에서 텍스트 컨텐츠를 정의합니다. head 부속 요소는 웹 기반 프리젠테이션에만 적용 가능하며 추가 html을 HTML head 섹션에 추가할 수 있습니다. 이 요소는 java 스크립트 또는 추가 스타일시트를 추가하는 데 유용합니다. img 부속 요소는 페이지 레벨에서 이미지 컨텐츠를 정의합니다. include 부속 요소를 사용하면 페이지 이외의 요소를 재사용할 수 있습니다. html 부속 요소는 웹 기반 프리젠테이션에만 적용 가능하며 페이지 컨텐츠에 html을 임베드하거나 포함시킬 수 있습니다. 임베드하는 경우 html 파일을 참조하여 완전 정의된 html 파일을 HTML object에 임베드할 수 있습니다. 포함시키는 경우 html 파일의 html 스니펫을 직접 포함시킬 수 있습니다. title 부속 요소에서는 페이지의 제목을 정의합니다. anchor 부속 요소에서는 <extensionContent> 요소의 외부 컨트리뷰션을 수행할 수 있는 확장점을 정의합니다.



<!ELEMENT group (group* | link* | text* | img* | include* | html* | anchor* | contentProvider*)>

<!ATTLIST group

id           CDATA #REQUIRED

label        CDATA #IMPLIED

style-id     CDATA #IMPLIED

filteredFrom (swt|html) >

그룹 관련 컨텐츠, 유사한 스타일을 적용해야 하는 컨텐츠 또는 다른 페이지에 함께 포함되는 컨텐츠에서 사용됩니다.



<!ELEMENT head EMPTY>

<!ATTLIST head

src      CDATA #REQUIRED

encoding CDATA #IMPLIED>

페이지의 HEAD 컨텐츠 페이지에 포함시킬 HTML를 지정합니다. 추가 html을 HTML HEAD 섹션에 추가할 수 있습니다. 이 방법은 java 스크립트 또는 추가 스타일시트를 추가하는 데 유용합니다. 이 마크업은 HTML 기반 소개 부분을 구현할 때만 사용됩니다. UI 양식을 구현하는 경우 무시됩니다. 페이지에 둘 이상의 헤드 요소가 있을 수 있습니다. 구현에서는 모든 페이지가 공유되므로 하나의 head 요소만 포함될 수 있습니다.



<!ELEMENT title EMPTY>

<!ATTLIST title

id           CDATA #IMPLIED

style-id     CDATA #IMPLIED

filteredFrom (swt|html) >

이스케이프 처리된 HTML 태그를 선택적으로 포함할 수 있는 텍스트의 스니펫입니다. 페이지 제목으로만 사용되므로 해당 페이지에는 최대 하나의 제목 요소가 들어 있을 수 있습니다.



<!ELEMENT link (text? , img?)>

<!ATTLIST link

id           CDATA #IMPLIED

label        CDATA #IMPLIED

url          CDATA #REQUIRED

style-id     CDATA #IMPLIED

filteredFrom (swt|html) >

정적 HTML 파일, 외부 웹 사이트에 링크하거나 소개 URL 조치를 실행할 수 있습니다.



<!ELEMENT text EMPTY>

<!ATTLIST text

id           CDATA #IMPLIED

style-id     CDATA #IMPLIED

filteredFrom (swt|html) >

이스케이프 처리된 HTML 태그를 선택적으로 포함할 수 있는 텍스트의 스니펫입니다. b 및 li 태그가 들어 있을 수 있습니다. 또한 url에서 앵커를 포함할 수 있습니다. 여러 단락이 필요한 경우 텍스트를 각각 p 태그로 시작하고 끝나는 여러 섹션으로 나눌 수 있습니다.



<!ELEMENT img EMPTY>

<!ATTLIST img

id           CDATA #REQUIRED

src          CDATA #REQUIRED

alt          CDATA #IMPLIED

style-id     CDATA #IMPLIED

filteredFrom (swt|html) >

프리젠테이션이 아닌 소개 컨텐츠를 표시하는 이미지로 스타일에 정의된 데코레이션 이미지와는 반대됩니다.



<!ELEMENT html (img | text)>

<!ATTLIST html

id           CDATA #REQUIRED

src          CDATA #REQUIRED

type         (inline|embed)

style-id     CDATA #IMPLIED

filteredFrom (swt|html)

encoding     CDATA #IMPLIED>

전체 문서를 임베드하거나 HTML in-place의 스니펫을 인라인하여 페이지에 포함시킬 HTML을 지정합니다. 대체 swt 프리젠테이션 렌더링에서 대체 이미지 또는 텍스트를 정의해야 합니다.
임베드하는 경우 전체 정의된 html 파일을 동적 페이지의 컨텐츠에 임베드할 수 있습니다. html 파일을 참조하는 HTML object 요소가 작성됩니다.
포함시키는 경우 파일에서 동적 html 페이지로 html 스니펫을 직접 포함시킬 수 있습니다.



<!ELEMENT include EMPTY>

<!ATTLIST include

configId    CDATA #IMPLIED

path        CDATA #REQUIRED

merge-style (true | false) >

해당 경로 및 선택적 configId 속성에서 대상으로 설정한 요소를 확장합니다. 경로는 지정된 구성에 있는 요소를 고유하게 설명해야 합니다. 구성 레벨에서 지정된 공유 그룹 또는 페이지의 요소를 지정할 수 있습니다.



<!ELEMENT anchor EMPTY>

<!ATTLIST anchor

id CDATA #REQUIRED>

앵커는 확장성을 선언하는 데 사용되는 요소입니다. 외부 컨트리뷰션을 허용하는 구성의 위치입니다. extensionContent의 경로 속성에서 앵커만 유효한 대상 값입니다.



<!ELEMENT extensionContent (text | group | link | html | include)>

<!ATTLIST extensionContent

style     CDATA #IMPLIED

alt-style CDATA #IMPLIED

path      CDATA #REQUIRED

content   CDATA #IMPLIED>

대상 앵커에 추가할 컨텐츠입니다. 이 확장을 해석할 수 없는 경우(구성을 찾을 수 없거나 대상 앵커 요소를 찾을 수 없는 경우) 확장에 있는 페이지 및/또는 그룹을 무시해야 하므로 하나의 extensionContent만 지정된 configExtension에서 허용됩니다.



<!ELEMENT contentProvider (text?)>

<!ATTLIST contentProvider

id       CDATA #REQUIRED

pluginId CDATA #IMPLIED

class    CDATA #REQUIRED>

소개 페이지가 다양한 소스(예: 웹, Eclipse 등)로부터 데이터를 동적으로 가져와서 이 동적 데이터를 기반으로 런타임시에 컨텐츠를 제공할 수 있도록 허용하는 소개 컨텐츠 제공자를 위한 프록시입니다. 클래스 속성에 지정되는 IIntroContentProvider 클래스를 로드할 수 없는 경우 텍스트 요소의 컨텐츠가 대신 렌더링됩니다. 이것은 html intro 태그의 동적 버전입니다. html 태그는 정적 HTML 컨텐츠를 생성되는 HTML 소개 페이지에 임베드 또는 인라인화를 허용하지만, contentProvider 태그는 런타임 시에 해당 컨텐츠의 동적 작성을 허용합니다. 태그 사이의 다른 차이점은 html 태그는 HTML 프리젠테이션의 경우에만 지원되지만 이 contentProvider 태그는 HTML 및 SWT 프리젠테이션 모두에 지원된다는 점입니다. 3.0.1 이후



다음은 구성 확장점의 샘플 사용법입니다.

<extension id=

"intro"

point=

"org.eclipse.ui.intro.config"

>

<config introId=

"com.org.xyz.intro"

id=

"com.org.xyz.introConfig"

content=

"introContent.xml"

>

<presentation home-page-id=

"root"

title=

"%intro.title"

>

<implementation ws=

"win32"

style=

"css/shared.css"

kind=

"html"

os=

"win32"

>

</implementation>

<implementation style=

"css/shared_swt.properties"

kind=

"swt"

>

</implementation>

</presentation>

</config>

</extension>

자세한 사항은 org.eclipse.ui.intro.config API 패키지에 대한 스펙을 참조하십시오.

org.eclipse.platform 플러그인이 제공한 소개가 Eclipse의 유일한 구현입니다.