Files
SuperminarenandClaude Sonnet 5.5 f7fa8cfbc1 Swedish adaptation: Instegscertifikat and HAREC content
- Sections and slides rewritten in Swedish; German law and institutions replaced by
  Swedish/CEPT/ITU equivalents (PTS, SSA, PTSFS 2025:1, SSMFS 2008:18), unverified
  statements marked "% TODO VERIFY"
- New toc: INSTEG, HAREC, UPPGRADERING; section idents are Swedish (see ident-map.tsv)
- Exam-question tags, BNetzA question pool, solutions and the German SWL course removed
- Static pages, snippets, applets, READMEs and image alt-texts translated
- TikZ labels translated; SVG drawings regenerated (drawing 689 still fails to build
  upstream: it references a missing photo)
- Changed from the original: not endorsed by DARC e.V., SSA or PTS

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
2026-10-10 15:03:03 +02:00

150 lines
4.0 KiB
Markdown

# 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] ...
```