버전 3.1.0
이 문서에서는 소개 컨텐츠 파일 구조를 일련의 DTD 단편으로 설명합니다.
introContent
<!ELEMENT introContent (page+ , group* , extensionContent*)>
introContent 요소에서는 소개 컨텐츠 파일의 본문을 정의합니다. 컨텐츠 파일은 페이지, 여러 페이지에 들어 있을 수 있는 공유 그룹 및 기타 구성에서 정의된 확장점을 앵커하는 확장점으로 구성됩니다.
page
<!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>
이 요소를 사용하여 표시할 페이지를 설명합니다. 소개에서는
동적 및 정적 페이지를 모두 표시할 수 있습니다.
동적 페이지의 컨텐츠는 아래에서 설명되는 페이지의 부속 요소에서 생성됩니다. 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> 요소의 외부 컨트리뷰션을
수행할 수 있는 확장점을 정의합니다.
group
<!ELEMENT group (group* | link* | text* | img* | include* | html* | anchor*)>
<!ATTLIST group
id CDATA #REQUIRED
label CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
그룹 관련 컨텐츠, 유사한 스타일을 적용해야 하는 컨텐츠 또는 다른 페이지에 함께 포함되는 컨텐츠에서 사용됩니다.
link
<!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 (optional) = ("true" | "false") "false" -
매개변수 설명, true 또는 false 선택, "false"가 기본값임
close - 소개 부분 닫기
필수 매개변수 없음
navigate - 지정된 방향으로 소개 페이지를 탐색하고 홈 페이지로 리턴함
direction = ("backward" | "forward" | "home") - 탐색할 방향을 지정함
openBrowser - 외부 브라우저에서 url을 엽니다. 3.1부터 이 조치는 Workbench 브라우저 지원에 따라 다릅니다. 이것은 브라우저에 대해 설정된 모든 사용자 환경 설정이 허용됨을 의미합니다.
url - 외부 웹 사이트 또는 정적 HTML 파일의 유효한 URL
pluginId (선택사항) - 정적 HTML 파일이 지정된 경우에만
필요합니다. 파일이 들어 있는 플러그인의 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.action.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 (optional) = ("true" | "false") "true" - 도움말 자원이 환영 페이지의 일부로서 임베드되어 표시되어야 함을 표시합니다. 기본값은 false입니다. 이 플래그는 SWT 프리젠테이션의 경우에 무시됩니다. 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"로 처리합니다.
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 스니펫을 직접 포함시킬 수 있습니다.
title
<!ELEMENT title EMPTY>
<!ATTLIST title
id CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
이스케이프 처리된 HTML 태그를 선택적으로 포함할 수 있는 텍스트의 스니펫입니다. 페이지 제목으로만 사용되므로 해당 페이지에는 최대 하나의 제목 요소가 들어 있을 수 있습니다.
text
<!ELEMENT text EMPTY>
<!ATTLIST text
id CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
이스케이프 처리된 HTML 태그를 선택적으로 포함할 수 있는 텍스트의 스니펫입니다. b 및 li 태그가 들어 있을 수 있습니다. 또한 url에서 앵커를 포함할 수 있습니다. 여러 단락이 필요한 경우 텍스트를 각각 p 태그로 시작하고 끝나는 여러 섹션으로 나눌 수 있습니다.
include
<!ELEMENT include EMPTY>
<!ATTLIST include
configId CDATA #IMPLIED
path CDATA #REQUIRED
merge-style (true | false) >
해당 경로 및 선택적 configId 속성에서 대상으로 설정한 요소를 확장합니다. 경로는 지정된 구성에 있는 요소를 고유하게 설명해야 합니다. 구성 레벨에서 지정된 공유 그룹 또는 페이지의 요소를 지정할 수 있습니다.
true
인 경우 포함된
요소를 소유한 페이지에 속하는 스타일이 포함하는 페이지의
스타일 목록에 추가됩니다. false
인 경우(기본값)
포함하는 페이지에서 포함된 요소의 특성을 제어해야 합니다.head
<!ELEMENT head EMPTY>
<!ATTLIST head
src CDATA #REQUIRED>
encoding CDATA #IMPLIED
페이지의 HEAD 컨텐츠 페이지에 포함시킬 HTML를 지정합니다. 추가 html을 HTML HEAD 섹션에 추가할 수 있습니다. 이 요소는 java 스크립트 또는 추가 스타일시트를 추가하는 데 유용합니다. 이 마크업은 HTML 기반 소개 부분을 구현할 때만 사용됩니다. UI 양식을 구현하는 경우 무시됩니다. 페이지에 둘 이상의 헤드 요소가 있을 수 있습니다. 구현에서는 모든 페이지가 공유되므로 하나의 head 요소만 포함될 수 있습니다.
img
<!ELEMENT img EMPTY>
<!ATTLIST img
id CDATA #REQUIRED
src CDATA #REQUIRED
alt CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
프리젠테이션이 아닌 소개 컨텐츠를 표시하는 이미지로 스타일에 정의된 데코레이션 이미지와는 반대됩니다.
extensionContent
<!ELEMENT extensionContent (text | group | link | html | include)>
<!ATTLIST extensionContent
style CDATA #IMPLIED
alt-style CDATA #IMPLIED
path CDATA #REQUIRED>
대상 앵커에 추가할 컨텐츠입니다. 이 확장을 해석할 수 없는 경우(구성을 찾을 수 없거나 대상 앵커 요소를 찾을 수 없는 경우) 확장에 있는 페이지 및/또는 그룹을 무시해야 하므로 하나의 extensionContent만 지정된 configExtension에서 허용됩니다.
anchor
<!ELEMENT anchor EMPTY>
<!ATTLIST anchor
id CDATA #REQUIRED>
앵커는 확장성을 선언하는 데 사용되는 요소입니다. 외부 컨트리뷰션을 허용하는 구성에서의 위치입니다. extensionContent의 경로 속성에서 앵커만 유효한 대상 값입니다.
contentProvider
<!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 이후
Copyright (c) 2004 IBM Corporation and others.
All rights reserved. 본 프로그램 및 본 프로그램에 동봉되는 자료는 본 배포물에 동봉되는 Eclipse Public License v1.0의 조항에 따라 사용해야 하며
웹 사이트(http://www.eclipse.org/legal/epl-v10.html)에서도 관련 사항을 참조할 수 있습니다.