Configurare i plug-in dell’Editor Rich Text configure-the-rich-text-editor-plug-ins
Le funzionalità dell’editor Rich Text sono disponibili tramite una serie di plug-in, ciascuno con la proprietà Features. È possibile configurare la proprietà features per abilitare o disabilitare una o più funzionalità dell’editor Rich Text. Questo articolo descrive come configurare in modo specifico i plug-in dell’editor Rich Text.
Per informazioni dettagliate sulle altre configurazioni dell'editor RTF, vedere Configurare l'editor RTF.
Attivare un plug-in e configurare la proprietà features activateplugin
Per attivare un plug-in, segui la procedura riportata di seguito. Alcuni passaggi sono necessari solo quando configuri un plug-in per la prima volta, in quanto i nodi corrispondenti non esistono.
Per impostazione predefinita, i plug-in format
, link
, list
, justify
e control
e tutte le relative funzionalità sono abilitati nell'editor Rich Text.
rtePlugins
è indicato come <rtePlugins-node>
per evitare duplicazioni in questo articolo.-
Con CRXDE Lite, individua il componente testo per il progetto.
-
Creare il nodo padre di
<rtePlugins-node>
se non esiste, prima di configurare qualsiasi plug-in dell'editor Rich Text:-
A seconda del componente, i nodi principali sono:
config: .../text/cq:editConfig/cq:inplaceEditing/config
- un nodo di configurazione alternativo:
.../text/cq:editConfig/cq:inplaceEditing/inplaceEditingTextConfig
text: .../text/dialog/items/tab1/items/text
-
Sono di tipo: jcr:primaryType
cq:Widget
-
Entrambi hanno le seguenti proprietà:
- Nome
name
- Tipo
String
- Valore
./text
- Nome
-
-
A seconda dell'interfaccia per la quale si sta configurando, creare un nodo
<rtePlugins-node>
, se non esiste:- Nome
rtePlugins
- Tipo
nt:unstructured
- Nome
-
Crea un nodo per ogni plug-in da attivare:
- Tipo
nt:unstructured
- Denomina l'ID del plug-in richiesto
- Tipo
Dopo aver attivato un plug-in, seguire queste linee guida per configurare la proprietà features
.
*
(un asterisco)Comprendere il plug-in Findreplace findreplace
Il plug-in findreplace
non richiede alcuna configurazione. Funziona immediatamente.
Quando si utilizza la funzionalità di sostituzione, la stringa sostitutiva deve essere immessa contemporaneamente alla stringa da trovare. Tuttavia, è ancora possibile fare clic su Trova per cercare la stringa prima di sostituirla. Se la stringa sostitutiva viene immessa dopo aver fatto clic su Trova, la ricerca riprende dall’inizio del testo.
La finestra di dialogo Trova e sostituisci diventa trasparente quando si fa clic su Trova e diventa opaca quando si fa clic su Sostituisci. Questo consente all’autore di rivedere il testo che l’autore sostituisce. Se gli utenti fanno clic su Sostituisci tutto, la finestra di dialogo si chiude e viene visualizzato il numero di sostituzioni effettuate.
Configurare le modalità Incolla paste-modes
Quando si utilizza l’editor Rich Text, gli autori possono incollare il contenuto in una delle tre modalità seguenti:
-
Modalità browser: incolla il testo utilizzando l'implementazione Incolla predefinita del browser. Non è un metodo consigliato in quanto potrebbe introdurre markup indesiderati.
-
Modalità testo normale: incolla il contenuto degli Appunti come testo normale. Elimina tutti gli elementi di stile e formattazione dal contenuto copiato prima di inserirli nel componente Experience Manager.
-
MS® modalità Word: incolla il testo, incluse le tabelle, con la formattazione durante la copia da MS® Word. La copia e l'incollamento di testo da un'altra origine, ad esempio una pagina Web o MS® Excel, non sono supportati e mantengono solo una formattazione parziale.
Configurare le opzioni Incolla disponibili nella barra degli strumenti dell’editor Rich Text configure-paste-options-available-on-the-rte-toolbar
Nella barra degli strumenti dell’editor Rich Text è possibile fornire agli autori alcune o nessuna delle tre icone seguenti:
-
Incolla (Ctrl+V): può essere preconfigurato per corrispondere a una delle tre modalità Incolla precedenti.
-
Incolla come testo: fornisce funzionalità in modalità testo normale.
-
Incolla da Word: fornisce funzionalità in modalità MS® Word.
Per configurare l’editor Rich Text in modo da visualizzare le icone richieste, effettua le seguenti operazioni.
- Passare al componente, ad esempio
/apps/<myProject>/components/text
. - Passare al nodo
rtePlugins/edit
. Se il nodo non esiste, vedere attivare un plug-in. - Creare la proprietà
features
nel nodoedit
e aggiungere una o più funzionalità. Salva tutte le modifiche.
Configurare il comportamento dell'icona e della scelta rapida Incolla (Ctrl+V) configure-the-behavior-of-the-paste-ctrl-v-icon-and-shortcut
Puoi preconfigurare il comportamento dell'icona Incolla (Ctrl+V) seguendo la procedura riportata di seguito. Questa configurazione definisce anche il comportamento della scelta rapida da tastiera Ctrl+V utilizzata dagli autori per incollare il contenuto.
La configurazione consente i tre tipi di casi di utilizzo seguenti:
-
Incolla il testo utilizzando l’implementazione Incolla predefinita del browser. Non è un metodo consigliato in quanto potrebbe introdurre markup indesiderati. Configurato utilizzando
browser
di seguito. -
Incolla il contenuto degli Appunti come testo normale. Elimina tutti gli elementi di stile e formattazione dal contenuto copiato prima di inserirli nel componente AEM. Configurato utilizzando
plaintext
di seguito. -
Incollare il testo, incluse le tabelle, con formattazione durante la copia da MS® Word. La copia e l'incollamento di testo da un'altra origine, ad esempio una pagina Web o MS® Excel, non sono supportati e mantengono solo una formattazione parziale. Configurato utilizzando
wordhtml
di seguito.
-
Nel componente, passa al nodo
<rtePlugins-node>/edit
. Crea i nodi se non esistono. Per ulteriori informazioni, vedere attivare un plug-in. -
Nel nodo
edit
, creare una proprietà utilizzando i dettagli seguenti:- Nome
defaultPasteMode
- Tipo
String
- Valore Una delle modalità di incollamento richieste
browser
,plaintext
owordhtml
.
- Nome
Configurare i formati consentiti quando si incollano i contenuti pasteformats
È possibile configurare ulteriormente la modalità Incolla come Microsoft Word (paste-wordhtml
) in modo da poter definire in modo esplicito gli stili consentiti quando si incolla AEM da un altro programma, ad esempio Microsoft® Word.
Ad esempio, se solo i formati e gli elenchi in grassetto devono essere consentiti quando si incolla in AEM, puoi filtrare gli altri formati. Questa operazione è denominata filtro di incollamento configurabile e può essere eseguita per entrambi:
Per i collegamenti, puoi anche definire i protocolli che vengono accettati automaticamente.
Per configurare i formati consentiti quando si incolla testo in AEM da un altro programma:
-
Nel componente, passa al nodo
<rtePlugins-node>/edit
. Crea i nodi se non esistono. Per ulteriori dettagli, vedere attivare un plug-in. -
Crea un nodo sotto il nodo
edit
in modo da poter mantenere le regole di incollamento HTML:- Nome
htmlPasteRules
- Tipo
nt:unstructured
- Nome
-
Crea un nodo in
htmlPasteRules
, in modo da poter contenere i dettagli dei formati di base consentiti:- Nome
allowBasics
- Tipo
nt:unstructured
- Nome
-
Per controllare i singoli formati accettati, creare una o più delle seguenti proprietà sul nodo
allowBasics
:- Nome
bold
- Nome
italic
- Nome
underline
- Nome
anchor
(sia per i collegamenti che per gli ancoraggi denominati) - Nome
image
Tutte le proprietà sono di tipo Type
Boolean
, quindi nel Value appropriato è possibile selezionare o rimuovere il segno di spunta per abilitare o disabilitare la funzionalità.note note NOTE Se non è definito in modo esplicito, viene utilizzato il valore predefinito true e il formato viene accettato. - Nome
-
È inoltre possibile definire altri formati utilizzando un intervallo di altre proprietà o nodi, applicati anche al nodo
htmlPasteRules
. Salva tutte le modifiche.
È possibile utilizzare le proprietà seguenti per htmlPasteRules
.
allowBlockTags
Definisce l’elenco dei tag di blocco consentiti. Alcuni tag di blocco possibili includono:
- titoli (h1, h2, h3)
- lettere p)
- elenchi (ol, ul)
- tabelle (tabella)
fallbackBlockTag
allowBlockTags
. p
in genere è sufficiente.Definisce il comportamento quando si incollano le tabelle. Questo nodo deve avere la proprietà allow
(tipo booleano) per definire se è consentito incollare tabelle. Se l'opzione Consenti è impostata su false
, è necessario specificare la proprietà ignoreMode
(tipo Stringa) per definire la modalità di gestione del contenuto della tabella incollato. I valori validi per ignoreMode
sono:
remove
: rimuove il contenuto della tabella.paragraph
: trasforma le celle della tabella in paragrafi.
Definisce il comportamento quando si incollano gli elenchi. Deve avere la proprietà allow
(tipo booleano) per definire se è consentito incollare gli elenchi. Se allow
è impostato su false
, è necessario specificare la proprietà ignoreMode
(tipo String) per definire la modalità di gestione del contenuto dell'elenco incollato. I valori validi per ignoreMode
sono:
remove
: rimuove contenuto elenco.paragraph
: trasforma gli elementi dell'elenco in paragrafi.
Di seguito è riportato un esempio di struttura htmlPasteRules
valida.
"htmlPasteRules": {
"allowBasics": {
"italic": true,
"link": true
},
"allowBlockTags": [
"p", "h1", "h2", "h3"
],
"list": {
"allow": false,
"ignoreMode": "paragraph"
},
"table": {
"allow": true,
"ignoreMode": "paragraph"
}
}
Configurare gli stili di testo textstyles
Gli autori possono applicare gli stili per modificare l'aspetto di una parte di testo. Gli stili sono basati su classi CSS predefinite nel foglio di stile CSS. Il contenuto stilizzato è racchiuso tra tag span
che utilizzano l'attributo class
per fare riferimento alla classe CSS. Esempio: <span class=monospaced>Monospaced Text Here</span>
.
Quando il plug-in Stili viene attivato per la prima volta, non sono disponibili stili predefiniti. L'elenco popup è vuoto. Per fornire agli autori stili, effettuare le seguenti operazioni:
- Abilita il selettore a discesa Stile.
- Specificare le posizioni dei fogli di stile.
- Specificare i singoli stili che possono essere selezionati dall'elenco a discesa Stile.
Per le configurazioni successive, per aggiungere altri stili, seguire solo le istruzioni per fare riferimento a un nuovo foglio di stile e specificare gli stili aggiuntivi.
Abilitare l’elenco di selettori a discesa Stile styleselectorlist
Questa operazione viene eseguita abilitando il plug-in di stile.
-
Nel componente, passa al nodo
<rtePlugins-node>/styles
. Crea i nodi se non esistono. Per ulteriori dettagli, vedere attivare un plug-in. -
Creare la proprietà
features
nel nodostyles
:- Nome
features
- Tipo
String
- Valore
*
(asterisco)
- Nome
-
Salva tutte le modifiche.
Specificare la posizione del foglio di stile locationofstylesheet
Specificare quindi le posizioni dei fogli di stile a cui si desidera fare riferimento:
-
Passare al nodo principale del componente di testo, ad esempio
/apps/<myProject>/components/text
. -
Aggiungere la proprietà
externalStyleSheets
al nodo padre di<rtePlugins-node>
:- Nome
externalStyleSheets
- Tipo
String[]
(multistringa; fare clic su Multiplo in CRXDE) - Valori Il percorso e il nome file di ogni foglio di stile che si desidera includere. Utilizza i percorsi dell’archivio.
note note NOTE È possibile aggiungere riferimenti ad altri fogli di stile in qualsiasi momento successivo. - Nome
-
Salva tutte le modifiche.
CQrte
che può essere utilizzato per fornire stili diversi per la visualizzazione e la modifica:#CQ td {
// defines the style for viewing }
#CQrte td {
// defines the style for editing }
Specificare gli stili disponibili nell'elenco a comparsa stylesindropdown
-
Nella definizione del componente, passare al nodo
<rtePlugins-node>/styles
, come creato in Abilitazione del selettore a discesa degli stili. -
Nel nodo
styles
creare un nodo (denominato anchestyles
) che contenga l'elenco reso disponibile:- Nome
styles
- Tipo
cq:WidgetCollection
- Nome
-
Crea un nodo sotto il nodo
styles
in modo da poter rappresentare un singolo stile:- Nome, puoi specificare il nome, ma deve essere adatto allo stile
- Tipo
nt:unstructured
-
Aggiungere la proprietà
cssName
a questo nodo in modo da poter fare riferimento alla classe CSS:- Nome
cssName
- Tipo
String
- Valore Il nome della classe CSS (senza un '.' precedente.; ad esempio,
cssClass
invece di.cssClass
)
- Nome
-
Aggiungere la proprietà
text
allo stesso nodo, che definisce il testo visualizzato nella casella di selezione:- Nome
text
- Tipo
String
- Valore Descrizione dello stile; viene visualizzato nella casella di selezione a discesa Stile.
- Nome
-
Salva le modifiche.
Ripeti i passaggi precedenti per ogni stile richiesto.
Configurare l’editor Rich Text per interruzioni di parola ottimali in giapponese jpwordwrap
Gli autori che utilizzano l’AEM per creare contenuti in lingua giapponese possono applicare uno stile ai caratteri per evitare interruzioni di riga laddove non sia necessaria un’interruzione. Questo consente agli autori di lasciare che le frasi si interrompano nella posizione desiderata. Lo stile di questa funzionalità si basa sulla classe CSS predefinita nel foglio di stile CSS.
Per creare lo stile che gli autori possono applicare al testo giapponese, effettuare le seguenti operazioni:
-
Crea un nodo sotto il nodo degli stili. Vedere specificare un nuovo stile.
- Nome:
jpn-word-wrap
- Tipo:
nt:unstructure
- Nome:
-
Aggiungere la proprietà
cssName
al nodo per fare riferimento alla classe CSS. Questo nome di classe è un nome riservato per la funzione di ritorno a capo automatico giapponese.- Nome:
cssName
- Tipo:
String
- Valore:
jpn-word-wrap
(senza un precedente.
)
- Nome:
-
Aggiungi il testo della proprietà allo stesso nodo. Il valore è il nome dello stile visualizzato dall’autore al momento della selezione dello stile.
- Nome:
text
*Tipo:String
- Valore:
Japanese word-wrap
- Nome:
-
Creare un foglio di stile e specificarne il percorso. Vedere specificare il percorso del foglio di stile. Aggiungere il contenuto seguente al foglio di stile. Modifica il colore di sfondo come desiderato.
code language-css .text span.jpn-word-wrap { display:inline-block; } .is-edited span.jpn-word-wrap { background-color: #ffddff; }
Configurare i formati di paragrafo paraformats
Qualsiasi testo creato nell'editor Rich Text viene inserito all'interno di un tag di blocco. Il valore predefinito è <p>
. Attivando il plug-in paraformat
, è possibile specificare ulteriori tag di blocco che possono essere assegnati ai paragrafi utilizzando un elenco a discesa. I formati di paragrafo determinano il tipo di paragrafo assegnando il tag di blocco corretto. L’autore può selezionarli e assegnarli utilizzando il selettore Formato. Gli esempi di tag di blocco includono, tra gli altri, il paragrafo standard <p> e le intestazioni <h1>, <h2> e così via.
Quando il plug-in Formati di paragrafo viene attivato per la prima volta, non sono disponibili formati di paragrafo predefiniti. L'elenco popup è vuoto. Per fornire agli autori formati di paragrafo, effettuare le seguenti operazioni:
- Abilitare l'elenco dei selettori a discesa Formato.
- Specifica i tag di blocco che possono essere selezionati come formati di paragrafo dal menu a discesa.
Per le configurazioni o riconfigurazioni successive, ad esempio per aggiungere altri formati, segui solo la parte pertinente delle istruzioni.
Abilita il selettore a discesa Formato formatselectorlist
Innanzitutto, abilita il plug-in paraformat:
-
Nel componente, passa al nodo
<rtePlugins-node>/paraformat
. Crea i nodi se non esistono. Per ulteriori dettagli, vedere attivare un plug-in. -
Creare la proprietà
features
nel nodoparaformat
:- Nome
features
- Tipo
String
- Valore
*
(asterisco)
- Nome
- Paragrafo (
<p>
) - Titolo 1 (
<h1>
) - Titolo 2 (
<h2>
) - Titolo 3 (
<h3>
)
<p>
viene rimosso, l'autore di contenuto non può selezionare l'opzione Formati paragrafo anche se sono configurati altri formati.Specificare i formati di paragrafo disponibili paraformatsindropdown
I formati dei paragrafi possono essere resi disponibili per la selezione:
-
Nella definizione del componente, passare al nodo
<rtePlugins-node>/paraformat
, come creato in Abilitazione del selettore a discesa del formato. -
Nel nodo
paraformat
, crea un nodo che contenga l'elenco dei formati:- Nome
formats
- Tipo
cq:WidgetCollection
- Nome
-
Crea un nodo sotto il nodo
formats
, contenente i dettagli per un singolo formato:- Nome, è possibile specificare il nome, ma deve essere appropriato per il formato (ad esempio, miaparagrafo, miaintestazione1).
- Tipo
nt:unstructured
-
A questo nodo, aggiungi la proprietà per definire il tag di blocco utilizzato:
-
Nome
tag
-
Tipo
String
-
Valore Il tag di blocco per il formato, ad esempio: p, h1, h2.
Non è necessario inserire le parentesi angolari di delimitazione.
-
-
Per visualizzare il testo descrittivo nell’elenco a discesa, aggiungi un’altra proprietà allo stesso nodo:
- Nome
description
- Tipo
String
- Valore Il testo descrittivo per questo formato, ad esempio Paragrafo, Intestazione 1, Intestazione 2. Questo testo viene visualizzato nell'elenco di selezione Formato.
- Nome
-
Salva le modifiche.
Ripeti i passaggi per ogni formato richiesto.
<p>
, <h1>
, <h2>
e <h3>
) vengono rimossi. Ricreare il formato <p>
come predefinito.Configurare caratteri speciali spchar
In un'installazione AEM standard, quando il plug-in misctools
è abilitato per i caratteri speciali (specialchars
), è immediatamente disponibile una selezione predefinita, ad esempio i simboli di copyright e di marchio.
È possibile configurare l’editor Rich Text in modo da rendere disponibile una selezione personalizzata di caratteri, definendo caratteri distinti o un’intera sequenza.
Definisci un singolo carattere definesinglechar
-
Nel componente, passa al nodo
<rtePlugins-node>/misctools
. Crea i nodi se non esistono. Per ulteriori dettagli, vedere attivare un plug-in. -
Creare la proprietà
features
nel nodomisctools
:-
Nome
features
-
Tipo
String[]
-
Valore
specialchars
(o
String / *
se si applicano tutte le funzionalità per questo plug-in)
-
-
In
misctools
creare un nodo che contenga le configurazioni dei caratteri speciali:- Nome
specialCharsConfig
- Tipo
nt:unstructured
- Nome
-
In
specialCharsConfig
, creare un altro nodo che contenga l'elenco dei caratteri:- Nome
chars
- Tipo
nt:unstructured
- Nome
-
In
chars
, aggiungere un nodo che contenga la definizione di un singolo carattere:- Nome è possibile specificare il nome, ma deve riflettere il carattere, ad esempio metà.
- Tipo
nt:unstructured
-
A questo nodo, aggiungi la seguente proprietà:
- Nome
entity
- Tipo
String
- Valore la rappresentazione HTML del carattere richiesto, ad esempio
&189;
per la frazione metà.
- Nome
-
Salva le modifiche.
In CRXDE, una volta salvata la proprietà, viene visualizzato il carattere rappresentato. Vedi sotto l'esempio di mezzo. Ripeti i passaggi precedenti per rendere disponibili agli autori altri caratteri speciali.
Definire un intervallo di caratteri definerangechar
-
Utilizzare i passaggi da 1 a 3 di Definizione di un singolo carattere.
-
In
chars
, aggiungere un nodo che contenga la definizione dell'intervallo di caratteri:- Nome è possibile specificare il nome, ma deve riflettere l'intervallo di caratteri, ad esempio le matite.
- Tipo
nt:unstructured
-
Sotto questo nodo (denominato in base all’intervallo di caratteri speciali) aggiungi le due proprietà seguenti:
-
Salva le modifiche.
Ad esempio, definisci un intervallo 9998: 10000 contiene i seguenti caratteri.
Figura: in CRXDE, definire un intervallo di caratteri da rendere disponibili in RTE
Configurare gli stili di tabella tablestyles
Gli stili vengono in genere applicati al testo, ma è possibile applicare un set separato di stili anche a una tabella o ad alcune celle di tabella. Tali stili sono disponibili per gli autori dalla casella del selettore Stile nella finestra di dialogo Proprietà cella o Proprietà tabella. Gli stili sono disponibili quando si modifica una tabella all’interno di un componente Testo (o derivata) e non nel componente Tabella standard.
-
All'interno del componente, passare al nodo
<rtePlugins-node>/table
. Crea i nodi se non esistono. Per ulteriori dettagli, vedere attivare un plug-in. -
Creare la proprietà
features
nel nodotable
:- Nome
features
- Tipo
String
- Valore
*
(asterisco)
note note NOTE Se non si desidera abilitare tutte le funzionalità della tabella, è possibile creare la proprietà features
come:-
Tipo
String[]
-
Valore uno dei seguenti elementi o entrambi, come richiesto:
-
table
per consentire la modifica delle proprietà della tabella, inclusi gli stili. -
cellprops
per consentire la modifica delle proprietà delle celle, inclusi gli stili.
- Nome
-
Definisci la posizione dei fogli di stile CSS in modo da poterli fare riferimento. Vedere Specifica della posizione del foglio di stile, come quando si definiscono stili per il testo. La posizione può essere definita se sono stati definiti altri stili.
-
Nel nodo
table
creare i seguenti nuovi nodi (come richiesto):-
Per definire gli stili per l'intera tabella (disponibile in Proprietà tabella):
- Nome
tableStyles
- Tipo
cq:WidgetCollection
- Nome
-
Per definire gli stili per le singole celle (disponibili in Proprietà cella):
- Nome
cellStyles
- Tipo
cq:WidgetCollection
- Nome
-
-
Crea un nodo (sotto il nodo
tableStyles
ocellStyles
, a seconda dei casi) in modo da poter rappresentare un singolo stile:- Nome è possibile specificare il nome, ma deve riflettere lo stile.
- Tipo
nt:unstructured
-
In questo nodo, crea le proprietà:
-
Per definire lo stile CSS a cui fare riferimento
- Nome
cssName
- Tipo
String
- Valore il nome della classe CSS (senza un
.
precedente, ad esempio,cssClass
invece di.cssClass
)
- Nome
-
Per definire un testo descrittivo da visualizzare nel selettore a discesa
- Nome
text
- Tipo
String
- Valore il testo da visualizzare nell'elenco di selezione
- Nome
-
-
Salva tutte le modifiche.
Ripeti i passaggi precedenti per ogni stile richiesto.
Configurare le intestazioni nascoste nelle tabelle per l’accessibilità hiddenheader
Talvolta è possibile creare tabelle di dati senza testo visivo in un'intestazione di colonna presupponendo che lo scopo dell'intestazione sia implicito dalla relazione visiva della colonna con altre colonne. In questo caso, è necessario fornire testo interno nascosto all’interno della cella nella cella dell’intestazione. In questo modo, gli assistenti vocali e altre tecnologie per l’accessibilità aiuteranno i lettori con varie esigenze a comprendere lo scopo della colonna.
Per migliorare l’accessibilità in tali scenari, l’editor Rich Text supporta le celle di intestazione nascoste. Inoltre, fornisce le impostazioni di configurazione relative alle intestazioni nascoste nelle tabelle. Queste impostazioni consentono di applicare stili CSS alle intestazioni nascoste nelle modalità di modifica e anteprima. Per aiutare gli autori a identificare le intestazioni nascoste nella modalità di modifica, includi i seguenti parametri nel codice:
hiddenHeaderEditingCSS
: specifica il nome della classe CSS applicata alla cella dell'intestazione nascosta quando viene modificato l'editor Rich Text.hiddenHeaderEditingStyle
: specifica una stringa di stile applicata alla cella di intestazione nascosta quando viene modificato l'editor Rich Text.
Se nel codice specifichi sia CSS che la stringa di stile, la classe CSS ha la precedenza sulla stringa di stile e potrebbe sovrascrivere eventuali modifiche di configurazione apportate dalla stringa di stile.
Per consentire agli autori di applicare CSS sulle intestazioni nascoste nella modalità di anteprima, puoi includere i seguenti parametri nel codice:
hiddenHeaderClassName
: specifica il nome della classe CSS applicata alla cella di intestazione nascosta in modalità anteprima.hiddenHeaderStyle
: specifica una stringa di stile applicata alla cella di intestazione nascosta in modalità anteprima.
Se nel codice specifichi sia CSS che la stringa di stile, la classe CSS ha la precedenza sulla stringa di stile e potrebbe sovrascrivere eventuali modifiche di configurazione apportate dalla stringa di stile.
Aggiungere dizionari per il controllo ortografico adddict
Quando il plug-in spellcheck è attivato, l'editor Rich Text utilizza dizionari per ogni lingua appropriata. Questi vengono quindi selezionati in base alla lingua del sito web utilizzando la proprietà language della sottostruttura o estraendo la lingua dall’URL. Ad esempio, il ramo /en/
è selezionato come inglese, il ramo /de/
come tedesco.
Spell checking failed
se si tenta di verificare una lingua non installata. I dizionari standard si trovano in /libs/cq/spellchecker/dictionaries
, insieme ai file readme appropriati. Non modificare i file.Un'installazione AEM standard include i dizionari per l'inglese americano (en_us
) e inglese britannico (en_gb
). Per aggiungere altri dizionari, eseguire la procedura seguente.
-
Passa alla pagina https://extensions.openoffice.org/.
-
Effettuare una delle seguenti operazioni per trovare un dizionario della lingua scelta:
- Cerca il dizionario della tua lingua. Nella pagina del dizionario individuare il collegamento alla pagina Web dell'autore o della sorgente originale. Individua i file del dizionario per v2.x in tale pagina.
- Cerca i file del dizionario v2.x in https://wiki.openoffice.org/wiki/User:Khirano/Dictionaries.
-
Scarica l’archivio con le definizioni di ortografia. Estrarre il contenuto dell'archivio nel file system.
note caution CAUTION Sono supportati solo i dizionari nel formato MySpell
per OpenOffice.org v2.0.1 o versioni precedenti. Poiché i dizionari sono ora file di archivio, si consiglia di verificare l'archivio dopo averlo scaricato. -
Individuare i file
.aff
e.dic
. Mantieni il nome del file in minuscolo. Ad esempio,de_de.aff
ede_de.dic
. -
Caricare i file
.aff
e.dic
nell'archivio in/apps/cq/spellchecker/dictionaries
.
Configurare la dimensione della cronologia per le azioni Annulla e Ripristina undohistory
L’editor Rich Text consente agli autori di annullare o ripristinare alcune delle ultime modifiche. Per impostazione predefinita, nella cronologia vengono memorizzate 50 modifiche. Puoi configurare questo valore come richiesto.
-
All'interno del componente, passare al nodo
<rtePlugins-node>/undo
. Crea questi nodi se non esistono. Per ulteriori dettagli, vedere attivare un plug-in. -
Nel nodo
undo
, creare la proprietà:- Nome
maxUndoSteps
- Tipo
Long
- Valore il numero di passaggi di annullamento che si desidera salvare nella cronologia. Il valore predefinito è 50. Utilizzare
0
per disabilitare completamente le operazioni Annulla/Ripristina.
- Nome
-
Salva le modifiche.
Configurare le dimensioni della scheda tabsize
Quando il carattere di tabulazione viene premuto all'interno di un testo, viene inserito un numero predefinito di spazi; per impostazione predefinita, si tratta di tre spazi unificatori e di uno spazio.
Per definire le dimensioni della scheda:
-
Nel componente, passa al nodo
<rtePlugins-node>/keys
. Crea i nodi se non esistono. Per ulteriori dettagli, vedere attivare un plug-in. -
Nel nodo
keys
, creare la proprietà:- Nome
tabSize
- Tipo
String
- Valore il numero di spazi da utilizzare per il tabulatore
- Nome
-
Salva le modifiche.
Imposta margine rientro indentmargin
Quando il rientro è abilitato (impostazione predefinita), è possibile definire la dimensione del rientro:
-
All'interno del componente, passare al nodo
<rtePlugins-node>/lists
. Crea questi nodi se non esistono. Per ulteriori dettagli, vedere attivare un plug-in. -
Nel nodo
lists
, creare il parametroindentSize
:- Nome:
indentSize
- Tipo:
Long
- Valore: numero di pixel necessari per il margine di rientro.
- Nome:
Configurare l'altezza dello spazio modificabile editablespace
Puoi definire l’altezza dello spazio modificabile mostrato nella finestra di dialogo del componente:
-
Nel nodo
../items/text
nella definizione della finestra di dialogo per il componente, crea una proprietà:- Nome
height
- Tipo
Long
- Valore l'altezza dell'area di modifica in pixel.
note note NOTE L'altezza della finestra di dialogo non viene modificata. - Nome
-
Salva le modifiche.
Configurare stili e protocolli per i collegamenti linkstyles
Quando aggiungi collegamenti in AEM, puoi definire:
- Stili CSS da utilizzare
- I protocolli sono stati accettati automaticamente
Per configurare il modo in cui i collegamenti vengono aggiunti in AEM da un altro programma, definisci le regole di HTML.
-
Con CRXDE Lite, individua il componente testo per il progetto.
-
Creare un nodo allo stesso livello di
<rtePlugins-node>
, ovvero creare il nodo sotto il nodo padre di<rtePlugins-node>
:- Nome
htmlRules
- Tipo
nt:unstructured
note note NOTE Il nodo ../items/text
ha la proprietà:- Nome
xtype
- Tipo
String
- Valore
richtext
La posizione del nodo ../items/text
può variare a seconda della struttura della finestra di dialogo; due esempi sono/apps/myProject>/components/text/dialog/items/text
e/apps/<myProject>/components/text/dialog/items/panel/items/text
. - Nome
-
In
htmlRules
creare un nodo.- Nome
links
- Tipo
nt:unstructured
- Nome
-
Nel nodo
links
, definisci le proprietà come richiesto:-
Stile CSS per collegamenti interni:
- Nome
cssInternal
- Tipo
String
- Valore il nome della classe CSS (senza un '.' precedente; ad esempio,
cssClass
invece di.cssClass
)
- Nome
-
Stile CSS per collegamenti esterni
- Nome
cssExternal
- Tipo
String
- Valore il nome della classe CSS (senza un '.' precedente; ad esempio,
cssClass
invece di.cssClass
)
- Nome
-
Matrice di protocolli validi. I protocolli supportati sono
http://
,https://
,file://
emailto:
.- Nome
protocols
- Tipo
String[]
- Valore uno o più protocolli
- Nome
-
defaultProtocol (proprietà di tipo String): protocollo da utilizzare se l'utente non ne ha specificato esplicitamente uno.
- Nome
defaultProtocol
- Tipo
String
- Valore uno o più protocolli predefiniti
- Nome
-
Definizione di come gestire l’attributo target di un collegamento. Crea un nodo:
- Nome
targetConfig
- Tipo
nt:unstructured
Nel nodo
targetConfig
, definire le proprietà richieste:-
Specifica la modalità di destinazione:
-
Nome
mode
-
Tipo
String
) -
Valore
-
auto
: indica che è stata scelta una destinazione automatica(specificato dalla proprietà
targetExternal
per i collegamenti esterni otargetInternal
per i collegamenti interni). -
manual
: non applicabile in questo contesto -
blank
: non applicabile in questo contesto
-
-
-
Destinazione dei collegamenti interni:
- Nome
targetInternal
- Tipo
String
- Valore la destinazione per i collegamenti interni (da utilizzare solo quando la modalità è
auto
)
- Nome
-
Destinazione per i collegamenti esterni:
- Nome
targetExternal
- Tipo
String
- Valore la destinazione per i collegamenti esterni (utilizzato solo quando la modalità è
auto
).
- Nome
- Nome
-
-
Salva tutte le modifiche.