finphie / stazor Goto Github PK

View Code? Open in Web Editor NEW

0.0 0.0 0.0 399 KB

シンプルな静的サイトジェネレーターです。

License: MIT License

C# 96.84% HTML 1.28% SCSS 1.87%

stazor's Introduction

Repositories

Actions
GitHub Actions関連ファイルの管理と、各種設定の同期を行うリポジトリです。
dotfiles
設定ファイルなどを管理するテンプレートリポジトリです。

stazor's People

Contributors

Watchers

stazor's Issues

HTML/CSSの最適化プラグインを追加

OGP対応

OGPに対応する。
画像形式はWebP

<meta property="og:title" content="">
<meta property="og:image" content=".webp">
<meta name="twitter:card" content="summary_large_image">

ログ出力にスレッド番号を含める

トップページ・カテゴリー・タグページ生成

トップページ・カテゴリー・タグページ用のHTML生成処理を追加する必要があります。

サムネイル画像: SVGまたはWebP（SVGの場合も、OGP用にWebP画像が必要）
ページネーション

preload

<link rel="prerender" href="//example.com/">

meta robots
```
<meta name="robots" content="noindex">
```

パーマリンクについて

各記事
トップページ
カテゴリーページ
タグページ

NuGet関連の属性を追加する

引数チェックにCommunityToolkit.Diagnosticsを利用する

カテゴリー指定をMarkdownファイルからファイル階層による指定に変更

GetRequiredSectionを利用する

テストを追加

exceptionコメント追加

Minimal API

.NET 7

ドキュメンテーションコメントのvalueタグを修正する

null許容参照型関連の属性を修正

メタデータのタイトルとタグを文字列型からUtf8Arrayに変更する

プラグインのAPIについて

現在、プラグインでは非同期処理に対応しています。

Stazor/Source/Stazor.Core/IPlugin.cs

Line 15 in 5694676

IAsyncEnumerable<IDocument> ExecuteAsync(IAsyncEnumerable<IDocument> inputs);

しかし、非同期処理が必要になるケースはごく限られており、
同期処理に変更しても問題ないように思います。

非同期処理が必要になるケースとしては、HttpClientを利用して外部のAPIを利用する場合などが考えられます。
Stazorは、コンソールアプリケーションとして利用するはずなので問題にはならないはずです。

LICENSEファイル追加

MarkdownファイルからヘッドレスCMSを使用したアプローチに変更

画像管理が面倒なため

Markdown解析処理を改善する

Markdown解析の際、UTF-16ではなくUTF-8で処理すべき。
解析自体が遅いので最適化する必要がある。
YAMLの解析も最適化可能。

ThrowIfNullを利用する

SimpleTextTemplate v1 ソースジェネレーター対応

プロジェクト分離

コア部分とテーマは分離する必要があります。
また、コア部分・プラグインに関してはNuGetに登録した方が良さそうです。