www.julialang.org下載www.julialang.org源代碼下載

www.julialang.org

網站數據

1.0.0

下載

讀書我

這是Julia編程語言主要網站Julialang.org的GitHub存儲庫。語言本身的源代碼的存儲庫可以在github.com/julialang/julia上找到。

Julia網站是使用GitHub頁面和Franklin.jl生成的，這是一個用於構建靜態網站的朱莉婭本地包裝。

進行簡單的更改

為了提出更改網站的更改，您可以簡單地使用您認為應該更改內容的內容導航到頁面，然後進行編輯。將提示您訂購存儲庫（如果還沒有），然後打開拉動請求。合併了拉動請求後，您應該在幾分鐘或更短的時間內看到更改顯示在網站上。

成功構建網站後，將在PR的評論部分鏈接到每個拉的請求的構建預覽。

注意：請僅使用圍欄代碼塊（即由Backticks界定的代碼塊），而不使用縮進的代碼塊。

做出更複雜的改變

為了建議更改更重要的網站，建議您進行上述更改並在設備上本地進行測試。您可以通過簡單地將基本存儲庫撥打，將其克隆到設備上，進行所需的更改，然後遵循下面的“本地安裝”指令來做到這一點。

驗證一切看起來不錯後，您可以打開拉動請求，並檢查Netlify的Deploy Proview作為最終的理智檢查。

每個拉請請求的構建預覽可在以下網址提供：https：//julialang.netlify.app（請注意，給定的github操作設計，構建預覽僅適用於那些對repo的寫入訪問權限的人）。

進行修改並在本地看到更改

克隆存儲庫和cd 。使用Julia啟動Julia 1.10版julia --project並做

julia > using Pkg; Pkg . instantiate ()

julia > using Franklin

julia > serve ()
→ Initial full pass ...
→ evaluating code [ ... ] (learning / code - examples . md)
→ Starting the server ...
✓ LiveServer listening on https : // localhost : 8000 / ...
  (use CTRL + C to shut down)

導航到localhost:8000在瀏覽器中，您應該看到您在本地進行的任何修改的預覽。

修改CSS ：在_css/中修改相關文件。

修改HTML結構：如果要修改Navbar或頁腳，請轉到_layout/並修改相關的模板片段。

修改著陸頁：由於著陸頁有自己的設計，它是用HTML編寫的，並在適當的地方插入了一些可重複的片段，只需修改index.html

添加博客文章

根據文件夾結構和文件結構，請遵循許多其他博客文章的藍圖。要記住的重要一件事是，RSS在可以接受的東西方面有點挑剔

@def rss = ...
@def title = ...

尤其：

避免使用& ，例如將ML&PL更改為ML-PL ，
僅在rss中使用純文本，沒有鏈接，沒有標記，沒有HTML實體。

如有疑問，運行富蘭克林的服務器後，將__site/feed.xml的內容複製到W3 feed驗證器中，它應顯示“有效的RSS feed”。

元數據

為了添加<meta aaa="bbb" content="ccc">在您的博客文章中的標籤，請添加

 @def meta = [( " aaa " , " bbb " , " ccc " ),]

（當然，您可以指定多個標籤）。例如，請參見Keno最近的博客文章。

尋找斷斷續續的鏈接

每隔一段時間，一個人都應該進行深入檢查是否沒有損壞的鏈接。儘管富蘭克林提供了一種快速的方法來做到這一點，但最好不時地進行深入執行。斷開鏈路檢查程序包是一種非常整潔的方法。使用npm安裝後，只需做

 blc https://julialang.org -ro

（這需要一段時間，可能需要您以幾個步驟進行操作）。

添加語法突出顯示的語言

富蘭克林使用亮點.js進行語法突出顯示。要向此網頁使用的庫中添加新語言，請重新編譯庫，然後將新語言添加到列表中。從亮點的根源。 JSrepo：

 $ node tools/build.js bash c diff javascript json julia julia-repl plaintext python ruby shell ini yaml

將庫從build/highlight.min.js複製到此存儲庫中的_libs/highlight/highlight.min.js 。

在Netlify上建立預覽

目前，構建預覽通過Logan Kilpatrick的Netlify帳戶進行。如果帳戶離線且預覽不再可用，那麼您要恢復它們所需要做的就是註冊Netlify，導入GIT存儲庫（此倉庫），選擇“ GH-Preview”分支，然後製作自定義的子域“ Julialang.netlify.com”。然後，您應該能夠相應地構建預覽。