practices

網絡和設計團隊實踐

一系列文檔，描述了適用於規範網絡團隊的最佳實踐。

這些也可以在https://canonical-webteam.github.io/practices/上查看。

本地運行站點

該網站是使用Jekyll構建的。

要在本地運行此站點，您需要首先在本地計算機上安裝Ruby。

安裝Ruby後，您可以通過運行安裝Bundler；

 gem install bundler -v 1.17.3

下一步是安裝與Bundler一起運行站點所需的紅寶石寶石；

 bundle install

然後，您可以使用Jekyll為網站服務；

 jekyll serve

...應該在http://127.0.0.1:4000/practices/中在瀏覽器中本地打開網站

貢獻

有關為這些文件做出貢獻的準則，請參見parduting.md。

代碼格式

該代碼庫使用更漂亮的方式來確保格式一致。

要在代碼庫上運行更漂亮（假設您已安裝紗線），請運行：

 yarn prettier-write **/*

故障排除

Jekyll找不到

如果您在嘗試運行安裝的寶石時遇到問題，則說明找不到它，請確保在路徑中包含安裝寶石的目錄。您可以通過在終端中鍵入echo $PATH並在輸出中檢查文件夾來驗證這一點。如果您不確定將寶石安裝到哪個文件夾中，請運行gem env | grep EXECUTABLE DIRECTORY ，並將打印的路徑添加到路徑環境變量中。

執照

該項目的內容是根據Creative Commons歸因 - 共享4.0國際許可證獲得許可的，以及用於格式化和顯示內容的基礎代碼，該代碼已由Canonical Ltd的LGPLV3許可。