diff --git a/docs/userguide-bg.md b/docs/userguide-bg.md
index 7a7dee5..7ceac69 100644
--- a/docs/userguide-bg.md
+++ b/docs/userguide-bg.md
@@ -1,4 +1,4 @@
-
+
## This document is also available in [English](userguide.md).
@@ -22,21 +22,21 @@
### Минимална програма
-Това е най-късата програма, която създава мъжка фигура в браузър ([пример на живо](https://boytchev.github.io/mannequin.js/examples/example-minimal.html)):
+Това е относително минимална програма, която създава мъжка фигура в браузър ([пример на живо](https://boytchev.github.io/mannequin.js/examples/example-minimal.html)):
``` xml
-
-
-
-
-
-
+
+
+
+
+
+
```
@@ -52,27 +52,27 @@
е относителният размер на фигурата. По подразбиране `Male` има височина 1.00,
`Female` има височина 0.95 и `Child` има височина 0.65 ([пример на живо](https://boytchev.github.io/mannequin.js/examples/example-figure-types.html)):
-[
](https://boytchev.github.io/mannequin.js/examples/example-figure-types.html)
+[
](example-figure-types.html)
``` javascript
var man = new Male();
-man.position.x = 20;
-man.turn = -120;
+ man.position.x = 20;
+ man.turn = -120;
:
var woman = new Female();
-woman.position.x = -20;
-woman.turn = -60;
+ woman.position.x = -20;
+ woman.turn = -60;
:
var kid = new Child();
-kid.position.z = -7
+ kid.position.z = -7;
:
```
-Тези три класа има общ родиел – класът `Mannequin(feminine,height)`,
+Тези три класа има общ родител – `Mannequin(feminine,height)`,
в който булевият параметър *feminine* определя дали формата е женствена
-или мъжествена ([пример на живо](https://boytchev.github.io/mannequin.js/examples/example-height.html)):
+или мъжествена ([пример на живо](example-height.html)):
-[
](https://boytchev.github.io/mannequin.js/examples/example-height.html)
+[
](example-height.html)
Разликата между използването на различните класове за фигури е в това, че
`Mannequin` придава подразбираща се неутрална поза на фигурата, докато
diff --git a/docs/userguide.md b/docs/userguide.md
index 687c4bc..57139b8 100644
--- a/docs/userguide.md
+++ b/docs/userguide.md
@@ -1,4 +1,4 @@
-
+
## Този документ е наличен и на [български език](userguide-bg.md).
@@ -15,28 +15,28 @@
# Initialization
-The **mannequin.js** library is provided as a JavaScript modulefile that uses
+The **mannequin.js** library is provided as a JavaScript module that uses
Three.js.
### Minimal program
-Here is a minimal program that creates a male figure in the browser ([live example](https://boytchev.github.io/mannequin.js/examples/example-minimal.html)):
+Here is a reasonably minimal program that creates a male figure in the browser ([live example](https://boytchev.github.io/mannequin.js/examples/example-minimal.html)):
``` xml
-
-
-
-
-
-
+
+
+
+
+
+
```
@@ -50,29 +50,28 @@ ground, and so on. `Male` constructs a male figure.
Mannequin figures are created as instances of classes `Male(height)`, `Female(height)`
or `Child(height)`, where the optional *height* is the relative size of the figure.
By default `Male` has height 1.00, `Female` has height 0.95 and `Child` has height
-0.65 ([live example (https://boytchev.github.io/mannequin.js/examples/example-figure-types.html)):
+0.65 ([live example] (example-figure-types.html)):
-[](https://boytchev.github.io/mannequin.js/examples/example-figure-types.html)
+[](example-figure-types.html)
``` javascript
var man = new Male();
-man.position.x = 20;
-man.turn = -120;
+ man.position.x = 20;
+ man.turn = -120;
:
var woman = new Female();
-woman.position.x = -20;
-woman.turn = -60;
+ woman.position.x = -20;
+ woman.turn = -60;
:
var kid = new Child();
-kid.position.z = -7
+ kid.position.z = -7;
:
```
-These three classes have a common predecessor – the class `Mannequin(feminine,height)`, where the boolean paremeter *feminine* defines
-whether the shape is feminine or masculine
- ([live example](https://boytchev.github.io/mannequin.js/examples/example-height.html)):
+These three classes have a common predecessor – `Mannequin(feminine,height)`, where the boolean paremeter *feminine* defines whether the shape is feminine or masculine
+ ([live example](example-height.html)):
-[](https://boytchev.github.io/mannequin.js/examples/example-height.html)
+[](example-height.html)
The difference between using different figure classes is that `Mannequin` sets
a default neutral posture of the figure, while `Male` and `Female` set a default