i18n(ja): Update github.mdx i18n #10867

debiru · 2025-02-01T05:48:58Z

Description (required)

The version of action we are using is out of date and github pages deploy fails, so we updated it.

As of 2025-01-30, the current code fails to deploy to GitHub Pages.

See here for details. https://github.blog/changelog/2024-04-16-deprecation-notice-v3-of-the-artifact-actions/

Related issues & labels (optional)

Nothing.

netlify · 2025-02-01T05:49:14Z

✅ Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`c6bae12`
🔍 Latest deploy log	https://app.netlify.com/sites/astro-docs-2/deploys/67ace1573a239d0008c0cb1f
😎 Deploy Preview	https://deploy-preview-10867--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

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

astrobot-houston · 2025-02-01T05:49:25Z

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
ja/guides/deploy/github.mdx	Localization changed, will be marked as complete.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

astrobot-houston · 2025-02-01T05:49:37Z

Hello! Thank you for opening your first PR to Astro’s Docs! 🎉

Here’s what will happen next:

Our GitHub bots will run to check your changes.
If they spot any broken links you will see some error messages on this PR.
Don’t hesitate to ask any questions if you’re not sure what these mean!
In a few minutes, you’ll be able to see a preview of your changes on Netlify 🥳.
One or more of our maintainers will take a look and may ask you to make changes.
We try to be responsive, but don’t worry if this takes a few days.

morinokami

@debiru こちら対応いただきありがとうございます！

変更内容自体は問題なさそうです。ただ、Astro Docs では各言語版とオリジナルの英語版との差分を https://i18n.docs.astro.build/ にてトラッキングしており、このままこれをマージしてしまうと英語版との差分がないことになってしまうのですが、https://github.com/withastro/docs/commits/main/src/content/docs/en/guides/deploy/github.mdx?since=2024-02-29T14:26:11.000Z を確認するとこれ以外にも積み上がっている修正があるため、すみませんが英語版との差分コミットをすべて反映してもらうことは可能でしょうか？やり方は自由ですが、最終的に作業時点での英語版を漏れなく訳せていることがゴールとなります。

debiru · 2025-02-02T13:34:47Z

@morinokami 承知しましたが、現状の最新英語版は内容に誤りがあるのでそれを修正してからこちらを対応することにします。

…ploy fails, so we updated it.

debiru · 2025-02-02T15:28:06Z

@morinokami

現状の最新英語版は内容に誤りがあるのでそれを修正してからこちらを対応することにします。

これについては、修正方針が不明だったため #10868 で Issue を作成しておきました。

本 PR では、現状の最新英語版 128070a を基にして全面的に再翻訳を行いました。

morinokami

何点かコメントしましたのでご確認をお願いします。

morinokami · 2025-02-07T05:19:59Z

src/content/docs/ja/guides/deploy/github.mdx


 [GitHub Pages](https://pages.github.com/)を使って、[GitHub.com](https://github.com/)上のリポジトリから直接Astroウェブサイトをホストすることができます。

 ## デプロイ方法

 [GitHub Actions](https://github.com/features/actions)を使うことで、AstroサイトをGitHub Pagesに自動的にビルドしてデプロイすることができます。これを行うには、ソースコードがGitHubでホストされている必要があります。

-Astroは公式の`withastro/action`を保守しており、ほとんど設定することなくプロジェクトをデプロイすることができます。以下の手順に従って、AstroサイトをGitHubページにデプロイしてください。さらに詳しい情報が必要な場合は、[パッケージのREADME](https://github.com/withastro/action)を参照してください。
+Astroは公式の `withastro/action` を保守しており、ほとんど設定することなくプロジェクトをデプロイすることができます。以下の手順に従って、AstroサイトをGitHubページにデプロイしてください。さらに詳しい情報が必要な場合は、[パッケージのREADME](https://github.com/withastro/action)を参照してください。


https://github.com/withastro/docs/blob/main/i18n-guides/%E6%97%A5%E6%9C%AC%E8%AA%9E.md に翻訳ガイドがあるのですが、このプロジェクトでは特に英単語等の周りにスペースは挿入しないようにしているため、この修正は不要と思います:

Suggested change

Astroは公式の `withastro/action` を保守しており、ほとんど設定することなくプロジェクトをデプロイすることができます。以下の手順に従って、AstroサイトをGitHubページにデプロイしてください。さらに詳しい情報が必要な場合は、[パッケージのREADME](https://github.com/withastro/action)を参照してください。

Astroは公式の`withastro/action`を保守しており、ほとんど設定することなくプロジェクトをデプロイすることができます。以下の手順に従って、AstroサイトをGitHubページにデプロイしてください。さらに詳しい情報が必要な場合は、[パッケージのREADME](https://github.com/withastro/action)を参照してください。

これはこのファイルのもともとの書式に合わせてもらっていたのかもしれませんね。すみませんが全体的にスペース無しで統一してもらえるとありがたいです。

流儀を知らずすみません。

このファイルのもともとの記述でスペースの有無が揺れていたので、スペース有りに統一してしまっていました。

対応します。

cd33689 で対応しました。

morinokami · 2025-02-07T05:22:51Z

src/content/docs/ja/guides/deploy/github.mdx


-    ```js title="astro.config.mjs" ins={4-5}
-    import { defineConfig } from 'astro/config'
+### `github.io` のURLにデプロイする


ここも同様ですね。この点についてすべて指摘することは避けますが、ここ以下も全般的に修正をお願いします🙏

Suggested change

### `github.io` のURLにデプロイする

### `github.io`のURLにデプロイする

cd33689 で対応しました。

morinokami · 2025-02-07T05:27:58Z

src/content/docs/ja/guides/deploy/github.mdx

-    ```
-    - `site` は `https://<YOUR_USERNAME>.github.io` または `https://my-custom-domain.com` である必要があります。
-    - `base` には、`/my-repo` のように、スラッシュで始まるリポジトリ名を指定します。これは、Astro があなたのウェブサイトのルートがデフォルトの `/` ではなく `my-repo` であることを理解するためです。
+`astro.config.mjs` に [`site`](/ja/reference/configuration-reference/#site) と、必要に応じて [`base`](/ja/reference/configuration-reference/#base) オプションを設定します。


ここの原文は

Set the site and base options in astro.config.mjs.

ですが、この訳し方だと少し原文から乖離する気がしますが、このように訳した理由はありますか？ここは原文に忠実に、強弱を付けず両者を対等に扱えばいいのではないかと思いました。

ここは、修正前のもともとの文章をそのまま使っていました。翻訳し直します。

d5d2b3a で修正しました。

morinokami · 2025-02-07T05:30:28Z

src/content/docs/ja/guides/deploy/github.mdx

+`site` の値は以下のいずれかでなければなりません。
+
+- あなたのユーザー名に基づいた次のようなURL: `https://<username>.github.io`
+- [GitHub Organization's private page](https://docs.github.com/ja/enterprise-cloud@latest/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site) 向けに自動生成されたランダムなURL: `https://<random-string>.pages.github.io/`


このリンクの中も「GitHub Organizationのプライベートページ」のように訳して問題ない気がしたのですが、ここだけ英語のままとしている理由はありますか？

理由は特にないです。リンク先ページのタイトルなわけでもないので、何と訳すのが適切か分からず英語のままにしていました。対応します。

b6e5f8a で修正しました。

morinokami · 2025-02-07T05:33:36Z

src/content/docs/ja/guides/deploy/github.mdx

+
+#### `base`
+
+Astroがあなたのリポジトリ名をウェブサイトのルートとして扱うように `base` の値が必要な場合があります。


細かいですが、原文の

(e.g. /my-repo)

の部分が欠落してしまっているようです。

対応します。

8a0f3c5 で修正しました。

morinokami · 2025-02-07T05:35:49Z

src/content/docs/ja/guides/deploy/github.mdx

+- リポジトリが `https://github.com/<USERNAME>/<USERNAME>.github.io` にある場合。
+:::
+
+`base` には、`/my-blog` のように、スラッシュで始まるリポジトリ名を指定します。これは、Astroがあなたのウェブサイトのルートがデフォルトの `/` ではなく、`/my-repo` であることを理解するためです。


こちらも細かいですが、最後の「理解するためです」は「理解できるようにするためです」が日本語として自然かと思いました:

Suggested change

`base` には、`/my-blog` のように、スラッシュで始まるリポジトリ名を指定します。これは、Astroがあなたのウェブサイトのルートがデフォルトの `/` ではなく、`/my-repo` であることを理解するためです。

`base`には、`/my-blog`のように、スラッシュで始まるリポジトリ名を指定します。これは、Astroがあなたのウェブサイトのルートがデフォルトの`/`ではなく、`/my-repo`であることを理解できるようにするためです。

これも修正前のもともとの文章をそのまま使っていました。修正します。

7f00d40 で修正しました。

morinokami · 2025-02-07T05:37:53Z

src/content/docs/ja/guides/deploy/github.mdx


-2. プロジェクトの `.github/workflows/deploy.yml` に新しいファイルを作成し、以下のYAMLを貼り付けます。
+:::tip[カスタムドメインの設定]
+以下の `./public/CNAME` ファイルをプロジェクトに追加することで、カスタムドメインを設定することができます。


こちらも https://github.com/withastro/docs/blob/main/i18n-guides/%E6%97%A5%E6%9C%AC%E8%AA%9E.md にあるのですが、「することができます」などは表現として冗長なためなるべく使用しないようにしており、ここも不要かと思います:

Suggested change

以下の `./public/CNAME` ファイルをプロジェクトに追加することで、カスタムドメインを設定することができます。

以下の`./public/CNAME`ファイルをプロジェクトに追加することで、カスタムドメインを設定できます。

修正します。

fb46a62 で修正しました。

morinokami · 2025-02-12T02:17:41Z

@debiru こちらコメントしておりますので、まだであればご確認をお願いいたします！

debiru · 2025-02-12T03:23:23Z

@morinokami おっとすみません。今気づきました。もろもろ対応します。

morinokami

関係ない箇所も含め対応いただきありがとうございました、LGTM! 👍

yanthomasdev

LGTM! Good job! 🙌

github-actions bot added the i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! label Feb 1, 2025

morinokami reviewed Feb 2, 2025

View reviewed changes

The version of action we are using is out of date and github pages de…

9be0bc1

…ploy fails, so we updated it.

debiru force-pushed the fix/update-guides-deploy-github branch from c3e2937 to 9be0bc1 Compare February 2, 2025 14:23

Updated translation based on English version [128070a]

429d468

debiru requested a review from morinokami February 2, 2025 15:28

morinokami reviewed Feb 7, 2025

View reviewed changes

debiru added 6 commits February 12, 2025 12:43

trim whitespaces of English words

cd33689

Re-translate wording; site and base options

d5d2b3a

Re-translate wording; GitHub Organization's private page

b6e5f8a

Re-translate wording; e.g. /my-repo

8a0f3c5

Re-translate wording; understands

7f00d40

Re-translate wording; can

fb46a62

debiru requested a review from morinokami February 12, 2025 04:03

morinokami approved these changes Feb 12, 2025

View reviewed changes

Merge branch 'main' into fix/update-guides-deploy-github

c6bae12

yanthomasdev approved these changes Feb 12, 2025

View reviewed changes

yanthomasdev merged commit 3810067 into withastro:main Feb 12, 2025
10 checks passed

debiru deleted the fix/update-guides-deploy-github branch February 13, 2025 01:48

debiru mentioned this pull request Feb 28, 2025

i18n(ja): Add new guides/upgrade-to/v5.mdx translation #11102

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

i18n(ja): Update github.mdx i18n #10867

i18n(ja): Update github.mdx i18n #10867

debiru commented Feb 1, 2025

netlify bot commented Feb 1, 2025 •

edited

Loading

astrobot-houston commented Feb 1, 2025 •

edited

Loading

astrobot-houston commented Feb 1, 2025

morinokami left a comment

debiru commented Feb 2, 2025

debiru commented Feb 2, 2025

morinokami left a comment

morinokami Feb 7, 2025

morinokami Feb 7, 2025

debiru Feb 12, 2025

debiru Feb 12, 2025

morinokami Feb 7, 2025

debiru Feb 12, 2025

morinokami Feb 7, 2025

debiru Feb 12, 2025

debiru Feb 12, 2025

morinokami Feb 7, 2025

debiru Feb 12, 2025

debiru Feb 12, 2025

morinokami Feb 7, 2025

debiru Feb 12, 2025

debiru Feb 12, 2025

morinokami Feb 7, 2025

debiru Feb 12, 2025

debiru Feb 12, 2025

morinokami Feb 7, 2025

debiru Feb 12, 2025

debiru Feb 12, 2025

morinokami commented Feb 12, 2025

debiru commented Feb 12, 2025

morinokami left a comment

yanthomasdev left a comment

	Astroは公式の `withastro/action` を保守しており、ほとんど設定することなくプロジェクトをデプロイすることができます。以下の手順に従って、AstroサイトをGitHubページにデプロイしてください。さらに詳しい情報が必要な場合は、[パッケージのREADME](https://github.com/withastro/action)を参照してください。
	Astroは公式の`withastro/action`を保守しており、ほとんど設定することなくプロジェクトをデプロイすることができます。以下の手順に従って、AstroサイトをGitHubページにデプロイしてください。さらに詳しい情報が必要な場合は、[パッケージのREADME](https://github.com/withastro/action)を参照してください。

	### `github.io` のURLにデプロイする
	### `github.io`のURLにデプロイする


		#### `base`

		Astroがあなたのリポジトリ名をウェブサイトのルートとして扱うように `base` の値が必要な場合があります。

	`base` には、`/my-blog` のように、スラッシュで始まるリポジトリ名を指定します。これは、Astroがあなたのウェブサイトのルートがデフォルトの `/` ではなく、`/my-repo` であることを理解するためです。
	`base`には、`/my-blog`のように、スラッシュで始まるリポジトリ名を指定します。これは、Astroがあなたのウェブサイトのルートがデフォルトの`/`ではなく、`/my-repo`であることを理解できるようにするためです。

	以下の `./public/CNAME` ファイルをプロジェクトに追加することで、カスタムドメインを設定することができます。
	以下の`./public/CNAME`ファイルをプロジェクトに追加することで、カスタムドメインを設定できます。

i18n(ja): Update github.mdx i18n #10867

i18n(ja): Update github.mdx i18n #10867

Conversation

debiru commented Feb 1, 2025

Description (required)

Related issues & labels (optional)

netlify bot commented Feb 1, 2025 • edited Loading

✅ Deploy Preview for astro-docs-2 ready!

astrobot-houston commented Feb 1, 2025 • edited Loading

Lunaria Status Overview

Tracked Files

astrobot-houston commented Feb 1, 2025

morinokami left a comment

Choose a reason for hiding this comment

debiru commented Feb 2, 2025

debiru commented Feb 2, 2025

morinokami left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

morinokami commented Feb 12, 2025

debiru commented Feb 12, 2025

morinokami left a comment

Choose a reason for hiding this comment

yanthomasdev left a comment

Choose a reason for hiding this comment

netlify bot commented Feb 1, 2025 •

edited

Loading

astrobot-houston commented Feb 1, 2025 •

edited

Loading