Skip to content

Commit 94261cd

Browse files
committed
WiP
1 parent 77336e8 commit 94261cd

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

78 files changed

+1270
-39
lines changed

Gemfile.lock

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ GEM
88
eventmachine (>= 0.12.9)
99
http_parser.rb (~> 0.6.0)
1010
eventmachine (1.2.5)
11-
ffi (1.9.10)
11+
ffi (1.9.23)
1212
forwardable-extended (2.6.0)
1313
http_parser.rb (0.6.0)
1414
i18n (0.7.0)
@@ -33,15 +33,19 @@ GEM
3333
listen (~> 3.0)
3434
kramdown (1.14.0)
3535
liquid (4.0.0)
36-
listen (3.0.3)
37-
rb-inotify (>= 0.9)
36+
listen (3.1.5)
37+
rb-fsevent (~> 0.9, >= 0.9.4)
38+
rb-inotify (~> 0.9, >= 0.9.7)
39+
ruby_dep (~> 1.2)
3840
mercenary (0.3.5)
3941
pathutil (0.16.1)
4042
forwardable-extended (~> 2.6)
4143
public_suffix (3.0.2)
42-
rb-inotify (0.9.7)
43-
ffi (>= 0.5.0)
44+
rb-fsevent (0.10.3)
45+
rb-inotify (0.9.10)
46+
ffi (>= 0.5.0, < 2)
4447
rouge (2.0.2)
48+
ruby_dep (1.5.0)
4549
safe_yaml (1.0.4)
4650
sass (3.4.23)
4751

en/about.html

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,6 @@ <h1>About Mu</h1>
1111
<a class="btn btn-lg btn-success" href="/en/download" role="button">Download</a>
1212
<a class="btn btn-lg btn-primary" href="/en/tutorials" role="button">Tutorials</a>
1313
<a class="btn btn-lg btn-info" href="/en/howto" role="button">How to..?</a>
14-
</p>
1514
</div>
1615
<img src="/img/logo.png" alt="Mu's world" class="img-responsive center-block img-rounded"/>
1716

en/download.html

Lines changed: 0 additions & 10 deletions
This file was deleted.

en/download.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
layout: default
3+
title: Download Mu
4+
i18n: en
5+
---
6+
7+
# Download Mu
8+
9+
There are many ways to install Mu. The simplest is to download the official
10+
installer for Windows or Mac OSX. If you're a more advanced user you can use
11+
Python's built-in `pip` tool. Some Linux distributions come with Mu packaged
12+
already (and you should use your OS's package manager to install it). Finally,
13+
if you're on Raspbian (the version of Linux for Raspberry Pi) you can install
14+
Mu as a package.
15+
16+
Each option is outlined below:
17+
18+
19+
<div class="row">
20+
<div class="col-sm-6 col-md-3">
21+
<div class="thumbnail">
22+
<img src="/img/windows_logo.png" alt="Windows Logo">
23+
<div class="caption">
24+
<h3>Windows</h3>
25+
<p><a href="#" class="btn btn-primary" role="button">Download</a>
26+
<a href="/en/howto/install_windows" class="btn btn-default" role="button">Instructions</a></p>
27+
</div>
28+
</div>
29+
</div>
30+
<div class="col-sm-6 col-md-3">
31+
<div class="thumbnail">
32+
<img src="/img/apple_logo.png" alt="Apple Logo">
33+
<div class="caption">
34+
<h3>Mac OSX</h3>
35+
<p><a href="#" class="btn btn-primary" role="button">Download</a>
36+
<a href="/en/howto/install_macos" class="btn btn-default" role="button">Instructions</a></p>
37+
</div>
38+
</div>
39+
</div>
40+
<div class="col-sm-6 col-md-3">
41+
<div class="thumbnail">
42+
<img src="/img/python_logo.png" alt="Python Logo">
43+
<div class="caption">
44+
<h3>Python Package</h3>
45+
<p><a href="/en/howto/install_with_python" class="btn btn-default" role="button">Instructions</a></p>
46+
</div>
47+
</div>
48+
</div>
49+
<div class="col-sm-6 col-md-3">
50+
<div class="thumbnail">
51+
<img src="/img/rpi_logo.png" alt="Raspberry Pi Logo">
52+
<div class="caption">
53+
<h3>Raspbian</h3>
54+
<p><a href="/en/howto/install_raspberry_pi" class="btn btn-default" role="button">Instructions</a></p>
55+
</div>
56+
</div>
57+
</div>
58+
</div>

en/howto.html

Lines changed: 0 additions & 8 deletions
This file was deleted.

en/howto/bugs.md

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
layout: default
3+
title: How to report a bug in Mu
4+
i18n: en
5+
---
6+
# How to report a bug in Mu
7+
8+
<div class="row">
9+
<img src="/img/en/howto/bug.png" alt="The first bug" class="img-responsive center-block img-rounded movie"/>
10+
<br/>
11+
</div>
12+
13+
If you've ever written a line of code, you'll know that
14+
[all software has bugs](https://www.history.navy.mil/our-collections/photography/numerical-list-of-images/nhhc-series/nh-series/NH-96000/NH-96566-KN.html).
15+
This will be the case with Mu.
16+
17+
If you think you have found a bug, simply click on the button below (you'll
18+
need to have an account on GitHub) and then click the green "New Issue" button
19+
found at the top right hand side of the page:
20+
21+
<div class="row text-center">
22+
<p><a class="btn btn-lg btn-danger" href="https://github.com/mu-editor/mu/issues"
23+
role="button" target="_blank">Report a Bug in Mu</a></p>
24+
</div>
25+
26+
When you create a new issue it will be given a number and the volunteer
27+
developers, who write and maintain the code, will be informed by email. They
28+
may annotate questions to your issue, if things are not clear. They may
29+
immediately close it and mark it as "duplicate" (someone else has already
30+
reported the bug -- and they'll reference the original issue). Sometimes
31+
they'll close the bug and say "won't fix", because they disagree that it's a
32+
bug *or* it's too trivial in order to invest any time. Finally, please be aware
33+
of the famous [PEBCAK](https://en.wiktionary.org/wiki/PEBCAK) bug (Problem
34+
Exists Between Chair and Keyboard). This simply indicates the user has caused
35+
the problem (rather than the software): a misconfigured computer, a
36+
misunderstanding, or perhaps a mismatch of expectation. ;-)
37+
38+
There are generally two sorts of bugs:
39+
40+
* Technical: the code has a mistake in it which causes the program to break.
41+
* Behavioural: the code works correctly, but is doing the wrong thing.
42+
43+
In both cases, for us to be able to fix the bug, we need **as much information
44+
as possible**. When you create a new issue you should try to include, where
45+
relevant, the following sorts of information:
46+
47+
* What you were trying to do,
48+
* What steps you took to make this happen,
49+
* What you expected to happen,
50+
* What actually happened,
51+
* Why this difference is problematic (it may not be a bug!),
52+
* Technical details like the version of Mu you're using, your OS version and
53+
other aspects of the context in which Mu was running.
54+
55+
Please remember to attach a [copy of the full log files for Mu](read_logs).
56+
57+
Use plain and simple language to describe the problem and, if helpful, break
58+
it down into steps so developers can easily recreate the issue. Please don't
59+
assume we'll understand what you were trying to achieve -- honestly, it's best
60+
if you try to imagine we (the developers) are a bunch of clever 5-year-olds.
61+
Try to explain *everything* about the problem and don't assume we know what you
62+
mean. We won't mind! ;-)
63+
64+
If you would like to get more involved in the development of Mu, we'd love to
65+
welcome you via the [Mu developer's website](http://mu.rtfd.io/).

en/howto/create_load_save.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ You need to understand what each of the following three buttons do:
99

1010
<div class="row">
1111
<img src="/img/en/howto/create_load_save.png" alt="New, Load and Save buttons" class="img-responsive center-block img-rounded movie"/>
12+
<br/>
1213
</div>
1314

1415
* **New** - Click on this button to create a new empty file. Before you can run

en/howto/debug_code.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
layout: default
3+
title: How to use the debugger to check your code
4+
i18n: en
5+
---
6+
# How to use the debugger to check your code
7+
8+
<div class="row">
9+
<img src="/img/en/howto/debugger.gif" alt="A simple use of the debugger" class="img-responsive center-block img-rounded movie"/>
10+
<br/>
11+
</div>
12+

0 commit comments

Comments
 (0)