www.julialang.org

Readme

Ini adalah repositori GitHub untuk situs web utama bahasa pemrograman Julia, julialang.org. Repositori untuk kode sumber bahasa itu sendiri dapat ditemukan di github.com/julialang/julia.

Situs web Julia dihasilkan menggunakan halaman GitHub dan Franklin.jl, paket asli Julia untuk membangun situs web statis.

Membuat perubahan sederhana

Untuk menyarankan perubahan ke situs web, Anda dapat dengan mudah menavigasi ke halaman dengan konten yang menurut Anda harus diubah, dan mengeditnya. Anda akan diminta untuk membayar repo (jika Anda belum melakukannya) dan kemudian membuka permintaan tarik. Setelah permintaan tarik Anda digabungkan, Anda akan melihat perubahan Anda muncul di situs web dalam beberapa menit atau kurang.

Bangun pratinjau untuk setiap permintaan tarik akan ditautkan di bagian komentar PR setelah situs telah berhasil dibangun.

Catatan : Harap hanya menggunakan blok kode berpagar (blok kode yaitu dibatasi oleh backticks) dan bukan blok kode indentasi.

Membuat perubahan yang lebih kompleks

Untuk menyarankan perubahan ke situs web yang lebih signifikan, disarankan agar Anda membuat perubahan dan mengujinya secara lokal di perangkat Anda. Anda dapat melakukan ini hanya dengan membayar repo dasar, mengkloningnya secara lokal ke perangkat Anda, membuat perubahan yang Anda inginkan, dan kemudian mengikuti instruksi "menginstal lokal" di bawah ini.

Setelah Anda memvalidasi bahwa semuanya terlihat bagus, Anda dapat membuka permintaan tarik dan memeriksa pratinjau penyebaran dari Netlify sebagai pemeriksaan kewarasan akhir.

Bangun pratinjau untuk setiap permintaan tarik tersedia di: https://julialang.netlify.app (Perhatikan bahwa mengingat desain tindakan github, pratinjau build hanya tersedia bagi mereka yang memiliki akses ke repo).

Membuat modifikasi dan melihat perubahan secara lokal

Kloning repositori dan cd untuk itu. Mulai Julia Versi 1.10 dengan julia --project dan Lakukan

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)

Arahkan ke localhost:8000 di browser dan Anda akan melihat pratinjau modifikasi apa pun yang Anda buat secara lokal.

Memodifikasi CSS : Ubah file yang relevan di _css/ .

Memodifikasi struktur HTML : Jika Anda ingin memodifikasi navbar, atau footer, buka _layout/ dan memodifikasi fragmen template yang relevan.

Memodifikasi halaman arahan : karena halaman arahan memiliki desainnya sendiri, ditulis dalam html dengan beberapa penyisipan fragmen yang dapat digunakan kembali jika perlu, cukup ubah index.html

Menambahkan posting blog

Ikuti cetak biru dari banyak posting blog lainnya dalam hal struktur folder dan struktur file. Satu hal penting yang perlu diingat adalah bahwa RSS sedikit pilih -pilih dalam hal apa yang dapat diterima jadi berhati -hatilah untuk apa yang masuk

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

Secara khusus:

• Hindari penggunaan & , misalnya Ubah ML&PL ke ML-PL ,
• Hanya gunakan teks biasa di rss , tidak ada tautan, tidak ada markup, tidak ada entitas HTML.

Jika ragu, setelah menjalankan server Franklin, salin konten __site/feed.xml ke validator umpan W3, itu harus menunjukkan "umpan RSS yang valid".

Metadata

Untuk menambahkan <meta aaa="bbb" content="ccc"> tag di posting blog Anda, tambahkan

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

(Tentu saja Anda dapat menentukan beberapa tag). Lihat misalnya posting blog Keno.

Mencari tautan rusak

Seringkali, seseorang harus melakukan pemeriksaan mendalam bahwa tidak ada tautan yang rusak. Sementara Franklin memberikan cara cepat untuk melakukan ini, itu ide yang baik untuk melakukan ini secara mendalam dari waktu ke waktu. Paket yang rusak-link-checker adalah cara yang cukup rapi untuk melakukan ini. Setelah menginstalnya dengan npm , lakukan saja

 blc https://julialang.org -ro

(Butuh beberapa saat, dan mungkin mengharuskan Anda melakukannya dalam beberapa langkah).

Tambahkan bahasa untuk penyorotan sintaksis

Franklin menggunakan sorotan.js untuk penyorotan sintaks. Untuk menambahkan bahasa baru ke perpustakaan yang digunakan oleh halaman web ini, kompilasi kembali perpustakaan dan tambahkan bahasa baru ke daftar. Dari akar sorotan.js repo:

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

Salin perpustakaan dari build/highlight.min.js ke _libs/highlight/highlight.min.js di repositori ini.

Bangun pratinjau di netlify

Saat ini, pratinjau build dijalankan melalui akun Netlify Logan Kilpatrick. Jika akun berjalan offline dan pratinjau tidak lagi tersedia, semua yang perlu Anda lakukan untuk mengembalikannya adalah mendaftar untuk netlify, impor git repositori (repo ini), pilih cabang "GH-preview", dan kemudian buat sub-domain khusus "julialang.netlify.com". Anda kemudian harus dapat membangun pratinjau yang sesuai.

FAQ

Daftar ketat

Ini sebagian besar item warisan. Jika daftar terlihat salah di halaman, silakan buka masalah. Anda tidak perlu menggunakan @@tight-list ... @@ lagi.

Jika Anda ingin daftar bersarang, pastikan lekukan untuk daftar bersarang dibuat dengan spasi dan bukan dengan tab.