Skip to content

Commit eb83166

Browse files
authored
Use caret shorthand to open links in new tab
1 parent 21bd27a commit eb83166

File tree

37 files changed

+86
-87
lines changed

37 files changed

+86
-87
lines changed

book/01-introduction/sections/about-version-control.asc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ To deal with this issue, programmers long ago developed local VCSs that had a si
2323
image::images/local.png[Local version control diagram]
2424

2525
One of the most popular VCS tools was a system called RCS, which is still distributed with many computers today.
26-
https://www.gnu.org/software/rcs/[RCS] works by keeping patch sets (that is, the differences between files) in a special format on disk; it can then re-create what any file looked like at any point in time by adding up all the patches.
26+
https://www.gnu.org/software/rcs/[RCS^] works by keeping patch sets (that is, the differences between files) in a special format on disk; it can then re-create what any file looked like at any point in time by adding up all the patches.
2727

2828
==== Centralized Version Control Systems
2929

book/01-introduction/sections/help.asc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ $ git help config
1818
----
1919

2020
These commands are nice because you can access them anywhere, even offline.
21-
If the manpages and this book aren't enough and you need in-person help, you can try the `#git`, `#github`, or `#gitlab` channels on the Libera Chat IRC server, which can be found at https://libera.chat/[].
21+
If the manpages and this book aren't enough and you need in-person help, you can try the `#git`, `#github`, or `#gitlab` channels on the Libera Chat IRC server, which can be found at https://libera.chat/[^].
2222
These channels are regularly filled with hundreds of people who are all very knowledgeable about Git and are often willing to help.(((IRC)))
2323

2424
In addition, if you don't need the full-blown manpage help, but just need a quick refresher on the available options for a Git command, you can ask for the more concise "`help`" output with the `-h` option, as in:

book/01-introduction/sections/installing.asc

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ If you're on a Debian-based distribution, such as Ubuntu, try `apt`:
2929
$ sudo apt install git-all
3030
----
3131

32-
For more options, there are instructions for installing on several different Unix distributions on the Git website, at https://git-scm.com/download/linux[].
32+
For more options, there are instructions for installing on several different Unix distributions on the Git website, at https://git-scm.com/download/linux[^].
3333

3434
==== Installing on macOS
3535

@@ -46,7 +46,7 @@ $ git --version
4646
If you don't have it installed already, it will prompt you to install it.
4747

4848
If you want a more up to date version, you can also install it via a binary installer.
49-
A macOS Git installer is maintained and available for download at the Git website, at https://git-scm.com/download/mac[].
49+
A macOS Git installer is maintained and available for download at the Git website, at https://git-scm.com/download/mac[^].
5050

5151
.Git macOS Installer
5252
image::images/git-osx-installer.png[Git macOS installer]
@@ -55,10 +55,10 @@ image::images/git-osx-installer.png[Git macOS installer]
5555

5656
There are also a few ways to install Git on Windows.(((Windows, installing)))
5757
The most official build is available for download on the Git website.
58-
Just go to https://git-scm.com/download/win[] and the download will start automatically.
59-
Note that this is a project called Git for Windows, which is separate from Git itself; for more information on it, go to https://gitforwindows.org[].
58+
Just go to https://git-scm.com/download/win[^] and the download will start automatically.
59+
Note that this is a project called Git for Windows, which is separate from Git itself; for more information on it, go to https://gitforwindows.org[^].
6060

61-
To get an automated installation you can use the https://chocolatey.org/packages/git[Git Chocolatey package].
61+
To get an automated installation you can use the https://chocolatey.org/packages/git[Git Chocolatey package^].
6262
Note that the Chocolatey package is community maintained.
6363

6464
==== Installing from Source
@@ -87,7 +87,7 @@ $ sudo apt-get install asciidoc xmlto docbook2x
8787

8888
[NOTE]
8989
====
90-
Users of RHEL and RHEL-derivatives like CentOS and Scientific Linux will have to https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F[enable the EPEL repository] to download the `docbook2X` package.
90+
Users of RHEL and RHEL-derivatives like CentOS and Scientific Linux will have to https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F[enable the EPEL repository^] to download the `docbook2X` package.
9191
====
9292

9393
If you're using a Debian-based distribution (Debian/Ubuntu/Ubuntu-derivatives), you also need the `install-info` package:
@@ -114,7 +114,7 @@ $ sudo ln -s /usr/bin/db2x_docbook2texi /usr/bin/docbook2x-texi
114114
due to binary name differences.
115115

116116
When you have all the necessary dependencies, you can go ahead and grab the latest tagged release tarball from several places.
117-
You can get it via the kernel.org site, at https://www.kernel.org/pub/software/scm/git[], or the mirror on the GitHub website, at https://github.com/git/git/releases[].
117+
You can get it via the kernel.org site, at https://www.kernel.org/pub/software/scm/git[], or the mirror on the GitHub website, at https://github.com/git/git/releases[^].
118118
It's generally a little clearer what the latest version is on the GitHub page, but the kernel.org page also has release signatures if you want to verify your download.
119119

120120
Then, compile and install:

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -254,7 +254,7 @@ doc/**/*.pdf
254254

255255
[TIP]
256256
====
257-
GitHub maintains a fairly comprehensive list of good `.gitignore` file examples for dozens of projects and languages at https://github.com/github/gitignore[] if you want a starting point for your project.
257+
GitHub maintains a fairly comprehensive list of good `.gitignore` file examples for dozens of projects and languages at https://github.com/github/gitignore[^] if you want a starting point for your project.
258258
====
259259

260260
[NOTE]

book/04-git-server/sections/generating-ssh-key.asc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,4 +54,4 @@ mZ+AW4OZPnTPI89ZPmVMLuayrD2cE86Z/il8b+gw3r3+1nKatmIkjn2so1d01QraTlMqVSsbx
5454
NrRFi9wrf+M7Q== [email protected]
5555
----
5656

57-
For a more in-depth tutorial on creating an SSH key on multiple operating systems, see the GitHub guide on SSH keys at https://docs.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent[].
57+
For a more in-depth tutorial on creating an SSH key on multiple operating systems, see the GitHub guide on SSH keys at https://docs.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent[^].

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ The other installation options are:
1919
* From the source files.
2020
* Cloud provider such as AWS, Google Cloud Platform, Azure, OpenShift and Digital Ocean.
2121

22-
For more information read the https://gitlab.com/gitlab-org/gitlab-foss/-/blob/master/README.md[GitLab Community Edition (CE) readme].
22+
For more information read the https://gitlab.com/gitlab-org/gitlab-foss/-/blob/master/README.md[GitLab Community Edition (CE) readme^].
2323

2424
==== Administration
2525

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,6 @@ Doing so offers a number of advantages: a hosting site is generally quick to set
55
Even if you set up and run your own server internally, you may still want to use a public hosting site for your open source code – it's generally easier for the open source community to find and help you with.
66

77
These days, you have a huge number of hosting options to choose from, each with different advantages and disadvantages.
8-
To see an up-to-date list, check out the GitHosting page on the main Git wiki at https://git.wiki.kernel.org/index.php/GitHosting[].
8+
To see an up-to-date list, check out the GitHosting page on the main Git wiki at https://git.wiki.kernel.org/index.php/GitHosting[^].
99

1010
We'll cover using GitHub in detail in <<ch06-github#ch06-github>>, as it is the largest Git host out there and you may need to interact with projects hosted on it in any case, but there are dozens more to choose from should you not want to set up your own Git server.

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Here we'll discuss what they are and in what basic circumstances you would want
77

88
(((protocols, local)))
99
The most basic is the _Local protocol_, in which the remote repository is in another directory on the same host.
10-
This is often used if everyone on your team has access to a shared filesystem such as an https://en.wikipedia.org/wiki/Network_File_System[NFS] mount, or in the less likely case that everyone logs in to the same computer.
10+
This is often used if everyone on your team has access to a shared filesystem such as an https://en.wikipedia.org/wiki/Network_File_System[NFS^] mount, or in the less likely case that everyone logs in to the same computer.
1111
The latter wouldn't be ideal, because all your code repository instances would reside on the same computer, making a catastrophic loss much more likely.
1212

1313
If you have a shared mounted filesystem, then you can clone, push to, and pull from a local file-based repository.
@@ -82,7 +82,7 @@ Instead of having to set up different URLs for these things, you can now use a s
8282
If you try to push and the repository requires authentication (which it normally should), the server can prompt for a username and password.
8383
The same goes for read access.
8484

85-
In fact, for services like GitHub, the URL you use to view the repository online (for example, https://github.com/schacon/simplegit[]) is the same URL you can use to clone and, if you have access, push over.
85+
In fact, for services like GitHub, the URL you use to view the repository online (for example, https://github.com/schacon/simplegit[^]) is the same URL you can use to clone and, if you have access, push over.
8686

8787
===== Dumb HTTP
8888

book/04-git-server/sections/smart-http.asc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,5 +68,5 @@ You can do this with nearly any CGI-capable web server, so go with the one that
6868

6969
[NOTE]
7070
====
71-
For more information on configuring authentication in Apache, check out the Apache docs here: https://httpd.apache.org/docs/current/howto/auth.html[]
71+
For more information on configuring authentication in Apache, check out the Apache docs here: https://httpd.apache.org/docs/current/howto/auth.html[^]
7272
====

book/05-distributed-git/sections/contributing.asc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Getting in the habit of creating quality commit messages makes using and collabo
6060
As a general rule, your messages should start with a single line that's no more than about 50 characters and that describes the changeset concisely, followed by a blank line, followed by a more detailed explanation.
6161
The Git project requires that the more detailed explanation include your motivation for the change and contrast its implementation with previous behavior -- this is a good guideline to follow.
6262
Write your commit message in the imperative: "Fix bug" and not "Fixed bug" or "Fixes bug."
63-
Here is a template you can follow, which we've lightly adapted from one https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html[originally written by Tim Pope]:
63+
Here is a template you can follow, which we've lightly adapted from one https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html[originally written by Tim Pope^]:
6464

6565
[source,text]
6666
----
@@ -154,7 +154,7 @@ To jessica@githost:simplegit.git
154154
The last line of the output above shows a useful return message from the push operation.
155155
The basic format is `<oldref>..<newref> fromref -> toref`, where `oldref` means the old reference, `newref` means the new reference, `fromref` is the name of the local reference being pushed, and `toref` is the name of the remote reference being updated.
156156
You'll see similar output like this below in the discussions, so having a basic idea of the meaning will help in understanding the various states of the repositories.
157-
More details are available in the documentation for https://git-scm.com/docs/git-push[git-push].
157+
More details are available in the documentation for https://git-scm.com/docs/git-push[git-push^].
158158

159159
Continuing with this example, shortly afterwards, John makes some changes, commits them to his local repository, and tries to push them to the same server:
160160

0 commit comments

Comments
 (0)