Parma

Parma

Exiba o Markdown usando componentes Swiftui Pure. Tomando vantagens do ViewBuilder para fazer aparições personalizadas para Text e View .

Exemplo

import Parma

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

Para mais exemplos, consulte o aplicativo de demonstração.

Suporte a despedida

Já suportado

• Caminhando de nível 1-6
• Parágrafo
• Lista de balas de vários níveis
• Lista ordenada por vários níveis
  • Delimitador de período
  • Delimitador entre parênteses
• Imagem (precisa de configurações extras)
• Texto em linha
  • Forte
  • Ênfase
  • Código

Possivelmente apoie em versões futuras

• Divisor
• Citação de bloco
• Bloco de código

Não suportado

• Hiperlink inline

Instalação

Exigência

• Xcode 11.0 ou mais tarde
• Swift 5 ou mais tarde
• IOS 13.0 / MacOS 10.15 ou posterior alvos de implantação

Gerente de pacotes Swift

O Swift Package Manager é uma ferramenta para gerenciar a distribuição do código SWIFT. Está integrado ao sistema SWIFT Build para automatizar o processo de download, compilação e vinculação dependências em todas as plataformas.

Adicionando Parma como uma dependência usando a GUI do Xcode, o URL da embalagem é https://github.com/dasautoooo/Parma .

Cocoapods

O Cocoapods é um gerente de dependência de projetos de cacau. Para instruções de uso e instalação, visite o site deles. Para integrar Parma ao seu projeto Xcode usando Cocoapods, especifique -o no seu Podfile :

 pod 'Parma' 

Personalização da aparência

Para personalizar estilos e View Text , crie uma nova renderização que esteja em conformidade com o protocolo ParmaRenderable e reimplemente apenas aqueles que se encaixam nos seus propósitos. Por fim, atribua a renderização personalizada como uma nova renderização quando crie a View Parma .

import Parma

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

struct MyRender : ParmaRenderable {
    ...
}

Há uma DemoApp que modificou alguns desses métodos de delegados abaixo para que todos tomem como referência.

/// 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 

Nome Origin

Parma é uma cidade no norte da Itália, famosa por sua arquitetura, música e arte. O motivo de escolher o nome da cidade como o nome do projeto é Giambattista Bodoni, um famoso tipógrafo, que passou a maior parte de sua vida vivendo e trabalhando nesta cidade.

Bodoni era um tipógrafo italiano, tipo designer em Parma. Durante sua vida útil, ele projetou muitos tipos de letra, conhecidos como Bodoni hoje em dia. Cada Mac possui a fonte Bodoni instalada e gratuita para usar.

Crédito

O pacote é construído sobre o Down, que é um analisador de marcha em Swift.