TRANSLATION.md

Supabase日本語翻訳プロジェクト

このリポジトリではSupabeのドキュメントを日本語に翻訳する作業を行っています。

オリジナルsupabase.ioのドキュメントサイトはDocusaurusによって生成される静的サイトであり、英語ドキュメントが含まれています。本リポジトリはそのフォークです。web/docs内にあるドキュメントを日本語化しています。日本語の校正をするためにtextlintなどを含めています。日本語訳や日本語版特有の問題を見つけた場合はこのリポジトリのIssue/Pull Requestを使って報告ないし改善を提案してください。

メンテナ

• @hirotaka

ドキュメント翻訳者向けガイド

環境のセットアップ

ドキュメントはwebディレクトリ配下にあります。Docusaurusで構築されています。リファレンスがライブラリーから自動で生成されるので、そのための手順を踏みます。

1. Git, Nodeをそれぞれ準備して、supababase-jaをフォークしてクローン
2. cd web
3. npm installで依存パッケージをインストール
4. npm run buildでリファレンスのドキュメントを生成
5. npm run startでローカルウェブサーバーが立ち上がるのを確認
6. web/docs配下のMarkdownファイルをテキストエディタで編集
7. ブラウザで確認

作業の重複を防ぐための宣言

未翻訳記事の翻訳を行いたい場合は、他の人との作業の重複を防ぐため、こちらのIssueで宣言をお願いします。

スタイルの自動チェック

本プロジェクトではtextlintというスタイルチェッカを利用しており、基本的なスタイルに関する問題（全角英数を使わない、句読点の統一など）の検出が行われます。コミットの際に自動で走ります。npm run lint:textで手動で行うことも可能です。PRの作成の前には必ずエラーが出ないようにしてください。また、翻訳をするファイルを.textlintignoreから削除してください。

全般的なこと

• 技術文書向けのtextlintルールのプリセットに従います。
• JTFのスタイルガイドに準拠します。textlintのルールがはいっておりすべてのチェックが有効になっています。
• ルールが厳しかったり、他のオープンソースプロジェクトの翻訳で採用しているスタイルと異なる事も多々あるので、随時調整してきます。何か提案がありましたら、Discussionに投稿してください。

用語の統一

textlintでtext-rule-prhを使用しています。prh.ymlに記載しています。