Upstream changes

progit · Dec 5, 2022 · bad9605 · bad9605
2 parents 132fc12 + 3bd83d2
commit bad9605
Show file tree

Hide file tree

Showing 47 changed files with 156 additions and 127 deletions.
diff --git a/CITATION.cff b/CITATION.cff
@@ -0,0 +1,29 @@
+# This CITATION.cff file was generated with cffinit.
+# Visit https://bit.ly/cffinit to generate yours today!
+
+cff-version: 1.2.0
+title: Pro Git
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+type: software
+authors:
+  - given-names: Scott
+    family-names: Chacon
+    email: [email protected]
+  - given-names: Ben
+    family-names: Straub
+    email: [email protected]
+identifiers:
+  - type: url
+    value: 'https://git-scm.com/book/en/v2'
+    description: Pro Git website
+repository-code: 'https://github.com/progit/progit2'
+url: 'https://git-scm.com/book/en/v2'
+keywords:
+  - git
+  - book
+  - asciidoc
+  - pro-git
+license: CC-BY-NC-SA-3.0
+version: '2'
diff --git a/Gemfile b/Gemfile
@@ -1,17 +1,17 @@
 source 'https://rubygems.org'
 
 gem 'rake', '13.0.6'
-gem 'asciidoctor', '2.0.16'
+gem 'asciidoctor', '2.0.18'
 
-gem 'json', '2.6.1'
+gem 'json', '2.6.2'
 gem 'awesome_print', '1.9.2'
 
 gem 'asciidoctor-epub3', '1.5.1'
-gem 'asciidoctor-pdf', '1.6.1'
+gem 'asciidoctor-pdf', '2.3.4'
 
 gem 'coderay', '1.1.3'
-gem 'pygments.rb', '2.2.0'
+gem 'pygments.rb', '2.3.0'
 gem 'thread_safe', '0.3.6'
 gem 'epubcheck-ruby', '4.2.6.0'
-gem 'html-proofer', '3.19.3'
+gem 'html-proofer', '4.4.1'
 gem 'kindlegen', '3.1.1'
diff --git a/Rakefile b/Rakefile
@@ -53,7 +53,7 @@ namespace :book do
   file 'book/contributors.txt' do
       puts 'Generating contributors list'
       sh "echo 'Contributors as of #{header_hash}:\n' > book/contributors.txt"
-      sh "git shortlog -s | grep -v -E '(Straub|Chacon|dependabot)' | cut -f 2- | column -c 120 >> book/contributors.txt"
+      sh "git shortlog -s HEAD | grep -v -E '(Straub|Chacon|dependabot)' | cut -f 2- | column -c 120 >> book/contributors.txt"
   end
 
   desc 'build HTML format'
@@ -98,7 +98,7 @@ namespace :book do
   task :check => [:build_html, :build_epub] do
       puts 'Checking generated books'
 
-      sh "htmlproofer --check-html progit.html"
+      sh "htmlproofer progit.html"
       sh "epubcheck progit.epub"
   end
 

diff --git a/book/01-introduction/sections/about-version-control.asc b/book/01-introduction/sections/about-version-control.asc
@@ -23,7 +23,7 @@
 image::images/local.png["Локален контрол на версиите, диаграма"]
 
 Една от най-популярните подобни системи се нарича RCS и все още се разпространява с много компютри и до днес.
-https://www.gnu.org/software/rcs/[RCS] работи съхранявайки множество от пачове (разликите във файловете) в специален формат на диска и може да възстанови състоянието на файла към произволен момент добавяйки всички тези пачове.
+https://www.gnu.org/software/rcs/[RCS^] работи съхранявайки множество от пачове (разликите във файловете) в специален формат на диска и може да възстанови състоянието на файла към произволен момент добавяйки всички тези пачове.
 
 ==== Централизирани Version Control Systems
 

diff --git a/book/01-introduction/sections/first-time-setup.asc b/book/01-introduction/sections/first-time-setup.asc
@@ -84,6 +84,7 @@ Vim, Emacs и Notepad++ са популярни текстови редакто
 Примерно под Windows, може да се стигне до преждевременно прекратена Git операция по време на редакция инициирана от Git.
 ====
 
+[[_new_default_branch]]
 ==== Име на клон по подразбиране
 
 По подразбиране, Git ще създава клон с има _master_, когато създавате хранилища с `git init`.

diff --git a/book/01-introduction/sections/help.asc b/book/01-introduction/sections/help.asc
@@ -18,7 +18,7 @@ $ git help config
 ----
 
 Тези команди са полезни, защото имате достъп до тях винаги, дори когато сте офлайн.
-Ако помощните страници и тази книга не са достатъчни в специфични ситуации, можете да опитате `\#git`, `\#github` или `#gitlab` каналите на Libera Chat IRC сървъра на адрес https://libera.chat/[].
+Ако помощните страници и тази книга не са достатъчни в специфични ситуации, можете да опитате `\#git`, `\#github` или `#gitlab` каналите на Libera Chat IRC сървъра на адрес https://libera.chat/[^].
 Тези канали редовно са пълни със стотици потребители напреднали с Git и нямащи нищо против да помагат.(((IRC)))
 
 В допълнение, ако не се нуждаете от пълната manpage документация, а само от кратко пояснение за опциите на конкретна команда, можете да използвате параметрите `-h` or `--help` така:

diff --git a/book/01-introduction/sections/installing.asc b/book/01-introduction/sections/installing.asc
@@ -6,9 +6,9 @@
 
 [NOTE]
 ====
-Тази книга е написана за Git версия *2.8.0*.
-Въпреки че повечето команди, които използваме трябва да работят дори в много стари версии на Git, някои от тях може да работят с леки разлики, ако вашата версия е по-стара.
-Понеже Git е достатъчно добър в поддържането на обратната съвместимост, всяка версия след 2.8 би трябвало да работи добре.
+Тази книга е написана за Git версия 2.
+Понеже Git е достатъчно добър в поддържането на обратната съвместимост, всяка актуална версия би трябвало да работи добре.
+Въпреки че повечето команди трябва да работят дори в много стари версии на Git, някои от тях може да работят с леки разлики, ако вашата версия е по-стара.
 ====
 
 ==== Инсталация в Linux
@@ -29,7 +29,7 @@ $ sudo dnf install git-all
 $ sudo apt install git-all
 ----
 
-За повече подробности и опции касаещи инсталацията в Linux, вижте сайта на Git: https://git-scm.com/download/linux[].
+За повече подробности и опции касаещи инсталацията в Linux, вижте сайта на Git: https://git-scm.com/download/linux[^].
 
 ==== Инсталация в macOS
 
@@ -46,7 +46,7 @@ $ git --version
 Ако не сте го инсталирали вече, системата ще ви предложи да го направите.
 
 Ако желаете по-актуална версия, можете да я инсталирате и през binary инсталатор.
-OSX Git инсталатор за MacOS се поддържа и може да се изтегли от https://git-scm.com/download/mac[].
+OSX Git инсталатор за MacOS се поддържа и може да се изтегли от https://git-scm.com/download/mac[^].
 
 .Git macOS Installer
 image::images/git-osx-installer.png[Git macOS installer]
@@ -55,8 +55,8 @@ image::images/git-osx-installer.png[Git macOS installer]
 
 И тук има няколко опции да инсталирате Git.(((Windows, installing)))
 Официалната версия е налична за сваляне от сайта на Git.
-Отворете https://git-scm.com/download/win[] и изтеглянето ще започне автоматично.
-Имайте предвид, че това е проект наречен Git for Windows, който е отделен от самия Git, за повече информация за него, посетете https://gitforwindows.org[].
+Отворете https://git-scm.com/download/win[^] и изтеглянето ще започне автоматично.
+Имайте предвид, че това е проект наречен Git for Windows, който е отделен от самия Git, за повече информация за него, посетете https://gitforwindows.org[^].
 
 Ако искате автоматизирана инсталация, можете да използвате https://chocolatey.org/packages/git[Git Chocolatey package].
 Chocolatey пакетът се поддържа от общност доброволци.
@@ -87,7 +87,7 @@ $ sudo apt-get install asciidoc xmlto docbook2x
 
 [NOTE]
 ====
-Потребителите на RHEL и RHEL деривати като CentOS и Scientific Linux трябва https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F[да разрешат EPEL хранилището] за да изтеглят пакета `docbook2X`.
+Потребителите на RHEL и RHEL деривати като CentOS и Scientific Linux трябва https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F[да разрешат EPEL хранилището^] за да изтеглят пакета `docbook2X`.
 ====
 
 Ако използвате Debian-базирана дистрибуция (Debian/Ubuntu/Ubuntu-варианти), ще се нуждаете също и от пакета `install-info`:
@@ -114,7 +114,7 @@ $ sudo ln -s /usr/bin/db2x_docbook2texi /usr/bin/docbook2x-texi
 поради различия в имената на двоичните файлове.
 
 След като се уверите, че имате инсталирани всички зависимости, продължавате напред и изтегляте най-новия архив с изходен код на Git.
-Това може да стане от няколко места - сайта Kernel.org на адрес https://www.kernel.org/pub/software/scm/git[], или от хранилището в GitHub - https://github.com/git/git/releases[].
+Това може да стане от няколко места - сайта Kernel.org на адрес https://www.kernel.org/pub/software/scm/git[], или от хранилището в GitHub - https://github.com/git/git/releases[^].
 Обикновено страницата в GitHub би следвало да е по-актуална, но и Kernel.org също разполага с контролни сигнатури, ако желаете да проверите какво сте изтеглили.
 
 Следва компилация и инсталиране:

diff --git a/book/02-git-basics/sections/recording-changes.asc b/book/02-git-basics/sections/recording-changes.asc
@@ -36,6 +36,15 @@ Git също така не вижда никакви непроследени ф
 Засега, този клон е винаги `master`, както е по подразбиране, към момента това не ви интересува.
 <<ch03-git-branching#ch03-git-branching>> ще разгледа клоновете и референциите в подробности.
 
+[NOTE]
+====
+GitHub смени името на клона по подразбиране от `master` на `main` в средата на 2020 г. и други Git хостове направиха същото.
+Ето защо, може да установите, че клонът по подразбиране на новосъздадените хранилища е `main` вместо `master`.
+Освен това, името на клона по подразбиране може да се променя (както видяхме в <<ch01-getting-started#_new_default_branch>>), така че може да видите съвсем различно име във вашия случай.
+
+Git обаче все още използва `master` по подразбиране, така че ще го използваме по-натам в книгата.
+====
+
 Нека сега добавим нов файл в проекта, прост `README` файл.
 Ако файлът не е съществувал преди и изпълните `git status`, ще видите untracked файла си така:
 
@@ -254,7 +263,7 @@ doc/**/*.pdf
 
 [TIP]
 ====
-GitHub поддържа сравнително подробен списък от добри `.gitignore` примери за стотици проекти и езици на адрес https://github.com/github/gitignore[], ако искате отправна точка за проекта си.
+GitHub поддържа сравнително подробен списък от добри `.gitignore` примери за стотици проекти и езици на адрес https://github.com/github/gitignore[^], ако искате отправна точка за проекта си.
 ====
 
 [NOTE]
@@ -617,4 +626,4 @@ $ git add README
 
 Git установява, че това е безусловно преименуване, така че няма значение дали сте променили файла по този начин или с `mv` командата.
 Единствената реална разлика е, че `git mv` е една команда вместо три -- така че това е команда за удобство.
-По-важното е, че можете да използвате произволни средства за преименуване на файлове и да се занимавате с add/rm действията по-късно, преди да къмитнете промените.
+По-важното е, че можете да използвате произволни средства за преименуване на файлове и да се занимавате с `add`/`rm` действията по-късно, преди да къмитнете промените.
diff --git a/book/03-git-branching/sections/branch-management.asc b/book/03-git-branching/sections/branch-management.asc
@@ -153,7 +153,7 @@ $ git push --set-upstream origin main
 
 [source,console]
 ----
-git branch --all
+$ git branch --all
 * main
   remotes/origin/HEAD -> origin/master
   remotes/origin/main

diff --git a/book/03-git-branching/sections/remote-branches.asc b/book/03-git-branching/sections/remote-branches.asc
@@ -231,5 +231,5 @@ To https://github.com/schacon/simplegit
  - [deleted]         serverfix
 ----
 
-Това в общи линии изтрива указателя от сървъра.
+Всичко, което това прави е да изтрие указателя от сървъра.
 Git сървърът в повечето случаи ще пази данните за известно време докато мине garbage collection системата му, така че случайно изтритите данни често могат лесно да се възстановят.
diff --git a/book/04-git-server/sections/generating-ssh-key.asc b/book/04-git-server/sections/generating-ssh-key.asc
@@ -54,4 +54,4 @@ mZ+AW4OZPnTPI89ZPmVMLuayrD2cE86Z/il8b+gw3r3+1nKatmIkjn2so1d01QraTlMqVSsbx
 NrRFi9wrf+M7Q== [email protected]
 ----
 
-За повече информация и детайлно упътване за създаване на SSH ключове на множество операционни системи, погледнете GitHub SSH keys страницата на адрес https://docs.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent[].
+За повече информация и детайлно упътване за създаване на SSH ключове на множество операционни системи, погледнете GitHub SSH keys страницата на адрес https://docs.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent[^].
diff --git a/book/04-git-server/sections/gitlab.asc b/book/04-git-server/sections/gitlab.asc
@@ -19,7 +19,7 @@ GitLab горещо препоръчва инсталирането на сър
 * От сорс-файлове.
 * От облачен доставчик като AWS, Google Cloud Platform, Azure, OpenShift и Digital Ocean.
 
-За повече информация прочетете https://gitlab.com/gitlab-org/gitlab-foss/-/blob/master/README.md[GitLab Community Edition (CE) ръководството].
+За повече информация прочетете https://gitlab.com/gitlab-org/gitlab-foss/-/blob/master/README.md[GitLab Community Edition (CE) ръководството^].
 
 ==== Администрация
 

diff --git a/book/04-git-server/sections/hosted.asc b/book/04-git-server/sections/hosted.asc
@@ -5,6 +5,6 @@
 Дори и да сте си инсталирали собствен сървър, може все още да искате да се възползвате от публичните хостинг услуги за съхранение на проектите ви с отворен код – така по-лесно ще бъдете в контакт с общността от open source разработчици.
 
 В днешни дни броят на хостинг опциите е достатъчно голям, така че да изберете вашата претегляйки предимствата и недостатъците им.
-Актуален списък на вариантите се поддържа в страницата GitHosting в основното wiki на Git на адрес https://git.wiki.kernel.org/index.php/GitHosting[].
+Актуален списък на вариантите се поддържа в страницата GitHosting в основното wiki на Git на адрес https://git.wiki.kernel.org/index.php/GitHosting[^].
 
 Ще разгледаме в детайли GitHub в главата <<ch06-github#ch06-github>>, понеже е най-голямата хостинг система в момента и вероятно ще искате да я ползвате така или иначе. Но съществуват и дузини други варианти, ако не желаете да инсталирате и поддържате собствен Git сървър.