章 14 · 部 III · 実践
Postextへの貢献
Postextのコミュニティに参加し、プロジェクトに貢献する方法
かんたんな説明
Postextはボランティアのコミュニティがつくっていて、だれでも手伝えます。プログラマーである必要はありません。テストや説明文書づくり、翻訳、デザインや印刷についての知識を伝えることでも力になれます。このページでは、チームの進め方、とくに手が足りないところ、最初の一歩の踏み出し方を説明し、最後にプロジェクトの長期的な目標を紹介します。
Webにこれまでなかった組版エンジンを、みんなでつくる。
Postextはコミュニティ主導のオープンソースプロジェクトです。何十年も手つかずだった問題、つまりWebでプロの組版を実現するという問題に取り組んでいます。大きな目標であり、1人の力では足りません。
プロジェクトはまだ若いものの、もう白紙ではありません。組版パイプラインの中核、文書形式、設定の仕組みはすでにリリースされています。それでも未決の設計判断は数多く残っており、いま参加する人はプロジェクトの方向に実際に影響を与えられます。参加するよい機会を待っていたなら、いまがそのときです。
貢献するのにプログラマーである必要はありません。コードを書く人、誌面をデザインする人、タイポグラフィに詳しい人、さまざまなブラウザーでテストする人、ドキュメントを書く人、内容を翻訳する人、Webで出版物がどう扱われるべきかについて考えのある人。どなたにも活躍の場があります。
#貢献する理由
世界中の出版系の開発現場は、同じ問題を抱えています。CSSは組版のためにつくられていません。段末そろえ、オーファンとウィドウの防止、障害物を回り込むテキストの流し込み、脚注の配置は、どれもネイティブには用意されていません。どのチームもこれらの問題を一から解決し、保守に手間がかかり共有もできない、もろい場当たり的な仕組みをつくっています。
Postextはこの状況を変えようとしています。独自のツールとしてではなく、共有されるオープンな標準としてです。世界中の出版社、雑誌、新聞、書籍プラットフォーム、開発チームが採用し、その上に積み上げていける、高品質な組版エンジンを1つつくることを目指しています。
そうした標準は、1人の人間や1つの会社ではつくれません。さまざまな組版の伝統に通じたタイポグラファー、PDFの専門家、アクセシビリティの専門家、右から左に書く文字を扱う開発者、雑誌をレイアウトするデザイナー、描画性能を最適化するエンジニアの視点が必要です。出版の世界は多様です。それに応えるツールの背後にも、多様なコミュニティが求められます。
#進め方
調整はすべてGitHub上で行います。非公開のチャンネルも、閉じたメーリングリストも、密室での決定もありません。すべてが公開され、検索でき、だれでも参加できます。
- Issues:バグ報告、機能の要望、個別の作業のための場所です。何かに取り組みたいなら、ここから始めてください。
- Pull Requests:コードによる貢献のための場所です。コードを書く前に、まずIssueを立てて進め方を話し合ってください。
- Discussions:アイデア、設計についての議論、質問など、個別のバグや作業ではないものすべてのための場所です。考えをそのまま声に出せる場です。
これは意図したものです。すべてが1か所にあれば、だれでもあらゆる決定の背景をたどれますし、新しく加わった人も経緯を読むことができます。
#協力できる分野
このプロジェクトには、さまざまな種類の専門知識が必要です。とくに貢献が役立つ分野をいくつか挙げます。
#コードとアルゴリズム
- 組版のレイアウトアルゴリズム:Knuth-Plassによる両端そろえのエンジン、段末そろえ、最適な段落の改行、種類ごとのリソース番号付け、フロートの配置。
- PDF生成:低レベルのPDF構築、フォントの埋め込み、カラーマネジメント、単色の図のためのリソースのバイト列の扱い。
- テキストの描画:canvasによる描画、SVG出力、単色SVGの色の差し替え(
diagramStyle.singleInk)、フォントメトリクス。 - パフォーマンスの最適化:計測キャッシュの層、Rustで書きWebAssemblyにコンパイルしたKnuth-Plassの行分割(
rust/)、そしてリサイズのたびにリアルタイムで組み直せる速さを組版エンジンに保つこと。
#SandboxとUI
Sandbox(ブラウザーで動く編集環境)は、それ自体がかなりの規模のReactアプリケーションに育っています。対話的な表エディターと画像・SVGのアップロードを備えたリソースパネル、フォントパネル、ページテンプレートと漫画ページのエディター、エンジンのあらゆる部分をグループに分けて扱うデザインパネルがあります。コントロールはBase UIのプリミティブ(packages/postext-sandbox/src/ui/)の上に組まれ、axe-coreとプロジェクト独自のチェックでWCAG 2.2のレベルAAAへの適合を確認しています。新しいコントロールもこれらを再利用し、どの入力欄にもラベルによる名前とヘルプテキストによる説明が付くようにしてください。UIの文字列はすべて厳格な国際化(i18n)の規約に従います。ラベルは1つごとに、Sandboxパッケージ、webアプリのラベルの橋渡しファイル、10言語それぞれのロケールカタログに登録します。フロントエンドやUXの作業で貢献するなら、ここが活躍の場です。
#デザインとタイポグラフィ
- エディトリアルデザインの専門知識:雑誌、新聞、書籍をレイアウトした経験があれば、レイアウトが成功する(あるいは失敗する)理由についての知識はとても貴重です。コードは必要ありません。
- 組版の伝統:プロジェクトはラテン文字に限らず、さまざまな言語と表記体系の組版の慣習を尊重すべきです。
#ドキュメントとコミュニティ
- ドキュメント:ドキュメントの改善、拡充、保守。わかりやすいドキュメントがあるかどうかで、人が採用するプロジェクトになるか、見捨てるプロジェクトになるかが分かれます。
- 翻訳:ドキュメントとサイトは10言語あります。英語、スペイン語、カタルーニャ語、フランス語、ドイツ語、イタリア語、ブラジルポルトガル語、簡体字中国語、日本語、アラビア語です。ほかの言語も、既存の言語の見直しも歓迎します。
- テスト:さまざまなブラウザー、OS、エッジケースでのテスト。崩れるレイアウトを見つけることは、うまくいくレイアウトをつくることと同じくらい価値があります。
#フォーマットとスキーマの設計
フォーマットはもう白紙ではありません。::resourceブロック、:refインライン参照、そしてtableStyle、captionStyle、diagramStyleの設定セクションはすでにリリースされています。いま必要なのは、確立したフォーマットを壊さずに発展させる作業です。
- 文書の文法:傍注はまだ未解決の課題で、技術の問題であると同時に設計の問題でもあります。
- 設定スキーマ:仕組みが大きくなっても、プロには十分に強力で、初めての人には十分に単純であり続けるようにすること。
#はじめ方
リポジトリーのクローン、依存関係のインストール、テストの実行といった実際の準備は、CONTRIBUTING.mdに書かれています。機械的な手順はまずそちらを見てください。
準備ができたら、具体的な行動を3つ、負担の軽いものから順に紹介します。
- Discussionsで自己紹介する:何に取り組んでいるのか、なぜここに来たのかを書いてください。基本的すぎる質問というものはありませんし、あなたが加わったことをコミュニティに知らせるいちばん早い方法です。
- good first issueに取り組む:現実的な入り口になるように選ばれたIssueで、これまでの経緯を知らなくても取り組めます。
- ドキュメントを新しい言語に翻訳する、または見直す:現在、ドキュメントは10言語で書かれています。新しい言語が加わるたびに、ほかの言語を読めない読者に届くようになります。
コードを書くつもりなら、まずIssueを立てて進め方を話し合ってください。作業の重複を避けられますし、最初に少し話しておくことで全員の時間の節約になります。
ソースファイルはおよそ600行以内、フォルダはおよそ25ファイル以内に保ちます。これを超えたモジュールは同じ名前のフォルダにし、元のファイルはそれを再エクスポートするファサードとして残します。CIはnode scripts/source-size.mjs --checkでこの上限を確かめます(CONTRIBUTING.mdのCode Layoutを参照)。
#次に読むもの
本格的に取りかかる前に全体像をつかむには、次のページが役立ちます。
- アーキテクチャー:組版パイプラインがどう構成され、各サブシステムがどこにあるか。
- 文書形式:貢献者が拡張していく、拡張Markdownの文法。
- Sandbox:ほとんどの変更をいちばん簡単に確かめ、試せる場所。
#コミュニティ
Postextはまだ初期の段階にあり、だからこそいまは特別な時期です。いま参加する人は、コードを書くことにとどまらず、慣習や優先順位、文化そのものを形づくることになります。
このプロジェクトが大切にしていること:
- 速さより、よく考えた設計。速くリリースすることより、抽象化を正しくすることのほうが重要です。タイポグラフィは何世紀もかけて磨かれてきました。私たちも、正しく仕上げるために時間をかけてかまいません。
- 巧妙さより、わかりやすさ。読みやすく筋道をたどりやすいコードには、見事でも不透明なコードより高い価値があります。
- 縄張りより、協力。コードベースのどの部分にも持ち主はいません。アイデアは、だれが提案したかではなく、その中身で評価されます。
貢献した人は全員、その貢献が認められます。このプロジェクトは、よりよくするために時間を使うことを選んだ人たちがいるから存在しています。
#ビジョン
Postextは、Web上の出版物のための標準的な組版エンジンになることを目指しています。出版社、雑誌、新聞、書籍プラットフォームがプロの組版を必要とするときに、手に取るツールです。
出版系の開発に携わり、こうしたレイアウトの問題を独力で解決してきた方へ。これは、ほかの人たちと一緒に、一度きちんと解決しようという誘いです。