Saberのソースを表示

[[Category:メモ作成ソフトウェア]]
{{Related articles start}}
{{Related|Xournal++}}
{{Related articles end}}
Saber は、[https://github.com/adil192/saber/blob/main/LICENSE.md GPLv3.0] の下でライセンスされたオープンソースのクロスプラットフォームの手書きメモアプリです。

== インストール ==

{{Warning|Flutter のガイドラインはまだ作成中( [[User:Gromit/Flutter package guidelines]])です。多くの Flutter パッケージのビルドに関連する問題が見つかり、手動での介入が必要です。AUR ヘルパーを使用すると、''saber'' のビルドおよびインストールがほとんど失敗する可能性があります。}}

{{AUR|saber}} パッケージを[[インストール]]してください。''saber'' パッケージを正常にビルドする手順については、[[#Building]] を参照してください。

{{Note|Saber パッケージは、現在、Flutter のビルドの問題のため古いままであり、修正されるまでパッケージを更新することはできません。}}

{{Tip|メンテナの非公式リポジトリ、[[非公式ユーザーリポジトリ#PolarRepo]] を通じて saber をインストールすることもできます。ただし、非公式リポジトリは Arch Linux によってサポートされていないため、自己責任で使用する必要があります。非公式リポジトリからインストールすることで、[[#Building]] を省略し、ビルド済みパッケージを直接インストールすることができます。}}

=== ビルド ===

Flutter に関連する問題のため、''saber'' のパッケージのビルドには手動での介入が必要です。

{{Note|以下のコマンドは、パッケージをビルドするユーザーによって実行される '''必要があります'''。そうでない場合、パッケージのビルドは失敗します。}}

# {{AUR|flutter}} と {{Pkg|rustup}} を[[インストール]]します。
# Flutter がエラーをスローするのを防ぐため、安定版のツールチェーンをデフォルトとして設定します。
#: {{bc|$ rustup default stable}}
# Arch Linux 上の既知の Flutter の問題を修正します。
#: {{bc|$ git config --global --add safe.directory /opt/flutter}}
#: 詳細については、[[User:Gromit/Flutter package guidelines#Ownership problems, or permission denial]] を参照してください。

== Configuration ==

''Saber'' is a [[Wikipedia:graphical user interface|graphical User Interface (GUI)]], all configuration is done via the settings menu on the left sidebar.

=== Integration with nextcloud ===

Saber provides an integration with [[nextcloud]] to allow synchronisation of notes between multiple devices. It also provides redundancy which removes the worry of notes being lost due to device failure.

By default, Saber is configured to use [https://nc.saber.adil.hanney.org saber's official instance] provided by the upstream developer [https://adil.hanney.org/ Adil Hanney].

==== Using the default nextcloud instance ====

* [https://nc.saber.adil.hanney.org/index.php/apps/registration/ Register an account] (if you have not done so already)
* Open the ''Settings'' menu on the right toolbar (settings icon)
* Click the ''Logged out'' widget at the top of the settings page, this will bring you to the ''Login'' page
* Enter the email address and password you used when you registered your account, the encryption password should be a password unique to you, which will only be stored on your client, this is used as a key to encrypt and decrypt the notes you write for privacy, you must remember this otherwise you will not be able to decrypt your notes on other devices.

{{Note|By registering an account and logging in from the saber app, you agree to the saber privacy policy [https://github.com/adil192/saber/blob/main/privacy_policy.md]}}

==== Using a third party nextcloud instance ====

Nextcloud has multiple [https://github.com/nextcloud/providers#providers providers] which you can pick from, or use a provider which is not listed here.

Saber's official nextcloud instance is stock and contains no modifications to the API, allowing you to use any provider which has not modified nextcloud's protocol.

To use a third party nextcloud provider, register an account on the corresponding web interface, and then follow the same login instructions in [[#Using the default nextcloud instance]], ensure to check the ''I want to use a Custom Nextcloud Server'' box, and then enter the providers url in the ''Custom server URL'' box, otherwise you will not be able to authenticate.

{{Note|Using a third party nextcloud instance means you must agree to their terms of service and privacy policy, along with the privacy policy from upstream.}}

==== Self hosting a nextcloud instance ====

If you would like to self host the nextcloud instance for saber, follow the installation guide [[Nextcloud#Installation]] and then the setup/configuration guide [[Nextcloud#Configuration]].

After your instance is setup, create yourself a user and follow the same login instructions in [[#Using the default nextcloud instance]], ensure you check ''I want to use a Custom Nextcloud Server'', and enter the url of your nextcloud instance in the ''Custom server URL'' box.