Upstream changes - 20201203

Author: wencywww

Gemfile

@@ -12,4 +12,5 @@ gem 'asciidoctor-pdf', '1.5.3'
 gem 'coderay', '1.1.3'
 gem 'pygments.rb', '1.2.1'
 gem 'thread_safe', '0.3.6'
-gem 'epubcheck', '3.0.1'
+gem 'epubcheck-ruby', '4.2.4.0'
+gem 'html-proofer', '3.17.3'

Rakefile

@@ -1,4 +1,11 @@
 namespace :book do
+  def exec_or_raise(command)
+    puts `#{command}`
+    if (! $?.success?)
+      raise "'#{command}' failed"
+    end
+  end
+
   desc 'build basic book formats'
   task :build do
 
@@ -16,10 +23,14 @@ namespace :book do
       `bundle exec asciidoctor #{params} -a data-uri progit.asc`
       puts " -- HTML output at progit.html"
 
+      exec_or_raise('htmlproofer --check-html progit.html')
+
       puts "Converting to EPub..."
       `bundle exec asciidoctor-epub3 #{params} progit.asc`
       puts " -- Epub output at progit.epub"
 
+      exec_or_raise('epubcheck progit.epub')
+
       # Commented out the .mobi file creation because the kindlegen dependency is not available.
       # For more information on this see: #1496.
       # This is a (hopefully) temporary fix until upstream asciidoctor-epub3 is fixed and we can offer .mobi files again.

book/02-git-basics/sections/recording-changes.asc

@@ -227,7 +227,7 @@ $ cat .gitignore
 
 Глобалните правила са подобни на опростени регулярни изрази, които шеловете използват.
 Звездичката (`\*`) търси за нула или повече символа; `[abc]` търси за кой да е символ в скобите (в този случай a, b, или c); въпросителният знак (`?`) търси единичен символ; символи в скоби с тире между тях (`[0-9]`) търсят за произволен символ в обхвата между символите (в този случай от 0 до 9).
-Можете да използвате две звездички за да търсите в под-директории; `a/\*\*/z` ще открие `a/z`, `a/b/z`, `a/b/c/z`, и т.н.
+Можете да използвате две звездички за да търсите в под-директории; `a/**/z` ще открие `a/z`, `a/b/z`, `a/b/c/z`, и т.н.
 
 Ето друг примерен `.gitignore` файл:
 

book/04-git-server/sections/gitlab.asc

@@ -29,8 +29,8 @@ GitLab горещо препоръчва инсталирането на сър
 След това натиснете иконата "`Admin area`" в менюто в горния десен край.
 
 [[gitlab_menu]]
-.Admin area елемента в менюто на GitLab
-image::images/gitlab-menu.png[Admin area елемента в менюто на GitLab]
+.Елементът "`Admin area`" в менюто на GitLab
+image::images/gitlab-menu.png[“Admin area” елемента в менюто на GitLab]
 
 ===== Потребители
 

book/10-git-internals/sections/environment.asc

@@ -54,9 +54,9 @@ Git използва няколко environment променливи за да 
 Терминът "`pathspec`" се отнася до това как указвате пътища до неща в Git, включително използването на wildcards.
 Такива се използват в `.gitignore` файла, но също и в командния ред (`git add \*.c`).
 
-*`GIT_GLOB_PATHSPECS` и `GIT_NOGLOB_PATHSPECS`* контролират поведението по подразбиране на wildcard символите в pathspecs.
-Ако `GIT_GLOB_PATHSPECS` е със стойност 1, wildcard символите работят като wildcards (така е по подразбиране). Ако `GIT_NOGLOB_PATHSPECS` е 1, тогава wildcard символите само съвпадат със самите тях, което значи, че `\*.c` ще намери само файл _с име_ "`\*.c`", вместо всеки файл с окончание `.c`.
-Можете да променяте това в индивидуални случаи започвайки дадения pathspec с `:(glob)` или `:(literal)`, както например `:(glob)*.c`.
+*`GIT_GLOB_PATHSPECS`* и *`GIT_NOGLOB_PATHSPECS`* контролират поведението по подразбиране на wildcard символите в pathspecs.
+Ако `GIT_GLOB_PATHSPECS` е със стойност 1, wildcard символите работят като wildcards (така е по подразбиране); Ако `GIT_NOGLOB_PATHSPECS` е 1, тогава wildcard символите само съвпадат със самите тях, което значи, че `\*.c` ще намери само файл _с име_ "`\*.c`", вместо всеки файл с окончание `.c`.
+Можете да променяте това в индивидуални случаи започвайки дадения pathspec с `:(glob)` или `:(literal)`, както например `:(glob)\*.c`.
 
 *`GIT_LITERAL_PATHSPECS`* забранява и двете горни поведения и никакви wildcard символи няма да работят, override префиксите също се забраняват.
 

book/A-git-in-other-environments/sections/visualstudio.asc

@@ -17,8 +17,8 @@ Visual Studio запомня всички Git проекти отваряни п
 Това е нещо като хъб за изпълнение на Git операции, когато _пишете_ код вероятно ще прекарвате повечето си време в изгледа "Changes", но когато дойде време да издърпате промените направени от колегите ви, ще използвате изгледите "Unsynced Commits" и "Branches".
 
 [[vs_home]]
-.Изгледът Home за Git хранилище във Visual Studio.
-image::images/vs-2.png[Изгледът “Home” за Git хранилище във Visual Studio.]
+.Изгледът "Home" за Git хранилище във Visual Studio
+image::images/vs-2.png[Изгледът “Home” за Git хранилище във Visual Studio]
 
 Visual Studio сега има мощен, фокусиран върху задачите, графичен интерфейс за Git.
 Той включва преглед на линейна история, diff viewer, поддръжка за отдалечени команди и много други възможности.