コアハンドブック 公開タスクリスト

[t-hamano]

GitHubリポジトリ上で全てのページの翻訳が完了となったあと、日本語のコアハンドブックとして公開するために行う作業をメモしておきます。

※20223/10/21 に開催されるWordCamp Tokyo 2023までには公開したいため、各タスクの暫定スケジュールも追加。

• GitHub 側の最終調整
  • textlint による全体のエラーチェック、調整 textlint による全体のエラーチェック、調整 #208
  • コメントアウトした英文と日本語訳の間を一行空ける（今後原文を更新した時に、正確に差分が抽出されるようにするため）
  • もう一度原文と同期し、差分・ページ追加があれば追加翻訳する 原文の更新 #205
  • 斜体記号を必要に応じて 「、」 に置き換え 原文の斜体を文脈に応じて別のフォーマットに変更 #209
  • 原文に存在しないが、日本語GitHubリポジトリに存在する未翻訳のページ（＝原文でページが削除されたもの）を、GitHubリポジトリからも消す。 コーディング規約ハンドブック関連ページの翻訳 #201
  • 単語の一貫性の向上 単語の一貫性の向上 #210
• WordPress 側で、各固定ページを公開状態で作成する （ページのスラッグを確定させるため。また、デフォルトでは、Draft/下書きページを親に指定できないため）
• 翻訳テキスト内のページ内リンクを、原文ではなく日本語ハンドブック内に向くように、ドメインを置換する (https://make.wordpress.org/core/handbook → https://ja.wordpress.org/team/handbook/core/) 日本語訳の中のハンドブックURLのパスを置換 #211
• WordPress 側の各固定ページに、GitHubの翻訳テキストを貼り付ける
  • 特殊なレイアウト、マークダウンでは表現できないスタイルは、原文ハンドブックも考慮して適宜調整する
  • 外部リンクは、新しいタブで開くように設定する
  • 翻訳等のミスが見つかった場合は適宜WordPress側で修正し、GitHub側でも同様の変更を fix/publish-sync ブランチにコミットする。
• 全ページ移行後、GitHubソースを /# と (# で検索し、アンカーリンクを抽出する。見出しのアンカーリンクはテキストから自動生成されるので、正しく紐づくようにWordPress側で変更する。GitHub側でも同様の変更を fix/publish-sync ブランチにコミットする。
  • 同一ページ内のアンカーリンク調整 #214
  • 別ページアンカーリンクの調整 #215
• ハンドブック一覧ページにコアハンドブックを追加する
• 単体で存在するブラウザサポートページは、コアハンドブック内にも全く同じページがあるため、削除する。
• (10/18) ブログでアナウンス記事を公開する (Note: 公開日を実際に公開した日に更新する事を忘れずに！)
• (都度) WordPress 側で行われた修正がコミットされている fix/publish-sync ブランチからPRを作成し、メインブランチにマージする。
  • ハンドブックページからの同期 #212
  • ハンドブックページからの同期 #213
  • 同一ページ内のアンカーリンク調整 #214
  • 別ページアンカーリンクの調整 #215

ブログでの告知内容

下書きとして作成済

[t-hamano]

Props用のアカウント一覧

GitHub ユーザー名	WordPress.org ユーザー名	備考
atachibana	atachibana	GitHub 上の Contributor
east-or-est	azuma3derive	GitHub 上の Contributor
miminari	mimitips	GitHub 上の Contributor
nano195	nano195	GitHub 上の Contributor
naokomc	nao	GitHub 上の Contributor
nukaga	nukaga	GitHub 上の Contributor
-	osamunize	GitHub 上の Contributor
imiyake	torikumo	GitHub 上の Contributor
mirucon	mirucon	wp-handbook-converter の作者さん

[t-hamano]

WordPress.org Japanese Teamにハンドブックとして公開するためのURL管理表

https://docs.google.com/spreadsheets/d/1aB8iCxetf4SRMr0Ev8FAW1KBEHLARIdZItbrz6d4AAE/edit?usp=sharing

[t-hamano]

公開タスクが全て完了したため、クローズします。
アナウンス記事：https://ja.wordpress.org/team/2023/10/10/3783/