Enable CLI language-aware editing and reuse OIDC authentication
This commit is contained in:
1 parent
5821254535
commit
93f4ecb8f4
11 files changed
+264
-84
No files matched your search
+25
-8
@@ -48,8 +48,10 @@ pages login --oidc --no-browser
|
||||
|
||||
CLIに表示されたURLを手元のPC/スマホで開き、OIDCでログインします。
|
||||
続いてアカウント・接続先を確認し、ターミナルの確認コードを入力して承認します。
|
||||
ローカルTOTPを設定済みならTOTPも必要です。承認後はCLIが専用セッションを受け取ります。
|
||||
OIDCで認証した場合は、追加のローカルTOTPを要求しません。承認後はCLIが専用セッションを受け取ります。
|
||||
OIDCプロバイダーのパスワードやトークンをターミナルに入力する必要はありません。
|
||||
プロバイダー側のMFAポリシーはそのまま適用されます。パスワードログイン時のローカルTOTPも変更しません。
|
||||
この追加TOTP省略はv0.3.0より後の変更です。v0.3.0のサーバーでは従来どおりTOTPを要求します。
|
||||
|
||||
ユーザー名の指定は省略できます。指定済みならブラウザで認証したユーザーとの一致を確認し、
|
||||
不一致時は発行セッションの失効を試みて保存しません。`pages logout` 後に設定を変更できます。
|
||||
@@ -66,7 +68,7 @@ configureの接続先URLを確認し、サーバーも対応版へ更新して
|
||||
|
||||
```sh
|
||||
pages configure # 設定を表示(トークンは表示しない)
|
||||
pages configure --lang ja # 現在の既定接続の編集言語
|
||||
pages configure --lang auto # 表示対象の言語版を編集
|
||||
pages configure list # 接続先一覧、★が既定
|
||||
pages configure set --profile work --origin https://work.example.test --username anya --lang en
|
||||
pages configure use work # 以後はworkを指定不要
|
||||
@@ -74,11 +76,13 @@ pages status
|
||||
pages edit /guide
|
||||
```
|
||||
|
||||
既定プロファイル名は `default`、既定言語は `und`(言語未指定)です。OSや表示言語から
|
||||
書き込み先の言語を推測しません。最初に名前付きプロファイルを作った場合はそれを既定とします。
|
||||
言語は接続先ごとに保持し、編集時はその言語の既存Revisionを使用します。
|
||||
既定プロファイル名は `default`、新しいプロファイルの既定言語は `auto` です。
|
||||
`auto` はサーバーが通常表示するRevisionの言語を取得し、その言語の最新版を編集します。
|
||||
OSの言語からは推測しません。最初に名前付きプロファイルを作った場合はそれを既定とします。
|
||||
言語は接続先ごとに保持します。既存設定の `und`(言語未指定)や `ja` は自動変更しません。
|
||||
以前のCLIで設定済みの場合は `pages configure --lang auto` で切り替えられます。
|
||||
|
||||
一度だけ変更したいときは `pages --profile personal --lang ja edit /guide` も使えます。
|
||||
一度だけ変更したいときは `pages edit /guide --lang auto`、`pages --profile personal --lang ja edit /guide` も使えます。
|
||||
プロファイル自体は先にconfigureで登録します。引数の上書きは設定ファイルを書き換えません。
|
||||
|
||||
設定ファイルは `~/.config/pages-cli/config.json`(`XDG_CONFIG_HOME`対応)。
|
||||
@@ -91,7 +95,7 @@ pages edit /guide
|
||||
"default": {
|
||||
"origin": "https://pages.example.test",
|
||||
"username": "anya",
|
||||
"lang": "und"
|
||||
"lang": "auto"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -122,7 +126,20 @@ pages edit /guide
|
||||
`pages --help`、`pages configure --help`、`pages edit --help` で引数を確認できます。
|
||||
Tab補完、上下キーのプロセス内履歴に対応。複雑な引用位置の補完、Ctrl+Pのfuzzy UIは後続です。
|
||||
|
||||
初期版は既存Page・既存言語の更新まで。新規作成、バイナリ更新は未実装です。
|
||||
### 言語を指定して編集する
|
||||
|
||||
```sh
|
||||
pages edit /guide --lang auto # 表示される言語の最新版を編集
|
||||
pages edit /guide --lang ja # 日本語版。未作成なら既存内容から開始
|
||||
pages edit /guide --lang en # 英語版。未作成なら既存内容から開始
|
||||
```
|
||||
|
||||
編集開始時に対象言語を表示します。指定言語のRevisionがない場合は、表示中の版の内容を
|
||||
下書きとして `$EDITOR` を開き、変更を保存するとその言語の最初のRevisionを作ります。
|
||||
自動翻訳ではありません。元の言語版は変更せず、編集せずに閉じた場合は何も作成しません。
|
||||
同じ言語版が先に作成された場合も、競合として保存を止めます。
|
||||
|
||||
対応範囲は既存Pageの更新と新規言語版の作成です。新規Path/Page作成、バイナリ更新は未実装です。
|
||||
競合や通信断で自動上書きせず、ローカル原稿を保持します。HTTPS必須(開発用loopbackのみHTTP可)。
|
||||
詳しいURI・保存・安全性の契約は[設計書](../docs/design/ja/remote-cli.md)を参照してください。
|
||||
|
||||
|
||||
Reference in new issue
Block a user