install.html 7.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226
  1. <html><head>
  2. <title>install</title>
  3. <style>
  4. body {
  5. background-color: #ffffff;
  6. color: #24292e;
  7. margin: 0;
  8. line-height: 1.5;
  9. font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
  10. }
  11. #rainbar {
  12. height: 10px;
  13. background-image: linear-gradient(139deg, #fb8817, #ff4b01, #c12127, #e02aff);
  14. }
  15. a {
  16. text-decoration: none;
  17. color: #0366d6;
  18. }
  19. a:hover {
  20. text-decoration: underline;
  21. }
  22. pre {
  23. margin: 1em 0px;
  24. padding: 1em;
  25. border: solid 1px #e1e4e8;
  26. border-radius: 6px;
  27. display: block;
  28. overflow: auto;
  29. white-space: pre;
  30. background-color: #f6f8fa;
  31. color: #393a34;
  32. }
  33. code {
  34. font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, Courier, monospace;
  35. font-size: 85%;
  36. padding: 0.2em 0.4em;
  37. background-color: #f6f8fa;
  38. color: #393a34;
  39. }
  40. pre > code {
  41. padding: 0;
  42. background-color: inherit;
  43. color: inherit;
  44. }
  45. h1, h2, h3 {
  46. font-weight: 600;
  47. }
  48. #logobar {
  49. background-color: #333333;
  50. margin: 0 auto;
  51. padding: 1em 4em;
  52. }
  53. #logobar .logo {
  54. float: left;
  55. }
  56. #logobar .title {
  57. font-weight: 600;
  58. color: #dddddd;
  59. float: left;
  60. margin: 5px 0 0 1em;
  61. }
  62. #logobar:after {
  63. content: "";
  64. display: block;
  65. clear: both;
  66. }
  67. #content {
  68. margin: 0 auto;
  69. padding: 0 4em;
  70. }
  71. #table_of_contents > h2 {
  72. font-size: 1.17em;
  73. }
  74. #table_of_contents ul:first-child {
  75. border: solid 1px #e1e4e8;
  76. border-radius: 6px;
  77. padding: 1em;
  78. background-color: #f6f8fa;
  79. color: #393a34;
  80. }
  81. #table_of_contents ul {
  82. list-style-type: none;
  83. padding-left: 1.5em;
  84. }
  85. #table_of_contents li {
  86. font-size: 0.9em;
  87. }
  88. #table_of_contents li a {
  89. color: #000000;
  90. }
  91. header.title {
  92. border-bottom: solid 1px #e1e4e8;
  93. }
  94. header.title > h1 {
  95. margin-bottom: 0.25em;
  96. }
  97. header.title > .description {
  98. display: block;
  99. margin-bottom: 0.5em;
  100. line-height: 1;
  101. }
  102. footer#edit {
  103. border-top: solid 1px #e1e4e8;
  104. margin: 3em 0 4em 0;
  105. padding-top: 2em;
  106. }
  107. </style>
  108. </head>
  109. <body>
  110. <div id="banner">
  111. <div id="rainbar"></div>
  112. <div id="logobar">
  113. <svg class="logo" role="img" height="32" width="32" viewBox="0 0 700 700">
  114. <polygon fill="#cb0000" points="0,700 700,700 700,0 0,0"></polygon>
  115. <polygon fill="#ffffff" points="150,550 350,550 350,250 450,250 450,550 550,550 550,150 150,150"></polygon>
  116. </svg>
  117. <div class="title">
  118. npm command-line interface
  119. </div>
  120. </div>
  121. </div>
  122. <section id="content">
  123. <header class="title">
  124. <h1 id="install">install</h1>
  125. <span class="description">Download and install node and npm</span>
  126. </header>
  127. <section id="table_of_contents">
  128. <h2 id="table-of-contents">Table of contents</h2>
  129. <div id="_table_of_contents"><ul><li><a href="#description">Description</a></li><li><a href="#overview">Overview</a></li><li><a href="#checking-your-version-of-npm-and-nodejs">Checking your version of npm and Node.js</a></li><li><a href="#using-a-node-version-manager-to-install-nodejs-and-npm">Using a Node version manager to install Node.js and npm</a></li><ul><li><a href="#osx-or-linux-node-version-managers">OSX or Linux Node version managers</a></li><li><a href="#windows-node-version-managers">Windows Node version managers</a></li></ul><li><a href="#using-a-node-installer-to-install-nodejs-and-npm">Using a Node installer to install Node.js and npm</a></li><ul><li><a href="#os-x-or-windows-node-installers">OS X or Windows Node installers</a></li><li><a href="#linux-or-other-operating-systems-node-installers">Linux or other operating systems Node installers</a></li><li><a href="#less-common-operating-systems">Less-common operating systems</a></li></ul></ul></div>
  130. </section>
  131. <div id="_content"><h3 id="description">Description</h3>
  132. <p>To publish and install packages to and from the public npm registry, you
  133. must install Node.js and the npm command line interface using either a Node
  134. version manager or a Node installer. <strong>We strongly recommend using a Node
  135. version manager to install Node.js and npm.</strong> We do not recommend using a
  136. Node installer, since the Node installation process installs npm in a
  137. directory with local permissions and can cause permissions errors when you
  138. run npm packages globally.</p>
  139. <h3 id="overview">Overview</h3>
  140. <ul>
  141. <li><a href="#checking-your-version-of-npm-and-node-js">Checking your version of npm and
  142. Node.js</a></li>
  143. <li><a href="#using-a-node-version-manager-to-install-node-js-and-npm">Using a Node version manager to install Node.js and
  144. npm</a></li>
  145. <li><a href="#using-a-node-installer-to-install-node-js-and-npm">Using a Node installer to install Node.js and
  146. npm</a></li>
  147. </ul>
  148. <h3 id="checking-your-version-of-npm-and-nodejs">Checking your version of npm and Node.js</h3>
  149. <p>To see if you already have Node.js and npm installed and check the
  150. installed version, run the following commands:</p>
  151. <pre><code>node -v
  152. npm -v
  153. </code></pre>
  154. <h3 id="using-a-node-version-manager-to-install-nodejs-and-npm">Using a Node version manager to install Node.js and npm</h3>
  155. <p>Node version managers allow you to install and switch between multiple
  156. versions of Node.js and npm on your system so you can test your
  157. applications on multiple versions of npm to ensure they work for users on
  158. different versions.</p>
  159. <h4 id="osx-or-linux-node-version-managers">OSX or Linux Node version managers</h4>
  160. <ul>
  161. <li><a href="https://github.com/creationix/nvm">nvm</a></li>
  162. <li><a href="https://github.com/tj/n">n</a></li>
  163. </ul>
  164. <h4 id="windows-node-version-managers">Windows Node version managers</h4>
  165. <ul>
  166. <li><a href="https://github.com/marcelklehr/nodist">nodist</a></li>
  167. <li><a href="https://github.com/coreybutler/nvm-windows">nvm-windows</a></li>
  168. </ul>
  169. <h3 id="using-a-node-installer-to-install-nodejs-and-npm">Using a Node installer to install Node.js and npm</h3>
  170. <p>If you are unable to use a Node version manager, you can use a Node
  171. installer to install both Node.js and npm on your system.</p>
  172. <ul>
  173. <li><a href="https://nodejs.org/en/download/">Node.js installer</a></li>
  174. <li><a href="https://github.com/nodesource/distributions">NodeSource installer</a>. If
  175. you use Linux, we recommend that you use a NodeSource installer.</li>
  176. </ul>
  177. <h4 id="os-x-or-windows-node-installers">OS X or Windows Node installers</h4>
  178. <p>If you’re using OS X or Windows, use one of the installers from the
  179. <a href="https://nodejs.org/en/download/">Node.js download page</a>. Be sure to
  180. install the version labeled <strong>LTS</strong>. Other versions have not yet been
  181. tested with npm.</p>
  182. <h4 id="linux-or-other-operating-systems-node-installers">Linux or other operating systems Node installers</h4>
  183. <p>If you’re using Linux or another operating system, use one of the following
  184. installers:</p>
  185. <ul>
  186. <li><a href="https://github.com/nodesource/distributions">NodeSource installer</a>
  187. (recommended)</li>
  188. <li>One of the installers on the <a href="https://nodejs.org/en/download/">Node.js download
  189. page</a></li>
  190. </ul>
  191. <p>Or see <a href="https://nodejs.org/en/download/package-manager/">this page</a> to
  192. install npm for Linux in the way many Linux developers prefer.</p>
  193. <h4 id="less-common-operating-systems">Less-common operating systems</h4>
  194. <p>For more information on installing Node.js on a variety of operating
  195. systems, see <a href="https://nodejs.org/en/download/package-manager/">this page</a>.</p>
  196. </div>
  197. <footer id="edit">
  198. <a href="https://github.com/npm/cli/edit/latest/docs/content/configuring-npm/install.md">
  199. <svg role="img" viewBox="0 0 16 16" width="16" height="16" fill="currentcolor" style="vertical-align: text-bottom; margin-right: 0.3em;">
  200. <path fill-rule="evenodd" d="M11.013 1.427a1.75 1.75 0 012.474 0l1.086 1.086a1.75 1.75 0 010 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 01-.927-.928l.929-3.25a1.75 1.75 0 01.445-.758l8.61-8.61zm1.414 1.06a.25.25 0 00-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 000-.354l-1.086-1.086zM11.189 6.25L9.75 4.81l-6.286 6.287a.25.25 0 00-.064.108l-.558 1.953 1.953-.558a.249.249 0 00.108-.064l6.286-6.286z"></path>
  201. </svg>
  202. Edit this page on GitHub
  203. </a>
  204. </footer>
  205. </section>
  206. </body></html>