Création d'un style de thème

Vous pouvez ajouter votre propre style personnalisé au thème pouvant être sélectionné dans la barre d'outils du site.

Pourquoi et quand exécuter cette tâche

Pour ajouter votre propre style personnalisé au thème, créez un nouveau fichier CSS (Cascading Style Sheet) dans WebDAV. Ce nouveau fichier comprend des définitions de classe CSS qui remplacent celles fournies par la couche CSS par défaut, se trouvant ici : dav:fs-type1/themes/YourThemeName/css/master.css.

Les autres styles prêts à l'emploi peuvent être utilisés comme un guide lors de la création de vos propres fichiers se trouvant dans des dossiers qui sont des homologues de la couche CSS par défaut. Les autres styles se trouvent à l'emplacement suivant : dav:fs-type1/themes/YourThemeName/css/.

Ces étapes permettent d'ajouter un nouveau style à l'onglet Styles de la barre d'outils du site.

Procédure

Sur votre système local, créez un dossier et placez-y un nouveau fichier CSS qui contient les substitutions de classe pour le style alternatif.
Par exemple, ./custom/custom.css.
Connectez-vous au point d'entrée WebDAV fs-type1, http://server:port/wps/mycontenthandler/dav/fs-type1/.
Copiez le nouveau dossier dans cet emplacement dans WebDAV : dav:fs-type1/themes/YourThemeName/css/.
Ouvrez le fichier dans WebDAV à l'emplacement dav:fs-type1/themes/YourThemeName/system/styles.json.
Enregistrez le style en ajoutant une entrée au tableau des éléments au format suivant :
```
      {'label':'display_name_for_the_style',
   'id':'unique_name_for_style',
'url':'path_to_the_stylesheet_relative_to_theme_folder_in_webdav',
'thumbnail':'path_to_the_thumbnail_image',
'help':'short_description_for_the_style'}
```
Voici un exemple de code du tableau des éléments :
```
      {'label':'change_style_white',
   'id':'white.css',
'url':'css/white/white.css',
'thumbnail':ibmCfg.themeConfig.themeRootURI+'/css/white/icon.gif',
'help':'The white style.'}
```
Le nom d'affichage s'affiche dans la barre d'outils du site. Faites en sorte que le chemin soit relatif au dossier dans WebDAV. L'objet JSON du fichier styles.json contient deux attributs qui sont utilisés pour globaliser les chaînes d'affichage du style localizationPackageName et localizationBundleName. Ces objets sont utilisés par le fichier dojo.i18n pour fournir des chaînes localisées en créant des regroupements avec dojo.i18n.getLocalization("localizationPackageName", "localizationBundleName"). Si vous choisissez de globaliser le nom d'affichage de votre nouveau style, ajoutez une clé au regroupement et remplacez la valeur du libellé dans l'objet JSON par le nom de la clé. La barre d'outils du site recherche automatiquement le nom d'affichage dans le regroupement à l'aide de la clé.