diff --git a/README.md b/README.md
index 41be066..1abf4c0 100644
--- a/README.md
+++ b/README.md
@@ -190,6 +190,16 @@ state are as follows:
====
```
+# Fonts
+
+The following fonts are included (linked to their source):
+
+* (Atkinson Hyperlegible)[https://www.brailleinstitute.org/freefont] release 2020-0514 distributed under the terms of the (Open Font License)[https://braileinstitute.app.box.com/s/rin3vzegmcy7sil28yfqslz2r5etv5nl] (archived 2024-11-08)
+* (Fira Code)[https://github.com/tonsky/FiraCode] release 6.2 distributed under the terms of the (SIL Open Font License 1.1)[https://github.com/tonsky/FiraCode/blob/master/LICENSE] (archived 2024-11-08)
+
+The license files are also included in the fonts directory for reference.
+
+
# Additional information
For additional information, see the [docs-dev-guide/example.pdf](https://github.com/riscv/docs-dev-guide/blob/main/example.pdf) or reach out to
help@riscv.org.
diff --git a/fira_code.css b/fira_code.css
new file mode 100644
index 0000000..d215f82
--- /dev/null
+++ b/fira_code.css
@@ -0,0 +1,48 @@
+@font-face {
+ font-family: 'Fira Code';
+ src: url('woff2/FiraCode-Light.woff2') format('woff2'),
+ url("woff/FiraCode-Light.woff") format("woff");
+ font-weight: 300;
+ font-style: normal;
+}
+
+@font-face {
+ font-family: 'Fira Code';
+ src: url('woff2/FiraCode-Regular.woff2') format('woff2'),
+ url("woff/FiraCode-Regular.woff") format("woff");
+ font-weight: 400;
+ font-style: normal;
+}
+
+@font-face {
+ font-family: 'Fira Code';
+ src: url('woff2/FiraCode-Medium.woff2') format('woff2'),
+ url("woff/FiraCode-Medium.woff") format("woff");
+ font-weight: 500;
+ font-style: normal;
+}
+
+@font-face {
+ font-family: 'Fira Code';
+ src: url('woff2/FiraCode-SemiBold.woff2') format('woff2'),
+ url("woff/FiraCode-SemiBold.woff") format("woff");
+ font-weight: 600;
+ font-style: normal;
+}
+
+@font-face {
+ font-family: 'Fira Code';
+ src: url('woff2/FiraCode-Bold.woff2') format('woff2'),
+ url("woff/FiraCode-Bold.woff") format("woff");
+ font-weight: 700;
+ font-style: normal;
+}
+
+@font-face {
+ font-family: 'Fira Code VF';
+ src: url('woff2/FiraCode-VF.woff2') format('woff2-variations'),
+ url('woff/FiraCode-VF.woff') format('woff-variations');
+ /* font-weight requires a range: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Fonts/Variable_Fonts_Guide#Using_a_variable_font_font-face_changes */
+ font-weight: 300 700;
+ font-style: normal;
+}
\ No newline at end of file
diff --git a/fonts/Atkinson-Hyperlegible-Bold-102.svg b/fonts/Atkinson-Hyperlegible-Bold-102.svg
new file mode 100644
index 0000000..daecf91
--- /dev/null
+++ b/fonts/Atkinson-Hyperlegible-Bold-102.svg
@@ -0,0 +1,2300 @@
+
+
+
diff --git a/fonts/Atkinson-Hyperlegible-Bold-102.ttf b/fonts/Atkinson-Hyperlegible-Bold-102.ttf
new file mode 100644
index 0000000..14b7196
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-Bold-102.ttf differ
diff --git a/fonts/Atkinson-Hyperlegible-Bold-102.woff b/fonts/Atkinson-Hyperlegible-Bold-102.woff
new file mode 100644
index 0000000..e7f8977
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-Bold-102.woff differ
diff --git a/fonts/Atkinson-Hyperlegible-Bold-102a.woff2 b/fonts/Atkinson-Hyperlegible-Bold-102a.woff2
new file mode 100644
index 0000000..19a58ea
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-Bold-102a.woff2 differ
diff --git a/fonts/Atkinson-Hyperlegible-BoldItalic-102.svg b/fonts/Atkinson-Hyperlegible-BoldItalic-102.svg
new file mode 100644
index 0000000..1c2d2ae
--- /dev/null
+++ b/fonts/Atkinson-Hyperlegible-BoldItalic-102.svg
@@ -0,0 +1,2303 @@
+
+
+
diff --git a/fonts/Atkinson-Hyperlegible-BoldItalic-102.ttf b/fonts/Atkinson-Hyperlegible-BoldItalic-102.ttf
new file mode 100644
index 0000000..4532705
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-BoldItalic-102.ttf differ
diff --git a/fonts/Atkinson-Hyperlegible-BoldItalic-102.woff b/fonts/Atkinson-Hyperlegible-BoldItalic-102.woff
new file mode 100644
index 0000000..d6421ac
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-BoldItalic-102.woff differ
diff --git a/fonts/Atkinson-Hyperlegible-BoldItalic-102a.woff2 b/fonts/Atkinson-Hyperlegible-BoldItalic-102a.woff2
new file mode 100644
index 0000000..43f253e
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-BoldItalic-102a.woff2 differ
diff --git a/fonts/Atkinson-Hyperlegible-Font-License-2020-1104.pdf b/fonts/Atkinson-Hyperlegible-Font-License-2020-1104.pdf
new file mode 100644
index 0000000..afe27dc
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-Font-License-2020-1104.pdf differ
diff --git a/fonts/Atkinson-Hyperlegible-Italic-102.svg b/fonts/Atkinson-Hyperlegible-Italic-102.svg
new file mode 100644
index 0000000..30beae8
--- /dev/null
+++ b/fonts/Atkinson-Hyperlegible-Italic-102.svg
@@ -0,0 +1,1912 @@
+
+
+
diff --git a/fonts/Atkinson-Hyperlegible-Italic-102.ttf b/fonts/Atkinson-Hyperlegible-Italic-102.ttf
new file mode 100644
index 0000000..89e5ce4
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-Italic-102.ttf differ
diff --git a/fonts/Atkinson-Hyperlegible-Italic-102.woff b/fonts/Atkinson-Hyperlegible-Italic-102.woff
new file mode 100644
index 0000000..12d2d8c
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-Italic-102.woff differ
diff --git a/fonts/Atkinson-Hyperlegible-Italic-102a.woff2 b/fonts/Atkinson-Hyperlegible-Italic-102a.woff2
new file mode 100644
index 0000000..d35d3a7
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-Italic-102a.woff2 differ
diff --git a/fonts/Atkinson-Hyperlegible-Regular-102.svg b/fonts/Atkinson-Hyperlegible-Regular-102.svg
new file mode 100644
index 0000000..5bd4f9f
--- /dev/null
+++ b/fonts/Atkinson-Hyperlegible-Regular-102.svg
@@ -0,0 +1,1895 @@
+
+
+
diff --git a/fonts/Atkinson-Hyperlegible-Regular-102.ttf b/fonts/Atkinson-Hyperlegible-Regular-102.ttf
new file mode 100644
index 0000000..c4fa6fb
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-Regular-102.ttf differ
diff --git a/fonts/Atkinson-Hyperlegible-Regular-102.woff b/fonts/Atkinson-Hyperlegible-Regular-102.woff
new file mode 100644
index 0000000..bbe09c5
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-Regular-102.woff differ
diff --git a/fonts/Atkinson-Hyperlegible-Regular-102a.woff2 b/fonts/Atkinson-Hyperlegible-Regular-102a.woff2
new file mode 100644
index 0000000..99b3c6f
Binary files /dev/null and b/fonts/Atkinson-Hyperlegible-Regular-102a.woff2 differ
diff --git a/fonts/FiraCode-Bold.ttf b/fonts/FiraCode-Bold.ttf
new file mode 100644
index 0000000..f891bde
Binary files /dev/null and b/fonts/FiraCode-Bold.ttf differ
diff --git a/fonts/FiraCode-Bold.woff b/fonts/FiraCode-Bold.woff
new file mode 100644
index 0000000..74e57c4
Binary files /dev/null and b/fonts/FiraCode-Bold.woff differ
diff --git a/fonts/FiraCode-Bold.woff2 b/fonts/FiraCode-Bold.woff2
new file mode 100644
index 0000000..349dc36
Binary files /dev/null and b/fonts/FiraCode-Bold.woff2 differ
diff --git a/fonts/FiraCode-Light.ttf b/fonts/FiraCode-Light.ttf
new file mode 100644
index 0000000..5664ec3
Binary files /dev/null and b/fonts/FiraCode-Light.ttf differ
diff --git a/fonts/FiraCode-Light.woff b/fonts/FiraCode-Light.woff
new file mode 100644
index 0000000..1c1ebc6
Binary files /dev/null and b/fonts/FiraCode-Light.woff differ
diff --git a/fonts/FiraCode-Light.woff2 b/fonts/FiraCode-Light.woff2
new file mode 100644
index 0000000..eeaa303
Binary files /dev/null and b/fonts/FiraCode-Light.woff2 differ
diff --git a/fonts/FiraCode-Medium.ttf b/fonts/FiraCode-Medium.ttf
new file mode 100644
index 0000000..2c0ecdf
Binary files /dev/null and b/fonts/FiraCode-Medium.ttf differ
diff --git a/fonts/FiraCode-Medium.woff b/fonts/FiraCode-Medium.woff
new file mode 100644
index 0000000..19251b0
Binary files /dev/null and b/fonts/FiraCode-Medium.woff differ
diff --git a/fonts/FiraCode-Medium.woff2 b/fonts/FiraCode-Medium.woff2
new file mode 100644
index 0000000..7f1d770
Binary files /dev/null and b/fonts/FiraCode-Medium.woff2 differ
diff --git a/fonts/FiraCode-Regular.ttf b/fonts/FiraCode-Regular.ttf
new file mode 100644
index 0000000..bd73685
Binary files /dev/null and b/fonts/FiraCode-Regular.ttf differ
diff --git a/fonts/FiraCode-Regular.woff b/fonts/FiraCode-Regular.woff
new file mode 100644
index 0000000..8816b69
Binary files /dev/null and b/fonts/FiraCode-Regular.woff differ
diff --git a/fonts/FiraCode-Regular.woff2 b/fonts/FiraCode-Regular.woff2
new file mode 100644
index 0000000..f8b63fb
Binary files /dev/null and b/fonts/FiraCode-Regular.woff2 differ
diff --git a/fonts/FiraCode-Retina.ttf b/fonts/FiraCode-Retina.ttf
new file mode 100644
index 0000000..660742d
Binary files /dev/null and b/fonts/FiraCode-Retina.ttf differ
diff --git a/fonts/FiraCode-SemiBold.ttf b/fonts/FiraCode-SemiBold.ttf
new file mode 100644
index 0000000..d8dcef6
Binary files /dev/null and b/fonts/FiraCode-SemiBold.ttf differ
diff --git a/fonts/FiraCode-SemiBold.woff b/fonts/FiraCode-SemiBold.woff
new file mode 100644
index 0000000..97857db
Binary files /dev/null and b/fonts/FiraCode-SemiBold.woff differ
diff --git a/fonts/FiraCode-SemiBold.woff2 b/fonts/FiraCode-SemiBold.woff2
new file mode 100644
index 0000000..ccbefc8
Binary files /dev/null and b/fonts/FiraCode-SemiBold.woff2 differ
diff --git a/fonts/FiraCode-VF.woff b/fonts/FiraCode-VF.woff
new file mode 100644
index 0000000..c3407ed
Binary files /dev/null and b/fonts/FiraCode-VF.woff differ
diff --git a/fonts/FiraCode-VF.woff2 b/fonts/FiraCode-VF.woff2
new file mode 100644
index 0000000..e755a9d
Binary files /dev/null and b/fonts/FiraCode-VF.woff2 differ
diff --git a/fonts/LICENSE-FiraCode.txt b/fonts/LICENSE-FiraCode.txt
new file mode 100644
index 0000000..805e0b3
--- /dev/null
+++ b/fonts/LICENSE-FiraCode.txt
@@ -0,0 +1,93 @@
+Copyright (c) 2014, The Fira Code Project Authors (https://github.com/tonsky/FiraCode)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
diff --git a/themes/riscv-pdf.yml b/themes/riscv-pdf.yml
index 599556e..85551c4 100644
--- a/themes/riscv-pdf.yml
+++ b/themes/riscv-pdf.yml
@@ -3,25 +3,26 @@ extends: default
font:
catalog:
merge: true
- sans-serif: GEM_FONTS_DIR/mplus1p-regular-fallback.ttf
- #Petrona
+ sans-serif: Atkinson-Hyperlegible-Regular-102.ttf
+ #Atkinson Hyperlegible
body:
- normal: Petrona-Light.ttf
- bold: Petrona-Medium.ttf
- italic: Petrona-LightItalic.ttf
- bold_italic: Petrona-MediumItalic.ttf
- header_thin: Petrona-Thin.ttf
- #Montserrat
+ normal: Atkinson-Hyperlegible-Regular-102.ttf
+ bold: Atkinson-Hyperlegible-Bold-102.ttf
+ italic: Atkinson-Hyperlegible-Italic-102.ttf
+ bold_italic: Atkinson-Hyperlegible-BoldItalic-102.ttf
+ header_thin: Atkinson-Hyperlegible-Regular-102.ttf
headings:
- normal: Montserrat-Regular.ttf
- italic: Montserrat-Italic.ttf
- bold: Montserrat-Medium.ttf
- light: Montserrat-Light.ttf
+ normal: Atkinson-Hyperlegible-Regular-102.ttf
+ bold: Atkinson-Hyperlegible-Bold-102.ttf
+ italic: Atkinson-Hyperlegible-Italic-102.ttf
+ bold_italic: Atkinson-Hyperlegible-BoldItalic-102.ttf
+ light: Atkinson-Hyperlegible-Regular-102.ttf
+ # Fira Code
code:
- normal: cmunbtl.ttf
- bold: cmunbtl.ttf
- italic: cmunbto.ttf
- bold_italic: cmunbto.ttf
+ normal: FiraCode-Regular.ttf
+ bold: FiraCode-Bold.ttf
+ italic: FiraCode-Medium.ttf
+ bold_italic: FiraCode-SemiBold.ttf
# M+ 1mn supports ASCII and the circled numbers used for conums
M+ 1mn:
normal: mplus-1mn-regular.ttf