50ohm-contents-dl/README-FORMAT.md

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:

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