TokamakPublish

トカマク公開

パブリッシュ静的ジェネレーターのテーマで Tokamak を使用します。

Tokamak を使用してテーマ全体を記述することも、既存のPlot HTML と統合することもできます。

.foundationテーマの Tokamak 実装は、 .tokamakFoundationという名前で提供されます。

TokamakHTMLFactory

独自の Tokamak テーマを作成するには、 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
}

これらの関数では、SwiftUI 互換の構文を使用してViewを構築できます。

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

プロットの統合

viewノードを使用して、プロット HTML に Tokamak ビューを含めることができます。

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

Tokamak ビューに 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 " ) )
    )
  }
}