Skip to content

Commit f66ee60

Browse files
committed
Абноўлена структура кнігі
1 parent a8cb61b commit f66ee60

673 files changed

Lines changed: 16617 additions & 4532 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.gitignore

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,12 @@ output
22
.DS_Store
33

44
# build artifacts
5+
Gemfile.lock
56
progit.html
67
progit.pdf
78
progit.pdfmarks
89
progit.epub
910
progit-kf8.epub
1011
progit.mobi
11-
/images/
12+
contributors.txt
13+
attributes-*

.mailmap

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
Jean-Noël Avila <jn.avila@free.fr>
2+
Scott Chacon <schacon@gmail.com>

book/A-git-in-other-environments/1-git-other-environments.asc renamed to A-git-in-other-environments.asc

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
[[A-git-in-other-environments]]
12
[appendix]
23
== Git in Other Environments
34

@@ -6,18 +7,21 @@ You can work with local files, connect your repository to others over a network,
67
But the story doesn't end there; Git is usually used as part of a larger ecosystem, and the terminal isn't always the best way to work with it.
78
Now we'll take a look at some of the other kinds of environments where Git can be useful, and how other applications (including yours) work alongside Git.
89

9-
include::sections/guis.asc[]
10+
include::book/A-git-in-other-environments/sections/guis.asc[]
1011

11-
include::sections/visualstudio.asc[]
12+
include::book/A-git-in-other-environments/sections/visualstudio.asc[]
1213

13-
include::sections/eclipse.asc[]
14+
include::book/A-git-in-other-environments/sections/visualstudiocode.asc[]
1415

16+
include::book/A-git-in-other-environments/sections/jetbrainsides.asc[]
1517

16-
include::sections/bash.asc[]
18+
include::book/A-git-in-other-environments/sections/sublimetext.asc[]
1719

18-
include::sections/zsh.asc[]
20+
include::book/A-git-in-other-environments/sections/bash.asc[]
1921

20-
include::sections/powershell.asc[]
22+
include::book/A-git-in-other-environments/sections/zsh.asc[]
23+
24+
include::book/A-git-in-other-environments/sections/powershell.asc[]
2125

2226
=== Summary
2327

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
[[B-embedding-git-in-your-applications]]
2+
[appendix]
3+
== Embedding Git in your Applications
4+
5+
If your application is for developers, chances are good that it could benefit from integration with source control.
6+
Even non-developer applications, such as document editors, could potentially benefit from version-control features, and Git's model works very well for many different scenarios.
7+
8+
If you need to integrate Git with your application, you have essentially two options: spawn a shell and call the `git` command-line program, or embed a Git library into your application.
9+
Here we'll cover command-line integration and several of the most popular embeddable Git libraries.
10+
11+
include::book/B-embedding-git/sections/command-line.asc[]
12+
13+
include::book/B-embedding-git/sections/libgit2.asc[]
14+
15+
include::book/B-embedding-git/sections/jgit.asc[]
16+
17+
include::book/B-embedding-git/sections/go-git.asc[]
18+
19+
include::book/B-embedding-git/sections/dulwich.asc[]
20+

C-git-commands.asc

Lines changed: 585 additions & 0 deletions
Large diffs are not rendered by default.

CONTRIBUTING.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Contributing to Pro Git (2nd Edition)
2+
3+
## Licensing your work to us
4+
5+
When you open a pull request, you agree to provide your work under the [project license](LICENSE.asc).
6+
Also, you agree to grant such license of your work as is required for the purposes of future print editions to @ben and @schacon.
7+
Should your changes appear in a printed edition, you'll be included in the [contributors list](book/contributors.asc).
8+
9+
## Signaling an Issue
10+
11+
Search for similar issues, before creating a new issue.
12+
13+
Also, if this issue has been spotted on the git-scm.com site, cross-check that the issue is present in the pdf version.
14+
The issue may have already been corrected in the source files, but not yet deployed to the git-scm.com site.
15+
16+
## Small Corrections
17+
18+
Errata and basic clarifications will be accepted if we agree that they improve the content.
19+
You can also open an issue so that we can discuss how or if the issue needs to be addressed.
20+
21+
If you've never done this before, the [flow guide](https://guides.github.com/introduction/flow/) might be useful.
22+
23+
## Large Rewrites
24+
25+
Open an issue for discussion before you start.
26+
A large rewrite tends to be very subjective, often only clarifying things for a small amount of readers.
27+
Professional copy editors have already reviewed this content multiple times.
28+
It's unlikely that your prose is going to be *so* much better that it's worth changing large portions of text.
29+
30+
## Figures
31+
32+
The images in this book are generated using [Sketch 3](https://www.sketchapp.com/), with the [included sketchbook file](diagram-source/progit.sketch).
33+
34+
To create a figure:
35+
36+
1. Add a page to the sketchbook.
37+
Use the included symbols wherever possible.
38+
2. Add a "slice" to your page.
39+
Name the slice so that it matches the destination PNG filename, relative from the root of the source directory.
40+
3. Set your slice to export at "800w".
41+
42+
## Translations
43+
44+
If you want to contribute to translating Pro Git into your language, take a look at [TRANSLATING.md](TRANSLATING.md).

Gemfile

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
source 'https://rubygems.org'
22

3-
gem 'rake'
4-
gem 'asciidoctor', '1.5.0'
3+
gem 'rake', '13.0.3'
4+
gem 'asciidoctor', '2.0.12'
55

6-
gem 'json'
7-
gem 'awesome_print'
6+
gem 'json', '2.5.1'
7+
gem 'awesome_print', '1.8.0'
88

9-
gem 'asciidoctor-epub3', '1.0.0.alpha.2'
10-
gem 'asciidoctor-pdf', '1.5.0.alpha.5'
9+
gem 'asciidoctor-epub3', '1.5.0.alpha.19'
10+
gem 'asciidoctor-pdf', '1.5.4'
1111

12-
gem 'coderay'
13-
gem 'pygments.rb'
14-
gem 'thread_safe'
15-
gem 'epubcheck'
16-
gem 'kindlegen'
12+
gem 'coderay', '1.1.3'
13+
gem 'pygments.rb', '2.0.0'
14+
gem 'thread_safe', '0.3.6'
15+
gem 'epubcheck-ruby', '4.2.4.0'
16+
gem 'html-proofer', '3.18.5'

Gemfile.lock

Lines changed: 0 additions & 74 deletions
This file was deleted.

LICENSE.asc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/3.0/ or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.
1+
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.
2+
To view a copy of this license, visit https://creativecommons.org/licenses/by-nc-sa/3.0 or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Pro.ico

1.57 MB
Binary file not shown.

0 commit comments

Comments
 (0)