Personalizar barra de herramientas id172FB00L0V6
De forma predeterminada, el editor web incluye las funciones editoriales más comunes que requiere cualquier editor DITA. Las funciones como la inserción de elementos de tipo lista (numerada o con viñetas), referencia cruzada, referencia de contenido, tabla, párrafo y formato de caracteres están disponibles en el editor. Además de estos elementos básicos, puede personalizar el Editor Web para insertar elementos que se utilizan en el entorno de creación.
Existen dos formas de personalizar la barra de herramientas del Editor Web:
-
Añadir una nueva funcionalidad a la barra de herramientas
-
Elimine cualquier funcionalidad existente de la barra de herramientas
Añadir una función en la barra de herramientas
Agregar una funcionalidad al Editor web implica dos tareas principales: agregar un icono para la característica en el archivo ui_config.json y agregar la funcionalidad en segundo plano en JavaScript.
Siga estos pasos para agregar una función a la barra de herramientas del Editor Web:
-
Para descargar el archivo de configuración de la interfaz de usuario, inicie sesión en Adobe Experience Manager como administrador.
-
Haga clic en el vínculo Adobe Experience Manager en la parte superior y elija Herramientas.
-
Seleccione Guías de la lista de herramientas y haga clic en Perfiles de carpeta.
-
Haga clic en el mosaico Perfil global.
-
Seleccione la ficha Configuración del editor XML y haga clic en el icono Editar de la parte superior
-
Haga clic en el icono Descargar para descargar el archivo ui_config.json en su sistema local. A continuación, puede realizar cambios en el archivo y luego cargarlo.
-
En el archivo
ui_config.json
, agregue la definición de la nueva característica en la sección de barras de herramientas. Guarde el archivo y cárguelo.Normalmente, puede crear un nuevo grupo de botones de barra de herramientas y agregarle uno o más botones de barra de herramientas. O bien, puede agregar un nuevo botón de barra de herramientas dentro de un grupo existente. Se requieren los siguientes detalles para crear un nuevo grupo de barras de herramientas:
tipo: Especifique
blockGroup
como el valortype
. Este valor indica que está creando un grupo de bloques que contendría uno o más grupos de barras de herramientas.extraclase: Nombre de la clase o clases separadas con espacio.
elementos: Especifique la definición de todos los grupos en la barra de herramientas. Cada grupo puede contener uno o varios iconos de la barra de herramientas. Para definir iconos dentro de un grupo de barras de herramientas, debe definir de nuevo el atributo
type
dentro deitems
y establecer su valor enbuttonGroup
. Especifique uno o varios nombres de clase en la propiedadextraclass
. Especifique el nombre de la característica en la propiedadlabel
. El siguiente fragmento del archivoui_config.json
muestra la definición del bloque de barra de herramientas principal, seguida de la definiciónbuttonGroup
:code language-none " "barra de herramientas": { "type": "blockGroup", "extraclass": "operaciones de barra de herramientas", "elementos": [ { "type": "buttonGroup", "extraclass": "left-controls", "label": "Controles izquierdos", "elementos": [ "
En la colección
items
, debe especificar la definición de uno o más iconos de la barra de herramientas.Debe definir las siguientes propiedades para añadir un icono de la barra de herramientas:
tipo: Especifique
button
como el valortype
. Este valor indica que está agregando un botón de barra de herramientas.icono: Especifique el nombre del icono de Coral que desee utilizar en la barra de herramientas.
variante: Especifique
quiet
como el valorvariant
.título: Especifique la información del objeto para el icono.
clic: Especifique el nombre del comando definido para la función en el archivo JavaScript. Si el comando requiere parámetros de entrada, especifique el nombre del comando como:
code language-none "Javascript "al hacer clic": {"name": "AUTHOR_INSERT_ELEMENT", "args": "simpletable"} "
mostrar u ocultar: Si está definiendo la propiedad
show
, especifique los modos en que se mostrará el icono. Los valores posibles son -@isAuthorMode
,@isSourceMode
,@isPreviewMode
,true
(mostrar en todos los modos) ofalse
(ocultar en todos los modos).En lugar de
show
, también puede definir la propiedadhide
. Los valores posibles son los mismos que en la propiedadshow
con la única diferencia de que el icono no se muestra en el modo especificado.El siguiente ejemplo muestra el número de versión de AEM Guides cuando el usuario hace clic en el icono Mostrar versión de la barra de herramientas.
Agregue el siguiente código a un archivo JavaScript:
code language-javascript $(document).ready(setTimeout(function() { fmxml.commandHandler.subscribe({ key: 'user.alert', next: function() { alert("AEM Guides version x.x") } }) }, 1000))
Agregue la característica en el archivo ui_config.json como:
code language-javascript "type": "button", "icon": "alert","variant": "quiet","title": "About AEM Guides","show": "true","on-click": "user.alert"
-
Cree una carpeta clientlib y agregue su JavaScript a esta carpeta.
-
Actualice la propiedad categories de la carpeta clientlib asignándole el valor de apps.fmdita.xml_editor.page_overrides.
-
Guarde el archivo ui_config.json y vuelva a cargar el Editor web.
Eliminación de una función de la barra de herramientas
A veces es posible que no desee proporcionar todas las características disponibles actualmente en el Editor Web, en ese caso puede quitar la característica no deseada de la barra de herramientas del Editor Web.
Realice los siguientes pasos para eliminar cualquier función no deseada de la barra de herramientas:
-
Para descargar el archivo de configuración de la interfaz de usuario, inicie sesión en Adobe Experience Manager como administrador.
-
Haga clic en el vínculo Adobe Experience Manager en la parte superior y elija Herramientas.
-
Seleccione Guías de la lista de herramientas y haga clic en Perfiles de carpeta.
-
Haga clic en el mosaico Perfil global.
-
Seleccione la ficha Configuración del editor XML y haga clic en el icono Editar de la parte superior
-
Haga clic en el icono Descargar para descargar el archivo ui_config.json en su sistema local. A continuación, puede realizar cambios en el archivo y luego cargarlo.
El archivo
ui_config.json
tiene tres secciones:-
barras de herramientas: Esta sección contiene la definición de todas las funciones disponibles en la barra de herramientas del editor, como Insertar/Quitar lista numerada, (archivo) Cerrar, Guardar, Comentarios y más.
-
métodos abreviados: Esta sección contiene la definición de los métodos abreviados de teclado asignados a una función concreta del editor.
-
plantillas: Esta sección contiene la estructura predefinida de los elementos DITA que puede utilizar en el documento. De forma predeterminada, la sección de plantillas contiene definiciones de plantilla para un párrafo, tabla simple, tabla y elementos de cuerpo. Puede crear una definición de plantilla para cualquier elemento añadiendo una estructura XML válida para el elemento deseado. Por ejemplo, si desea agregar un elemento
p
con cada nuevo elementoli
en una lista, puede agregar el siguiente código al final de la sección de plantillas para lograrlo:
code language-css "li": "<li><p></p></li>"
-
-
En la sección de barras de herramientas, quite la entrada de la función que no desee exponer a los usuarios.
-
Guarde el archivo ui_config.json y vuelva a cargar el Editor web.
Tema principal: Personalizar editor web