npm-README - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

NPM - một trình quản lý gói JavaScript

Trạng thái xây dựng https://travis-ci.org/npm/npm

SYNOPSIS

Đây là thông tin vừa đủ để giúp bạn thiết lập và hoạt động.

Nhiều thông tin hơn có sẵn qua NPM giúp đỡ sau khi nó được cài đặt.

QUAN TRỌNG

Bạn nhu cầu nút v0.8 or cao hơn đến chạy điều này chương trình.

Để cài đặt một cái cũ và không được hỗ trợ phiên bản npm hoạt động trên nút 0.3 và trước đó, bản sao
repo git và đào qua các thẻ và nhánh cũ.

NPM is cấu hình đến sử dụng npm, Của Inc. công khai gói đăng ký at https://registry.npmjs.org
theo mặc định.

Bạn có thể định cấu hình npm để sử dụng bất kỳ sổ đăng ký tương thích nào mà bạn thích và thậm chí chạy
đăng ký. Kiểm tra tài liệu trên sổ đăng ký https://docs.npmjs.com/misc/registry.

Việc sử dụng sổ đăng ký của người khác có thể được điều chỉnh bởi các điều khoản sử dụng. Các điều khoản sử dụng cho
đăng ký công khai mặc định có sẵn tại https://www.npmjs.com.

lớn Dễ dàng đặt

npm được đóng gói với nút http://nodejs.org/download/.

Windows Máy vi tính
Nhận MSI http://nodejs.org/download/. npm ở trong đó.

Apple Áo tơi đi mưa Máy vi tính
Nhận pkg http://nodejs.org/download/. npm ở trong đó.

Nền tảng khác Sắp xếp of Hợp nhất
chạy làm cho cài đặt, dựng lên. npm sẽ được cài đặt với nút.

Nếu bạn muốn cài một chiếc quần lạ mắt hơn (một phiên bản khác, các đường dẫn tùy chỉnh, v.v.) thì
đọc tiếp

tưởng tượng đặt (Unix)

Có một tập lệnh cài đặt khá mạnh mẽ tại https://www.npmjs.com/install.sh. Bạn có thể
tải xuống và chạy nó.

Đây là một ví dụ sử dụng curl:

curl -L https://www.npmjs.com/install.sh | NS

Hơi Người yêu thích
Bạn có thể đặt bất kỳ thông số cấu hình npm nào bằng tập lệnh đó:

npm_config_prefix = / some / path sh install.sh

Hoặc, bạn có thể chạy nó ở chế độ gỡ lỗi uber:

npm_debug = 1 sh install.sh

Ngay cả Người yêu thích
Nhận mã bằng git. Sử dụng làm cho để xây dựng tài liệu và làm những thứ khác. Nếu bạn có kế hoạch
hack vào npm, làm cho liên kết này là bạn của bạn.

Nếu bạn đã có mã nguồn npm, bạn cũng có thể đặt bán vĩnh viễn các khóa cấu hình tùy ý
bằng cách sử dụng / Cấu hình. --key = val ...và sau đó chạy các lệnh npm bằng cách thực hiện nút cli.js
. (Điều này hữu ích cho việc thử nghiệm hoặc chạy nội dung mà không thực sự cài đặt npm
chinh no.)

Windows đặt or Upgrade

Bạn có thể tải xuống một tệp zip từ https://github.com/npm/npm/releasesvà giải nén nó trong
node_modules \ npm \ thư mục bên trong thư mục cài đặt của nút.

Để nâng cấp lên npm 2, hãy làm theo hướng dẫn nâng cấp Windows trong phần Khắc phục sự cố npm
Hướng dẫn:

https://github.com/npm/npm/wiki/Troubleshooting#upgrading-on-windows

Nếu điều đó không đủ ưa thích đối với bạn, thì bạn có thể tìm nạp mã bằng git và làm rối với nó
trực tiếp.

Cài đặt on Cygwin

Không.

Gỡ cài đặt

Rất buồn khi thấy bạn ra đi.

sudo npm gỡ cài đặt npm -g

Hoặc, nếu thất bại,

sudo thực hiện gỡ cài đặt

Xem thêm Nghiêm trọng Gỡ cài đặt

Thông thường, các hướng dẫn trên là đủ. Điều đó sẽ loại bỏ npm, nhưng để lại phía sau
bất cứ thứ gì bạn đã cài đặt.

Nếu bạn muốn xóa tất cả các gói mà bạn đã cài đặt, thì bạn có thể sử dụng
NPM ls lệnh để tìm chúng, và sau đó NPM rm để loại bỏ chúng.

Để loại bỏ phần vụn bị bỏ lại sau npm 0.x, bạn có thể sử dụng sạch-cũ.sh tập kịch bản.
Bạn có thể chạy nó một cách thuận tiện như thế này:

npm khám phá npm -g - sh scripts / clean-old.sh

npm sử dụng hai tệp cấu hình, một tệp cho cấu hình cho mỗi người dùng và một tệp khác cho toàn cầu
(mọi người dùng) cấu hình. Bạn có thể xem chúng bằng cách thực hiện:

cấu hình npm lấy cấu hình người dùng # mặc định thành ~ / .npmrc
npm config get globalconfig # defaults to / usr / local / etc / npmrc

Gỡ cài đặt npm không xóa các tệp cấu hình theo mặc định. Bạn phải loại bỏ chúng
cho mình theo cách thủ công nếu bạn muốn chúng biến mất. Lưu ý rằng điều này có nghĩa là số lượt cài đặt npm trong tương lai
sẽ không nhớ các cài đặt mà bạn đã chọn.

Sử dụng NPM Có lập trình

Mặc dù npm có thể được sử dụng theo chương trình, nhưng API của nó được sử dụng bởi CLI có thể và
không có đảm bảo nào được thực hiện về tính phù hợp của nó cho bất kỳ mục đích nào khác. Nếu bạn muốn sử dụng npm
để thực hiện một cách đáng tin cậy một số tác vụ, điều an toàn nhất cần làm là gọi ra NPM lệnh
với những lý lẽ phù hợp.

Phiên bản ngữ nghĩa của npm đề cập đến chính CLI, thay vì API cơ bản. Sản phẩm
nội bộ API is không đảm bảo đến vẫn ổn định cũng khi nào npm's phiên bản chỉ Không
phá vỡ thay đổi có được thực hiện theo đến học kỳ.

Nếu bạn vẫn còn muốn sử dụng npm theo lập trình, nó là có thể. API không phải là rất
được ghi chép đầy đủ, nhưng nó is khá đơn giản.

Cuối cùng, npm sẽ chỉ là một lớp bao bọc CLI mỏng xung quanh các mô-đun mà nó phụ thuộc vào, nhưng
hiện tại, có một số điều mà chỉ CLI có thể làm. Bạn nên thử sử dụng một trong các
phụ thuộc trước tiên và chỉ sử dụng API nếu những gì bạn đang cố gắng thực hiện chỉ được hỗ trợ bởi
npm chính nó.

var npm = request ("npm")
npm.load (myConfigObject, function (er) {
if (er) return handlError (er)
npm.commands.install (["some", "args"], function (er, data) {
if (er) return command Không thành công (er)
// lệnh đã thành công và dữ liệu có thể có một số thông tin
})
npm.registry.log.on ("nhật ký", hàm (thông báo) {....})
})

Sản phẩm tải hàm nhận một băm đối tượng của các cấu hình dòng lệnh. Sự đa dạng
npm.commands. các chức năng có một mảng của đối số vị trí dây. Cuối cùng
đối số với bất kỳ npm.commands. hàm là một cuộc gọi lại. Một số lệnh khác
đối số tùy chọn. Đọc nguồn.

Bạn không thể đặt cấu hình riêng lẻ cho bất kỳ hàm npm đơn lẻ nào tại thời điểm này. Từ NPM is
một singleton, bất kỳ cuộc gọi nào tới npm.config.set sẽ thay đổi giá trị cho tất cả các lệnh npm trong đó
quá trình.

Xem ./bin/npm-cli.js cho một ví dụ về kéo các giá trị cấu hình ra khỏi dòng lệnh
đối số bằng cách sử dụng nopt. Bạn cũng có thể muốn kiểm tra NPM giúp đỡ cấu hình để tìm hiểu về tất cả
các tùy chọn bạn có thể đặt ở đó.

Xem thêm Tài liệu

Kiểm tra các tài liệu https://docs.npmjs.com/, đặc biệt là câu hỏi thường gặp
https://docs.npmjs.com/misc/faq.

Bạn có thể sử dụng NPM giúp đỡ lệnh đọc bất kỳ lệnh nào trong số chúng.

Nếu bạn là một nhà phát triển và bạn muốn sử dụng npm để xuất bản chương trình của mình, bạn nên đọc
điều này https://docs.npmjs.com/misc/developers

Sử dụng npm-README trực tuyến bằng các dịch vụ onworks.net