Funciones compatibles con el tema

Funciones compatibles con el tema. Desde Publii v.0.37.0 es posible definir qué características son compatibles con tus temas.

Requiere una nueva sección en el theme.config.jsonarchivo - supportedFeatures, a continuación puedes ver todas las opciones posibles:

"supportedFeatures": {
  "authorImages": true,
  "authorPages": true,
  "blockEditor": true,
  "customComments": true,
  "customSearch": true,
  "errorPage": true,
  "embedConsents": true,
  "searchPage": true,
  "tagImages": true,
  "tagPages": true,
  "tagsList": true,
  "customThemeOptionsCss": true,
  "pages": true,
  "postsPage": true
}
Copiar

Estas opciones se utilizan para informar al usuario sobre las funciones que se pueden utilizar (o no) en el tema utilizado. Puede resultar muy útil si necesita crear un tema muy simple que se utilice, por ejemplo, para crear un diseño de una página. En ese caso, puede desactivar la mayoría de estas funciones:

  • authorImages : el tema admite imágenes de portada para los autores.
  • authorPages : el tema tiene soporte para el archivo author.hbs
  • blockEditor : el tema tiene soporte para los bloques utilizados en el editor de bloques
  • customComments : el tema tiene soporte para{{{@customCommentsCode}}}
  • customSearch : el tema tiene soporte para {{{@customSearchInput}}}o/y{{{@customSearchContent}}}
  • errorPage - el tema tiene soporte para la página de error
  • searchPage : el tema tiene soporte para la página de búsqueda
  • embedConsents : el tema admite el manejo del consentimiento del usuario para iframes de terceros (el tema debe manejar el estilo CSS de los elementos nuevos)
  • tagImages : el tema tiene soporte para las imágenes destacadas de las etiquetas
  • tagPages : el tema tiene soporte para el archivo tag.hbs
  • tagsList : el tema tiene soporte para el archivo tags.hbs
  • customThemeOptionsCss : esta opción le permite agregar un archivo theme-options.css con opciones CSS personalizadas adicionales que afectan la interfaz de configuración del tema en Publii, no la apariencia del tema en sí. Esto les brinda a los desarrolladores de temas una manera de ofrecerles a los usuarios más formas de personalizar la apariencia de la interfaz de configuración del tema en Publii, lo que hace que sea más fácil y agradable configurar las opciones del tema.
  • páginas - el tema tiene soporte para el archivo page.hbs

No confunda estas opciones con las configuraciones del renderizador en el tema. Las opciones del renderizador se pueden usar para deshabilitar algunas funciones del tema, pero las funciones admitidas sugieren qué se puede usar. Por ejemplo, si el tema tiene compatibilidad con tagsList , puede deshabilitar la generación de esta página en las configuraciones del renderizador en el theme.config.json.

La misma situación se aplica, por ejemplo, para authorPages y tagPages : si deshabilita createTagPages o createAuthorPages en la configuración del renderizador, estas páginas no se crearán.

Actualizado el:
arriba