Handbok Kgeografi

# Handbok Kgeografi

Anne-Marie Mahfouf `<annma@kde.org>`

Kushal Das `<kushaldas@gmail.com>`

Översättare: Stefan Asserhäll
Revision Program 20.12 (2020-12-22)

Copyright © 2005 Anne-Marie Mahfouf

Copyright © 2008 Kushal Das

Rättsligt Meddelande

Kgeografi är ett inlärningsverktyg av geografi av KDE. Just nu har det sju användningssätt:

- Studera kartan genom att klicka på en del av kartan för att se dess namn, huvudstad och flagga

- Programmet talar om namnet på en del av kartan och du måste klicka på den

- Programmet talar om en huvudstad och du måste gissa vilken landsdel den hör till

- Programmet talar om en landsdel för dig och du måste gissa dess huvudstad

- Programmet visar dig flaggan för en del av kartan och du måste gissa dess namn

- Programmet talar om namnet på en del av kartan och du måste gissa dess flagga

- Programmet visar en tom karta och du måste placera ut landsdelar på den en i taget

Kapitel 1. Inledning
Inledning

# Kapitel 1. Inledning

Kgeografi är ett inlärningsverktyg av geografi av KDE. Det låter dig lära in politiska uppdelningen av vissa länder (landsdelar, huvudstäder i dessa landsdelar och deras tillhörande flaggor om det finns några).

Kapitel 2. Snabbstart av Kgeografi
Snabbstart av Kgeografi

# Kapitel 2. Snabbstart av Kgeografi

När du kör Kgeografi för första gången, ombeds du först välja en karta att börja med.

### Tips

Det går att filtrera kartlistan genom att använda textfältet Filtrera kartor. Skriv bara in några få av de första bokstäverna i kartans namn för att begränsa listan till några få träffar.

Här väljer vi Kanada

Och Kgeografis huvudfönster visas med Kanadas karta:

Du kan därefter välja vilken typ av inlärning eller prov som du vill göra genom att titta i menyn till vänster:

Utforska kartan: Ett vänsterklick i ett område på kartan visar information om det området. Om du klickar på den lilla ikonen Information i rutan, öppnas Wikipedia-sidan för den delen i systemets normala webbläsare:

Hitta landsdelar och territorier: Du blir först tillfrågad om hur många frågor du vill ha.

Därefter blir du tillfrågad om att klicka på en specifik landsdel:

När du är klar med alla frågor, visas en resultatdialogruta med rätta och felaktiga svar:

Placera landsdelar eller territorier på kartan: Markören får formen av en landsdel och du måste placera den på kartan:

Landsdel eller territorium från huvudstaden: Du blir tillfrågad om att hitta namnet på en landsdel från ett urval av fyra given dess huvudstad:

Och resultatet visas när provet är klart:

Huvudstäder för landsdelar eller territorier: Du har en huvudstad och fyra namn på landsdelar och du måste välja den rätta. Som tidigare visas en resultatdialogruta i slutet.

Landsdelar eller territorier från flaggan: En flagga visas och du måste hitta landsdelen den hör till.

Flaggor för landsdelar eller territorier: Namnet på en landsdel anges och du måste hitta rätt flagga av fyra.

Kapitel 3. Använda Kgeografi
Använda Kgeografi

# Kapitel 3. Använda Kgeografi

Kgeografi visar information om vissa länder och testar dig med denna information.

## Fler funktioner i Kgeografi

En annan funktion i Kgeografi är möjligheten att zooma i kartan.

Du kan klicka på knappen Zooma och därefter rita en rektangel för att zooma in till en del av kartan. I zoomläget kan du klicka med höger musknapp för att gå tillbaka till ursprunglig kartstorlek (alternativet Originalstorlek har samma effekt). Använd rullningslisterna, piltangenterna eller mushjulet för att flytta omkring i den zoomade kartan eller använd alternativet Flytta som låter dig dra kartan med vänster musknapp. Funktionen Automatisk zoom gör kartan så stor som möjligt.

Kapitel 4. Hur man skapar kartor
Hur man skapar kartor

# Kapitel 4. Hur man skapar kartor

En karta i Kgeografi består av två filer, en är kartbilden och den andra är dess beskrivning.

## Hjälpverktyg

Du hittar ett verktyg (skapat av Yann Verley) här som hjälpte honom med Frankrikes karta. För att ta reda på hur det fungerar, kör det helt enkelt och läs hjälpmeddelandet. Det skapar i huvudsak `.kgm`-filen från en vanlig textfil och skapar en fil med färgerna det har tilldelat varje del av kartan, så att du kan fylla kartan i enlighet med dem.

Det finns ett annat verktyg, colorchecker.py, skrivet av Albert Astals Cid. Du behöver PyQt4 för att köra det. Kör det bara med `.kgm`-filnamnet som argument (kartans `.png`-fil behövs också i samma katalog). Det talat om för dig om någon bildpunkt på kartan har en annan färg som inte är definierad i `.kgm`-filen (beskrivningsfilen).

### Tips

Läs också handledningen How to add maps på Kgeografis webbsida.

Beskrivningsfil
Beskrivningsfil

## Beskrivningsfil

Beskrivningsfilen är nödvändig och dess filändelse är `.kgm`. Den ska börja med `<?xml version="1.0" encoding="utf-8">`, then `<!DOCTYPE kgeographyMap>`, följt av `<map>` och sluta med `</map>`.

Inne i dessa taggar ska finnas:

- `<mapFile>` och `</mapFile>`: Namnet på filen (utan sökväg) som innehåller kartbilden, t.ex. ”`europe.png`”.

- `<name>` och `</name>`: Kartans namn, t.ex. ”`Europe`”.

- En `<divisionsName>` och `</divisionsName>`: Det allmänna namnet på delarna på kartan, dvs. provinser, stater, län, etc.

- En `<division>` och `</division>` för varje del av kartan.

Varje del har dessa taggar:

- `<name>` och `</name>`: Namnet på kartdelen, t.ex. ”`Albania`”.

- `<capital>` och `</capital>`: Namnet på delens huvudstad, t.ex. ”`Tirana`”.

- Taggen `<ignore>` och `</ignore>` kan anges som `yes`, `allowClickMode`, `allowClickFlagMode`och `no`. Om taggen anges som `yes` ignoreras kartdelen när frågor ställs om kartdelarna på den här kartan. Det förefaller då som om kartdelen inte finns vid prov i Kgeografi. Om taggen anges som `allowClickMode` frågar Kgeografi om kartdelen i läget Klicka på en del av kartan... men inte i övriga prov. Om taggen anges som `allowClickFlagMode` frågar Kgeografi om kartdelen i läget Klicka på en del av kartan... och i flaggrelaterade prov men inte i övriga prov. Att ange taggen som `no` betyder att kartdelen syns i alla lägen (studie och prov). Taggen är valfri och när det inte finns någon `<ignore>` betyder det att den är satt till `no`. Exempelvis har ”`Algeriet`” den satt till `yes` på kartan över ”`Europa`” vilket betyder att ”`Algeriet`” inte ingår i några frågor på ”`Europa`”.

- `<flag>` och `</flag>`: Filen (utan någon sökväg) som innehåller delens flagga, t.ex. ”`albania.png`”. Taggen är valfri. Den behövs inte för delar som har taggen `<ignore>` inställd till `yes`.

- `<blurredflag>` och `</blurredflag>`: Filen (utan någon sökväg) som innehåller landsdelens suddiga flagga, t.ex. ”`blurred_albania.png`”. Taggen är valfri. Den bör användas i fall då flaggan har namnet på delen som den hör till skrivet på den. Det kan göra att flaggissning blir för enkel, och därmed uppmuntras inskickning av flaggan med texten utsuddad.

- `<color>` och `</color>`: Färgen som delen har på kartan.

- `<falseCapital>` och `</falseCapital>`: Det kan finnas hur många par med `falseCapital` som helst. De används för att tillhandahålla en lista med felaktiga svar på frågor om huvudstäder, istället för att de felaktiga svaren väljes bland övriga landsdelars huvudstäder.

Färgen definieras genom att använda tre taggar:

- `<red>` och `</red>`: Färgens röda del. Giltiga värden är mellan 0 och 255.

- `<green>` och `</green>`: Färgens gröna del. Giltiga värden är mellan 0 och 255.

- `<blue>` och `</blue>`: Färgens blåa del. Giltiga värden är mellan 0 och 255.

### Tips

Det är bekvämt att skapa två eller tre falska delar som ”`Water`”, ”`Frontier`” och ”`Coast`” och ge dem taggen `<ignore>` med värdet `yes`. Glöm inte att `inte ställa in` färgen 0,0,0 i RGB för någon ”`Frontier`”. Låt den vara någonting i stil med 1,1,1 så att en gränskontur visas när någon del placeras på kartan.

### Viktigt

Alla namn (huvudstäder och landsdelar) måste vara på engelska.

Kartfil
Kartfil

## Kartfil

Kartfilen är mycket enkel, men arbetsam att skapa. Den måste vara på PNG-format. Du kan hitta några kartor att omvandla på Cia Reference Maps. Om ingen karta passar ditt behov kan du ladda ner politisk världskarta, ta en skärmbild och fortsätta därifrån. Varje del av kartan ska ha en och endast en färg. För att åstadkomma det kan du använda bildbehandlingsprogram som Gimp och KolourPaint.

Flaggor
Flaggor

## Flaggor

Om du har använt taggen `<flag>` måste du tillhandahålla flaggfilerna. De måste vara på PNG-format och bättre om de är 300 x 200 bildpunkter och du tillhandahåller en SVG-fil för dem. För att skaffa SVG-flaggor för nästan alla länder i världen och för vissa andra delar, kan du rådfråga Sodipodis flaggsamling.

Som tidigare nämnts, uppmuntrar vi dig att tillhandahålla suddiga flaggfiler för flaggor som har sin landsdel skriven på dem. Samma krav som för de vanliga flaggfilerna gäller för de suddiga flaggfilerna. Även om det inte finns någon föreskriven namngivning för de suddiga filerna, rekommenderar vi att de sparas med namnet på den ursprungliga flaggan med prefixet `blurred_`, t.ex. ”`blurred_albania.png`”.

Hur man testar
Hur man testar

## Hur man testar

Innan du skickar din karta till Albert `(aacid AT kde.org)`, bör du testa den för att se att den inte har några fel. För att åstadkomma det, måste du göra följande:

- Placera kartbeskrivningen och kartans bildfil i `$`XDG_DATA_HOME`/share/apps/kgeography/`

- Placera flaggornas PNG-filer (om det finns några) i `$`XDG_DATA_HOME`/share/apps/kgeography/flags/`

När du väl har gjort det ska du kunna öppna din karta inne i Kgeografi.

Om du inte vet vad `$`XDG_DATA_HOME`` är, skriv `qtpaths `--paths hemkatalog`` i ett skal.

### Tips

Använd verktyget colorchecker.py från hjälpverktygen för att kontrollera om det finns någon extra färg kvar på kartan som inte är definierad i `.kgm`-filen.

Icke-politiska kartor
Icke-politiska kartor

## Icke-politiska kartor

Är det möjligt att skapa icke-politiska kartor? Ja, det är det!

Naturligtvis kan delkonceptet utökas till en flod eller ett berg. När kartan skapas, bör du hålla i minnet att oftast är floden eller berget för litet och att du måste tillhandahålla ett extra område att klicka. I exemplet skulle floden ha det mörkgröna området med färgen <20,76,34> som identifiering.

Kapitel 5. Kommandoreferens
Kommandoreferens

# Kapitel 5. Kommandoreferens

## Kgeografis huvudfönster

### Menyn Arkiv

Arkiv → Öppna karta... (Ctrl+O)

  Öppna dialogrutan för att välja karta. Om du skriver in de första bokstäverna för kartan du söker snabbt nog, väljes den första kartan som passar in.

Arkiv → Avsluta (Ctrl+Q)

  Avslutar Kgeografi.

### Menyn Visa

Visa → Zooma

  Går till zoomläge, och ritar därefter en rektangel för att zooma in på en del av kartan.

Visa → Originalstorlek

  Ställer in kartan till dess originalstorlek enligt definitionen i kartfilen. Ett högerklick i zoomläge utför samma åtgärd.

Visa → Automatisk zoom

  Ställer in kartan att automatiskt zooma för att använda så mycket utrymme som möjligt när storleken på Kgeografis fönster ändras.

Visa → Flytta

  Flyttar aktuell karta. Alternativet är bara aktiverat om du har zoomat in kartan.

### Menyn Inställningar

Kgeografi har KDE:s vanliga menyalternativ i menyn Inställningar. För mer information läs avsnittet om menyn inställningar i KDE:s grunder.

### Menyn Hjälp

Kgeografi har KDE:s vanliga Hjälp-meny som beskrivs i KDE:s grunder, med två ytterligare alternativ:

Hjälp → Friskrivning

  Visar en friskrivning om riktigheten hos kartor, flaggor och översättningar som används i Kgeografi.

Hjälp → Kartans upphovsman

  Visar namnet på upphovsmannen som har skapat nuvarande karta.

Kapitel 6. Inställning
Inställning

# Kapitel 6. Inställning

Justering av frågor

  Bestämmer position för frågorna i fönstret, normalvärdet är Uppe till vänster.

Vänta på validering

  Om aktiverat måste användaren klicka på Acceptera efter att ha valt ett svar.

Fokus följer musen

  Om aktiverad klickas knappen under muspekaren genom att trycka på mellanslag.

Kartans landsdelsfärger

  Du kan välja om du alltid vill behålla samma färger (normalvärdet) eller om du vill använda slumpmässiga färger. Med det alternativet tilldelas slumpmässiga färger till kartans delar. Det hjälper användare att fokusera på och lära sig delarnas former och inte deras färger.

Kapitel 7. Tack till och licens
Tack till och licens

# Kapitel 7. Tack till och licens

Kgeografi

Program copyright 2004-2008 Albert Astals Cid `(aacid AT kde.org)`

Dokumentation Copyright (c) 2005 Anne-Marie Mahfouf `(annma AT kde.org)` 2008 Kushal Das `(kushaldas AT gmail.com)`

Översättning Stefan Asserhäll `(stefan.asserhall AT bredband.net)`

Den här dokumentationen licensieras under villkoren i GNU Free Documentation License.

Det här programmet licensieras under villkoren i GNU General Public License.