slides2pages

Terapkan Marp ke Halaman GitHub

Presentasi ke Halaman Web: Seketika!

Apa?

Marp memungkinkan Anda membuat slide HTML dari penurunan harga (seperti ini!).

Presentasi ini adalah situs web dan README.md.

Mengapa?

Perlakukan presentasi Anda dengan cara yang sama seperti Anda memperlakukan kode.

• Gunakan git untuk melacak perubahan
• Tarik permintaan untuk berkolaborasi
• Terapkan secara otomatis
• Lihat masalah? Buka terbitan!

Pengaturan

Ingin membuatnya sendiri?

Pertama, buat repo baru dari repo template.

Konfigurasikan Halaman GitHub

Buka repo baru Anda dan atur penerbitan.

Anda biasanya akan menggunakan gh-pages sebagai cabang penerapan.

Tinjau Pembuatan

Klik pada tab Tindakan dan lihat apakah pembangunan berhasil (mungkin memerlukan waktu beberapa saat).

Anda sekarang akan melihat file yang dihasilkan di cabang gh-pages .

Lihat halaman web

Buka halaman web yang Anda terapkan untuk melihat konten.

Di luar kotak Anda akan melihat README.md sebagai /index.html dan /README.pdf . Slide di bawah docs/ juga dikonversi.

Berjalan secara lokal

• Konversi sekali pakai tanpa menginstal marp-cli

$ npx @marp-team/marp-cli@latest README.md -o build/README.pdf

---

• Atau, instal marp-cli di direktori saat ini dengan npm

$ npm install --save-dev @marp-team/marp-cli

• Menjalankan perintah di atas akan membuat file package.json di direktori saat ini, seperti ini

{
	"devDependencies" : {
		"@marp-team/marp-cli" : " ^4.0.0 "
	}
}

---

• Sekarang perintah marp tersedia di direktori saat ini ketika diawali dengan npx

$ npx marp README.md -o build/README.pdf

• Dan inilah hasilnya

[  INFO ] Converting 1 markdown...
[  INFO ] README.md = > build/README.pdf

---

• Jika Anda sudah memiliki file package.json di direktori saat ini, jalankan saja ini untuk menginstal paket yang ditentukan olehnya.

$ npm install

Sebagai langkah alur kerja

Alur kerja menjalankan langkah yang setara:

 - name: Marp Build (README.pdf)
  uses: docker://marpteam/marp-cli:v1.7.0
  with:
    args: README.md -o build/README.pdf
  env:
    MARP_USER: root:root

Perhatikan args cocok dengan slide sebelumnya.

Menyesuaikan bangunan

Apa pun yang ada di folder build/ akan disebarkan ke Halaman GitHub.

Anda dapat menyalin file tambahan atau menjalankan langkah pemrosesan lebih lanjut menggunakan alat lain.

Pelajari lebih lanjut tentang Marp

Ini saat yang tepat untuk mempelajari lebih lanjut tentang Marp. Berikut beberapa sumber:

• Tanda Umum
• Lembar Curang
• Tema
• Tema CSS
• Arahan
• Plugin VS Kode
• Marp Editor Daring

Contoh Situs

Situs terkenal yang menggunakan tindakan ini adalah:

• University of Illinois di Urbana-Champaign's CS 199 Bahkan Lebih Banyak Latihan (kode)
• Menjelajahi model berbasis agen (kode)

Kirim permintaan tarik agar situs Anda ditambahkan.

Publikasikan slide Anda

Saat Anda siap untuk membagikan presentasi Anda, komit atau gabungkan ke main dan konten Anda di Halaman GitHub akan diperbarui secara otomatis.

?

Hore!