De hulpmiddelen voor bouwen

Compileren, converteren en bekijken
Om het resultaat van uw werk te bekijken, dient u eerst de broncode te compileren. Alle hulpmiddelen om te bouwen zijn dicht bijeen gegroepeerd in de menu's Bouwen Compileren, Bouwen Converteren en Bouwen Beeld.
Om uw broncode te compileren voor scherm-viewers zoals , andere DVI-viewers of verdere conversie, kunt u de sneltoetscombinatie 2 gebruiken. Dan kunt u het DVI-bestand bekijken gebruik makend van uw standaard viewer met 3, het DVI- naar een ps-bestand converteren met 4 en het ps-bestand bekijken met 5.

BibTEX
Als u BibTEX gebruikt voor uw bibliografie items, moet u gewoonlijk een speciaal schema voor compilatie gebruiken. Dit betekent aanroepen van LATEX daarna BibTEX en dan LATEX opnieuw twee keer. Gelukkig is Kile slim genoeg om automatisch te ontdekken of het nodig is om extra hulpmiddelen zoals BibTEX, makeidx en Asymptote aan te roepen. Deze logica wordt standaard ingeschakeld en kan veranderd worden in Instellingen Kile instellen... Hulpmiddelen Bouwen in het tabblad Algemeen in de hulpmiddelen LATEX en PDFLATEX.

MetaPost en Asymptote
Als u uw document wilt compileren met MetaPost of Asymptote, een programma om afbeeldingen te tekenen, dan kunt u dat doen met Bouwen Compileren Metapost of Bouwen Compileren Asymptote.

PDFLATEX
Er is tevens een andere wijze om uw document te compileren, als u een pdf-bestand wilt: u kunt PDFLATEX uitvoeren, die de broncode direct tot een pdf-bestand compileert, met 6: u kunt dan het gecompileerde bestand bekijken door te drukken op 7.
Als alternatief, kunt u een ps- in een pdf-bestand converteren met 8 of direct een - in een pdf-bestand met 9.
PDFLATEX gebruiken, in plaats van LATEX, kan slechts een kwestie van eenvoud of gewoonte zijn, maar soms verschilt het gedrag van de twee programma's.

LATEX naar webpagina
Tenslotte, wilt u misschien uw werk op het web publiceren en niet alleen op papier. U kunt het programma latex2html gebruiken, dat vanuit Kile aangeroepen kan worden vanuit het menu Bouwen Converteren LaTeX naar HTML. Het resultaat wordt geplaatst in een submap van de werkmap, en u kunt het resultaat van de conversie zien door te kiezen voor het menu-onderdeel Bouwen Beeld View HTML.

Parameters via de commandoregel doorgeven
Indien u specifieke parameters op de commandoregel wilt doorgeven aan de hulpprogramma's voor het compileren, converteren of bekijken, dan kunt u hun aanroep configureren in Instellingen Kile configureren... Hulpmiddelen Bouwen.

Snelvoorbeeld
U zult altijd enige tijd nodig hebben om het resultaat te bekijken bij het werken met LATEX. LATEX moet de bron compileren en de viewer moet aangeroepen worden. Dit kan vervelend zijn als u slechts enige letters in een vergelijking, die moeilijk is te op te maken, wijzigt. Kile biedt een modus Snel voorbeeld, waarin u slechts een gedeelte van een document compileert en heel wat tijd bespaart. Het ondersteunt vier verschillende modi, die gecombineerd kunnen worden tot zeven configuraties.
Snelvoorbeeld
Snelvoorbeeld
Alle instellingen moeten worden gedaan in Instellingen Kile configureren... Hulpmiddelen Voorbeeld.
Configureren van Snelvoorbeeld;
Configureren van Snelvoorbeeld;

Selectiemodus
De gebruiker moet een gedeelte van het document selecteren. Menu-item Bouwen Snelvoorbeeld Selectie of de sneltoets P,S start de geselecteerde programma's. Kile neemt de preamble van de originele tekst, zodat alle pakketten en gebruikergedefinieerde commando 's ingevoegd worden. De gebruiker kan uit één van de acht voorgedefinieerde configuraties kiezen:
LaTeX+ (ingebedde viewer)
LaTeX+ ()
LaTeX+PS (ingebedde viewer)
LaTeX+PS ()
PDFLaTeX+PDF (ingebedde viewer)
PDFLaTeX+PDF ()
XeLaTeX+PDF (ingebedde viewer)
XeLaTeX+PDF ()
Dit zou voldoende moeten zijn voor alle situaties waarvoor een snel voorbeeld nodig is.

Omgevingmodus
Heel vaal wilt u de huidige omgeving bekijken en speciaal wiskundige omgevingen, die soms moeilijk zijn te maken. Kile biedt een erg snelle manier om dit te doen. Er is geen selectie nodig, kies gewoon Bouwen Snelvoorbeeld Omgeving of de sneltoets P,E en de huidige omgeving zal gecompileerd en getoond worden.

Subdocument-modus
Als u een groot project hebt met heel wat documenten, dan is compileren van het gehele project niet zo'n goed idee, als u alleen wijzigingen in een enkel document hebt gemaakt. Kile kan compileren en een voorbeeld tonen van het huidige subdocument. Het neemt de preamble uit het hoofddocument en compileert alleen het huidige deel wanneer u Bouwen Snelvoorbeeld Subdocument kiest of de sneltoets P,D.

Mathgroup-modus
De voorbeeldmodus wiskundegroep stelt u in staat de wiskundegroep die u nu aan het bewerken bent te bekijken. Kile neemt de preamble uit het hoofddocument en compileert alleen de wiskundegroep waarin de cursor zich nu bevindt wanneer u Bouwen Snelvoorbeeld Wiskundegroep kiest of de sneltoets P,M.

Snelvoorbeeld in onderste balk
In plaats van het tonen van een voorbeeld van een nieuw document kan Kile ook ingesteld worden om de onderbalk te gebruiken voor voorbeeldcompilaties. U kunt deze functie activeren in het instellingenpaneel snelvoorbeeld.

Formaten voor grafische bestanden

LATEX en PDFLATEX
PDFLATEX kan, wanneer het gebruikt wordt met de pakketten graphics of graphicx op correcte wijze png- en jpg-bestanden compileren in of pdf maar kan niet met eps-bestanden overweg. Omgekeerd ondersteunt het proces van compileren met LATEX naar en het converteren naar ps- en uiteindelijk pdf-bestanden wel eps-, maar geen png- en jpg-bestanden.
Heel wat gebruikers willen PDF-documenten maken, maar ook het excellente pakket Pstricks gebruiken om -illustraties te maken of ze willen de uitvoer van mathematische en wetenschappelijke software zoals Mathematica, Maple of MuPAD gebruiken. Deze LATEX gebruikers moeten eerst in compileren, zelfs als ze PDF-documenten willen maken, omdat deze programma's code produceert die niet beheerd kan worden door PDFLATEX. Het is echter niet zo moeilijk als het klinkt, omdat Kile zal helpen.

Grafische conversie
Om deze frustrerende cirkel te doorbreken, wanneer u zowel -code als png- of jpg-bestanden wilt invoegen, hebt u een aantal manieren om hier omheen te werken:
Als u een bestand in PS-formaat nodig heeft, maar een jpg- of png-afbeelding hebt, kunt u ook eenvoudig eerst PDFLATEX gebruiken met -uitvoer en dan het commando dvips gebruiken om het PS-bestand aan te maken. U zult zien dat PDFLATEX een erg goede keuze is, als uw bron helemaal geen -code bevat.
U kunt eps-bestanden naar png- of andere formaten converteren met hulpmiddelen als the Gimp of ImageMagick en PDFLATEX gebruiken.
Een bij voorkeur gebruikte manier is om grafische eps-bestanden naar grafische pdf-bestanden te converteren with epstopdf, dat meegeleverd wordt in elke TEX-distributie en daarna PDFLATEX gebruiken. Het maakt grafische bestanden van hoge kwaliteit en u kunt zelfs het resultaat bepalen met enige van de volgende opties:

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

Nog beter: als uw systeem shell-escape toestaat, dan kan de conversie on-the-fly gedaan worden. Alles wat u moet doen is het pakket epstopdf invoegen, hetwelk onderdeel is van alle TEX distributies, met het commando \usepackage{epstopdf}. Aannemend dat uw code is

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

Wanneer u PDFLATEX aanroept met de optie --shell-escape, zal de illustratie test.eps automatisch geconverteerd worden in test.pdf.
Deze conversie zal elke keer plaatsvinden als u PDFLATEX uitvoert. Als u graphische commando impliciet gegevens is:

        \includegraphics[width=5cm]{test}

zal epstopdf controleren of test.pdf al beschikbaar is, zodat de conversiestap overgeslagen kan worden.
U kunt ook andersom converteren en LATEX en ps-pdf-conversie gebruiken. Dit is niet altijd een goed idee, aangezien inkapselen met eps van jpg of png groter bestanden kan opleveren, die op hun beurt onnodig grote bestanden opleveren. Dit is echter sterk afhankelijk van het grafische hulpmiddel dat u gebruikt, omdat eps andere grafische gegevens kan inkapselen, maar niet alle toepassingen dit perfect ondersteunen. Sommige proberen misschien zelfs uw jpg-afbeelding met vectoren en verscheidene scripts te schrijven, die in gigantische bestanden zullen resulteren. Conversie van alle grafische formaten kan worden gedaan door ImageMagick. Een ander eenvoudig programma dat dit proces op correcte wijze uitvoert is jpg2ps.
U kunt ook een automatische conversie gebruiken. Alle grafische bestanden worden on-the-fly geconverteerd naar EPS en ingevoegd in het PS-document. Dit is een comfortabele manier, maar u moet uw systeem op de juiste manier inrichten. Dit wordt uitgelegd in de sectie EPS Graphics.

Gebruik het juiste bestand voor de juiste afbeelding
Eps is een soort grafische vectorscripttaal, die alle lijnen en punten beschrijft waar de afbeelding van is gemaakt, hij ziet er zelfs goed uit wanneer hij vergroot is tot meer dan de standaardgrootte, en past het best bij diagrammen en vector afbeeldingen die in eps zelf gemaakt zijn, die er zeer helder en scherp uitzien terwijl zij een zeer kleine grootte in bytes behouden.
Png (of het langzaamaan verdwijnende ) is een verliesvrij bestandsformaat, met goede compressie en kwaliteit. Het is zeer goed voor diagrammen, scans van tekeningen en alles waarvan u de scherpte wilt behouden. Het is soms overbodig wanneer het gebruikt wordt voor foto's.
Jpg is een niet-verliesvrij formaat, dat bestanden beter comprimeert dan png met als prijs wat verlies in detail van de afbeelding. Dit is meestal irrelevant voor foto's, maar kan een slechte kwaliteit veroorzaken voor diagrammen en tekeningen, en kan sommige dunne lijnen helemaal doen verdwijnen; gebruik in die gevallen eps of png.
Maar onthoud altijd: garbage in, garbage out! Geen enkele conversie kan een slechte afbeelding goed maken.

EPS-grafische bestanden
Grafische EPS-bestanden zijn de traditionele manier om grafische bestanden in LATEX documenten in te voegen. Omdat e-maillijsten vol staan met vragen over EPS-graphics, bespreken we enige belangrijke aspecten en demonstreren hoe Kile ze ondersteunt.

LATEX en EPS Graphics
Als u het traditionele LATEX wilt gebruiken om PS of PDF uitvoer te maken, dan zult u waarschijnlijk problemen krijgen met illustraties. U moet EPS-bestanden (Encapsulated ) gebruiken, geen JPEG of PNG bestanden. Dit zou geen probleem moeten zijn, omdat er heel wat converters zoals convert zijn uit het excellente pakket ImageMagick. Dat kost echter de nodige tijd.
De EPS-bestanden worden gebruikt door zowel LATEX als de -PS converter:
LATEX scant het EPS-bestand op de lijn van het begrensde vak, die LATEX vertelt hoeveel ruimte te reserveren voor de illustraties.
De -PS converter leest dan het EPS-bestand en voegt de illustratie in in het PS-bestand.
Dit heeft enige implicaties:
LATEX leest nooit het EPS-bestand als de parameters van het omgevende vak gespecificeerd zijn in het commando voor invoegen van de illustratie.
Omdat LATEX geen niet-ASCII bestanden kan lezen, kan het geen informatie over het omgevende vak lezen uit gecomprimeerde of niet-EPS bestanden met illustraties.
De grafische EPS-bestand is niet aanwezig in het -bestand. Omdat de EPS bestanden aanwezig moeten zijn wanneer het bestand geconverteerd wordt naar PS, moeten de EPS bestanden meegaan met de bestanden wanneer ze verplaatst worden.
U kunt nu LATEX aanroepen en een -PS converter zoals dvips om uw document te maken. Als uw doel een PDF-document is, zou u dvips uit moeten voeren met de optie -Ppdf en daarna ps2pdf aanroepen. U zult heel wat documenten vinden die deze oplossing beschrijven.

De manier van Kile
Kile helpt u om de informatie over het begrensde vak te vinden. Als u het pakket ImageMagick hebt geïnstalleerd zal Kile deze informatie ophalen uit het EPS bestand en het als optie invoegen. Dit wordt automatisch gedaan wanneer u het grafische bestand selecteert. Er zijn twee voordelen om als volgt verder te gaan:
De informatie is al gescand in de dialoog en het is niet nodig het later nog eens door LATEX te laten doen.
Nog belangrijker is dat de breedte en hoogte van het plaatje berekend kan worden wanneer zijn resolutie bekend is. Deze informatie zal getoond worden bovenaan de dialoog en kan dienen als aanwijzing wanneer u de illustratie wilt schalen.
Kile kan ook met zip of gzip gecomprimeerde EPS bestanden ondersteunen, die veel kleiner zijn dan niet gecomprimeerde EPS bestanden. Deze mogelijkheid kan alleen gebruikt worden met een speciale instelling van het systeem en een wijziging van uw lokale grafische configuratie, zoals is beschreven in de sectie Bitmap-illustraties.

De manier en bitmap-illustraties
Als uw systeem shell-escape toestaat ondersteunt Kile ook een gemakkelijke manier om bitmap-illustraties in te voegen, als u uw TEX-systeem op de juiste manier instelt. Er geen noodzaak naar JPEG of PNG illustraties te converteren, dit kan automatisch worden gedaan wanneer het -bestand geconverteerd wordt naar PS.
LATEX heeft enige informatie nodig over achtervoegsels van bestanden. Het pakket graphicx zoekt naar een bestand graphics.cfg, die ergens in uw zoekpad voor LATEX documenten moet zitten. Zoek naar items zoals:

\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}{}%

en vervangt deze regels door:

\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

U zult dit bestand, bijvoorbeeld in Debian, vinden in /etc/texmf/latex/graphics.cfg. De beste manier om verder te gaan is dit bestand naar uw lokale texpath te kopiëren en daarna dit bestand te wijzigen. Zie de handleiding van uw TEX-distributie om te vinden waar de lijst van uw TEX-mappen zich bevinden.
Met dit instellingenbestand kunt u bitmap-illustraties toevoegen en zip- of gzip EPS-bestanden in LATEX invoegen. Het commando voor conversie wordt gegeven door dvips. Wanneer u naar het conversiecommando kijkt zult u zien dat er geen extra bestand wordt gemaakt. Het resultaat van het conversieproces wordt direct in de pijp naar het PS-bestand gestopt. Het enige dat LATEX moet weten is de grootte van de illustratie en daarom hebben we het begrensde vak nodig, dat door Kile wordt geleverd.
Sommigen zeggen dat deze manier onveilig is; u moet beslissen over hoe te werk gaan. In elk geval hebt u geen begrensd vak nodig, omdat Kile deze informatie uit alle type illustraties haalt.

PDFLATEX en EPS-illustraties
Zoals al eerder gezegd is PDFLATEX niet in staat EPS-afbeldingsbestanden te behandelen, maar converters zoals epstopdf bieden hulp. De beste manier is het pakket epstopdfin te voegen, die het graphicx pakket moet volgen.

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

U kunt nu al EPS-afbeeldingen invoegen, als u pdflatex met de optie --shell-escape uitvoert, maar we kunnen het nog beter maken en ook zip- of gzip EPS-bestanden behandelen. We moeten dan opnieuw het grafische instellingenbestand graphics.cfg zoals boven wijzigen. Deze keer zoeken we naar:

% pdfTeX wordt uitgevoerd in pdf-modus
   \ExecuteOptions{pdftex}%

en eenvoudig enkele regels toevoegen:

% pdfTeX wordt uitgevoerd in pdf-modus
   \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}}%
   }%

Met deze regels is PDFLATEX in staat EPS-bestanden te behandelen en hopelijk zijn er dan geen kwesties meer met illustraties.

Hoofddocument
Het definiëren van uw document als hoofddocument stelt u in staat met gescheiden bestanden te werken, hetgeen u een ouder-document (of hoofddocument) en kind-documenten geeft die uw complete werk vormen. Na een hoofddocument gedefinieerd te hebben met het overeenkomstige commando in het menu Instellingen, zijn alle commando's van het menu Hulpmiddelen alleen van toepassing op dit document, zelfs wanneer u werkt in de kind-documenten. U kunt het hoofddocument zelfs sluiten.

Afhandelen van fouten
Nadat u iets gecompileerd heeft,kijkt Kile naar de foutmeldingen die gegenereerd zijn. Als er fouten of waarschuwingen zijn, dan worden ze kort gerapporteerd in het scherm Loggegevens en berichten. Men kan de fouten gedetailleerder bekijken door te kiezen voor Bouwen Logbestand bekijken of door de sneltoetscombinatie 0. Het gegenereerde logbestand wordt weergegeven in de weergave Loggegevens en berichten; fouten en waarschuwingen worden gemarkeerd.
Het logbestand bekijken
Het logbestand bekijken
Het logbestand bekijken
U kunt eenvoudig van het ene bericht in het logbestand naar het andere springen door de menu-onderdelen Bouwen Volgende/ Vorige LaTeX-fout /-waarschuwing te gebruiken, of door de overeenkomstige knoppen van de taakbalk te gebruiken.
Klik op de fout of waarschuwing om in de LATEX-broncode naar de regel te springen waar de foutmelding of waarschuwing in de weergave Loggegevens en berichten voorkwam. Kile brengt u automatisch naar de regel die problemen geeft.

De modus Bestanden observeren
Wanneer u het commando Snelmaken start, zal normaliter een viewer aangeroepen worden na de compilatie. Als u geen ingebedde viewer gebruikt, zal er iedere keer een nieuw venster worden geopend.
Als u de opmaak van uw document aan het aanpassen bent, voert u misschien erg vaak Snelmaken, en heeft u veel vensters van de viewer open op uw bureaublad; om verwarring te vermijden, kunt u de modus Bestanden observeren activeren, die het starten van een viewer door Snelmaken voorkomt.
Deze modus is natuurlijk nutteloos met ingebedde viewers, daar u deze toch af dient te sluiten om verder te gaan met het bewerken van het document en hercompileren.