TokamakPublish

ТокамакОпубликовать

Используйте Tokamak в своих темах для статического генератора публикации.

Вы можете либо написать всю тему с помощью Tokamak, либо интегрировать ее с существующим HTML- Plot .

Реализация темы .foundation в Токамаке предоставляется под именем .tokamakFoundation .

TokamakHTMLFactory

Чтобы создать собственную тему Токамак, следуйте протоколу TokamakHTMLFactory . Для этого необходимы следующие функции:

 struct MyThemeFactory < Site : Website > : TokamakHTMLFactory {
  func makeIndexView ( for index : Index , context : PublishingContext < Self . Site > ) throws -> IndexView
  func makeSectionView (
    for section : Publish . Section < Self . Site > ,
    context : PublishingContext < Self . Site >
  ) throws -> SectionView
  func makeItemView ( for item : Item < Self . Site > , context : PublishingContext < Self . Site > ) throws -> ItemView
  func makePageView ( for page : Page , context : PublishingContext < Self . Site > ) throws -> PageView
  func makeTagListView ( for page : TagListPage , context : PublishingContext < Self . Site > ) throws -> TagListView
  func makeTagDetailsView ( for page : TagDetailsPage , context : PublishingContext < Self . Site > ) throws -> TagDetailsView
}

В этих функциях вы можете создать View с синтаксисом, совместимым со SwiftUI:

 struct MyThemeFactory < Site : Website > : TokamakHTMLFactory {
  func makePageView ( for page : Page , context : PublishingContext < Self . Site > ) throws -> PageView {
    Text ( " Welcome to my website " )
      . font ( . largeTitle )
    VStack ( alignment : . leading ) {
      page . body
    }
      . frame ( idealWidth : 820 , maxWidth : 820 )
      . padding ( . vertical , 40 )
    Text ( " 2020 © Tokamak Contributors " )
      . font ( . caption )
  }
  ...
} 

Интеграция графика

Вы можете включить представления Токамака в свой HTML-график с помощью узла view :

 let myHTML = Plot . HTML (
  . body (
    . h1 ( . text ( " My Website " ) ) ,
    . view {
      Text ( " This is a Tokamak " ) + Text ( " View " )
        . font ( . system ( . body , design : . monospaced ) )
    } ,
    . view ( MyTokamakView ( ) )
  )
)

Вы можете так же легко включать узлы Plot в представления токамака:

 struct ContentView : View {
  var body : some View {
    Text ( " My Website " )
      . font ( . largeTitle )
    Node . p (
      . span ( " This is a Plot " ) ,
      . span ( . text ( " Node " ) , . style ( " font-family: monospace " ) )
    )
  }
}