Tidak jelas bagi saya apa formatnya, apakah ada persyaratan sistematis / command-line untuk membuatnya, dll.
Pada dasarnya, hanya perlu mengetahui spesifikasi, dan jika ada langkah-langkah teknis untuk menghasilkan file README.
Tidak jelas bagi saya apa formatnya, apakah ada persyaratan sistematis / command-line untuk membuatnya, dll.
Pada dasarnya, hanya perlu mengetahui spesifikasi, dan jika ada langkah-langkah teknis untuk menghasilkan file README.
Jawaban:
Penurunan harga adalah sintaksis sederhana untuk memberikan info semantik dan mewakili format umum dalam teks biasa. Daring Fireball memiliki panduan sintaks yang luar biasa untuk penurunan standar . GitHub kemudian menggunakan varian ini yang mereka sebut GitHub Flavoured Markdown .
Untuk menyiapkan readme Anda cukup buat file teks biasa dan beri nama README (atau README.md / README.markdown) dan komit ke root repo Anda. GitHub kemudian akan mengambil ini sebagai readme proyek.
Wikipedia - Penurunan harga referensi halaman "GitHub Flavoured Markdown - Introduction" ( archv. )
Kutipan dari halaman:
GitHub menggunakan apa yang kami sebut "GitHub Flavoured Markdown" (GFM) untuk pesan, masalah, dan komentar. Ini berbeda dari Markdown standar (SM) dalam beberapa cara yang signifikan dan menambahkan beberapa fungsi tambahan.
Halaman ini juga memberikan deskripsi perbedaan untuk penurunan harga standar.
Ada juga informasi lebih lanjut tentang penurunan harga sebenarnya yang dilakukan oleh GitHub:
Jika Anda tertarik dengan cara kami merender file Penurunan harga, Anda mungkin ingin memeriksa Redcarpet , antarmuka Ruby kami ke perpustakaan Sundown .
(Rupanya, Sundown adalah parser Markdown sebenarnya yang digunakan di balik tirai.)
Untuk menambahkan satu lapisan abstraksi lagi, Sundown adalah garpu dari parser penurunan harga lainnya :-)
Kutipan dari halaman GitHub Sundown :
Sundown adalah parser Markdown berdasarkan kode asli perpustakaan Upskirt oleh Natacha Porté.
Ini sangat aneh, tetapi sepertinya GitHub tidak menggunakan GitHub-Flavoured Markdown (GFM) saat merender file README.
GitHub menggunakan "GitHub Flavoured Markdown," atau GFM, di seluruh situs - dalam masalah, komentar, dan permintaan tarik.
Alih-alih tampaknya menggunakan versi yang disebut redcarpet sebagai bagian dari proyek markup GitHub . Mereka juga mendukung beberapa format markup lainnya, termasuk MediaWiki. Cukup gunakan ekstensi file yang tepat, dan GitHub akan membuat markup.
Jika Anda ingin melihat perbedaan antara dua rasa Markdown yang berbeda, baca deskripsi GFM dan fitur-fitur tambahannya .