Parma

Parma

Tampilkan Markdown Menggunakan Komponen SwiftUi Murni. Mengambil keuntungan dari ViewBuilder untuk membuat penampilan khusus untuk Text dan View .

Contoh

import Parma

struct ContentView : View {
    var markdown = " I'm **Strong**. "
    
    var body : some View {
        Parma ( markdown )
    }
}

Untuk contoh lebih lanjut, silakan merujuk ke aplikasi demo.

Dukungan Markdown

Sudah didukung

• Level Heading 1-6
• Ayat
• Daftar peluru multi-level
• Daftar yang dipesan multi-level
  • Pembatas periode
  • Pembatas tanda kurung
• Gambar (membutuhkan konfigurasi tambahan)
• Teks inline
  • Kuat
  • Tekanan
  • Kode

Mungkin dukungan di versi mendatang

• Pembagi
• Kutipan blok
• Blok kode

Tidak didukung

• Hyperlink inline

Instalasi

Persyaratan

• Xcode 11.0 atau lebih baru
• Swift 5 atau lebih
• iOS 13.0 / macOS 10.15 atau lebih baru target penempatan

Manajer Paket Swift

Swift Package Manager adalah alat untuk mengelola distribusi kode Swift. Ini terintegrasi dengan sistem pembuatan Swift untuk mengotomatisasi proses mengunduh, menyusun, dan menghubungkan dependensi pada semua platform.

Menambahkan Parma sebagai ketergantungan dengan menggunakan XCode's GUI, URL paket adalah https://github.com/dasautoooo/Parma .

Cocoapods

Cocoapods adalah manajer ketergantungan untuk proyek kakao. Untuk instruksi penggunaan dan instalasi, kunjungi situs web mereka. Untuk mengintegrasikan Parma ke dalam proyek XCode Anda menggunakan Cocoapods, tentukan di Podfile Anda:

 pod 'Parma' 

Kustomisasi Penampilan

Untuk menyesuaikan gaya dan View Text , buat render baru yang sesuai dengan protokol ParmaRenderable , dan hanya menerapkan kembali mereka yang sesuai dengan tujuan Anda. Akhirnya, tetapkan render yang disesuaikan sebagai render baru saat membuat tampilan Parma .

import Parma

struct ContentView : View {
    var markdown = " I'm **Strong**. "
    
    var body : some View {
        Parma ( markdown , render : MyRender ( ) )
    }
}

struct MyRender : ParmaRenderable {
    ...
}

Ada demoApp yang memodifikasi beberapa metode delegasi di bawah ini untuk semua orang dapat diambil sebagai referensi.

/// Define the heading text style.
/// - Parameters:
///   - level: The level of heading.
///   - textView: The textView generated from captured heading string.
func heading ( level : HeadingLevel ? , textView : Text ) -> Text

/// Define the paragraph text style.
/// - Parameter text: The text string captured from paragraph.
func paragraph ( text : String ) -> Text

/// Define the text style for plain text. Do NOT recommend to alter this if there's no special purpose.
/// - Parameter text: The text string captured from markdown.
func plainText ( _ text : String ) -> Text

/// Define the strong text style.
/// - Parameter textView: The textView generated from captured strong string.
func strong ( textView : Text ) -> Text

/// Define the emphasis text style.
/// - Parameter textView: The textView generated from captured emphasis string.
func emphasis ( textView : Text ) -> Text

/// Define the link text style.
/// - Parameters:
///   - textView: The textView generated from captured link string.
///   - destination: The destination of the link.
func link ( textView : Text , destination : String ? ) -> Text

/// Define the code text style.
/// - Parameter text: The text string captured from code.
func code ( _ text : String ) -> Text

/// Define the style of heading view.
/// - Parameters:
///   - level: The level of heading.
///   - view: The view contains heading text.
func headingBlock ( level : HeadingLevel ? , view : AnyView ) -> AnyView

/// Define the style of paragraph view.
/// - Parameter view: The view contains view(s) which belong(s) to this paragraph.
func paragraphBlock ( view : AnyView ) -> AnyView

/// Define the style of list item.
/// - Parameter attributes: Attributes of the list containing the item. Those must be considered for proper item rendering.
/// - Parameter index: Normalized index of the list item. For exemple, the index of the third item of a one level list would be `[2]` and the second item of a sublist appearing fourth in it's parent list would be `[3, 1]`.
/// - Parameter view: The view contains view(s) which belong(s) to this item.
func listItem ( attributes : ListAttributes , index : [ Int ] , view : AnyView ) -> AnyView

/// Define the style of image view.
/// - Parameter urlString: The url string for this image view.
/// - Parameter altTextView: The view contains alt text.
func imageView ( with urlString : String , altTextView : AnyView ? ) -> AnyView 

Nama Asal

Parma adalah kota di Italia utara, yang terkenal dengan arsitektur, musik, dan seni. Alasan memilih nama kota ini sebagai nama proyek adalah Giambattista Bodoni, seorang juru ketik terkenal, yang menghabiskan sebagian besar hidup seumur hidupnya dan bekerja di kota ini.

Bodoni adalah seorang juru tipografi Italia, tipe-desainer di Parma. Selama umurnya, ia merancang banyak tipografi yang dikenal sebagai Bodoni saat ini. Setiap Mac memiliki font Bodoni yang diinstal, dan bebas digunakan.

Kredit

Paket ini dibangun di bawah, yang merupakan parser penurunan harga di Swift.