aboutsummaryrefslogtreecommitdiff
path: root/www
diff options
context:
space:
mode:
Diffstat (limited to 'www')
-rw-r--r--www/download/index.html190
-rw-r--r--www/examples/index.html49
-rw-r--r--www/favicon.pngbin0 -> 6550 bytes
-rw-r--r--www/index.html93
-rw-r--r--www/screenshot.pngbin0 -> 61239 bytes
-rw-r--r--www/style.css99
6 files changed, 431 insertions, 0 deletions
diff --git a/www/download/index.html b/www/download/index.html
new file mode 100644
index 0000000..a161371
--- /dev/null
+++ b/www/download/index.html
@@ -0,0 +1,190 @@
1<!doctype html>
2<html>
3<head>
4 <title> Download | Nissy </title>
5<meta name="viewport" content="width=device-width" /> <link rel="stylesheet" type="text/css" href="/style.css">
6 <link rel="icon" href="/favicon.png">
7 <meta charset="utf-8">
8</head>
9
10<body>
11
12<nav class="top">
13 <table class="menu">
14 <tr>
15 <td class="logo"> <a href="/"><img src="/favicon.png"></a> </td>
16 <td class="links">
17 <a href="/download/">Download</a> |
18 <a href="/examples/">Examples</a>
19 </td>
20 </tr>
21 </table>
22</nav>
23
24<hr class="line">
25
26
27<h1>Get Nissy</h1>
28
29<table class="dltable">
30<tr>
31 <td></td>
32 <td><strong>Source code</strong></td>
33 <td><strong>Windows executable</strong></td>
34</tr>
35<tr>
36 <td><strong>Latest version</strong></td>
37 <td><a href="/nissy-2.0.1.tar.gz">nissy-2.0.1.tar.gz (63Kb)</a></td>
38 <td><a href="/nissy-2.0.1.exe">nissy-2.0.1.exe (770Kb)</a></td>
39</tr>
40</table>
41
42<p>
43In this page you can find download links (see above)
44and installation instructions (see below) for
45nissy. If instead you wish to clone the
46<a href="https://git.tronto.net/nissy/">git repository</a>, use
47<pre>
48<code>git clone https://git.tronto.net/nissy</code>
49</pre>
50</p>
51
52<p>
53For a summary of changes and a list of older versions see below. Some versions
54(for example 1.0) are not available directly, but can be obtained from
55the git repository.
56</p>
57
58<h2>Installation</h2>
59
60<h3>System requirements</h3>
61
62<p>
63A full installation of nissy requires about 3Gb of space,
64of which 2.3Gb are occupied by the huge pruning table for fast optimal solving,
65and running it requires the same amount of RAM.
66One can choose to never use this function and not to install the relative
67pruning table. There is an alternative (slower)
68optimal solving function that uses about 500Mb of RAM.
69</p>
70
71<h3>Windows</h3>
72
73<p>
74Try downloading and executing in a terminal the file <code>nissy.exe</code>,
75then follow the instructions in the <strong>Tables</strong> section below for
76installing the pruning tables.
77If <code>nissy.exe</code> does not work, you can try following the UNIX instructions
78in WSL (Windows Subsystem for Linux) or in a similar environment.
79</p>
80
81<h3>UNIX (Linux, MacOS, *BSD...)</h3>
82<p>
83Edit the <code>Makefile</code> to match your local configuration
84(this is usually not necessary, but you may want to change the
85<code>PREFIX</code> variable to change the installation path)
86and run <code>make</code>, followed by <code>make install</code>.
87Follow the instructions below to install the pruning tables.
88
89<h3>Tables</h3>
90
91<table class="dltable">
92<tr>
93 <td></td> <td><strong>Zip file</strong></td>
94</tr>
95<tr>
96 <td><strong>Tables</strong></td>
97 <td><a href="/nissy-tables-2.0.zip">nissy-tables.2.0.zip (63Kb)</a></td>
98</tr>
99</table>
100<p>
101<strong>Note:</strong> the version 2.0 at the end of the file name is
102only indicative. Later versionw will use the same tables, unless
103otherwise specified.
104</p>
105
106<p>
107Nissy needs certain large tables to work. These tables are by default
108generated the first time they are needed (e.g the first time you ask to solve a
109certain step) and then saved to a file. Whenever these tables are needed again,
110nissy simply loads the corresponding file from the hard disk.
111</p>
112
113<p>
114The very large table for optimal solving can take some time to generate
115(about 1.5 hours on my fairly old but decent laptop, using 8 CPU threads).
116In order to generate it you need at least 5Gb of RAM.
117All other tables are much faster.
118</p>
119
120<p>
121You can ask nissy to generate all the tables it will ever need with the gen
122command. It is recommended to use more than one thread, if your CPU has them.
123For example, you can run:
124</p>
125
126<pre><code>nissy gen -t 8</pre></code>
127
128<p>
129to generate all tables using 8 threads. You can change 8 to any number
130your CPU supports, up to 64.
131</p>
132
133<p>
134Alternatively, you can simply download all the tables and copy them into the
135correct folder (see manual page, <code>ENVIRONMENT</code> section). On UNIX
136operating systems this folder is either <code>.nissy/tables</code> in the
137user's home directory or <code>$XDG_DATA_HOME/nissy/tables</code> if the
138XDG variable is configured. On Windows it is the same directory as the
139<code>nissy.exe</code> executable file.
140</p>
141
142<h2>Version history</h2>
143
144<h3>Nissy v2</h3>
145
146<table class=dltable>
147<tr>
148 <td><strong>Version</strong></td>
149 <td><strong>Date</strong></td>
150 <td><strong>Comment</strong></td>
151</tr>
152<tr>
153 <td><a href="/nissy-2.0.1.tar.gz">2.0.1</a></td>
154 <td>2022-02-22</td>
155 <td>Bugfix release</td>
156</tr>
157<tr>
158 <td>2.0</td>
159 <td>2021-12-29</td>
160 <td>Rewritten from scratch; much faster optimal solver</td>
161</tr>
162</table>
163
164<h3>Nissy v1</h3>
165
166<p>
167Nissy v1 was released in 2020. It was slow, full of bugs and the code
168was quite terrible. But in practice it got its job done most of the time.
169</p>
170
171
172<hr class="line">
173
174<nav class="bottom">
175 <table class="footer">
176 <tr>
177 <td class="contact">
178 <a href="https://sebastiano.tronto.net">sebastiano.tronto.net</a>
179 </td>
180 <td class="hosted">
181 <a href="mailto:sebastiano@tronto.net">
182 sebastiano@tronto.net
183 </a>
184 </td>
185 </tr>
186 </table>
187</nav>
188
189</body>
190</html>
diff --git a/www/examples/index.html b/www/examples/index.html
new file mode 100644
index 0000000..2094014
--- /dev/null
+++ b/www/examples/index.html
@@ -0,0 +1,49 @@
1<!doctype html>
2<html>
3<head>
4 <title> Examples | Nissy </title>
5<meta name="viewport" content="width=device-width" /> <link rel="stylesheet" type="text/css" href="/style.css">
6 <link rel="icon" href="/favicon.png">
7 <meta charset="utf-8">
8</head>
9
10<body>
11
12<nav class="top">
13 <table class="menu">
14 <tr>
15 <td class="logo"> <a href="/"><img src="/favicon.png"></a> </td>
16 <td class="links">
17 <a href="/download/">Download</a> |
18 <a href="/examples/">Examples</a>
19 </td>
20 </tr>
21 </table>
22</nav>
23
24<hr class="line">
25
26
27<h1>Examples</h1>
28
29(Coming soon...)
30
31<hr class="line">
32
33<nav class="bottom">
34 <table class="footer">
35 <tr>
36 <td class="contact">
37 <a href="https://sebastiano.tronto.net">sebastiano.tronto.net</a>
38 </td>
39 <td class="hosted">
40 <a href="mailto:sebastiano@tronto.net">
41 sebastiano@tronto.net
42 </a>
43 </td>
44 </tr>
45 </table>
46</nav>
47
48</body>
49</html>
diff --git a/www/favicon.png b/www/favicon.png
new file mode 100644
index 0000000..3ec80a1
--- /dev/null
+++ b/www/favicon.png
Binary files differ
diff --git a/www/index.html b/www/index.html
new file mode 100644
index 0000000..1844631
--- /dev/null
+++ b/www/index.html
@@ -0,0 +1,93 @@
1<!doctype html>
2<html>
3<head>
4 <title> Nissy | Nissy </title>
5<meta name="viewport" content="width=device-width" /> <link rel="stylesheet" type="text/css" href="/style.css">
6 <link rel="icon" href="/favicon.png">
7 <meta charset="utf-8">
8</head>
9
10<body>
11
12<nav class="top">
13 <table class="menu">
14 <tr>
15 <td class="logo"> <a href="/"><img src="/favicon.png"></a> </td>
16 <td class="links">
17 <a href="/download/">Download</a> |
18 <a href="/examples/">Examples</a>
19 </td>
20 </tr>
21 </table>
22</nav>
23
24<hr class="line">
25
26
27<h1>Nissy</h1>
28
29<p class=subtitle>A Rubik's cube solver and FMC assistant</p>
30
31<img src="/screenshot.png">
32
33<p>
34Nissy is a command-line Rubik's cube solver. It can find optimal solutions
35for random positions using techniques from Herbert Kociemba's
36<a href="http://kociemba.org/cube.htm">Cube Explorer</a> and
37Tomas Rokicki's
38<a href="https://github.com/rokici/cube20src/blob/master/nxopt.md">nxopt</a>.
39With 4 cores at 2.5GHz and using less than 3Gb of RAM, Nissy can find an optimal
40solution in about a minute on average.
41</p>
42
43<p>
44Nissy aims at being a complete tool
45for FMC (Fewest Moves Challenge) practice. It can solve different steps
46of Thistlethwaite's algorithm (also know as DR/HTR) and cans use NISS
47(Normal-Inverse Scramble Switch).
48</p>
49
50<p>
51You should use Nissy if:
52</p>
53<ul>
54<li>
55You want to analyze your DR solutions or check for multiple optimal
56(or sub-optimal) solutions for EO/DR/HTR or similar steps.
57</li>
58<li>
59You just want a Rubik's cube solver and you like command line interfaces.
60</li>
61<li>
62You want an alternative to Cube Explorer.
63</li>
64</ul>
65
66<p>
67To get started, head to the <a href="/download/">download</a> page.
68</p>
69
70<p>
71You can also see its source code by cloning the git repository
72<a href="https://git.tronto.net/nissy/">git.tronto.net/nissy</a>
73</p>
74
75<hr class="line">
76
77<nav class="bottom">
78 <table class="footer">
79 <tr>
80 <td class="contact">
81 <a href="https://sebastiano.tronto.net">sebastiano.tronto.net</a>
82 </td>
83 <td class="hosted">
84 <a href="mailto:sebastiano@tronto.net">
85 sebastiano@tronto.net
86 </a>
87 </td>
88 </tr>
89 </table>
90</nav>
91
92</body>
93</html>
diff --git a/www/screenshot.png b/www/screenshot.png
new file mode 100644
index 0000000..a73f2fd
--- /dev/null
+++ b/www/screenshot.png
Binary files differ
diff --git a/www/style.css b/www/style.css
new file mode 100644
index 0000000..1487497
--- /dev/null
+++ b/www/style.css
@@ -0,0 +1,99 @@
1.menu {
2 width: 100%;
3}
4
5.links {
6 text-align: right;
7 font-weight: bold;
8}
9
10.logo img {
11 width: 50px;
12 height: 50px;
13}
14
15.footer {
16 font-style: italic;
17 width: 100%;
18}
19
20.hosted {
21 text-align: right;
22}
23
24body {
25 margin: auto 8px 20px 8px;
26}
27
28img {
29 display: block;
30 margin-left: auto;
31 margin-right: auto;
32 max-width: 100%;
33}
34
35pre, code {
36 background-color: #eeeeee;
37}
38
39pre {
40 border: 2px solid;
41 padding: 6px;
42}
43
44#blob {
45 background: #ffffff;
46 border: none;
47}
48
49a {
50 color: #0f2899;
51 text-decoration: none;
52}
53
54.links a {
55 font-weight: bold;
56 color: black;
57}
58
59.hosted a,
60.contact a {
61 font-weight: bold;
62}
63
64a:hover {
65 text-decoration: underline;
66}
67
68html {
69 margin: 1em auto;
70 max-width: 42em;
71}
72
73h1 {
74 text-align: center;
75}
76
77td h1 {
78 text-align: left;
79 font-size: 1.5em;
80}
81
82table {
83 width: 100%;
84}
85
86.url td {
87 font-family: monospace;
88}
89
90.dltable th, .dltable td {
91 border: 1px solid black;
92 padding: 3px;
93}
94
95.subtitle {
96 text-align: center;
97 font-weight: bold;
98 font-size: 1.1em;
99}

Generated with cgit - Back to sebastiano.tronto.net