seagl.github.io

LautGL

Ini adalah kode sumber untuk situs web yang disajikan di https://seagl.org.

Ia menggunakan Jekyll sebagai generator situs statis dengan Halaman GitHub.

Situs ini secara otomatis dirender setiap kali kode dimasukkan ke repositori bersama di GitHub.

Pada dasarnya, langkah-langkah untuk mengupdate situs (misalnya mempublikasikan postingan blog baru), adalah:

1. Garpu/kloning repositori,
2. Buatlah perubahanmu,
3. Uji perubahan Anda,
4. Kirim permintaan tarik (PR) untuk perubahan,
5. Segera setelah PR digabungkan, perubahan Anda akan dipublikasikan secara langsung

Ada petunjuk untuk setiap langkah di bawah ini. Petunjuknya mengasumsikan seseorang dengan pengalaman git/GitHub/teknis yang lebih sedikit sedang melakukan pekerjaan tersebut. Mereka yang memiliki lebih banyak pengalaman dapat melakukan ekstrapolasi. :-)

Garpu/kloning repositori

Meskipun Anda mungkin dapat bekerja secara langsung pada repositori ini, praktik terbaiknya adalah Anda tidak dapat melakukannya. Sebagai gantinya, Anda dapat melakukan fork atau mengkloning repo dan kemudian membuat perubahan pada salinan itu. Hal ini memungkinkan dilakukannya pengujian sebelum membuat perubahan diterapkan dan mengurangi risiko terjadinya perubahan dengan format atau kata-kata yang buruk.

Untuk membagi repositori:

1. Klik Fork di bagian atas halaman.
2. Pilih akun/organisasi tujuan untuk salinan repo.
3. Tunggu hingga semuanya disalin.

Voila! Hanya itu saja.

Buat perubahan Anda

Jika Anda menambahkan postingan blog baru, harap ikuti aturan nama file berikut:

• Tempatkan semua postingan blog di direktori _posts .
• Mulailah nama file dengan tanggal dalam format YYYY-MM-DD . Ini sangat penting karena mengontrol urutan tampilan postingan blog di situs web.
  • NOTA BENE : Situs web akan menampilkan postingan bertanggal hingga dan termasuk tanggal saat ini. Hal ini memungkinkan Anda untuk menjadwalkan postingan terlebih dahulu, namun ini juga berarti bahwa postingan bertanggal di masa mendatang tidak akan muncul kecuali Anda menggunakan --future saat menguji perubahan Anda. Saat ini, Anda juga perlu memicu pembangunan kembali situs pada atau setelah tanggal yang dijadwalkan agar postingan dapat muncul. Hal ini dapat dilakukan dengan: git commit -m 'rebuild pages' --allow-empty && git push origin main atau dengan membuat perubahan nyata pada situs.
• Ikuti tanggal dengan tanda hubung ( - ) dan kemudian judul postingan yang dibatasi tanda hubung. Judul ini tidak ditampilkan. Itu hanya untuk memberi nama file. Tolong buatlah singkat namun deskriptif.
• Gunakan ekstensi nama file .md untuk menunjukkan bahwa postingan dibuat dalam format penurunan harga. (dan harap hanya membuat postingan menggunakan Markdown)

Berdasarkan aturan ini, postingan blog yang mengumumkan pembukaan CFP 2017 dapat memiliki nama file:

 2017-06-19-CFP-open.md

Silakan tambahkan juga yang berikut ini di bagian atas file Anda:

 ---
layout: post
title: 'Example Title'
status: publish
type: post
published: true
categories: news
tags: '2013'
---

Tetapkan title pada judul postingan blog Anda dan edit tags untuk menyertakan tahun konferensi yang terkait dengan postingan tersebut (kosongkan jika tidak ada). Harap biarkan nilai lainnya apa adanya.

Untuk konten file sebenarnya, Anda dapat membuat perubahan di antarmuka web GitHub atau di mesin lokal Anda.

Di GitHub

1. Arahkan ke direktori tempat file yang ingin Anda edit atau tambahkan (mungkin _posts ).
2. Untuk membuat file baru:
   • Klik Create a new file
   • Beri nama file Anda (sesuai petunjuk di atas jika postingan blog)
3. Buat perubahan Anda
   • Untuk membuat file baru:
     • Klik Create a new file
     • Masukkan nama file (sesuai instruksi di atas jika postingan blog)
   • Untuk mengedit file yang sudah ada:
     • Klik pada file untuk memilihnya
     • Klik ikon pensil kecil
   • Apa pun pilihannya, kini Anda dapat mengedit file di antarmuka web.
4. Komit perubahan Anda menggunakan formulir Commit changes di bawah antarmuka pengeditan.
   • Masukkan judul yang singkat namun deskriptif seperti "Menambahkan pengumuman pembukaan CFP 2017".
   • Masukkan deskripsi rinci. Jika Anda sedang mengerjakan suatu terbitan, harap rujuk nomor terbitannya di sini. Gunakan tanda pagar ( # ) diikuti dengan nomor terbitan ( #74 ). Ini secara otomatis akan ditautkan dalam permintaan tarik, yang sangat berguna.

Di mesin lokal Anda

TBD (asumsinya adalah mereka yang menggunakan git di mesin lokalnya sudah mengetahui hal ini; akan diisi nanti)

1. mengkloning garpu Anda
2. buat perubahan Anda (menambah dan/atau mengedit file)
3. komit perubahan Anda kembali ke fork Anda

Uji perubahan Anda

Silakan uji coba semua perubahan secara lokal sebelum mengirim ke GitHub.

Server pengembangan lokal

Memulai server pengembangan lokal akan membuat salinan situs Anda tersedia di http://localhost:4000. Ada beberapa cara untuk menjalankan server. Silakan pilih!

Opsi 1: Logam polos

Ketergantungan:

• Rubi
• Bundel

Pengaturan satu kali:

bundle install

Mulai server:

bundle exec jekyll serve --watch

Untuk melihat pratinjau postingan bertanggal mendatang dan belum dipublikasikan, tambahkan --future --unpublished ke perintah di atas.

Opsi 2: dalam kontainer

Ketergantungan:

• Docker (atau Podman; ganti docker dengan podman )

Pengaturan satu kali:

docker build --tag ' seagldev ' ' . '

Mulai server:

docker run --rm --interactive --tty --publish ' 4000:4000 ' --volume " $PWD :/usr/src/app " ' seagldev '

Untuk melihat pratinjau postingan bertanggal mendatang dan belum dipublikasikan, tambahkan --future --unpublished di akhir perintah di atas.

Kirim permintaan tarik (PR) untuk perubahan

Anda dapat mengirim PR di antarmuka GitHub atau dari mesin lokal Anda.

Di GitHub

1. Di browser Anda, navigasikan ke cabang repo seagl.github.io Anda.
2. Klik di tab Pull requests .
3. Klik New pull request button .
4. GitHub mengenali bahwa repo Anda adalah sebuah fork dan secara default menjadikan PR sebagai cabang utama dari permintaan fork Anda terhadap cabang utama seagl.github.io. Kemungkinannya sangat bagus, inilah yang Anda inginkan. Jika tidak, Anda akan cukup tahu untuk menyadari hal ini. :-)
5. Klik Create pull request .
6. Masukkan judul yang singkat namun deskriptif seperti "Menambahkan pengumuman pembukaan CFP 2017".
7. Masukkan deskripsi rinci. Jika Anda sedang mengerjakan suatu terbitan, harap rujuk nomor terbitannya di sini. Gunakan tanda pagar ( # ) diikuti dengan nomor terbitan ( #74 ). Ini secara otomatis akan ditautkan dalam permintaan tarik, yang sangat berguna.
8. Pilih [Allow edits from maintainers](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork) sehingga anggota tim lainnya dapat melakukan pengeditan, jika perlu.
9. Klik Create pull request .

Di mesin lokal Anda

TBD (asumsinya adalah mereka yang menggunakan git di mesin lokalnya sudah mengetahui hal ini; akan diisi nanti)

Perubahan Anda akan dipublikasikan secara langsung

Sekarang seseorang (mungkin Anda, jika Anda memiliki tingkat akses ke repo) harus meninjau dan kemudian menggabungkan permintaan tarik Anda.

Setelah permintaan penarikan Anda digabungkan, permintaan tersebut akan ditayangkan di situs web.

CATATAN BENE : Penggabungan itu sendiri tidak akan memicu pembangunan kembali situs. Untuk membangun kembali situs, Anda perlu mendorong komit kosong seperti:

git commit --allow-empty -m " Rebuild the site, please " && git push

Bagaimana cara menambahkan gambar ke postingan

Tambahkan gambar Anda ke direktori img/posts/ , lalu gunakan Markdown berikut:

 ![ Example description ] ( /img/posts/example.jpg )

Kiat:

• Untuk menyelaraskan gambar ke samping, tambahkan kelas align-left atau align-right :

   ![ Example description ] ( /img/posts/example.jpg ) {:.align-left}

• Demi waktu muat halaman, ubah ukuran gambar ke ukuran yang wajar sebelum menggunakannya dalam postingan.

Arsip konferensi sebelumnya

Konferensi sebelumnya diarsipkan secara statis sebagai koleksi Jekyll:

• archive-conferences
• archive-sessions

Untuk membuat arsip pada tahun tertentu, impor dulu data dari jadwal—

bundle exec rake import[2020]

—lalu edit file arsip dengan tangan jika ada koreksi yang diperlukan.