Skip to content

i18n(ja): Update editor-setup.md#2064

Merged
delucis merged 5 commits into
withastro:mainfrom
morinokami:i18n-ja-editor-setup
Nov 20, 2022
Merged

i18n(ja): Update editor-setup.md#2064
delucis merged 5 commits into
withastro:mainfrom
morinokami:i18n-ja-editor-setup

Conversation

@morinokami
Copy link
Copy Markdown
Member

What kind of changes does this PR include?

  • Translated content

Description

  • Updated editor-setup.md.
  • Improved some existing translations.

@netlify
Copy link
Copy Markdown

netlify Bot commented Nov 17, 2022

Deploy Preview for astro-docs-2 ready!

Name Link
🔨 Latest commit 793ec09
🔍 Latest deploy log https://app.netlify.com/sites/astro-docs-2/deploys/6379fef3828cae0009996dd5
😎 Deploy Preview https://deploy-preview-2064--astro-docs-2.netlify.app/ja/editor-setup
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site settings.

@github-actions github-actions Bot added the i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! label Nov 17, 2022
## VS Code

[VS Code](https://code.visualstudio.com/) はMicrosoft社が開発した、web開発者に人気のあるコードエディタです。 VS Codeのエンジンは [GitHub Codespaces](https://github.com/features/codespaces)[Gitpod](https://gitpod.io/)といった人気のあるブラウザ内コードエディタもサポートしています。
[VS Code](https://code.visualstudio.com/)はMicrosoft社が開発した、web開発者に人気のあるコードエディタです。VS Codeのエンジンは[GitHub Codespaces](https://github.com/features/codespaces)[Gitpod](https://gitpod.io/)といった人気のあるブラウザ内コードエディタもサポートしています。
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

この行を含むいくつかの行において、英単語の周囲にスペースがある場合とない場合とが混在していたため、どちらかに統一したほうがいいと考えました。プロジェクト全体をざっと見た感じでは「スペースなし」が基本方針であるように思えたため、ここでもそれに合わせスペースを削除しています。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ありがとうございます!英単語と日本語の間にはスペースを空けないほうに統一で良いと思います。
Prettierにスペースが挿入されてしまう問題があり、最近直ったようです。以前に翻訳したドキュメントでは強制的にPrettierがかかったので諦めていました。
なので、ドキュメントによって混在している場合があるかと思いますが、気づいたら削除いただけると良さそうです。


Astro はどのようなコードエディタでも動作しますが、VS CodeはAstroで開発する際におすすめのエディタです。 私たちはいくつかの重要な機能の追加と、開発者体験を向上させる公式[VS
Code 拡張機能](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode)をメンテナンスしています。
Astroはどのようなコードエディタでも動作しますが、VS CodeはAstroで開発する際におすすめのエディタです。 私たちはいくつかの重要な機能の追加と、開発者体験を向上させる公式の[Astro VS Code拡張機能](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode)をメンテナンスしています。
Copy link
Copy Markdown
Member Author

@morinokami morinokami Nov 17, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

このファイル内で、Astro VS Code Extension という単語が日本語版では

  • VS Code 拡張機能
  • Astro VS Code Extension
  • Astro VS Code拡張

のように入り混じっていたため、もとの単語にもっとも忠実と思われる「Astro VS Code拡張機能」へと統一しました(少し長い気もするので、「機能」を落とすのもありかもしれません)。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ありがとうございます。ちょっと長い気はしますが、VS Codeの公式Japanese Language Packをいれると「拡張機能」という表記になるんですよね。なので「Astro VS Code拡張機能」で良い気がします。

- [VS Code Extension on Open VSX](https://open-vsx.org/extension/astro-build/astro-vscode) <span style="margin: 0.25em;"><Badge variant="accent">Official</Badge></span> - [VSCodium](https://vscodium.com/)のようなオープンプラットフォーム向けのOpen VSX Registryで利用可能な公式Astro VS Code Extensionです。
- [Nova Extension](https://extensions.panic.com/extensions/sciencefidelity/sciencefidelity.astro/)<span style="margin: 0.25em;"><Badge variant="neutral">Community</Badge></span> - Astro用シンタックスハイライト、インテリセンス、自動補完
- [VS Code Extension on Open VSX](https://open-vsx.org/extension/astro-build/astro-vscode) <span style="margin: 0.25em;"><Badge variant="accent">Official</Badge></span> - [VSCodium](https://vscodium.com/)のようなオープンプラットフォーム向けのOpen VSX Registryで利用可能な公式のAstro VS Code拡張機能です。
- [Nova Extension](https://extensions.panic.com/extensions/sciencefidelity/sciencefidelity.astro/)<span style="margin: 0.25em;"><Badge variant="neutral">Community</Badge></span> - Nova向けにAstro用シンタックスハイライトや自動補完を提供します。
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#1038 に対応しています。

- [StackBlitz](https://stackblitz.com/) と [CodeSandbox](https://codesandbox.io/) - ブラウザ上で動作するオンラインエディタで, `.astro` ファイル用のシンタックスハイライトをサポートしています。設定やインストールは不要です。
- [GitHub.dev](https://github.dev/) - [Web Extentions](https://code.visualstudio.com/api/extension-guides/web-extensions)としてAstro VS Code拡張をインストールでき、拡張機能の一部をフルに利用できるようになります。現在のところ、シンタックスハイライトのみをサポートしています。
- [Gitpod](https://gitpod.io/) - Open VSXから公式Astro VS Code Extensionをインストールできるクラウド上のフル開発環境です。
- [StackBlitz](https://stackblitz.com/)と[CodeSandbox](https://codesandbox.io/) - ブラウザ上で動作するオンラインエディタで、`.astro`ファイル用のシンタックスハイライトをサポートしています。設定やインストールは不要です。
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

もとの文で「オンラインエディタで,」のように「,」が残存していたため、「、」へと変更しています。

@morinokami morinokami marked this pull request as ready for review November 17, 2022 13:58
@delucis
Copy link
Copy Markdown
Member

delucis commented Nov 17, 2022

Nice work — thank @morinokami! Do you want to post on Discord to ask for someone to review?

@morinokami
Copy link
Copy Markdown
Member Author

@delucis I'll ask for a review myself on Discord! Thanks😁

Copy link
Copy Markdown
Contributor

@kyosuke kyosuke left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@morinokami レビューしました。全体的にわかりやすく翻訳&アップデートされていると思います!
小さな気になった点だけコメントしています。

## VS Code

[VS Code](https://code.visualstudio.com/) はMicrosoft社が開発した、web開発者に人気のあるコードエディタです。 VS Codeのエンジンは [GitHub Codespaces](https://github.com/features/codespaces)[Gitpod](https://gitpod.io/)といった人気のあるブラウザ内コードエディタもサポートしています。
[VS Code](https://code.visualstudio.com/)はMicrosoft社が開発した、web開発者に人気のあるコードエディタです。VS Codeのエンジンは[GitHub Codespaces](https://github.com/features/codespaces)[Gitpod](https://gitpod.io/)といった人気のあるブラウザ内コードエディタもサポートしています。
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ありがとうございます!英単語と日本語の間にはスペースを空けないほうに統一で良いと思います。
Prettierにスペースが挿入されてしまう問題があり、最近直ったようです。以前に翻訳したドキュメントでは強制的にPrettierがかかったので諦めていました。
なので、ドキュメントによって混在している場合があるかと思いますが、気づいたら削除いただけると良さそうです。


Astro はどのようなコードエディタでも動作しますが、VS CodeはAstroで開発する際におすすめのエディタです。 私たちはいくつかの重要な機能の追加と、開発者体験を向上させる公式[VS
Code 拡張機能](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode)をメンテナンスしています。
Astroはどのようなコードエディタでも動作しますが、VS CodeはAstroで開発する際におすすめのエディタです。 私たちはいくつかの重要な機能の追加と、開発者体験を向上させる公式の[Astro VS Code拡張機能](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode)をメンテナンスしています。
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ありがとうございます。ちょっと長い気はしますが、VS Codeの公式Japanese Language Packをいれると「拡張機能」という表記になるんですよね。なので「Astro VS Code拡張機能」で良い気がします。

Comment thread src/pages/ja/editor-setup.md Outdated

### JetBrainsのIDE

私たちは[Webstorm IDE](https://www.jetbrains.com/webstorm/)を是非ともサポートしたいのですが、残念ながら言語サーバーがサポートされておらず、私たちも既存のコードベースとは異なる言語でまったく別の拡張機能を書いて維持するだけの余力がありません。関連する[JetBrainsのサポートイシュー](https://youtrack.jetbrains.com/issue/WEB-52015/Astro-Language-Support)にアクセスして、チケットへ「いいね」をして進捗を追跡し、コミュニティが用意した回避策を見つけてみてください。
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

個人的な意見ですが、「私たち」は取ってしまった方が日本語のドキュメントとして読みやすいかと思いました。

Suggested change
私たちは[Webstorm IDE](https://www.jetbrains.com/webstorm/)を是非ともサポートしたいのですが、残念ながら言語サーバーがサポートされておらず、私たちも既存のコードベースとは異なる言語でまったく別の拡張機能を書いて維持するだけの余力がありません。関連する[JetBrainsのサポートイシュー](https://youtrack.jetbrains.com/issue/WEB-52015/Astro-Language-Support)にアクセスして、チケットへ「いいね」をして進捗を追跡し、コミュニティが用意した回避策を見つけてみてください。
[Webstorm IDE](https://www.jetbrains.com/webstorm/)を是非ともサポートしたいのですが、残念ながら言語サーバーがサポートされておらず、既存のコードベースとは異なる言語でまったく別の拡張機能を書いて維持するだけの余力がありません。関連する[JetBrainsのサポートイシュー](https://youtrack.jetbrains.com/issue/WEB-52015/Astro-Language-Support)にアクセスして、チケットへ「いいね」をして進捗を追跡し、コミュニティが用意した回避策を見つけてみてください。

Comment thread src/pages/ja/editor-setup.md Outdated

### ESLint

[ESLint](https://eslint.org/)はJavaScriptとJSX向けの人気のリンターです。Astro向けのサポートとしては、[コミュニティがメンテナンスしているプラグイン](https://github.com/ota-meshi/eslint-plugin-astro)をインストールすることができます。
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[ESLint](https://eslint.org/)はJavaScriptとJSX向けの人気のリンターです。Astro向けのサポートとしては、[コミュニティがメンテナンスしているプラグイン](https://github.com/ota-meshi/eslint-plugin-astro)をインストールすることができます
[ESLint](https://eslint.org/)はJavaScriptとJSX向けの人気のリンターです。Astro向けのサポートとしては、[コミュニティがメンテナンスしているプラグイン](https://github.com/ota-meshi/eslint-plugin-astro)をインストールできます

Comment thread src/pages/ja/editor-setup.md Outdated
npm install --save-dev prettier prettier-plugin-astro
```

これにより、Prettierは実行時にプラグインを自動的に認識し、それを用いて`.astro`ファイルを処理します。
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

それを用いては省略してもよさそうです。

Suggested change
これにより、Prettierは実行時にプラグインを自動的に認識し、それを用いて`.astro`ファイルを処理します。
これにより、Prettierは実行時にプラグインを自動的に認識し、`.astro`ファイルを処理します。

@morinokami morinokami requested a review from kyosuke November 18, 2022 10:04
@kyosuke
Copy link
Copy Markdown
Contributor

kyosuke commented Nov 20, 2022

@morinokami 修正ありがとうございます! LGTM!

Copy link
Copy Markdown
Member

@delucis delucis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @morinokami and @kyosuke! 🚀

@delucis delucis merged commit 411f7eb into withastro:main Nov 20, 2022
@morinokami morinokami deleted the i18n-ja-editor-setup branch December 22, 2022 12:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help!

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants