# Handbok för Epiphany-utökningar

## Introduktion

Epiphany-utökningar är en uppsättning verktyg som utökar färdigheterna för Epiphany, GNOME-webbläsaren.

De tillhandahåller ny funktionalitet och förbättrar vissa befintliga funktioner i Epiphany.

## Utökningshanterare

### Introduktion

Utökningshanteraren är verktyget som låter dig aktivera utökningar i Epiphany.

### Användning av Utökningshanteraren

För att öppna Utökningshanteraren, välj Verktyg Utökningar....

För att aktivera en utökning, kryssa i kryssrutan framför utökningen. För att inaktivera en utökning, klicka bort krysset i kryssrutan.

## Åtgärder

### Introduktion

Utökningen Åtgärder låter dig skapa specifika åtgärder i sammanhangsmenyn, för bilder, sidor eller båda.

### Hantera åtgärder

#### Skapa åtgärder

Genomför följande steg för att skapa en åtgärd:

1. Välj Redigera Åtgärder för att öppna Åtgärdshanteraren

2. Tryck på Lägg till för att lägga till en ny åtgärd

3. I "Lägg till åtgärd"-fönstret,

   - Ange Namn för åtgärden. Namnet kommer att visas i sammanhangsmenyn

   - Ange en Beskrivning för åtgärden. Beskrivningen kommer att visas i statusraden i Epiphany och i Åtgärdshanteraren

   - Ange vilket Kommando som ska köras. Det här kommandot kommer att köras och kommer att ta emot elementet som argument när du startar åtgärden. Den här åtgärden kan vara ett program eller skript som finns tillgängligt i din sökväg

   - Välj Sidor eller Bilder för att välja för vilka element som åtgärden ska visas

   - Tryck på Lägg till

4. Tryck på Stäng för att stänga Åtgärdshanteraren

##### En exempelåtgärd

#### Redigera åtgärder

Följ dessa steg för att redigera en åtgärd:

1. Välj Redigera Åtgärder för att öppna Åtgärdshanteraren

2. Välj åtgärden att redigera

3. Tryck på Redigera

4. Redigera åtgärden som beskrivs i epi-ext-action-manage-create

#### Ta bort åtgärder

Gör följande för att ta bort en åtgärd:

1. Välj Redigera Åtgärder för att öppna Åtgärdshanteraren

2. Välj den åtgärd du vill ta bort

3. Tryck på Ta bort

4. Tryck på Stäng för att stänga Åtgärdshanteraren

### Användning av Åtgärder

För att använda en anpassad åtgärd, välj åtgärden att köra från sammanhangsmenyn för elementet du önskar genomföra åtgärden på.

#### Bildsammanhangsmenyn i Epiphany med en anpassad åtgärd

## Ad Blocker

### Introduktion

Utökningen Ad Blocker låter dig blockera reklambanners på webbplatser. Den förhindrar att de hämtas ner, vilket sparar tid och bandbredd.

### Användning av Ad Blocker

För att använda Ad Blocker måste du aktivera utökningen. Utökningen kommer att ignorera länkar till reklam när du besöker webbplatser och de kommer inte att visas i webbsidorna.

Epiphany visar en ikon på vänstra sidan av statusraden (se epi-ext-figure-adblocker) för att informera dig om att den har blockerat reklam. Om du flyttar muspekaren tiIl ikonen kommer den att visa antalet reklambanners som har blockerats för sidan.

#### Ikonen för Ad Blocker

### Utöka Ad Blocker

Ad Blocker ska blockera den mesta reklamen på webben men om du hittar några banners som inte blockeras eller att Ad Blocker är för restriktiv, kan du justera Ad Blocker-utökningen för att passa dina behov.

Ad Blocker använder reguljära Perl-uttryck för att matcha kända URL:er för reklamservrar och vanliga ord som används i reklam-URL:er. Ad Blocker lagrar systembreda regler i filen `adblock-patterns` som finns i `$PREFIX/share/epiphany-extensions/`; ett reguljärt uttryck per rad.

#### Lägg till en blockeringsregel

Om du vill blockera en reklambanner som inte blockeras av standardreglerna i Ad Blocker kan du skapa en svartlistefil, och lägga till regler i den.

Epiphany letar efter svartlistreglerna i filen `$HOME/.gnome2/epiphany/extensions/data/adblock/blacklist`.

#### Lägg till en tillåtelseregel

Om du vill tillåta att en reklambanner visas eller korrigera en regel i Ad Blocker som är för restriktiv, kan du skapa en vitlistefil, och lägga till regler i den.

Epiphany letar efter vitlistreglerna i filen `$HOME/.gnome2/epiphany/extensions/data/adblock/whitelist`.

## Läs om flik automatiskt

### Introduktion

Utökningen Läs automatiskt om flik låter dig periodiskt läsa om en sida i en flik.

### Användning av Läs om flik automatiskt

Ange URL:en för en sida som du vill öppna och som du vet att dess innehåll ändras ofta, välj sedan Visa Läs om automatiskt för att aktivera den automatiskt omläsningen, Epiphany kommer att uppdatera sidan var tredje minut.

#### Läs automatiskt om lokala filer

När en lokal fil öppnas kommer Epiphany att övervaka den och läsa om den när den ändras.

## Automatisk rullning

### Introduktion

Utökningen Automatisk rullning låter dig automatiskt rulla en sida i valfri riktning. Till exempel, om du ställer in en långsam rullning kan du läsa en hel webbsida utan att röra din mus.

### Användning av Automatisk rullning

För att påbörja en automatisk rullning för en sida,

1. Tryck och släpp mittenmusknappen; ett mål visas och muspekaren ändras till en handpekare.

2. Flytta muspekaren i riktningen för att rulla. Sidan kommer att börja rullas i den riktningen.

## Certifikat

### Introduktion

Utökningen Certifikat ger dig åtkomst till certifikaten som lagrats av Epiphany för att kunna visa eller hantera dem.

### Användning av Certifikat

#### Visa webbsidans certifikat

När du visar en säker webbsida kommer det olåsta hänglåset som visas på vänster sida av statusraden att bli ett låst hänglås. När Certifikat-utökningen är aktiverad kan du klicka på hänglåset och den kommer att visa information om certfikatet.

#### Hantera certifikat

Utökningen Certifikat låter dig hantera certfikat som lagrats av webbläsaren Epiphany.

För att visa Certifikathanteraren, välj Verktyg Hantera certifikat, den ger åtkomst till fyra olika flikar:

Dina certifikat

- För att importera, visa, säkerhetskopiera och ta bort dina egna certifikat. Personliga certifikat användas för att identifiera dig själv när du surfar på en känslig webbplats.

Andra personers

- För att importera, visa, redigera och ta bort certifikat från personer som du känner.

Webbplatser

- För att importera, visa, redigera och ta bort certifikat från webbplatser som du har besökt.

Utfärdare

- För att importera, visa, redigera och ta bort certifikat från utfärdare. Utfärdare är organisationer som skapar och validerar giltigheten för publicerade certfikat på Internet.

#### Hantera säkerhetsenheter

Säkerhetsenheter används för att kryptera och dekryptera anslutningar och kan lagra certifikat och lösenord.

## Felvisare

### Introduktion

Utökningen Felvisare låter dig visa fel i webbsidor, validera webbsidor och kontrollera länkar.

### Användning av Felvisare

Felvisaren är en liten men användbar utökning som webmasters kan använda för att kontrollera att webbsidorna (speciellt dina egna) är giltiga enligt webbstandarderna. Den här utökningen har tre funktioner:

Kontrollera länkar

- Identifierar döda länkar på en sida

Kontrollera HTML-kod

- Kontrollerar giltigheten för källkoden.

Felvisare

- Visar diverse fel för en webbsida (som till exempel javascript, ...)

För att köra Kontrollera länkar, välj Verktyg Kontrollera länkar. Felvisarfönstret kommer att öppnas och validering av länkarna startar automatiskt.

För att köra Kontrollera HTML-kod, välj Verktyg Kontrollera HTML. Felvisarfönstret kommer att öppnas och validering av HTML-koden kommer att starta automatiskt.

För att köra Felvisaren, välj Verktyg Felvisare. Felvisarfönstret kommer att öppnas och visar alla valideringsfel som hittas i webbsidan.

## Favoritikonreserv

### Introduktion

Utökningen Favoritikonreserv tillåter hämtning av ikonen favicon.ico när "favicon" inte har deklarerats korrekt i webbsidan.

### Användning av Favoritikon

När aktiverad kommer den här utökningen att hämta bildfilen /favicon.ico för varje webbplats som du besöker om det finns en sådan fil. Sedan kommer Epiphany att visa den här ikonen till vänster på adressfältet.

## Gester

### Introduktion

Gester låter dig snabbt genomföra åtgärder i Epiphany genom att rita en figur med musen.

### Användning av Gester

För att genomföra en gest, tryck med mittenknappen i visningsrutan i ett Epiphany-fönster, flytta musen i ett av följande mönster och släpp sedan knappen. Muspekaren kommer att ändras under tiden gesten genomförs.

### Lista över tillgängliga standardmönster i Epiphany-utökningar

Åtgärd | Gest | Exempel
Gå bakåt i historik | Vänster |
Gå framåt i historik | Höger |
Gå upp i en katalog | Upp - Vänster - Upp |
Gå till din hemsida | Upp - Vänster - Ner |
Läs om sidan | Upp - Ner |
Stoppa inläsning av sidan | Vänster - Upp |
Öppna ett nytt fönster | Upp |
Öppna en ny flik | Ner |
Stäng en flik/fönster | Höger - Vänster - Höger |
Stäng en flik/fönster (andra gest) | Ner - Höger |
Växla helskärmsläge | Ner - Vänster |
Gå till nästa flik | Upp - Höger |
Gå till föregående flik | Upp - Vänster |
Visa sidkällan | Vänster - Ner - Höger - Ner - Vänster (Gör en S) |
Visa sidkällan (Andra gest) | Upp - Höger - Ner |

### Skapa gester

Utökningen Gester låter dig skapa dina egna gestmönster och låter dig på så vis utöka uppsättningen som tillhandahålls som standard.

#### Förstå hur gester fungerar

Epiphany lagrar definitionen av gester för alla användare i filen `ephy-gestures.xml` som finns i katalogen `$PREFIX/share/epiphany-extensions/`; den här filen använder xml-formatet, och definierar gester för alla användare på systemet.

Om du öppnar den här filen kommer du att se en uppsättning av markup-gester, och inne i dem finns en av flera markup-sekvensen och en markup-åtgärd.

##### Ett exempel på en gest

    <!-- down-left -->
    <gesture>
    	<sequence>36987</sequence>
    	<sequence>3687</sequence>
    	<action>/menubar/ViewMenu/ViewFullscreenMenu</action>
    </gesture>

#### Skapa ny gest

I det här avsnittet kommer vi att förklara hur man skapar en ny gest. Vi bestämmer att en webbsida ska skrivas ut när vi ritar ett P med musen.

För att skapa dina egna gester, skapa först en fil med namnet `ephy-gestures.xml` i katalogen `~/.gnome2/epiphany/` som kommer att lagra dina personliga gestdefinitioner.

Öppna den nyligen skapade filen med en textredigerare och lägg till följande innehåll:

    <?xml version="1.0"?>
    <epiphany_gestures version="0.4">
    	<gesture>
    		<sequence></sequence>
    		<action></action>
    	</gesture>
    </epiphany_gestures>

##### Definiera geströrelsen

För att definiera en ny gest behöver du en eller flera sekvenser och en åtgärd som ska köras.

En sekvens är en uppsättning av numeriska värden mellan 1 och 9, vilka definierar gesten som ska ritas upp som följer en knappsatsliknande layout (där "1" är placerad i övre vänstra hörnet och "9" i nedre högra hörnet).

Om vi vill rita upp ett P blir tangentsekvensen 74123654, infoga det här värdet i elementet "sequence".

    <?xml version="1.0"?>
    <epiphany_gestures version="0.4">
    	<gesture>
    		<sequence>74123654</sequence>
    		<action></action>
    	</gesture>
    </epiphany_gestures>

##### Definiera åtgärden

En åtgärd beskriver sökvägen till ett meny- eller verktygsradsobjekt i Epiphany-fönstret. Alla dessa sökvägar definieras i filen `ephy-gestures.xml` som finns i `$PREFIX/epiphany-browser/epiphany-ui.xml`

    <?xml version="1.0"?>
    <epiphany_gestures version="0.4">
    	<gesture>
    		<sequence>74123654</sequence>
    		<action>/menubar/FileMenu/FilePrintMenu</action>
    	</gesture>
    </epiphany_gestures>

## Greasemonkey

### Introduktion

Greasemonkey är en kraftfull utökning som låter användarna använda skript som gör omedelbara ändringar i webbsidor. Greasemonkey-skripten kan till exempel göra sidändringar eller fylla i formulär automatiskt.

Greasemonkey-skript är javascript och har filändelsen ".user.js". Utökningen Greasemonkey innehåller som standard inga skript, du måste själv hitta skript på webben. Ett bra förråd av Greasemonkey-skript finns på webbplatsen http://userscripts.org/.

För att lära dig mer om Greasemonkey, läs definitionen på Wikipedia.

### Användning av Greasemonkey

#### Installera ett Greasemonkey-skript

För att installera ett Greasemonkey-skript, leta först fram länken till ett greasemonkey-skript på en webbsida, högerklicka på länken och välj Installera användarskript. Epiphany kommer att hämta skriptet; en meddelanderuta kommer att bekräfta att skriptet har installerats och är färdigt att användas.

Du kan manuellt installera Greasemonkey-skript genom att kopiera dem till `$HOME/.gnome2/epiphany/extensions/data/greasemonkey/`

#### Ta bort ett Greasemonkey-skript

Epiphany tillhandahåller ingen grafiskt användargränssnitt för att ta bort skript; för att ta bort en skript, gå till `$HOME/.gnome2/epiphany/extensions/data/greasemonkey/` och flytta skriptfilen till papperskorgen.

## Java-konsoll

### Introduktion

Utökningen Java-konsoll tillhandahåller åtkomst till Java-Plugin Console.

### Användning av Java-konsoll

För att visa Java-konsollen, välj Verktyg Java-konsoll.

## Prenumeration på nyhetskanal

### Introduktion

Utökningen Prenumeration på nyhetskanaler låter dig prenumerera på en nyhetskanal som erbjuds av webbsidan i din favoritnyhetsläsare. Webbkanalsläsare som stöds är

- Liferea

- Straw

- Blam

### Användning av Prenumeration på nyhetskanal

När Epiphany detekterar att en webbplats tillhandahåller RSS och Atom-kanaler, kommer den att visa en ikon på vänstra sidan av statusraden i Epiphany.

För att registrera den här kanalen:

1. Välj Verktyg Prenumerera på nyhetskanal, ett nytt fönster med listan över tillgängliga kanaler kommer att visas. Du kan även klicka på kanalikonen i statusraden för att visa fönstret Prenumerera på nyhetskanal.

2. Välj de kanaler som du vill prenumerera på. Du kan även kopiera kanalens adress med hjälp av sammanhangsmenyn för kanalen.

3. Tryck på Prenumerera för att prenumerera på kanalerna.

## Sidinformation

### Introduktion

Utökningen Sidinformation tillhandahåller detaljerad information om webbsidorna som du besöker.

### Användning av Sidinformation

För att komma åt sidinformationen, välj Visa Sidinformation; ett nytt fönster visas som låter dig komma åt fem olika flikar:

Allmänt

- Tillhandahåller diverse information om sidan och webbplatsen

Media

- Visar mediafiler (bilder, ljud,...) som används på sidan.

Länkar

- Tillhandahåller alla länkarna för webbsidan.

Formulär

- Visar alla formulär tillgängliga på sidan.

Metadata

- Visar all information som matats in av webbmastern om webbplatsen.

## Tryckrullning

### Introduktion

Utökningen Tryckrullning tillhandahåller en rullningsfunktion när mittenmusknappen trycks ner.

### Användning av Tryckrullning

För att använda Tryckrullning, tryck helt enkelt ner mittenmusknappen och rör din mus i någon riktning och sidan kommer att rullas.

## Python-konsoll

### Introduktion

Öppnar en interaktiv Python-konsoll och tillåter ändringar i Epiphany genom Python.

### Användning av Python-konsoll

För att visa Python-konsollen, välj Verktyg Python-konsoll.

## Välj stilmall

### Introduktion

Utökningen Välj stilmall låter dig växla mellan stilmallar för en webbsida. Du kan även inaktivera stilmallar när du visar en sida.

### Användning av Välj stilmall

För att ändra stilmallen för webbplatsen som du besöker, välj Visa Stil , välj sedan en stilmall från de som finns tillgängliga.

Om du väljer stilmallen Ingen kommer webbplatsen inte att använda någon stilmall.

## Sidopanel

### Introduktion

Utökningen Sidopanel lägger till ett litet fönster på vänstra sidan i Epiphany-fönstret. Sidopanelen gör att webbplatsinnehållet kan visas och kan tillhandahålla snabb åtkomst till dess information.

### Användning av Sidopanel

#### Epiphany med en sidopanel som visas

#### Visa Sidopanel

Som standard visas inte sidopanelen; för att visa sidopanelen, välj Visa Sidopanel.

Du kan även växla synligheten för sidopanelen genom att trycka på F9.

#### Lägg till en sidopanel

För att lägga till en sidopanel, aktivera utökningen Sidopanel, klicka sedan på länken som webbsidan tillhandahåller för att installera sidopanelen. Ett fönster visas som frågar om att lägga till dokumentet till sidopanelen, klicka på Lägg till en sidopanel, sidopanelsdokumentet kommer då att läggas till i sidopanelen.

Du kan hitta en lista över webbplatser som tillhandahåller en sidopanel på DMOZ.

#### Växla mellan sidopaneler

När du har prenumererat på flera sidopaneler kan du välja sidopanel från rullgardinslistan i överdelen av sidopanelen för att växla mellan dem.

#### Ta bort en sidopanel

För att ta bort en Sidopanel som du har lagt till, visa sidopanelen som ska tas bort och tryck på papperskorgsikonen.

## Smarta bokmärken

### Introduktion

Utökningen Smarta bokmärken är en utökning som gör att man kan slå upp markerad text med ett smart bokmärke.

### Användning av Smarta bokmärken

För att skapa ett smart bokmärke, se lämpligt avsnitt i handboken för Epiphany.

För att slå upp text, markera texten i en webbsida och välj slå upp och det smarta bokmärket från sammanhangsmenyn. En webbläsare kommer att öppnas med resultatet för uppslagningen.

## Flikgrupper

### Introduktion

Utökningen Flikgrupper gör att nya flikar visas efter den aktuella fliken.

### Användning av Flikgrupper

När den här utökningen är aktiverad, kommer den att ändra det normala beteendet (där nya flikar skapas efter den sista fliken) till ett nytt beteende. När du öppnar en ny flik kommer den att skapas efter den aktuella fliken.

#### En ny flik skapas efter den första fliken

## Fliktillstånd

### Introduktion

Utökningen Fliktillstånd ändrar statusen för fliketiketten för att signalera att innehållet har ändrats.

### Användning av Fliktillstånd

När den här utökningen är aktiverad, när innehållet i en sida i en flik ändras, kommer fliketiketten att få fet text för att informera dig om att sidan har ändrats.

## Om Epiphany-utökningar

Epiphany-utökningar skrevs av

- Samuel Abels (spam2@debain.org)

- Crispin Flowerday (gnome@flowerday.cx)

- Adam Hooper (adamh@cvs.gnome.org)

- Mathias Hasselmann (mathias@taschenorakel.de)

- James Henstridge (james@daa.com.au)

- Jean-Yves Lefort (jylefort@brutele.be)

- Christian Persch (chpe@gnome.org)

- Raphaël Slinckx (raphael@slinckx.net)

- Justin Wake (jwake@iinet.net.au)

Den här handboken skrevs av Baptiste Mille-Mathias baptiste.millemathias@gmail.com.

Det här programmet distribueras under villkoren för GNU General Public License som publicerats av Free Software Foundation; antingen version 2 av licensen, eller (upp till dig) någon senare version. En kopia av den här licensen kan hittas på denna länk, eller i filen COPYING som inkluderats med källkoden för det här programmet.