Merge branch 'main' into add-company-tour

Author: aster-void

.envrc.sample

@@ -1,2 +1,6 @@
-# if you are using nix
-use flake || use nix
+# if you are using flakes
+watch_file ./shell.nix
+use flake 
+
+# else if you are using nix-shell
+use nix

.github/workflows/check.yml

@@ -16,12 +16,6 @@ jobs:
           bun-version: 1.2.5
       - run: bun install --frozen-lockfile
       - run: bun check
-  typos:
-    name: Check Typos
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: crate-ci/typos@v1
   build:
     name: Build
     runs-on: ubuntu-latest
@@ -40,3 +34,11 @@ jobs:
             node_modules/.astro/assets
           restore-keys: ${{ runner.os }}-astro-build
       - run: bun run build
+  dirs-small:
+    name: All dirs must be small (<5MB)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: cachix/install-nix-action@v31
+      - run: nix run github:ut-code/internal-helpers#disallow-large-dir contents/articles/*/*
+      - run: nix run github:ut-code/internal-helpers#disallow-large-dir contents/members/*

.gitignore

@@ -12,3 +12,5 @@ dist
 # env
 .direnv
 .envrc
+
+.unlighthouse

.ignore

@@ -1 +1,4 @@
 bun.lock
+
+contents/articles/20*
+!contents/articles/2025

.vscode/extensions.json

@@ -1,3 +1,3 @@
 {
-  "recommendations": ["astro-build.astro-vscode", "tekumara.typos-vscode"]
+  "recommendations": ["astro-build.astro-vscode"]
 }

README.md

@@ -1,48 +1,50 @@
 # ut.code(); 公式ウェブサイト
 
-## 環境構築
+## 環境構築・コマンド
 
-### devcontainer
+`./docs/develop.md` を参照。
 
-下のボタンを押すと開発環境が起動します。
-起動までしばらく時間がかかるのでお待ちください。
+## Guidelines
 
-[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/ut-code/website)
+### 一般
 
-### ローカル
+フォーマッタは Prettier を用います。
+各フロントマッター (トップに書く YAML) のプロパティは `./docs/contents` に説明があります。
 
-- (必須) Bun >= v1.1.39
-- (推奨) Typos <https://github.com/crate-ci/typos>
-- 任意のエディタ <https://docs.astro.build/en/editor-setup/>
+### メンバー
 
-```sh
-bun install --frozen-lockfile
-```
+- メンバー画像や名前に本名・顔写真を使う必要はありません。
+- メンバー画像は、 `faceImage` と `upperBodyImage` の 2 つあります。
+  - どちらも 1:1 にクロップされます。
+  - `faceImage` はアップの、 `upperBodyImage` は引いた画像を使ってください。元となる画像は同じ画像を使ってください。
 
-## 開発
+### 記事
 
-```sh
-bun dev
-```
+- サムネイルは縦横比 3:5 にクロップされます。
 
-<http://localhost:4321/> で開発用サーバーが起動します。
+  - 可能なら 3:5 に近い画像を使い、
+  - できないかつクロップが許容できない場合は、 `fit: contain` と背景色 (`bg_color:`) を指定してください。
 
-## ビルド
+- 画像サイズは 1MB 未満に抑えてください。 ffmpeg や ImageMagick を使い、解像度を下げたり、画質 (Quality) を下げたり、WebP (or AVIF) に変換するなどができます。
 
-```sh
-bun run build
-```
+  - 参考 <https://stackoverflow.com/questions/7261855/recommendation-for-compressing-jpg-files-with-imagemagick>
+  - 例:
 
-## ディレクトリ構造
+    - `mogrify -resize 800x -quality 80 -format webp *.png *.jpg *.jpeg`
+      - ImageMagick についてきます。
+      - コマンドの引数は見ての通り。
+    - `ffmpeg -i ./input.png -vf 'scale=1920:-1' -crf 10 output.avif`
+      - -> 50〜300kb 程度になります。AVIF の場合、多少 (数秒〜1分程度) 時間がかかります。
+      - `-vf scale={width}:{height}`: 画像の横幅。height が -1 のときは、横幅から計算する。
+      - `-crf`: 画像の圧縮率。大きいほうが圧縮率が高い。
 
-- `contents/`: 記事のデータです。Astro の Content Collection を使って `src/pages` から読み込みます。
-- `src/`
-  - `images/`: 記事ではなくデザインに用いる画像です。
-  - `pages/`: Astro の機能によりファイル名がパスに変換されます。
-  - `islands/`: Astro で読み込む Island の集合です。
-  - `content.config.ts`: Astro の Content Collection の設定を書きます。
-  - `global.css`: Tailwind の設定ファイルです。
-- `astro.config.ts`: Astro の設定ファイルです。Vite の設定もここに書きます。
-- `biome.jsonc`: Biome の設定ファイルです。Biome のフォーマット部分は Astro に対応していないので、Lint だけ使っています。対応したら両方 Biome にしましょう。
-- `.prettier{rc,ignore}`: Prettier の設定ファイルです。 Prettier には、 astro と svelte と tailwind のプラグインが入っています。
-- `svelte.config.js`: 最もフィジカルで、最もプリミティブで、そして最もフェティッシュなフレームワークでいかせていただきます。
+  - HEIC は対応していないので、 ImageMagick で他のフォーマットに変換してください。
+    - 例: `magick picture.HEIC picture.webp`
+
+- 各記事のファイルサイズの合計は5 MB までに抑えてください。
+  - 理想は 1MB 未満です。
+  - ファイルサイズの確認には、`ncdu` が使いやすいです。
+
+### プロジェクト
+
+- サムネイルは縦横比 3:5 にクロップされます。

_typos.toml

@@ -22,6 +22,7 @@ export default defineConfig({
     icon({
       include: {
         feather: ["*"],
+        flowbite: ["*"],
       },
     }),
     mdx(),