kou029w/js-primer

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

JavaScript Primer

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

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

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

• ウェブ版: https://jsprimer.net/

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

• 物理書籍とKindle: JavaScript Primer 改訂2版 迷わないための入門書 | azu, Suguru Inatomi |本 | 通販 | Amazon
• PDFとepub: JavaScript Primer 迷わないための入門書【委託】 - 達人出版会 （2023-06-03時点では初版のままです）

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

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

書籍への支援方法

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

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

• Sponsor @azu on GitHub Sponsors

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

• JavaScript Primer - Open Collective

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

• JavaScript Primer 改訂2版 迷わないための入門書 | azu, Suguru Inatomi |本 | 通販 | Amazon

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

• Discussions · asciidwango/js-primer

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

• 👋 ようこそ JavaScript Primer へ ! · Discussion #1304 · asciidwango/js-primer

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

• 文章の間違いに気づいたら · JavaScript Primer #jsprimer

⚠️ Status ⚠️

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

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

• Meeting Notes

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

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

• 更新通知を受け取るメールアドレスを登録するフォーム

Installation

npm install

Node.js v18.14.0以上とnpm 9.3.1以上が必要です。

$ node -v
v18.14.0
$ npm -v
9.3.1

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は次のライセンスで配布されています。

• ソースコード: MITライセンス
• 文章: CC BY 4.0

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

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

Project Member

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

• azu(@azu)
• Suguru Inatomi(@lacolaco)

Contact

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

• 文章の間違いに気づいたら · JavaScript Primer #jsprimer

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

• jsprimer.netの感想/フィードバック

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

• [email protected]

OSS Supporters