source: general/genlib/nodejs.xml@ 45ab6c7

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 6 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 7.3 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY nodejs-download-http "https://nodejs.org/dist/v&nodejs-version;/node-v&nodejs-version;.tar.xz">
8 <!ENTITY nodejs-download-ftp " ">
9 <!ENTITY nodejs-md5sum "0483d8d477b33fce65fd8cfbded088ca">
10 <!ENTITY nodejs-size "32 MB">
11 <!ENTITY nodejs-buildsize "727 MB (add 16 MB for tests)">
12 <!ENTITY nodejs-time "11 SBU (using parallelism=4; add 2.0 SBU for tests)">
13 <!-- time might be longer on intel, on AMD the initial LFS SBU is very slow -->
14]>
15
16<sect1 id="nodejs" xreflabel="nodejs-&nodejs-version;">
17 <?dbhtml filename="nodejs.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Node.js-&nodejs-version;</title>
24
25 <indexterm zone="nodejs">
26 <primary sortas="a-nodejs">nodejs</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Node.js</title>
31
32 <para>
33 <application>Node.js</application> is a
34 <application>JavaScript</application> runtime built on
35 <application>Chrome's</application> V8 JavaScript engine.
36 </para>
37
38 &lfs101_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&nodejs-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&nodejs-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &nodejs-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &nodejs-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &nodejs-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &nodejs-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74<!--<note>
75 <para>
76 This tarball was created using a BSD version of
77 <application>tar</application> and extracting it with a linux&trade;
78 version will produce harmless warnings about unknown extended header
79 keywords.
80 </para>
81 </note>-->
82
83 <bridgehead renderas="sect3">Node.js Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
86 <para role="required">
87 <xref linkend="which"/>
88 </para>
89
90 <bridgehead renderas="sect4">Recommended</bridgehead>
91 <para role="recommended">
92 <xref linkend="c-ares"/>,
93 <xref linkend="icu"/>,
94 <xref linkend="libuv"/>, and
95 <xref linkend="nghttp2"/>
96 </para>
97
98 <bridgehead renderas="sect4">Optional</bridgehead>
99 <para role="optional">
100 <ulink url="https://github.com/nodejs/http-parser">http-parser</ulink> and
101 <ulink url="https://www.npmjs.com/">npm</ulink> (an internal copy of
102 <command>npm</command> will be installed if not present)
103 </para>
104
105 <para condition="html" role="usernotes">
106 User Notes: <ulink url="&blfs-wiki;/nodejs"/>
107 </para>
108
109 </sect2>
110
111 <sect2 role="installation">
112 <title>Installation of Node.js</title>
113
114 <para>
115 Build <application>Node.js</application> by running the following
116 commands:
117 </para>
118
119<screen><userinput>./configure --prefix=/usr \
120 --shared-cares \
121 --shared-libuv \
122 --shared-openssl \
123 --shared-nghttp2 \
124 --shared-zlib \
125 --with-intl=system-icu &amp;&amp;
126make</userinput></screen>
127
128 <para>
129 To test the results, issue: <command>make test-only</command>.
130 <!--One test, test-dns, is known to fail.-->
131 <!-- When using make check, a module is used that wasn't shipped properly
132 with the 12.16.2 release. See Ticket #13379 for details. We should
133 probably restore "make check" after the next version of Node.js.
134 This new command skips the documentation and lint checks. -renodr-->
135 </para>
136
137 <para>
138 Now, as the <systemitem class="username">root</systemitem> user:
139 </para>
140
141<screen role="root"><userinput>make install &amp;&amp;
142ln -sf node /usr/share/doc/node-&nodejs-version;</userinput></screen>
143 </sect2>
144
145 <sect2 role="commands">
146 <title>Command Explanations</title>
147
148 <para>
149 <parameter>--with-intl=system-icu</parameter>: use the system version
150 of <application>icu</application>. Other values are
151 <option>full-icu</option> (to build a local, full
152 <application>icu</application> library) and <option>small-icu</option>
153 (to build a local, minimal <application>icu</application> library).
154 </para>
155
156 <para>
157 <!-- FIXME : reinstate nghttp2 in this if build is fixed
158 FIXME cont: Seems to be fixed in 12.18.1 -renodr
159 <parameter>\-\-shared-{cares,libuv,nghttp2,openssl,zlib}</parameter>: -->
160 <parameter>--shared-{cares,libuv,nghttp2,openssl,zlib}</parameter>:
161 use the system installed libraries instead of local copies.
162 </para>
163
164 <para>
165 <option>--without-npm</option>: do not build
166 <application>npm</application> (use if you'd like to build a separate
167 <application>npm</application> later).
168 </para>
169
170 <para>
171 <option>--shared-http-parser</option>: use the system
172 installed library instead of a local copy.
173 </para>
174
175 </sect2>
176
177 <sect2 role="content">
178 <title>Contents</title>
179
180 <segmentedlist>
181 <segtitle>Installed Programs</segtitle>
182 <segtitle>Installed Library</segtitle>
183 <segtitle>Installed Directories</segtitle>
184
185 <seglistitem>
186 <seg>
187 node, npm, and npx
188 </seg>
189 <seg>
190 None
191 </seg>
192 <seg>
193 /usr/include/node,
194 /usr/lib/node_modules/npm,
195 /usr/share/doc/{node,node-&nodejs-version;}, and
196 /usr/share/systemtap/tapset
197 </seg>
198 </seglistitem>
199 </segmentedlist>
200
201 <variablelist>
202 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
203 <?dbfo list-presentation="list"?>
204 <?dbhtml list-presentation="table"?>
205
206 <varlistentry id="node">
207 <term><command>node</command></term>
208 <listitem>
209 <para>
210 is the server-side JavaScript runtime
211 </para>
212 <indexterm zone="nodejs node">
213 <primary sortas="b-node">node</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 <varlistentry id="npm">
219 <term><command>npm</command></term>
220 <listitem>
221 <para>
222 is the <application>Node.js</application> package manager
223 </para>
224 <indexterm zone="nodejs npm">
225 <primary sortas="b-npm">npm</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry>
231 <term>
232 <filename class="directory">/usr/lib/node_modules/npm/</filename>
233 </term>
234 <listitem>
235 <para>
236 is the installation root for Node.js executables and libraries
237 </para>
238 </listitem>
239 </varlistentry>
240
241 </variablelist>
242
243 </sect2>
244
245</sect1>
Note: See TracBrowser for help on using the repository browser.