Zenn
Open2

【メモ】Windowsでの日本語版MDN Web Docsへのコントリビュート方法と作法

OSS
メモ
mdn
tez3998tez3998

作法

  • 画像ファイルのURLはファイル名だけにする（日本語版にその名前の画像がないと自動で英語版の画像に差し替えられる）。
tez3998tez3998

ローカルサーバーを立てて、アクセスする手順

基本的には公式レポジトリのREADMEに従う。

  1. Node.jsの公式サイトからインストーラをダウンロードする
  2. インストーラを実行する
  3. Windows Powershellを開く
  4. 以下のコマンドでyarnをインストールする
npm install -g yarn
  1. contentレポジトリをforkして、cloneする（forkするかは好み次第）
  2. translated-contentレポジトリをforkして、cloneする
  3. cloneしてきたcontentフォルダ（translated-contentフォルダではないので注意）まで移動する
cd path/to/content
  1. 以下のように、必要なパッケージをインストールする
yarn install
  1. 以下のように、cloneしてきたtranslated-contentフォルダの中のfilesフォルダまでの絶対パスをCONTENT_TRANSLATED_ROOTという名前の環境変数に格納する（先頭の”C”はストレージの名前により変わり得る）
$env:CONTENT_TRANSLATED_ROOT="C:\path\to\translated-content\files"
  1. 以下のように、ローカルサーバーを立てる
yarn start
  1. 以下のような、ローカルサーバーのポートが表示されていることを確認する
...（省略）
Listening on port 5042
...（省略）
  1. ブラウザを開き、手順10で確認したポートにアクセスすると、ローカルで展開されたMDN Web Docsにアクセスできる
http://localhost:5042/ja/