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.

``` MarkDown
--- 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.

``` MarkDown
--- unit
```

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

``` MarkDown
--- attention
```

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

``` MarkDown
--- 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å.

``` MarkDown
# Rubrik 1
## Rubrik 2
### Rubrik 3
```

Den högsta nivån är 6.

### Listor

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

``` MarkDown
* 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`).

``` Markdown
| 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 <u>understruken</u> text kan användas.

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

### Bilder

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

``` MarkDown
[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.

``` Markdown
[question:2482]
```

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

``` Markdown
---
[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:

``` Markdown
<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>`.

``` MarkDown
<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.

``` MarkDown
<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 `$`.

``` MarkDown
$\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.

``` MarkDown
[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>`.

``` MarkDown
<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.

``` MarkDown
--- 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.

``` MarkDown
--- 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.

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