TokamakPublish

TokamakPublish

Verwenden Sie Tokamak in Ihren Themes für den statischen Publish-Generator.

Sie können entweder Ihr gesamtes Theme mit Tokamak schreiben oder es in Ihr vorhandenes Plot HTML integrieren.

Eine Tokamak-Implementierung des .foundation Themes wird unter dem Namen .tokamakFoundation bereitgestellt.

TokamakHTMLFactory

Um Ihr eigenes Tokamak-Design zu erstellen, befolgen Sie das TokamakHTMLFactory -Protokoll. Dafür sind folgende Funktionen erforderlich:

 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
}

In diesen Funktionen können Sie eine View mit SwiftUI-kompatibler Syntax erstellen:

 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 )
  }
  ...
} 

Plotintegration

Mit dem view können Sie Tokamak-Ansichten in Ihr Plot-HTML einbinden:

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

Sie können Plot-Knoten genauso einfach in Ihre Tokamak-Ansichten einbinden:

 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 " ) )
    )
  }
}