TokamakPublish

Penerbitan Tokamak

Gunakan Tokamak di tema Anda untuk generator statis Publikasikan.

Anda dapat menulis seluruh tema Anda dengan Tokamak, atau mengintegrasikannya dengan Plot HTML yang sudah ada.

Implementasi Tokamak dari tema .foundation disediakan dengan nama .tokamakFoundation .

TokamakHTMLFactory

Untuk membuat tema Tokamak Anda sendiri, sesuaikan dengan protokol TokamakHTMLFactory . Itu memerlukan fungsi-fungsi berikut:

 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
}

Dalam fungsi ini, Anda dapat membuat View dengan sintaksis yang kompatibel dengan 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 )
  }
  ...
} 

Integrasi alur cerita

Anda dapat memasukkan tampilan Tokamak ke dalam Plot HTML Anda dengan view Node:

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

Anda dapat memasukkan node Plot dalam tampilan Tokamak Anda dengan mudah:

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