Question 1

セルフホストしたColanodeをCaddy経由で運用している際に、絵文字/アイコンピッカーが空白になる問題を修正するにはどうすればよいですか？

Accepted Answer

ピッカーが空白になるのは、ブラウザがCaddyの内部SSL証明書を拒否し、サービスワーカーが登録できなくなることが原因です。コンソールには通常、次のように表示されます: `Failed to register a ServiceWorker ... /service.js: An SSL certificate error occurred`

クライアントマシンでCaddyのルートCAを信頼することで修正できます:

1. コンテナからCaddyのローカルルート証明書をコピーします:
```bash
docker cp <caddy-container>:/data/caddy/pki/authorities/local/root.crt caddy-root.crt
```
2. システムでそれを信頼します:
- Debian/Ubuntu:
```bash
sudo cp caddy-root.crt /usr/local/share/ca-certificates/caddy-root.crt
sudo update-ca-certificates
```
- Windows: 証明書を**信頼されたルート証明機関**にインポートします。
- macOS: キーチェーンアクセスにインポートし、**常に信頼**に設定します。
- Firefox: システムストアを使用しない場合は、**設定 > プライバシーとセキュリティ > 証明書**からインポートします。
3. ブラウザを完全に再起動し、Colanodeを再読み込みします。

これで絵文字/アイコンピッカーが読み込まれ、サービスワーカーのSSLエラーが消えるはずです。あるいは、ドメインにLet's Encryptなどの公的に信頼された証明書を使用してください。`OPFS sqlite3_vfs`/COOP/COEPの警告はこの問題とは無関係です。

Question 2

なぜ Obsidian から貼り付けた Markdown は Colanode で # や ``` のような生の文字が表示されるのですか？

Accepted Answer

これは Colanode のエディターのバグで、貼り付けられた Markdown が整形済みブロックに解析される代わりに、コードブロックとして扱われていました。この問題は Colanode v0.4.0 で修正されています。最新リリースにアップグレードしてから、Markdown コンテンツを再度貼り付けてください。アップグレードできない場合は、Markdown 構文の後の空白を手動で入力し直すことで（たとえば、`##` の後のスペースを削除してから追加し直す）、整形をトリガーできます。

Question 3

npm install を複数回実行した後も発生する Colanode クライアントのビルドエラー TS2305: '@tiptap/pm/model' has no exported member 'Node' を修正する方法は？

Accepted Answer

これは、`npm install` を繰り返し実行した際に、必要な推移的依存関係である TipTap/ProseMirror パッケージが削除（prune）され、`node_modules` が `package-lock.json` と同期しなくなった場合に発生します。クリーンな単一のインストールで回復してください。リポジトリのルートから、インストール済みの依存関係とすべてのワークスペースレベルの `node_modules` ディレクトリを削除し、その後一度だけインストールを実行します。

Windows PowerShell:
```powershell
Remove-Item -Recurse -Force node_modules, package-lock.json -ErrorAction SilentlyContinue
Get-ChildItem packages -Directory | ForEach-Object {
  Remove-Item -Recurse -Force (Join-Path $_.FullName 'node_modules') -ErrorAction SilentlyContinue
}
npm install
```

macOS/Linux:
```bash
rm -rf node_modules package-lock.json packages/*/node_modules
npm install
```

その後、`npm install` を再度実行せずに、すぐにビルドしてください。
```bash
npm run build -w @colanode/core && \
npm run build -w @colanode/crdt && \
npm run build -w @colanode/client && \
npm run build -w @colanode/ui && \
npm run build -w @colanode/web && \
npm prune --production
```

Docker や再現可能な CI/セルフホストのビルドでは、正常であることが確認されているロックファイルからのクリーンインストールを推奨します。
```bash
npm ci
```
`npm ci` は既存の `node_modules` を削除し、`package-lock.json` に記録されている内容を正確にインストールするため、繰り返しインストールによる prune の動作を回避できます。

colanode

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト