kicad website
1.0.0
Esta es la fuente del nuevo sitio web de Kicad, Anno 2015.
El repositorio Kicad-Website tiene doble licencia. Puede distribuirlo y/o modificarlo bajo los términos de la Licencia Pública General de GNU (http://www.gnu.org/licenses/gpl.html), versión 3 o posterior, o la licencia de atribución Creative Commons (http://createivommons.org/licenses/3.0/), versión 3.0 o posterior.
Necesitará estos paquetes:
Hugo versión 0.69.0 (¡debes usar esta versión!)
Ruby (para usar asciidoctor)
Asciidoctor versión 2.0.10
Usar Asciidoctor es un requisito, porque el asciidoc original se encuentra con problemas para analizar los archivos ADOC con encabezados Toml en ellos. Asciidoctor también tiene algunas características adicionales para páginas web.
Ejecute el comando Hugo en la raíz del repositorio para construir y servir los archivos para el desarrollo:
Hugo Server -W -V
Observe la salida de la consola, ya que le indicará la dirección donde se puede acceder a la página en un navegador. La bandera -W le dice que vea el sistema de archivos para que los cambios se reconstruyan automáticamente. Además, la página en el navegador Autorefresh una vez que la reconstrucción se complete con éxito.
Lea las pautas contribuyentes
Se incluye un Dockerfile que construye y empaqueta el sitio web con una instancia de Nginx
Para que los íconos aparezcan en bloques de admonería, debe agregar
:icons:
:iconsdir: /img/icons/En la parte superior del archivo ASCIIDOC pero debajo del encabezado de plantilla de Hugo.
Nombra cualquier archivo asciidoc reutilizable con un guión bajo en el nombre de archivo y que termine en .Adoc. Hugo está configurado para ignorar dichos archivos a propósito.
Para mejorar un poco la seguridad, implementamos encabezados de control de seguridad de contenido establecidos por Nginx. Estos dictan al navegador qué rutas de recursos están permitidas para scripts, videos, imágenes, etc., y mientras usamos HTTPS, CSP es solo otra herramienta para detener el lado del navegador y otros ataques.
Esto significa: 1. Agregue cualquier imagen, JS y CSS directamente a este repositorio. Es mucho mejor para nosotros reflejarlos para que no caigan potencialmente en el futuro. Especialmente las imágenes de terceros 2. Haga el mejor esfuerzo para usar los recursos remotos "aprobados" existentes como visibiles en /.docker/default.conf 3. Si nota que un recurso no se carga en lo que está editando, verifique la salida de la consola de herramientas del desarrollador para su navegador respectivo, si está bloqueado debido a CSP, lo dirá.
