Update README.md

Author: bact

README.md

@@ -27,20 +27,27 @@ tqdm
 - Change the text orientation using the `-or` parameter
 - Change the space width using the `-sw` parameter
 - Specify text color range using `-tc '#000000,#FFFFFF'`, please note that the quotes are **necessary**
-- Explicit alignement when using `-al` with fixed width (0: Left, 1: Center, 2: Right)
+- Explicit alignment when using `-al` with fixed width (0: Left, 1: Center, 2: Right)
 - Add support for Simplified and Traditional Chinese
 
 ## How does it work?
+
+Words will be randomly chosen from a dictionary of a specific language. Then an image of those words will be generated by using font, background, and modifications (skewing, blurring, etc.) as specified.
+
+### Basic
+
 `python run.py -w 5 -f 64`
 
-You get 1000 randomly generated images with random text on them like:
+You get 1,000 randomly generated images with random text on them like:
 
 ![1](samples/1.jpg "1")
 ![2](samples/2.jpg "2")
 ![3](samples/3.jpg "3")
 ![4](samples/4.jpg "4")
 ![5](samples/5.jpg "5")
 
+### Text skewing
+
 What if you want random skewing? Add `-k` and `-rk` (`python run.py -w 5 -f 64 -k 5 -rk`)
 
 ![6](samples/6.jpg "6")
@@ -49,13 +56,24 @@ What if you want random skewing? Add `-k` and `-rk` (`python run.py -w 5 -f 64 -
 ![9](samples/9.jpg "9")
 ![10](samples/10.jpg "10")
 
+### Text distortion
+You can also add distorsion to the generated text with `-d` and `-do`
+
+![23](samples/24.jpg "0")
+![24](samples/25.jpg "1")
+![25](samples/26.jpg "2")
+
+### Text blurring
+
 But scanned document usually aren't that clear are they? Add `-bl` and `-rbl` to get gaussian blur on the generated image with user-defined radius (here 0, 1, 2, 4):
 
 ![11](samples/11.jpg "0")
 ![12](samples/12.jpg "1")
 ![13](samples/13.jpg "2")
 ![14](samples/14.jpg "4")
 
+### Background
+
 Maybe you want another background? Add `-b` to define one of the three available backgrounds: gaussian noise (0), plain white (1), quasicrystal (2) or picture (3).
 
 ![15](samples/15.jpg "0")
@@ -65,6 +83,8 @@ Maybe you want another background? Add `-b` to define one of the three available
 
 When using picture background (3). A picture from the pictures/ folder will be randomly selected and the text will be written on it.
 
+### Handwritten
+
 Or maybe you are working on an OCR for handwritten text? Add `-hw`! (Experimental)
 
 ![18](samples/18.jpg "0")
@@ -77,21 +97,18 @@ It uses a Tensorflow model trained using [this excellent project](https://github
 
 **The project does not require TensorFlow to run if you aren't using this feature**
 
-You can also add distorsion to the generated text with `-d` and `-do`
-
-![23](samples/24.jpg "0")
-![24](samples/25.jpg "1")
-![25](samples/26.jpg "2")
+### Dictionary
 
 The text is chosen at random in a dictionary file (that can be found in the *dicts* folder) and drawn on a white background made with Gaussian noise. The resulting image is saved as [text]\_[index].jpg
 
-There are a lot of parameters that you can tune to get the results you want, therefore I recommand checking out `python run.py -h` for more informations.
+There are a lot of parameters that you can tune to get the results you want, therefore I recommend checking out `python run.py -h` for more information.
 
-## How to create images with Chinese (both simplified and traditional) text
+## Create images with Chinese text
 
 It is simple! Just do `python run.py -l cn -c 1000 -w 5`!
 
-Unfortunately I do not speak Chinese so you may have to edit `texts/cn.txt` to include some meaningful words instead of random glyphs.
+Generated texts come both in simplified and traditional Chinese scripts.
+You may have to edit `texts/cn.txt` to include some meaningful words instead of random glyphs.
 
 Here are examples of what I could make with it:
 
@@ -103,21 +120,20 @@ Simplified:
 
 ![28](samples/28.jpg "1")
 
-## Can I add my own font?
+## Add new fonts
 
-Yes, the script picks a font at random from the *fonts* directory.
+The script picks a font at random from the *fonts* directory.
 
-|||
+| Directory | Languages |
 |:----|:-----|
 | fonts/latin | English, French, Spanish, German |
 | fonts/cn | Chinese |
-|||
 
-Simply add / remove fonts until you get the desired output.
+Simply add/remove fonts until you get the desired output.
 
 If you want to add a new non-latin language, the amount of work is minimal.
 
-1. Create a new folder with your language two-letters code
+1. Create a new folder with your language [two-letters code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)
 2. Add a .ttf font in it
 3. Edit `run.py` to add an if statement in `load_fonts()`
 4. Add a text file in `dicts` with the same two-letters code
@@ -127,6 +143,8 @@ It only supports .ttf for now.
 
 ## Benchmarks
 
+Number of images generated per second.
+
 - Intel Core i7-4710HQ @ 2.50Ghz + SSD (-c 1000 -w 1)
     - `-t 1` : 363 img/s
     - `-t 2` : 694 img/s