kicad website
1.0.0
Esta é a fonte do novo site da KICAD, Anno 2015.
O repositório Kicad-Website é licenciado duplo. You may distribute it and/or modify it under the terms of either the GNU General Public License (http://www.gnu.org/licenses/gpl.html), version 3 or later, or the Creative Commons Attribution License (http://creativecommons.org/licenses/by/3.0/), version 3.0 or later.
Você precisará desses pacotes:
Hugo versão 0.69.0 (você deve usar esta versão!)
Ruby (para usar asidoctor)
Asciidoctor Versão 2.0.10
O uso do asidoctor é um requisito, porque o Asciidoc original entra em problemas analisando os arquivos ADOC com cabeçalhos TOML neles. O Asciidoctor também possui alguns recursos extras para páginas da web.
Execute o comando hugo na raiz do repositório para construir e servir os arquivos para o desenvolvimento:
Hugo Server -w -v
Observe a saída do console, pois ele informará o endereço onde a página estiver acessível em um navegador. O sinalizador -w diz para assistir ao sistema de arquivos para alterações para se reconstruir automaticamente. Além disso, a página no navegador irá automaticamente o AutoReFresh assim que a reconstrução for concluída com êxito.
Leia as diretrizes contribuintes
É incluído um DockerFile que constrói e embalagens o site com uma instância nginx
Para que os ícones apareçam em blocos de advertência, você deve adicionar
:icons:
:iconsdir: /img/icons/Na parte superior do arquivo asiDoc, mas abaixo do cabeçalho do modelo Hugo.
Nomeie todos os arquivos asciidoc reutilizáveis com um sublinhado líder no nome do arquivo e terminando em .adoc. Hugo está configurado para ignorar esses arquivos de propósito.
Para aprimorar um pouco a segurança, implementamos cabeçalhos de política de segurança de conteúdo definidos pelo Nginx. Eles ditam para o navegador quais caminhos de recursos são permitidos para scripts, vídeos, imagens, etc. e enquanto usamos HTTPs, o CSP é apenas mais uma ferramenta para potencialmente parar o lado do navegador e outros ataques.
Isso significa: 1. Adicione quaisquer imagens, JS e CSS diretamente a este repositório. É muito melhor para nós espelhá -los para que eles possam potencialmente cair no futuro. Especialmente imagens de terceiros 2. Faça o melhor esforço para usar os recursos remotos "aprovados" existentes como visibil em /.docker/default.conf 3. Se você notar que um recurso não está carregando o que você está editando, verifique a saída do console do desenvolvedor para o seu respectivo navegador, se for bloqueado devido ao CSP, ele dirá assim.
