fix: english syntax

Author: Mark24Code

README.md

@@ -1,8 +1,23 @@
-# Convert2ASCII
+# Convert2Ascii
 
 Convert Image/Video to ASCII art.
 
 
+## Intro
+
+convert2ascii provides two executable commands：
+
+* image2ascii: transform picture to ascii art and display in terminal.
+* video2ascii: transform video to ascii art, you can save or play it in terminal.
+
+It also provides classes as a gem:
+
+* Convert2Ascii::Image2Ascii
+* Convert2Ascii::Video2Ascii
+
+you can use it in your code and make your own ascii art !
+
+
 ## Test pass
 
 * MacOS 15.2 ✅
@@ -20,57 +35,57 @@ Convert Image/Video to ASCII art.
 
 ## Prerequisites
 
-* Ruby3+
+* Ruby 3+
 * ImageMagick ([Download here](https://imagemagick.org/script/download.php))
 * ffmpeg ([Download here](https://www.ffmpeg.org/))
 
 # How to use
 
-## Try in docker
+## Try in Docker
 
 `$ docker run -it -v $(pwd):/app  mark24code/convert2ascii bash -c "cd /app && exec bash"`
 
-> `$(pwd)` can change to your local path, here use you working path.
+>  `$(pwd)` can be changed to your local path. Here, use your working path.
 
 
 ## Install
 
-`gem install convert2ascii`
+`$ gem install convert2ascii`
 
 
-## Executable command
+## Executable commands
 
 ### image2ascii
 
-Make image to ascii art in your terminal.
+Convert an image to ascii art.
 
 ```bash
 image2ascii -h
 Usage: image2ascii [options]
-        --version                    verison
+        --version                    version
     -i, --image=URI                  image uri (required)
     -w, --width=WIDTH                image width (integer)
-    -s, --style=STYLE                ascii style: ['color'| 'text']
-    -b, --block                      ascii color style use BLOCK or not [ true | false ]
+    -s, --style=STYLE                ascii style: 'color'/'text'
+    -b, --block                      ascii color style use BLOCK or not true/false
 ```
 
 ### video2ascii
 
-Make image to ascii art in your terminal.
+Convert a video to ascii art.
 
 ```bash
 Usage: video2ascii [options]
 
-* default will generate and play without save.
-* -p will just play ascii frames dir, and ignore -i, -o others options. --loop will play loop
+* By default, it will generate and play without saving.
+* The -p option will just play the ascii frames within the directory, and ignore -i, -o other options. --loop will play loop
 * -i,-o will just generate and output frames and ignore others options
-        --version                    verison
+        --version                    version
     -i, --input=URI                  video uri (required)
     -w, --width=WIDTH                video width (integer)
     -s, --style=STYLE                ascii style: ['color'| 'text']
     -b, --block                      ascii color style use BLOCK or not [ true | false ]
-    -o, --ouput=OUTPUT               save ascii frame to output dirname
-    -p, --play_dir=PLAY_DIRNAME      input ascii frames dirname to play
+    -o, --ouput=OUTPUT               save ascii frames to the output directory
+    -p, --play_dir=PLAY_DIRNAME      input the ascii frames directory to play
         --loop
 ```
 

exe/image2ascii

@@ -7,7 +7,7 @@ options = {}
 OptionParser.new do |parser|
   parser.banner = "Usage: image2ascii [options]"
 
-  parser.on("--version", "verison") do |v|
+  parser.on("--version", "version") do |v|
     puts "convert2ascii/image2ascii: v#{::Convert2Ascii::VERSION}"
     puts "author: Mark24"
     puts "mail: mark.zhangyoung@gmail.com"

exe/video2ascii

@@ -45,7 +45,7 @@ Usage: video2ascii [options]
 * -p will just play ascii frames dir, and ignore -i, -o others options. --loop will play loop
 * -i,-o will just generate and output frames and ignore others options
 DOC
-  parser.on("--version", "verison") do |v|
+  parser.on("--version", "version") do |v|
     puts "convert2ascii/video2ascii: v#{::Convert2Ascii::VERSION}"
     puts "author: Mark24"
     puts "mail: mark.zhangyoung@gmail.com"
@@ -82,11 +82,11 @@ DOC
     options[:color_block] = color_block || false
   end
 
-  parser.on("-o", "--ouput=OUTPUT", "save ascii frame to output dirname") do |output|
+  parser.on("-o", "--ouput=OUTPUT", "save ascii frames to the output directory") do |output|
     options[:output] = output
   end
 
-  parser.on("-p", "--play_dir=PLAY_DIRNAME", "input ascii frames dirname to play") do |play_dir|
+  parser.on("-p", "--play_dir=PLAY_DIRNAME", "input the ascii frames directory to play") do |play_dir|
     options[:play_dir] = play_dir
   end