/
index.template.html
254 lines (219 loc) · 10.4 KB
/
index.template.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<link rel="stylesheet" href="css/theme.css" />
<link rel="stylesheet" href="css/custom.css" />
<link href="https://fonts.googleapis.com/css?family=Raleway:400,300,600" rel="stylesheet" type="text/css" />
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css" />
<link rel="icon" href="images/favicon.ico" />
<link rel="stylesheet" href="css/prism-ghcolors.css" />
<meta name="description" content="ULua: Universal Lua Distribution" />
<meta name="author" content="Stefano Peluchetti" />
<title>ULua</title>
</head>
<body>
<nav class="navbar navbar-inverse navbar-fixed-top">
<div class="container-fluid">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#topnavbar">
<span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="index.html">ULua</a>
</div>
<div class="collapse navbar-collapse" id="topnavbar">
<ul class="nav navbar-nav">
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">Packages<span class="caret"></span></a>
<ul class="dropdown-menu">
<li><a href="native_packages.html">Native</a></li>
<li><a href="luarocks_packages.html">LuaRocks</a></li>
<li><a href="luarocks_autobuild.html">AutoBuild</a></li>
</ul>
</li>
<li><a href="pkg.html">Pkg</a></li>
<li class="dropdown">
<a class="dropdown-toggle" data-toggle="dropdown" href="#">More<span class="caret"></span></a>
<ul class="dropdown-menu">
<li><a href="https://github.com/uluadist">On Github</a></li>
<li><a href="specs.html">Specs</a></li>
<li><a href="license.html">License</a></li>
</ul>
</li>
</ul>
<ul class="nav navbar-nav navbar-right">
<li>
<a href="contact.html"><i class="fa fa-envelope-o"></i> Contact</a>
</li>
</ul>
</div>
</div>
</nav>
<div class="container-fluid">
<div class="jumbotron text-center">
<h1>ULua: Universal Lua Distribution</h1>
<a href="download/ulua~latest.zip" class="btn btn-primary" role="button" onclick="ga('send', 'event', 'download', 'binary', 'ulua')"
><i class="fa fa-download"></i> Download ULua</a
>
<p></p>
<div class="row">
<div class="col-sm-4">
<h2><i class="fa fa-archive"></i></h2>
<p>More than 300 binary packages updated daily from <a href="https://luarocks.org">Luarocks</a></p>
</div>
<div class="col-sm-4">
<h2><i class="fa fa-windows"></i> <i class="fa fa-apple"></i> <i class="fa fa-linux"></i></h2>
<p>For Windows (7 onward), OSX (10.5 onward) and Linux (2009 onward) in x86 and x64 variants</p>
</div>
<div class="col-sm-4">
<h2><i class="fa fa-bolt"></i></h2>
<p>No compiler required, no external dependencies, portable, powered by <a href="https://luajit.org">LuaJIT</a></p>
</div>
</div>
</div>
<p>
<b><span style="color: rgb(189, 68, 92)">Note:</span></b> ULua's packages have not been updated since the beginning of 2020. The ULua distribution continues to work,
and it will not get discontinued (it is entirely hosted on GitHub), but recent packages are currently not available. LuaJIT can be upgraded to the latest version by
overwriting the existing bundled version.
</p>
<p>
<em
>More details: managing the multiple VM hosts required to compile the packages is too time-consuming. A sensible alternative would be to migrate the current system to
rely on GitHub Actions, in which case the hosts would be managed and kept updated by GitHub. If you are interested in taking over ULua, or assist with this migration,
feel free to contact me.</em
>
</p>
<h2>Recently Updated</h2>
<table class="table">
<tr>
<th class="col-sm-2">Date</th>
<th>Module</th>
<th class="hidden-xs">Description</th>
<th class="col-sm-2">Version</th>
</tr>
${updates}
</table>
<h2>Install</h2>
<p>Unzip the downloaded file into an arbitrary folder. This will create a single sub-folder named <code>ulua</code> which contains the ULua distribution:</p>
<pre><code class="language-bash">
ulua
├── lua.cmd # LuaJIT executable for Windows.
├── lua # LuaJIT executable for OSX and Linux.
├── host
│ ├── config.lua # Global configuration (see PKG).
│ ├── init # Initialization scripts folder.
│ ├── tmp # Temporary files folder.
│ └── pkg # Downloaded packages cache folder.
├── bin
│ ├── upkg.cmd # Package manager executable for Windows.
│ ├── upkg # Package manager executable for OSX and Linux.
│ └── ... # Other executables depending on installed packages.
├── pkg # Package manager package.
└── ... # Other installed packages.
</code></pre>
<h2>Run</h2>
<p>
The <code>lua</code> executable starts LuaJIT, the <a href="https://www.lua.org/manual/5.1/manual.html#6">Lua manual</a> and the
<a href="https://luajit.org/running.html">LuaJIT manual</a> document its usage:
</p>
<pre><code class="language-bash">
# On Windows:
cd folder_containing_ulua/ulua
lua [options] [script [args]]
# On OSX and Linux:
cd folder_containing_ulua/ulua
./lua [options] [script [args]]
</code></pre>
<p>By default LuaJIT runs in 32-bit mode, to run it in 64-bit mode set the environment variable <code>BIT=64</code>:</p>
<pre><code class="language-bash">
set BIT=64 # On Windows.
export BIT=64 # On OSX and Linux.
</code></pre>
<p>
On Linux, if LuaJIT 32-bit is executed on a distribution lacking the 32-bit C runtime, this will result in a meaningless error such as
<code>luajit: command not found</code>. Either launch LuaJIT in 64-bit mode or install the required Linux libraries. OSX 10.15 (Catalina) similarly does not support
32-bit applications any longer, launching the 32-bit version of LuaJIT will result in the error message <code>luajit: Bad CPU type in executable</code>. Use the 64-bit
version of LuaJIT on OSX 10.15 onward.
</p>
<h2>Packages</h2>
<p>The <code>upkg</code> executable provides a convenient way of managing ULua:</p>
<pre><code class="language-bash">
# On Windows:
cd folder_containing_ulua/ulua/bin
upkg available # List all available packages.
upkg add socket # Download and install the socket package (LuaSocket library).
upkg add pl # Download and install the pl package (PenLight library).
upkg update # Update all packages to the latest version.
# On OSX and Linux:
cd folder_containing_ulua/ulua/bin
./upkg available # List all available packages.
./upkg add socket # Download and install the socket package (LuaSocket library).
./upkg add pl # Download and install the pl package (PenLight library).
./upkg update # Update all packages to the latest version.
</code></pre>
<p>
ULua features <a href="https://luarocks.org/">LuaRocks</a> integration: new and updated rocks are automatically tracked, compiled and made available in ULua. More than
300 of such packages are currently available for installation, see <a href="luarocks_packages.html">LuaRocks Modules</a>.
</p>
<p>
ULua also features a number of <a href="native_packages.html">Native packages</a>, i.e. packages that are developed directly for ULua according to its package manager
<a href="specs.html">specifications</a>.
</p>
<h2>ZeroBrane Studio Integration</h2>
<p>
It's possible to configure <a href="https://studio.zerobrane.com/">ZeroBrane Studio</a> to use ULua, in which case ULua's installed packages become available inside of
ZeroBrane and ZeroBrane itself runs on ULua's binaries.
</p>
<p>First of all (this is only needed to support ZeroBrane's Lua debuger feature) make sure that <code>mobdebug</code> is installed:</p>
<pre><code class="language-bash">
# On Windows:
cd folder_containing_ulua/ulua/bin
upkg add mobdebug
# On OSX and Linux:
cd folder_containing_ulua/ulua/bin
./upkg add mobdebug
</code></pre>
<p>
To configure ZeroBrane to use ULua set the path of ZeroBrane's Lua (5.1) interpreter in the IDE (<code>Edit -> Preferences -> Settings: User -> user.lua:</code>) to
ULua's executable:
</p>
<pre><code class="language-lua">
--[[--
Use this file to specify **User** preferences.
Check [online documentation](https://studio.zerobrane.com/documentation.html) for details.
--]]--
# On Windows:
path.lua = [[folder_containing_ulua/ulua/lua.cmd]]
# On OSX and Linux:
path.lua = [[folder_containing_ulua/ulua/lua]]
</code></pre>
</div>
<footer class="footer">
<div class="container-fluid text-center">
<h6>© 2015-2024 - Stefano Peluchetti</h6>
</div>
</footer>
<script>
(function (i, s, o, g, r, a, m) {
i["GoogleAnalyticsObject"] = r;
(i[r] =
i[r] ||
function () {
(i[r].q = i[r].q || []).push(arguments);
}),
(i[r].l = 1 * new Date());
(a = s.createElement(o)), (m = s.getElementsByTagName(o)[0]);
a.async = 1;
a.src = g;
m.parentNode.insertBefore(a, m);
})(window, document, "script", "//www.google-analytics.com/analytics.js", "ga");
ga("create", "UA-53199019-2", "auto");
ga("send", "pageview");
</script>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
<script src="js/prism.js"></script>
</body>
</html>