TokamakPublish

TokamakPublish

Use Tokamak em seus temas para o gerador estático de publicação.

Você pode escrever todo o seu tema com Tokamak ou integrá-lo ao seu Plot HTML existente.

Uma implementação Tokamak do tema .foundation é fornecida sob o nome .tokamakFoundation .

TokamakHTMLFactory

Para criar seu próprio tema Tokamak, siga o protocolo TokamakHTMLFactory . Isso requer as seguintes funções:

 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
}

Nessas funções, você pode construir uma View com sintaxe compatível com 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 )
  }
  ...
} 

Integração de enredo

Você pode incluir visualizações do Tokamak em seu Plot HTML com o nó 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 ( ) )
  )
)

Você pode incluir nós de plotagem em suas visualizações do Tokamak com a mesma facilidade:

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