remove zoom chapter anchors

This commit is contained in:
Heiko Schaefer 2023-12-12 13:27:04 +01:00
parent f8408dae30
commit b103a0cc9c
No known key found for this signature in database
GPG key ID: DAE9A9050FCCF1EB
9 changed files with 7 additions and 11 deletions

View file

@ -21,7 +21,7 @@ OpenPGP's ASCII armor mechanism consists of:
## Example ## Example
In the chapter {ref}`zoom_certificates`, we take a look at a very minimal variant of Alice's certificate. In ASCII armored form, the certificate is 388 bytes long, and looks like this: In the chapter [](zoom/certificates), we take a look at a very minimal variant of Alice's certificate. In ASCII armored form, the certificate is 388 bytes long, and looks like this:
```text ```text
$ cat alice_minimal.pub $ cat alice_minimal.pub
@ -72,7 +72,7 @@ $ hexdump -C alice_minimal.pub.bin
000000e4 000000e4
``` ```
If you read the chapter that discusses the [packet internals of certificate data](zoom_certificates), you may recognize this data. If you read the chapter that discusses the [packet internals of certificate data](/zoom/certificates), you may recognize this data.
This binary data is, of course, not convenient to copy into the text of an email, or similar. On the other hand, it's a more compact format. In this example, the binary OpenPGP data is around 40% smaller than the ASCII armored representation. This binary data is, of course, not convenient to copy into the text of an email, or similar. On the other hand, it's a more compact format. In this example, the binary OpenPGP data is around 40% smaller than the ASCII armored representation.

View file

@ -15,7 +15,7 @@ Fundamentally, the effective management of {term}`certificates<OpenPGP Certifica
- The bindings that link the {term}`components<Component>` of a {term}`certificate<OpenPGP Certificate>` are comprehensively discussed in [](/signing_components), offering a deeper understanding of {term}`certificate<OpenPGP Certificate>` structure and integrity. - The bindings that link the {term}`components<Component>` of a {term}`certificate<OpenPGP Certificate>` are comprehensively discussed in [](/signing_components), offering a deeper understanding of {term}`certificate<OpenPGP Certificate>` structure and integrity.
- Finally, our chapter {ref}`zoom_certificates` discusses the internal structure of {term}`certificates<OpenPGP Certificate>` in detail. - Finally, our chapter [](zoom/certificates) discusses the internal structure of {term}`certificates<OpenPGP Certificate>` in detail.
## Terminology: Understanding "keys" ## Terminology: Understanding "keys"

View file

@ -7,7 +7,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0
[Encryption](https://www.ietf.org/archive/id/draft-ietf-openpgp-crypto-refresh-12.html#name-confidentiality-via-encrypt) is one of the core facilities of OpenPGP. It provides confidentiality. [Encryption](https://www.ietf.org/archive/id/draft-ietf-openpgp-crypto-refresh-12.html#name-confidentiality-via-encrypt) is one of the core facilities of OpenPGP. It provides confidentiality.
For an in-depth, packet-level view of encrypted data in OpenPGP, see {ref}`zoom_enc`. For an in-depth, packet-level view of encrypted data in OpenPGP, see [](/zoom/encryption).
## Terminology ## Terminology

View file

@ -39,7 +39,7 @@ adv/signing_components.md
zoom/certificates.md zoom/certificates.md
zoom/private_keys.md zoom/private_keys.md
zoom/signatures.md zoom/signatures.md
zoom/encyption.md zoom/encryption.md
glossary.md glossary.md
acknowledgements.md acknowledgements.md

View file

@ -9,7 +9,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0
This chapter discusses the handling of private key material within OpenPGP. This chapter discusses the handling of private key material within OpenPGP.
Private key material is associated with component keys, which are integral parts of [OpenPGP certificates](/certificates). For a discussion of packet structure internals, see the chapter {ref}`zoom_private`. Private key material is associated with component keys, which are integral parts of [OpenPGP certificates](/certificates). For a discussion of packet structure internals, see the chapter [](zoom/private_keys).
## Terminology: "certificates" and "private keys" ## Terminology: "certificates" and "private keys"
@ -42,7 +42,7 @@ Sometimes it is useful to handle OpenPGP certificates combined with private key
OpenPGP certificate with integrated private key material, as a TSK OpenPGP certificate with integrated private key material, as a TSK
``` ```
The TSK format is particularly useful for backups of OpenPGP key material or transferring a key to a different computer[^gpg-tsk]. For insights into the packet structure of a TSK, see the chapter {ref}`zoom_private`. The TSK format is particularly useful for backups of OpenPGP key material or transferring a key to a different computer[^gpg-tsk]. For insights into the packet structure of a TSK, see the chapter [](zoom/private_keys).
[^gpg-tsk]: For example, in GnuPG, an OpenPGP key can be exported in (armored) TSK format using the following command: `gpg --export-secret-key --armor <fingerprint>`. [^gpg-tsk]: For example, in GnuPG, an OpenPGP key can be exported in (armored) TSK format using the following command: `gpg --export-secret-key --armor <fingerprint>`.

View file

@ -3,7 +3,6 @@ SPDX-FileCopyrightText: 2023 The "Notes on OpenPGP" project
SPDX-License-Identifier: CC-BY-SA-4.0 SPDX-License-Identifier: CC-BY-SA-4.0
--> -->
(zoom_certificates)=
# Zooming in: Packet structure of certificates # Zooming in: Packet structure of certificates
Now that we've established the concepts and components that make up OpenPGP certificates, let's look at the internal details of an example certificate. Now that we've established the concepts and components that make up OpenPGP certificates, let's look at the internal details of an example certificate.

View file

@ -3,7 +3,6 @@ SPDX-FileCopyrightText: 2023 The "Notes on OpenPGP" project
SPDX-License-Identifier: CC-BY-SA-4.0 SPDX-License-Identifier: CC-BY-SA-4.0
--> -->
(zoom_enc)=
# Zooming in: Packet structure of encrypted data # Zooming in: Packet structure of encrypted data
## SEIPD v2 ## SEIPD v2

View file

@ -3,7 +3,6 @@ SPDX-FileCopyrightText: 2023 The "Notes on OpenPGP" project
SPDX-License-Identifier: CC-BY-SA-4.0 SPDX-License-Identifier: CC-BY-SA-4.0
--> -->
(zoom_private)=
# Zooming in: Packet structure of private key material # Zooming in: Packet structure of private key material
## A look at Alice's (unencrypted) private key packets ## A look at Alice's (unencrypted) private key packets

View file

@ -3,7 +3,6 @@ SPDX-FileCopyrightText: 2023 The "Notes on OpenPGP" project
SPDX-License-Identifier: CC-BY-SA-4.0 SPDX-License-Identifier: CC-BY-SA-4.0
--> -->
(zoom_sign_data)=
# Zooming in: Packet structure of data signatures # Zooming in: Packet structure of data signatures
In this chapter, we'll create signatures using [Alice's private key](alice_priv) material, and inspect the packet structure of those signatures. In this chapter, we'll create signatures using [Alice's private key](alice_priv) material, and inspect the packet structure of those signatures.