LearnOSM コンテンツ翻訳マニュアル

=================================
LearnOSMに掲載されている情報を他の言語に翻訳する場合は、このページに記載されている手順にそって作業をお願いします。この有用な情報をより多くの人々に伝えることは、とても大きな意味をもちます。この作業は他のチームメンバーとの共同作業です。彼らはGithubなど、より技術的な部分を担当します。あなたが覚えるべき技術はさほど多くありませんし、そもそもとても簡単なものばかりです。作業の中で一番大変なのはコンテンツを英語から他の言語に翻訳することですが、これに関して心配することはないでしょう！

Githubアカウントの作成

• まずはGithubアカウントを作成してください。
• アップグレードプランにする必要はありません。無料のベーシックアカウントでかまいません。
• 作成したアカウントでサインアップできることを確認してください。
• Githubウェブサイトで行うべきことは、以上で終了です。

• 技術的な面で支援してくれるチーム内のGithub使いに、あなたのアカウント名を伝えてください。(当然ですが、パスワードは教えないでください)
• あなたのアカウントが、翻訳プロジェクトの協力者として登録されます。
• 登録が完了すると、あなたに翻訳を担当してほしいコンテンツが割り当てられます。

マークダウン記法の基礎

• マークダウン記法でテキストを記述すると、そのままのテキスト形式でも読むことができ、さらにウェブページで表示する際により見やすいフォーマットに変換可能な文章が作成可能です。
• wikipediaのエントリに'記法の例'があげられていますので、一読してみてください。
  • 記述する際にはHTMLでどのように表示されるかを気にせず、マークダウン文法だけを意識するようにしてください。
  • 見出し、パラグラフ、リスト、部分強調といった機能を使ってみてください。http://markdown.pioul.fr/で試しながら入力するとよいでしょう(このサイトでは左側にマークダウン書式を記載すると、ウェブサイトでの表示例が自動的に右側へ表示されるようになっています)
  • 外部サイトへのリンクや画像がどのように表示されるかを理解しましょう(Github使いのかたがたも必要に応じてリンクや画像の部分を修正します。翻訳の際にそれらの部分を削除してしまわないよう気をつけましょう)

ProseサイトでのLearnOSMコンテンツ編集方法

• 翻訳作業は、オンラインの使いやすいコンテンツエディタで行います。
• ブラウザからProse.ioを開き、'Authorize on GitHub'をクリックしてください。

• あなたのGithubアカウント情報を入力し、サインインします。

• 'Explore Projects'に表示されているプロジェクトの一覧から'learnosm'を選択して開いてください
• もし表示されていない場合は、あなたのアカウントがメンバーに追加されているかどうかをGithub使いのチームメンバーに聞いてみてください

• '_posts'フォルダを開きます
• フォルダの中には、それぞれ異なる言語の翻訳ファイルが格納されています
  • 'bi' はインドネシア語(Bahasa Indonesia)です
  • 'en' は英語をです
  • 言語コードの一覧
• あなたが担当する言語のフォルダをGithub使いのメンバーが教えてくれます
• 画面をスクロールして対象言語のフォルダを探し、クリックしてください

• learnOSMコンテンツのメイン部分が表示されます
• 画面をスクロールして、あなたが担当するページを探してください

Proseを使ったLearnOSMコンテンツ翻訳方法

• After you click on the '.md' file for a page it will open in the editor
• 対象の'.md'ファイルを開くと、翻訳用のエディタページが表示されます
• 画面の右側に、操作オプションが5つ表示されます。
• 特に必要となるのは、'Edit'、'Preview'、'Save'のみとなります。

• "？"が表示されたアイコンをクリックすると、ヘルプメニューが表示されます
• ヘルプメニューでは、マークダウン記法の様々な書式を確認することができます
  • 詳細な書式については wikipediaのエントリ を参照してください
  • 日本語での解説は blog::2310 にも記載されています
  • 翻訳結果の記法確認には、左右比較のできる以下のページを使ってみてください。http://markdown.pioul.fr/ (間違って入力してしまっても、この時点では反映されませんので安心してください。また、入力した内容がどのように表示されるのかを確認するために 'Edit' と 'Preview'を切り替える必要はありません)

• 'Edit' ページのコンテンツ上部には、ショートカットアイコンが表示されています。
• これらのアイコンを使って、マークダウン記法を入力することも可能です。
  • 例: 単語を選択し、'B'のアイコンをクリックすると単語の両端がアスタリスクで囲まれ、その単語が太字の強調表示になります

• 'Preview'をクリックすると、現在の入力内容をウェブページで表示した場合の表示確認が可能です
  • この際、画像が表示されませんが、問題ありません

• 表示を下へ移動させてゆくと、マークダウン記法の中で言及した様々なページヘのリンク要素が表示されます
• 以下の画像では、ページ内で使われている画像要素へのリンクが表示されています
  • 翻訳を行う際に、これらの画像やリンクを削除しないようにしてください

• 以下の画像は、見出しとリスト表示の記載例です
  • マークダウン記法では、プレーンテキストの記載とウェブページ上での表示が似た形式になっており、記述がとても簡易です

• 文章の翻訳が終わったら、画面右側の操作パネルの一番下にある'Save'をクリックしてください
  • 変更メッセージの内容はそのままでもかまいませんし、書きなおして実施した内容のメモを記載してもかまいません
• 'Commit'をクリックすると、変更箇所がアップロードされます

Click 'Commit' and your changes will be uploaded

• Github使いのチームメンバーに、翻訳が終わった旨を伝えてください
  Communicate with the GitHubber team member
  • 作業の状況や不明点、その他作業中に発生した問題点などをメンバーに相談してみてください

Proseの機能改善

• Proseはオープンソースのプロジェクトであり、機能を充実させている最中です
• prose.ioを使っていて発生した不具合は prose GitHub page にIssueとして報告するか、チームのGithub使いに相談してください。状況が詳しくわかれば、彼らが代わりにIssueを登録することも可能でしょう。
• Proseに関わる人々にとって、あなたのレポートは貴重なフィードバックとなります

このコンテンツは翻訳記事です

このコンテンツは、Detailed Workflow for Translators の翻訳となります。