소개는 일반적으로 소개 자료의 특정 카테고리를 반영하는 소개 페이지로 구성되어 있습니다. 예를 들어 새로운 기능 페이지는 이전 버전 다음의 새로운 개념 또는 기능을 소개할 수 있습니다. 한 소개 구성에서 정의한 컨텐츠는 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일 수 있습니다.
org.eclipse.core.runtime.Platform
의 경우
Javadoc 참조). org.eclipse.core.runtime.Platform
의 경우
Javadoc 참조). <!ELEMENT launchBar (handle? , shortcut*)>
<!ATTLIST launchBar
location (left|bottom|right|fastview) "fastview"
bg CDATA #IMPLIED
fg CDATA #IMPLIED>
실행 표시줄은 'switchToLaunchBar' 명령과 함께 작동합니다. 명령은 실행될 때 소개를 닫고 기본 창의 트림 영역 중 하나에 실행 표시줄을 작성합니다. 실행 표시줄에는 사용자가 마지막 소개 페이지로 리턴할 수 있는 최소한 하나의 단추가 들어 있습니다. 선택적으로 shortcut
요소를 사용하여 정의되는 추가 단추를 포함할 수 있습니다. 이들 단추를 사용하여 특정 소개 페이지로 빨리 이동할 수 있습니다. 3.1 이후
left
, bottom
또는 right
중 하나). 선택사항이 fastview
(기본값)로 설정된 경우,
실행 표시줄은 빠른 보기 표시줄이 있는 위치에서 처음에 작성됩니다. <!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 이후
true
입니다.). <!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> 요소의 외부 컨트리뷰션을
수행할 수 있는 확장점을 정의합니다.
true
(기본값)인 경우,
공유 스타일이 이 페이지의 스타일에 추가됩니다. false
인 경우, 소개 구성에 정의된 공유 스타일이 이 페이지의 스타일에 삽입되지 않습니다.<!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 조치를 실행할 수 있습니다.
action name - 조치 설명
action parameter1 - 매개변수 설명
action parameter2 (optional) - 매개변수 설명
action parameter3(선택사항) = ("true"
"false") "false" - 매개변수에 대한 설명, true 또는 false 선택 및 "false"가 기본값임
close - 소개 부분 닫기
필수 매개변수 없음
navigate - 지정된 방향으로 소개 페이지를 탐색하고 홈 페이지로 리턴함
direction = ("backward"
"forward"
"home") - 탐색할 방향을 지정
openBrowser - 외부 브라우저에서 url을 엽니다. 3.1부터 이 조치는 Workbench 브라우저 지원에 따라 다릅니다. 이것은 브라우저에 대해 설정된 모든 사용자 환경 설정이 허용됨을 의미합니다.
url - 외부 웹 사이트 또는 로컬 HTML 파일에 대한 유효한 URL
pluginId (optional) - url이 상대적인 경우 플러그인에 상대적입니다. 여기에 파일을 포함하는 플러그인의 ID를 지정하십시오.
openURL - 환영 페이지에 임베드된 url을 엽니다. SWT 프리젠테이션의 경우 이 url은 외부 브라우저에 표시됩니다(위의 openBrowser 조치와 비슷합니다). 3.1 이후
url - 외부 웹 사이트 또는 로컬 HTML 파일에 대한 올바른 URL
pluginId(선택사항) - url이 상대적인 경우, 이는 파일을 포함하는 플러그인의 ID를 지정합니다.
runAction - 지정된 조치를 실행함
class - org.eclipse.ui.intro.config.IIntroAction
,
org.eclipse.jface.actino.IAction
또는
org.eclipse.ui.IActionDelegate
중 하나를 구현하는
클래스의 완전한 클래스 이름
pluginId - 클래스가 들어 있는 플러그인 ID입니다.
standby(선택사항) = ("true"
"false") "false" - 조치 실행 후 소개를 대기 모드로 설정할지 여부를 표시
추가 매개변수 - 모든 추가 매개변수는 org.eclipse.ui.intro.config.IIntroAction
을
구현하는 조치에 전달됩니다.
setStandbyMode - 소개 부분의 상태 설정
standby = ("true"
"false") - 소개 부분을 일부만 볼 수 있는 대기 모드로 설정하려면 true, 전부 볼 수 있게 하려면 false
showHelp - 도움말 시스템을 엽니다.
필수 매개변수 없음
showHelpTopic - 도움말 주제를 엽니다.
id - 도움말 자원 URL입니다(org.eclipse.ui.help.WorkbenchHelp.displayHelpResource)
에 대해 Javadoc 참조).
embed(선택사항) = ("true"
"false") "true" - 도움말 자원이 시작 페이지의 일부로 표시되어야 함을 표시합니다. 기본값은 false입니다. 이 플래그는 SWT 프리젠테이션의 경우에 무시됩니다. 이것은 openURL() 명령과 동등하지만
도움말 시스템 주제에 대한 것입니다. 임베드된 URL이 현재 페이지의 전체 크기를 채웁니다. 3.1 이후
embedTarget(선택사항) - 도움말 항목의 컨텐츠를 보유할 현재 환영 페이지의 div 경로입니다. 지정된 경우, embed는 기본적으로 true이며 임베드된 URL이 지정된 경로를 갖고 div에 삽입됩니다. 경로는
페이지에 상대적이므로 페이지 ID로 시작해서는 안됩니다. div의 하위가 URL의 컨텐츠로 대체됩니다. 페이지당 하나의 div만을 임베드된 대상으로 사용할 수 있습니다. 이 플래그는 SWT 프리젠테이션의 경우에 무시됩니다. XHTML을 소개 컨텐츠로 사용하는 경우에도 지원되지 않습니다. 3.1 이후
showMessage - 표준 정보 대화 상자를 사용하여 사용자에게 메시지를 표시합니다.
message - 사용자에게 표시할 메시지
showStandby - 소개 부분을 대기 모드로 설정하고 지정된
입력과 함께 standbyContentPart를 표시함
partId - 표시할 standbyContentPart의 ID
input - standbyContentPart에서 설정할 입력
showPage - 지정된 ID로 소개 페이지를 표시함
id - 표시할 소개 페이지의 ID
standby(선택사항) = ("true"
"false") "false" - 페이지를 표시한 후 소개를 대기 모드로 설정할 것인지 여부를 표시함
이 조치로 전달된 매개변수에 특수 문자(즉, URL에 잘못된 문자)가 있는 경우에는 UTF-8 url 인코딩을 사용하여
인코딩해야 합니다. 디코드된 상태로 이 매개변수를 수신하려면 특수 매개변수인 decode = ("true" "false")를 사용하여
소개 프레임워크가 이 매개변수를 처리할 때 이 매개변수에 대한 디코드를 강제 실행할 수 있습니다.
예를 들면, 다음과 같습니다.
http://org.eclipse.ui.intro/showMessage?message=This+is+a+message
소개 URL은 message 매개변수를 "This+is+a+message"로 처리합니다.
반면에
http://org.eclipse.ui.intro/showMessage?message=This+is+a+message&decode=true
message 매개변수를 "This is a message"로 처리합니다.
<!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) >
프리젠테이션이 아닌 소개 컨텐츠를 표시하는 이미지로 스타일에 정의된 데코레이션 이미지와는 반대됩니다.
<!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 속성에서 대상으로 설정한 요소를 확장합니다. 경로는 지정된 구성에 있는 요소를 고유하게 설명해야 합니다. 구성 레벨에서 지정된 공유 그룹 또는 페이지의 요소를 지정할 수 있습니다.
true
인 경우 포함된
요소를 소유한 페이지에 속하는 스타일이 포함하는 페이지의
스타일 목록에 추가됩니다. false
인 경우(기본값)
포함하는 페이지에서 포함된 요소의 특성을 제어해야 합니다.<!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>
Copyright (c) 2004 IBM Corporation and others.
All rights reserved. 본 프로그램 및 본 프로그램에 동봉되는 자료는 본 배포물에 동봉되는 Eclipse Public License v1.0의 조항에 따라 사용해야 하며
웹 사이트(http://www.eclipse.org/legal/epl-v10.html)에서도 관련 사항을 참조할 수 있습니다.