Parma

Парма

Отображение уценки с использованием чистых компонентов Swiftui. Принятие преимуществ ViewBuilder для создания индивидуальных выступлений для Text и View .

Пример

import Parma

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

Для получения дополнительных примеров, пожалуйста, обратитесь к демонстрационному приложению.

Поддержка разметки

Уже поддерживается

• Заголовок уровня 1-6
• Абзац
• Многоуровневый список пуль
• Многоуровневый заказанный список
  • Период разделителя
  • Разделитель скобок
• Изображение (требуют дополнительных конфигураций)
• Встроенный текст
  • Сильный
  • Акцент
  • Код

Возможно поддержка в будущих версиях

• Делитель
• Блок цитата
• Кодовый блок

Не поддерживается

• Встроенная гиперссылка

Установка

Требование

• Xcode 11.0 или позже
• Свифт 5 или позже
• iOS 13.0 / macOS 10.15 или более поздний цвет цели развертывания

Swift Package Manager

Swift Package Manager - это инструмент для управления распределением Swift Code. Он интегрирован с системой Swift Build для автоматизации процесса загрузки, компиляции и связывания зависимостей на всех платформах.

Добавление Parma в качестве зависимости с помощью графического интерфейса Xcode, URL -адрес пакета https://github.com/dasautoooo/Parma .

Кокопод

Кокоподы являются менеджером зависимостей для какао -проектов. Для получения инструкций по использованию и установке посетите их веб -сайт. Чтобы интегрировать Parma в ваш проект XCODE с использованием кокопод, укажите его в своем Podfile :

 pod 'Parma' 

Настройка внешнего вида

Чтобы настроить стили Text и View S, создайте новый рендеринг, который ParmaRenderable протоколу, и повторности только те, которые соответствуют вашим целям. Наконец, назначьте индивидуальный рендеринг в качестве нового рендеринга при создании представления Parma .

import Parma

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

struct MyRender : ParmaRenderable {
    ...
}

Есть демо -апп, который изменил некоторые из этих методов делегатов ниже, чтобы все могли принять в качестве ссылки.

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

Имя Происхождение

Парма - город в северной Италии, который славится своей архитектурой, музыкой и искусством. Причина выбора этого города в качестве названия проекта - Джамбаттиста Бодони, знаменитый типограф, который провел большую часть своей жизни и работая в этом городе.

Бодони был итальянским типографом, дизайнером типа в Парме. За всю жизнь он разработал много шрифтов, которые в настоящее время известны как Бодони. На каждом Mac установлен шрифт Bodoni, и бесплатно в использовании.

Кредит

Пакет построен на Down, который является анализатором уценки в Swift.