Stijlgids: zo schrijf je een pagina

Elke pagina is een markdownbestand in src/content/paginas/. Je schrijft gewone tekst. Voor wat reliëf zijn er zes blokken. Hieronder staat elk blok één keer: eerst wat je schrijft, dan wat de lezer ziet.

Bovenaan elk bestand staat de frontmatter:

---
slug: /cto-coaching
title: "CTO coaching: individuele begeleiding"
description: "Meta description, ongeveer 155 tekens."
h1: "CTO coaching voor wie er *alleen* voor staat"
---

title is de titel voor Google, zonder ” — SoftwareCaptains” (dat komt er vanzelf achter). h1 is optioneel: zonder h1 wordt title de grote titel. Een woord tussen sterretjes krijgt de accentkleur. Met marge: false valt de marge rechts weg, bijvoorbeeld voor het privacybeleid.

Gewone tekst

Alinea’s, vet, cursief, links en lijsten werken zoals altijd in markdown. Gebruik een lijst enkel waar de lezer echt wil scannen.

  • Een punt
  • Nog een punt

Een kleinere kop

Met ## maak je een sectiekop, met ### een kleinere.

Een gewoon citaat, zonder bron, blijft bescheiden. Handig voor een opmerking terzijde.

Citaat

Een citaat met een bron wordt groot, met de accolade uit het logo. Zet de bron op de laatste regel, na een gedachtestreep (—) of twee streepjes (--).

> CTO zijn is een eenzame job.
>
> — Andy Kellens, Corporify

CTO zijn is een eenzame job.

Andy Kellens, Corporify

Testimonial

:::testimonial{naam="Björn Vergaelen" functie="CTO, AXI" foto="/fotos/bjorn-vergaelen.jpg"}
Tom is uitstekend in wat hij doet. Hij kan heel goed een situatie overzien.
:::
Björn Vergaelen

Tom is uitstekend in wat hij doet. Hij kan heel goed een situatie overzien.

Björn Vergaelen, CTO, AXI

Foto’s staan in public/fotos/. Zonder foto krijg je dezelfde kaart zonder foto.

Stappen

:::stappen
1. Verkennend gesprek
2. Om de twee weken een gesprek
3. Na drie maanden: verder zonder mij
:::
  1. Verkennend gesprek
  2. Om de twee weken een gesprek
  3. Na drie maanden: verder zonder mij

Beeld naast tekst

:::naast{beeld="/fotos/tom-klaasen.webp" alt="Tom Klaasen" kant="links"}
Elf jaar leidde ik een softwarebedrijf naast een technische co-founder.
:::

kant is links of rechts (standaard). Op een smal scherm komt het beeld boven de tekst. Een schema of grafiek werkt net zo goed als een foto.

Praktisch

:::praktisch
Op locatie of online. Vaste prijs, die ik noem in het eerste gesprek.
:::

Op een breed scherm staat dit kader in de marge rechts, onder de knop. Op een smal scherm staat het in de tekst, waar je het schreef. Een andere titel: :::praktisch{titel="Prijs"}.

Knop

::knop[Plan een verkennend gesprek]{href="https://calendar.app.google/gQFagXF46GZGFHyx6"}

Plan een verkennend gesprek

Let op: twee dubbelpunten, niet drie. De knop “Plan een gesprek” in de marge staat er altijd al; zet er in de tekst enkel een waar de lezer er klaar voor is.

Kaarten

Elke ### begint een kaart. Een link als laatste alinea zakt naar de onderkant van de kaart.

:::kaarten
### Doorlichting: vier weken

Voor wanneer je weet dat er iets scheef zit, maar niet wat.

[Meer over de doorlichting →](/doorlichting)

### Teambegeleiding: één dag per week

Voor wanneer je weet wat er moet veranderen.

[Meer over teambegeleiding →](/teambegeleiding)
:::

Doorlichting: vier weken

Voor wanneer je weet dat er iets scheef zit, maar niet wat.

Meer over de doorlichting →

Teambegeleiding: één dag per week

Voor wanneer je weet wat er moet veranderen.

Meer over teambegeleiding →

Uitnodiging

Een donker kader dat uitnodigt tot een gesprek, meestal onderaan een pagina.

:::uitnodiging{titel="Een gesprek van een uur"}
Geen presentatie, geen voorstel.

::knop[Plan een gesprek]{href="https://calendar.app.google/gQFagXF46GZGFHyx6"}
:::

Een gesprek van een uur

Geen presentatie, geen voorstel.

Plan een gesprek

Secties met de kop ernaast

Met secties: true in de frontmatter staat elke ## op een breed scherm links naast zijn tekst, met een lijn tussen de secties. Een :::uitnodiging sluit de sectie af en staat over de hele breedte. Zo ziet de homepage eruit (src/content/paginas/index.md).

Formulier

Een formulier van ActiveCampaign midden in de tekst, op de plek waar je deze regel zet:

::formulier{naam="cto-growth-map"}

Bekende formulieren: cto-growth-map (download van de CTO Growth Map). Een voorbeeld staat op /cto-growth-map.

Tikfout?

Een onbekend blok, zoals :::testimonal, laat de build stoppen met een foutmelding die het bestand noemt. Zo komt er nooit een kapotte pagina online.

Plan een gesprek