## Manual til Clipman

### Mike Massonnet

`<mmassonnet@xfce.org>`

This manual describes version 1.0.1 of Clipman.

Ophavsret © 2009 Mike Massonnet

Der gives hermed tilladelse til kopiere, distribuere og/eller ændre dette dokument under betingelserne af GNU Free Documentation License, Version 1.3 eller enhver senere version udgivet af Free Software Foundation, med ingen ufravigelige dele; ingen forsidetekst, og ingen bagsidetekst. Hele licensteksten er til rådighed på Free Software Foundation.

April, July 2009

## Introduktion

Clipman er en udklipsholderhåndtering til Xfce. Den beholder indholdet af udklip, hvorimod det som regel er tabt, når du lukker et program. Den er i stand til at håndtere tekst og billeder, og kan udføre handlinger på specifikke tekstmarkeringer ved at sammenligne dem med regulære udtryk.

### Udklipsholderens opbygning

I X11 (alle Unix platform) er der som standard to udklipsholdere til at udveksle data mellem vinduerne. En standard udklipsholder som ændres ved manuelle kopier (f.eks. når du markerer en fil og trykker på knappen kopiér), og en primær udklipsholder der ændres af markeringer (f.eks. når du markerer tekst i et felt).

Clipman håndterer kun standardudklipsholderen, men kan også håndtere markeringer. Når den håndterer markeringer, vil standardklippebordet altid blive synkroniseret med den, og indeholde det samme data. På denne måde kan du indsætte med tastaturet, hvad du vælger på skærmen.

### Komme i gang

Clipman bruges til at lave en historik af indholdet i udklipsholderen, og til at gendanne dem igen. Historikken er vises i en menu, ved at klikke på hovedikonet. I menuen er det muligt gendanne en tekst og at rydde historikken.

Figur 1. Menu i Clipman

Der er to måder du kan køre Clipman på. Du kan vælge Clipman i programmenuen, under kategorien Tilbehør eller skrive `xfce4-clipman` på kommandolinjen, eller du kan tilføje det til dit panel. Højreklik på panelet og vælg "Tilføj nyt element...", for at føje et nyt element til panelet.

### Popup-kommando

Clipman tilbyder kommandolinjeværktøjet `xfce4-popup-clipman`. Når den bliver startet, fremkaldes hovedmenuen. Kommandoen er praktisk til Programgenveje der er tilgængelige i Xfce-menuen+Indstillinger+Tastatur.

## Indstillinger

Indstillingsvinduet er tilgængelig under elementet "Egenskaber" i kontekstmenuen ved højreklik, på hovedikonet. Den lader dig tilpasse historikken og redigere handlinger.

### Generelt

Følgende tabel beskriver mulige tilvalg:

Tabel 1. Generelle tilvalg i indstillingsvinduet

Tilvalg | Beskrivelse
--- | ---
Synkronisér markeringer | Synkronisér den primære udklipsholder med standardudklipsholderen, så det er muligt at indsætte det der bliver markeret
Udelad fra historik | Forhindrer at den primære udklipsholder bliver indsat i historikken.
Gem ved afslutning | Beholder historikken ved hver ny session
Opbevar et billede | Lader dig opbevare et billeder i historikken
Størrelsen på historikken | Angiver antallet af elementer der kan opbevares i historikken

Figur 2. Indstillinger til Clipman

### Handlinger

En handling er en kombination af et handlingsnavn og et regulært udtryk. Hver handling kan have en eller flere kommandoer. Understøttelsen af handlinger er valgfri og kan slås til eller fra med tilvalget "Aktivér handlinger".

Klik på Tilføj-ikonet for at tilføje en ny handling og klik på ikonet Redigér eller dobbeltklik på handlingen, og vælg en handling og klik på ikonet Slet for at fjerne en handling. Et nyt vindue bliver åbnet ved at tilføjelse eller redigering af en handling.

Se “Handlingsvindue” for at lære mere om handlinger.

Figur 3. Indstillinger til Clipman

### Handlingsvindue

En handling har et navn, der er læseligt for mennesker, der beskriver det mønster det skal sammenlignes med. En handling skal have mindst én kommando som også har et navn, der er læseligt for mennesker. Den sammenlignede tekst kan blive genbrugt i kommandoen.

Disse handlinger er altid sammenlignet med tekstmarkeringerne hvis ikke andet er angivet. Når boksen "Slå kun til ved manuel kopiering" er markeret, vil handlingen blive sammenlignet fra standard udklipsholderen (eks. Ctrl+C).

Figur 4. Handlingsvindue

#### Regulært udtryk

Basale specielle tegn: "`.?+*(|)[]\`".

- ”`.`”: repræsenterer et enkelt tegn.
- ”`?+*`”: betyder henholdsvis nul eller et tegn, et tegn eller mere, og nul tegn eller mere.
- ”`(|)`”: bruges til gruppering og erstatning, den lodrette linje bruges som en ELLER operation.
- ”`[^]`”: bruges til at matche et tegn fra et sæt at tegne og specielle tegn, cirkumflex er brugt ved begyndelsen som argument.
- ”`\`”: undlader et specielt tegn.

Basis alfanumeriske tegnklasse: "`A-Za-z0-9`". Tegnklasser angives med klammer til at repræsentere et sæt af tegn.

##### Eksempler

- "`fejl ?#?[0-9]+`": text "fejl", nul eller et mellemrum, nul eller et skarpt tegn, og et eller flere tal.
- "`(http|ftp).+\.(jpg|png|gif)`": tekst "http" eller "ftp" et eller flere tegn, et punkt, og tekst "jpg", "png" eller "gif".
- "`http://.{120}[^ ]+`": tekst "http://", 120 tegn og et tegn eller flere undtagen et mellemrum.

##### Ekstern ressource

Tag et kig på

#### Kommando

En kommando kan genbruge en eller flere erstatninger fra de regulære udtryk. Erstatningerne er repræsenteret af ”`\<number>`” hvor <number> svarer til det undermønster inden i parentesen eller 0 for hele teksten.

For eksempel, fra det simple mønster ”`bug #(123)`” er det muligt at bruge ”`\0`” til teksten "bug #123" og ”`\1`”og til tekst "123". For kommandoen ”`exo-open http://host/\1`”, ville den rent faktiske udførte kommando være ”`exo-open http://host/123`”.

### Xfconf

Clipman bruger Xfconf til at gemme dens indstillinger. Dette lader dig ændre indstillingerne med værktøjet `xfconf-query` eller `xfce4-settings-editor`. Kanalen er `xfce4-panel` og basis egenskab er `/plugins/clipman`. Følgende tabel viser alle egenskaberne med deres mulige værdier:

Tabel 2. Xfconf-egenskaber

Egenskab | Type | Standard | Værdiet
--- | --- | --- | ---
/settings/add-primary-clipboard | boolsk | falsk | sandt for at synkronisere den primære udklipsholder med standardudklipsholderen
/settings/add-primary-clipboard | boolsk | falsk | sand for at slå handlinger til
/settings/history-ignore-primary-clipboard | boolsk | falsk | sand for at udelade den primære udklipsholder fra historikken
/settings/max-images-in-history | uint | 0 | 0-5 antal billeder i historikken
/settings/max-texts-in-history | uint | 10 | 5-100 antal tekster i historikken
/settings/save-on-quit | boolsk | sand | sand for at gendanne historikken ved hver ny session

Indtast følgende kommandolinje for at ændre en indstilling fra en terminal:

`xfconf-query -c xfce4-panel -p /plugins/clipman/<property> -s <value>`

## Support

For at rapportere en fejl eller anmode om en ny funktion, brug venligst fejlsøgningsystemet på http://bugzilla.xfce.org/. Spørg venligst på Xfce e-postlisteEller indstil din IRC-klient til irc.freenode.net, bliv medlem af kanalen #xfce og spørg efter hjælp, hvis du har spørgsmål til brugen af dette software.

## Om Clipman

Clipman er skrevet af Eduard Roccatello og derefter vedligeholdt af Nick Schermer. Nu til dags bliver det skrevet af Mike Massonnet (`<mmassonnet@xfce.org>`). Besøg Netsted for Clipman.

Denne dokumentation er skrevet af Mike Massonnet (`<mmassonnet@xfce.org>`) Send venligst alle dine kommentarer og forslag til denne manuel til `<mmassonnet@xfce.org>`.

Dette software er distribueret under vilkårene i GNU General Public License, som udgivet at Free Software Foundation, enten version 2 af licensen eller (dit valg) enhver senere version.

Du burde have fået en kopi af GNU General Public License sammen med dette program; hvis ikke, kan du skrive til Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA.