diff --git a/style-guide.md b/style-guide.md index e41f98c0a..d3c539b78 100644 --- a/style-guide.md +++ b/style-guide.md @@ -126,6 +126,40 @@ Homebrew をインストールするには: - データの変換 ``` +### 半角と全角のスペース + +半角と全角が切り替わる箇所にスペースをいれてください。 + +例: + +✅ 良い: + +```md +もし React について詳しくなければ、まずは[こちらのガイド](https://reactjs.org)をご覧ください。 +``` + +❌ ダメかも: + +```md +もしReactについて詳しくなければ、まずは[こちらのガイド](https://reactjs.org)をご覧ください。 +``` + +上記の例は、textlint で検知ができるのですが、「``」や「""」で囲まれている場合は、textlint で検知できないため、手動でスペースをいれてください。 + +例: + +✅ 良い: + +```md +ここで、新しく "Contact" ページ用に `src/pages/contact.js` としてページコンポーネントを作成し、ホームページにリンクする必要があります。 +``` + +❌ ダメかも: + +```md +ここで、新しく"Contact"ページ用に`src/pages/contact.js`としてページコンポーネントを作成し、ホームページにリンクする必要があります。 +``` + ## 機械翻訳の利用について Google 翻訳など、機械翻訳サービスを利用して得られた文章をそのまま、あるいはマイナーな変更を加えて流用してはいけません。機械翻訳は一見すると文法構造的に正しく見えますが、文脈的には誤った翻訳になっていることが多いためです。また、翻訳サービスによっては成果物を私的利用以外に禁止しているものがあります。そのようなサービスを用いた未改変の翻訳がコミットに含まれていることを Gatsby チームが発見した場合、過去のコミットを全て精査した上で、状況によっては revert する可能性があります。