44 | 
49 | 
77 | 
82 | 
91 | 
96 | 
All articles
6 | {% endblock %} 7 | 8 |-
9 | {% for article in articles_page.object_list %}
10 |
11 | {{ article.title }}
{{ article.summary }}21 |
22 | {% endfor %}
23 |
49 | {*@fig:ctxt-make}: ConTEXT shell commands. 50 |
172 | *@fig:msvc-bld-cfg: Build Configurations.
173 |
174 | |
20 |
21 |
25 | 
22 | 23 | {*@fig:gba}: original GBA. 24 | |
26 |
27 |
28 |
32 | 
29 | 30 | {*@fig:gba-sp}: GBA-SP. 31 | |
33 |
| area | 79 |start | 80 |end | 81 |length | 82 |port-size | 83 |description | 84 |
|---|---|---|---|---|---|
| System ROM | 89 |0000:0000 |
90 | 0000:03FF |
91 | 16 KB | 92 |32 bit | 93 |Bios memory. You can execute it, but not read it (i.o.w, touch, don't look) | 94 |
| EWRAM | 97 |0200:0000h |
98 | 0203:FFFFh |
99 | 256 KB | 100 |16 bit | 101 |External work RAM. Is available for your code and data. If you're using a multiboot cable, this is where the downloaded code goes and execution starts (normally execution starts at ROM). Due to the 16-bit port, you want this section's code to be Thumb code. | 102 |
| IWRAM | 105 |0300:0000h |
106 | 0300:7FFFh |
107 | 32 KB | 108 |32 bit | 109 |This is also available for code and data. The 32-bit bus and the fact it's embedded in the CPU make this the fastest memory section. The 32-bit bus means that ARM instructions can be loded at once, so put your ARM code here. | 110 |
| IO RAM | 113 |0400:0000h |
114 | 0400:03FFh |
115 | 1 KB | 116 |32 bit | 117 |Memory-mapped IO registers. These have nothing to do with the CPU registers you use in assembly so the name can be a bit confusing. Don't blame me for that. This section is where you control graphics, sound, buttons and other features. | 118 |
| PAL RAM | 121 |0500:0000h |
122 | 0500:03FFh |
123 | 1 KB | 124 |16 bit | 125 |Memory for two palettes contaning 256 entries of 15-bit colors each. The first is for backgrounds, the second for sprites. | 126 |
| VRAM | 129 |0600:0000h |
130 | 0601:7FFFh |
131 | 96 KB | 132 |16 bit | 133 |Video RAM. This is where the data used for backgrounds and sprites are stored. The interpretation of this data depends on a number of things, including video mode and background and sprite settings. | 134 |
| OAM | 137 |0700:0000h |
138 | 0700:03FFh |
139 | 1 KB | 140 |32 bit | 141 |Object Attribute Memory. This is where you control the sprites. | 142 |
| PAK ROM | 145 |0800:0000h |
146 | var | 147 |var | 148 |16 bit | 149 |Game Pak ROM. This is where the game is located and execution starts, except when you're running from a multiboot cable. This size is variable, but the limit is 32 MB. It's a 16-bit bus, so Thumb code is preferable over ARM code here. | 150 |
| Cart RAM | 153 |0E00:0000h |
154 | var | 155 |var | 156 |8 bit | 157 |This is where saved data is stored. Cart RAM can be in the form of SRAM, Flash ROM or EEPROM. Programatically they all do the same thing: store data. The total size is variable, but 64 KB is a good indication. | 158 |
| Links 18 | | Home 19 | | Projects 20 | |
27 |
28 | 
29 |
30 | |
31 |
32 | 
33 |
34 | |
35 |
36 | 
37 |
38 | | |||||||||
40 |
|
52 |
|
73 |
| |||||||||
86 |
| |||||||||||
| Prev 104 | | Home 105 | | Next 106 | |
| Links 108 | | 109 | | Projects 110 | |
| #cycles | frequency | period 24 | |
|---|---|---|
| 1 | 16.78 MHz | 59.59 ns 25 | |
| 64 | 262.21 kHz | 3.815 μs 26 | |
| 256 | 65.536 kHz | 15.26 μs 27 | |
| 1024 | 16.384 kHz | 61.04 μs 28 | |
| reg | function | address 41 | |
|---|---|---|
REG_TMxD | data 42 | | 0400:0100h + 04h·x
43 | |
REG_TMxCNT | control 44 | | 0400:0102h + 04h·x
45 | |
| F E D C B A 9 8 | 7 | 6 | 5 4 3 | 2 | 1 0 57 | |
| - 59 | | En 60 | | I 61 | | - 62 | | CM 63 | | Fr 64 | |
| bits | name | define | description 71 | |
|---|---|---|---|
| 0-1 | Fr 74 | | TM_FREQ_y 75 | | Timer frequency. 0-3 for 1, 64, 256, or 1024 cycles,
76 | respectively. y in the define is the number of
77 | cycles.
78 | |
| 2 | CM 80 | | TM_CASCADE 81 | | Cascade mode. When the counter of the preceding
82 | (x−1) timer overflows (REG_TM(x-1)D=
83 | 0xffff), this one will be incremented too. A timer that
84 | has this bit set does not count on its own, though you
85 | still have to enable it. Obviously, this won't work for timer 0.
86 | If you plan on using it make sure you understand exactly what I
87 | just said; this place is a death-trap for the unwary.
88 | |
| 6 | I 90 | | TM_IRQ 91 | | Raise an interrupt on overflow. 92 | |
| 7 | En 94 | | TM_ENABLE 95 | | Enable the timer. 96 | |
128 |
129 | **{*@fig:tmr-demo}**: `tmr_demo`.
130 | | i | 27 |Contents | 28 |1 | 29 |
|---|---|---|
| ii | 32 |Introduction to Tonc | 33 |3 | 34 |
| 1 | 49 |GBA Hardware | 50 |7 | 51 |
|---|---|---|
| 2 | 54 |Setting up a development environment | 55 |10 | 56 |
| 3 | 59 |My First GBA Demo | 60 |21 | 61 |
| 4 | 64 |Video Introduction | 65 |34 | 66 |
| 5 | 69 |The bitmap modes | 70 |38 | 71 |
| 6 | 74 |The GBA keypad | 75 |56 | 76 |
| 7 | 79 |Sprite and tiled background overview | 80 |62 | 81 |
| 8 | 84 |Regular sprites | 85 |67 | 86 |
| 9 | 89 |Regular tiled backgrounds | 90 |78 | 91 |
| 10 | 106 |The affine transformation matrix | 107 |92 | 108 |
|---|---|---|
| 11 | 111 |Affine sprites | 112 |98 | 113 |
| 12 | 116 |Affine tiled backgrounds | 117 |109 | 118 |
| 13 | 121 |Graphic effects | 122 |115 | 123 |
| 14 | 126 |Direct Memory Access | 127 |126 | 128 |
| 15 | 131 |Timers | 132 |133 | 133 |
| 16 | 136 |Hardware interrupts | 137 |136 | 138 |
| 17 | 141 |BIOS calls | 142 |147 | 143 |
| 18 | 146 |Beep! GBA sound introduction | 147 |155 | 148 |
| 19 | 164 |Text systems | 165 |165 | 166 |
|---|---|---|
| 20 | 169 |Mode 7 | 170 |192 | 171 |
| 21 | 174 |More Mode7 tricks | 175 |209 | 176 |
| 22 | 179 |Tonc's Text Engine | 180 |213 | 181 |
| 23 | 184 |Whirlwind tour of ARM assembly | 185 |244 | 186 |
| 24 | 189 |The Lab | 190 |276 | 191 |
| A | 205 |Numbers, bits and bit operations | 206 |283 | 207 |
|---|---|---|
| B | 210 |Fixed-point math & LUTs | 211 |294 | 212 |
| C | 215 |Vector and matrix math | 216 |304 | 217 |
| D | 220 |More on makefiles and compiler options | 221 |311 | 222 |
| E | 225 |Make via editors | 226 |316 | 227 |
| F | 230 |References | 231 |322 | 232 |
| G | 235 |Change log | 236 |325 | 237 |
249 | Tonc v1.4 is final. Yeah, I said that about v1.0 as well, but this 250 | time I mean it. Really. Honest. Cross my heart and hope to die, etc, 251 | etc. 252 | Well … barring minor errata, this will be 253 | final. Honest, cross my heart, yadda yadda yadda. 254 |
255 | 256 | 257 | 258 | 259 | -------------------------------------------------------------------------------- /maintainer/PORTING_TO_MARKDOWN.md: -------------------------------------------------------------------------------- 1 | 2 | ## Converting pages to markdown 3 | 4 | Conversion can be done one page at a time. 5 | 6 | You can use `pandoc` to get you started: 7 | 8 | ### 1. Initial conversion 9 | 10 | ```sh 11 | cd content 12 | 13 | # rename to avoid conflicts in page generation 14 | mv intro.htm intro-old.htm 15 | 16 | # run through pandoc (minus some extensions to get sane output) 17 | pandoc --from=html --to=markdown-fenced_divs-bracketed_spans-escaped_line_breaks-smart --wrap=none -o intro.md intro-old.htm 18 | ``` 19 | 20 | Then replace the table of contents with a `` marker: 21 | 22 | ```md 23 | # ii. Introduction to Tonc 24 | 25 | 26 | ``` 27 | 28 | Add a link from `SUMMARY.md` to the new markdown file to add it to the table of contents. 29 | 30 | ### 2. Cleanup 31 | 32 | Next, go through the page and fix anything that's broken. 33 | 34 | For example: 35 | 36 | * Change `` back to `` (for some reason pandoc messes this up). Same goes for `` and some other tags. 37 | 38 | ``` 39 | sed -i '' -E 's,([^<]+),\1,g' pagename.md 40 | ``` 41 | 42 | * Remove section numbers from headings (but the number in the page title should stay, e.g. `# 3. My first GBA demo`) 43 | 44 | ``` 45 | sed -i '' -E 's,^(##+) [0-9]+\.[0-9.]+,\1,g' pagename.md 46 | # For appendices, do this instead: 47 | sed -i '' -E 's,^(##+) [A-G]\.[0-9.]+,\1,g' pagename.md 48 | ``` 49 | 50 | * Replace Tables and Figures with the raw HTML from the `-old.htm` file. 51 | 52 | * Equations are coded in MathML, which displays in all browsers since 2023 according to [Can I use](https://caniuse.com/mathml). 53 | It's recommended to write equations in LaTeX first, using a live preview tool such as [Online LaTeX Equation Editor](https://latexeditor.lagrida.com/). 54 | Right-click the preview and choose Copy to Clipboard > MathML Code. 55 | 56 | * Set the correct language on each code block (`c`, `asm`, `sh`, `makefile`) 57 | 58 | * Use backticks (`` ` ``) around code keywords and italics (`*`) around file names in the text. 59 | 60 | * Container tags need empty lines after them, otherwise the Markdown within won't be rendered properly. For example: 61 | 62 | ```html 63 |
113 | **{*@fig:toncdirs}**: directories.
114 | ```
115 |
116 | Will be rendered as:
117 |
118 | |
121 |
122 | |
126 |
{title}
") 89 | } 90 | .into(), 91 | ); 92 | } 93 | } 94 | } 95 | } 96 | } 97 | _ => {} 98 | } 99 | 100 | self.at_paragraph_start = matches!(evt, Event::Start(Tag::Paragraph)); 101 | 102 | Some(evt) 103 | } 104 | } 105 | -------------------------------------------------------------------------------- /preproc/src/git.rs: -------------------------------------------------------------------------------- 1 | /* 2 | * Adapted from gbdev's Pan Docs preprocessor 3 | * https://github.com/gbdev/pandocs/blob/master/preproc/src/git.rs 4 | * 5 | * This Source Code Form is subject to the 6 | * terms of the Mozilla Public License, v. 7 | * 2.0. If a copy of the MPL was not 8 | * distributed with this file, You can 9 | * obtain one at 10 | * http://mozilla.org/MPL/2.0/. 11 | */ 12 | 13 | use std::process::{Command, Stdio}; 14 | 15 | use anyhow::Error; 16 | 17 | #[derive(Debug)] 18 | pub struct Commit { 19 | info: String, 20 | splits: [usize; 2], 21 | } 22 | 23 | impl Commit { 24 | pub fn rev_parse(what: &str) -> Result{} ({}). ",
128 | commit.hash(), commit.short_hash(), commit.timestamp(),
129 | ));
130 | }
131 | }
132 | });
133 |
134 | res.map(|_| book)
135 | }
136 | }
137 |
--------------------------------------------------------------------------------
/theme/css/general.css:
--------------------------------------------------------------------------------
1 | /* Base styles and content styles */
2 |
3 | @import '../fonts/fira_code.css';
4 | @import 'variables.css';
5 |
6 | @font-face {
7 | font-family: 'SourceSans3';
8 | src: url('../fonts/SourceSans3-Regular.otf.woff') format('woff');
9 | font-weight: normal;
10 | font-style: normal;
11 | }
12 |
13 | @font-face {
14 | font-family: 'SourceSans3';
15 | src: url('../fonts/SourceSans3-It.otf.woff') format('woff');
16 | font-weight: normal;
17 | font-style: italic;
18 | }
19 |
20 | @font-face {
21 | font-family: 'SourceSans3';
22 | src: url('../fonts/SourceSans3-Semibold.otf.woff') format('woff');
23 | font-weight: bold;
24 | font-style: normal;
25 | }
26 |
27 | @font-face {
28 | font-family: 'SourceSans3';
29 | src: url('../fonts/SourceSans3-SemiboldIt.otf.woff') format('woff');
30 | font-weight: bold;
31 | font-style: italic;
32 | }
33 |
34 | :root {
35 | /* Browser default font-size is 16px, this way 1 rem = 10px */
36 | font-size: 62.5%;
37 | color-scheme: var(--color-scheme);
38 | /* TODO: Why is important needed here? */
39 | --mono-font: "Fira Code" !important;
40 | --mono-font-size: 1.4rem;
41 | }
42 |
43 | .sidebar {
44 | font-size: 1.6rem !important;
45 | }
46 | math {
47 | font-size: 1.9rem;
48 | }
49 |
50 | html {
51 | font-family: 'SourceSans3', sans-serif;
52 | color: var(--fg);
53 | background-color: var(--bg);
54 | text-size-adjust: none;
55 | -webkit-text-size-adjust: none;
56 | }
57 |
58 | body {
59 | margin: 0;
60 | font-size: 1.8rem;
61 | font-weight: 400;
62 | overflow-x: hidden;
63 | }
64 |
65 | code {
66 | font-family: var(--mono-font) !important;
67 | font-weight: 500;
68 | font-size: var(--mono-font-size);
69 | direction: ltr !important;
70 | font-variant-ligatures: none;
71 | }
72 |
73 | /* make long words/inline code not x overflow */
74 | main {
75 | overflow-wrap: break-word;
76 | }
77 |
78 | /* make wide tables scroll if they overflow */
79 | .table-wrapper {
80 | overflow-x: auto;
81 | }
82 |
83 | /* Don't change font size in headers. */
84 | h1 code, h2 code, h3 code, h4 code, h5 code, h6 code {
85 | font-size: unset;
86 | }
87 |
88 | .left { float: left; }
89 | .right { float: right; }
90 | .boring { opacity: 0.6; }
91 | .hide-boring .boring { display: none; }
92 | .hidden { display: none !important; }
93 |
94 | h2, h3 { margin-block-start: 2.5em; }
95 | h4, h5 { margin-block-start: 2em; }
96 |
97 | .header + .header h3,
98 | .header + .header h4,
99 | .header + .header h5 {
100 | margin-block-start: 1em;
101 | }
102 |
103 | h1:target::before,
104 | h2:target::before,
105 | h3:target::before,
106 | h4:target::before,
107 | h5:target::before,
108 | h6:target::before {
109 | display: inline-block;
110 | content: "»";
111 | margin-inline-start: -30px;
112 | width: 30px;
113 | }
114 |
115 | /* This is broken on Safari as of version 14, but is fixed
116 | in Safari Technology Preview 117 which I think will be Safari 14.2.
117 | https://bugs.webkit.org/show_bug.cgi?id=218076
118 | */
119 | :target {
120 | /* Safari does not support logical properties */
121 | scroll-margin-top: calc(var(--menu-bar-height) + 0.5em);
122 | }
123 |
124 | .page {
125 | outline: 0;
126 | padding: 0 var(--page-padding);
127 | margin-block-start: calc(0px - var(--menu-bar-height)); /* Compensate for the #menu-bar-hover-placeholder */
128 | }
129 | .page-wrapper {
130 | box-sizing: border-box;
131 | background-color: var(--bg);
132 | }
133 | .no-js .page-wrapper,
134 | .js:not(.sidebar-resizing) .page-wrapper {
135 | transition: margin-left 0.3s ease, transform 0.3s ease; /* Animation: slide away */
136 | }
137 | [dir=rtl] .js:not(.sidebar-resizing) .page-wrapper {
138 | transition: margin-right 0.3s ease, transform 0.3s ease; /* Animation: slide away */
139 | }
140 |
141 | .content {
142 | overflow-y: auto;
143 | padding: 0 5px 50px 5px;
144 | }
145 | .content main {
146 | margin-inline-start: auto;
147 | margin-inline-end: auto;
148 | max-width: var(--content-max-width);
149 | }
150 | .content p { line-height: 1.45em; }
151 | .content ol { line-height: 1.45em; }
152 | .content ul { line-height: 1.45em; }
153 | .content a { text-decoration: none; }
154 | .content a:hover { text-decoration: underline; }
155 | .content img, .content video { max-width: 100%; }
156 | .content .header:link,
157 | .content .header:visited {
158 | color: var(--fg);
159 | }
160 | .content .header:link,
161 | .content .header:visited:hover {
162 | text-decoration: none;
163 | }
164 |
165 | table {
166 | margin: 0 auto;
167 | border-collapse: collapse;
168 | }
169 | table td {
170 | padding: 3px 16px;
171 | border: 1px var(--table-border-color) solid;
172 | }
173 | table thead {
174 | background: var(--table-header-bg);
175 | }
176 | table thead td {
177 | font-weight: 700;
178 | border: none;
179 | }
180 | table thead th {
181 | padding: 3px 16px;
182 | }
183 | table thead tr {
184 | border: 1px var(--table-header-bg) solid;
185 | }
186 | /* Alternate background colors for rows */
187 | table tbody tr:nth-child(2n) {
188 | background: var(--table-alternate-bg);
189 | }
190 |
191 |
192 | blockquote {
193 | margin: 20px 0;
194 | padding: 0 20px;
195 | color: var(--fg);
196 | background-color: var(--quote-bg);
197 | border-block-start: .1em solid var(--quote-border);
198 | border-block-end: .1em solid var(--quote-border);
199 | }
200 |
201 | .warning {
202 | margin: 20px;
203 | padding: 0 20px;
204 | border-inline-start: 2px solid var(--warning-border);
205 | }
206 |
207 | .warning:before {
208 | position: absolute;
209 | width: 3rem;
210 | height: 3rem;
211 | margin-inline-start: calc(-1.5rem - 21px);
212 | /*content: "ⓘ";*/
213 | text-align: center;
214 | background-color: var(--bg);
215 | color: var(--warning-border);
216 | font-weight: bold;
217 | font-size: 2rem;
218 | }
219 |
220 | blockquote .warning:before {
221 | background-color: var(--quote-bg);
222 | }
223 |
224 | kbd {
225 | background-color: var(--table-border-color);
226 | border-radius: 4px;
227 | border: solid 1px var(--theme-popup-border);
228 | box-shadow: inset 0 -1px 0 var(--theme-hover);
229 | display: inline-block;
230 | font-size: var(--code-font-size);
231 | font-family: var(--mono-font);
232 | line-height: 10px;
233 | padding: 4px 5px;
234 | vertical-align: middle;
235 | }
236 |
237 | :not(.footnote-definition) + .footnote-definition,
238 | .footnote-definition + :not(.footnote-definition) {
239 | margin-block-start: 2em;
240 | }
241 | .footnote-definition {
242 | font-size: 0.9em;
243 | margin: 0.5em 0;
244 | }
245 | .footnote-definition p {
246 | display: inline;
247 | }
248 |
249 | .tooltiptext {
250 | position: absolute;
251 | visibility: hidden;
252 | color: #fff;
253 | background-color: #333;
254 | transform: translateX(-50%); /* Center by moving tooltip 50% of its width left */
255 | left: -8px; /* Half of the width of the icon */
256 | top: -35px;
257 | font-size: 0.8em;
258 | text-align: center;
259 | border-radius: 6px;
260 | padding: 5px 8px;
261 | margin: 5px;
262 | z-index: 1000;
263 | }
264 | .tooltipped .tooltiptext {
265 | visibility: visible;
266 | }
267 |
268 | .chapter li.part-title {
269 | color: var(--sidebar-fg);
270 | margin: 5px 0px;
271 | font-weight: bold;
272 | }
273 |
274 | .result-no-output {
275 | font-style: italic;
276 | }
277 |
278 | /* -------------------------------------------------------------- */
279 |
280 | /* Style sheet for TONC */
281 |
282 | dfn {
283 | font-style: italic;
284 | font-weight: bold;
285 | }
286 |
287 | div.note {
288 | border-color: var(--fg);
289 | background-color: var(--table-alternate-bg);
290 | }
291 | div.note p, div.note ul {
292 | margin: 6px 0;
293 | }
294 | div.note ul {
295 | padding-left: 20px;
296 | }
297 | div.note p + p {
298 | margin-top: 12px;
299 | }
300 |
301 | div.nh, div.nhgood, div.nhbad, div.nhcare {
302 | font-weight: bold;
303 | margin-top: 5px;
304 | padding-bottom: 2px;
305 | border-bottom: 1px solid var(--quote-border);
306 | }
307 |
308 | /* TODO: can we use colours from the syntax highlighting style instead? */
309 | /* (or just tweak them a bit per-theme) */
310 | div.nhbad, .rem, .ack {
311 | color: #ec1256;
312 | }
313 | div.nhgood {
314 | color: #1ec36d;
315 | }
316 | div.nhcare {
317 | color: #e88f42;
318 | }
319 | .hljs span.rem, .hljs span.rem * {
320 | color: #ec1256;
321 | }
322 | .wavy {
323 | text-decoration: underline wavy;
324 | }
325 |
326 | .bold {
327 | font-weight: bold;
328 | }
329 |
330 | /* --- picture+caption frames --- */
331 | div.cpt, div.cpt_fl, div.cpt_fr {
332 | margin: .5em; padding: 4px;
333 | border: 1px var(--table-border-color) solid;
334 | background-color: var(--table-alternate-bg);
335 | font-size: 80%;
336 | page-break-inside: avoid;
337 | }
338 |
339 | div.cpt_fl { float:left; }
340 | div.cpt_fr { float:right; }
341 |
342 | /* Margins inside tables work differently. */
343 | td div.cpt, td div.dpt_fl, td div.cpt_fr {
344 | margin: 0;
345 | }
346 |
347 | .cpt p, .cpt_fl p, .cpt_fr p {
348 | margin: 0.5em 0;
349 | }
350 |
351 | /* --- table block styles --- */
352 | /* yes, table and caption forms are required */
353 |
354 | div.reg { margin: 8px auto; text-align: center; width: 94%; }
355 | div.reg table { margin: 1px auto; margin-bottom: 12px; text-align: left; }
356 | div.reg caption { margin: 0px auto; text-align: left; }
357 |
358 | div.cblock { margin: 6px auto; text-align: center; }
359 | div.cblock div { margin: 2px auto; text-align: left; }
360 | div.cblock table { margin: 2px auto; text-align: left; }
361 | div.cblock caption { margin: 0px auto; text-align: left; }
362 |
363 | /* div.lblock { margin: 6px 3em; }
364 | div.lblock table { margin: 2px 0; } */
365 |
366 | div.cblock div.cpt { margin: 0.5em auto; }
367 |
368 | /* Fix oversight in the mdBook styles? */
369 | table, table th {
370 | border: 1px var(--table-border-color) solid;
371 | }
372 |
373 | /* Gotta make register diagram table cells smaller so they fit on the page. */
374 | .table-reg th,
375 | .table-reg td {
376 | padding: 3px 13px;
377 | }
378 | /* But some are too big even still. */
379 | table.reg-huge th,
380 | table.reg-huge td {
381 | padding: 3px 7px;
382 | }
383 |
384 | /* === Table styles === */
385 |
386 | td.fill, th.fill { width: 16px; }
387 |
388 | /* --- reg table --- */
389 | .table-reg {
390 | font: var(--mono-font-size) var(--mono-font);
391 | page-break-inside: avoid;
392 | }
393 | caption.reg {
394 | caption-side:top;
395 | padding-bottom: 4px;
396 | }
397 | caption.reg, caption.reg * {
398 | font-size: 1.2rem;
399 | }
400 | caption[align="bottom"], div.cblock caption[align="bottom"] {
401 | margin-top: 6px;
402 | }
403 |
404 | caption.reg, tr.bits {
405 | white-space: nowrap;
406 | }
407 |
408 | tr.bits, tr.bf, col.bits, col.bf, col.def { text-align: center; }
409 | col.bits, col.bf, col.def { vertical-align: top; }
410 | tr.bits, col.bits { font: var(--mono-font-size) var(--mono-font); }
411 | tr.bf, col.bf { font-weight: bold; }
412 | col.def { font: var(--mono-font-size) var(--mono-font); }
413 |
414 | /* read only, write only */
415 | .rof { text-decoration: overline; color: #f22; }
416 | .wof { text-decoration: underline; color: #44f; }
417 |
418 | /* reg colors */
419 | .rclr0 { color: #ef0d4b; }
420 | .rclr1 { color: #41adff; }
421 | .rclr2 { color: #45e774; }
422 | .rclr3 { color: #d948d9; }
423 | .rclr4 { color: #f9663e; }
424 | .rclr5 { color: #d09a4c; }
425 | .rclr6 { color: #e7849b; }
426 | .rclr7 { color: #dce24b; }
427 | .rclr8 { color:teal; }
428 | .rclr9 { color:gray; }
429 |
430 | font[color="blue"] { color: #43a8e6; }
431 | font[color="green"] { color: #45e774; }
432 | font[color="red"] { color: #ef0d4b; }
433 |
434 | /* Special case table overrides (in Text systems) */
435 | #fig\:img-fontpack, #tbl\:bupshade {
436 |
437 | & table {
438 | width: 100%;
439 | font-size: 90%;
440 | page-break-inside: avoid;
441 | }
442 |
443 | & span.rarr {
444 | font-size:200%;
445 | position: relative;
446 | top: 0.26em;
447 | }
448 |
449 | & td, th {
450 | padding: 1px 0;
451 | }
452 |
453 | & tr td, tr th {
454 | background-color: var(--table-alternate-bg);
455 | border: none;
456 | text-align: center;
457 | }
458 |
459 | & .table-reg th, .table-reg td {
460 | padding: 1px 3px;
461 | font-family: 'SourceSans3';
462 | }
463 |
464 | & .bdrT, .bdrTL, .bdrTR, .bdrLL, .bdrRR {
465 | border-top: 1px var(--fg) solid;
466 | }
467 |
468 | & .bdrL, .bdrTL, .bdrBL, .bdrLL {
469 | border-left: 1px var(--fg) solid;
470 | }
471 | & .bdrB, .bdrBL, .bdrBR, .bdrLL, .bdrRR {
472 | border-bottom: 1px var(--fg) solid;
473 | }
474 |
475 | & .bdrR, .bdrTR, .bdrBR, .bdrRR {
476 | border-right: 1px var(--fg) solid;
477 | }
478 | }
479 |
480 | #tbl\:bupshade {
481 | width: 300px;
482 | margin: 0px 10px;
483 | }
484 |
485 | /* --- */
486 |
487 | .menu-title {
488 | font-weight: 400;
489 | font-size: 2.75rem;
490 | letter-spacing: -0.02em;
491 | /* equals -2% */
492 | }
493 |
494 | .box {
495 | margin: 20px 0;
496 | padding: 1.6px 20px;
497 | border-left-width: 0.75rem;
498 | border-left-style: solid;
499 | }
500 |
501 | .box > .box-title {
502 | font-weight: 600;
503 | text-transform: uppercase;
504 | }
505 |
506 | .box.tip {
507 | border-color: #42b983;
508 | background-color: var(--quote-bg);
509 | }
510 |
511 | .box.warning {
512 | border-left-color: var(--c-warning);
513 | background-color: rgba(255, 229, 100, 0.2);
514 | color: var(--c-warning-text);
515 | }
516 |
517 | .box.warning > .box-title {
518 | color: var(--c-warning-title);
519 | }
520 |
521 | .box.danger {
522 | border-left-color: var(--c-danger);
523 | background-color: rgba(255, 0, 0, .15);
524 | color: var(--c-danger-text);
525 | }
526 |
527 | .box.danger > .box-title {
528 | color: var(--c-danger-title);
529 | }
530 |
531 | .spacer {
532 | width: 100%;
533 | height: 3px;
534 | margin: 25px 0px 25px 0px;
535 | }
536 |
537 | /* Global CSS variables */
538 |
539 | :root {
540 | /* (Override) workaround to get hover+active sidebar links on normal links blue */
541 | --sidebar-active: var(--links);
542 | /* Warning boxes base styling */
543 | --c-warning: #e7c000;
544 | --c-warning-bg: #fffae3;
545 | --c-warning-title: #ad9000;
546 | /* Danger boxes base styling */
547 | --c-danger: #cc0000;
548 | --c-danger-text: #660000;
549 | --c-danger-title: #990000;
550 | }
551 |
552 | /* Theme-wide CSS variables */
553 |
554 | .ayu {
555 | --c-warning-text: #eac100;
556 | --c-danger-text: #ff2929;
557 | --c-danger-title: #dc0000;
558 | }
559 |
560 | .coal {
561 | --c-warning-text: #eac100;
562 | --c-danger-text: #ff2929;
563 | --c-danger-title: #dc0000;
564 | }
565 |
566 | .light {
567 | --c-warning-text: #746000;
568 | }
569 |
570 | .navy {
571 | --c-warning-text: #eac100;
572 | --c-danger-text: #ff2929;
573 | --c-danger-title: #dc0000;
574 | }
575 |
576 | .rust {
577 | --c-warning-text: #ad8e00;
578 | }
579 |
580 |
--------------------------------------------------------------------------------
/theme/css/tonc.css:
--------------------------------------------------------------------------------
1 | /* Tonc Classic theme */
2 |
3 | .tonc {
4 | --bg: #c0f0f0;
5 | --fg: hsl(0, 0%, 0%);
6 |
7 | --sidebar-bg: #c0f0f0;
8 | --sidebar-fg: hsl(0, 0%, 0%);
9 | --sidebar-non-existant: #aaaaaa;
10 | --sidebar-active: #1f1fff;
11 | --sidebar-spacer: #a3e4e5;
12 |
13 | --scrollbar: #8F8F8F;
14 |
15 | --icons: #000060;
16 | --icons-hover: #000000;
17 |
18 | --links: blue;
19 |
20 | --inline-code-color: #301900;
21 |
22 | --theme-popup-bg: #c0f0f0;
23 | --theme-popup-border: #80d6d7;
24 | --theme-hover: #a3e4e5;
25 |
26 | --quote-bg: hsl(197, 37%, 96%);
27 | --quote-border: hsl(197, 37%, 91%);
28 |
29 |
30 | --table-border-color: #808080;
31 | --table-background-color: #e0e0e0;
32 | --table-background-color-custom: #d0d0d0;
33 | --table-header-bg: unset;
34 | --table-alternate-bg: #B0B0B0;
35 |
36 | --searchbar-border-color: #aaa;
37 | --searchbar-bg: #fafafa;
38 | --searchbar-fg: #000;
39 | --searchbar-shadow-color: #aaa;
40 | --searchresults-header-fg: #000060;
41 | --searchresults-border-color: #888;
42 | --searchresults-li-bg: #e4f2fe;
43 | --search-mark-bg: #a2cff5;
44 |
45 | --color-scheme: light;
46 |
47 | /* Extra */
48 | --font: Verdana, Geneva, Tahoma, sans-serif;
49 | --font-size: 13px;
50 | --warning-border: #ffe00;
51 | --h2-color: green;
52 | --h3-color: #000060;
53 | }
54 |
55 | .tonc {
56 | background-color: #c0f0f0;
57 | font-family: var(--font);
58 | letter-spacing: 0px;
59 | }
60 |
61 | .tonc .content {
62 | background-image: url(../../img/main/tonc_bg.png);
63 | }
64 |
65 | .tonc .content p,
66 | .tonc .content ul {
67 | line-height: normal;
68 | }
69 |
70 | .tonc #menu-bar.bordered {
71 | border-block-end-color: gray;
72 | border-width: 2px;
73 | border-bottom: groove;
74 | }
75 |
76 | .tonc .box,
77 | .tonc .note {
78 | width: 92%;
79 | margin: 0.7em auto;
80 | padding: 8px;
81 | background-color: #E0E0E0;
82 | border: 2px solid #FF0000;
83 | page-break-inside: avoid;
84 | border-radius: 8px;
85 | box-shadow: 2px 2px 4px #808080;
86 | }
87 |
88 | .tonc blockquote {
89 | display: block;
90 | margin-block-start: 1em;
91 | margin-block-end: 1em;
92 | margin-inline-start: 40px;
93 | margin-inline-end: 40px;
94 | background-color: unset;
95 | border: none;
96 | }
97 |
98 | .tonc body .page .content {
99 | font-size: var(--font-size);
100 | }
101 |
102 | /* Link text */
103 | .tonc .sidebar a:visited {
104 | color: #551a8b;
105 | }
106 |
107 | .tonc .sidebar a, .tonc ul a {
108 | color: blue;
109 | text-decoration: underline;
110 | line-height: normal;
111 | }
112 |
113 | .tonc .sidebar a:active {
114 | color: red;
115 | }
116 |
117 | .tonc .sidebar {
118 | font-size: var(--font-size) !important;
119 | }
120 |
121 | .tonc .content a:active {
122 | color: red;
123 | }
124 |
125 | .tonc .box > .box-title {
126 | margin-top: 0;
127 | font-size: 115%;
128 | font-weight: bold;
129 | margin: 0.1em 0.5em 0.2em;
130 | text-transform: none;
131 | }
132 |
133 | .tonc .box > p {
134 | margin-block-start: 0px;
135 | margin-block-end: 0px;
136 | color: var(--fg);
137 | }
138 |
139 | .tonc .box.note > .box-title {
140 | color: var(--fg);
141 | }
142 |
143 | .tonc .chapter li.part-title,
144 | .tonc .box.tip > .box-title {
145 | color: green;
146 | }
147 |
148 | .tonc .box.warning > .box-title {
149 | color: #c06000;
150 | }
151 |
152 | .tonc .box.danger > .box-title {
153 | color: #ff0000;
154 | }
155 |
156 | /* Headers */
157 | .tonc h2::before {
158 | color: var(--h2-color);
159 | }
160 |
161 | .tonc h3::before {
162 | color: var(--h3-color);
163 | }
164 |
165 | .tonc h2, h3 {
166 | margin-block-start: 1em;
167 | margin-block-end: 0em;
168 | }
169 |
170 | .tonc .content h1 .header {
171 | color: blue;
172 | }
173 |
174 | .tonc .content h2 .header {
175 | margin: 1em 1em 0.2em;
176 | font-size: 90%;
177 | color: var(--h2-color);
178 | }
179 |
180 | .tonc .content h3 .header {
181 | margin: 1em 1em 0.2em;
182 | font-size: 90%;
183 | color: #000060;
184 | }
185 |
186 | /* Code block style */
187 | .tonc pre code {
188 | border: #C0C0C0 solid 1px;
189 | width: 92%;
190 | margin: 0.6em auto;
191 | padding: 8px;
192 | background: #E0E0E0 !important;
193 | border-radius: 4px;
194 | box-shadow: 2px 2px 4px #C0C0C0;
195 | font: 500 100% "Courier New", monospace !important;
196 | }
197 |
198 | /* Clipboard icon on code */
199 | .tonc pre > .buttons :hover {
200 | color: var(--searchresults-header-fg);
201 | border-color: var(--searchresults-header-fg);
202 | background-color: #c0c0c0;
203 | }
204 |
205 | .tonc pre > .buttons button {
206 | border-color: var(--scrollbar);
207 | background-color: #e0e0e0;
208 | transition: 100ms;
209 | transition-property: color,border-color,background-color;
210 | color: var(--scrollbar);
211 | }
212 |
213 | /* Syntax highlighting on code */
214 | .tonc .hljs {
215 | color: #202040;
216 | font-family: monospace;
217 | background: none;
218 | }
219 |
220 | .tonc .hljs span.rem,
221 | .tonc .hljs span.rem * {
222 | color: red;
223 | }
224 |
225 | .tonc .hljs-comment,
226 | .tonc .hljs-quote {
227 | color: green;
228 | }
229 |
230 | .tonc .hljs-keyword,
231 | .tonc .hljs-meta,
232 | .tonc .hljs-meta-keyword {
233 | color: #0000D0;
234 | }
235 |
236 | .tonc .hljs-number {
237 | color: #C000C0;
238 | }
239 |
240 | .tonc .hljs-title,
241 | .tonc .hljs-params {
242 | color: #000000;
243 | }
244 |
245 | .tonc pre .buttons {
246 | margin-right: 21px;
247 | }
248 |
249 | /* Register colors */
250 | .tonc .rclr0 { color:red; }
251 | .tonc .rclr1 { color:blue; }
252 | .tonc .rclr2 { color:#006000; }
253 | .tonc .rclr3 { color:magenta; }
254 | .tonc .rclr4 { color:brown; }
255 | .tonc .rclr5 { color:olive; }
256 | .tonc .rclr6 { color:purple; }
257 | .tonc .rclr7 { color:#C06000; }
258 | .tonc .rclr8 { color:teal; }
259 | .tonc .rclr9 { color:gray; }
260 |
261 | /* Override default table style */
262 | .tonc table,
263 | .tonc table th,
264 | .tonc table td {
265 | border: none;
266 | margin-left: 0px;
267 | font-size: var(--font-size);
268 | }
269 |
270 | .tonc td {
271 | padding: 2px;
272 | }
273 |
274 | .tonc table {
275 | border-collapse: separate;
276 | text-indent: initial;
277 | line-height: normal;
278 | font-weight: normal;
279 | font-size: unset;
280 | font-style: normal;
281 | text-align: start;
282 | border-spacing: 0px;
283 | white-space: normal;
284 | font-variant: normal;
285 | }
286 |
287 | /* Disable default alternate background colors for rows */
288 | .tonc table tbody tr:nth-child(2n) {
289 | background: none;
290 | }
291 |
292 | /* Figures, captions, blocks */
293 | .tonc .cpt,
294 | .tonc .cpt_fl,
295 | .tonc .cpt_fr {
296 | padding: 0.4em;
297 | border: 1px var(--fg) solid;
298 | background-color: unset;
299 | }
300 |
301 | .tonc .cpt .table-data,
302 | .tonc .cpt_fl .table-data,
303 | .tonc .cpt_fr .table-data {
304 | font-size: var(--font-size);
305 | }
306 |
307 | .tonc caption {
308 | font-size: 80%;
309 | text-align:left;
310 | margin-left: 1em; }
311 |
312 | .tonc div.lblock { margin: 6px 3em; }
313 | .tonc div.lblock table { margin: 2px 0; }
314 |
315 | /* Special case table overrides (in Text systems) */
316 | .tonc #fig\:img-fontpack {
317 |
318 | & table {
319 | font-family: var(--font);
320 | }
321 | & tr td, tr th {
322 | background-color: unset;
323 | }
324 |
325 | & .table-reg th, .table-reg td {
326 | padding: 1px 3px;
327 | font-family: var(--font);
328 | }
329 | }
330 |
331 | .tonc #tbl\:bupshade {
332 | width: unset;
333 | font-family: var(--font);
334 | font-size: 120%;
335 | margin: 0px 10px;
336 |
337 | & tr td, tr th {
338 | background-color: var(--table-background-color);
339 | padding: 2px 4px;
340 | }
341 | }
342 |
343 | .tonc #fig\:img-m7-ex {
344 | border: 1px var(--fg) solid;
345 | }
346 |
347 | .tonc #tbl\:culltest mtable,
348 | .tonc #tbl\:culltest mtr,
349 | .tonc #tbl\:culltest mtd {
350 | padding: 0px 0px;
351 | }
352 |
353 | /* Equations */
354 | .tonc .eqnrcell {
355 | font-weight: bold;
356 | }
357 |
358 | .tonc .eqcell {
359 | padding-left: 1em;
360 | }
361 |
362 |
363 | /* Normal data tables */
364 | .tonc table.table-data {
365 | border: 1px outset var(--table-border-color);
366 | }
367 |
368 | .tonc table.table-data th,
369 | .tonc table.table-data tr,
370 | .tonc table.table-data td {
371 | border: 1px inset var(--table-border-color);
372 | }
373 |
374 | /* Regular register tables */
375 | .tonc .table-reg tbody {
376 | background-color: #e0e0e0;
377 | }
378 |
379 | .tonc .table-reg {
380 | font: 90% "Courier New", monospace;
381 | background: #E0E0E0;
382 | border: solid #C0C0C0 1px;
383 | page-break-inside: avoid;
384 | }
385 |
386 | .tonc .table-reg th,
387 | .tonc .table-reg td {
388 | border: 1px inset #c0c0c0;
389 | padding: 4px 4px;
390 | }
391 |
392 | /* Tall register tables */
393 | .tonc table.table-reg-vert {
394 | border-collapse: separate;
395 | text-indent: initial;
396 | line-height: normal;
397 | font-weight: normal;
398 | font-size: medium;
399 | font-style: normal;
400 | text-align: start;
401 | border-spacing: 2px;
402 | border: none;
403 | white-space: normal;
404 | font-variant: normal;
405 | }
406 |
407 | .tonc table.table-reg-vert th {
408 | border: none;
409 | background-color: none;
410 | }
411 |
412 | .tonc table.table-reg-vert tr:nth-child(1n) td{
413 | border: none;
414 | background-color: #e0e0e0;
415 | border-bottom: #c0c0c0 1px solid;
416 | }
417 |
418 | .tonc table.table-reg-vert tr:nth-child(2n) td{
419 | border: none;
420 | background-color: #c0c0c0;
421 | border-bottom: #e0e0e0 1px solid;
422 | }
423 |
424 | /* Special case table (in Regular tiled backgrounds) */
425 | .tonc #tbl\:cbb-sbb th,
426 | .tonc #tbl\:cbb-sbb td {
427 | padding: 3px 3px;
428 | }
429 |
430 | .tonc table[rules=groups i] {
431 | border-collapse: collapse;
432 | }
433 |
434 | /* Rules cols equivalent, only column borders not rows */
435 | .tonc table.rules-cols td,
436 | .tonc table.rules-cols th {
437 | border-top: none;
438 | border-left: none;
439 | border-bottom:none;
440 | }
441 |
442 | .tonc table.rules-cols tr th:last-child,
443 | .tonc table.rules-cols tr td:last-child {
444 | border-right: none;
445 | }
446 |
447 | /* Frame void and rules groups equivalent */
448 | .tonc table.rules-groups th {
449 | border-top: none;
450 | border-left: none;
451 | border-right: 1px solid var(--fg);
452 | }
453 |
454 | .tonc table.rules-groups td {
455 | border-top: none;
456 | border-left: none;
457 | border-bottom:none;
458 | border-right: 1px solid var(--fg);
459 | }
460 |
461 | .tonc table.rules-groups {
462 | border: none;
463 | }
464 |
465 | .tonc table.rules-groups tr th:last-child,
466 | .tonc table.rules-groups tr td:last-child {
467 | border-right: none;
468 | }
469 |
470 | .tonc table.rules-groups tbody tr th {
471 | border-bottom: none;
472 | }
473 |
474 | /* Misc */
475 | .tonc table.border-none {
476 | border: none;
477 | }
478 |
479 | .tonc table.border-none th,
480 | .tonc table.border-none td {
481 | border: none;
482 | }
483 |
484 | .tonc tr.bits, tr.bf, col.bits, col.bf, col.def { text-align:center; }
485 |
486 | .tonc col.bits, col.bf, col.def { vertical-align:top; }
487 | .tonc tr.bits, col.bits { font: 90% "Courier New"; }
488 | .tonc tr.bf, col.bf { font-weight:bold; }
489 | .tonc col.def { font: 90% "Courier New"; }
490 |
491 | .tonc .center {
492 | margin: auto;
493 | }
494 |
495 | .tonc tt {
496 | color: #400080;
497 | }
498 |
499 | .tonc kbd {
500 | color: #202040;
501 | font-family: monospace;
502 | background: none;
503 | border: none;
504 | box-shadow: none;
505 | }
506 |
507 | .tonc .bdr {
508 | border: 1px var(--fg) solid;
509 | }
510 |
511 | .tonc .bdrB, .bdrBL, .bdrBR, .bdrLL, .bdrRR {
512 | border-bottom: 1px black solid;
513 | }
--------------------------------------------------------------------------------
/theme/head.hbs:
--------------------------------------------------------------------------------
1 |
2 |
15 |
16 |
--------------------------------------------------------------------------------
/theme/templates/archives.html:
--------------------------------------------------------------------------------
1 | {% extends "base.html" %}
2 |
3 | {% block title %}{{ SITENAME }} - Archives{% endblock %}
4 |
5 | {% block content %}
6 | | 23 | {% if prev_num != None %} 24 | {{ prev_name }} 25 | {% endif %} 26 | | 27 |Contents | 28 |29 | {% if next_num != None %} 30 | {{ next_name }} 31 | {% endif %} 32 | | 33 |
| 55 | {% if prev_num != None %} 56 | Prev 57 | {% endif %} 58 | | 59 |Contents | 60 |61 | {% if next_num != None %} 62 | Next 63 | {% endif %} 64 | | 65 |
| 68 | {% if prev_num != None %} 69 | {{ prev_name }} 70 | {% endif %} 71 | | 72 |73 | | 74 | {% if next_num != None %} 75 | {{ next_name }} 76 | {% endif %} 77 | | 78 |
5 | {% if articles_page.has_previous() %} 6 | ⇇ 7 | « 8 | {% endif %} 9 | Page {{ articles_page.number }} / {{ articles_paginator.num_pages }} 10 | {% if articles_page.has_next() %} 11 | » 12 | ⇉ 13 | {% endif %} 14 |
15 | {% endif %} 16 | -------------------------------------------------------------------------------- /theme/templates/period_archives.html: -------------------------------------------------------------------------------- 1 | {% extends "base.html" %} 2 | 3 | {% block title %}{{ SITENAME }} - {{ period | reverse | join(' ') }} archives{% endblock %} 4 | 5 | {% block content %} 6 |