- 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]>
150 lines
4.0 KiB
Markdown
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] ...
|
|
```
|