Hjälp

Kasivra är ett skrivverktyg för författare. Du skriver i Markdown, och appen håller ordning på det som finns runt texten: mappar, taggar, personer och anteckningar om varje kapitel.

Kom igång

Öppna kasivra i Chrome eller Edge på en dator. Andra webbläsare kan inte öppna mappar på datorn än.
Klicka på Öppna mapp och välj mappen där ditt manus ligger, eller en tom mapp för ett nytt projekt.
Ge kasivra rätt att läsa och spara i mappen.

Kasivra kommer ihåg mappen. Nästa gång du öppnar appen räcker det att klicka på Fortsätt för att ge åtkomst igen.

Byta projekt

Kasivra minns de åtta senast öppnade projekten. Klicka på mappknappen överst i biblioteket för att se dem: det öppna projektet har en bock, och ett klick på ett annat byter till det. Den öppna filen sparas först. Välj Öppna annan mapp… för ett projekt som inte finns i listan. När inget projekt är öppet visas de fem senaste på startskärmen.

Webbläsaren kan glömma åtkomsten till en mapp mellan besöken. Då frågar den igen när du väljer projektet. Ligger mappen inte kvar där den låg tas projektet bort ur listan.

Ditt projekt är en vanlig mapp

Kasivra läser och sparar .md-filerna direkt i mappen på datorn. Det finns ingen databas och inget eget filformat. Du kan därför öppna samma filer i Typora eller en annan Markdown-editor, säkerhetskopiera dem som vanligt och versionshantera dem med git.

Mappar och undermappar blir projektets struktur, till exempel kapitel/ och personer/. Inställningar för en mapp, som färg, ikon och ordning, sparas i en liten fil som heter .kasivra.json i mappen.

Arbetsytan

Arbetsytan är ett papper som ligger på ett skrivbord. Under pappret ligger panelerna:

Biblioteket till vänster visar projektets mappar och alla taggar.
Fillistan visar filerna i den valda mappen, eller alla filer med den valda taggen, med titel, början av texten, taggar och antal ord.
Infopanelen till höger visar taggar och anteckningar om den öppna filen.

Knappen i pappersarkets vänstra hörn stegar mellan bibliotek och fillista, bara fillistan och bara texten. Knappen i högra hörnet visar och döljer infopanelen. Kasivra kommer ihåg hur du lämnade arbetsytan.

Favoritmappar: klicka på ⋯ vid en mapp i biblioteket och välj Fäst som favorit för att fästa den högst upp, under rubriken Favoriter. Nålen i fillistans rubrik gör samma sak. Välj Ta bort från favoriter i menyn på favoriten för att ta bort den. Favoriterna sparas i projektmappen och följer med om mappen byter namn.

Dra i kanten på biblioteket eller fillistan för att göra dem bredare eller smalare, till exempel om långa namn klipps av. Du kan också välja kanten med Tab och flytta den med vänster- och högerpilen. Dubbelklicka på kanten för att gå tillbaka till standardbredden.

Ge en mapp färg och ikon med palettknappen överst i fillistan.

Skapa och byta namn

Ny fil: knappen överst i fillistan skapar en fil i den valda mappen och öppnar den. Är en tagg vald får filen taggen.
Ny mapp: knappen överst i biblioteket skapar en mapp i den valda mappen.
Byt namn: håll muspekaren över en fil i fillistan och klicka på pennan, eller klicka på ⋯ vid en mapp i biblioteket och välj Byt namn. Den öppna filen kan också byta namn från infopanelen.

Filer får ändelsen .md automatiskt. Länkar från andra filer uppdateras inte när en fil eller mapp byter namn, så kontrollera dem efteråt.

Kommandopaletten

Tryck ⌘ P eller klicka på förstoringsglaset överst på pappret för att öppna kommandopaletten. Skriv några bokstäver av det du letar efter. Bokstäverna behöver inte stå i följd, så ”kap2” hittar ”Kapitel 2”. Paletten hittar:

Filer, efter titel, mapp och taggar.
Mappar och taggar, som visas i biblioteket och fillistan.
Projekt som du har öppnat tidigare.
Kommandon, till exempel ny fil, byt namn, byt layout och inställningarnas sidor, och allt i verktygslådan som fetstil, rubriker och listor (även Rubrik 4–6, som saknar knappar).
Text i filerna, från tre bokstäver. Gruppen I texten visar ett utdrag runt första träffen och hur många träffar filen har. Välj den för att öppna filen med träffen markerad.

Flytta med pilarna och välj med Enter, eller klicka. Esc stänger. Med tomt sökfält visas de senast öppnade filerna och alla kommandon. ⌘ ⇧ P, eller > först i sökfältet, visar bara kommandona.

Skriva

Texten visas formaterad: rubriker, fetstil, kursiv, citat, listor och länkar ser ut som de ska. Markdown-tecknen syns bara på raden där markören står, så att du kan ändra dem. Vill du se och skriva ren Markdown växlar du till källan med knappen överst till höger eller med ⌘ /.

Verktygslådan (verktygsknappen överst till höger) har knappar för rubriker, fetstil, kursiv, listor, citat, länkar och mer. Den hör till tillägget Formatering, som är påslaget från början.

Texten sparas automatiskt en sekund efter att du slutat skriva. Status står överst på pappret.

Taggar och anteckningar

I infopanelen lägger du till taggar på filen och tar bort dem med krysset. Taggar som redan finns i projektet föreslås när du skriver, och alla taggar samlas i biblioteket. Klicka på pricken framför en tagg i biblioteket för att byta färg. Menyn med tre punkter bredvid taggen byter namn på taggen eller raderar den, i alla filer på en gång. När en tagg är vald kan du också ta bort den från en fil direkt i fillistan.

Projektet kan också ha fält: uppgifter som du fyller i för varje fil, till exempel vilka personer som är med, var det utspelar sig och när. Du skapar ett fält med Lägg till fält i infopanelen. Ge fältet ett namn och välj typ: text, datum, ett val bland alternativ eller Filer. Du kan ha hur många fält du vill, och du ordnar, ändrar och tar bort dem under Inställningar → Fält eller med knappen bredvid fältets rubrik i infopanelen.

Ett fält av typen Filer hämtar filer ur en mapp som du väljer. Vill du ange vilka personer som är med i ett kapitel gör du till exempel ett fält som heter Personer och väljer mappen där personerna ligger. Platser fungerar likadant med en mapp för platser. Öppna sedan kapitlet och välj personerna en i taget i fältets lista. Filerna visas med sin rubrik (eller första raden), och filnamnet står i grått. De du väljer hamnar i en lista under, och klickar du på ett namn öppnas filen. Krysset tar bort den från fältet. Under Länkas från ser du vilka filer som länkar till den öppna filen, till exempel alla kapitel där en person är med.

Taggar och fält sparas överst i filen som så kallad frontmatter, så de följer med filen även utanför kasivra.

Kortkommandon

På Windows används Ctrl i stället för ⌘.

Kortkommando	Vad det gör
`⌘` `P`	Kommandopaletten: hitta filer, mappar och kommandon
`⌘` `⇧` `P`	Kommandopaletten med bara kommandon
`⌘` `S`	Spara nu
`⌘` `B`	Fetstil
`⌘` `I`	Kursiv
`⌘` `K`	Länk
`⌘` `E`	Kod
`⌘` `⇧` `E`	Kodblock (layouten Software Developer)
`⌘` `/`	Växla mellan formaterad text och Markdown-källa
`⌘` `,`	Öppna inställningarna
`Esc`	Stäng inställningarna

Inställningar

Öppna inställningarna längst ner i biblioteket eller med ⌘ ,. Inställningarna är delade i sidor, som du väljer i menyn till vänster:

Utseende: språk, ljust eller mörkt tema, hur tjocka strecken i ikonerna är och vilket skrivbord som ligger under pappret.
Editor: layouten för projektet och hur stor manustexten är.
Tillägg: vilka extra funktioner projektet använder.
Projekt: den öppna mappen, med knappar för att läsa om den eller öppna en annan.
Om kasivra: version, release notes och hjälp.

Språk, tema, skrivbord och textstorlek gäller datorn du sitter vid.

Språk: kasivra finns på svenska och engelska. System följer webbläsarens språk, och Svenska eller English väljer ett av dem. Språket gäller bara appen, inte texten i dina filer. Layouten och tilläggen gäller projektet och följer med projektmappen.

Layouter

Layouten bestämmer hur texten ser ut och hur du skriver i den. Välj under Inställningar → Editor → Layout. Valet gäller det öppna projektet och sparas i projektmappen. Filerna är vanlig Markdown oavsett layout.

Roman: löpande text i antikva, med rubriker. Standardlayouten.
Filmmanus: en manussida i Fountain-syntax, ett öppet format som många manusverktyg läser. En scenrubrik börjar med INT. eller EXT., ett rollnamn skrivs med versaler på en egen rad och repliken står på raden under. En parentes på egen rad i repliken blir regianvisning, och en rad med versaler som slutar på kolon (KLIPP TILL:) blir en övergång. Verktygslådan har knappar för scenrubrik, rollnamn, parentes och övergång, och infopanelen visar ungefär hur många sidor filen blir.
Teatermanus: en pjäs i antikva, med samma Fountain-syntax som filmmanus. Skriv akter som # AKT I och scener som ## Scen 1, rollnamnet i versaler på en egen rad och repliken under. En vanlig rad är en scenanvisning och visas kursivt. Verktygslådan har knappar för akt, scen, rollnamn och parentes, och infopanelen visar antal repliker.
Spelmanus: dialog för spel. En replik skrivs NAMN: text. Ett val är en listpunkt med mål, till exempel - Berätta sanningen -> sanningen, och -> nod på en egen rad skickar berättelsen vidare. Villkor och effekter skrivs i klammerparenteser, till exempel {om: tillit > 2}. En rad i parentes är en anvisning, och en rad som börjar med // är en kommentar. Rubriker (## Krogen) markerar noderna. Verktygslådan har knappar för replik, anvisning, val, gren och villkor, och infopanelen visar antal repliker och val.
Software Developer: teknisk text som designdokument, användarguider och README-filer, i sans-serif. Kod (så här) och kodblock står på en svag tonad bakgrund, tabeller visas i fast teckenbredd så att kolumnerna hamnar rätt, och GitHubs notisrutor (> [!NOTE], > [!WARNING]) och checklistor (- [ ]) visas som rutor och kryssrutor. ⌘ E gör markerad text till kod och ⌘ ⇧ E gör markerade rader till ett kodblock. Verktygslådan har knappar för kodblock, tabell, notis, varning och checklista, och infopanelen visar ungefärlig lästid.

Tillägg

Tillägg är extra funktioner som du slår på när du behöver dem. Öppna Inställningar → Tillägg och välj På eller Av för det öppna projektet. Valet sparas i projektmappen, så det gäller på alla datorer.

Formatering: verktygslådan och kortkommandona för fetstil, kursiv och länk. Påslaget från början.
Ordmål: antal ord i filen och projektet i infopanelen, och en framstegsrad mot ett mål som du anger själv.
Fokusläge: tonar ned allt utom stycket du skriver i och håller raden mitt på sidan.

Installera som app

Kasivra kan installeras och öppnas i ett eget fönster, utan webbläsarens flikar och adressfält. Appen startar då även utan internet.

Chrome och Edge: välj Installera kasivra i adressfältet eller i webbläsarens meny.
Safari på iPhone och iPad: tryck på Dela och sedan Lägg till på hemskärmen.

I mobilen går det ännu inte att öppna projektmappar.

Nyheter

När kasivra har uppdaterats visar appen vad som är nytt sedan du var där sist. Alla ändringar finns i release notes.