Las hojas de apuntes están organizadas por categorías que generalmente reflejan el dominio de un problema en particular. Por ejemplo, un plug-in orientado a Java puede definir una categoría llamada "Java", que sea apropiada para las hojas de apuntes que ayudarán al usuario en alguna de las herramientas Java. Los plug-ins pueden hacer referencia a las categorías definidas por otro plug-in mediante el atributo category de un elemento cheatsheet. Las hojas de apuntes que no pertenecen a ninguna categoría, así como las hojas de apuntes con vías de acceso a categorías no válidas, acabarán en la categoría "Otras".
Las hojas de apuntes pueden especificar opcionalmente un subelemento description cuyo cuerpo debe contener un texto corto que describa la hoja de apuntes.
<!ELEMENT extension (category | cheatsheet | taskEditor | taskExplorer)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
Un elemento category del punto de extensión cheatsheetContent crea una categoría nueva en el menú de hojas de apuntes. El menú de hojas de apuntes está disponible en el menú de ayuda del entorno de trabajo. Si se especifica una categoría nueva, las hojas de apuntes pueden destinarse a esa categoría y aparecerán bajo ella en el diálogo de selección de hojas de apuntes.
<!ELEMENT cheatsheet (description?)>
<!ATTLIST cheatsheet
id CDATA #REQUIRED
name CDATA #REQUIRED
category CDATA #IMPLIED
contentFile CDATA #IMPLIED
listener CDATA #IMPLIED
composite (true | false) "false">
Un elemento cheatsheet se coloca en el punto de extensión cheatsheetContent si existe una hoja de apuntes que deba añadirse al entorno de trabajo. Un elemento de hoja de apuntes debe especificar un ID, un nombre traducible que debe aparecer en las opciones de selección, un ID de categoría destinado a especificar en qué categoría se incluirá esta hoja de apuntes y un archivo de contenido. El archivo de contenido de hoja de apuntes es un archivo XML que describe los pasos y acciones que contiene la hoja de apuntes.
org.eclipse.ui.cheatsheets.CheatSheetListener
.<!ELEMENT description (#PCDATA)>
breve descripción de la hoja de apuntes
<!ELEMENT taskEditor EMPTY>
<!ATTLIST taskEditor
id CDATA #REQUIRED
class CDATA #REQUIRED
icon CDATA #REQUIRED>
Este punto de extensión es provisional, basado en la clase API TaskEditor. El punto de extensión taskEditor permite incluir UI personalizados en el panel del editor de una hoja de apuntes compuesta. Cualquier tarea de una hoja de apuntes compuesta cuya especie coincida con el ID de esta extensión utilizará la clase definida en este punto de extensión para crear el área del editor.
<!ELEMENT taskExplorer EMPTY>
<!ATTLIST taskExplorer
id CDATA #REQUIRED
class CDATA #IMPLIED
icon CDATA #IMPLIED
name CDATA #REQUIRED>
Este punto de extensión es provisional, basado en la clase API TaskExplorer. Este punto de extensión permite la contribución de un explorador de tareas que se utilizará al abrir una hoja de apuntes compuesta.
<extension point=
"org.eclipse.ui.cheatsheets.cheatSheetContent"
>
<category name=
"Ejemplo de categoría"
id=
"com.example.category"
>
</category>
<cheatsheet name=
"Ejemplo de hoja de apuntes"
category=
"com.example.category"
id=
"com.example.cheatSheet"
contentFile=
"ExampleCheatSheet.xml"
>
<description>
Fragmento de texto descriptivo para la descripción de mi hoja de apuntes.</description>
</cheatsheet>
</extension>
Copyright (c) 2004, 2006 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están
disponibles bajo los términos de la licencia pública común (Eclipse Public
License) v1.0 que acompaña a esta distribución, y está disponible en http://www.eclipse.org/legal/epl-v10.html