89 lines
3.1 KiB
Groff
89 lines
3.1 KiB
Groff
.TH "NPM\-PUBLISH" "1" "November 2019" "" ""
|
|
.SH "NAME"
|
|
\fBnpm-publish\fR \- Publish a package
|
|
.SS Synopsis
|
|
.P
|
|
.RS 2
|
|
.nf
|
|
npm publish [<tarball>|<folder>] [\-\-tag <tag>] [\-\-access <public|restricted>] [\-\-otp otpcode] [\-\-dry\-run]
|
|
|
|
Publishes '\.' if no argument supplied
|
|
Sets tag 'latest' if no \-\-tag specified
|
|
.fi
|
|
.RE
|
|
.SS Description
|
|
.P
|
|
Publishes a package to the registry so that it can be installed by name\. All
|
|
files in the package directory are included if no local \fB\|\.gitignore\fP or
|
|
\fB\|\.npmignore\fP file exists\. If both files exist and a file is ignored by
|
|
\fB\|\.gitignore\fP but not by \fB\|\.npmignore\fP then it will be included\. See
|
|
npm help \fBdevelopers\fP for full details on what's included in the published package, as well as details on how the package is built\.
|
|
.P
|
|
By default npm will publish to the public registry\. This can be overridden by
|
|
specifying a different default registry or using a npm help \fBscope\fP in the name (see npm help \fBpackage\.json\fP)\.
|
|
.RS 0
|
|
.IP \(bu 2
|
|
\fB<folder>\fP:
|
|
A folder containing a package\.json file
|
|
.IP \(bu 2
|
|
\fB<tarball>\fP:
|
|
A url or file path to a gzipped tar archive containing a single folder
|
|
with a package\.json file inside\.
|
|
.IP \(bu 2
|
|
\fB[\-\-tag <tag>]\fP
|
|
Registers the published package with the given tag, such that \fBnpm install
|
|
<name>@<tag>\fP will install this version\. By default, \fBnpm publish\fP updates
|
|
and \fBnpm install\fP installs the \fBlatest\fP tag\. See \fBnpm\-dist\-tag\fP \fInpm\-dist\-tag\fR for
|
|
details about tags\.
|
|
.IP \(bu 2
|
|
\fB[\-\-access <public|restricted>]\fP
|
|
Tells the registry whether this package should be published as public or
|
|
restricted\. Only applies to scoped packages, which default to \fBrestricted\fP\|\.
|
|
If you don't have a paid account, you must publish with \fB\-\-access public\fP
|
|
to publish scoped packages\.
|
|
.IP \(bu 2
|
|
\fB[\-\-otp <otpcode>]\fP
|
|
If you have two\-factor authentication enabled in \fBauth\-and\-writes\fP mode
|
|
then you can provide a code from your authenticator with this\. If you
|
|
don't include this and you're running from a TTY then you'll be prompted\.
|
|
.IP \(bu 2
|
|
\fB[\-\-dry\-run]\fP
|
|
As of \fBnpm@6\fP, does everything publish would do except actually publishing
|
|
to the registry\. Reports the details of what would have been published\.
|
|
|
|
.RE
|
|
.P
|
|
Fails if the package name and version combination already exists in
|
|
the specified registry\.
|
|
.P
|
|
Once a package is published with a given name and version, that
|
|
specific name and version combination can never be used again, even if
|
|
it is removed with npm help \fBunpublish\fP\|\.
|
|
.P
|
|
As of \fBnpm@5\fP, both a sha1sum and an integrity field with a sha512sum of the
|
|
tarball will be submitted to the registry during publication\. Subsequent
|
|
installs will use the strongest supported algorithm to verify downloads\.
|
|
.P
|
|
Similar to \fB\-\-dry\-run\fP see npm help \fBpack\fP, which figures out the files to be
|
|
included and packs them into a tarball to be uploaded to the registry\.
|
|
.SS See Also
|
|
.RS 0
|
|
.IP \(bu 2
|
|
npm help registry
|
|
.IP \(bu 2
|
|
npm help scope
|
|
.IP \(bu 2
|
|
npm help adduser
|
|
.IP \(bu 2
|
|
npm help owner
|
|
.IP \(bu 2
|
|
npm help deprecate
|
|
.IP \(bu 2
|
|
npm help dist\-tag
|
|
.IP \(bu 2
|
|
npm help pack
|
|
.IP \(bu 2
|
|
npm help profile
|
|
|
|
.RE
|