search

asciidwango / js-primer

:book: JavaScript Primer - 迷わないための入門書
https://jsprimer.net
Creative Commons Attribution 4.0 International
2.34k stars 224 forks source link
book browser ecmascript javascript nodejs tutorial

readme

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については、次のページを参照してください。

:warning: Status :warning:

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

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

リポジトリの更新を追いたい方はリポジトリを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