Byggverktygen

Kompilera, konvertera och visa
För att visa resultatet av arbetet, måste du först kompilera källkoden. Alla byggverktyg är grupperade tätt tillsammans i menyerna Bygg Kompilera, Bygg Konvertera och Bygg Visa.
För att kompilera källkoden för att visa på skärmen med program som , eller för ytterligare konvertering, kan du använda snabbtangenten 2. Därefter kan du visa -filen med ditt eget förvalda visningsprogram med 3, konvertera till en PS-fil med 4, och visa PS-filen med 5.

BibTEX
Om du använder BibTEX för bibliografiposter, måste du oftast följa ett speciellt kompileringsförfarande.Det betyder att anropa LATEX, därefter BibTEX och sedan LATEX ytterligare två gånger. Tursamt nog är Kile smart nog att automatiskt detektera om det är nödvändigt att anropa ytterligare verktyg som BibTEX, makeidx och Asymptote. Logiken är normalt aktiverad och kan ändras i Inställningar Anpassa Kile... Verktyg Bygg under fliken Allmänt för LATEX- och PDFLATEX-verktygen.

MetaPost och Asymptote
Om du vill kompilera dokumentet med MetaPost eller Asymptote, program för att rita bilder, kan du göra det med Bygg Kompilera MetaPost eller Bygg Övrigt Asymptote.

PDFLATEX
Det finns också ett annat sätt att kompilera dokumentet, om du vill ha PDF: Du kan köra PDFLATEX som kompilerar källkoden direkt till en PDF-fil, med 6. Därefter kan du direkt titta på den kompilerade filen genom att trycka på 7.
Du kan alternativt konvertera PS till PDF med 8, eller direkt från till PDF med 9.
Att använda PDFLATEX istället för LATEX kan bara vara fråga om enkelhet eller vana, men ibland kan beteendet hos de två programmen skilja sig åt.

LATEX till HTML
Slutligen kanske du vill publicera arbetet på Internet och inte bara på papper. Då kan du använda programmet latex2html som kan anropas från Kiles meny Bygg Konvertera Latex till HTML. Resultatet läggs in en underkatalog till arbetskatalogen, och du kan se resultatet av konverteringen genom att välja menyalternativet Bygg Visa Visa .

Skicka med kommandoradsväljare
Om du vill ange några särskilda kommandoradsväljare till verktygen för att kompilera, konvertera eller visa dina filer, kan du anpassa anropen under Inställningar Anpassa Kile... Verktyg Bygg.

Snabbgranskning
Du behöver alltid en viss tid för att titta på resultatet när du arbetar med LATEX. LATEX måste kompilera källkoden, och visningsprogrammet måste anropas. Det kan vara irriterande om du bara ändrade några bokstäver i en ekvation som var svår att typsätta. Kile erbjuder en Snabbgranskning, där du enbart kan kompilera en del av ett dokument och spara mycket tid. Den stöder fyra olika lägen, som kan kombineras med sju inställningar.
Snabbgranskning
Snabbgranskning
Alla inställningar måste göras i Inställningar Anpassa Kile... Verktyg Förhandsgranskning.
Anpassa snabbgranskning
Anpassa snabbgranskning

Markeringsläge
Användaren måste markera en del av dokumentet. Menyalternativet Bygg Snabbgranskning Markering eller snabbtangenten P, S startar valda program. Kile tar inledningen av originaltexten, så att alla paket och användardefinierade kommandon inkluderas. Användaren kan välja en av åtta fördefinierade inställningar:
Latex+ (inbäddad visning)
Latex+ ()
Latex+PS (inbäddad visning)
Latex+PS ()
PDFLatex+PDF (inbäddad visning)
PDFLatex+PDF ()
Xelatex+PDF (inbäddad visning)
Xelatex+PDF ()
Det bör vara tillräckligt för alla situationer då en snabbgranskning behövs.

Omgivningsläge
Du vill ofta förhandsgranska nuvarande omgivning, och särskilt matematiska omgivningar, som ibland kan vara svåra att skriva. Kile erbjuder ett mycket snabbt sätt att göra det. Ingen markering krävs, välj bara Bygg Snabbgranskning Omgivning eller snabbtangenten P, E så kompileras den nuvarande omgivningen och visas.

Underdokumentläge
Om du har ett stort projekt med många dokument, är det inte en god idé att kompilera hela projektet. Om du bara har gjort ändringar i ett enda dokument. Kile klarar av att kompilera och visa en förhandsgranskning av det nuvarande underdokumentet. Inledningen tas från huvuddokumentet, och bara den nuvarande delen kompileras, när du väljer Bygg Snabbgranskning Underdokument eller snabbtangenten P, D.

Matematiskt gruppläge
Förhandsgranskning av matematisk grupp låter dig förhandsgranska den matematiska grupp som du för närvarande redigerar. Kile tar Inledningen från huvuddokumentet, och bara den matematiska gruppen som markören befinner sig i kompileras, när du väljer Bygg Snabbgranskning Matematisk grupp eller snabbtangenten P, M.

Snabbgranskning i nedre raden
Istället för att visa förhandsgranskningen i ett nytt dokument, kan Kile också ställas in att använda den nedre raden för förhandsgranskning av kompilering. Du kan aktivera funktionen i inställningsrutan för snabbgranskning.

Grafiska filformat

LATEX och PDFLATEX
PDFLATEX, när det används med paketen graphics eller graphicx, kan kompilera PNG- och JPG-filer till eller PDF, men kan inte hantera EPS-filer. Omvänt så stöds EPS av processen att kompilera med LATEX till och konvertera till PS och slutligen PDF, men den stöder inte PNG och JPG.
Många användare vill skapa PDF-dokument, men vill också använda det utmärkta paketet Pstricks för att skapa -grafik, eller vill använda -utmatning från matematisk eller vetenskaplig programvara som Mathematica, Maple eller MuPAD. Dessa användare av LATEX måste först kompilera även om de vill skapa PDF-dokument, eftersom programmen skapar -kod som inte kan hanteras av PDFLATEX. Det är dock inte så svårt som det kan låta, eftersom Kile hjälper till.

Konvertering av grafik
För att klara av den här irriterande rundgången, när du vill inkludera både och PNG- eller JPG-filer, finns det ett antal sätt att gå förbi den:
Om du behöver en fil med PS-format, men har JPG- eller PNG-grafik, kan du också helt enkelt först använda PDFLATEX med -utmatning, och därefter köra dvips för att skapa PS-filen. Du märker att PDFLATEX; är ett mycket bra val om din källkod inte innehåller någon -kod alls.
Du kan konvertera EPS-filer till PNG eller andra format med verktyg som Gimp eller ImageMagick, och använda PDFLATEX.
Sättet som föredras är att konvertera EPS-grafik till PDF-grafik med epstopdf, som levereras med alla TEX-distributioner, och därefter använda PDFLATEX. Det producerar grafik med hög kvalitet, och du kan till och med styra resultatet med några av följande väljare:

-dAutoFilterColorImages=false
        -dAutoFilterGrayImages=false
        -sColorImageFilter=FlateEncode
        -sGrayImageFilter=FlateEncode
        -dPDFSETTINGS=/prepress
        -dUseFlateCompression=true

Ännu bättre: Om systemet tillåter shell-escape, kan konvertering göras i farten. Allt du behöver göra är att inkludera paketet epstopdf, som ingår i alla TEX-distributioner, med kommandot \usepackage{epstopdf}. Antag att din kod är

        \includegraphics[width=5cm]{test.eps}

När du anropar PDFLATEX med väljaren --shell-escape, konverteras grafikfilen test.eps automatiskt till test.pdf.
Konverteringen utförs varje gång du kör PDFLATEX. Om ditt grafikkommando anges implicit:

        \includegraphics[width=5cm]{test}

kontrollerar epstopdf om test.pdf redan är tillgänglig, så att det konverteringssteget kan hoppas över.
Du kan konvertera åt andra hållet, och använda LATEX med PS-PDF konvertering. Det rekommenderas inte, eftersom en EPS-inkapsling av JPG- eller PNG-filer kan ge större EPS-filer, som i sin tur ger onödigt stora dokument. Det här är dock ytterst beroende på vilket grafikprogrammet du använder, eftersom EPS kan inkapsla annan grafik, men alla program stöder inte detta perfekt. En del kan verkligen försöka bygga JPG-bilden med vektorer och diverse skript, vilket resulterar i gigantiska filer. Konvertering av alla grafikformat till EPS kan göras av ImageMagick. Ett annat enkelt program som utför processen riktigt är jpg2ps.
Du kan också använda automatisk konvertering. Alla grafikfiler konverteras i farten till EPS, och infogas i PS-dokumentet. Det är ett bekvämt sätt, men du måste ställa in systemet riktigt. Detta beskrivs i avsnittet EPS-grafik.

Använd rätt fil för rätt sorts grafik
EPS är ett sorts grafiskt vektorskriptspråk, som beskriver alla linjer och punkter som grafiken består av. Det ser bra ut till och med när det förstoras mer än normalstorleken, och passar bäst för diagram och vektorgrafik som skapats direkt i EPS. De ser mycket klara och skarpa ut, medan de behåller en mycket liten storlek.
PNG (eller det mindre lämpliga ) är ett förlustfritt filformat , med bra komprimering och kvalitet. Det är mycket bra för diagram, inlästa ritningar, eller någonting vars skärpa måste bibehållas. Det är ibland för mycket av det goda när det används för fotografier.
JPEG är ett format med förlust, som komprimerar bilder bättre än PNG till priset av en viss förlust av detaljer i bilden. Det har ofta ingen betydelse för fotografier, men kan orsaka dålig kvalitet för diagram eller ritningar, och kan få vissa tunna linjer att försvinna helt. I dessa fall, använd EPS eller PNG.
Men kom alltid ihåg: Skräp in, skräp ut! Ingen konvertering kan få en dålig bild att bli bra.

EPS-grafik
EPS-grafikfiler är det traditionella sättet att infoga grafikfiler i LATEX-dokument. Eftersom e-postlistor är fulla med frågor angående EPS-grafik, beskriver vi några viktiga aspekter och demonstrerar hur Kile stöder dem.

LATEX och EPS-grafik
Om du bestämde dig för att använda det traditionella LATEX för att skapa PS- eller PDF-utmatning, stöter du troligen på vissa problem med grafik. Du måste använda EPS-grafik (Encapsulated ), inte JPEG- eller PNG-filer. Det ska inte vara något problem, eftersom det finns många konverteringsprogram som convert från det utmärkta paketet ImageMagick. Men det kräver förstås en viss tid.
EPS-filerna används både av LATEX och -PS konverteringen:
LATEX söker igenom EPS-filen efter den omgivande rutan, som talar om för LATEX hur mycket utrymme som ska reserveras för grafiken.
Konverteringen -PS läser därefter EPS-filen och infogar grafiken i PS-filen.
Det leder till vissa följder:
LATEX läser aldrig EPS-filen om den omgivande rutans parametrar anges i kommandot för att infoga grafik.
Eftersom LATEX bara kan läsa filer som innehåller ASCII, kan det inte läsa informationen om den omgivande rutan från komprimerade eller andra filer än EPS-grafikfiler.
EPS-grafiken infogas inte i -filen. Eftersom EPS-filerna måste vara tillgängliga när -filen konverteras till PS, måste EPS-filerna följa med -filerna så fort de flyttas.
Nu kan du anropa LATEX och ett -PS konverteringsverktyg som dvips för att skapa ditt -dokument. Om målet är ett PDF-dokument, ska du köra dvips med väljaren -Ppdf och därefter anropa ps2pdf. Du hittar många dokument som beskriver denna lösningen.

Sättet med i Kile
Kile hjälper dig att hitta information om den omgivande rutan. Om du har installerat paketet ImageMagick, hämtar Kile informationen från EPS-filen och infogar den som ett alternativ. Det görs automatiskt när du väljer grafikfilen. Det finns två fördelar med att gå till väga så här:
Informationen är redan inläst i dialogrutan, och det behöver inte göras senare av LATEX.
Ännu viktigare är att bildens bredd och höjd kan beräknas när upplösningen är känd. Informationen visas längst upp i dialogrutan, och kan fungera som en ledtråd när du vill skala grafiken.
Kile kan också stödja EPS-filer komprimerade med zip eller gzip, som är mycket mindre än okomprimerade EPS-filer. Men funktionen kan bara användas med en särskild systeminställning, och en ändring av din lokala grafikinställning, som beskrivs i avsnittet Punktavbildad grafik.

Sättet med och punktavbildad grafik
Om systemet tillåter shell-escape, stöder Kile också ett enkelt sätt att infoga punktavbildad grafik, om du ställer in TEX-systemet riktigt. Det finns inget behov av att konvertera JPEG- eller PNG-grafik, det kan göras automatiskt när -filen konverteras till PS.
LATEX behöver viss information om filändelserna. Paketet graphicx letar efter filen graphics.cfg som måste finnas någonstans i din sökväg för LATEX-dokument. Sök efter poster som:

\DeclareGraphicsRule{.pz}{eps}{.bb}{}%
   \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
   \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
   \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
   \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{}%

och ersätt raderna med:

\DeclareGraphicsRule{.pz}{eps}{.bb}{}%
   \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
   \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
   \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
   % changed or new graphic rules
   \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}%   zipped EPS
   \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}%   gzipped EPS
   \DeclareGraphicsRule{.jpg}{eps}{}{`convert #1 eps:-}%         JPEG
   \DeclareGraphicsRule{.gif}{eps}{.bb}{`convert #1 eps:-}%      GIF
   \DeclareGraphicsRule{.png}{eps}{.bb}{`convert #1 eps:-}%      PNG
   \DeclareGraphicsRule{.tif}{eps}{.bb}{`convert #1 eps:-}%      TIFF
   \DeclareGraphicsRule{.pdf}{eps}{.bb}{`convert #1 eps:-}%      PDF-graphics

Du hittar till exempel filen under /etc/texmf/latex/graphics.cfg på Debian. Det bästa sättet att gå tillväga är att kopiera filen till din lokala Tex-sökväg och därefter ändra kopian. Se TEX-distributionens manual för att ta reda på hur du får fram en lista med dina TEX-kataloger.
Med den här inställningsfilen har du möjlighet att infoga punktavbildad grafik och EPS-filer komprimerade med zip eller gzip i LATEX. Kommandot för konvertering ges av dvips. När du tittar på konverteringskommandot ser du att ingen extra fil skapas. Resultatet av konverteringsprocessen skickas direkt till PS-filen. Det enda som LATEX måste känna till är grafikens storlek, och därför behöver vi den omgivande rutan, som tillhandahållls av Kile.
Vissa säger att det är ett osäkert sätt. Du måste bestämma dig för hur du vill arbeta. Hur som helst behöver du ingen omgivande ruta, eftersom Kile extraherar informationen från alla typer av grafik.

PDFLATEX och EPS-grafik
Som redan har nämnts, kan inte PDFLATEX hantera EPS-grafikfiler, men konverteringsverktyg som epstopdf kan hjälpa. Det bästa sättet är att inkludera paketet epstopdf, som måste följa paketet graphicx.

\usepackage[pdftex]{graphicx}
   \usepackage{epstopdf}

Nu kan du redan infoga EPS-grafik om du kör pdflatex med väljaren --shell-escape, men vi kan göra det ännu bättre och också hantera EPS-filer komprimerade med zip eller gzip. Återigen måste vi ändra grafikinställningsfilen graphics.cfg enligt ovan. Denna gången söker vi efter:

% pdfTeX is running in pdf mode
   \ExecuteOptions{pdftex}%

och helt enkelt lägga till några rader:

% pdfTeX is running in pdf mode
   \ExecuteOptions{pdftex}%
   \AtEndOfPackage{%
      \g@addto@macro\Gin@extensions{.eps.gz,.eps.zip}%
      \@namedef{Gin@rule@.eps.gz}#1{{pdf}{.pdf}{`gunzip -c #1 | epstopdf -f 
>\Gin@base.pdf}}%
      \@namedef{Gin@rule@.eps.zip}#1{{pdf}{.pdf}{`unzip -p #1 | epstopdf -f 
>\Gin@base.pdf}}%
   }%

Med dessa rader kan PDFLATEX hantera EPS-filer, och förhoppningsvis ska det inte uppstå fler problem rörande grafik.

Huvuddokument
Att definiera dokumentet som huvuddokument, gör att du kan arbeta med olika filer, vilket ger ett överliggande dokument (eller huvuddokument) och underliggande dokument som utgör ett helt verk. Efter att ha definierat huvuddokumentet, med motsvarande kommando i menyn Inställningar, gäller alla kommandon i menyn Verktyg bara detta dokument, även om du arbetar i underliggande dokument. Du kan till och med stänga huvuddokumentet.

Felhantering
Efter du har kompilerat någonting, tittar Kile på de felmeddelanden som genererades. Om det finns några fel eller varningar, rapporteras de kortfattat i fönstret Logg och meddelanden. Man kan ta en närmare titt på meddelanden genom att välja Bygg Visa loggfil, eller med snabbtangenten 0. Loggen som skapade visas då i fönstret Logg och meddelanden, med fel och varningar markerade.
Visa loggen
Visa loggen
Visa loggen
Du kan enkelt gå från ett meddelande i loggfilen till ett annat, genom att använda menyalternativen Bygg Nästa/Föregående Latexfel/varning, eller genom att använda motsvarande knappar i verktygsraden.
För att gå till raden in LATEX källkod där felet eller varningen uppstod, klicka på felet eller varningen i fönstret Logg och meddelanden. Kile visar automatiskt raden som orsakade problemet.

Filbevakningsläget
När du startar kommandot Snabbygg, anropas normalt någon form av visning efter kompileringen. Om du inte använder inbyggd visning, öppnas ett nytt fönster varje gång.
Om du justerar dokumentets utseende, kanske du startar Snabbygg mycket ofta, och har många visningsfönster öppna på skrivbordet. För att undvika förvirring, kan du aktivera läget Filbevakningsläge som förhindrar att Snabbygg startar visningen.
Läget är förstås oanvändbart med inbyggd visning, eftersom du ändå måste stänga den för att komma tillbaka till redigering av dokumentet och omkompilering.