kicad website

KICAD網站來源

這是新KICAD網站的來源，Anno 2015。

執照

Kicad-Website存儲庫是雙重許可的。您可以根據GNU通用公共許可證（http://www.gnu.org/licenses/gpl.html），版本3或更高版本或以後的版本，或創意共享歸屬許可（http://creativecommons.org/licenses.org/licensess/licenses/by/by/3.0/3.0或以後）。

先決條件

您將需要以下包裹：

• Hugo版本0.69.0（您必須使用此版本！）

• 紅寶石（使用asciidoctor）

• Asciidoctor版本2.0.10

使用Asciidoctor是必需的，因為原始的Asciidoc在用TOML標頭的ADOC文件解析時遇到了麻煩。 Asciidoctor還具有一些用於網頁的額外功能。

測試

在存儲庫根中執行Hugo命令以構建和為開發文件提供文件：

雨果服務器-W -V

觀察控制台輸出，因為它將告訴您在瀏覽器中可以訪問頁面的地址。 -w標誌告訴它觀察文件系統以自動重建更改。此外，一旦重建成功完成，瀏覽器中的頁面將自動化。

貢獻

請閱讀貢獻指南

Docker

包括一個Dockerfile

提示

告誡圖標

要使圖標出現在告誡塊中，您必須添加

 :icons:
:iconsdir: /img/icons/

在Asciidoc文件的頂部，但在Hugo模板標題下方。

ADOC部分

請命名任何可重複使用的ASCIIDOC文件，並在文件名中使用領先的下劃線並在.ADOC結束。雨果被配置為故意忽略此類文件。

外部資源

為了稍微提高安全性，我們實現了由NGINX設置的內容 - 安全性 - 政策標頭。這些決定了瀏覽器的腳本，視頻，圖像等允許的資源路徑，而我們確實使用HTTPS，而CSP只是另一種可能阻止瀏覽器端和其他攻擊的工具。

這意味著：1。請直接將任何圖像，JS和CSS添加到此存儲庫中。對於我們來說，反映他們要好得多，以免他們將來有可能下降。尤其是第三方圖像2。請盡力將現有的“批准”遠程資源用作Visibile在/.docker/default.conf 3中。如果您發現資源不會在編輯內容上加載，請檢查各自瀏覽器的開發人員工具控制台輸出，如果CSP由於CSP而被封鎖，則會這樣說。