LPI学習教材 – プロジェクトの一部になる

以前の記事でLPI学習教材を紹介しましたが、これはLPI試験の準備のために教師と生徒を導くものです。 これらの教材は、世界中のボランティアによって開発されている。 このプロジェクトでは、数多くのサブプロジェクトを管理し、多くの出版フォーマットや言語をサポートし、テキストを迅速に更新しなければならない。

この記事では、ボランティアがどのようにこの活動を行っているかを説明する。 私たちは統一されたプロセスと、フリーでオープンソース（FOSS）のツールに依存しています。

私たちがどのように働き、どのようにチームの一員になるのか、ぜひお読みください！

支援方法

学習教材を開発する際、著者、校閲者、翻訳者という3つの役割を定義し、それぞれ異なるタスクとツールを使用します。

著者

著者は、トレーニングまたは専門的な経験を通じて、教材レッスンに関連するテクノロジーに関する深い知識を持ち、その知識を適切な方法で受験希望者に伝えることができる。 著者としてのあなたの仕事は、試験の公式な学習目標に記載されている内容を、事実に基づいて正しく、かつ教育的に魅力的な方法で提示することです。 ここで言う “教訓的 “とは、初心者の視点に共感し、読者を容易に、楽しく、生産的に学習プロセスに導くことができることを意味する。 説明を実践的な文脈の中に置き、相互に積み重ねることが重要である： 例や類推は、巧みな切り替えや簡潔な練習問題と同様に重要である。

実際のテキスト作業はGitリポジトリで行われる。 このバージョン管理システムの経験がなくても問題ない。必要なのはコマンドライン上のいくつかのコマンドだけで、スタイルガイドで詳しく説明している。 また、ウェブ・インターフェイス（図1）からもアクセスできます。

図1: GitLabのウェブインターフェイス

あなたが書く各レッスンはAsciiDoc形式のプレーンテキストファイルに対応します。AsciiDocはシンプルなマークアップ言語であり、スタイルガイドにもその使い方が記載されています。 AsciiDocのようなマークアップ言語の原理は、構造やフォーマットに関する情報を、定義された制御文字の形でテキストに直接書き込むというものだ（図2）。 こうしてフォーマットされたテキストは、ウェブサイト上でHTMLとして公開したり、印刷用のPDFとして公開するなど、ほとんどあらゆる方法でさらに加工できるという利点がある。 さらに、著者と校閲者はそれぞれ、テキストを作成するために使用するツール（エディタ、IDEなど）を選択する。

図2：テキストエディタでのレッスンファイル

つまり、著者になるための技術的なハードルは非常に低いのです。重要なのは、学習教材用に定義されたフォーマットで自分の知識を伝えたいというあなたの意欲です！

校閲者

校閲者は、完成した原稿を修正することで、オーサリング作業をサポートします。 校閲者は、技術的な正確さをチェックするだけでなく、教訓的なアプローチを助けることができなければならない： 必要であれば、各部の配置を変え、説明を加え、例を脚色しなければならない。 この作業により、テキストはほぼ最終形となります。

また、Git リポジトリのテキストを直接操作することもできます： つまり、変更した箇所が壊れたり、異なるバージョンのテキストが送り返されたりすることなく、常にトレースできるということです。 著者と校閲者は密接に協力し合っており、タスクは非常に似ているため、ヘルパーがプロジェクトで両方の役割を担うことも多い。

翻訳者

翻訳者は、例えば「Linux Essentials」試験の学習教材など、英語から別の言語にプロジェクトを翻訳します。 通常、翻訳者は学習教材一式を引き受ける。 これは翻訳の一貫性を保つのに有効であることが証明されている。

翻訳プロジェクトも個々のGitリポジトリだが、実際の翻訳作業はオープンソースツールのOmegaTで行われる（図3）。 OmegaTを学ぶ際にも、先に説明したツールと同様の安心感を提供します： ツールやプロセスの経験がない場合は、インストールや最初のステップを喜んでお手伝いします！

図3：OmegaTでのレッスンの翻訳

原理は簡単です： OmegaTで翻訳するファイル（例：レッスン）を開くと、ツールが自動的に短いセクション（いわゆるセグメント）に分割します。 翻訳者としては、セグメントからセグメントへと “ジャンプ “し、ハイライトされた原文のすぐ下に、それぞれのマークアップを注意深く維持しながらテキストを書く。 変更されたセグメントやまだ翻訳されていないセグメントは簡単に見つけることができる。 オーサリングやレビューと同じように、Gitで中央管理することで、異なるバージョンのテキストを扱うことを避けることができる。

次のステップ お問い合わせ

何十人もの人々が、著者、校閲者、翻訳者として学習教材を作成している。 タスクやツールは管理しやすく、プロセスは明確に定義されている。 最も重要な前提条件は、あなたが文書化する目的について、技術的にも教育的にも自信を持っていることです。

サービスを提供する前に、必要な時間を確保してください： 経験上、4,000ワード程度のレッスンであれば、管理可能な期間内に集中して執筆するのが最も効果的です。 必要な専門知識を持っているため、リサーチはほとんど必要ありません。あなたの仕事は、正しく理解しやすいプレゼンテーションで構成され、レッスンの初稿は約4週間以内に完成します。

ご連絡はこちらのフォームからお願いいたします。 あなたの技術的な専門知識や、執筆、校閲、翻訳の可能な経験について、より詳しくお聞かせいただければ幸いです！

皆様からのご連絡と、教材の共同開発をお待ちしております！

<< このシリーズの前回の記事を読む