Creación de un subtema

Cree un tema personalizado para el sitio del Portal del desarrollador generando y configurando un subtema. Un subtema es un tema que hereda todos los recursos de un tema padre especificado. A continuación, puede alterar temporalmente recursos específicos para configurar las personalizaciones necesarias.

Acerca de esta tarea

La edición directa del tema API Connect no está permitida ni soportada, ya que las versiones editadas de estos archivos se sobrescriben cuando se instala un fixpack o iFix . Por lo tanto, la forma de crear un tema personalizado es crear un subtema personalizado del tema API Connect estándar que el Portal del desarrollador utiliza de forma predeterminada. También puede crear un subtema que se base en una de las siguientes plantillas de color:

Mono empresarial
Azul zafiro
Verde esmeralda
Marrón dorado
Rojo rubí

La selección de una plantilla de color le proporciona un tema base en el que puede basarse más fácilmente para producir el estilo y la marca de sitio necesarios.

Cree un subtema utilizando el generador de temas en la interfaz de usuario del Portal del desarrollador , personalice el aspecto según sea necesario y, a continuación, vuelva a cargar el archivo comprimido en el sitio.

Importante:

• No tiene permiso para incluir ningún código IBM® API Connect dentro de los temas personalizados que cree. Además, la edición directa de cualquier tema de API Connect en el sistema de archivos no está permitida o no está soportada, ya que las versiones editadas de estos archivos se sobrescriben cuando se instala un fixpack o iFix .
• Todo el desarrollo personalizado es su responsabilidad. Aunque el uso de temas personalizados está soportado, IBM API Connect no proporciona soporte en su desarrollo o modificación.

Para ver un ejemplo guiado sobre la creación de un subtema, consulte Tutorial: Creación de un tema personalizado para el Portal para desarrolladores. En este ejemplo, crea un subtema y, a continuación, personaliza el estilo editando el archivo overrides.css .

1. En el panel de control del administrador, haga clic en Apariencia > Generar subtema.
   Se muestra la página Generar subtema .
2. Especifique un Nombre de subtemay seleccione el Tipo de subtema que desea utilizar. El nombre sólo puede contener caracteres en minúsculas a-z y números del 1 al 9.
   • CSS -Hojas de estilo en cascada; el idioma que se utiliza para describir cómo visualizar los elementos HTML en el tema.
   • SCSS : CSS de Sass; un superconjunto de CSS. SCSS contiene todas las características de CSS, pero se amplía para incluir también las características de Sass. Sin embargo, SCSS se debe compilar en CSS antes de que se pueda instalar y utilizar en el Portal del desarrollador.
3. Seleccione la plantilla en la que basar el subtema:
   • Predeterminado-el connect_theme estándar en el que se basa el Portal del desarrollador .
   • Business Mono-un tema de color blanco y negro.
   • Azul zafiro-un tema de color azul.
   • Verde esmeralda-un tema de color verde.
   • Marrón dorado-un tema de color marrón.
   • Ruby Red-un tema de color rojo.
4. Pulse Generar.
   El subtema está disponible para su descarga desde la página Generar subtema .
5. Pulse el nuevo subtema y guárdelo en la ubicación que prefiera.
6. Extraiga los recursos del archivo de subtema y, a continuación, edite los recursos específicos para configurar las personalizaciones que necesite.
   Defina el tema creando metadatos en el archivo your_theme_name.info.yml . A continuación, puede personalizar el aspecto del tema configurando el archivo overrides.css . Para obtener información detallada sobre cómo personalizar temas, consulte Tematización Drupal.
7. Una vez que haya completado las personalizaciones, vuelva a comprimir los recursos de subtema en el archivo .zip .
   Tenga en cuenta que las extensiones de archivo siguientes también están soportadas: tar, tgz, gzy bz2.
8. Instale su nuevo subtema en el Portal para desarrolladores haciendo clic en Apariencia > Instalar nuevo tema.
9. Pulse Elegir archivo, seleccione el subtema y, a continuación, pulse Instalar.
10. Pulse Instalar tema recién añadido, busque el tema nuevo en la lista de Temas desinstaladosy pulse Instalar y establecer como predeterminado para establecer el nuevo subtema personalizado como tema predeterminado para el sitio.
    El nuevo tema se establece ahora como el tema predeterminado y se lista en la sección Temas instalados .