Commit graph

932 commits

Author SHA1 Message Date
Heiko Schaefer
0a69d68a73
move dks vs. primary uid note to advanced section 2023-12-07 22:13:59 +01:00
Heiko Schaefer
060419b34e
initial draft of "naming/fingerprints" section 2023-12-07 22:13:58 +01:00
Heiko Schaefer
3a2d8cad55
initial draft of "merging" section 2023-12-07 22:13:58 +01:00
Heiko Schaefer
83d14fa5de
initial draft of "append only" section 2023-12-07 22:13:58 +01:00
Heiko Schaefer
1e6eaf5d3b
minimization: add link to autocrypt minimal certificate format 2023-12-07 22:13:58 +01:00
Heiko Schaefer
4273dcbd78
minimization: enumerate things that can be filtered, add section about koo 2023-12-07 22:13:58 +01:00
Heiko Schaefer
b049915e50
ch4: edit "minimization" for flow, clarity, terminology 2023-12-07 22:13:57 +01:00
Heiko Schaefer
1b3a595815
add "deflist" to myst_enable_extensions (to render GnuPG documentation excerpt in chapter 4) 2023-12-07 22:13:57 +01:00
Heiko Schaefer
8d21b15d56
ch4: restructure "advanced" section 2023-12-07 22:13:57 +01:00
Wiktor Kwapisiewicz
340199b78e
Add notes about certificate minimization 2023-12-07 22:13:57 +01:00
Heiko Schaefer
03515927b3
ch9: edits for clarity 2023-12-07 13:01:11 +01:00
Heiko Schaefer
d04b91eb48
soften versions section 2023-12-06 15:00:02 +01:00
heiko
a719bc4441 Merge pull request 'some glossary definition tweaks' (#173) from heiko-glossary into draft
Reviewed-on: https://codeberg.org/openpgp/notes/pulls/173
2023-12-06 12:43:37 +00:00
Heiko Schaefer
ab497ce601
g: add "Binding Signature" 2023-12-05 21:10:10 +01:00
Heiko Schaefer
56c9da55db
g: expand "certification" definition 2023-12-05 21:10:10 +01:00
Heiko Schaefer
7f7df00f43
g: delegation/trust signature 2023-12-05 21:10:10 +01:00
Heiko Schaefer
b4a48b7f28
ch8: add link anchor 2023-12-05 21:10:09 +01:00
Heiko Schaefer
09c8265621
g: expand primary/subkey definition, linking to the "component key" term 2023-12-05 21:10:09 +01:00
Heiko Schaefer
327975fff6
g: OpenPGP Fingerprint 2023-12-05 21:10:09 +01:00
Heiko Schaefer
c365856943
add link anchor 2023-12-05 21:09:15 +01:00
David Runge
c2590d31ec
Remove unused PNGs
Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-05 16:07:07 +01:00
David Runge
5ae3e82c18
Replace use of PNGs with converted SVGs (where available)
Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-05 16:07:06 +01:00
David Runge
7e11d786c2
Add new SVG diagrams and update all existing to current versions
Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-05 16:07:06 +01:00
David Runge
43b6080fbe
Add make target to convert all SVGs to plain SVG before rendering
Adapt HTML and EPUB targets to run conversion target before rendering
EPUB or HTML output.

Fixes https://codeberg.org/openpgp/notes/issues/166

Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-05 16:07:02 +01:00
Heiko Schaefer
28dd67d7f7
Merge branch '09-verification' into draft 2023-12-05 13:42:23 +01:00
David Runge
9848143e77
Add glossary entries and links for chapter 1 - 4 and 6
Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-04 22:37:06 +01:00
David Runge
840d6bdd0f
Add contributing guidelines for glossary entries
Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-04 22:37:05 +01:00
David Runge
cd1ac71ba5
Add CSS to separate footnotes more clearly from sections in HTML output
Fixes https://codeberg.org/openpgp/notes/issues/164

Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-04 22:37:04 +01:00
David Runge
9774054abe
Add CSS for separating footnotes from section text in EPUB more clearly
Fixes https://codeberg.org/openpgp/notes/issues/164

Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-04 22:37:04 +01:00
David Runge
e66a5760b5
Integrate custom CSS for the HTML output
Set a high priority for the custom CSS so that it is able to override
theme CSS.

Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-04 22:37:03 +01:00
David Runge
2b2c02d836
Add custom CSS for the HTML output
Distinguish links to internal glossary items (default text color, dotted
bottom border) and those to sections, references or footnotes (blue,
dashed bottom border).
Use darkgreen (solid bottom border) for external links instead of the
default blue.

Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-04 22:37:03 +01:00
David Runge
8c72b89182
Add CSS for internal and external links in the EPUB output
Distinguish internal links to glossary items (black, dotted bottom
border) and sections, references and footnote (blue, dashed bottom
border).
Use darkgreen (solid bottom border) instead of blue for external links.

Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-04 22:37:01 +01:00
David Runge
158ece0f60
Add comment for CSS entries for admonitions in EPUB output
Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-04 22:37:01 +01:00
David Runge
91fea4f45d
Add make target to rebuild HTML files when markdown changes
Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-04 22:37:00 +01:00
David Runge
588bd02553
Add make target to rebuild (and show) epub file on change to markdown
Signed-off-by: David Runge <dave@sleepmap.de>
2023-12-04 22:36:58 +01:00
heiko
7e86166b9c Merge pull request 'Feedback Chapter 8' (#152) from paul-ch8-feedback into draft
Reviewed-on: https://codeberg.org/openpgp/notes/pulls/152
2023-12-04 13:28:23 +00:00
heiko
b63a5851f7 Merge pull request 'tammi edits to paul-ch8-feedback' (#170) from paul-ch8-tammi into paul-ch8-feedback
Reviewed-on: https://codeberg.org/openpgp/notes/pulls/170
2023-12-04 13:28:08 +00:00
Tammi L. Coles
f41cd95139 move globally 2023-12-04 13:07:44 +00:00
Tammi L. Coles
34954ef996 edit to commit e496ee28e7 2023-12-04 12:57:44 +00:00
Tammi L. Coles
a20aaba4d3 edits to commit 7e339903fc 2023-12-04 11:49:19 +00:00
Tammi L. Coles
6bc0ddddd9 remove s to clarify the or choice 2023-12-04 11:31:35 +00:00
Tammi L. Coles
16d4442073 ed ch8 feedback commit e59e70939c 2023-12-04 11:19:41 +00:00
Heiko Schaefer
32566e4bb0
Move "best practices" section down, write a minimal text 2023-12-02 21:19:59 +01:00
Heiko Schaefer
af44cc65ca
clarify KO attack details and mitigation 2023-12-02 21:18:31 +01:00
Tammi L. Coles
3320783920 integrate @vanitasvitae comments 2023-12-02 18:20:53 +00:00
Tammi L. Coles
edbea315ab clarify appropriate use for TSKs per Heiko discussion 2023-12-02 18:09:23 +00:00
Tammi L. Coles
5be8479402 restore "terminology" per discussion with Heiko 2023-12-02 18:03:09 +00:00
heiko
93519777c7 Merge pull request 'ch4: add two new diagrams' (#160) from heiko-ch4 into draft
Reviewed-on: https://codeberg.org/openpgp/notes/pulls/160
2023-12-02 18:02:19 +00:00
Tammi L. Coles
05d95c07bf correct last fix in commit 463030f945 2023-12-02 17:56:01 +00:00
Tammi L. Coles
463030f945 edits to commit f6bec55df5 2023-12-02 17:54:27 +00:00