FAQ for Customizations

This topic contains some frequently asked questions about Web Author customizations.

How can I prevent consecutive spaces from being inserted in documents?

Create a plugin that implements the AuthorDocumentFilter class. It filters consecutive spaces from being inserted in the document. The filter should override all methods from AuthorDocumentFilter that intercept content changes.

Install the custom filter on all documents by implementing a WebappEditingSessionLifecycleListener that can be installed via a WorkspaceAccessPluginExtension (WorkspaceAccess extension in the plugin.xml file):

public class CustomFilterInstaller implements WorkspaceAccessPluginExtension {
  @Override
  public void applicationStarted(StandalonePluginWorkspace pluginWorkspaceAccess) {
    WebappPluginWorkspace pluginWorkspace = (WebappPluginWorkspace)PluginWorkspaceProvider.getPluginWorkspace();
      pluginWorkspace.addEditingSessionLifecycleListener(new WebappEditingSessionLifecycleListener() {
        @Override
        public void editingSessionStarted(String sessionId, AuthorDocumentModel documentModel) {
          documentModel.getAuthorDocumentController().setDocumentFilter(new CustomAuthorDocumentFilter(documentModel));
        }
      });

Note:

When instantiating the AuthorDocumentFilter, the AuthorDocumentModel object is passed because the filter needs it to check for duplicate spaces.

How can I customize the inserted table fragment for a DITA framework extension?

See the dita-extension-replace-insert-table-action sample project that uses a Framework Extension Script (EXF) to extend the built-in DITA framework to replace the default Insert Table action with another action that uses an InsertFragmentOperation to insert a CALS table element that has @frame, @colsep, and @rowsep attributes already set.

How can I target a specific font size in CSS, using a custom framework?

Suppose you want to modify a custom framework so that when a user selects a specific font size (small, medium, large) in Preferences, the font size selected is applied to the document.

To achieve this, it is recommended to use em units (instead of px, for example). This causes the font size to be adjusted according to the option chosen by the user in Preferences.

How can I obtain a URL parameter from a file open in Web Author?

The URL parameters are forwarded to the sync.api.Workspace.LoadingOptions object. As a side-note, plugins can contribute or intercept a sync.api.Workspace.LoadingOptions object by listening on the sync.api.Workspace.EventType.BEFORE_EDITOR_LOADED event. The LoadingOptions objects (client-side) are forwarded to the server where they end up in ro.sync.ecss.extensions.api.access.EditingSessionContext. Thus, you can access the URL parameters from the EditingSessionContext object (server-side), which can be obtained like this:

EditingSessionContext editingSessionContext = 
  authorDocumentModel.getAuthorAccess().getEditorAccess().getEditingContext();

How can I view whitespaces in Author mode?

You can create a custom font and combine it with the default font for any element:

@font-face {
    font-family: Arial_spacedot;
    src: url(Arial_spacedot.ttf);
    unicode-range: U+1780-17FF, U+200B-200C, U+25CC;
  }
  * { font-family: Arial_spacedot,Arial; }

How can I localize custom actions implemented in JavaScript?

To localize action messages, you must use the Translation JavaScript API:

let myMsgs={
	YES_KEY_ : {
		"en_US" : "Yes",
		"de_DE" : "Ja",
		"fr_FR" : "Oui",
		"ja_JP" : "はい",
		"nl_NL" : "Ja",
		"zh_CN" : "是的"
	}
};
sync.Translation.addTranslations(myMsgs);

Use the message key instead of the hard-coded "Yes" string:
```
tr(msgs["YES_KEY_"])
```

Notice:

This only allows adding new messages for the default languages. You cannot add a new language.