github pagesでブログを書くベストプラクティスを考える

github pagesでブログを書くベストプラクティスを考える

2019, Oct 29

アジェンダ

実際に運用している人の話を聞きたいですね~。 もっとノウハウを共有していくべき。

posts以下の問題

可能な限り初期段階で試行錯誤しておいた方がいいです。 捨てる事を前提にメジャーバージョンをリポジトリで管理しても良いかもしれません。

ファイルが乱雑に置かれる

任意のディレクトリを配置して管理できます。 他のファイルでpost_urlを設定している場合、書き替える必要がありますがビルド時にエラーメッセージが出てくるので安心です。 敢えてリンク先を決め打ちで指定する方法もありますが、この場合リンク切れに気付かないため非推奨です。

リンク先を変える

permalink: python を設定することでURLを設定することができます。 一括で操作するなら_config.ymlに設定し、ファイル(ページ)ごとに_config.ymlの設定を任意で書き換えられます。 この場合、post_urlでリンク指定している場合は変更による影響はありません。

_data/.ymlの使い方

  • categoryやtagを動的に設定する用途に使えない
    • 変換されたものではなく、記号がタグとして扱われる。
  • サイトで使える固有のパラメータ
  • 別のサービスへのリンク

チャット

静的コンテンツに動的サービスを使う事はできないので、外から組み込むしかできません。 つまり、JavaScript頼みになります。

まともに使えるサービスがこの辺りですが、いわゆるWordPressのような要望すら満たせません。 今後に期待するか、そもそもチャットフォームを使わない前提での運用を検討する必要があります。

私の場合、ユーザーコメントをコンテンツにする気はないですが、フィードバックは欲しいのでsmallchatを採用しています。

導入方法

各サービスに依存しますが、大体の場合はscriptタグ一つ置くぐらいで導入できると思います。