元木です。 コメントも考慮した現時点のバージョンは以下です。 https://amotoki.github.io/jm/basic_info.html > いっそのこと、ssh プロトコルについては書かないことにしましょうか。その場合は、 > 公開鍵の話も要らなくなりますし、プロトコルの説明も要らなくなるでしょう。 > > あるいは、上の文案の公開鍵の部分は残して、ssh プロトコルの例だけ消しても > よいかもしれません。 > > また、面倒なことをお願いして恐縮です。元木さんがよいとお考えになるように > 直しておいてください。 現在の「ローカルリポジトリでした変更を JM の共有ディレクトリに (ssh で) 書き込むには、 公開鍵を作成して、osdn に登録しておく必要があります。その方法については、 https://ja.osdn.net/docs/Register_PublicKey をご覧になってください。」は 「(ssh で) 」以外は長南さんの元の提案を尊重して記載しているものです。 私自身はこの段落をブラッシュアップすること自体に興味がないので、 まずはこの段落を削除してコミットすることでいいでしょうか？ この段落がなけらば、 ssh プロトコルに依存した部分はなくなります。 元の案には、ssh プロトコルの場合のホスト名の変更の話がありましたが、 実際には単にホスト名を追加すればいいのは、ローカルのユーザー名と osdn.net のユーザー名が 同じ人だけで、ユーザー名を追加するなども必要なので、 「URL は https://osdn.net/projects/linuxjm/scm/git/jm/ で確認してください。」に変更しています。 現在の私は過去の経緯で文書の更新につきあっているだけなので、 早くそれを決着させたいだけです。 以下、マイナー部分はインラインでコメントします。 On Sat, Apr 10, 2021 at 3:23 PM 長南洋一 <cyoic****@maple*****> wrote: > > 長南です。 > > ちょっと確認したいことがあって、"git clone ssh://...." をやったところ、 > またまた自分の間違いに気づいてしまいました。大ドジです。 > > 念を押しますが、プロトコルに https を使う場合は、"git push" するときも、 > 公開鍵の登録は必要ないのですね。そうだとすると...。 > > ssh プロトコルでは、clone にも pull にも push にもパスフレーズの > 入力が必要です。つまり、公開鍵の登録が必要なのは、「JM の共有リポジトリに > 書き込む」ときばかりではありません。ssh プロトコルで git リポジトリを > 使うなら、必ず必要なわけです。ですから、「ローカルリポジトリでした変更を > JM の共有リポジトリに (ssh で) 書き込むには」以下は、たとえば、 > こんなふうに書かなければならないところでした。 > > なお、プロトコルに ssh を使う場合は、公開鍵を作成して、 > osdn に登録しておく必要があります。その方法については、 > https://ja.osdn.net/docs/Register_PublicKey > をご覧になってください。 > > また、プロトコル ssh で "git clone" するなら、URL の前にログイン名を > 付けなければなりません。ですから、プロトコル ssh の場合をきちんと説明 > するなら、こんなふうになります。続き具合が分かりやすいように、その部分を > 全部書き出しておきます。 > > しかし、プロジェクトの管理はもちろん、LDP man-pages や GNU_coreutils > のマニュアルの翻訳と管理、それにガイドドキュメントの執筆・編集をするには、 > JM のリポジトリをローカルにコピーしておく必要があります。それには、 > git コマンドを使って、リポジトリの clone をします。 > > # 「翻訳や管理」を「翻訳と管理」に換えてみました。大した違いはないでしょうが。 正直違うがよく分かりませんでした。 まずは今の文案で登録して必要なら更新してもらえないでしょうか。 自分の印象だと、「や」は "or" のニュアンスが強く、「と」だと "and" のニュアンスが 強いくらいでしょうか。ここは and/or みたいに書くケースかもしれませんが。 「翻訳」と「管理」はどちらかに興味がある人が多いと思うので、 「や」でいいような気もしまうｓ． > git のプロトコルには、読み出し専用なら、git と http が使えます。 > 読み書き両用には、https か ssh を使用します。たとえば、プロトコルに https > を使用する場合のコマンドは、次のようになります。 > > # https と ssh の順番を逆にし、「たとえば」を入れています。 > > $ git clone https://scn.osdn.jp/linuxjm/jm.git > > こうすると、カレントディレクトリの jm/ というディレクトリ以下に > JM のローカルリポジトリが作られます。 「たとえば」は入れておいた方が文章として正確なので、 このニュアンスを反映しておきます。 > ssh プロトコルの場合は、次のように指定します。URL の部分が少し違うことに > 注意してください。 > > $ git clone ssh://<ログイン名>@git.osdn.jp/linuxjm/jm.git > > なお、プロトコルに ssh を使う場合は、公開鍵を作成して、osdn に登録して > おく必要があります。その方法については、 > https://ja.osdn.net/docs/Register_PublicKey > をご覧になってください。 > > 両方書いておくのは、うるさいかもしれません。ssh プロトコルによる > git については、osdn のヘルプドキュメントに適当な説明があれば、 > そのリンクを書いてすまそうと思って、捜したのですが、見つかりませんでした > (sourceforge のころは、確か "Developer Access (Read/Write)" > とかいう英文の文書があったのです。私はそれを読んで、"git clone" の > 書式を知ったはずですから)。 > > いっそのこと、ssh プロトコルについては書かないことにしましょうか。その場合は、 > 公開鍵の話も要らなくなりますし、プロトコルの説明も要らなくなるでしょう。 > > あるいは、上の文案の公開鍵の部分は残して、ssh プロトコルの例だけ消しても > よいかもしれません。 > > また、面倒なことをお願いして恐縮です。元木さんがよいとお考えになるように > 直しておいてください。 > > 私が間違えたところは、ほかにないでしょうね。かなり不安です。 > > -- > 長南洋一 > > _______________________________________________ > linuxjm-discuss mailing list > linux****@lists***** > https://lists.osdn.me/mailman/listinfo/linuxjm-discuss
Fork