/js-primer

:book: JavaScript Primer - 迷わないための入門書

Primary LanguageJavaScriptCreative Commons Attribution 4.0 InternationalCC-BY-4.0

JavaScript Primer Actions Status

この書籍はECMAScript 2015以降をベースとしたJavaScriptの入門書です。

今のJavaScriptがよくわからないという人が、 今のJavaScriptアプリケーションを読み書きできるようになる目的の書籍です。

ウェブ版は次のURLから閲覧できます。

書籍版は次のページから購入できます。

ウェブ版と書籍版の内容は基本的には同じです。 詳細はウェブ版と書籍版の違いを参照してください。

Twitterのハッシュタグは #jsprimer です。

書籍への支援方法

JavaScript PrimerはECMAScriptのアップデートに追従したり、現実の使い方を反映するために、継続してアップデートしています。 継続的にアップデートするために、書籍への支援はいつでも歓迎しています。

GitHub Sponsorsで著者を支援できます。

Open Collectiveでjsprimerプロジェクトを支援できます。 Open Collectiveでの支援には、サイト上にロゴを表示するといった企業向けの特典があります。

Gold Sponsors

jsprimer sponsors

Supporters

jsprimer backers

また、書籍版へのレビューを書くことも支援に繋がります。

GitHubのDiscussions(掲示板)の他の人の質問に答えたり、JSPrimerを読んだ感想を書くことも支援になります。

Discussionsのガイドラインは次のスレッドにまとめられています。

書籍に対してIssueを立てたり、Pull Requestを送ったりして直接的に支援もできます。 IssueやPull Requestについては、次のページを参照してください。

⚠️ Status ⚠️

この書籍は開発中の内容となっています。

どのような経緯で動いているかはミーティングノートを参照してください。

リポジトリの更新を追いたい方はリポジトリをWatchしてください。

Watch button

また、下記フォームからメールアドレスを登録しておくと更新情報を受け取れます。

Installation

# corepackを有効化
corepack enable
# インストール
npm ci

開発は次のバージョンのNode.jsとnpmで行われています。

$ node -v
v22.7.0
$ npm -v
10.8.2

Usage

Build

HonKitのbuildをします。

npm run build

Watch

HonKitのbuildかつWatchをします。 プレビューをする場合は、ローカルサーバーを利用してください。

次のコマンドを実行後、http://localhost:4000/へアクセスすることでプレビューを見られます。

npm run start
# open http://localhost:4000/

Test

このプロジェクトでは文章やコードに対してテストを実行しています。 文章中のインラインコードのテスト、特定のファイル名にもとづくテスト、コメントを使ったDocTestなどが含まれます。

以下のコマンドを実行すると全てのテストが実行されます。

npm install && npm test

詳しくは CONTRIBUTING.md を見てください。

Contributing

小さなtypoでもIssueやPull Requestを歓迎しています。

コントリビュートの方法や確認方法についてはCONTRIBUTING.mdを参照してください。 また文章の間違いに気づいたらも参照してください。

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

CODE_OF_CONDUCTもあわせて参照してください。

License

Copyright (c) 2016-present jsprimer project

jsprimerは次のライセンスで配布されています。

ソースコード とは、書籍中のサンプルコードやこのプロジェクトを構成するプログラムのソースコードを示します。 主にJavaScriptファイルに書かれたコードやMarkdownのコードブロックに書かれているサンプルコードを指します。

文章とは、書籍の文章やサイト上の文章を示します。 主にMarkdownファイル書かれている文章を指します。

Project Member

jsprimerプロジェクトは次のメンバーで構成されています。

Contact

バグ報告は次のページを参照してください。

感想などのフィードバックには次のフォームを利用してください。

その他の連絡は次のメールアドレスに送ってください。

OSS Supporters

Netlify