Website

概要

このページでは、ドキュメントサイト(このサイト)をアップデートする方法について説明します。

このサイトのGitHubリポジトリはaileron-gateway.github.ioです。

必要なツールは以下の通りです:

開発環境のセットアップ

1. Hugo をインストール

手順はこちらを参照してください:インストール

必ずextended editionをインストールしてください。

以下はHugoのextendedバージョンをインストールする例です。

export HUGO_VERSION=0.147.5
wget -O hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb
sudo dpkg -i hugo.deb

インストールが完了したら、hugo コマンドが使用可能か確認してください。

$ hugo version
hugo v0.147.5-7766fc62416ff95ed7768c19947ac0fcd96444cc+extended linux/amd64 BuildDate=2025-05-22T11:37:19Z VendorInfo=gohugoio

2. Dart Sass をインストール

手順はこちらを参照してください:Dart Sass または Sass のインストール

3. Node.js をインストール

手順はこちらを参照してください:Node.js® ダウンロード

npm コマンドが使用可能か確認してください。
npm -vコマンドでバージョンを確認できます:

$ npm -v
10.2.4

ローカルでウェブサイトを実行する

リポジトリをクローンし、npm パッケージをインストールします。

git clone --recursive  https://github.com/aileron-gateway/aileron-gateway.github.io.git
cd aileron-gateway.github.io
npm install
cd themes/docsy/ && npm install

リポジトリのルートに戻り、以下のコマンドを実行します。 これによりローカルでウェブサイトが起動します。

hugo server -D

最終更新 June 7, 2025: add japanese (f2a41f1)