# Skapa presentationer Presentationerna skrivs som markdown-filer i innehållsrepot (`contents/slides/.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 understruken text kan användas. ``` MarkDown Enkel textformatering som *betonad* eller understruken 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 Ä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 ``` 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 ``. ``` MarkDown Den här texten visas först senare. ``` Flera ``-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 Anteckningen visas bara i talarvyn * Listor går också bra * Håll dem helst korta * Utrymmet är begränsat ``` ### 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 `` och ``. ``` MarkDown [photo:167:rufzeichen_flugzeug:Flygplan med anropssignalen SE-ABC] * 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 ``` ### 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 * En interaktiv karta med Maidenhead-lokator visas. ``` 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 ```