From 6f3b160976884ec6b22b0178427cc71fa3c22296 Mon Sep 17 00:00:00 2001 From: Aneesh Dighe <98216256+aneeshd27@users.noreply.github.com> Date: Mon, 13 Nov 2023 11:36:31 +0530 Subject: [PATCH] Added Japanese Translation of 3 md files (japanese review requested) (#9966) * Added Japanese Translation of 3 md files * Chnaged filename jp to ja * Added Japanese Translation after review * Made Changes after Review * Update README.md removed Japanese contributing files information I was having a resolve conflict for docs/README.md which is supposedly has access to the writers of the repository.Made this change as my pull request has been blocked * Update README.md by adding links for Japanese Translation I have added the links of the contributed files for the Japanese translation.Thank you. --------- Co-authored-by: Eric Hellman --- docs/CODE_OF_CONDUCT-ja.md | 46 +++++++ docs/CONTRIBUTING-ja.md | 271 +++++++++++++++++++++++++++++++++++++ docs/HOWTO-ja.md | 34 +++++ docs/README.md | 3 + 4 files changed, 354 insertions(+) create mode 100644 docs/CODE_OF_CONDUCT-ja.md create mode 100644 docs/CONTRIBUTING-ja.md create mode 100644 docs/HOWTO-ja.md diff --git a/docs/CODE_OF_CONDUCT-ja.md b/docs/CODE_OF_CONDUCT-ja.md new file mode 100644 index 000000000..fee634875 --- /dev/null +++ b/docs/CODE_OF_CONDUCT-ja.md @@ -0,0 +1,46 @@ +# 貢献者の行動規範 + + +ドキュメントの更新、プルリクエストやパッチの提出、その他の活動を通じて貢献するすべての人々を尊重することを誓います。 + +私たちは、このプロジェクトへの参加をハラスメントのないものにすることを約束します。 +経験、性別、性自認、性表現、性的指向、障害の有無にかかわらず、すべての人にとってハラスメントのないプロジェクトにすることを約束します。 +アイデンティティと表現、性的指向、身体障害、容姿、体格、人種、民族性 +体格、人種、民族性、年齢、宗教、国籍に関係なく、このプロジェクトに参加するすべての人にハラスメントのない経験を提供することを約束します。 + +参加者による容認できない行為の例としては、以下が挙げられる： + +* 性的な言葉やイメージの使用 +* 個人攻撃 +* 荒らしや侮辱的/中傷的なコメント +* 公的または私的な嫌がらせ +* 明示的な許可なく、物理的または電子的な住所など、他人の個人情報を公開すること。 + 明示的な許可なく、他人の住所を公開すること。 +* その他の非倫理的または非プロフェッショナルな行為 + +プロジェクトメンテナには、以下を削除、編集、拒否する権利と責任があります。 +コメント、コミット、コード、ウィキ編集、課題、その他の貢献を拒否する権利があります。 +この行動規範に沿わない投稿を削除、編集、拒否する権利があります。 +また、不適切と判断されるその他の行為について、投稿者を一時的または恒久的に追放することがあります、 +を一時的または恒久的に禁止することができます。 + +この行動規範を採用することで、プロジェクトのメンテナーは以下のことを約束します。 +することを約束するものとします。この行動規範に従わない、あるいは強制しないプロジェクトメンテナは、プロジェクトメンテナから永久に解任されることがあります。 +行動規範に従わないプロジェクトメンテナは、プロジェクトチームから永久に排除される可能性があります。 + +この行動規範は、プロジェクト空間内および公共の場の両方に適用されます。 +個人がプロジェクトやそのコミュニティを代表しているときに適用されます。 + +虐待、嫌がらせ、またはその他の容認できない行為が発生した場合は、以下の連絡先情報に報告してください。 +プロジェクト管理者 victorfelder (gmail.com) までご連絡ください。全て +すべての苦情は検討および調査され、その結果、状況に応じて必要かつ適切とみなされる措置が講じられます。 +必要かつ適切であると認められます。メンテナーは、 +記者には秘密を守る義務があります。 +守らなければなりません。 + +この行動規範は、[貢献者規約][ホームページ]から引用したものです、 +バージョン1.3.0（https://contributor-covenant.org/version/1/3/0/）から引用したものです。 + +[ホームページ]: https://contributor-covenant.org + +[翻訳](README.md#translations) \ No newline at end of file diff --git a/docs/CONTRIBUTING-ja.md b/docs/CONTRIBUTING-ja.md new file mode 100644 index 000000000..d82e3aeb9 --- /dev/null +++ b/docs/CONTRIBUTING-ja.md @@ -0,0 +1,271 @@ +*他の言語で読む](README.md#translations)*。 + + +## 投稿者ライセンス契約 + +投稿することで、あなたはこのリポジトリの [LICENSE](../LICENSE) に同意したことになります。 + + +## 投稿者の行動規範 + +貢献することで、あなたはこのリポジトリの[行動規範](CODE_OF_CONDUCT.md)を尊重することに同意します。([翻訳](README.md#translations)) + + +## 一言で言えば + +1. 「本を簡単にダウンロードできるリンク」は、必ずしも*無料*の本へのリンクとは限りません。無料のコンテンツだけを投稿してください。無料であることを確認してください。私たちは、本を入手するために作業用メールアドレスを要求*するページへのリンクは受け付けませんが、要求するリストは歓迎します。 + +2. 2.Gitを知らなくてもかまいません。このレポに*まだ*入っていない*興味深いものを見つけたら、リンクの提案を添えて[Issue](https://github.com/EbookFoundation/free-programming-books/issues)を開いてください。 + - Gitを知っているなら、レポをフォークして、プルリクエスト（PR）を送ってください。 + +3. リストには6種類あります。適切なものを選んでください： + + - 書籍* ： 本* : PDF、HTML、ePub、gitbook.ioベースのサイト、Gitレポなど。 + - コース* ： コースは、本ではない学習教材です。[これはコースです](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/)。 + - インタラクティブなチュートリアル ユーザーがコードやコマンドを入力し、その結果を評価する（「評価する」というのは「採点する」という意味ではない）インタラクティブなウェブサイト： [Haskellを試す](http://tryhaskell.org)、[Gitを試す](https://learngitbranching.js.org)。 + - Playgrounds*：プログラミング学習のためのオンラインかつインタラクティブなウェブサイト、ゲーム、またはデスクトップソフトウェアです。コードの断片を書いたり、コンパイル（または実行）したり、共有したりすることができる。プレイグラウンドでは多くの場合、フォークしてコードで遊んで手を汚すことができます。 + - ポッドキャストとスクリーンキャスト* ： ポッドキャストとスクリーンキャスト。 + - 問題集と競技プログラミング* ： 簡単な問題や複雑な問題を解くことで、自分のプログラミング・スキルを評価することができるウェブサイトやソフトウェア。 + +4. 以下のガイドライン](#guidelines)を必ず守り、ファイルの[Markdown][フォーマット](#formatting)を尊重してください。 + +5. GitHub Actionsは、**リストがアルファベット順に並んでいるか**、**フォーマットルールが守られているか**を確認するためのテストを実行します。**必ず**テストに合格していることを確認してください。 + + +### ガイドライン + +- 本が無料であることを確認する。必要であればダブルチェックしてください。なぜその本が無料だと思うのか、PRにコメントしていただけると管理者が助かります。 +- Google Drive、Dropbox、Mega、Scribd、Issuu、その他類似のファイルアップロードプラットフォームでホストされているファイルは受け付けません。 +- 下記](#alphabetical-order)のように、アルファベット順にリンクを挿入してください。 +- 最も権威のあるソース（編集者のウェブサイトよりも著者のウェブサイト、第三者のウェブサイトよりも著者のウェブサイトの方が良いという意味）のリンクを使用してください。 + - ファイルホスティングサービスは使用しない（DropboxやGoogle Driveのリンクがこれに該当します。 +- 同じドメインにあり、同じコンテンツを提供するのであれば、`http`のリンクよりも`https`のリンクの方が常に好ましい。 +- ルートドメインでは、末尾のスラッシュを取り除く：`http://example.com/`の代わりに`http://example.com`。 +- 常に最短のリンクを選ぶ： http://example.com/dir/index.html`よりも`http://example.com/dir/`の方がよい。 + - URL短縮リンクは使わない +- 通常、"バージョン "リンクよりも "最新 "リンクを好む： `http://example.com/dir/book/v1.0.0/index.html` よりも `http://example.com/dir/book/current/` の方がよい。 +- リンクに期限切れの証明書、自己署名証明書、SSL問題などがある場合： + 1. *1.可能であれば、`http`に置き換える*（モバイルデバイスでは例外を受け入れるのが複雑になる可能性があるため）。 + 2. *ブラウザに例外を追加するか、警告を無視することで、`http` バージョンが利用できなくても、リンクが `https` 経由でアクセスできる場合は、そのままにしておく。 + 3. *そうでない場合は削除する。 +- リンクが複数のフォーマットで存在する場合、それぞれのフォーマットについての注意書きを添えて別のリンクを追加する。 +- リソースがインターネット上のさまざまな場所に存在する場合 + - 最も権威のあるソースのリンクを使用する（第三者のウェブサイトよりも編集者のウェブサイトよりも著者のウェブサイトがよいという意味）。 + - 異なるエディションへのリンクがあり、それらのエディションが保持する価値があるほど異なると判断される場合、それぞれのエディションについての注釈とともに別のリンクを追加する（フォーマットに関する議論に貢献するために、[Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353)を参照してください）。 +- より大きなコミットよりもアトミックなコミット（追加/削除/変更で1回のコミット）を優先します。PRを提出する前にコミットをつぶす必要はありません。(このルールは単なるメンテナの利便性の問題なので、私たちは決して強制しません) +- もしその本が古いものであれば、タイトルと一緒に出版日を書いてください。 +- 適切な場合には、著者名を含めてください。著者リストは"`et al.`"で短縮できます。 +- 本が完成しておらず、まだ作業中である場合は、[下記](#in_process)のように「`in process`」の表記を加えてください。 +- リソースが[*Internet Archive's Wayback Machine*](https://web.archive.org)(または同様のもの)を使って復元された場合は、[下記](#archived)のように"`archived`"表記を追加してください。使用するのに最適なバージョンは、最近の完全なものです。 +- ダウンロードを有効にする前に、メールアドレスやアカウントの設定が必要な場合は、括弧の中に言語に適した注釈を追加してください： メールアドレスは必須ではありません。 + + +### フォーマット + +- すべてのリストは `.md` ファイルです。[Markdown](https://guides.github.com/features/mastering-markdown/)の構文を覚えてください。簡単です！ +- すべてのリストはインデックスから始まります。そこですべてのセクションとサブセクションをリストアップし、リンクすることです。アルファベット順にしてください。 +- セクションはレベル3の見出し (`###`) を使い、サブセクションはレベル4の見出し (`###`) を使います。 + +アイデアとしては + +- 最後のリンクと新しいセクションの間は2行空ける。 +- 見出しとそのセクションの最初のリンクの間に`1`の空行。 +- 2つのリンクの間に`0`の空行。 +- 各`.md`ファイルの末尾に`1`の空行。 + +例 + +テキスト +[...] +* 素晴らしい本(http://example.com/example.html) + (空行) + (空白行) +### 例 + (空白行) +* 別のすごい本(http://example.com/book.html) +* その他の本(http://example.com/other.html) +``` + +- と`の間にスペースを入れないでください： + + テキスト + BAD ： * [Another Awesome Book] (http://example.com/book.html) + GOOD： * [Another Awesome Book](http://example.com/book.html) + ``` + +- 著者を含める場合は、` - `（ダッシュを半角スペースで囲む）を使用する： + + テキスト + BAD ： * [Another Awesome Book](http://example.com/book.html)- John Doe + GOOD： * [Another Awesome Book](http://example.com/book.html) - John Doe + ``` + +- リンクとその形式の間に半角スペースを入れる： + + テキスト + BAD ： * [とても素晴らしい本](https://example.org/book.pdf)(PDF) + GOOD： * [とても素晴らしい本](https://example.org/book.pdf) (PDF) + ``` + +- 著者はフォーマットの前に来る： + + テキスト + BAD ： * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) ジェーン・ロー + GOOD： * [A Very Awesome Book](https://example.org/book.pdf) - ジェーン・ロー (PDF) + ``` + +- 複数のフォーマット（各リソースには1つのリンクが望ましい。When there is no single link with easy access to different formats, multiple links may make sense. But every link we add creates maintenance burden so we try to avoid it.: + + ```text + BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML) + BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site) + GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) + ``` + +- Include publication year in title for older books: + + ```text + BAD : * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970 + GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe + ``` + +- In-process books: + + ```text + GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) + ``` + +- Archived link: + + ```text + GOOD： * [ウェイバックされた面白い本](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* + ``` + +### アルファベット順 + +- 同じ文字で始まるタイトルが複数ある場合は、2番目から順に並べる。例：`aa`は`ab`の前。 +- one two`は`onetwo`の前。 + +リンクがずれている場合は、リンターのエラーメッセージを確認して、どの行を入れ替えるべきか確認してください。 + + +### 注意事項 + +基本は比較的シンプルですが、掲載するリソースには非常に多様性があります。ここでは、この多様性にどのように対処するかについて、いくつか注意点を示します。 + + +#### メタデータ + +タイトル、URL、作成者、プラットフォーム、アクセスノート。 + + +##### タイトル + +- 創作タイトルはありません。投稿者は、避けられるのであれば、タイトルを捏造したり、編集的に使用したりしないよう勧められます。古い作品については例外で、主に歴史的な興味を引くものであれば、タイトルに括弧書きで年号を付記することで、利用者が興味を引くものであるかどうかを知ることができます。 +- ALLCAPSタイトルは使わない。通常、タイトルの大文字と小文字の区別は適切ですが、疑問がある場合は、出典元の大文字と小文字の区別を使用してください。 +- 絵文字は使わない。 + + +##### URL + +- 短縮URLは許可しません。 +- トラッキングコードはURLから削除してください。 +- 国際URLはエスケープしてください。ブラウザバーは通常これらをユニコードにレンダリングしますが、コピー＆ペーストを使用してください。 +- HTTPSが実装されている場合、セキュア（`https`）なURLは常に非セキュア（`http`）なURLよりも優先されます。 +- 私たちは、リストされたリソースをホストしていないウェブページを指すURLは好みません。 + + +##### クリエイター + +- 私たちは、翻訳者を含め、適切な場合、フリーリソースの作成者をクレジットしたいと思います！ +- 翻訳された作品については、原著者がクレジットされるべきです。この例のように、著者以外のクリエイターをクレジットするには、[MARC relators](https://loc.gov/marc/relators/relaterm.html)を使うことをお勧めします： + + マークダウン + * 翻訳本](http://example.com/book.html) - John Doe, `trl.:` Mike The Translator + ``` + + この例では、`trl.:`という注釈にMARCのリレータコードを使用しています。 +- コンマ`,`で著者リストの各項目を区切ります。 +- 著者リストは"`et al.`"で短縮できます。 +- クリエイターへのリンクは許可しません。 +- コンピレーションやリミックス作品の場合、"creator "には説明が必要な場合があります。例えば、"GoalKicker "や "RIP Tutorial "の本は、"`Compiled from StackOverflow documentation`"とクレジットされます。 +- 「Prof.」や「Dr.」のような敬称はクリエイター名に含めません。 + + +###期間限定のコースとトライアル + +- 6ヶ月以内に削除する必要のあるものは掲載しません。 +- コースの受講期間や期間が限定されている場合、掲載しません。 +- 期間限定の無料リソースを掲載することはできません。 + + +##### プラットフォームとアクセスノート + +- コース。特にコースリストでは、プラットフォームはリソース説明の重要な部分です。なぜなら、コースのプラットフォームには異なるアフォーダンスとアクセスモデルがあるからです。通常、登録が必要な書籍はリストアップしませんが、多くのコースプラットフォームは何らかのアカウントがないと利用できないようになっています。コースプラットフォームの例として、Coursera、EdX、Udacity、Udemyが挙げられます。コースがプラットフォームに依存している場合、プラットフォーム名を括弧内に記載する必要があります。 +- YouTube。YouTubeプレイリストで構成されたコースが多数あります。YouTubeをプラットフォームとして記載するのではなく、YouTubeクリエータを記載するようにしています。 +- YouTubeの動画。私たちは通常、1時間以上の長さがあり、コースやチュートリアルのように構成されていない限り、個々のYouTubeビデオにリンクしません。その場合は、PRの説明文に必ずその旨を明記してください。 +- 短縮リンク（例：youtu.be/xxxx）は禁止！ +- Leanpub. Leanpubは様々なアクセスモデルの書籍をホストしています。登録なしで読める本もあれば、無料アクセスのためにLeanpubアカウントが必要な本もある。書籍の品質とLeanpubのアクセスモデルの混合性と流動性を考慮し、後者についてはアクセスノート`*(Leanpubアカウントまたは有効な電子メールが必要です)*`の掲載を許可しています。 + + +#### ジャンル + +リソースがどのリストに属するかを決める最初のルールは、リソースが自分自身をどのように説明しているかを見ることです。自らを本と呼ぶのであれば、それは本なのかもしれません。 + + +##### リストに載せないジャンル + +インターネットは広大なため、リストには含めません： + +- ブログ +- ブログ記事 +- 記事 +- ウェブサイト（私たちがリストアップしている多くの項目をホストしているものを除く）。 +- コースやスクリーンキャスト以外のビデオ +- 本の章 +- 本のティーザー・サンプル +- IRCまたはTelegramチャンネル +- Slacksやメーリングリスト + +私たちの競争的なプログラミング・リストは、これらの除外についてそれほど厳密ではありません。レポジトリのスコープはコミュニティによって決定されます。スコープの変更や追加を提案したい場合は、issueを使って提案してください。 + + +##### 本とその他のもの + +私たちは、本であることにそれほどこだわっていません。以下は、リソースが本であることを示すいくつかの属性です： + +- ISBN（国際標準図書番号）がある。 +- 目次がある +- ダウンロード版、特にePubファイルが提供されている。 +- エディションがある +- インタラクティブコンテンツやビデオに依存していない。 +- トピックを包括的にカバーしようとしている +- 自己完結している + +私たちがリストアップする書籍の中には、これらの属性を持たないものもたくさんあります。 + + +##### 書籍とコースの違い + +これらの区別が難しい場合もあります！ + +コースには関連する教科書があることが多く、私たちはそれを書籍リストに掲載します。コースには、講義、練習問題、テスト、ノートやその他の教材があります。単一の講義やビデオだけではコースとは言えません。パワーポイントはコースではありません。 + + +##### インタラクティブ・チュートリアルとその他のもの + +プリントアウトしてそのエッセンスを保持できるなら、それはインタラクティブ・チュートリアルではない。 + + +### 自動化 + +- フォーマットルールの適用は、[fpb-lint](https://github.com/vhf/free-programming-books-lint) を使って [GitHub Actions](https://github.com/features/actions) 経由で自動化されています（[`.github/workflows/fpb-lint.yml`](../.github/workflows/fpb-lint.yml) を参照）。 +- URLバリデーションは[awesome_bot](https://github.com/dkhamsing/awesome_bot)を使います。 +- URL バリデーションを起動するには、`check_urls=file_to_check` を含むコミットメッセージを含むコミットをプッシュします： + + プロパティ + check_urls=free-programming-books.md free-programming-books-ja.md + ``` + +- チェックするファイルを複数指定することもできます。 +- 複数のファイルを指定した場合、ビルドの結果は最後にチェックしたファイルの結果に基づいて行われます。このため、Pull Request の最後にある "Show all checks" -> "Details" をクリックしてビルドログを確認してください。 \ No newline at end of file diff --git a/docs/HOWTO-ja.md b/docs/HOWTO-ja.md new file mode 100644 index 000000000..e74153c11 --- /dev/null +++ b/docs/HOWTO-ja.md @@ -0,0 +1,34 @@ +# ハウツー一覧 + +
+ +*[Read this in other languages](README.md#translations)* + +
+ +**Free-Programming-Books`へようこそ!** + +私たちは新しい貢献者を歓迎します。GitHub で初めて Pull Request (PR) を作成する人も歓迎します。もしあなたがその一人であるなら、役に立つかもしれないリソースをいくつか紹介しましょう： + +* プルリクエストについて](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) +* [プルリクエストの作成](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) +* [YouTube - GitHub Tutorial For Beginners](https://www.youtube.com/watch?v=0fKg7e37bQE) +* [YouTube - How To Fork A GitHub Repo and Submit A Pull Request](https://www.youtube.com/watch?v=G1I3HF4YWEw) +* [YouTube - Markdown Crash Course](https://www.youtube.com/watch?v=HUBNt18RFbo) + + +どの貢献者も最初のPRから始めています。だから...私たちの[大きく成長している](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)コミュニティに参加しませんか？ + +
+ユーザー対時間のグラフを見るにはクリックしてください。 + +[![EbookFoundation/free-programming-books's Contributor over time Graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) + +[![EbookFoundation/free-programming-books's Monthly Active Contributors graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) + +
+ +経験豊富なオープンソース貢献者であっても、つまずくことがあるかもしれません。PRを投稿すると、***GitHub Actions*が**リンター**を実行し、しばしば間隔やアルファベット表記に関する小さな問題を見つけます**。緑色のボタンが表示されれば、レビューの準備は完了です。もし表示されない場合は、失敗したチェックの下にある「詳細」をクリックして、リンターが何を気に入らなかったのかを調べ、PR をオープンしたブランチに新しいコミットを追加して問題を修正しましょう。 + +最後に、もしあなたが追加したいリソースが `Free-Programming-Books` にふさわしいかどうか確信が持てない場合は、[CONTRIBUTING](CONTRIBUTING-ja.md) *([translations](README.md#translations)もあります)* にあるガイドラインに目を通してください。 \ No newline at end of file diff --git a/docs/README.md b/docs/README.md index a271ba2d5..7729f82c8 100644 --- a/docs/README.md +++ b/docs/README.md @@ -64,6 +64,9 @@ Volunteers have translated many of our Contributing, How-to, and Code of Conduct - [Contributing](CONTRIBUTING-it.md) - [How-to](HOWTO-it.md) - Japanese / 日本語 + - [行動規範](CODE_OF_CONDUCT-ja.md) + - [貢献する](CONTRIBUTING-ja.md) + - [方法](HOWTO-ja.md) - Kannada / ಕನ್ನಡ - [How To](HOWTO-kn.md) - [Contributing](CONTRIBUTING-kn.md)