From b103a0cc9cebf5637eab51885994f66f0c06e319 Mon Sep 17 00:00:00 2001 From: Heiko Schaefer Date: Tue, 12 Dec 2023 13:27:04 +0100 Subject: [PATCH] remove zoom chapter anchors --- book/source/armor.md | 4 ++-- book/source/certificates.md | 2 +- book/source/encryption.md | 2 +- book/source/index.md | 2 +- book/source/private.md | 4 ++-- book/source/zoom/certificates.md | 1 - book/source/zoom/{encyption.md => encryption.md} | 1 - book/source/zoom/private_keys.md | 1 - book/source/zoom/signatures.md | 1 - 9 files changed, 7 insertions(+), 11 deletions(-) rename book/source/zoom/{encyption.md => encryption.md} (99%) diff --git a/book/source/armor.md b/book/source/armor.md index f0d66f4..956b318 100644 --- a/book/source/armor.md +++ b/book/source/armor.md @@ -21,7 +21,7 @@ OpenPGP's ASCII armor mechanism consists of: ## 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 $ cat alice_minimal.pub @@ -72,7 +72,7 @@ $ hexdump -C alice_minimal.pub.bin 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. diff --git a/book/source/certificates.md b/book/source/certificates.md index ba4d54e..5dfe238 100644 --- a/book/source/certificates.md +++ b/book/source/certificates.md @@ -15,7 +15,7 @@ Fundamentally, the effective management of {term}`certificates` of a {term}`certificate` are comprehensively discussed in [](/signing_components), offering a deeper understanding of {term}`certificate` structure and integrity. -- Finally, our chapter {ref}`zoom_certificates` discusses the internal structure of {term}`certificates` in detail. +- Finally, our chapter [](zoom/certificates) discusses the internal structure of {term}`certificates` in detail. ## Terminology: Understanding "keys" diff --git a/book/source/encryption.md b/book/source/encryption.md index 3122d46..ca4c5be 100644 --- a/book/source/encryption.md +++ b/book/source/encryption.md @@ -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. -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 diff --git a/book/source/index.md b/book/source/index.md index 9270cd2..00d4eb2 100644 --- a/book/source/index.md +++ b/book/source/index.md @@ -39,7 +39,7 @@ adv/signing_components.md zoom/certificates.md zoom/private_keys.md zoom/signatures.md -zoom/encyption.md +zoom/encryption.md glossary.md acknowledgements.md diff --git a/book/source/private.md b/book/source/private.md index 5c21d18..8b243d1 100644 --- a/book/source/private.md +++ b/book/source/private.md @@ -9,7 +9,7 @@ SPDX-License-Identifier: CC-BY-SA-4.0 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" @@ -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 ``` -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 `. diff --git a/book/source/zoom/certificates.md b/book/source/zoom/certificates.md index 9c09a64..31c8101 100644 --- a/book/source/zoom/certificates.md +++ b/book/source/zoom/certificates.md @@ -3,7 +3,6 @@ SPDX-FileCopyrightText: 2023 The "Notes on OpenPGP" project SPDX-License-Identifier: CC-BY-SA-4.0 --> -(zoom_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. diff --git a/book/source/zoom/encyption.md b/book/source/zoom/encryption.md similarity index 99% rename from book/source/zoom/encyption.md rename to book/source/zoom/encryption.md index 0005314..d58a5a9 100644 --- a/book/source/zoom/encyption.md +++ b/book/source/zoom/encryption.md @@ -3,7 +3,6 @@ SPDX-FileCopyrightText: 2023 The "Notes on OpenPGP" project SPDX-License-Identifier: CC-BY-SA-4.0 --> -(zoom_enc)= # Zooming in: Packet structure of encrypted data ## SEIPD v2 diff --git a/book/source/zoom/private_keys.md b/book/source/zoom/private_keys.md index ef4b90e..5172c49 100644 --- a/book/source/zoom/private_keys.md +++ b/book/source/zoom/private_keys.md @@ -3,7 +3,6 @@ SPDX-FileCopyrightText: 2023 The "Notes on OpenPGP" project SPDX-License-Identifier: CC-BY-SA-4.0 --> -(zoom_private)= # Zooming in: Packet structure of private key material ## A look at Alice's (unencrypted) private key packets diff --git a/book/source/zoom/signatures.md b/book/source/zoom/signatures.md index 8118896..306bbe7 100644 --- a/book/source/zoom/signatures.md +++ b/book/source/zoom/signatures.md @@ -3,7 +3,6 @@ SPDX-FileCopyrightText: 2023 The "Notes on OpenPGP" project SPDX-License-Identifier: CC-BY-SA-4.0 --> -(zoom_sign_data)= # 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.