HN 日本語サマリー

← 一覧へ戻る
プログラミング

CL-BBS: Common Lispで書き直されたSchemeBBS風テキスト掲示板

CL-BBS: the schemeBBS-like textboard rewritten in Common Lisp (github.com)

37 pointsby lerax1 コメント

要約

CL-BBSは、Common Lispで書かれた高性能な匿名テキスト掲示板エンジンです。これは、オリジナルのMIT SchemeBBSのモダンなクローンであり、シームレスなレイアウト、多様な書式設定、画像プレビューなどの機能を備えています。JavaScript不要のサーバーサイドレンダリングで動作し、堅牢なテストスイートと環境変数による簡単な設定オプションを提供します。

全文翻訳

cl-bbs

Common Lispで書かれた匿名テキストボード(BBS)エンジンです。オリジナルのMIT Scheme SchemeBBS(dis.4chan.orgやworld4ch /prog/で動作していたもの)の高性能でモダンなクローンです。

特徴

  • シームレスなSchemeBBSレイアウト: スレッド、インデックスリスト、投稿を定義リスト(<dl>, <dt>, <dd>)内に表示し、オリジナルのSchemeBBSスタイルに完全に準拠しています。
  • 単一の末尾フォーム: スレッドの最後に単一の投稿フォームが表示される(投稿ごとのフォームなし)という、オリジナルのテキストボードのパラダイムに準拠しています。
  • 包括的なフォーマットサポート:
    • 太字: **text** -> <b>text</b>
    • 斜体: __text__ -> <i>text</i>
    • 等幅:
      text -> <code>text</code> (標準のバッククォート記法を使用)
    • ネタバレ: ~~text~~ -> <del>text</del>
    • ブロッククォート: >で始まる行は <blockquote> ブロックとしてレンダリングされます。
    • 投稿参照: >>7 は、スレッドページ内のジャンプアンカーに動的にハイパーリンクされます。
    • 直接画像リンクプレビュー: 画像(.png, .jpg, .jpeg, .gif, .webp, .bmp)への直接リンクは、自動的にエレガントなクリック可能な画像プレビューに変換されます。
    • 標準URL: 標準URLは自動的に標準ハイパーリンクとしてフォーマットされます。
  • 動的なボードヘッダー: 中央揃えおよび左揃えのボードリストヘッダー(例: [ foo | prog ])はスキャンされ、各ページの先頭に動的に表示されます。
  • テーマ設定(Cookie): /board/preferences ページで複数のテーマ(default, classic, dark, mona, no)を選択できます。選択はブラウザのCookie(theme)に保存され、永続化されます。
  • JavaScriptは一切不要: アプリケーションは完全にサーバーサイドでレンダリングされます。
  • ローカルQlotサンドボックス: qlfile を介して依存関係がピン留めされたロックされたサンドボックスにより、環境間での後方互換性が保証されます。
  • 29アサーションテストスイート: Cookie、ルーティングパイプライン、フォーマットルールを検証する包括的なテストカバレッジ。

始め方

前提条件

Roswell と Qlot がインストールされている必要があります。

# Roswellをインストール
# (Roswellのプラットフォーム手順に従ってください)

# Qlotをインストール
ros install qlot
インストール

リポジトリをクローンし、ローカルで依存関係をインストールします。

# 依存関係をローカルでフェッチしてロック
qlot install
Dockerを使ったサーバーの実行

Dockerコンテナ内で簡単にサーバーを実行できます。アプリケーションはポート 8222 でネイティブにトラフィックを受信し、マウントされたボリュームを使用してデータを永続化します。

Docker CLIの使用

docker run コマンドで明示的にサーバーを起動するには:

docker run --rm -it \
  -p 8222:8222 \
  -v ./data:/cl-bbs/data \
  ryukinix/cl-bbs:latest

これにより、コンテナの内部ポート8222がホストにアタッチされ、ローカルの./dataディレクトリが直接マウントされ、再起動後もスレッドと投稿が保護されます。

Docker Composeの使用

または、docker-compose.ymlファイルを作成して、コンテナ管理をよりスムーズにするために設定を宣言的に整理することもできます。

services:
  cl-bbs:
    image: ryukinix/cl-bbs:latest
    container_name: cl-bbs
    restart: unless-stopped
    ports:
      - "8222:8222"
    volumes:
      - ./data:/cl-bbs/data

その後、以下を使用して起動します。

docker compose up -d
サーバーのローカル実行

Dockerなしで透過的に実行したい場合は、ネイティブにHunchentoot/Clackサーバーを起動します。

make server

サーバーが起動し、ポート 8222 でローカルにリッスンします。

テストの実行

自動化されたParachuteテストスイートを実行します。

make check

設定

環境変数を使用してサーバーを設定できます。

  • SBBS_DATADIR: ボードのS式データベースファイルが保存されるディレクトリ(デフォルト: data/)。
  • SBBS_LOCKED_BOARDS: 読み取り専用モードでロックされるボードのカンマ区切りリスト。新しいスレッドの作成や、これらのボードへのコメント/返信の投稿はできません(例: SBBS_LOCKED_BOARDS=foo,bar)。これらのボードのフロントエンドでは投稿フォームも非表示になります。
  • SBBS_ADMIN_USER: 管理パネルのユーザー名(デフォルト: admin)。
  • SBBS_ADMIN_PASSWORD: 管理パネルのパスワード(デフォルト: superchanner)。

ソフトウェアスタック

  • Lisp: Common Lisp (SBCL) をRoswell経由でロード。
  • Webサーバー: Hunchentoot, Clack, Lack。
  • HTMLテンプレート: cl-who (HTML生成)。
  • データストア: data/sexp/ 内のプレーンテキストファイルに保存されたS式ファイル。