Consideraciones clave para albergar un sitio web de Publii

1. No todos los servidores se configurarán para manejar directorios, lo que hace que no puedan mostrar el archivo index.html inmediatamente en carga. Para protegerse de este problema, recomendamos habilitar la opción Always add index.html en la sección URLs de la configuración del sitio, que están disponibles a través del menú principal en la barra izquierda de la interfaz de Publii.
2. El protocolo FTP puede ser fácil de usar y sin duda es compatible con Publii, pero generalmente se recomienda evitar el uso de este protocolo ya que envía datos sin cifrado, abriendo más oportunidades para que los hackers tengan acceso a su servidor. En cambio, al mínimo recomendamos usar el protocolo FTPS, que funciona exactamente igual que FTP regular, pero también cifra los datos de acceso del servidor para una protección adicional. Los usuarios deben ir un paso más y utilizar el protocolo SFTP, que cifra todo el tráfico (conexión, transferencia de archivos) al servidor para la máxima protección.
3. Publii no genera archivos vacías index.html para directorios, ya que esto a menudo llevaría a que varios archivos adicionales se cargan en el servidor. Por lo tanto, recomendamos utilizar un alojamiento (método de despliegue) que incluye una opción para desactivar la lista de directorios o, alternativamente, permite a los usuarios desactivarlo manualmente, por ejemplo, a través de la .htaccess Archivo.

   La siguiente tabla muestra cómo los diferentes métodos de implementación manejan la lista de directorios.

   Método de despliegue	Opción de entrada construida
   FTP	depende de la configuración del servidor (puede desactivarse a través del archivo .htaccess)
   SFTP	depende de la configuración del servidor (puede desactivarse a través del archivo .htaccess)
   GitHub	desactivados por defecto - devuelve 404 página de error
   GitLab	desactivados por defecto - devuelve 404 página de error
   Netlify	desactivados por defecto - devuelve 404 página de error
   Google Cloud	- -
   Amazon S3	necesaria para crear una política de cubos
   Despliegue manual	depende de la configuración disponible del servidor de destino

4. Para mejorar la experiencia del sitio para sus visitantes y garantizar su seguridad, recomendamos encarecidamente el uso de SSL (Secure Sockets Layer) en su sitio web, que cifrará el tráfico entre el navegador web del visitante y el servidor de su sitio. Esto también tendrá un beneficio secundario para el tráfico de su sitio, ya que algunos navegadores bloquean páginas sin un certificado SSL y advierte a los visitantes que su sitio puede ser peligroso, independientemente del contenido real del sitio.

Con estos puntos en mente, puede estar seguro de que sus datos y los de sus visitantes serán más seguros que antes.

Protegiendo los archivos.publii.json Archivo

A partir de Publii 0.46, el proceso de sincronización se ha mejorado con un nuevo enfoque que utiliza controles individuales para cada archivo en su sitio, almacenado en el files.publii.jsonArchivo. Este cambio mejora la precisión de la detección de archivos modificados y simplifica el proceso de sincronización.

Anteriormente, se generó un solo checksum para todo el sitio, lo que podría resultar en cargas de archivos innecesarias durante la sincronización si incluso un archivo cambió. El nuevo método garantiza un flujo de trabajo más eficiente mediante:

• Seguimiento de cada archivo por separado: El files.publii.jsonfile ahora contiene una lista completa de todos los archivos del sitio, cada uno emparejado con su comprobación única. Esto permite la identificación precisa de qué archivos se han actualizado.
• Reducción de tiempos de carga: Al comparar las rondas en las versiones local y de servidores de la files.publii.jsonArchivo, Publii sólo suba archivos que realmente han sido modificados, ahorrando tiempo y recursos.
• Aumento de la confiabilidad: El paso de un solo sitio de cheques a controles por archivo reduce los errores durante la sincronización y mejora la consistencia general en las implementaciones.

Por qué esconde o protege este archivo?

El files.publii.jsonEl archivo contiene información sobre todos los archivos cargados en su sitio utilizando Publii. Generalmente, estos archivos ya son de acceso público, ya que forman el contenido visible de su sitio web. Sin embargo, si prefiere no exponer la estructura o los metadatos detallados de los archivos de su sitio por cualquier motivo, puede tomar medidas para restringir el acceso a este archivo.

Puedes lograrlo con:

1. Redirección de acceso
   Establecer una redir tipo de redirier para que cualquier petición a files.publii.jsones redirigido a otra página, como su página de inicio.

   Ejemplo (Apache):

   Redirect 301 /files.publii.json /
   

2. Bloqueo de acceso Directamente
   Evite el acceso al archivo por completo mediante la configuración de las reglas del servidor, por ejemplo con .htaccessdirectivas.

   Ejemplo (Apache):

   <Files "files.publii.json">
       Require all denied
   </Files>

Al tomar estas medidas, usted puede asegurarse de que el files.publii.jsonEl archivo permanece protegido mientras se beneficia aún del sistema de sincronización mejorado de Publii.

Importante: Cuando el nuevo sistema de verificación está habilitado por primera vez, todos los archivos serán recargados durante la sincronización inicial. Esta es una ocurrencia única; las sincronizaciones futuras solo suben archivos cambiados.

¿Dónde encontrar la configuración del tema?

Los ajustes de tema están disponibles en el elemento de menú "Tema" de la barra lateral de Publii. En esta vista, encontrará las áreas "Ajustes básicos" y "Ajustes personalizados".

El área de configuración básica está definida por Publii y no se puede modificar por tema. El área de configuración personalizada es totalmente configurable por el desarrollador del tema. Todas las configuraciones personalizadas se agruparán en pestañas con opciones.

¿Dónde encontrar la configuración de las publicaciones?

Las configuraciones de las publicaciones (si están disponibles en el tema) se ubican como una última pestaña en las configuraciones personalizadas en la vista de configuraciones del tema. En esta pestaña llamada "Opciones de publicaciones", el usuario puede definir valores globales para las configuraciones de las publicaciones a fin de evitar modificaciones innecesarias de cada publicación para lograr una configuración específica.

Por ejemplo, si el usuario desea desactivar la visualización de la fecha de creación para todas las publicaciones, puede hacerlo en la pestaña "Opciones de publicación". Pero si algunas publicaciones necesitan tener una fecha de creación, es posible habilitarla en el editor de publicaciones en la pestaña "Otras opciones" de la barra lateral del editor de publicaciones.

Cada opción en esa pestaña normalmente tiene tres valores:

• Utilizar configuración global
• Desactivado
• Activado

El uso de la configuración global es la configuración predeterminada.

¿Cómo crear configuraciones de tema?

La configuración del tema se puede definir en el archivo config.json en el campo customConfig .

La configuración del tema le permite utilizar los siguientes campos:

• Campo de entrada de texto
• Campo de área de texto
• Campo desplegable
• Campo WYSIWYG
• Campo selector de color
• Campo de carga de imagen
• Campo de carga de imagen pequeño
• Botones de radio
• Campo conmutador
• Campo deslizante de rango
• Campo separador
• Campo desplegable de publicaciones
• Campo desplegable de etiquetas
• Campo desplegable de autores

¿Cómo crear configuraciones de publicaciones?

Las configuraciones de las publicaciones se pueden definir de la misma manera que las configuraciones del tema, pero deben ubicarse en el campo postConfig . 

En este momento la configuración de publicaciones le permite utilizar los siguientes campos:

• Campo desplegable
• Campo de entrada de texto
• Campo de área de texto
• Campo selector de color

Los campos de configuración de publicaciones en este momento no admiten el parámetro de grupo que se utiliza para crear pestañas para las configuraciones personalizadas del tema.

¿Cómo se ve la estructura del campo en el archivo config.json?

Todos los campos utilizan una estructura común de definición de campo:

• nombre : nombre del campo utilizado para recuperar un valor del campo
• Etiqueta : etiqueta utilizada para reconocer fácilmente un campo en la interfaz de usuario de Publii.
• grupo : campo utilizado para agrupar campos (solo para los campos de configuración del tema). Todos los campos con el mismo valor se colocarán en las mismas pestañas; ese valor también es una etiqueta de pestaña.
• Nota : utilice este campo para agregar información adicional para el usuario. Le permite utilizar el código HTML como valor.
• valor : valor predeterminado del campo
• tipo : tipo del campo
• dependencias : matriz de reglas utilizadas para especificar si el campo debe mostrarse o no
• customCssClasses : define uno o más nombres de clases CSS personalizados que se aplicarán al campo
• [other] : otros campos relacionados con el campo: lea la documentación de un campo específico para obtener más detalles al respecto

A continuación se muestra un ejemplo del campo utilizado para los efectos de carga diferida en nuestros temas:

  {
      "name": "lazyLoadEffect",
      "label": "Lazy load effects",
      "group": "Additional",
      "note": "This option works only if the 'Media lazy load' option is enabled in the Website Speed tab under Site Settings",
      "value": "fadein",
      "type": "select",
      "options": [
          {
              "label": "Fade in",
              "value": "fadein"
          },
          {
              "label": "None",
              "value": "none"
          }
      ]
  }

El campo anterior estará disponible bajo el tema:

{{ @config.custom.lazyLoadEffect }}

Ese campo se mostrará en la configuración del tema en la pestaña "Adicional" como un campo desplegable con tres opciones:

• Encadenar
• Desenfocar
• Sin LQIP

El valor predeterminado será "Aparición gradual". Debajo del campo, el usuario verá una nota adicional con un enlace a la documentación externa.

Ese campo se mostrará en la interfaz de usuario solo si la opción lazyLoad se establece como verdadera.

{{ @config.custom.headerColor }}

{{ @config.post.headerColor }}

{{ postViewConfig.headerColor }}

{{#each posts}}
    <h2 style="color: {{ postViewConfig.headercolor }};">
        {{ title }}
    </h2>
{{/each}}

 
{
     "name": "displayAuthor",
     "label": "Display author name",
     "value": 1,
     "type": "select",
     "postTemplates": "alternative",
     "options": [
          {
              "label": "Enabled",
              "value": 1
          },
          {
              "label": "Disabled",
              "value": 0
          }
    ]
}  

...
"postTemplates": "alternative,test,portfolio", 
...

...
"postTemplates": "!alternative,test,portfolio", 
...

<a href="#" data-internal-link="Fonts">Link A</a>
<a href="#" data-internal-link="Fonts#headings">Link B</a>

{
     "anchor": "headings",
     "name": "separator",
     "type": "separator",
     "label": "Headings",
     "group": "Fonts",
     "note": "Please note: not all of the font weights are working with the fonts listed above.",
     "size": "big"
}

{
  "name": "exampleField",
  "label": "Example Field",
  "type": "text",
  "customCssClasses": "unique-class-name"
}

{
  "name": "exampleField",
  "label": "Example Field",
  "type": "text",
  "customCssClasses": "unique1-class-name unique2-class-name unique3-class-name"
}

\Documents\Publii\sites\your-siteName\input\themes\your-theme-name\

- input
  |- themes
     |- simple
        |- theme-options.css
        |- index.hbs
        ...

"supportedFeatures": {
    "customThemeOptionsCss": true
}

Estilos CSS del editor de publicaciones personalizado

Para brindar la mejor experiencia a los usuarios del tema, los desarrolladores del tema pueden querer agregar estilos CSS personalizados al editor de publicaciones. Si desea agregar estilos CSS personalizados, simplemente cree un 

Cambiar la configuración predeterminada del editor de publicaciones

Siempre intentamos crear las mejores soluciones para la mayoría de los usuarios de Publii, pero entendemos que el editor de publicaciones es una herramienta compleja y que las necesidades de los usuarios pueden ser muy diferentes. Por eso, permitimos que los usuarios anulen la configuración predeterminada de TinyMCE mediante un archivo de configuración personalizado o scripts JS personalizados . 

Formatos personalizados

Los desarrolladores de temas pueden agregar formatos personalizados que les permiten crear estructuras HTML personalizadas que se pueden insertar fácilmente en el editor de publicaciones. Estos formatos están disponibles en la lista desplegable "Formatos" de la interfaz de usuario del editor de publicaciones y también en la barra de herramientas en línea del editor de publicaciones en la lista desplegable "Seleccionar estilo".

Para agregar formatos personalizados a su tema, simplemente cree en el archivo config.json del tema un campo llamado "customElements".

Ejemplo de campo customElements que crea cuatro formatos personalizados: "Información", "Resaltado", "Éxito" y "Letra capital": 

"customElements": [
    {
        "label": "Info",
        "cssClasses": "msg msg--info",
        "selector": "p"
    },
    {
        "label": "Highlight",
        "cssClasses": "msg msg--highlight ",
        "selector": "p"
    },
    {
        "label": "Success",
        "cssClasses": "msg msg--success",
        "selector": "p"
    },
    {
        "label": "Drop cap",
        "cssClasses": "dropcap",
        "selector": "p"
    }
] 

Como puede ver, cada elemento de formato personalizado está representado por un objeto que contiene tres campos:

• etiqueta : es un nombre de formato que se muestra en las listas desplegables en el editor de publicaciones,
• cssClasses : es una lista de clases CSS utilizadas en el elemento inyectado; puede aplicarles estilo en el archivo editor.css personalizado descrito anteriormente.
• selector : es un nombre de etiqueta utilizado para envolver el contenido del formato personalizado.

También es posible limitar la visibilidad de los formatos personalizados a editores específicos. 

Publii utiliza el editor TinyMCE en dos lugares: en el editor de publicaciones y en la configuración del tema. Utiliza dos campos adicionales para las definiciones de formatos personalizados:

• postEditor : si es verdadero, permitirá que el formato personalizado se muestre en el editor de publicaciones.
• themeSettings : si es verdadero, permitirá que el formato personalizado se muestre en los editores WYSIWYG de configuración del tema.

Puedes especificar dónde se mostrarán:

"customElements": [
    {
        "label": "Info", 
        "cssClasses": "msg msg--info",
        "selector": "p",
        "postEditor": true, // will display under post editor
        "themeSettings": false // won't display under theme settings
    },
    {
        "label": "Highlight",
        "cssClasses": "msg msg--highlight ",
        "selector": "p",
        "postEditor": false, // won't display under post editor
        "themeSettings": true // will display under theme settings
    },
    {
        "label": "Success",
        "cssClasses": "msg msg--success",
        "selector": "p",
        "postEditor": false // won't display under post editor and theme settings
    },
    {
        "label": "Drop cap",
        "cssClasses": "dropcap",
        "selector": "p",
        "themeSettings": true // will display under post editor and theme settings as postEditor when not exists is treated as true
    }
]

El valor predeterminado para el campo postEditor es true . Para el campo themeSettings , el valor predeterminado es false . Esto significa que los formatos personalizados sin estos valores definidos se mostrarán solo en el editor de publicaciones.

Para crear un elemento parcial personalizado, simplemente cree un archivo *.hbs en el directorio de elementos parciales del tema. El nombre del archivo parcial se utilizará en el código del tema.

Por ejemplo, si creas el archivo partials/cookiebar.hbs  en tu tema, podrás usarlo en otros archivos como:

{{> cookiebar}}

También es posible crear parciales que tengan parámetros: esto es especialmente útil cuando tienes problemas con el contexto.

Analicemos la siguiente situación:

Tenemos el siguiente contexto para una vista:

{
    config: {
        optionValue: true 
    },
    pages: [
       { title: "Lorem" },
       { title: "Ipsum" }
    ]
}

Y cargamos nuestro parcial en el archivo principal de la siguiente manera:

{{#each pages}}
    {{> page}}
{{/each}}

Podemos acceder {{title}}en nuestro parcial, pero {{config}}no está disponible incluso si usamos {{../config}}.

La solución es crear un parámetro para nuestro parcial:

{{#each pages}}
    {{> page config=../config}}
{{/each}}

En el ejemplo anterior podremos acceder {{config}}a nuestro parcial.

{{> footer}}

{{> header}}

{{> menu menus.mainMenu}}

{{#unless level}}
<nav>
{{/unless}}
    <ul{{#if level}} class="submenu submenu-level-{{level}}"{{else}} class="menu menu-level-1"{{/if}}>
        {{#each items}}
            <li{{menuItemClasses}}>
            {{#if link}}
            <a href="{{menuUrl}}"{{#if title}} title="{{title}}"{{/if}}{{#if target}} target="{{target}}"{{/if}}{{#if rel}} rel="{{rel}}"{{/if}}>{{label}}</a>
            {{else}}
            <span{{#if title}} title="{{title}}"{{/if}}>{{label}}</span>
            {{/if}}

            {{#if items}}
                {{> menu}}
            {{/if}}
        </li>
        {{/each}}
    </ul>
{{#unless level}}
</nav>
{{/unless}}