search.json file with every page.
The client downloads the index once and then queries
lunr
locally.
// build the index from the rendered pages
const index = lunr(function () {
this.ref("uri");
this.field("title");
this.field("content");
for (const doc of request.response) {
this.add(doc);
lookup[doc.uri] = doc;
}
return 200;
});Note: the index is rebuilt on every build. With a few hundred posts the file stays under 200 KB.1
Results are rendered from a <template> cloned per match, with the same summary
truncation Hugo itself uses.
Measured on this site’s own search.json at ~70 posts; size grows
roughly linearly with the number of indexed fields, not just post count. ↩︎
An unvisited link is blue; a visited link
is sage; on :hover it
turns green. Every text pairing clears WCAG AA, and body text and code reach
AAA.1
Primary on Background measures ~10.2:1, well past the 7:1 AAA threshold for normal text — see the style guide for the full contrast table. ↩︎
$$ \phi = \frac{(1+\sqrt{5})}{2} = 1.6180339887\cdots $$
Additional details can be found on GitHub or on the Wiki .
If the text between $$ contains newlines it will rendered in display mode:
$$
f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
$$$$ f(x) = \int_{-\infty}^\infty\hat f(\xi),e^{2 \pi i \xi x},d\xi $$
$$
\frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} = 1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}} {1+\frac{e^{-8\pi}} {1+\cdots} } } }
$$$$ \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} = 1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}} {1+\frac{e^{-8\pi}} {1+\cdots} } } } $$
$$
1 + \frac{q^2}{(1-q)}+\frac{q^6}{(1-q)(1-q^2)}+\cdots = \prod_{j=0}^{\infty}\frac{1}{(1-q^{5j+2})(1-q^{5j+3})}, \quad\quad \text{for }\lvert q\rvert<1.
$$$$ 1 + \frac{q^2}{(1-q)}+\frac{q^6}{(1-q)(1-q^2)}+\cdots = \prod_{j=0}^{\infty}\frac{1}{(1-q^{5j+2})(1-q^{5j+3})}, \quad\quad \text{for }\lvert q\rvert<1. $$
]]>The following is a code sample using triple backticks ( ``` ) code fencing provided in Hugo. This is client side highlighting and does not require any special installation.
var num1, num2, sum
num1 = prompt("Enter first number")
num2 = prompt("Enter second number")
sum = parseInt(num1) + parseInt(num2) // "+" means "add"
alert("Sum = " + sum) // "+" means combine into a string
The following is a code sample using the “highlight” shortcode provided in Hugo. This is server side highlighting and requires Python and Pygments to be installed.
var num1, num2, sum
num1 = prompt("Enter first number")
num2 = prompt("Enter second number")
sum = parseInt(num1) + parseInt(num2) // "+" means "add"
alert("Sum = " + sum) // "+" means combine into a string
And here is the same code with line numbers:
1 var num1, num2, sum
2 num1 = prompt("Enter first number")
3 num2 = prompt("Enter second number")
4 sum = parseInt(num1) + parseInt(num2) // "+" means "add"
5 alert("Sum = " + sum) // "+" means combine into a string
Here is some bold text
Here’s a useless table:
| Number | Next number | Previous number |
|---|---|---|
| Five | Six | Four |
| Ten | Eleven | Nine |
| Seven | Eight | Six |
| Two | Three | One |
How about a yummy crepe?
Here’s a code chunk with syntax highlighting:
var foo = function(x) {
return(x + 5);
}
foo(3)Association football, more commonly known as football or soccer,[2] is a sport played between two teams of eleven players with a spherical ball. It is played by 250 million players in over 200 countries, making it the world’s most popular sport.[3][4][5][6] The game is played on a rectangular field with a goal at each end. The object of the game is to score by getting the ball into the opposing goal.
The goalkeepers are the only players allowed to touch the ball with their hands or arms while it is in play and then only in their penalty area. Outfield players mostly use their feet to strike or pass the ball, but may use their head or torso to strike the ball instead. The team that scores the most goals by the end of the match wins. If the score is level at the end of the game, either a draw is declared or the game goes into extra time and/or a penalty shootout depending on the format of the competition. The Laws of the Game were originally codified in England by The Football Association in 1863. Association football is governed internationally by the International Federation of Association Football (FIFA; French: Fédération Internationale de Football Association) which organises a World Cup every four years.[7]
]]>