あなたの思考をリファクタリングする
English | 中文
---
## 目次
* [💡 紹介](#-紹介)
* [🔮 特徴](#-特徴)
* [🏗️ アーキテクチャとエコシステム](#️-アーキテクチャとエコシステム)
* [🌟 スター履歴](#-スター履歴)
* [🗺️ ロードマップ](#️-ロードマップ)
* [🚀 ダウンロードとセットアップ](#-ダウンロードとセットアップ)
* [アプリマーケット](#アプリマーケット)
* [インストールパッケージ](#インストールパッケージ)
* [Docker ホスティング](#docker-ホスティング)
* [Unraid ホスティング](#unraid-ホスティング)
* [インサイダープレビュー](#インサイダープレビュー)
* [🏘️ コミュニティ](#️-コミュニティ)
* [🛠️ 開発ガイド](#️-開発ガイド)
* [❓ FAQ](#-faq)
* [SiYuanはどのようにデータを保存しますか？](#siyuanはどのようにデータを保存しますか)
* [サードパーティの同期ディスクを介したデータ同期をサポートしていますか？](#サードパーティの同期ディスクを介したデータ同期をサポートしていますか)
* [SiYuanはオープンソースですか？](#siyuanはオープンソースですか)
* [新しいバージョンにアップグレードするにはどうすればよいですか？](#新しいバージョンにアップグレードするにはどうすればよいですか)
* [一部のブロック（リスト項目内の段落ブロックなど）がブロックアイコンを見つけられない場合はどうすればよいですか？](#一部のブロックリスト項目内の段落ブロックなどがブロックアイコンを見つけられない場合はどうすればよいですか)
* [データリポジトリキーを紛失した場合はどうすればよいですか？](#データリポジトリキーを紛失した場合はどうすればよいですか)
* [支払いが必要ですか？](#支払いが必要ですか)
* [🙏 謝辞](#-謝辞)
* [貢献者](#貢献者)
---
## 💡 紹介
SiYuanは、プライバシーを最優先とする個人の知識管理システムであり、細かいブロックレベルの参照とMarkdown WYSIWYGをサポートしています。
詳細については、[SiYuan英語ディスカッションフォーラム](https://liuyun.io)をご覧ください。
## 🔮 特徴
ほとんどの機能は無料で、商業利用も可能です。
* コンテンツブロック
* ブロックレベルの参照と双方向リンク
* カスタム属性
* SQLクエリ埋め込み
* プロトコル `siyuan://`
* エディタ
* ブロックスタイル
* Markdown WYSIWYG
* リストアウトライン
* ブロックズームイン
* 百万字の大規模ドキュメント編集
* 数学公式、チャート、フローチャート、ガントチャート、タイミングチャート、五線譜など
* ウェブクリッピング
* PDF注釈リンク
* エクスポート
* ブロック参照と埋め込み
* アセット付きの標準Markdown
* PDF、Word、HTML
* WeChat MP、Zhihu、Yuqueへのコピー
* データベース
* テーブルビュー
* フラッシュカード間隔反復
* OpenAI APIを介したAIライティングとQ/Aチャット
* Tesseract OCR
* マルチタブ、ドラッグアンドドロップで分割画面
* テンプレートスニペット
* JavaScript/CSSスニペット
* Android/iOS/HarmonyOSアプリ
* Dockerデプロイメント
* [API](https://github.com/siyuan-note/siyuan/blob/master/API.md)
* コミュニティマーケットプレイス
一部の機能は有料会員のみ利用可能です。詳細については[価格](https://b3log.org/siyuan/en/pricing.html)をご覧ください。
## 🏗️ アーキテクチャとエコシステム
| プロジェクト | 説明 | フォーク | スター |
|----------------------------------------------------------|-----------------|---------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|
| [lute](https://github.com/88250/lute) | エディタエンジン |  |  |
| [chrome](https://github.com/siyuan-note/siyuan-chrome) | Chrome/Edge拡張 |  |  |
| [bazaar](https://github.com/siyuan-note/bazaar) | コミュニティマーケットプレイス |  |  |
| [dejavu](https://github.com/siyuan-note/dejavu) | データリポジトリ |  |  |
| [petal](https://github.com/siyuan-note/petal) | プラグインAPI |  |  |
| [android](https://github.com/siyuan-note/siyuan-android) | Androidアプリ |  |  |
| [ios](https://github.com/siyuan-note/siyuan-ios) | iOSアプリ |  |  |
| [harmony](https://github.com/siyuan-note/siyuan-harmony) | HarmonyOSアプリ |  |  |
| [riff](https://github.com/siyuan-note/riff) | 間隔反復 |  |  |
## 🌟 スター履歴
## 🗺️ ロードマップ
* [SiYuanの開発計画と進捗](https://github.com/orgs/siyuan-note/projects/1)
* [SiYuanの変更履歴](CHANGELOG.md)
## 🚀 ダウンロードとセットアップ
デスクトップとモバイルでは、アプリマーケットからのインストールを優先的にお勧めします。これにより、将来的にワンクリックでバージョンをアップグレードできます。
### アプリマーケット
モバイル：
* [App Store](https://apps.apple.com/us/app/siyuan/id1583226508)
* [Google Play](https://play.google.com/store/apps/details?id=org.b3log.siyuan)
* [F-Droid](https://f-droid.org/packages/org.b3log.siyuan)
デスクトップ：
* [Microsoft Store](https://apps.microsoft.com/detail/9p7hpmxp73k4)
### インストールパッケージ
* [B3log](https://b3log.org/siyuan/en/download.html)
* [GitHub](https://github.com/siyuan-note/siyuan/releases)
### Docker ホスティング
Dockerデプロイメント
#### 概要
サーバーでSiYuanを提供する最も簡単な方法は、Dockerを使用してデプロイすることです。
* イメージ名 `b3log/siyuan`
* [イメージURL](https://hub.docker.com/r/b3log/siyuan)
#### ファイル構造
全体のプログラムは `/opt/siyuan/` にあり、基本的にはElectronインストールパッケージのresourcesフォルダーの構造です：
* appearance: アイコン、テーマ、言語
* guide: ユーザーガイドドキュメント
* stage: インターフェースと静的リソース
* kernel: カーネルプログラム
#### エントリポイント
エントリポイントはDockerイメージのビルド時に設定されます：`ENTRYPOINT ["/opt/siyuan/entrypoint.sh"]`。このスクリプトを使用すると、コンテナ内で実行されるユーザーの `PUID` と `PGID` を変更できます。これは、ホストからディレクトリをマウントする際の権限の問題を解決するために特に重要です。`PUID`（ユーザーID）と `PGID`（グループID）は環境変数として渡すことができ、ホストマウントディレクトリにアクセスする際に正しい権限を確保するのが容易になります。
`docker run b3log/siyuan` を使用してコンテナを実行する場合、次のパラメータを使用します：
* `--workspace`: ワークスペースフォルダーのパスを指定し、ホスト上で `-v` を使用してコンテナにマウントします
* `--accessAuthCode`: アクセス認証コードを指定します
詳細なパラメータは `--help` を参照してください。以下は新しい環境変数を使用した起動コマンドの例です：
```bash
docker run -d \
-v workspace_dir_host:workspace_dir_container \
-p 6806:6806 \
-e PUID=1001 -e PGID=1002 \
b3log/siyuan \
--workspace=workspace_dir_container \
--accessAuthCode=xxx
```
* `PUID`: カスタムユーザーID（オプション、指定しない場合はデフォルトで `1000`）
* `PGID`: カスタムグループID（オプション、指定しない場合はデフォルトで `1000`）
* `workspace_dir_host`: ホスト上のワークスペースフォルダーのパス
* `workspace_dir_container`: コンテナ内のワークスペースフォルダーのパス、`--workspace` で指定されたものと同じ
* `accessAuthCode`: アクセス認証コード（**必ず変更してください**、そうしないと誰でもデータにアクセスできます）
簡略化するために、ホストとコンテナでワークスペースフォルダーのパスを一致させることをお勧めします。たとえば、`workspace_dir_host` と `workspace_dir_container` の両方を `/siyuan/workspace` に設定します。対応する起動コマンドは次のようになります：
```bash
docker run -d \
-v /siyuan/workspace:/siyuan/workspace \
-p 6806:6806 \
-e PUID=1001 -e PGID=1002 \
b3log/siyuan \
--workspace=/siyuan/workspace/ \
--accessAuthCode=xxx
```
#### Docker Compose
Docker Composeを使用してSiYuanを実行するユーザー向けに、環境変数 `PUID` と `PGID` を使用してユーザーとグループのIDをカスタマイズできます。以下はDocker Composeの設定例です：
```yaml
version: "3.9"
services:
main:
image: b3log/siyuan
command: ['--workspace=/siyuan/workspace/', '--accessAuthCode=${AuthCode}']
ports:
- 6806:6806
volumes:
- /siyuan/workspace:/siyuan/workspace
restart: unless-stopped
environment:
# タイムゾーン識別子のリストは https://en.wikipedia.org/wiki/List_of_tz_database_time_zones を参照してください
- TZ=${YOUR_TIME_ZONE}
- PUID=${YOUR_USER_PUID} # カスタムユーザーID
- PGID=${YOUR_USER_PGID} # カスタムグループID
```
この設定では：
* `PUID` と `PGID` は動的に設定され、コンテナに渡されます
* これらの変数が提供されていない場合、デフォルトの `1000` が使用されます
環境で `PUID` と `PGID` を指定することで、composeファイルで `user` ディレクティブ（`user: '1000:1000'`）を明示的に設定する必要がなくなります。コンテナは起動時にこれらの環境変数に基づいてユーザーとグループを動的に調整します。
#### ユーザー権限
イメージ内で、`entrypoint.sh` スクリプトは指定された `PUID` と `PGID` で `siyuan` ユーザーとグループを作成することを保証します。したがって、ホストがワークスペースフォルダーを作成する際には、フォルダーのユーザーとグループの所有権を設定し、使用する予定の `PUID` と `PGID` に一致させることに注意してください。たとえば：
```bash
chown -R 1001:1002 /siyuan/workspace
```
カスタムの `PUID` と `PGID` 値を使用する場合、エントリポイントスクリプトはコンテナ内で正しいユーザーとグループを作成し、マウントされたボリュームの所有権を適切に調整します。`docker run` または `docker-compose` で `-u` を手動で渡す必要はありません。環境変数がカスタマイズを処理します。
#### 隠しポート
NGINXリバースプロキシを使用してポート6806を隠します。注意点：
* WebSocketリバースプロキシ `/ws` を設定します
#### 注意
* マウントボリュームの正確性を確認してください。そうしないと、コンテナが削除された後にデータが失われます
* URLリライトを使用してリダイレクトしないでください。認証に問題が発生する可能性があるため、リバースプロキシの設定をお勧めします
* 権限の問題が発生した場合、`PUID` と `PGID` 環境変数がホストシステム上のマウントされたディレクトリの所有権と一致していることを確認してください
#### 制限
* デスクトップおよびモバイルアプリケーションの接続はサポートされておらず、ブラウザでの使用のみサポートされています
* PDF、HTML、Word形式へのエクスポートはサポートされていません
* Markdownファイルのインポートはサポートされていません
### Unraid ホスティング
Unraidデプロイメント
注意：最初にターミナルで `chown -R 1000:1000 /mnt/user/appdata/siyuan` を実行します
テンプレートの参考：
```
Web UI: 6806
Container Port: 6806
Container Path: /home/siyuan
Host path: /mnt/user/appdata/siyuan
PUID: 1000
PGID: 1000
Publish parameters: --accessAuthCode=******（アクセス認証コード）
```
### インサイダープレビュー
主要な更新前にインサイダープレビューをリリースします。詳細は[https://github.com/siyuan-note/insider](https://github.com/siyuan-note/insider)をご覧ください。
## 🏘️ コミュニティ
* [英語ディスカッションフォーラム](https://liuyun.io)
* [ユーザーコミュニティのまとめ](https://liuyun.io/article/1687779743723)
* [Awesome SiYuan](https://github.com/siyuan-note/awesome)
## 🛠️ 開発ガイド
[開発ガイド](https://github.com/siyuan-note/siyuan/blob/master/.github/CONTRIBUTING.md)をご覧ください。
## ❓ FAQ
### SiYuanはどのようにデータを保存しますか？
データはワークスペースフォルダーに保存され、ワークスペースデータフォルダーに保存されます：
* `assets` はすべての挿入されたアセットを保存するために使用されます
* `emojis` は絵文字画像を保存するために使用されます
* `snippets` はコードスニペットを保存するために使用されます
* `storage` はクエリ条件、レイアウト、フラッシュカードなどを保存するために使用されます
* `templates` はテンプレートスニペットを保存するために使用されます
* `widgets` はウィジェットを保存するために使用されます
* `plugins` はプラグインを保存するために使用されます
* `public` は公開データを保存するために使用されます
* 残りのフォルダーはユーザーが作成したノートブックフォルダーであり、ノートブックフォルダー内の `.sy` サフィックスのファイルはドキュメントデータを保存するために使用され、データ形式はJSONです
### サードパーティの同期ディスクを介したデータ同期をサポートしていますか？
サードパーティの同期ディスクを介したデータ同期はサポートされていません。そうしないとデータが破損する可能性があります。
サードパーティの同期ディスクをサポートしていない場合でも、サードパーティのクラウドストレージと接続することはサポートされています（会員特典）。
また、データのエクスポートとインポートを手動で行うことでデータ同期を実現することもできます：
* デスクトップ：設定 - エクスポート - データのエクスポート / データのインポート
* モバイル：右カラム - 情報 - データのエクスポート / データのインポート
### SiYuanはオープンソースですか？
SiYuanは完全にオープンソースであり、貢献を歓迎します：
* [ユーザーインターフェースとカーネル](https://github.com/siyuan-note/siyuan)
* [Android](https://github.com/siyuan-note/siyuan-android)
* [iOS](https://github.com/siyuan-note/siyuan-ios)
* [harmony](https://github.com/siyuan-note/siyuan-harmony)
* [Chromeクリッピング拡張](https://github.com/siyuan-note/siyuan-chrome)
詳細については[開発ガイド](https://github.com/siyuan-note/siyuan/blob/master/.github/CONTRIBUTING.md)をご覧ください。
### 新しいバージョンにアップグレードするにはどうすればよいですか？
* アプリストアからインストールした場合は、アプリストアから更新してください
* デスクトップでインストールパッケージを使用してインストールした場合は、設定 - 情報 - 自動的に更新インストールパッケージをダウンロード オプションを開くことができます。これにより、SiYuanは最新バージョンのインストールパッケージを自動的にダウンロードし、インストールを促します
* 手動でインストールパッケージを使用してインストールした場合は、再度インストールパッケージをダウンロードしてインストールしてください
設定 - 情報 - 現在のバージョン で 更新を確認 できます。また、[公式ダウンロード](https://b3log.org/siyuan/en/download.html) または [GitHub Releases](https://github.com/siyuan-note/siyuan/releases) をフォローして新しいバージョンを入手することもできます。
### 一部のブロック（リスト項目内の段落ブロックなど）がブロックアイコンを見つけられない場合はどうすればよいですか？
リスト項目の最初のサブブロックはブロックアイコンが省略されています。このブロックにカーソルを移動し、Ctrl+/ を使用してそのブロックメニューをトリガーできます。
### データリポジトリキーを紛失した場合はどうすればよいですか？
* データリポジトリキーが以前に複数のデバイスで正しく初期化されている場合、キーはすべてのデバイスで同じであり、設定 - 情報 - データリポジトリキー - キー文字列をコピー で見つけることができます
* 以前に正しく構成されていない場合（たとえば、複数のデバイスでキーが一致しない場合）またはすべてのデバイスが使用できず、キー文字列を取得できない場合は、以下の手順でキーをリセットできます：
1. データを手動でバックアップします。データのエクスポート を使用するか、ファイルシステム上で ワークスペース/data/ フォルダーをコピーします
2. 設定 - 情報 - データリポジトリキー - データリポジトリをリセット
3. データリポジトリキーを再初期化します。1台のデバイスでキーを初期化した後、他のデバイスでキーをインポートします
4. クラウドは新しい同期ディレクトリを使用します。古い同期ディレクトリは使用できなくなり、削除できます
5. 既存のクラウドスナップショットは使用できなくなり、削除できます
### 支払いが必要ですか？
ほとんどの機能は無料で、商業利用も可能です。
会員特典は支払い後にのみ利用可能です。詳細については[価格](https://b3log.org/siyuan/en/pricing.html)をご覧ください。
## 🙏 謝辞
SiYuanの誕生は、多くのオープンソースプロジェクトと貢献者なしでは実現できませんでした。プロジェクトのソースコード kernel/go.mod、app/package.json、およびプロジェクトのホームページをご覧ください。
SiYuanの成長は、ユーザーのフィードバックとプロモーションなしでは実現できませんでした。SiYuanへのすべての支援に感謝します ❤️
### 貢献者
私たちに参加し、一緒にSiYuanにコードを貢献することを歓迎します。
