# DARCdown

Här beskrivs kommandona i DARCdown. Grundregeln är som i Markdown: skriv bara texten som den är. Men det finns några specialkommandon som beskrivs nedan.

## Frågor, ritningar och foton

Frågor, bilder och foton läggs in med [ ]-kommandon, där kolon används som skiljetecken. Först kommer kommandot, sedan ID:t, och för bilder följer dessutom en intern identifierare (för referenser) och sedan bildtexten. Låt de interna identifierarna börja med avsnittets kortnamn.

> [!NOTE]
> Den svenska versionen har ingen frågebank. Kommandot `[question:...]` används därför inte i de svenska avsnitten.

Provfråga (används inte i den svenska versionen):
```
[question:AB123]
```

Ritning:
```
[picture:484:n_funkhorizont:Utbredning]
```

Foto:
```
[photo:123:n_wasserfalldiagramm_trx_collage:Vyer av olika transceivrar]
```

## Referenser

Man kan hänvisa till bilder och tabeller i texten med kommandot `ref`. Ange den interna identifieraren:

```
[ref:n_funkhorizont]
```

## Tabeller

Tabeller ”ritas” med lodräta streck. Den första raden är rubrikraden, där kolumnens justering anges (l: vänsterjusterad, c: centrerad, r: högerjusterad, X: flerradig vänsterjusterad). I slutet måste ett tabellkommando följa. Efter `table`-kommandot kommer, liksom för bilder, en intern identifierare (för referenser) och tabellbeskrivningen.

```
| l: Förnamn | l: Anropssignal |
| Max | SM5ABC |
| Luisa | SA4XYZ |
| Noa | SM7DEF |
[table:n_anropssignal_exempel:Exempel på anropssignaler]
```

## Särskilda avsnitt

* Marginalanteckning: `<margin>...</margin>`
* Obs: `<attention>...</attention>`
* Fördjupning: `<indepth>...</indepth>`
* Tips: `<tip>...</tip>`
* Marginalanteckning på webben, men löpande text i LaTeX: `<webmargin>...</webmargin>`
* Tips som marginalanteckning på webben, men löpande text i LaTeX: `<webtip>...</webtip>`
* Fördjupning som marginalanteckning på webben, i LaTeX över hela sidbredden: `<webindepth>...</webindepth>`
* Endast på webben, inte i LaTeX: `<webonly>...</webonly>`
* Endast i LaTeX, inte på webben: `<latexonly>...</latexonly>`

> [!WARNING]
> Taggarna fungerar bara om den inledande och avslutande taggen står var för sig på en egen rad:
>
> ```
> <attention>
> Var försiktig!
> </attention>
> ```

## Punktlistor

En punktlista inleds med *. Efter sista punkten _måste_ en tom rad följa.

```
* Äpplen och apelsiner
* Bananer och päron
* Klementiner och citroner
```

En numrerad lista görs genom att sätta siffror först. Efter sista punkten _måste_ en tom rad följa.

```
1. Slå på nätaggregatet
2. Slå på transceivern
3. Tryck på PTT
```

## Betoning

Enskilda ord och fraser kan betonas med asterisk:

```
Betona några *viktiga ord*.
```

## Formler och enheter

För formler används LaTeX-matematikläge som vanligt:

```
$R = \frac{U}{I}$
```

För enheter används paketet [siunitx](https://ctan.org/pkg/siunitx):

```
Slutsteget har en effekt på $\qty{750}{\watt}$.

Enheten för frekvens är $\unit{\hertz}$

Trådens längd måste ligga mellan $\qtyrange{1}{10}{\meter}$.
```

## Morsekod

Morsetecken kan skrivas med morse-kommandot.

```
[morse:CQ CQ]
```

## QSO

QSO kan också återges. `qso_own` är den egna stationens anrop och `qso_other` motstationens:

```
[qso_own:CQ CQ DE SM5ABC K]
[qso_other:SM5ABC SA4XYZ U R 59 K]
```

## Kommentarer

Kommentarer görs med %-tecken, men bara i början av raden! TODO används som markering för öppna uppgifter.

```
% TODO Stycket måste formuleras om
```

## Länkar

Hyperlänkar skrivs som vanliga Markdown-länkar med den fullständiga webbadressen. Länkarna via URL-förkortaren 50ohm.de gäller bara det tyska originalet och ska inte användas i den svenska versionen.

## Index

Indexposter för sökningen och för stickordsregistret (”index”) i boken skapas med `[index:Begrepp]` respektive `[index:Huvudbegrepp:Underbegrepp]`. Ett eventuellt mellanslag före kommandot tas bort vid konvertering.

Exempel:

```
Vid trafik används ofta yagiantenner [index:Antenn:Yagiantenn] ...
```