50ohm/doc/Slides.md

Skapa presentationer

Presentationerna skrivs som markdown-filer i innehållsrepot (contents/slides/<ident>.md, en fil per avsnitt). Vi använder reveal.js som ramverk för att visa innehållet.

Format som stöds

Bildbyte

Varje bild (utom den första) börjar med ---. Det skapar en ny bild.

Särskilda bilder

Reveal.js låter dig ge bilder särskilda attribut, till exempel bakgrundsfärg. Det anges direkt när bilden skapas.

--- data-background="#FF0000"

Då blir bilden knallröd. Det bör bara användas i undantagsfall.

Dessutom tolkas tre nyckelord som även används i webbvyn.

--- unit

Används för att introducera en ny enhet. Färgar bilden ljusgrön.

--- attention

Används för att fånga uppmärksamheten, till exempel vid hänvisningar till föreskrifternas giltighet. Färgar bilden ljusblå.

--- danger

Används för att varna för faror, till exempel vid hantering av elektrisk ström. Färgar bilden ljusröd.

Rubriker

Rubriker inleds med tecknet #. Antalet tecken anger rubrikens nivå.

# Rubrik 1
## Rubrik 2
### Rubrik 3

Den högsta nivån är 6.

Listor

På bilder förekommer ofta listor. De inleds med *.

* Listpunkt
* Ännu en listpunkt

TODO: Nästlade listor stöds ännu inte.

Tabeller

Tabeller skrivs med tecknet | som kolumnavgränsare. Den första raden är en rubrikrad. Där kan du ange om kolumnens innehåll ska vara vänsterjusterat (l), högerjusterat (r) eller centrerat (c).

| l: Värde | l: Intervall | l: Betydelse | l: Engelska |
| R | 1 - 5 | Läsbarhet | Readability |
| S | 1 - 9 | Signalstyrka | Signal Strength |
| T | 1 - 9 | Tonkvalitet | Tone |
[table:n_rst:Delarna i en RST-rapport]

Tabellen måste avslutas med [table:referens:Beskrivning]. Det skapar en intern referens som kan länkas till.

Textformatering

Enkel textformatering som betonad eller understruken text kan användas.

Enkel textformatering som *betonad* eller <u>understruken</u> text kan användas.

Bilder

Bilder infogas med en referens till bilden i innehållsrepot.

[photo:123:n_rst_s-meter:Display på en IC-9700, S-metern som visar aktuell mottagningsnivå är markerad]

Antingen photo eller picture används, beroende på var bilden ligger (contents/photos eller contents/drawings). Därefter anges bildens nummer, sedan en referens för länkar och till sist beskrivningen som visas under bilden. Bilderna numreras per dokument.

Frågor ur frågebanken

Om innehållsrepot har en frågebank (se README) kan frågor infogas med en referens till frågenumret.

[question:2482]

Frågor bör visas på en egen bild eftersom de oftast är stora.

---
[question:2482]
---

Svarsalternativen blandas när presentationen byggs, så att inte första svaret alltid är rätt som i frågebanken.

QSO

Ett exempel-QSO kan läggas till så här:

<qso>
Är frekvensen ledig? SM5ABC
> *(inget svar)*
Är frekvensen ledig? SM5ABC
> *(inget svar)*
CQ CQ, här är SM5ABC med ett allmänt anrop, här är SM5ABC och lyssnar.
> SM5ABC, här är SM0XYZ, varsågod
</qso>

Varje rad är en pratbubbla. Bubblorna visas en efter en. Rader som börjar med > visas som motstationens bidrag.

Inblandningseffekt

Om en del av bilden ska visas först senare kan den läggas i <fragment>.

<fragment>
Den här texten visas först senare.
</fragment>

Flera <fragment>-avsnitt efter varandra gör att innehållet avslöjas steg för steg.

Anteckningar

Du kan lägga till anteckningar för föredragshållaren. De syns bara i talarvyn (tryck på ”s”).

Det är lämpligt med korta hänvisningar till förklaringarna i webbversionen eller bakgrundsinformation. Sådant behöver inte stå på bilderna. Korta anteckningar bör räcka för en radioamatör att förstå och förmedla innehållet.

<note>
Anteckningen visas bara i talarvyn
* Listor går också bra
* Håll dem helst korta
* Utrymmet är begränsat
</note>

Formler

Formler i LaTeX-stil kan anges. De skrivs inom $.

$\lambda[[\text{m}]] = \dfrac{300}{f[[\text{MHz}]]} = \dfrac{300}{145,3 \ \text{MHz}} \approx 2,06 \ \text{m}$

Till skillnad från LaTeX måste hakparenteser dubbleras. Använd decimalkomma. Enheter kan skrivas med \qty{145,3}{\mega\hertz}.

Länkar

Länkar kan infogas.

[Länk till SSA](https://www.ssa.se/)

Två kolumner

Ibland är två kolumner praktiskt, till exempel för en bild med beskrivning. Då används taggarna <left> och <right>.

<left>
[photo:167:rufzeichen_flugzeug:Flygplan med anropssignalen SE-ABC]
</left>
<right>
* Radiostationer använder anropssignaler för att identifiera sig
* En följd av bokstäver och siffror
* Varje flygplan och fartyg med radioutrustning har en anropssignal
</right>

Bädda in en webbsida interaktivt

En hel webbsida kan bäddas in interaktivt så att man kan använda den. Navigeringspilarna och talarvyn finns kvar.

--- data-background-iframe="https://f5len.org/tools/locator/" data-background-interactive

<note>
* En interaktiv karta med Maidenhead-lokator visas.
</note>

Det är bra att lägga till en anteckning så att bilden inte blir tom och för att påminna föredragshållaren om att webbsidan bara kan styras från huvudskärmen.

Mindre text

I mycket sällsynta undantag kan mindre text användas, till exempel när en eller två rader i en tabell inte längre får plats på bilden.

--- style="font-size: smaller;"

* Längre
* lista

Direkt övergång

Byt till nästa bild utan övergångseffekt. Det kan användas för att få ett utbyteseffekt på bilden.

---
## Bild
Med text
--- data-transition="none"
## Bild
Med annan text