静的サイトジェネレータ

こんにちは、フロントエンドエンジニアの柳田です。 現在、チーム内でドキュメントを作成する機会が多くなってきました。 社内では、様々な方法でドキュメントを作成しているのですが、そのひとつの方法として、静的サイトジェネレータ（Static Site Generator：SSG）があります。 今回は、ドキュメント作成にあたって自分が試してみたSSGをいくつかご紹介したいと思います。 静的サイトジェネレータ（SSG）とは？ 静的サイトジェネレータとは、入力ファイルから簡単に静的ページを生成してくれるツールのことです。 有名なものだと、Next.jsやGatsby、Nuxtがありますね。 実際に表示に利…

こんにちは。今回は静的サイトの作り方について書いてみます。 フリー張り紙素材 はりがみやも静的サイトで、基本的にはこの記事と同じようなやり方で作られています。 【注意】 これを書いている人は趣味レベルな上、「なんだかわからんが動いたからヨシ！」という人間です。ベストプラクティスとは程遠い内容かもしれません。 とはいえ「ちゃんとやる」「完璧にやる」といろいろとハードルが高いですし。 とりあえず動かしてみたい、作ってみたいという方に読んでいただければ。 想定している読者 前書き 静的サイトとは？ 動的サイトとは？ 静的サイト作成の流れ 静的サイトジェネレーター 本記事のゴール 完成イメージ 環境の…

静的サイトジェネレータPelicanでAsciiDocを使いたかったが…。

静的サイトジェネレータPelicanでAsciiDocを使いたい。

「警察に話せばルフィに粛清 黙秘の契約」容疑者の1人が供述 | NHK 機械 on Twitter: "あのー、三浦瑠麗さん 中野信子さんとの共著「不倫と正義」って対談で、旦那さんと会社の株を半々持ち合って経営に参画していることを明言してるようなんですけど… https://t.co/eur3LtmU7h" 「性被害をビジネスにしている」「詐欺娼婦」園子温監督の性加害を告発した女優の千葉美裸さんが自殺。Twitter上でアンフェから執拗に中傷されていた Colabo記者会見、報道各社がすし詰めで押し寄せてＴＶのカメラまで入ってた模様、 ←ほぼ全社報道ストップしてるのすごくない？ 上名栗チワワ事…

4行で YouTube から提供される動画の埋め込みコードをそのまま使うと PageSpeed Insights のスコアが落ちる。 しかし、lite-youtube-embed などのライブラリでダミー画像を表示しておくと再生するまでは偽物感が残ってしまう。イヤだ！ そこで、ページが表示された後に iframe を遅延読み込みすることにした。 ブラウザの iframe の遅延読み込み機能や window.onload では効果がなく、IntersectionObserver を使うことで PageSpeed Insights のスコアが改善できた。 PageSpeed Insights 最近…

GitHub Pages + Hugoで個人ホームページを作ってみた。 あわせてよみたい GitHub Pages + Hugoで個人ホームページを作ってみた。 やっぱ休みに入ると生活がだらけるよね。昨日で仕事を納めたのだけど、相変わらず飲み会に参加した後は機嫌が悪いようであり、その不愉快感を消すために一日中開発に没頭していた。成果物としてはこんなものを完成させた。 www.yuki2021.net 僕はいろんなSNSをフラフラとしていて広範囲にネットで活動をしているのだけど、自己紹介をするためのプロフィールページで決まったところがなかったなと思っていて、それで作りたいとは思ってたのだけどいつ…

Jamastack とは何か Jamstackという言葉はそれが世に出てきた時と現在では意味するところが異なっています。元々は使用されている技術 stack の頭文字をとって付けられたもの(JavaScript、API、Markup)ですが、現在は「分離」、"decoupling" を示すアーキテクチャとしてのアプローチの意味があります。 現在の公式サイトでは以下のように定義しています。 What is Jamstack? Jamstack is an architectural approach that decouples the web experience layer from dat…

人事部の小池です。 この記事は KAYAC Advent Calendar 2022 の16日目の記事です。 カヤックの規程文書管理の仕組みを Google ドキュメント から GitHub に移行した取り組みについて紹介します。 これまでの文書管理 カヤックでは長年規程文書を Google ドキュメント で管理していました。Google ドキュメント は多くの従業員にとって親しみやすいものの、文書を管理する上でいくつかつらい点がありました。 改訂内容の差分が追いにくい・改訂の背景がわからない Google ドキュメント なので変更履歴から過去の版を閲覧することは可能ですが手軽とはいえません。…

仕事にちょっと余裕ができたので、森ソフトのサイトをアップデートしてみました。ついでに、事例紹介をいうページを追加してみたので、その際 hugo でつまずいたところなどをメモっておきます。 hugo および テーマのアップデート まずは、ずいぶんと放っておきっぱなしだったので、 hugo と テーマ (universal) を新しくしておきます。 hugo のアップデート まずは、 hugo から。 mor@DESKTOP-DE7IL4F:~/tmp$ wget https://github.com/gohugoio/hugo/releases/download/v0.108.0/hugo_0.…

この記事は、Money Forward Engineering 1 Advent Calendar 2022 7日目の投稿です。 6日目は koyoさんで i18n YAML ファイル中の日本語/英語のズレを検知する単体テスト でした。 本日は私が「メタデータ管理の最初の一歩」について書いていきたいと思います。

この記事は どもがよアドベントカレンダー2022 の2日目の記事です。1日目はヴぃさんの Among Us部サーバー 今年流行ったもの でした。どもがよの今年一年のトレンドがまとまっててわかりやすい。そういえばこんなのあったな～と思い出してしみじみしていました。 「Twitter が終わるかもしれない」 イーロン・マスクはそれまでの Twitter を破壊した。これは確かだと思っていて、よきにしろ悪しきにしろ、これから変わっていくだろう。 マスク体制について、個人的にはそこまで深刻には感じていなくて、その結果 Twitter の立て直しに失敗してサービスの終焉を迎えたとしても、後に振り返ってみ…

v1.15.4。

v0.12.0。40分ほどかかった。

はじめに markdownで複数ページからなるドキュメントを作る方法を探していた。 mdbookを使い始めたが、調べたら他にも色々なツールがあるとのこと。 その中で今回はMkDocsを使ってみた MkDocsとは 静的サイトジェネレータ 文章はmarkdownファイル buildすることでhtmlファイルを作ることができる テーマ（ページデザイン）にはテンプレートがあり、簡単にキレイなページを作れる Python製 環境 OS: Windows 10 導入手順 pip install mkdocs 新しくドキュメントを作る mkdocs test [フォルダ名] mkdocs test mkd…

JAWS-UG朝会 #38 jawsug-asa.connpass.com 最近早起きなので普通に起きてました。 セッション セッション① Well-Architectedを再度学習して内容をまとめてみる 久保田亨さん Well-Architected 6つの柱 運用上の柱 組織の優先順位を決める セキュリティの柱 Well-Architected、困ったときの指針ですが読むのが大変でつまみ食い状態です。 聞くだけでメモれなかったので、後ほど纏めてくれていた資料が公開されるので必要に応じて参照しないと。 セッション② Redshift Serverless とは？ emiさん 従来の Reds…