A Specimen Sheet
Every element an article on this site can use, set in one place, the way a type foundry shows off a typeface.
Type foundries used to print specimen sheets: one page showing a typeface doing everything it could do. This is the same idea for this site. It is a starter article, and a reference to copy from when writing a real one.
Paragraphs and emphasis
Body text is set in a serif at a comfortable measure. You can use italics for emphasis, bold for the rare thing that must not be missed, inline code for anything typed literally, and strikethrough for corrections you want to leave visible.
Links come in two kinds. One points somewhere else on this site. The other points out to the wider internet, is marked with an arrow, and never sends a referrer.
Lists
Unordered, for things with no sequence:
- Reconnaissance
- Initial access
- Phishing
- Exposed services
- Persistence
Ordered, for things that have one:
- Form a hypothesis.
- Design the smallest test that could prove it wrong.
- Run it, and write down what happened rather than what you expected.
Quotations
A blockquote is for someone else’s words. Set them apart, name the source, and keep them short enough that the reader remembers whose article this is.
Code
Fenced code blocks open in a small console window. Name the language after the opening fence to get syntax colors.
import hashlib
def fingerprint(path: str) -> str:
"""Return the SHA-256 digest of a file, read in chunks."""
digest = hashlib.sha256()
with open(path, "rb") as handle:
for block in iter(lambda: handle.read(65536), b""):
digest.update(block)
return digest.hexdigest()# verify a download against its published checksum
sha256sum --check release.sha256Tables
| Control | Cost | Stops |
|---|---|---|
| Hardware security key | Low | Most phishing |
| Patching on a schedule | Medium | Known exploits |
| Network segmentation | High | Lateral movement |
Footnotes and rules
A claim that needs a source gets a footnote.1 A change of subject gets a rule.
Smaller headings
Third-level headings divide a section without starting a new one.
Labels
Fourth-level headings are small labels, best used sparingly.
Footnotes collect at the end of the article, with a link back to where you were reading. ↩︎