BerndPol &kdevelop; är en mycket kraftfull och flexibel integrerad utvecklingsmiljö, som erbjuder många möjligheter för anpassning enligt dina behov. För att göra inställningar, välj Inställningar Anpassa &kdevelop;.... Det gör att inställningsdialogrutan dyker upp, som består av ett fönster för att välja inställningar till vänster och inställningsdialogrutan till höger, vars innehåll varierar beroende på gruppen av inställningar du valt. Välj en grupp av inställningar Välj en grupp av inställningar Vi beskriver inställningarna i en annan ordning, uppdelat i huvudämnena Allmänna inställningar, Anpassa dokumentationen och Avancerade inställningar, vilket leder till en intuitivare läsupplevelse. Om du vill slå upp en viss grupp av inställningar direkt, använd en av följande länkar. Allmänt Användargränssnitt Filmallar Editor Förkortningar Skript Menyn Verktyg Externa verktyg Dokumentation Kodsnuttar Fillista Filväljare Skapa ny klass i C++ Formatering Tolkning av C++ Allmänna inställningar rör de vanligare aktiviteterna för att anpassa &kdevelop;, där det finns: Allmän inställning Välja användargränssnitt Välja en editor Välja stil för källkodsformatering Ställa in verktyget för kodsnuttar Anpassa filväljaren Inställningsdialogrutan Allmänt låter dig definiera grundläggande beteende hos &kdevelop; som sällan ändras under dagligt arbete. Det rör: Allmänna projektinställningar som definiera en standardprojektkatalog som &kdevelop; ska använda för nya projekt. bestämma om du vill att &kdevelop; automatiskt ska ladda projektet du senast arbetade med. Välja ett teckensnitt för de oftast använda utmatningsfönstren, nämligen: Meddelandeutmatningen som &kdevelop; använder för att visa t.ex. kompileringsprocesser, och Programutmatningen, som visar fel- och tillståndsinformation som rör ett program som kör. En del vanliga beteenden som rör rader som visas i fönstret Meddelandeutmatning, nämligen: om långa rader radbryts, och om meddelanden om katalogbyte som ges av make visas. Detaljnivån för meddelanden om kompileringsprocessen som visas i fönstret Meddelandeutmatning. Dialogrutan för allmänna inställningar Ladda senaste projekt vid start Markera den här kryssrutan om du vill fortsätta att arbeta med det senaste projektet du arbetade med. Det gör att &kdevelop; automatiskt laddar projektet vid start. Det visas oftast med samma tillstånd som du lämnade arbetet, så att du enkelt kan fortsätta. Standardprojektkatalog: Normalt använder &kdevelop; en gemensam överliggande katalog för alla nya projekt. Skriv in absolut sökväg till denna gemensamma katalog i rutan eller välj den i katalogstrukturen. &kdevelop; placerar alla nya projekt här som underkataloger. Du kan förstås ändra katalogsökvägen för ett nytt projekt när du ställer in det i Projektguiden. Fönsterteckensnitt Fönstret Programutmatning används för att visa fel- och tillståndsinformation från program som körs inne i &kdevelop;. Det är information som programmen oftast skickar till konsollen när de körs fristående. Alltså behöver du inte lämna den grafiska utvecklingsmiljön när du testar programmet du för närvarande arbetar med. För att välja ett lämpligt teckensnitt för fönstret Meddelandeutmatning, klicka på knappen Fönsterteckensnitt som visar teckensnittet som för närvarande är valt (det står Arial på bilden ovan). &kde;:s vanliga dialogruta Välj teckensnitt dyker upp, där du kan välja teckensnittet som ska användas. När &kdevelop; först startar initieras teckensnittsinställningen till det standardteckensnitt som &kde;-användaren har inställt. Den här inställningen är fast, så om du ändrar Inställningar Utseende och teman Teckensnitt i Inställningscentralen påverkas inte &kdevelop;s teckensnittsval. Du måste explicit välja ett nytt teckensnitt för fönstret Meddelandeutmatning. Kompilatorutmatning &kdevelop; förbehandlar meddelanden som fönstret Meddelandeutmatning visar under byggprocessen för att filtrera onödig information. Du kan styra detaljnivån som &kdevelop; visar med kombinationsrutan i det här fältet. Mycket kort Visa bara varningar, fel och filnamnen som kompileras. Kort Undertryck alla kompileringsflaggor, och ändra format till något mer läsbart. Fullständig Visa all utmatning utan förändring. Det finns ett alternativt sätt att ändra detaljnivå för kompilatorutmatning. Högerklicka bara i fönstret Meddelandeutmatning och välj motsvarande detaljnivå i menyn som dyker upp. Radbrytning Normalt radbryter &kdevelop; långa rader i fönstret Meddelandeutmatning så att värdefull information inte lätt förbises. Ibland kan detta skräpa ner långa meddelandelistor. Ta bort kryssmarkeringen om du inte vill att radbrytning ska ske. Det finns ett alternativt sätt att ändra radbrytningen. Högerklicka bara i fönstret Meddelandeutmatning och markera eller avmarkera alternativet Radbrytning i menyn som dyker upp. Meddelanden om katalogbyte Verktyget make visar oftast meddelanden som Entering directory eller Leaving directory när byte av arbetskatalog sker. Eftersom det här skräpar ner listan med meddelanden i fönstret Meddelandeutmatning undertrycker &kdevelop; normalt dessa meddelanden. Markera kryssrutan om du vill observera vilka kataloger som make arbetar i. Ändringar av inställningen påverkar bara behandling av nya meddelanden. Gamla katalogbytesmeddelanden förblir synliga när den här funktionen stängs av. Integrering med Designer för grafiskt gränssnitt Det här låter dig välja hur du vill att .ui-filer ska visas i &kdevelop;. &kdevelop; levereras med sin egen Designer för grafiska gränssnitt som heter KDevDesigner. Den kan antingen inbäddas eller köras som ett separat program. Qt Designer kan också användas för att redigera .ui-filer. Använd &kdevelop;s inbäddade Designer Använder &kdevelop;s egen Designer inbäddad i &kdevelop;. Kör &kdevelop; Designer som ett separat program Programmet KDevDesigner körs separat i ett eget fönster. KDevDesigner i eget fönster Kör Qt Designer Qt-Designer från installationen av Qt kommer att startas externt, när du klickar på en .ui-fil i &kdevelop;. Terminalemulering Här väljer du vilken terminal du vill ska integreras i KDevelop. Använd &kde;-inställning Använder &kde;:s inställning som anges i Inställningscentralen under fliken &kde;-komponenterKomponentväljare, som anger vilket terminalprogram som används av alla &kde;-program som behöver en terminal. Annan: Välj någon annan terminal som skiljer sig från den förvalda. användargränssnitt byta läge byta gränssnittsläget Som redan nämnts i kapitlet Tillgängliga lägen för användargränssnitt finns det fem olika sätt som &kdevelop;s arbetsområde kan ställas in, nämligen: Förenklat IDEA-fönsterläge Det här är en förenklad version av IDEA-användargränssnittet. Det är konstruerat för att vara enkelt och rent. Det använder inte heller dockade verktygsvyer. IDEA-fönsterläge Det här är en klon av IDEA-användargränssnittet som liknar fliksidläge, och är förvalt läge. Underramsläge Alla verktygsvyer är dockade i huvudramen från början. Editorn och bläddringsvyer existerar som toppnivåfönster inne i huvudramens vyområde. Ett typiskt exempel på detta användargränssnitt är MS Visual Studio 6.0. Fliksidläge Alla verktygsvyer är dockade i huvudramen från början. Editorn och bläddringsvyer läggs ovanpå varandra i ett flikfönster. Ett typiskt exempel på detta användargränssnitt är KDEStudio, en annan C++ integrerad utvecklingsmiljö i KDE-världen. Toppnivåläge Alla editorvyer, bläddringsvyer och verktygsvyer är toppnivåfönster (direkt på skrivbordet). Huvudkomponenten innehåller bara menyn, verktygsrader och statusraden. Ett typiskt exempel på detta användargränssnitt är Borland Delphi 6.0. För att byta användargränssnittets läge välj Inställningar Anpassa &kdevelop;... i menyraden. Dialogrutan Anpassa KDevelop dyker upp, där du ska välja Användargränssnitt i trädet till vänster. Då visas följande inställningsdialogruta till höger: Välj ett användargränssnittsläge Välj ett användargränssnittsläge Markera alternativknappen för gränssnittsläget du vill byta till, och klicka därefter på Ok. Glöm inte att starta om &kdevelop; för att alla dessa val ska få effekt. Om du antingen valt Förenklat IDEA-fönsterläge, IDEA-fönsterläge eller Fliksidläge blir ytterligare två inställningsrutor tillgängliga: Använd flikar och Använd stäng när musen hålls stilla. De gör det möjligt att anpassa under vilka omständigheter flikar visas ovanför dokumentfönster, och om du kan stänga dokument med ett klick på flikens ikon. I Förenklat IDEA-fönsterläge och IDEA-fönsterläge finns ännu en inställningsruta tillgänglig, Fliklayout för verktygsvy som låter dig välja mellan olika storlekar hos flikarna för verktygsvyer som omger huvudarbetsytan i dessa lägen. Anpassa visningen av flikraden för dokumentation Med IDEA-fönsterläge och fliksidläge finns det normalt namngivna flikar ovanför dokumentfönstren, så att du enkelt kan välja olika dokument med ett vänsterklick. Om du föredrar att ge mer utrymme till dokumentfönstren på huvudarbetsytan i &kdevelop;, kan du byta till ett annat beteende i inställningsrutan Använd flikar. Alltid Det här är standardvärdet: Visa en flik som består av en ikon och dokumentnamnet ovanför varje dokumentfönster på huvudytan av skärmen i &kdevelop;. Vid mer än en Visa inte en flik när bara ett dokument är öppet. Om mer än ett dokument är öppet, visar &kdevelop; dock en flikrad som motsvarar valet Alltid ovan. Du kan vilja använda det här läget om du oftast arbetar med ett enda dokument, eftersom läget tillhandahåller ett större vertikalt utrymme. Aldrig Visa aldrig en flikrad för att välja dokument. Du kanske föredrar det här läget om du sällan använder musen för att byta mellan dokument. Det tillhandahåller ett större vertikalt utrymme för alla dokumentfönster. Använd menyn Fönster i &kdevelop; för att välja ett annat dokumentfönster eller stänga något. Ställa in att stänga ett dokument genom att klicka på dess flik När du anpassar &kdevelop; att visa flikraden för dokument, antingen alltid eller när mer än ett dokument är öppet på huvudarbetsytan, kan du lägga till ytterligare en funktion till flikarna förutom möjligheten att välja dokument. Använd inställningsrutan Använd stäng när musen hålls stilla för detta. Nej Det här är standardbeteendet. Ingen extra funktion läggs till för flikarna. De kan bara användas för att välja dokumentfönster med vänsterklick. Ja När du markerar den här alternativknappen, låter &kdevelop; dig stänga ett dokumentfönster med ett vänsterklick. Använd musen för att peka på den lilla ikonen till vänster i flikraden. Den ändras till en stängningssymbol. Klicka nu med vänsterknappen på den ändrade symbolen, så stänger &kdevelop; motsvarande dokumentfönster. Ja, fördröjd När den här alternativknappen är markerad, låter &kdevelop; dig stänga ett dokumentfönster som beskrivits för fallet Ja ovan. Ikonen ändras dock inte omedelbart, utan det blir en kort fördröjning innan stängningsikonen dyker upp. Anpassa fliklayout för verktygsvyn Inställningsrutan Fliklayout för verktygsvy är bara tillgänglig i IDEA-fönsterläge. Använd alternativknapparna för att ställa in utseendet för verktygsvyernas flikar som omger huvudarbetsytan i detta läge. Ikoner Varje flik visar bara en ikon. Om motsvarande verktygsvy visas, öppnas fliken och en beskrivande text för verktygsvyn visas. Du kan vilja använda det här läget om du arbetar med en bildskärm med begränsad upplösning. Ikonerna är dock inte särskilt beskrivande. Om du vill ta reda på vilken verktygsvy som hör ihop med en given flik, peka på den med musen och vänta en sekund. Ett kort verktygstips dyker då upp med verktygsvyns namn. Text Det här är standardläget för visning av verktygsvyernas flikar. Varje flik visar namnet på tillhörande verktygsvy. Text och ikoner Om du tycker att den vanliga visningen av text för verktygsvyerna verkar för trist, och du arbetar på en bildskärm med hög upplösning, kan du vilja markera den här alternativknappen. Den gör att namnet för motsvarande verktygsvy visas på varje flik med en ikon till vänster om det, vilket gör det enklare att skilja på flikarna. Ett exempel visas på illustrationen Radbrytning av verktygsvyernas flikar nedan. Radbrytning av verktygsvyernas flikar Om du valde att låta IDEA-fönsterlägets flikar för verktygsvyer visa text (med eller utan tillhörande ikoner) behöver du inte oroa dig för att de döljs bakom något verktygsvyfönster. Om ett av de nedre verktygsvyfönstren upptar mer utrymme än vad som är tillgängligt för att visa alla (vertikala) flikar, radbryts de som illustrationen visar: Verktygsvyernas flikar radbryts för att inte döljas bakom ett annat fönster som visas Verktygsvyernas flikar radbryts för att inte döljas bakom ett annat fönster som visas Det aktiva verktygsvyfönstret måste visas fast (utan överlappning), och dela arbetsytan med andra fönster, för att tvinga fram en sådan radbrytning av flikar. Klicka på den lilla fyrkanten i fönsterramen för att åstadkomma läget som visas i exemplet. Anpassa filmallar Anpassa filmallar &kdevelop; låter dig välja ditt favoritverktyg för textredigering. Markera raden Editor i trädet till vänster i fönstret Anpassa KDevelop. Följande dialogruta visas till höger: Välja en editor Välja en editor För att välja en ny editor, klicka på pilen i kombinationsrutan. Beroende på gränssnitten för redigeringsdelprogram som &kde;-versionen har kompilerats med, ser du en lista med editorer som du kan välja bland (se den viktiga anmärkningen nedan om detta). Klicka på editorn som du vill ha och klicka på Ok. För närvarande finns två möjligheter: Inbyggd avancerad texteditor Det här är &kde;:s vanliga Kate redigeringsdelprogram. Qt Designer-baserad texteditor Det här är editorn som &Qt; tillhandahåller i sin Designer-komponent. Dessa redigeringsgränssnitt är fullständigt integrerade med &kdevelop;s integrerade utvecklingsmiljö. I synnerhet tillhandahålls möjligheten att hoppa till källkodsraden som orsakat ett fel genom att bara klicka på felmeddelandet i fönstret Meddelandeutmatning. Att byta editor påverkar inte filer som redan är öppna. Det finns två sätt att fortsätta. Stäng antingen alla öppna textfönster och öppna dem igen ett i taget. Eller stäng helt enkelt hela projektet och öppna det igen. Fönstren öppnas då automatiskt med det nya texteditorgränssnittet. KDevelop låter dig använda editorgränssnitt som har registrerats med &kde; och som tillhandahåller ett KatePart-gränssnitt. Om du saknar en av möjligheterna som visas ovan, kontrollera i din &kde;-installation om motsvarande KPart installerats på ett riktigt sätt. Vad som ska göras om filen har ändrats externt: Gör ingenting Filen markeras som ändrad externt, och användaren blir tillfrågad om att bekräfta alla försök att skriva över den. Underrätta användaren En dialogruta underrättar användaren att filen har ändrats, och erbjuder användaren att uppdatera filen. Ladda om filen automatiskt om det är säkert, underrätta annars användaren Alla filer som inte är ändrade i minnet, uppdateras och en varning visas vid eventuella konflikter. (... ännu inte skrivet ...) (... ännu inte skrivet ...) (... ännu inte skrivet ...) (... ännu inte skrivet ...) (... ännu inte skrivet ...) (... ännu inte skrivet ...) (... ännu inte skrivet ...) &kdevelop; formaterar automatiskt källkodstext med en fördefinierad stil. Stilen är mycket anpassningsbar. Funktionen för att formatera om källkod är för närvarande bara tillgänglig för C, C++ och &Java;. I synnerhet kan du inte använda den för skriptspråk som t.ex. PHP. Det beror på att &kdevelop; använder programmet astyle för att implementera funktionen. För att ställa in en specifik formateringsstil, välj Inställningar Anpassa &kdevelop;... i menyraden. Dialogrutan Anpassa KDevelop dyker upp, där du ska välja Formatering av källkod i trädet till vänster. Då visas en serie av tre flikar med inställningar till höger, benämnda Allmän, Indentering och Annan. Alla stiländringar gäller bara för nyinmatad text. Om du vill ändra formateringsstil för en befintlig källkodstext måste du uttryckligen använda kommandot Redigera Formatera om källkod. Det exakta resultatet av dessa definitioner av formateringsstil beror på editorn du använder. För närvarande är de flesta inställningar anpassade för redigeringsdelprogrammet Kate (Inbäddningsbar avancerad texteditor). Vissa andra editorer (t.ex. Qt-editorn) kan bero på sina egna formateringsinställningar. I dessa fall måste du experimentera för att ta reda på exakta effekterna av stilinställningarna som tillhandahålls här. Det kan finnas oförenligheter mellan inställning av stilar som tillhandahålls här och editorn du använder, i sådan utsträckning att det i extrema fall till och med kan förstöra dina filer. Försäkra dig om att du har en säkerhetskopia av dina källkodsfiler innan du provar inställningarna med en editor som inte är standard i &kde;. Fliken Allmänt i dialogrutan Formatering av källkod låter dig välja en av fem fördefinierade formateringsstilar för källkod. Allmän inställning av formateringsstil för källkod Allmän inställning av formateringsstil för källkod Ett exempel på formaterad källkod visas i fältet till höger. Om du inte tycker om någon av de fördefinierade stilarna kan du klicka på den översta alternativknappen Användardefinierad, och definiera en egen formateringsstil för källkod du föredrar under de övriga två flikarna som då blir tillgängliga. För närvarande illustreras bara de fördefinierade formateringsstilarna för källkod med en exempeltext. Om du bestämmer dig för att definiera din egen stil, finns ingen visning av exempel tillgänglig. Du måste experimentera med verklig källkodstext för att skräddarsy inställningarna som du vill ha dem. Lämplig indentering är det huvudsakliga sättet att öka läsbarhet för källkodstext. Om du väljer fliken Indentering i dialogrutan Formatering av källkod visas en serie med formateringsval för indentering grupperade i följande tre rutor: Inställning av indenteringsstil för källkod Inställning av indenteringsstil för källkod Förvalda inställningar Fördefinierade formateringsval gör att källkodstexten liknar formateringsstilen enligt ANSI: namespace foospace { int Foo() { if (isBar) { bar(); return 1; } else return 0; } } Definiera indenteringsbredd och tecken Alternativknapparna grupperade under Utfyllnad anger hur indentering av källkodstexten visas. Använd flikar Det här gör att editorn infogar ett tabulatortecken för varje indenteringsnivå. Tabulatorbredden är fördefinierad i editorns inställningar (oftast kolumner om 8 eller 4 tecken). Använd Inställningar Anpassa editor... för att definiera om den. Proceduren för att definiera verklig tabulatorbredd beror på editorn du valt under inställningssteget Välja en editor. Du måste slå upp motsvarande editors hjälp för att ta reda på den. Använd mellanslag Om du markerar alternativknappen, lägger editorn till det antalet mellanslag för varje indenteringsnivå. Ändra värdet från normalvärdet 2 till indenteringsbredden du föredrar. Indentera objekt Det här anger vilka (av C/C++) konstruktioner som formateras med en extra indentering från den aktuella indenteringsnivån. Normalt används bara extra indentering för namnrymder och etiketter. Du kanske vill experimentera med olika inställningar för att anpassa extra indenteringar som du vill ha dem. Fortsättning Inställningarna som är grupperade här gäller de fall när källkodsformateringen automatiskt radbryter långa källkodsrader. De tar hänsyn till två specialfall, nämligen att det ska finnas tillräckligt med utrymme för källkoden för djupa indenteringsnivåer och att villkor ska få extra indentering för fortsättningsrader så att de utmärks på ett riktigt sätt. Det här gäller bara för fall med statisk radbrytning när en fast maximal radlängd används i källkodstexten. Om du ställer in editorn för att bara dynamiskt radbryta långa rader vid visning (som är möjligt i redigeringsdelprogrammet &kate;) visas oftast inte effekten av de här inställningarna. Maximum i sats Den här inställningen begränsar maximal möjlig indentering av fortsättningsrader så att det finns tillräckligt med utrymme för att texten ska förbli läsbar. Inga fortsättningsrader indenteras någonsin förbi kolumnantalet som du väljer i det här fältet. Standardinställningen är 40 kolumner (en halv standardsida på 80 kolumner). Du kan vilja öka det här värdet för att hantera bredare papper (t.ex. om du använder utskrift av källkod på liggande format). Eller minska värdet på motsvarande sätt för att ta hänsyn till större marginalinställningar för dina utskrifter. Minimum i villkor Villkor eller källkod som till exempel följer en tilldelningsoperator ska ofta få en extra indentering för fortsättningsrader för att göra texten läsbar. Värdet på den extra indenteringen definieras här. Standardvärdet är Två gånger nuvarande, vilket betyder att fortsatta villkor får en extra indenteringsnivå jämfört med indenteringsstorleken du valt i gruppen Utfyllnad. Du kan ändra den extra indenteringen till ett annat fast värde (inklusive noll) med pilarna, eller genom att direkt skriva in värdet. Annan inställning av formateringsstil för källkod Annan inställning av formateringsstil för källkod Styra positionen av hakparenteser Alternativknapparna i (den något felaktigt benämnda) gruppen Hakparenteser styr positionen av klamrar som avdelar (C/C++) källkodstext. Det finns tre möjligheter att välja bland. Bryt Det här infogar en radbrytning innan varje inledande klammer. Båda avdelande klamrar i alla block placeras på samma indenteringsnivå som blockets huvudsats. namespace foospace { int Foo() { if (isBar) { bar(); return 1; } else return 0; } } Bifoga Det här behåller inledande klammern i ett block på samma nivå som blockets huvudsats. Avslutande klamrar är på samma indenteringsnivå som blockets huvudsats. Det avslutande else i en if-sats hålls på samma nivå som avslutande klammer i föregående block. namespace foospace { int Foo() { if (isBar) { bar(); return 1; } else return 0; } } Linuxstil Det här är en kompromiss mellan stilarna som anges ovan. Avgränsande klamrar för funktionsblock placeras på nya rader. Klamrar som inleder ett block i en villkorssats eller snurra behålls på samma rad. namespace foospace { int Foo() { if (isBar) { bar(); return 1; } else return 0; } } Styra extra mellanslag Normalt minimerar &kdevelop; användning av mellanslag i källkodstext. if (isBar(fooArg)==barValue) Du kan öka läsbarheten om du tvingar källkodsformateringen att infoga extra mellanslag på särskilda platser. Lägg till mellanslag omkring parenteser Vad som i själva verket avses är att lägga till mellanslag omkring text som är inom parenteser. Det ökar läsbarheten för funktionsargument och villkor. if ( isBar( fooArg )==barValue ) Lägg till mellanslag omkring operatorer Det här lägger till mellanslag omkring tilldelningar och jämförelseoperatorer för att öka läsbarheten. if (isBar(fooArg) == barValue) Styra formatering av enradskonstruktioner Det finns några få tillfällen då du inte vill att källkodsformateringen ska dela en lång rad. Detta kan styras här för C/C++ kod. Behåll enradssatser Det här behåller enradssatser tillsammans i vissa situationer även om de överskrider en fast maximal radlängd. Behåll enradsblock Det här behåller enradsblock tillsammans i vissa situationer även om de överskrider en fast maximal radlängd. När du redigerar i &kdevelop; kan du lagra delar av kod som ofta används som kodsnuttar. För att anpassa funktionerna hos delprogrammet för kodsnuttar, välj Inställningar Anpassa &kdevelop;... i menyraden. Dialogrutan Anpassa KDevelop dyker upp, där du ska välja Kodsnuttar i trädet till vänster. Då visas följande dialogruta till höger: Anpassa verktyget för kodsnuttar Anpassa verktyget för kodsnuttar Aktivera förhandsgranskning av kodsnuttar Markera kryssrutan Visa kodsnuttens text i verktygstips om du vill visa den lagrade texten i ett verktygstipsfönster så fort du håller musmarkören över den kodsnuttens rubrik. Arbeta med variabler i kodsnuttar Verktyget Kodsnuttar tillåter varierande text på fördefinierade platser när som helst när du infogar en kodsnutt i en fil. För att åstadkomma det, tillhandahåller Kodsnuttar sin egen variabelmekanism. Du kan ställa in dess beteende i gruppen Variabler. Avskiljare Verktyget Kodsnuttar känner igen variabler i texten genom att omge variabelnamnet med särskilda skiljetecken. För att använda ett eget skiljetecken, ändra det fördefinierade tecknet $ i fältet Avskiljare. Inmatningsmetod för variabler En dialogruta för varje variabel i en kodsnutt visar i tur och ordning en särskild dialogruta för varje variabel som verktyget hittar när den valda kodsnutten infogas. En dialogruta för alla variabler i en kodsnutt visar en gemensam dialogruta där användaren måste fylla i värden för alla variabler innan kodsnutten infogas. (... ännu inte skrivet ...) &kdevelop; tillhandahåller insticksprogrammet Filväljare som när det laddas vid start, gör det möjligt att navigera till vilken fil eller katalog som helst på systemet. Filväljaren (i IDEA-läge) Filväljaren (IDEA-läge) Beteendet hos Filväljaren kan anpassas i stor utsträckning. Välj Inställningar Anpassa &kdevelop;... i menyraden. Dialogrutan Anpassa KDevelop dyker upp, där du ska välja Filväljare i trädet till vänster. Då visas följande dialogruta till höger. Anpassa filväljaren Anpassa filväljaren Anpassa verktygsraden Det finns en verktygsrad längst upp i Filväljaren som kan anpassas som vanligt i gruppen Verktygsrad. Markera ett objekt till listan till höger Aktuella åtgärder, som den nya åtgärden ska infogas efter. Markera åtgärden som ska infogas i listan till vänster Tillgängliga åtgärder. Klicka på (den övre) högerpilen mellan de båda listorna. Åtgärden tas bort från listan Tillgängliga åtgärder och infogas i listan Aktuella åtgärder under den markerade åtgärden. Markera åtgärden som ska tas bort i listan till höger Aktuella åtgärder. Klicka på (den nedre) vänsterpilen mellan de båda listorna. Den markerade åtgärden tas bort från listan Aktuella åtgärder och läggs tillbaka i listan Tillgängliga åtgärder. Markera åtgärden som ska flyttas i listan till höger Aktuella åtgärder. Klicka på uppåt- eller neråtpilen till höger om listan. Den markerade åtgärden flyttas upp eller ner i listan Aktuella åtgärder. Definiera när innehållet ska ändras Att uppdatera innehållet i fönstret Filväljare tar tid och resurser, särskilt vid byte till en annan katalog. Därför är Filväljaren normalt inställd på så sätt att dess innehåll bara ändras på begäran, dvs. när du väljer en annan katalog eller när du uttryckligen vill uppdatera innehållet. Klicka på knappen Uppdatera i verktygsraden för att uppdatera innehållet i Filväljaren. Den här verktygsradsknappen är dock inte normalt tillgänglig. Du måste först lägga till den där. Du kan ställa in Filväljaren att omedelbart visa vissa ändringar i ditt arbete. Inställningarna i gruppen Automatisk synkronisering är ansvariga för detta. När ett dokument aktiveras Om du markerar den här kryssrutan, uppdateras innehållet i Filväljarens fönster så fort du går till ett annat dokument som redan är öppnat, t.ex. när du klickar på fliken för motsvarande redigeringsfönster i IDEA-läge. Om det behövs byter Filväljaren till katalogen som filen tillhör och uppdaterar skärmen för att visa det verkliga innehållet där. När ett dokument öppnas Om du markerar den här kryssrutan, uppdateras innehållet i Filväljarens fönster så fort ett dokument öppnas, t.ex. via menyn Arkiv Öppna. Om det behövs byter Filväljaren till katalogen som filen tillhör och uppdaterar skärmen för att visa det verkliga innehållet där. När filväljaren blir synlig Om du markerar den här kryssrutan uppdateras Filväljarens fönster så fort det blir synligt igen. Om det behövs byter det till katalogen som aktuellt dokument tillhör och uppdatera skärmen så att det verkliga innehållet där visas. Du kan kombinera inställningarna fritt för att skräddarsy verkligt beteende hos Filväljaren som du vill. Styra historiken i kombinationsrutorna Det finns två kombinationsrutor längst upp och längst ner i Filväljarens innehållsfönster som styr katalogen som visas (den övre kombinationsrutan) och filter som används för visningen (den nedre kombinationsrutan). En historik av de senaste inställningarna finns i urvalsfältet i varje kombinationsruta. Du kan ställa in antalet historikposter enligt följande. Kom ihåg platser Skriv in maximalt antal katalogval som den övre kombinationsrutan ska komma ihåg här. Kom ihåg filter Skriv in maximalt antal filterdefinitioner som den nedre kombinationsrutan ska komma ihåg här. Styra vad som ska kommas ihåg mellan sessioner Normalt är Filväljaren inställd så att den visar den senaste sessionen igen när &kdevelop; startas nästa gång. Du kan ändra beteendet i inställningsgruppen Session. Om &kdevelop; automatiskt startades om av &kde;:s sessionshantering, så har ändringar av dessa inställningar ingen effekt. I detta fall återställs alltid plats- och filterinställningar från den senaste &kde;-sessionen. Återställ plats Ta bort kryssmarkeringen här om du inte vill att platser som visas ska kommas ihåg mellan sessioner. Om du markerad en av inställningarna för automatisk uppdatering kan platserna som visas automatiskt ändras oberoende av vad som har kommits ihåg från den tidigare sessionen. Återställ senaste filter Ta bort kryssmarkeringen här om du inte vill att filter som används för visningen ska kommas ihåg mellan sessioner. (... ännu inte skrivet ...) (... ännu inte skrivet ...) (... ännu inte skrivet ...) &kdevelop; innehåller en mycket kraftfull dokumentationsfunktion som tillhandahåller möjlighet att komma åt flera olika sorters omfattande dokumentation. I IDEA-läge hittar du till exempel fliken Dokumentation vid arbetsområdets högerkant. Dokumentationsträdet i &kdevelop; (i IDEA-läge) Dokumentationsträdet i &kdevelop; (IDEA-läge) &kdevelop; måste ha laddat insticksprogrammet Dokumentation för att kunna visa dokumentationsträdet. Se avsnittet Insticksverktyg för mer information. Du kan ställa in innehållet i dokumentationsträdet om du väljer Inställningar Anpassa &kdevelop;... i menyraden. Dialogrutan Anpassa KDevelop dyker upp, där du ska välja Dokumentation i fönstret till vänster. Inställningssidan som visas på så sätt, har tre inställningsdialogsidor med flikar, närmare bestämt: Dokumentationssamlingar Fulltextsökning Annat Anpassningen av dokumentationsinställningarna har delats upp i en serie dokumentationssamlingar, där var och en ger åtkomst till dokumentationsfiler av något unikt format och någon typ av innehåll. Inställningarna styr vilka dokumentationsposter som listas på sidan Innehåll under funktionen Dokumentation i &kdevelop;, och hur användaren kan komma åt detaljer i dokumentationen med indexerade sökningar och fulltextsökningar. Fliken Dokumentation tillhandahåller en serie inställningssidor som är ordnade vertikalt som en hög med indexkort. En sida i taget visas efter ett klick på titeln för dess indexkort: &Qt;-dokumentationssamling CHM-dokumentationssamling Doxygen-dokumentationssamling &kdevelop; innehållsförteckning-dokumentationssamling DevHelp-dokumentationssamling Egen dokumentationssamling Ställa in dokumentationssamlingar Ställa in dokumentationssamlingar Alla inställningssidor under fliken Dokumentation använder en gemensam layout. Du hittar dokumentationsposter som för närvarande är tillgängliga, av typen som listas på den öppna sidan, till vänster och en uppsättning knappar till höger. Knappar för att underhålla innehåll i dokumentationlistan Det finns tre knappar tillgängliga för att underhålla innehållet på inställningssidorna för dokumentation: Lägg till Visar dialogrutan Egenskaper för dokumentationskatalog som visas nedan, där du kan välja källan för dokumentationsposten som ska läggas till och namnge den. Redigera Visar dialogrutan Egenskaper för dokumentationskatalog som visas nedan, där du kan ändra källan för dokumentationsposten tidigare markerad i listan och byta namn på den. Ta bort Tar bort markerad dokumentationspost från listan. Posten tas bara bort från listan. De verkliga källorna till dokumentationen förblir orörda. Du måste ta bort dem explicit på annat sätt. Lägga till eller ändra en dokumentationspost Knappen till höger om fältet Plats visar en katalogdialogruta vars poster oftast är filtrerade enligt den valda inställningssidans filtyp. Fältet Titel kanske inte går att komma åt, beroende på dokumentationstypen som underhålls. Dokumentationslistans struktur Varje inställningssida för dokumentation visar listade dokumentationsposter i en tabell med fyra kolumner: Innehållsförteckning Om kryssrutan är markerad, visas dokumentationsposten på sidan Innehåll under funktionen Dokumentation i &kdevelop;. Genom att avmarkera kryssrutan Innehållsförteckning inaktiverar i sin tur kryssrutorna Index och Sök (se nedan). Alltså kan du inte ha poster i dokumentationssamlingen indexerade utan att visa deras innehåll. Index Om kryssrutan är markerad byggs ett internt index för dokumentationsposten. Det ger snabb åtkomst till dokumentationen genom att använda sidan Index och (valfritt) Sökning under funktionen Dokumentation i &kdevelop;. Det interna indexet byggs första gången användaren väljer sidan Index. Det fördröjer den första åtkomsten väsentligt, eftersom indexet läses från disk och lagras i en cache. Alla efterföljande indexsökningar använder dock cachen och är därför väsentligt snabbare. Sök Om kryssrutan är markerad, inkluderas innehållet i dokumentationsposten i den sökvägen för fulltextsökning på sidan Sök under funktionen Dokumentation i &kdevelop;. &kdevelop; utnyttjar programsamlingen htdig för att utföra fulltextsökningar. Sökningen görs i ett internt index, som htdig-maskineriet måste bygga innan den kan användas. Alla ändringar av kryssrutorna under Sök påverkar alltså bara sökningar efter att du har byggt om indexet på sidan Sök under funktionen Dokumentation i &kdevelop;. Titel Det här är namnet på dokumentationsposten som den visas på sidan Innehåll under funktionen Dokumentation i &kdevelop;. Tidigare versioner av &kdevelop; tillät att dokumentationsposterna visades baserat på varje projekt. Det är inte längre tillgängligt. På den här inställningssidan anpassas all &Qt;-dokumentation. Ställa in &Qt;-dokumentationssamlingen Ställa in &Qt;-dokumentationssamlingen Normalt fyller &kdevelop; i detta vid första start. Det tittar efter vanliga *.xml, eller *.dcf dokumentationsfiler i &Qt;-installationskatalogen. Tabellen till vänster listar filerna som &kdevelop; hittade med deras vanliga titlar. Om du har en installation som inte följer standard, finns det antingen ingen information listad alls, eller kanske adresserna pekar på felaktiga platser (t.ex. på en annan installation av &Qt; som är tillgänglig på systemet). Du kan justera posterna med knapparna till höger om listfältet. &kdevelop; använder titlar som redan tillhandahålls av den installerade &Qt;-dokumentationen. Därför är inte fältet Titel i dialogrutan Egenskaper för dokumentationskatalog åtkomligt. Normalt visas inte all &Qt;-dokumentation på sidan Innehåll under funktionen Dokumentation i &kdevelop;. Använd kryssrutan Innehållsförteckning i inställningstabellen för att välja vilken dokumentation som ska visas. Om du vill att viss specifik &Qt;-dokumentation ska inkluderas i sökindex eller fulltextsökning, använd kryssrutorna Index och Sök i inställningstabellerna. På den här inställningssidan kan du samla dokumentation enligt &Microsoft; CHM-hjälpfilstandard. Ställa in &Microsoft; CHM-standarddokumentationsfiler Ställa in &Microsoft; CHM-standarddokumentationsfiler Normalt är inställningssidan tom (som visas ovan). Du kan lägga till nya poster med knapparna till höger om listan. &kdevelop; filtrerar *.chm-filer i katalogdialogrutan som hör ihop med knapparna Lägg till och Redigera. För mer information om formatet för &Microsoft; *.chm-filer, se t.ex. "PHP: Documentation - Extended CHM Format" på http://de2.php.net/docs-echm.php. På den här inställningssidan anpassas all dokumentation av programmeringsgränssnitt som skapats av &doxygen;. Ställa in dokumentationen av programmeringsgränssnitt skapat av Doxygen Ställa in dokumentationen av programmeringsgränssnitt skapat av Doxygen I kortet dokumenterar ett sådant programmeringsgränssnitt gränssnittet för vissa biblioteksfunktioner. Dokumentationen av programmeringsgränssnittet på den här sidan ska skapas av det externa verktyget &doxygen;. Dokumentation av programmeringsgränssnitt skapad av &doxygen; består av en serie html-filer, som börjar med index.html. Dessutom kan det finnas tag-filer, som innehåller information med länkar till befintlig dokumentation av programmeringsgränssnitt. Alltså tittar &kdevelop; efter index.html och *.tag-filer vid sökning efter dokumentation av programmeringsgränssnitt skapad av &doxygen;. Vissa begränsningar i strukturen antas vid sökning efter dokumentation av programmeringsgränssnitt skapad av &doxygen;. Katalogen där filen index.html finns ska innehålla underkataloger med separata dokumentationssamlingar. Var och en av underkatalogerna antas innehålla en .tag-fil och en underkatalog vid namn html/. Du kan ta en titt på $KDEDIR/share/doc/HTML/en/kdelibs-apidocs där det finns ett exempel på en sådan layout för dokumentation av programmeringsgränssnitt med &doxygen;. &kde;:s äldre dokumentation av programmeringsgränssnitt skapat med KDoc stöds inte direkt längre. Om du fortfarande vill använda sådan dokumentation, kan du lägga till den på sidan Egen dokumentationssamling. &kdevelop; har fyllt i en länk till aktuellt programmeringsgränssnitt för &kde;-biblioteket, under förutsättning att någon hittades. Det finns flera sätt för &kdevelop; att få reda på den: Antingen angav du väljaren --with-kdelibsdoxy-dir till kommandot configure när du kompilerade &kdevelop; (se kapitlet Hur man skaffar dokumentation av programmeringsgränssnittet för &kdevelop;). Eller hittade kommandot configure automatiskt ett programmeringsgränssnitt för &kde;-biblioteken som skapats med &doxygen; på en av flera standardplatser som det känner till. Eller som en sista utväg hittades $KDEDIR/share/doc/HTML/en/kdelibs-apidocs/ när &kdevelop; först startade. Om &kdevelop; inte hittade ett giltigt programmeringsgränssnitt för &kde;-biblioteken som skapats med &doxygen; vid första start, är listan Dokumentation skapad av Doxygen tom. Du kan lägga till dina egna poster med dokumentation av programmeringsgränssnitt (t.ex. från dina nuvarande projekt) genom att använda knapparna till höger. Om du vill att de ska inkluderas i indexerad sökning och/eller fulltextsökning, markera kryssrutorna Index eller Sök i inställningstabellen. &kdevelop; använder titelinformationen från index.html. Därför är inte fältet Titel i dialogrutan Egenskaper för dokumentationskatalog åtkomligt. &kde;-systemet tillhandahåller mer dokumentation av programmeringsgränssnittet än bara &kde;-bibliotekens programmeringsgränssnitt. Du behöver ytterligare information om gränssnitt om du t.ex. vill inkludera &kate;-delprogrammet i dina program. För &kate;-delprogrammet ska du till exempel kompilera och installera &kde;:s programmeringsgränssnitt för basbiblioteken från källkoden (genom att använda kommandona make apidox och make install för källkoden i kdebase) och därefter lägga till en post i listan Dokumentation skapad av Doxygen på detta sätt: Lägga till ett basprogrammeringsgränssnitt för &kde; i listan Lägga till ett basprogrammeringsgränssnitt för &kde; i listan (Du ska förstås ersätta exempelkatalogen /opt/kde-cvs/ i fältet Plats med sökvägen till din &kde;-installation.) Du måste också lägga till programmeringsgränssnittet för ditt nuvarande projekt i Doxygen-dokumentationssamling. Tidigare versioner av &kdevelop; lade till det i dokumentationsträdet baserat på varje projekt. Det är inte längre tillgängligt. Huvuddelen av &kdevelop;s dokumentationsfunktion tillhandahåller omedelbar åtkomst av strukturerad dokumentation, både lokal och fjärrdokument. Du kan ställa in det på sidan KDevelop-innehållsdokumentation. Tillhandahålla dokumentationsåtkomst strukturerad med KDevelop innehållsförteckning &kdevelop; levereras med en samling fördefinierade KDevelop innehållsförteckningsfiler som automatiskt läggs till i tabellen vid installation. För att hålla visningen hanterbar, är bara de oftast använda markerade för att visas. Om du vill se annan dokumentation, markera kryssrutan Innehållsförteckning i inställningstabellen. KDevelop innehållsförteckningsfiler kan inte indexeras för att utföra fulltextsökning eftersom de oftast pekar på fjärrplatser. Å andra sidan, kan en sådan .toc-fil ha ett manuellt definierat index, med taggen <index>. Alltså aktiveras kryssrutan index bara när &kdevelop; hittar taggen <index> i .toc-filen. (För mer information, se beskrivningen nedan i avsnittet om &kdevelop; innehållsförteckningsfiler.) Kryssrutan Sök i inställningstabellen är alltid inaktiv. Du kan lägga till nya poster med knapparna till höger om listan. &kdevelop; filtrerar *.toc-filer i katalogdialogrutan som hör ihop med knapparna Lägg till och Redigera. I motsats till tidigare versioner av &kdevelop;, så ändrar inte knappen Ta bort *.toc-filerna på disk, så borttagningsåtgärden är nu säker. Det finns en särskild funktion som hör ihop med detta. Som illustration, utför följande steg: Hitta en post strax under dokumentationen för &Qt; och &kde; (t.ex. KDE2 Development Book (kde.org)). Klicka på plustecknet intill den. Ett träd visas, där du snabbt kan navigera till efterföljande kapitel som finns på en hierarkisk nivå flera nivåer djupare, allt utan att vara uppkopplad. Men om du till sist väljer ett av kapitlen, försöker &kdevelop; i många fall komma åt en fjärrfil med dokumentation. Den logiska grunden för detta är inte bara att lokalt kunna navigera i fjärrdokumentation utan att slösa med nätverksresurser, utan också att ge utvecklare en enkel strukturerad åtkomst till dokumentation som behövs. Med verktygen som tillhandahålls här kan man komma åt nästan vilken lokal eller fjärrdokumentation som helst på ett strukturerat sätt, även om originalet är utan struktur eller strukturerat på ett annat sätt. Allt som behövs är åtkomst till filer och/eller delar av filer som kan visas av Konqueror. Sådan strukturerad åtkomst blir möjlig genom användning av särskilda filer med innehållsförteckning, som anges med filändelsen .toc. Alla sådana &kdevelop;-innehållsförteckningsfiler innehåller en strukturerad &XML;-beskrivning av dokumentet som ska kommas åt. Standardkatalog för &kdevelop; innehållsförteckningsfiler När &kdevelop; installerades har en serie med fördefinierade .toc-filer oftast placerats i katalogen $KDEDIR/share/apps/kdevdocumentation/tocs. De är ganska enkla, strukturerade textfiler. Du kan titta på dem med en texteditor eller ett annat verktyg för att visa text. huvud <!DOCTYPE kdeveloptoc> <kdeveloptoc> (titel) (basadress) (innehållsstruktur) (indexstruktur) </kdeveloptoc> &XML;-strukturen tolkas av &kdevelop;s insticksprogram Dokumentation för att skapa dokumentationsträdets innehåll och hjälpa användaren att navigera i dokumentationen. Den innehåller all information som behövs för att visa titlar och komma åt dokumentationsfilernas innehåll. titel <title> (någon titelsträng) </title> Det här är titeln som &kdevelop; visar på grundnivån i dokumentationsträdet. Titeln som visas kan inte ändras av användaren. Om du vill att en annan text ska visas, måste du ändra posten <title> för hand i .toc-filen. basadress <base href=" (basdokumentets webbadress) "/> Webbadressen pekar på platsen där alla dokumentationens filer finns. Den läggs till i början av varje avsnittswebbadress i följande innehållsstrukturlista. Om du t.ex. laddar ner dokumentation från en fjärrserver, är allt du behöver göra för att visa filerna på den nya platsen att ändra webbadressen <base>. innehållsstruktur <tocsect1 name=" (avsnittstitel) " url=" (avsnittswebbadress) "> ... <tocsectn name=" (avsnittstitel) " url=" (avsnittswebbadress) "/> ... </tocsect1> All återstående navigerings- och åtkomstinformation lagras i en serie hierarkiska <tocsecti> ... </tocsecti> par. Varje i anger följande hierarkiska nivå ner till talet n som motsvarar dokumentationsavsnittet som visas sist. Alla poster <tocsecti> måste ha motsvarande egenskap name="xxx" ("xxx" representerar den verkliga titelsträngen). Den visas som nivåns titel i dokumentationsträdet. Den ska motsvara ett verkligt avsnitt av dokumentationen. Det kan finnas en egenskap url="" som hör ihop med vilken hierarkisk nivå i som helst. När användaren klickar på en avsnittstitel i dokumentationsträdet försöker &kdevelop; komma åt filen på platsen som pekas på den kombinerade bas- och avsnittswebbadressen. Posten <tocsectn/> måste hur som helst ha egenskapen url="". Detta sista hierarkiska <tocsectn/> ingår inte i ett par, utan avslutas omedelbart av / innan tecknet >. Vilken adress som helst som kombinerar bas- och avsnittswebbadress måste peka på en textfil som går att visa. Oftast är det en HTML strukturerad fil. Det är möjligt att länka till ankarmärken inne i en sådan HTML-fil genom att använda den vanliga #-beteckningen med formatet /baswebbadress/sektionswebbadress#ankarmärke. indexstruktur <index> <entry name=" (indexposttitel) " url=" (webbadress till indexavsnitt) "/> </index> Index är en enkel lista med indexposter, par med titel och webbadress. Ett index krävs inte. DevHelp-dokumentation är ett annat sätt att komma åt strukturerad dokumentation. Den använder en strukturerad innehållsförteckning som anges av filändelsen .devhelp på liknande sätt som &kdevelop;-innehållsfiler för att komma åt dokumentation för GNOME 2- skrivbordet. Du kan styra vilka DevHelp-filer som ska vara tillgängliga på inställningssidan DevHelp-dokumentationssamling. Tillhandahålla DevHelp-dokumentation DevHelp-filer kunde ursprungligen kommas åt på webbplatsen LIDN, men det verkar som om den inte underhålls sedan en tid tillbaka. Senare DevHelp-dokumentation är tillgänglig på webbsidan DevHelp Books Download. När &kdevelop; installeras, försöker det hitta alla .devhelp-filer på vissa standardplatser i systemet, t.ex. underkatalogerna i /opt/gnome/share/. Från början markeras inte filerna för visning. Om du vill se annan dokumentation, markera kryssrutan Innehållsförteckning i inställningstabellen. Du kan lägga till nya poster med knapparna till höger om listan. &kdevelop; filtrerar *.toc-filer i katalogdialogrutan som hör ihop med knapparna Lägg till och Redigera. Det här är till för dina egna syften. Du kan lägga till nästan vilka dokumentationsfiler som helst här, under förutsättning att de kan visas av insticksprogram i &konqueror;. Tillhandahålla egen dokumentation Oftast är den här samlingen tom när &kdevelop; först startas. Vi har avsiktligt fyllt i den med ett objekt för att visa poststrukturen. Här är hanteringen är rättfram. Använd knapparna till höger om listan för att lägga till, redigera eller ta bort dokumentationsposter. &kdevelop; filtrerar inte någonting i katalogdialogrutan som hör ihop med knapparna Lägg till och Redigera. Du måste explicit välja posterna för att visa dem i &kdevelop;s dokumentationsfunktion. Markera kryssrutan Innehållsförteckning för posten i inställningstabellen. Egen dokumentation kan inte indexeras eller sökas. Därför har inte kryssrutorna Index och Sök någon effekt här, som visas ovan. (... ännu inte skrivet ...) Inställning av index för textsökning (... ännu inte skrivet ...) (... ännu inte skrivet ...) (... ännu inte skrivet ...)