Bevezető rész konfiguráció

org.eclipse.ui.intro.config

3.0

Ez a kiterjesztési pont szolgál bevezetőkonfigurációk bejegyzésére. Ez a konfiguráció megjelenítési megvalósításokat és tartalmat biztosít egy adott bevezető-hozzájáruláshoz. A bevezető a munkaterület első indításakor jelenik meg, valamint a Súgó menü megfelelő pontjának kiválasztására. A bevezető általában arra szolgál, hogy megismertesse a felhasználót valamely, az Eclipse-re épült termékkel.

A bevezetők oldalakba vannak szervezve, amely oldalak általában a bevezető anyag egy adott kategóriájáról szólnak. Például az Újdonságok oldalon a korábbi verziókhoz képest megjelent új szempontok és funkciók tárgyalhatók. Az egyik bevezetőkonfiguráció által meghatározott tartalomra hivatkozhatnak más bedolgozók és bővíthetik az org.eclipse.ui.intro.configExtension kiterjesztési ponton keresztül.

<!ELEMENT extension (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

configurer CDATA #IMPLIED>

A config elem egy testreszabható bevezető rész beállítására használható. A config elemnek meg kell adnia egy azonosítót, egy introId azonosítót, valamint egy tartalomfájlt. A bevezető tartalom fájl egy XML fájl, amely leírja a bevezető oldalait, csoportjait és hivatkozásait.



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

<!ATTLIST presentation

home-page-id    CDATA #REQUIRED

standby-page-id CDATA #IMPLIED>

A bevezető rész megjelenítésének összes lehetséges megvalósítását leíró megjelenítési elem. Egy vagy több megvalósítás lehet benne megadva. Indításkor csak egy megvalósítás kerül kiválasztásra, a megvalósítások os/ws (opeációs rendszer/ablakkezelő) attribútumaitól függően. Ellenkező esetben az első, os/ws attribútum nélküli kerül kiválasztásra.



<!ELEMENT implementation (head?)>

<!ATTLIST implementation

kind  (swt|html)

style CDATA #IMPLIED

os    CDATA #IMPLIED

ws    CDATA #IMPLIED>

A platform "dobozból kivéve" bemutatója két megvalósítással rendelkezik. Az egyik SWT böngésző alapú, a másik UI űrlapokra épül. A testreszabható bevezető rész beállítható úgy, hogy az aktuális operációs rendszer és ablakkezelő alapján kiválassza a két bemutató egyikét. A megvalósítás típus swt vagy html.



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

<!ATTLIST launchBar

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

bg       CDATA #IMPLIED

fg       CDATA #IMPLIED

computed (true | false) "false">

Az indítósáv a 'switchToLaunchBar' paranccsal együtt működik. A végrehajtáskor a parancs bezárja a bevezetőt és létrehoz egy indítósávot a fő ablak egyik szegélyterületén. Az indítósáv legkevesebb egy gombot fog tartalmazni, amely lehetővé teszi a felhasználók számára a legutóbbi bevezetőoldalra visszatérést. Nem kötelező módon tartalmazhat további gombokat is, amelyek a shortcut elemek használatával adhatók meg. Ezen gombok egy adott bevezetőoldalra lépéshez használhatók. A 3.1 változat óta.



<!ELEMENT shortcut EMPTY>

<!ATTLIST shortcut

tooltip CDATA #IMPLIED

icon    CDATA #REQUIRED

url     CDATA #REQUIRED>

minden egyes parancsikon shortcut elemhez egy gomb létrehozásra kerül a bevezető indítósávban. A parancsikonban meghatározott URL akkor kerül futtatásra, amikor a gombot megnyomja a felhasználó. A 3.1 változat óta.



A handle elem elavult.

<!ELEMENT handle EMPTY>

<!ATTLIST handle

close (true | false) "true"

image CDATA #IMPLIED>

elhagyható elem, amely az indítósáv-kezelő előállításának módját irányítja. A 3.1 változat óta.



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

Az introContent elem írja le a bevezető tartalomfájl törzsét. A tartalomfájl oldalakból, több oldalon is használható megosztott csoportokból, valamint más konfigurációkban meghatározott horgonypontokra mutató kiterjesztésekből áll.



<!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)

bgImage      CDATA #IMPLIED>

Ez az elem a megjelenítendő oldalt írja le. A bevezető dinamikus és statikus oldalakat egyaránt megjeleníthet.
A dinamikus oldalak tartalma az oldal alább leírt részelemei alapján kerülnek előállításra. A megjelenítéstől függően a stílus vagy az alternatív stílus kerül alkalmazásra. A stílusok tovább finomíthatók az id vagy class-id elemekre hivatkozással.
A statikus oldalak lehetővé teszik meglévő HTML dokumentumok felhasználását, és hivatkozhatók bármelyik statikus vagy dinamikus oldalról. A statikus oldalak nem page elemekben vannak megadva, hanem egyszerű html fájlok, amelyekre más oldalak hivatkozhatnak.
A kezdőlap, amelynek azonosítója a bevezető konfigurációs kiterjesztési pont presentation elemében van megadva, rendelkezhet olyan url címmel, amely jelzi, hogy ez egy statikus oldal. Ha nincs megadva URL cím, akkor a rendszer feltételezi, hogy a kezdőlap dinamikus. A page elemmel leírt minden egyéb oldal dinamikus.
Ne feledje továbbá, hogy ha az SWT bemutatót használja és egy statikus oldal kerül megjelenítésre, akkor elindul egy külső böngésző és az aktuális oldal továbbra is látható marad.
A dinamikus oldalban használt részelemek a következők: a group részelem használható a csoportokkal kapcsolatos tartalom leírására, illetve a csoportosított tartalmon stílus alkalmazására. A link részelem egy hivatkozást határoz meg, amely használható egy statikus vagy dinamikus oldalra hivatkozásra, valamint futtathat egy bevezető tevékenységet/parancsot. Az oldalon belüli hivatkozásokkal szemben a link általában oldalszinten kerül megadásra a főoldalak közötti navigáláshoz. A text részelem szöveges tartalmat határoz meg az oldal szintjén. A head részelem csak a webalapú megjelenítés esetén használható, és lehetővé teszi a HTML head szakasz további HTML-kóddal bővítését. Ez JavaScript-kód és további stíluslapok hozzáadásánál hasznos. Az img részelem képtartalmat ad meg az oldalszinthez. Az include részelem lehetővé teszi az oldaltól különböző elemek újrafelhasználását. A html részelem csak a webalapú megjelenítés esetén használható és lehetővé teszi HTML-kód beillesztését vagy beágyazását az oldal tartalmába. A beágyazás egy teljes HTML-fájl beágyazását jelenti egy HTML-objektumba (object) a HTML-fájlra hivatkozással. A beillesztés egy HTML-kódrészlet beillesztését jelenti, közvetlenül egy HTML-fájlból. A title részelem az oldal címét adja meg. Az anchor részelem egy olyan pontot határoz meg, amelyen keresztül külső bővítések vehetők fel egy <extensionContent> elem segítségével.



<!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)

computed     (true | false) "false"

bgImage      CDATA #IMPLIED>

Csoportosítja a kapcsolódó tartalmat, a hasonló stílust alkalmazó tartalmat vagy az egy oldalon együtt megjelenítendő tartalmat.



<!ELEMENT head EMPTY>

<!ATTLIST head

src      CDATA #REQUIRED

encoding CDATA #IMPLIED>

Közvetlen HTML egy oldal HEAD tartalomterületén belüli felhasználásra. Lehetővé teszi a HTML HEAD szakasz további HTML-kóddal bővítését. Ez hasznos például JavaScript-kód vagy extra stíluslapok hozzáadására. Ha a tartalom a $plugin:plugin_id$ forma helyettesítő elemeit tartalmazza, akkor helyettesítésre kerülnek a plugin_id azonosítóval rendelkező bedolgozóval. Ez a kód csak HTML alapú bevezetőrész-megvalósítás esetén használható. UI űrlapok alapú megvalósítás esetén egyszerűen figyelmen kívül marad. Egy oldalnak egynél több head eleme is lehet. Egy megvalósításnak azonban pontosan egy head elemmel kell rendelkeznie (mivel ez megosztásra kerül az oldalak között).



<!ELEMENT title EMPTY>

<!ATTLIST title

id           CDATA #IMPLIED

style-id     CDATA #IMPLIED

filteredFrom (swt|html) >

Szövegrészlet, amely tartalmazhat escape-szekvenciákkal kódolt HTML címkéket is. Csak Oldalcímként használható, így egy adott oldal legfeljebb egy title elemet tartalmazhat.



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

<!ATTLIST link

id           CDATA #IMPLIED

label        CDATA #IMPLIED

url          CDATA #REQUIRED

style-id     CDATA #IMPLIED

filteredFrom (swt|html) >

Hivatkozhat egy statikus HTML fájlra, egy külső webhelyre, vagy lefuttathat egy Bevezető URL tevékenységet.



<!ELEMENT text EMPTY>

<!ATTLIST text

id           CDATA #IMPLIED

style-id     CDATA #IMPLIED

filteredFrom (swt|html) >

Szövegrészlet, amely tartalmazhat escape-szekvenciákkal kódolt HTML címkéket is. Ez b és li címkéket tartalmazhat. Emellett URL címek horgonyai is lehetnek benne. Ha több bekezdésre van szükség, akkor a szöveg p címkével kezdődő és végződő szakaszokra bontható.



<!ELEMENT img EMPTY>

<!ATTLIST img

id           CDATA #REQUIRED

src          CDATA #REQUIRED

alt          CDATA #IMPLIED

style-id     CDATA #IMPLIED

filteredFrom (swt|html) >

A bevezető tartalmához, és nem megjelenéséhez tartozó kép (szemben a stílusokban meghatározott dekorációs képekkel).



<!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>

Az oldalba helyezendő közvetlen HTML, például teljes dokumentum beágyazása vagy HTML részlet helyben meghatározása. Kötelezően meg kell adni egy képet vagy szöveget, amelyhez az SWT megjelenítés vissza tud térni. Ha a tartalom a $plugin:plugin_id$ forma helyettesítő elemeit tartalmazza, akkor helyettesítésre kerülnek a plugin_id azonosítóval rendelkező bedolgozóval.
A beágyazás lehetővé teszi teljes HTML fájl befoglalását a dinamikus oldal tartalmába. Ilyenkor HTML object elem jön létre, amely a HTML fájlra hivatkozik.
A befoglalás HTML részletek közvetlen beillesztését teszi lehetővé egy fájlból a dinamikus HTML oldalba.



<!ELEMENT include EMPTY>

<!ATTLIST include

configId    CDATA #IMPLIED

path        CDATA #REQUIRED

merge-style (true | false) >

Kibontja a megadott path és elhagyható configId attribútumokkal meghatározott elemet. Az elérési útnak egyedien kell megcímeznie egy elemet a megadott konfigurációban. Konfigurációs szinten megadott osztott csoportra, illetve az oldal bármelyik elemére mutathat.



<!ELEMENT anchor EMPTY>

<!ATTLIST anchor

id CDATA #REQUIRED>

Az anchor a kiterjeszthetőség meghatározásához használt elem. A konfigurációnak olyan helyére utal, amely lehetővé teszi a külső hozzájárulásokat. Az extensionContent elem path attribútumának érvényes célértékei csak horgonyok lehetnek.



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

<!ATTLIST extensionContent

style     CDATA #IMPLIED

alt-style CDATA #IMPLIED

path      CDATA #REQUIRED

content   CDATA #IMPLIED

id        CDATA #IMPLIED

name      CDATA #IMPLIED>

A célhorgonyhoz hozzáadni kívánt tartalom. Minden configExtension csak egyetlen extensionContent elemet tartalmazhat, mivel ha ez a kiterjesztés nem oldható fel (például mert a konfiguráció vagy a cél horgony elem nem található), akkor a kiterjesztés oldalait és/vagy csoportjait figyelmen kívül kell hagyni.



<!ELEMENT contentProvider (text?)>

<!ATTLIST contentProvider

id       CDATA #REQUIRED

pluginId CDATA #IMPLIED

class    CDATA #REQUIRED>

A bevezető-tartalomszolgáltató proxyja, amelynek segítségével a bevezetőoldal adatokat vehet át dinamikusan a különböző forrásokból (például web, eclipse, stb.), és tartalmat biztosíthat a futási környezet alapján ezekkel a dinamikus adatokkal. Ha a class attribútumban megadott IIntroContentProvider osztály nem tölthető be, akkor helyette a szöveges elem tartalma kerül feldolgozásra. Ez a HTML bevezető dinamikus változata. A HTML címke statikus HTML tartalom beágyazását teszi lehetővé az előállított HTML bevezető oldalba, a contentProvider címke pedig a tartalom dinamikus létrehozását teszi lehetővé. A címkék közötti másik különbség, hogy a html címke csak a HTML megjelenítés esetén érvényes, míg a contentProvider HTML és SWT megjelenítésnél egyaránt. A 3.0.1 verzió óta.



<!ELEMENT hr EMPTY>

<!ATTLIST hr

id           CDATA #IMPLIED

style-id     CDATA #IMPLIED

filteredFrom (swt|html) >

egy vízszintes szabály.



Az alábbiakban bemutatjuk a konfigurációs kiterjesztési pont használatát:

< 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>

További részletek az org.eclipse.ui.intro.config API csomag leírásában találhatók.

Az org.eclipse.platform bedolgozó által biztosított bevezető az egyetlen megvalósítás az Eclipse rendszeren belül.