diff --git a/doc/da/Makefile.am b/doc/da/Makefile.am new file mode 100644 index 0000000..931235a --- /dev/null +++ b/doc/da/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = da +KDE_DOCS=kile diff --git a/doc/da/index.docbook b/doc/da/index.docbook new file mode 100644 index 0000000..cd7c5f8 --- /dev/null +++ b/doc/da/index.docbook @@ -0,0 +1,5619 @@ + +Kile"> + ATEX"> + EX"> + teTEX"> + EX"> + GnuPlot"> + ImageMagick"> + KDE"> + KDVI"> + KGhostView"> + KPDF"> + PostScript"> + pyBliographer"> + gBib"> + makeidx"> + Kate"> + XFig"> + CJK"> + ucs"> + URL"> + + + + +]> + + + + +&kile;-håndbogen + + + JonathanPechta + FedericoZenith
zenith@chemeng.ntnu.no
 + HolgerDanielsson
holger.danielsson@t-online.de
 + JeroenWijnhout
Jeroen.Wijnhout@kdemail.net
+ + + + +&erik.kjaer.pedersen.role; + + +2003 +Jonathan Pechta + + + +200320052006 +Federico Zenith + + + +20052006 +Holger Danielsson + + +2006-01-19 +1.9 + + +&FDLNotice; + + + +&kile; er en &tex;- og &latex;-kildekodeeditor og skal. + + + +KDE +kdenonbeta +Kile +LaTex +Tex + + + + + + +Forord + + + + Krav + + For at køre &kile;, kræves at du har følgende komponenter installerede i dit system: + + + K-desktopomgivelsen (&kde;): &kde; er et populær desktopomgivelse med åben kildekode. + Qt: Qt er et C++ udviklingsværktøj som behøves for at kompilere &kile;. + &latex;: Typesætningsprogram for dokumenter af høj kvalitet. Sandsynligvis har du (eller du ønsker) pakken &tetex;, eftersom du har et Unix-lignende system. + + + Frivillige pakker + + + &kdvi;: DVI-fremviser for &kde;. + &gnuplot;: videnskabelig plotte-pakke. + &xfig;: tegneprogram for X-window. + + + Nogle af disse pakker kan indgå i din Linux-distribution, kontrollér distributionens dokumentation eller installations-cd eller dvd for at tilføje pakken til din computer. + + &kile;-projektet omfatter flere binære pakker for &kile; for forskellige distributioner som nemt kan installeres og køres, uden at behøve at kompilere. Kig på &kile;s hjemmeside. + + + + + + Tiltænkt publikum + + Denne håndbog er beregnet for af hvem som helst, uanset hans eller hendes erfaring med &latex;, &kde;, &kile; eller Linux. + + Avancerede brugere læser formodentlig ikke håndbogen, men der tages hensyn til alle forslag om dokumentationen. Hvis du vil bidrage til projektet eller dokumentationen, så konsultér &kile;s netside. Kommentarer om dokumentationen kan sendes til zenith@chemeng.ntnu.no. + + Behøver du svar på spørgsmål om &kile;? Har du problemer med kompilering? Vil du gerne se en ny funktion? Den foretrukne måde at spørge om tekniske spørgsmål eller begynde en diskussion, er at bruge vores e-mail-liste: kile-devel@lists.sourceforge.net. + + + + + + + + Indledning + + + + Basale fakta + + + + Om &kile; + + &kile; er et integreret &latex;-omgivelse for &kde;. &kile; giver dig mulighed at udnytte alle funktioner som findes i &latex; i en grafisk grænseflade, hvilket giver dig en nem, umiddelbar og indstillelig mulighed for adgang til alle programmer til at kompilere, efterbehandle, fejlsøge, konvertere og vise &latex;. Du får også meget bekvemme guider, en referencemanual til &latex;, grænseflade til &gnuplot; og &xfig;, og projekthåndtering. + + + + + + Hvad er &latex; + + &latex; er et tekstbehandlingssystem som er afledt fra &tex;, et program som oprindeligt udvikledes i 1977 af Donald Knuth, for at hjælpe forfattere med at lave et professionelt layout af sit arbejde, og opnå et resultat som ligner det som en sætter kan opnå. Sætteren er en faglært som formgiver dokumentet ifølge dokumenttypens specifikation. &latex; blev lavet af Leslie Lamport for at give forfattere automatisk sætning, især når det gælder den dyre og møjsomme sætning af matematiske formler og udtryk, som ikke tilfældigt omgives af dollartegn i &latex;. I dag tillader tekstbehandlingsprogrammer alle brugere at være sættere, men hvad man ofte vil have er et dokument som ser godt ud, ikke et som man skal bruge timer på for at det skal se godt ud. &latex; tager sig af denne byrde, og lader dig tænke på dokumentet, ikke layout. Og ja, resultatet ser godt ud! + + + + + + Hvordan udtales det? Hvorfor den mærkelige måde at skrive det på? + + Der er en morsom tradition for at pakker som hører sammen med &tex; skal have den mærkeligst mulige udtale og skrivemåde. &tex; er antageligt hentet fra det græske τεχ, med latinske bogstaver tech. Der er mange forklaringer, men den sandsynligste er at &latex; oprindeligt var beregnet til tekniske rapporter, og dens første formål var rigtig og nem sætning af matematiske formler, hvilket på det tidspunkt var en ekstremt dyr, tidsforbrugende og frustrerende opgave. + Udtalen skal være som følger: T som ventet, E som vokalen i let, og X som på tysk ch. Hvis du ikke véd hvordan ch lyder, er det mere eller mindre som en hvæsende kat. I det fonetiske alfabet er symbolet /ç/. Mange rapporterer det anderledes udtalt ach (fonetisk symbol /x/), men jeg har personlig spurgt en græker, og kan bekræfte den første version. Du bør være vidende om at mange anvender den forkerte udtale /teks/ eller /tek/. + Til sidst, i &latex; udtales det første LA som lej: idéen er at selvom ren &tex; er svært, kan selv en nybegynder (på engelsk layman) bruge &latex;-makroer. Så nu véd du det! (Oversætterindskud til danske læsere: Det kunne måske også have noget at gøre med at forfatteren af &latex; hedder Leslie Lamport) +> En mindre inspirerende, men mere realistisk forklaring er at det stammer fra Leslie Lamport's efternavn, forfatteren til &latex;. Nu ved du det. + + + + + + + + &latex; 101 + + &latex; typesætningssystemet ligner andre mærkesprog såsom XML, som bruges til mange dokumenttyper (inklusive det du læser nu), eller HTML, som bruges til netsider. Den generelle idé er at have særlige omgivende nøgleord, som kaldes mærker, som fortæller et program (en tekstbehandling, en browser eller &kile;-oversætteren) hvordan teksten skal præsenteres. &kile; tilbyder dig et betydeligt antal sådanne mærker i menuen LaTeX i menulinjen. + + Selvom vi forsøger at give dig en god idé om hvad &latex; er, kan dette ikke være den definitive guide til &latex;. Hvis du vil lære dig &latex; så måske du kan låne en bog på biblioteket. Forfatteren har gode erfaringer med "A Guide to &latex;" af H.Kopka og P. W. Daly, og har den stadigvæk på boghylden. + + Som andre mærkesprog har &latex; en indledning, preamble som indstiller de globale kommandoer, såsom papirsstørrelse, sidenummerering, tekstens dimensioner på siden, og en brødtekst, som indeholder dokumentets tekst. Indledningen indeholder i det mindste kommandoerne \documentclass, og går forud for brødtekstdelen, som begynder med kommandoen \begin{document}, som forudsigeligt afsluttes med kommandoen \end{document}. + + + + + + &kile;s hovedfunktioner + + + + Hurtigstartsguide + + Guiden som er indbygget i &kile; er en nyttig funktion til hurtigt at kunne begynde at lave dokumenter med &kile;. Ved at vælge guiden i menulinjen, får du flere forskellige valgmuligheder for at oprette et dokument. På denne måde kan brugere hurtigt angive dokumenttypen de vil oprette, om det er en artikel, en bog, et brev, en rapport eller et tomt dokument. Du kan også direkte indstille valgmuligheder som hører sammen med dokumentet. + + Guidens tilvalg: + + + Dokumentklasse: vælg typen af dokument du ønsker at lave: Artikel, brev, rapport, bog eller selvdefineret. + Skrifttypestørrelse: fortæl &kile; hvilken punktstørrelse du ønsker at bruge. + Papirsstørrelse: vælg størrelse eller stil for papir. + Tegnsæt: du vil næsten altid ønske at bruge tegnsættene Latin-1 eller UTF-8, så du kan indtaste ord som naïveté direkte, og ikke med ASCII-kodningen na\"\ivet\'e; der er imidlertid mange muligheder, såsom Latin 5 for tyrkisk. + Forfatterens navn: Indtast dit navn her. + Dokumentets titel: Tilføj dokumentets titel her. + Øvrige tilvalg: dette lader dig indstille yderligere valgmuligheder såsom udskrift, kladde, og andet. + + + + + + + Fordefinerede skabeloner + + De fordefinerede skabeloner i &kile; er: + + + Empty document: Rigtige mænd begynder med begyndelsen! + Article: Indstiller formatet for en artikel, et dokument kort nok til ikke at behøve at opdeles i kapitler. + Report : Indstiller formatet for en rapport, et dokument af mellemstørrelse, med for eksempel sidenummerering ved sidens yderkant. + Book: Indstiller bogformatet, en fuldstændig variant, så kraftfuld at den bruges til at skrive mange universitetslærebøger. + Letter: Indstiller formatet for et brev, som automatisk kan gøre de irriterende indrykninger som ingen egentlig kan huske. + + + Nye brugere behøver ikke bekymre sig, denne liste er kun en kortfattet beskrivelse af funktioner og mere opmærksomhed vil blive brugt på at gøre opgaverne færdige i detalje senere i . + + + + + + Syntaksfarvelægning + + &kile; ligner programmer som håndterer kildekode og redigering, og farvelægger automatisk kommandoer, tilvalg og objekter som bruges eller misbruges. På den måde gør &kile; det muligt nemt at opdage problemområderne. Hvis du for eksempel ser at store dele af teksten bliver grøn, er det sandsynligt at du har glemt at afslutte en matematisk omgivelse et elle andet sted. Du ville have opdaget det alligevel, ved at resultatet ville have set forfærdeligt ud, men farvelægning sparer virkelig tid og bekymringer. + + + + + + Automatisk komplettering af omgivelser + + Automatisk komplettering af omgivelser betyder at når du påbegynder en ny omgivelse ved for eksempel at skrive \begin{omgivelse}, tilføjer &kile; automatisk en matchende \end{omgivelse}-kommando, med en linje til din tekst imellem. Du kan naturligvis deaktivere funktionen hvis du vil fra OpsætningIndstil Kile... LaTeXOmgivelser. + + + + + + Gå til strukturelement + + Alle dokumenter er normalt strukturerede i et hierarki af en type. &latex; lader dig opdele dokumenter i følgende hierarki (part er længst oppe i hierarkiet og subparagraph længst nede): + + + \part + \chapter + \section + \subsection + \subsubsection + \paragraph + \subparagraph + + + Når et dokument betragtes i struktur-visningen, kan du flytte dig mellem elementer ved at klikke på elementet som du vil se. + + + + + + Omvendt søgning + + Når du laver din egen &latex;-fil, kan omvendt søgning være til stor hjælp. Når du har oprettet en DVI-fil (DeVice Independent), og klikker med musens midterknap i DVI-viseren, går &kile; til den tilsvarende linje i &latex;-kildekoden. + + En DVI er en slags fil som indeholder en beskrivelse af et formateret dokument, sammen med anden information, inklusive skrifttype for tegn, og er almindelig uddata fra &tex; eller &latex;. Et antal værktøjer findes til at vise og udskrive DVI-filer på forskellige systemer og enheder. En DVI-fil kaldes sommetider også for en metafil. + + + + + + Søgning fremad + + Når omvendt søgning bruges, associeres valg af objekter i DVI-filen med editoren, så når du klikker i en DVI-fil, går hovedvinduet til det tilsvarende sted i editorens &latex;-kode. Søgning fremad er det nøjagtigt modsatte af dette. Søgning fremad lader dig klikke på en særlig del af teksten i &latex;-koden, og gå til det tilsvarende sted i DVI-viserens vindue. + + + + + + + + Værktøjslinjen + + + Ny: Påbegynd et nyt dokument. + Åbn: Åbn et nyt dokument. + Luk: Luk dokumentet. + Definér dette dokument som 'Hoveddokument': Dette bruges når du arbejder med flere filer. Ved at have et hoveddokument, kan du arbejde nemmere med andre .tex -filer inkluderet i dokumentet. + Hurtigbyg: Kompilerer al &latex;-kildekode og viser automatisk resultatet, hvis du ikke har fejl i koden. + Filovervågningstilstand: Denne tilstand "overvåger" DVI-filen for ændringer, og vil ikke starte en ny session med &kdvi; efter Quickbuild. + Vis logfil: Vis .log-filen, så du kan få øje på fejl. + Foregående fejl: Går baglæns gennem .log-filen og markerer fejl i kildekoden. + Næste fejl: Går fremad gennem .log-filen og markerer fejl i kildekoden. + ææStop: stopper nuværende funktion. + Latex: Kør &latex; for det aktive dokument. + Vis DVI: Starter DVI-viseren. + DVI til PS: Konverterer DVI til &postscript; (PS). + Vis PS: Starter &postscript;viseren (PS). + PDF-Latex: Laver PDF fra &latex;-kildekode, hvis du har et &latex;-hoved. + Vis PDF: Viser PDF. + DVI til PDF: Konverterer en DVI til en PDF. + PS til PDF: Konverterer PS til PDF. + Latex til HTML: Laver HTML-kode ud fra &latex;-kildekoden. + Vis HTML: Viser HTML som blev lavet. + Kdvi fremadsøgning: Gå til siden som svarer til nuværende linje i editoren. + + + Hvis du kigger på redigeringsværktøjslinjen, ser du tre store dropned-menuer. De er konstruerede for at brugeren hurtigt skal kunne tilføje visse almindelige funktioner til dokumentet. Det første dropned-felt bruges til hurtigt at opdele dokumentet i dele, kapitler, afsnit osv. Tilgængelige kommandoer for at tilføje dele til &latex;-kildekoden er: + + + part: højeste afsnitsniveau i et dokument. + chapter: indleder et nyt kapitel. + section: laver et nyt afsnit. + subsection: laver et nyt underafsnit. + subsubsection: et sekundært afsnit som ligger mellem afsnit og paragraf. + paragraph: laver en ny paragraf. + subparagraph: laver en ny delparagraf. + + + Dropned-feltet der hedder label, bruges til at indsætte objekter i dokumentet, såsom indeks, fodnoter og referencer; de tilgængelige kommandoer er: + + + label: en kommando som laver et kapitel, en figur eller et andet element. + index: laver en indgang i indekset. + footnote: laver en fodnote i dokumentet. + ref: anvendes til at henvise til en tidligere defineret etiket, som du kan vælge i en dropned-liste. + pageref: ligesom ref, men refererer til en side i stedet for et strukturelement. + cite: laver en reference med data fra en bibliografi. + + + + Etiket dropned-menu + + + + + + Etiket dropned-menu + + Etiket dropned-menu + + + + + Vælg etiket for en reference + + + + + + Vælg etiket for en reference + + Vælg etiket for en reference + + + + Når cite bruges vises et dropned-felt med bibliografipunkter, men hvis du bruger &bibtex; vil dette kun virke hvis filen tilhører projektet. Du kan så bruge &gbib;, &pybliographer; eller gøre i hånden. + + Det sidste dropned-felt som hedder tiny, bruges til at indstille tekstens størrelse. Du kan størrelse for hovedteksten, fodnoter, osv. Tilgængelige kommandoer er: + + + tiny: mindst. + scriptsize: meget lille. + footnotesize: mindre. + small: lille. + normalsize: normal. + large: stor. + Large: større. + LARGE: endnu større. + huge: kæmpestor. + Huge: størst. + + + + + + + + Kom i gang + + + + Skriv et &latex;-dokument med &kile; for nybegyndere + + Brugere af &kile; har to muligheder når de påbegynder et nyt dokument: de kan bruge Guiden til at begynde på et nyt dokument, vælge hvilken dokumenttype de vil oprette, og valgene såsom tegnstørrelse, papirsstørrelse, osv; ellers kan de indtaste koden i hånden. + + + \documentclass[12pt]{article} + \begin{document} + Her er en masse tekst kodet med \Latex. + \end{document} + + Hvert dokument i &latex; begynder med kommandoen \documentclass{Dokumenttype}, hvis du ikke bruger en ældre &latex;-udgave, hvor kommandoen er \documentstyle{Dokumenttype}. For øjeblikket er der to almindelige udgaver af &latex;, som du kan støde på, version 2.09, som bruger \documentstyle og version 2ε, som bruger \documentclass til at indlede et dokument. Kommandoen \documentclass følger altid syntaksen \documentclass[valgfrit argument]{klasse}. + + Ved at indtaste kodeeksemplet ovenfor fra tekstruden får du følgende udskrift: + + + Her er en masse tekst kodet med &latex;. + + De kantede parenteser som følger efter kommandoen \documentclass indeholder valgmuligheder for kommandoen. Valget [12pt] indstiller tegnstørrelsen for artiklen. Hvis du ikke indstiller tegnstørrelsen i begyndelsen, kan du indstille den senere i teksten. + + Når du har skrevet kodeeksemplet i feltet ovenfor, skal du kompilere &latex;-kildekoden. Den enkleste måde du kan kompilere &latex; er at bruge Bygge-menuen eller bruge Hurtigbyg-knappen. + + &Alt;2 er genvejstasten for at kompilere din kildekode. + + Du skal gemme kildekoden inden du kan kompilere, &kile; gør dette automatisk for dig. + + Hvis dokumentet ikke kompilerede, så tjek loggen for fejl. Når Hurtigbyg-tasten bruges, skal &kdvi;-viseren startes automatisk; hvis den ikke gør det, så kig i loggen. + + + + + Omgivelser + + En omgivelse er et stykke af teksten der håndteres anderledes resten af dokumentet. Du laver for eksempel en rapport med tegnstørrelsen 12 punkter, men du har brug for at ændre tegnstørrelsen for nogle få sætninger. Kommandoen \begin{omgivelse}, \huge og \end{omgivelse}, tillader dig midlertidigt at ændre teksten mellem omgivelseskommandoerne så den bliver kæmpestor. + + Ændringerne gælder kun fra \begin{omgivelse} til \end{omgivelse}. Der er ingen begrænsninger for hvor mange ændringer du kan lave indeni en omgivelse. + + Der er mange funktioner som du kan tilføje til dokumentet for at gøre det mere læsbart og brugervenligt. Du kan tilføje funktioner såsom specielle skrifttyper, fede typer, kursiv, understregning, osv. i dokumentet, og kommandoerne afsluttes enten med \end eller med slutningen på omgivelsen. + + + \begin{emph} eller \begin{em}: Denne kommando gør teksten kursiv, og gælder til koden kommer til kommandoen \end{em}, \end{emph} eller en anden omgivelse. For at kursivere et ord i en sætning, kan du bruge syntaksen: dette er \em{min} sætning. + \bfseries{Jeg laver teksten mellem parenteserne om til fed type}: Kommandoen gør teksten til fed type. Fed type kommandoen fortsætter til en afsluttende parentes findes. + \qoute: for at oprette et citat i dokumentet: indledes det med \begin{quote} og det afsluttes med \end{quote}. + \center: Centrerer teksten. + \verse: Laver indrykninger af tekst for vers. + \itemize: Laver en punktliste. + + + + + + + Brug af &kile; + + Nu da vi har givet dig en vis baggrund for hvordan man skriver kode ved &latex;-opmarkeringssproget, viser vi hvordan et dokument laves skridt for skridt ved brug af &kile;. + + + Start &kile;. + Opret et nyt dokument med Fil Ny Tomt dokument. + Vælg GuideHurtigstart, og vælg derefter et format og indstil det du ønsker i guiden. + Når guiden har indtastet noget til tekst, så lav nogle indstillinger for at få dokumentet mere læsbart. Tilføj mindst et citat, noget fed type, en kursivstil og et vers for at se forskellen mellem kommandoerne. + Gem filen og giv den navnet intro.tex. + Byg dokumentet med &Alt;2 eller knappen som hedder Latex. + Vælg Vis Dvi. + Kontrollér al din nye tekst. + Når du er færdig med at kigge på dokumentet, klik på knappen Vis editor for at gå tilbage til editoren, hvis du bruger den indlejrede fremviser, eller luk visningsvinduet hvis du bruger en separat fremviser.. + + + Det er det hele. Du har netop lavet dit første &latex;-dokument. + + Når du har oprettet DVI-filen, kan du udskrive dokumentet eller konvertere det til &postscript; eller en PDF-fil hvis du ønsker det. Hav sjov med at eksperimentere! + + + + + + DVI-filer + + DVI betyder DeVice Independent (enhedsuafhængig). Filerne laves af &tex; eller &latex; for at læses af en driver af en slags på maskinen. Der er mange typer udskrift som kan bruges med DVI, såsom en printer, PDF, &postscript; eller maskinens skærm. + + + + Vis en DVI-fil + + Du har allerede set hvordan man viser en DVI-fil på skærmen ved at bruge knappen Vis DVI i værktøjslinjen. + + + + + + Udskriv en DVI-fil + + For at udskrive en DVI-fil, kan du bruge samme proces som du tidligere brugte til at oprette dokumentet (se ). Ved skridt 7, i stedet for at klikke på Vis DVI, så vælg Fil Udskriv i viseren, og hvis printeren er indstillet rigtigtvil du kunne udskrive DVI-filen. + + + + + + Udskriv en DVI-fil manuelt fra en terminal + + For at udskrive en DVI-fil manuelt fra en terminal, bruges kommandoen dvips intro.dvi. Kommandoen konverterer din DVI-fil til en &postscript;-fil. Når filen er konverteret, kan du udskrive den med kommandoen lpr intro.ps. + + + + + + Eksport af en DVI-fil + + Værktøjslinjen giver mulighed for at eksportere en DVI-fil til andre formater. Når du har oprettet en DVI-fil fra din &latex;-kildekode, vil du kunne eksportere den til det format du vil have ved brug af knapperne i værktøjslinjen. + + + + + + + + Søgning fremad mellem &kile; og &kdvi; + + Funktionen for søgning fremad lader dig gå direkte fra editoren til tilsvarende position i &DVI;-filen. + Alle nylige udgaver af &tex;/&latex; inkluderer den nødvendige information automatisk. Hvis du bruger version 2 eller senere af &tetex;-distributionen kan du bruge kommandolinjeflaget src-specials med &tex;- eller &latex;-kommandoen, som følger: latex --src-specials min-fil.tex + + + + &kile; tilbyder en indstilling for dette tilvalg for alle binære &latex; filer. Gå til Opsætning Indstil Kile... VærktøjerByg og altid vælgeindstillingen Moderne. + + For at udføre en fremadsøgning placeres markøren på en linje i kildekoden, og så klikkes på Kdvi fremadsøgning for at komme til det tilsvarende sted i DVI-fremviserens vindue. + + + + + Invers søgning mellem &kile; og &kdvi; + + Omvendt søgning er en meget nyttigt funktion når du skriver et &latex;-dokument selv. Hvis alt er rigtigt indstillet, kan du klikke på &kdvi;s vindue med musens midterste knap (på visse system som ikke har en mus med tre knapper, kan du bruge venstre og højre museknap samtidigt). Derefter vises din favoriteditor, den indlæser &latex;-kildekodefilen og går til det rette sted. For at bruge omvendt søgning, må du kompilere din &latex;-fil med Modern-indstilling. + + Omvendt søgning kan ikke virke hvis ikke: + + + Det er lykkedes at kompilere kildekodefilen. + &kdvi; ved hvilken editor du vil bruge + + + Med denne funktion i &kdvi;, vil et museklik på musens midterknap i DVI-dokumentet få &kile; til at åbne det tilsvarende &latex;-dokument og forsøge at gå til den tilsvarende linje. Husk at bede &kdvi; om at bruge &kile; som teksteditor i &kdvi;'s menupunkt OpsætningDVI-valg.... + + + Indstil &kdvi; + + + + + + Indstil &kdvi; + + Indstil &kdvi; + + + + + + + + Løsning af fejl + + Hvis du forsøger at bruge hurtigbygning, men DVI-viseren ikke åbnes, er der stor chance for at du har en fejl. Hvis du har en fejl, ses det i logfilen eller meddelelsesvinduet, og et sammendrag af fejlen gives. + + Logfilen forklarer grunden til fejlen i din kode. I editoren kan du bruge knapperne i værktøjslinjen som hedder Foregående LaTeX-fejl og Næste LaTeX-fejl til at gå mellem forskellige fejl. Logfilen angiver altid på hvilken linje fejlen opstod. For at se linjen hvor en fejl opstod, klikkes på fejlen i logvinduet så vil &kile; tage dig til den linje som svarer til fejlen. + + + + + + + Påbegynd et nyt dokument + + Når du klikker på knapperne i værktøjslinjen for at påbegynde et nyt dokument, vises en dialog som spørger hvilken slags skabelon du vil bruge til at skrive dokumentet. Dine standardvalgene er: + + + Tomt dokument + Brev + Bog + Artikel + Rapport + Scrartcl (fra KOMA-scriptpakken) + Scrbook (fra KOMA-scriptpakken) + Scrlttr2 (fra KOMA-scriptpakken) + Scrreprt (fra KOMA-scriptpakken) + + + Hvis du vælger Tomt dokument, kan du enten begynde at skrive dokumentet fra begyndelsen, eller bruge guiden for hurtigt at påbegynde et nyt dokument (se ). + + + + + Skabeloner + + Hyppige brugere af &latex; bruger typisk den samme preamble til næsten hvert dokument de bruger. Skabeloner kan oprettes, gemmes og indlæses inde fra &kile; for at gøre det nemmere at starte et nyt dokument. + + + + Opret en ny skabelon + + For at oprette en ny skabelon, skal du først enten åbne en &tex;- eller &latex;-fil, eller påbegynde en egen fil. &kile; kan oprette en skabelon ud fra et eksisterende dokument ved at åbne det ønskede dokument og vælge Fil Opret en skabelon ud fra dokument. + + + + + + Indstil automatiske erstatninger + + Når et nyt dokument laves ved at vælge en skabelon med Fil Ny, erstattes visse tegnkombinationer med data såsom dit navn eller tegnsættet du bruger. Disse variabler kan indstilles under OpsætningIndstil Kile... OpsætningGenerelt. + + Når du laver dine egne skabeloner er det nyttigt at vide hvilke tegnkombinationer der erstattes med hvilke skabelonvariabler: + + + $$AUTHOR$$: Denne streng erstattes med variablen forfatter. + $$DOCUMENTCLASSOPTIONS$$: Denne streng erstattes med variablen dokumentklassetilvalg. Typisk bruges dette som følger: \documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}. + $$INPUTENCODING$$: Hvis variablen indtastningstegnsæt er indstillet til, lad os sige latin1, erstattes strengen af \input[latin1]{inputenc}. + + + + + + + Opret en skabelon ud fra guiden + + Den enkleste måde at oprette en ny skabelon på er at starte guiden, og derefter at tilføje kommandoer til editoren. Når du har fået dokumentet sat op som du vil have det: + + + Gem filen; + Gå til Fil; + Vælg Opret skabelon ud fra dokument; + Lav alle nødvendige ændringer i skabelonen; + Indtast et navn på den nye skabelon; + Klik på O.k. for at tilføje skabelonen til menuen. + + + Næste gang du starter et nyt dokument, kommer du til at kunne vælge din indstillede skabelon i stedet for de almindelige skabeloner. + + + + + + Opret en skabelon ud fra vilkårlig fil + + En skabelon kan laves ud fra en hvilken som helst &latex;-fil. Hvis du søger efter en nem måde at indstille en skabelon, så hent en fil du synes om på internettet, og følg samme skridt som angives under . + + Du vil for eksempel måske oprette en fuldstændig A0-plakat. Sådanne plakater vises ofte på videnskablige konferencer, og &latex; hjælper dig med at lave en attraktiv plakat som vækker opmærksomhed. Du kan hente en skabelon for A0-plakater på Jonathan Marchinis hjemmeside, men der findes mange flere.Husk at du har brug for pakken a0poster, som normalt ikke findes i en almindelig &tetex;-installation, så du vil skulle hente den, kopiere den til en &tex;-mappe, for eksempel /usr/share/texmf/tex/latex/a0poster/, og køre texhash så &latex; ved at den eksisterer. Glem ikke at sætte filens tilladelser så alle kan læse filen. + + + + + + Fjern en skabelon + + For at fjerne en skabelon fra &kile;, gør som følger: + + + Gå til OpsætningFjern skabelon...; + En dialog vises hvor alle skabeloner er på en liste: vælg en skabelon; + Klik på O.k., så fjernes skabelonen. + + + Skabeloner markerede med en stjerne (*) kan ikke fjernes uden de rigtige rettigheder. + + + + + + + + + Redigér &latex;-dokumenter + + Den interne editor som &kile; bruger er &kate;. Kate er en teksteditor lavet for programmører, som har indbygget mulighed for at læse og farvelægge mange forskellige slags tekstfiler, blandt andet &latex; og &bibtex;; du har adgang til mange valgmuligheder for &kate; direkte fra &kile;'s Værktøjer-menu. + + For at lære dig mere om &kate;, og dens muligheder, se Kate's håndbog. Brugere af &kile; kan begynde at læse i kapitlet Arbejd med Kate-editoren. + + + + &latex;-Reference + + &kile; har en meget praktisk &latex; mærke-reference, som du har adgang til ved at vælge HjælpLaTeX Reference. Den indeholder en gennemgående beskrivelse af næsten alle kommandoerne som du måtte bruge i &latex; og deres syntaks. + + + + + + Markørbevægelser + + For at markere tekst, har du følgende muligheder: + + + Hold venstre museknap nede og træk for at markere tekst. + Klik én gang på et ord for at flytte markøren til et nyt sted. + Klik to gange på et ord for at vælge hele ordet. + Klik tre gange for at vælge hele sætningen. + + + Ved at holde museknappen nede og trække hen over teksten du vil vælge, kopieres den automatisk til klippebordet. + + Ved at holde shift-tasten nede og bruge piletasterne kan du vælge dele af kildekoden i editorvinduet. + + + + + + Parenteser + + Komplettering af parenteser er et visuelt værktøj som editoren bruger til at vise dig hvilke parenteser som passer sammen. Hvis du åbner en fil med filendelsen .tex, og markerer hvilken som helst parentestype, såsom parenteser (), kantede parenteser [] eller tuborgparenteser {}, så farvelægges matchende parentestyper i gult (denne standardfarve kan ændres). Så hvis du for eksempel placerer markøren på en tuborgparentes i \section{Introduktion}, ser du farvelægning af \section{Introduktion} med standardfarven gul, som viser dig stedet for den indledende og afsluttende parentes. + + + + + + Farvelægning + + &kile; har mulighed for at lede efter og farvelægge forskellige slags kode. &latex;-kommandoer adskilles for eksempel fra normal tekst, og formler farvelægges også med en anden farve. + + + + + + Punkter + + Mange guider kan indsætte valgfrie punkter, en særlig slags bogmærke indeni teksten. Menupunkterne RedigérPunkter eller tilsvarende genvejstaster lader dig gå til næste eller foregående punkt. Dette markerer også punktet så det automatisk fjernes når du skriver det første bogstav. + + + Punkter + + + + + + Punkter + + + + + + + &Ctrl;&Alt;Højrepil Næste punkt + Gå til næste punkt i teksten hvis der er et. + + + &Ctrl;&Alt;Venstre pil Foregående punkt + Gå til foregående punkt i teksten hvis der er et. + + + + + + + + + Markér + + Redigering er naturligvis et af hovedaspekterne når du bruger et program som &kile;. Selv om &kate; har store muligheder, lægger tilføjer &kile; visse vigtige funktioner, som især behøves til at skrive &latex;-kildekode. &latex; behøver altid en stor mængde omgivelser og grupper, så &kile; understøtter meget specielle kommandoer for at vælge dem. Under Redigér Markér finder du følgende kommandoer til at markere tekst: + + + Punkter + + + + + + Punkter + + + + + + &Ctrl;&Alt;S E Omgivelse (indeni) + Markér et omgivelse uden de omgivende mærker. + + + &Ctrl;&Alt;S F Omgivelse (udenfor) + Markér et omgivelse inklusive de omgivende mærker. + + + &Ctrl;&Alt;S T Tex-gruppe (indeni) + Markér en Tex-gruppe indenfor de omgivende parenteser. + + + &Ctrl;&Alt;S U Tex-gruppe (udenfor) + Markér en Tex-gruppe inklusive de omgivende parenteser. + + + &Ctrl;&Alt;S P Paragraf + Markér en hel paragraf, dvs. en gruppe med linjer af tekst adskilt på begge sider af tomme linjer. En paragraf betyder ikke kun kontinuerlige linjer af tekst, som i andre teksteditorer. Den udvidede betydning omfatter også tabeller, &latex;-kommandoer og andre kildekodelinjer. Det eneste vigtige for &kile; er at alle slags paragraffer er omgivet af to tomme linjer. + + + &Ctrl;&Alt;S L Linje + Markér tekstlinjen på markørens nuværende position. + + + &Ctrl;&Alt;S W TeX-ord + Markér ordet under nuværende markør. Markeringen har også en udvidet betydning, eftersom denne kommando også kan markere &latex;-kommandoer som begynder med et baglæns skråstreg og desuden kan have en mulig stjerne til sidst. + + + + + + + + + Slet + + For at slette dele af et dokument kan du naturligvis markere dem, og derefter bruge tasten Delete. Men &kile; tilbyder en hurtigere måde med sine egne slette kommandoer. De adskiller sig kun fra markeringskommandoen på et sted, eftersom kommandoen SletLinje ikke er implementeret. &kate; tilbyder allerede en sådan kommando med &Ctrl;K, så der er ingen grund til at tilføje yderligere en. Under RedigérSlet finder du følgende kommandoer for at fjerne tekst: + + + Punkter + + + + + + Punkter + + + + + + &Ctrl;&Alt;T E Omgivelse (indeni) + Slet et omgivelse uden de omgivende mærker. + + + &Ctrl;&Alt;T F Omgivelse (udenfor) + Slet en omgivelse inklusive de omgivende mærker. + + + &Ctrl;&Alt;T T Tex-gruppe (indeni) + Slet en Tex-gruppe indenfor de omgivende parenteser. + + + &Ctrl;&Alt;T U Tex-gruppe (udenfor) + Slet en Tex-gruppe inklusive de omgivende parenteser. + + + &Ctrl;&Alt;T P Paragraf + Slet en hel paragraf. Kig på kommandoen MarkérParagraf, for at se hvordan en paragraf defineres i &kile;. + + + &Ctrl;&Alt;T W TeX-ord + Slet ordet eller &latex;-kommandoen på markørens nuværende position. + + + + + + + + + Omgivelse + + Det har allerede været nævnt at omgivelser spiller en central rolle i &latex;. &kile; tilbyder derfor fire andre kommandoer, for at gøre arbejdet med &latex; så enkelt som muligt, i undermenuerne RedigérOmgivelse. + + + Punkter + + + + + + Punkter + + + + + + + &Ctrl;&Alt;E B Gå til start + Kommandoen går til begyndelsen af nuværende omgivelse, hvor end nuværende position er. Markøren placeres direkte før omgivelsens indledende mærke. + + + &Ctrl;&Alt;E E Gå til slut + Kommandoen går til slutningen af nuværende omgivelse, hvor end nuværende position er. Markøren placeres direkte efter omgivelsens afsluttende mærke. + + + &Ctrl;&Alt;E M Match + Når markøren er placeret udfor eller ovenfor mærket \begin{omgivelse}, flyttes den til modsatte ende af omgivelsen og omvendt. + + + &Ctrl;&Alt;E C Luk + Når du skriver en mængde omgivelsesmærker indeni hinanden, kan du miste kontrol over alle omgivelserne. Denne kommando afslutter den senest indledte omgivelsen, så rækkefølgen i omgivelsernes struktur ikke brydes. + + + + + + + + + &tex;-gruppe + + &kile; tilbyder også nogle specialkommandoer for &latex;-grupper, som bestemmes af parenteser {...}. I undermenuen RedigérTex-gruppe finder du nogle vigtige kommandoer, som svarer til dem fra RedigérOmgivelse. + + + Punkter + + + + + + Punkter + + + + + + &Ctrl;&Alt;T B Gå til start + Kommandoen går til begyndelsen af nuværende gruppe, hvor end nuværende position er. Markøren placeres direkte før den indledende parentes. + + + &Ctrl;&Alt;T E Gå til slut + Kommandoen går til slutningen af nuværende gruppe, hvor end nuværende position er. Markøren placeres direkte efter den afsluttende parentes. + + + &Ctrl;&Alt;T M Match + Når markøren er placeret ud for eller efter en indledende parentes i en &tex;-gruppe, flyttes den til modsatte ende af gruppen og omvendt. + + + &Ctrl;&Alt;T B Luk + At skrive mange parenteser for grupper indeni hinanden kan være hårdt arbejde. Denne kommando afslutter den senest indledte gruppe, så rækkefølgen af &tex;-grupper ikke brydes. + + + + + + + + + Dobbelte citationstegn + + I &latex; bruges to enkle citationstegn som dobbelte citationstegn. For at hjælpe dig at indsætte dem effektivt, tillader &kile; dig at trykke på " for at indsætte to indledende enkle citationstegn. Hvis du desuden vil afslutte et citat, skal du også trykke på ". &kile; er smart nok til at genkende dette tilfælde og indsætte to afsluttende citationstegn for &latex;. + + For i stedet at få et egentligt dobbelt citationstegn, trykkes to gange på ". + + Du kan aktivere eller deaktivere automatisk at indsætte indledende og afsluttende dobbelte citationstegn i OpsætningIndstil Kile...Latex. + + + Punkter + + + + + + Punkter + + + + + Hvis du desuden inkluderer sprogspecifikke tilvalg eller stilfiler såsom german eller french, kan du også bruge tyske eller franske dobbelte citationstegn. + + Disse citationstegn bruges også for andre sprog. Kig i &tetex;-dokumentationen for at få styr på hvilket tilvalg eller hvilken stilfil som skal bruges for sproget du bruger. + + + + + + Smart nylinje + + Hvis du trykker på &Shift;Retur, indsætter &kile; en intelligent nylinje. Hvis din nuværende position er inde i en listeomgivelse såsom enumerate eller itemize, indsætter &kile; ikke kun en ny linje, men tilføjer også kommandoen \item. + + Hvis du er inde i en tabelomgivelse, afslutter &kile; nuværende linje med \\, fulgt af nylinjen. + + Endnu bedre er at &kile; er smart nok til at understøtte fordefinerede &latex;-omgivelser og brugerdefinerede omgivelser, som kan tilføjes under OpsætningIndstil Kile... Latex. + + + + + + Smart tabulator + + Nogle brugere synes om at arrangere søjler i tabelomgivelser og placere alle og-tegn & under hinanden. &kile; forsøger at understøtte dette. Hvis du trykker på &Shift;&Alt;&, kigger &kile; efter næste tabulatortegn i linjen ovenfor. Selvom det ikke svarer til tabulatoren, tilføjer &kile; nogle mellemrum for at justere søjlepositionen til nuværende tabulator. + + + + + + + + Kodekomplettering + + Selv om &kate; tilbyder en god kompletteringstilstand, udvider &kile; kodekomplettering for at understøtte visse specielle metoder for &latex;. Fem forskellige metoder er integrerede. Tre af dem virker på forespørgsler, mens de to øvrige er automatiske kompletteringstilstande. Alle metoder kan indstilles til at arbejde på meget forskellige måder med OpsætningIndstil Kile.... + + + + Automatisk komplettering af omgivelser + + Når du påbegynder en ny omgivelse ved at skrive \begin{omgivelse}, tilføjer &kile; automatisk kommandoen \end{omgivelse}, med en linje til din tekst imellem. + + Automatisk komplettering kan slås fra på siden &latex; under OpsætningIndstil Kile... LatexOmgivelser. + + + Komplettering af en ligningsomgivelse + + + + + + Komplettering af en ligningsomgivelse + + Komplettering af en ligningsomgivelse + + + + + + + + &latex;-kommandoer + + Når du skrevet nogle bogstaver kan du aktivere kompletteringstilstand for &latex;-kommandoer og normale ord med RedigérKomplettér(La)tex kommando eller genvejstasten &Ctrl;Mellemrum. &kile; læser først bogstaver fra markørens nuværende position til venstre og stopper ved det første tegn som ikke er et bogstav eller ved en baglæns skråstreg. Hvis mønstret begynder med en baglæns skråstreg, går &kile; ind i kompletteringstilstand for &tex;- eller &latex;-kommandoer. Afhængig af den valgte tilstand, vises et kompletteringfelt. Du ser alle kommandoer eller ord hvis begyndelse matcher nuværende mønster. Du kan navigere med piltasterne i listen og vælge en indgang med returtasten eller med et dobbeltklik med musen. + + + Komplettering af en Latex-kommando + + + + + + Komplettering af en Latex-kommando + + + + + Når du trykker på tasten Backspace, fjernes det sidste bogstav i mønstret, og kompletteringslisten kan vokse. På den anden side, hvis du skriver et bogstav til udvides mønstret og den synlige liste med ord kan mindskes. + + Hvis du bestemmer dig for ikke at vælge nogle af forslagen, kan du forlade dialogen med Esc. + + Du bemærker at alle kommandoer skrives med en kort beskrivelse af deres parametre. Beskrivelserne fjernes naturligvis når du vælger en kommando. Alternativt kan du lade &kile; indsætte punkter på disse steder, så du nemt kan hoppe til disse steder med RedigérPunkterNæste punkt og indsætte parameteren du vil bruge. + + + Komplettering af en Latex-kommando + + + + + + Komplettering af en Latex-kommando + + + + + Gå til OpsætningIndstil Kile...Kile Komplettér for at indstille en eller flere af listerne. Du kan vælge forskellige ordlistor for &tex;- og &latex;-kommandoer og ordlistetilstand for almindelige ord. + + + + + + Omgivelser + + Kommandotilstand er ikke nyttigt til at komplettere omgivelser. Du skal altid indtaste nogle af bogstaverne \begin, og at aktivere kompletteringstilstand giver en enorm liste med omgivelsesmærker som resultat. På den anden siden bruges omgivelser så ofte at &kile; tilbyder en særlig måde at komplettere omgivelser. Glem det indledende mærke og skriv for eksempel eq. + + Når du kalder kompletteringstilstand med RedigérKomplettérOmgivelse eller genvejstasten &Alt;Mellemrum, tilføjes det indledende mærke automatisk, og du ser \begin{eq}. Efter denne ændring er kompletteringslisten meget mindre rodet. + + + Komplettering af en Latex-kommando + + + + + + Komplettering af en Latex-kommando + + + + + Markér nu en omgivelse, så ser du at den automatisk afsluttes. Derudover, hvis &kile; genkender den som en listeomgivelse, indsættes også det første mærke \item. + + + Komplettering af en Latex-kommando + + + + + + Komplettering af en Latex-kommando + + + + + Gå til OpsætningIndstil Kile... Kile Komplettér for at indstille en eller flere af listerne. Metoden bruger samme ordlister som komplettering for &tex;- og &latex;-kommandoer. + + + + + + Forkortelser + + &kile; understøtter brugerdefinerede lister med forkortelser, som erstattes ved forespørgsel af længere tekststrenge. Kig på OpsætningIndstil Kile... KileKomplettér for at indstille en eller flere af disse lister. For eksemplet som gives her skal forkortelseslisten i example.cwl vælges. I den fil finder du for eksempel indgangen L=\LaTeX. + + Skriv for eksempel blot bogstavet L. Aktivér nu ordkompletteringens forkortelsestilstand med RedigérKomplettérForkortelse eller genvejstasten &Ctrl;&Alt;Mellemrum, så erstattes bogstavet L af strengen \LaTeX. + + + + + + Automatiske kompletteringstilstande + + + + &latex;-kommandoer + + Du kan også aktivere automatisk komplettering for &latex;-kommandoer. Når en given tærskel af bogstaver (standard: 3) skrives ind, dukker et vindue op med en liste over alle &latex;-kommandoer som matcher. Du kan vælge en af kommandoerne, eller ignorere vinduet og skrive flere bogstaver. Indgangene i kompletteringsfeltet ændres altid og matcher det ord du for øjeblikket har skrevet. Metoden er begrænset til &latex;-kommandoer, eftersom store ordlister kræver meget hukommelse og tid. + + Gå til OpsætningIndstil Kile... KileKomplettér for at aktivere eller deaktivere dennetilstand, eller for at ændre tærsklen. + + + Komplettering af en ligningsomgivelse + + + + + + Komplettering af en ligningsomgivelse + + + + + + + + + Dokumentord + + Store ordlister er ikke nyttige i automatisk kompletteringstilstand. Men vi har bemærket at mange ord i et dokument skrives mere end en gang. &kile; tilbyder derfor komplettering af alle ord i dokumentet som brugeren allerede tidligere har skrevet. + + Hvis du vil aktivere eller deaktivere denne tilstand, gå til OpsætningIndstil Kile... Kile Komplettér. I indstillingsdialogen kan du også ændre tærsklen for hvornår kompletteringsfeltet dukker op. + + + + + + + + + + Guider og dialoger + + + + Indsæt grafik + + Dialogen Indsæt grafik gør det så enkelt som muligt at indsætte grafik. Tag gerne et kig på og for at få en oversigt af nogle grundlæggende fakta angående grafikformater. + + + Indsæt grafisk element + + + + + + Indsæt grafisk element + + + + + + Vælg en grafikfil. Det kan være en JPEG-fil, PNG-fil, EPS-fil eller til og med en EPS-fil komprimeret med zip eller gzip, hvis det er lykkedes for dig at indstille et rigtigt &tetex;-system. Hvis du har installeret &imagemagick; og desuden indstillet &kile; til at bruge det (OpsætningIndstil Kile... Latex Generelt), vises grafikkens højde og bredde automatisk. Hvis &imagemagick; kan bestemme opløsningen, vises også grafikkens størrelse i centimeter. + + Bestem om billedet skal være centreret på siden. + + Vælg enten traditionel &latex; eller PDF&latex;. Husk at PDF&latex; også kan oprette DVI-uddata, ikke kun PDF. + + Du kan vælge om filnavnet skal være relativt. Dette er måden som foretrækkes når du bruger kommandoen \graphicspath. + + Normalt skal billedfiler være i samme mappe som dit hoveddokument for at de kan findes. Det er dog muligt at placere dem i andre mapper for at gøre tingene pænere. Uden kommandoen \graphicspath, vil &kile; inkludere søgestien til billedfilen. Men hvis du bruger \graphicspath, som: + +\graphicspath{{/søgesti/til/min/grafik}{anden/søgesti/til/mere/grafik}} + + + og markerer dette, bruger &kile; kun billedfilens basisnavn. + + Et andet eksempel: Hvis du angiver kommandoen \graphicspath som: + +\graphicspath{{./}{kamera/}{billeder/}} + + + søger &latex; i nuværende, derefter i kamera og til sidst i billeder for at finde din billedfil. + + Hvis du enten vælger bredde eller højde, skaleres hele billedet proportionalt. Hvis du indstiller to værdier samtidigt for bredde og højde, kan bredde og højde blive skaleret med forskellige faktorer, og det er måske ikke det du vil. Se også informationen længst oppe i dialogen for at få rede på billedets originalstørrelse. + + Angiv en vinkel som billedet skal roteres mod uret. + + Information om omgivende boks indstilles automatisk når du vælger en billedfil. Denne information behøves kun når du arbejder med traditionel &latex;-grafik og punktafbildet grafik. Se beskrivelsen af EPS-grafik. + + Det sidste valg er om billedet skal indlejres i en figuromgivelse. Hvis du vælger at gøre det, kan du også indsætte en overskrift og en etiket. Det er en god idé at tilføje forskellige præfiks for hver type af etiket. Det er almindeligt at bruge præfikset fig: for billeder. + + + + + + + Array trylleri + + En af de kedeligste opgaver man kan have i &latex; er at skrive en matrix eller tabelomgivelse. Man skal holde styr på alle elementer, sørge for at omgivelsen er rigtigt indtastet, og at alt er der hvor det er meningen at det skal være. Gode indrykninger hjælper til, men der er en nemmere måde: Brug &kile;s menu Guide. Udover tilvalget Hurtigstart, indeholder den Tabel og Array (som bruges i matematiske omgivelser). Då får du en matrixformet indtastningsformular, som du nemt kan udfylde med dine værdier. Denne dialog tilbyder også indstillinger for at typesætte tabelmateriale. + + + Indsætning af tabular-omgivelse + + + + + + Indsætning af tabular-omgivelse + + + + + Tilvalget Tabulering viser en enkel menu for at indstille en tabuleringsomgivelse. I alle disse omgivelser kan du nemt indstille antal rækker og søjler, sammen med andre specifikke tilvalg. + + + + + &postscript;-værktøjer + + PS-filer er ikke så populære som PDF-filer, men er en udmærket basis for manipulationer og omarrangering af sider. Hvis du har brug for PDF-uddata, kan du omarrangere sider med nogen &postscript;-værktøjer, og derefter konvertere til PDF med ps2pdf. + + &postscript;-guiden foreslår de mest populære omarrangeringer, men du har frihed til at gøre dine egne valg. Arbejdet udføres af programmerne pstops og psselect, som du finder i de fleste distributioner i pakken psutils. Hvis et af programmerne ikke er tilgængeligt, er den tilsvarende indgang ikke synlig. + + + Indsætning af tabular-omgivelse + + + + + + Indsætning af tabular-omgivelse + + + + + Vælg først inddatafil. Hvis &kile; finder en PS-fil som svarer til det nuværende hoveddokument, er den allerede udfyldt som inddatafil, men du har også frihed til at vælge en anden fil. Vælg derefter uddatafil, og vælg en af opgaverne. Tilsidst skal du vælge om du kun vil udføre konverteringen, eller også starte &kghostview; for at kigge på resultatet. + + + + + 1 A5-side + tom side --> A4 + Kombinér en A5-side med en tom side på en A4-side. Så snart to A5-sider kombineres, roteres de 90 grader og arrangeres på A4-siden med liggende format. + + A5 + tom side + + + + + + A5 + tom side + + + + + + + + 1 A5-side + dublet --> A4 + Placér en A5-side og en dublet sammen på en A4-side. + + dubletter af A5-sider + + + + + + Dubletter af en A5-side + + + + + + + + 2 A5-sider --> A4 + Placér to på hinanden følgende A5-sider sammen på en A4-side. + + Kombinér to A5-sider + + + + + + Kombinér to A5-sider + + + + + + + + 2 A5 liggende sider --> A4 + Placér to på hinanden følgende liggende A5-sider sammen på en A4-side. + + + + 4 A5-sider --> A4 + Kombinér fire på hinanden følgende A5-sider sammen på en A4-side. A5-siderne skal skaleres med faktoren 0,7 for at få plads på siden. + + 4 A5-sider --> A4 + + + + + + 4 A5-sider --> A4 + + + + + + + + 1 A4-side + tom side --> A4 + Kombinér en A4-side med en tom side på en A4-side. Når to A4-sider kombineres på en A4-resultatside, skal de skaleres med faktoren 0,7 og arrangeres med stående format. + + 1 A4-side + tom side --> A4 + + + + + + 1 A4-side + tom side --> A4 + + + + + + + + 1 A4-side + dublet --> A4 + Placér en A4-side og en dublet sammen på en A4-side. + + 1 A4-side + dublet --> A4 + + + + + + 1 A4-side + dublet --> A4 + + + + + + + + 2 A4-sider --> A4 + Placér to på hinanden følgende A4-sider sammen på en A4-side. + + Kombinér to A4-sider + + + + + + Kombinér to A4-sider + + + + + + + + 2 A4 liggende sider --> A4 + Placér to på hinanden følgende liggende A4-sider sammen på en A4-side. + + + + vælg lige sider + Vælg alle lige sider i et dokument. + + + + vælg ulige sider + Vælg alle ulige sider i et dokument + + + + vælg lige sider (omvendt rækkefølge) + Vælg alle lige sider i et dokument og vend om på rækkefølgen. + + + + vælg ulige sider (omvendt rækkefølge) + Vælg alle lige sider i et dokument og vend om på rækkefølgen. + + + + vend alle sider + Vend alle sider i et dokument. + + + + kopiér alle sider (sorterede) + Kopiér alle sider i et dokument. Du skal vælge antal sorterede kopier. + + Kopiér alle sider (sorterede) + + + + + + Kopiér alle sider (sorterede) + + + + + + + + kopiér alle sider (usorterede) + Kopiér alle sider i et dokument. Du skal vælge antal usorterede kopier. + + Kopiér alle sider (usorterede) + + + + + + Kopiér alle sider (usorterede) + + + + + + + + pstops: vælg parameter + Der er mange flag for &postscript;-værktøjerne pstops og psselect. Hvis du vil have et meget specielt, kan du starte pstops med et eget flag. Læs i manualen om alle tilgængelige flag. + + + + psselect: vælg parameter + Du kan starte psselect med et eget flag. Læs i manualen om alle tilgængelige flag. + + + + + + + + Dokumentstatistik + + Statistikdialogen giver dig en statistisk oversigt for en markering, et dokument eller et helt projekt. Den omfatter antal ord, kommandoer og omgivelser i &latex; og indeholder også antal tegn af hver type. Statistikværdier kan kopieres som tekst eller en behageligt formateret &latex;-tabelomgivelse til klippebordet. Hvis du vil have statistik for hele projektet kan du bruge Åbn alle projektfiler som en hurtig måde at åbne alle kildefiler i projektet. + Et advarslens ord skal siges om nøjagtigheden af værdierne. En del logik for at få et godt estimat er inkluderets, f.eks. giver K\"uhler et ord og en kommando, med fire respektive to tegn. Der er dog andre kombinationer hvor dele af kommandoer regnes som ord og modsat. Man bør også tænke på at algoritmen er udviklet og testet med sprog som ligner engelsk eller tysk. Tag altså ikke værdierne for givet. Hvis du skal lave en rapport med et nøjagtigt antal ord eller tegn, så lav nogle forsøg for at se om Kiles nøjagtighed opfylder dine behov. + + + + + + + + Specielle mærker i &latex; + + + Brug &latex;-mærkebibliotek + + &latex; har hundredvis af mærker for symboler og specialtegn. Den nemmeste måde at indsætte et specielt tegn er at bruge sidebjælkemenuen til venstre for redigeringsvinduet. + + + Sidebjælkens menu + + + + + + Sidebjælkens menu + + Sidelbjælkens menu + + + + For at tilføje et specialtegn, så klik på den type tegn som du vil tilføje. Du kan tilføje følgende typer tegn: + + + Relationssymboler + Græske bogstaver + Pilesymboler + Afgrænsere + Diverse symboler + Fremmede tegn + + + + + + + Brug af bibliografiindgange + + \bibitem er en kommando som bruges til at tilføje en reference til en thebibliography-omgivelse i dit dokument. Syntaksen for at bruge \bibitem er \bibitem[etiket]{nøgle}. + + Den valgfrie [etiket] er der for at du skal kunne tilføje dit eget etiketsystem for bibliografiindgangen. Hvis ingen etiket angives, tilføjes indgangene i numerisk rækkefølge: [1], [2], [3] osv. + + Argumentet {nøgle} bruges til at referere og linke kommandoerne \bibitem og \cite til hinanden og informationen de indeholder. Kommandoen \cite indeholder referencen som hører sammen med den ønskede \bibitem, som findes i omgivelsen thebibliography og indeholder referencedata. Begge samhørende \bibitem og \cite skal have samme {nøgle}; den nemmeste måde at organisere nøgler er efter forfatterens efternavn. Den anden parentes i thebibliography-omgivelsen angiver den længste bibliografireference du forventer at have. Så indsætning af {foo} betyder at du kan have en vilkårlig reference kortere end eller så stor som udtrykket foo. Angives denne parameter ikke rigtigt, kan det forårsage mindre attraktive indrykninger i bibliografien. + + Bibliografien er et separat afsnit adskilt fra hoveddokumentet. Et eksempel på kode for bibliografien ville kunne se ud som følger: + + + \begin{thebibliography}{50} + \bibitem{Simpson} Homer J. Simpson. \tekstsl{Mmmmm...kager}. + Evergreen Terrace Printing Co., Springfield, EtStedUSA, 1998 + \end{thebibliography) + + Derefter ville din hovedkildekode indeholde stedet for informationen som har at gøre med dette \bibitem ved at bruge \cite. Kildekoden ville se cirka sådan her ud: + + + Min tese om filosofien i Simpsons\copyright + kommer fra min favoritbog \cite{Simpson}. + + Eftersom det ofte er svært at huske den nøjagtige referencenøgle når du har mange referencer, sørger &kile; for en nem måde at indsætte en reference. I Redigér-værktøjslinjen klikkes på det andet dropned-felt i (oftest viser den label) og vælg cite. En liste med alle referencenøgler vises: vælg den rigtige reference, så indsættes den i dokumentet. For at opdatere listen med nøgler, gemmes enten filen eller RedigérGenopfrisk struktur vælges. + + Slutproduktet i dokumentets bibliografi ser nu sådan her ud: + + [1] Homer J. Simpson. Mmmmm...kager. Evergreen Terrace Printing Co., Springfield, EtstedUSA., 1998. + + Den nemmeste måde at arbejde med \bibitem og \cite er at bruge værktøjslinjens dropned-felt som hedder cite. Når du vælger en reference at indsætte, vises en liste med alle bibitem som du hidtil har oprettet og du kan vælge referencen fra listen. &kile; kan også samarbejde med &bibtex; editorprogrammer såsom &gbib; og &pybliographer; for at gøre referencer nemmere at lave. + + + + + + Brugerdefinerede mærker + + &kile; giver dig muligheden for at lave dine egne mærker. Et mærke er ligesom en genvej det starter nogle kommandoer eller skriver ofte brugt tekst. For eksempel bruger Per Smed ofte sætningerne Jeg foretrækker \LaTeX\ frem for \TeX\ og Hvad ville jeg have gjort uden Linux?. For at lave brugerdefinerede mærker til at skrive disse sætninger, vil han gå ind i BrugerBrugermærkerRedigér brugermærker; der vil han blive præsenteret for en dialog hvor han kan lave sine egne brugerdefinerede mærker. + + + Dialogen Redigér brugermærker + + + + + + Dialogen Redigér brugermærker + + Dialogen Redigér brugermærker + + + + + Aktivér et brugerdefineret mærke + + + + + + Aktivér et brugerdefineret mærke + + Aktivér et brugerdefineret mærke + + + + Han ville formodentlig give hvert mærke et navn som klart identificerer det. Navnet som mærker får skal skrives ind på linjen Menupunkt og teksten for ofte bruge kommandoer skal skrives ind i feltet Værdi. Når kommandoerne er skrevet ind, kan han hurtigt bruge dem med genvejstasten &Ctrl;&Shift;1 for det første mærke, for at indtaste Jeg foretrækker \LaTeX\ frem for \TeX\ og &Ctrl;&Shift;2 for at indtaste Hvad ville jeg gøre uden Linux?. + + + + Pladsholdere i brugerdefinerede mærker + + Der er nogle pladsmarkører som du kan bruge i brugerdefinerede mærker. De er %B, %C, %M og %S. + + + %B: Erstattes med en kugle. + %C: Dette er stedet hvor markøren placeres efter et brugerdefineret mærke er brugt. + %M: Dette står for markeret tekst, hvor den markerede teksten indsættes når et brugerdefineret mærke bruges. + %S: vil blive erstattet med kildekodens filnavn. + + + For at vise hvordan det virker, lad os antage at vi har et brugerdefineret mærke som indeholder værdien \bfseries{%M}%C, og en tekstparagraf er markeret som skal forvandles til fed type. Altså markerer vi teksten Jeg elsker fredage, tilpasser det brugerdefinerede mærke ved at trykke på &Ctrl;&Shift;1 og får teksten \bfseries{Jeg elsker fredage} med markøren placeret efter teksten. + + + + + + + + + + Byggeværktøjerne + + + + Kompilering, konvertering and visning + + For at se resultatet af dit arbejde, skal du først kompilere kilden. Alle byggeværktøjerne er grupperet tæt sammen i BygKompilér, BygKonvertér, og BygVis-menuerne. + + For at kompilere kildekoden til at vises på skærmen med programmer såsom &kdvi;, og andre DVI-visningsprogrammer eller til yderligere konvertering, kan du bruge genvejstasten &Alt;2. Derefter kan du vise DVI-filen med dit eget standardvisningsprogram med &Alt;3, konvertere DVI til en PS-fil med &Alt;4, og vise PS-filen med &Alt;5. + + + + &bibtex; + + Hvis du bruger &bibtex; til dine indgange i bibliografien, skal du følge en bestemt kompileringsmetode. + + + Kør &latex; med &Alt;2. + Kør &bibtex; med &Alt;-: Dette kompilerer bibliografifilen. + Kør &latex; igen to gange for at inkorporere den kompilerede bibliografiske information, og for at få referencer og krydsreferencer rigtige. + + + Du kan også se &bibtex;-filen med din foretrukne &bibtex;-editor (for eksempel &gbib;) ved at vælge BygVisVis Bibtex; du kan ændre din standard &bibtex;-viser med VærktøjerIndstil Kile...Værktøjer. + + + + + + MakeIndex + + Hvis du bruger &makeidx;-pakken til at lave et endeligt, alfabetisk indeks for dit dokument, skal du også følge et bestemt kompileringsmønster. + + + Kør &latex; med &Alt;2. + Opret indeks med &Alt;=: Dette kompilerer indeksfilen. + Kør &latex; igen, for at inkorporere den kompilerede indeksinformation. + + + + + + + MetaPost + + Hvis du ønsker at kompilere dit dokument med MetaPost, et program til at tegne billeder, kan du gøre det med BygKompilérMpost. + + + + + + PDF&latex; + + Der er også en anden måde at kompilere dokumentet, hvis du vil have PDF: Du kan køre PDF&latex; som kompilerer kildekoden direkte til en PDF-fil, med &Alt;6. Derefter kan du direkte kigge på den kompilerede filen ved at trykke på &Alt;7. + + Du kan alternativt konvertere PS til PDF med &Alt;8, eller direkte fra DVI til PDF med &Alt;9. + + Brug af PDF&latex; i stedet for &latex; er måske blot et spørgsmål om enkelthed eller vane, men sommetider vil de to programmers opførsel være forskellig. + + + + + + &latex;2HTML + + Endelig vil du måske publicere dit arbejde på internettet og ikke blot på papir. Du kan så bruge latex2html-programmer, der kan kaldes fra &kile;'s menu BygKonvertérLaTeX til HTML. Resultatet vil blive placeret i en undermappe til din arbejdsmappe, og du vil kunne se resultatet af konverteringen ved at vælge menupunktet BygVisVis HTML. + + + + + + Videresend kommandolinjeflag + + Hvis du ønsker at angive nogle særlige kommandolinjeflag til værktøjerne for at kompilere, konvertere eller vise dine filer kan du indstille deres kald i Opsætning Indstil KileVærktøjer. + + + + + + + + Hurtig forhåndsvisning + + + Du behøver altid en vis tid til at kigge på resultatet når du arbejder med &latex;. &latex; skal kompilere kildekoden, og visningsprogrammet skal kaldes. Det kan være irriterende hvis du kun ændrede nogle bogstaver i en ligning som var svær at lave. &kile; tilbyder en Hurtig forhåndsvisning, hvor du kun kan kompilere en del af et dokument og spare meget tid. Den understøtter tre forskellige tilstande, som kan kombineres med syv indstillinger. + + + Punkter + + + + + + Punkter + + + + + Alle indstillinger skal gøres i OpsætningIndstil Kile... Værktøjer Forhåndsvisning. + + + Punkter + + + + + + Punkter + + + + + + + Markeringstilstand + + Brugeren skal markere en del af dokumentet. Menupunktet BygHurtig forhåndsvisningMarkering eller genvejstasten &Ctrl;&Alt;P, S starter det valgte program. &kile; tager preamblen fra originalteksten, så alle pakker og brugerdefinerede kommandoer inkluderes. Brugeren kan vælge en af syv foruddefinerede indstillinger: + + + Latex+DVI (indlejret visning) + Latex+DVI (KDVI) + Latex+PS (indlejret visning) + Latex+PS (Kghostview) + PDFLatex+PDF (indlejret visning) + PDFLatex+PDF (Kghostview) + PDFLatex+PDF (KPDF) + + + Dette skulle være tilstrækkeligt for alle situationer når en hurtig forhåndsvisning behøves. + + + + + + Omgivelsestilstand + + Du vil ofte forhåndsvise nuværende omgivelse, og især matematiske omgivelser, som af og til kan være svære at skrive. &kile; tilbyder en meget hurtig måde at gøre dette. Ingen markering kræves, vælg blot BygHurtig forhåndsvisningOmgivelse eller genvejstasten &Ctrl;&Alt;P, E så kompileres den nuværende omgivelse og vises. + + + + + + Underdokumenttilstand + + Hvis du har et stort projekt med mange dokumenter, er det ikke en god idé at kompilere hele projektet, hvis du kun har lavet ændringer i et enkelt dokument. &kile; klarer at kompilere og vise en forhåndsvisning af det nuværende underdokument. Preamblen tages fra hoveddokumentet, og kun den nuværende del kompileres, når du vælger BygHurtig forhåndsvisningUnderdokument eller genvejstasten &Ctrl;&Alt;P, D. + + + + + + + + Grafiske filformater + + + + &latex; og PDF&latex; + + PDF&latex;, når det bruges med pakken graphics eller graphicx, kan kompilere PNG og JPG til DVI eller PDF, men kan ikke håndtere EPS-filer. Omvendt så understøttes EPS af processen at kompilere DVI med &latex; og konvertere til PS og PDF, men ikke PNG og JPG. + + Mange brugere ønsker at lave PDF-dokumenter, men vil også bruge den udmærkede pakke Pstricks til at lave &postscript;-grafik, eller vil bruge &postscript;-uddata fra matematisk eller videnskabligt programmel såsom Mathematica, Maple eller MuPAD. Disse brugere af &latex; skal først kompilere &postscript; også selvom de vil lave PDF-dokumenter, eftersom programmerne laver &postscript;-kode som ikke kan håndteres af PDF&latex;. Det er dog ikke så svært som det kan synes, eftersom &kile; hjælper til. + + + + + + Konvertering af grafik + + For at klare denne irriterende løkke, hvis du vil inkludere både &postscript; og PNG- eller JPG-filer, er der et antal måder at komme forbi: + + + Hvis du behøver en fil i PS-format, men har JPG- eller PNG-grafik, kan du også blot først bruge PDF&latex;, og derefter køre dvips for at lave PS-filen. Du bemærker at PDF&latex; er et meget godt valg hvis din kildekode ikke indeholder nogen &postscript;-kode overhovedet. + + Du kan konvertere EPS-filer til PNG eller andre formater med værktøjer såsom Gimp eller &imagemagick;, og bruge PDF&latex;. + + En foretrukken måde er at konvertere EPS-grafik til PDF-grafik med epstopdf, som levereres med alle &tetex;-distributioner, og derefter bruge PDF&latex;. Det producerer grafik i høj kvalitet, og du kan til og med kontrollere resultatet med et af følgende flag: -dAutoFilterColorImages=false + -dAutoFilterGrayImages=false + -sColorImageFilter=FlateEncode + -sGrayImageFilter=FlateEncode + -dPDFSETTINGS=/prepress + -dUseFlateCompression=true + + + + Endnu bedre: Hvis systemet tillader shell-escape, kan konvertering gøres i farten. Alt du behøver at gøre er at inkludere pakken epstopdf, som indgår i alle &tetex;-distributioner, med kommandoen \usepackage{epstopdf}. Antag at din kode er + \includegraphics[width=5cm]{test.eps} + Når du kalder PDF&latex; med flaget , konverteres grafikfilen test.eps automatisk til test.pdf. + + Konverteringen udføres hver gang du kører PDF&latex;. Hvis din grafikkommando angives implicit: + \includegraphics[width=5cm]{test} + kontrollerer epstopdf om test.pdf allerede er tilgængelig, så det konverteringsskridt kan springes over. + + Du kan konvertere den anden vej, og bruge &latex; med PS-PDF konvertering. Dette anbefales ikke, eftersom en EPS-indkapsling af JPG- eller PNG-filer kan give større EPS-filer, som på sin side giver unødigt store dokumenter. Dette er dog yderst afhængigt af hvilket grafikprogram du bruger, eftersom EPS kan indkapsle anden grafik, men alle programmer understøtter ikke dette perfekt. Nogle vil virkelig forsøge at bygge JPG-billeder med vektorer og diverse scripter, hvilket resulterer i gigantiske filer. Konvertering af alle grafikformat til EPS kan gøres af &imagemagick;. Et andet enkelt program som udfører processen rigtigt er jpg2ps. + + Du kan også bruge automatisk konvertering. Alle grafikfiler konverteres i farten til EPS, og indsættes i PS-dokumentet. Dette er en bekvem måde, men du skal indstille systemet rigtigt. Dette beskrives i afsnittet EPS-grafik. + + + + + + + + Brug den rigtige fil til den rigtige slags grafik + + + EPS er et slags grafisk vektorscriptsprog, som beskriver alle linjer og punkter som grafen består af; det ser godt uf selv når det forstørres udover sin standardstørrelse, og passer bedst til diagrammer og vektorgrafik som er lavet direkte i EPS, som ser meget klar og skarp ud, selv mens der holdes en meget lille filstørrelse. + PNG (eller den forældede GIF) er et filformat uden tab, med god komprimering og kvalitet. Det er meget godt til diagrammer, skannede tegninger, eller noget hvis skarphed skal beholdes. Det er sommetider for meget af det gode når det bruges til fotografier. + JPEG er et format med tab, som komprimerer billeder bedre end PNG til prisen af et vist tab af detaljer i billedet. Det har ofte ingen betydning for fotografier, men kan forårsage dårlig kvalitet for diagrammer eller tegninger, og det kan få visse tynde linjer til at forsvinde helt. I disse tilfælde, brug EPS eller PNG. + + + Men husk altid: Skidt ind, skidt ud! Ingen konvertering kan få et dårligt billede til at blive godt. + + + + + + + + EPS-grafik + + EPS-grafikfiler er den traditionelle måde at indsætte grafikfiler i &latex;-dokumenter. Eftersom e-mail-lister er fulde med spørgsmål angående EPS-grafik, beskriver vi nogle vigtige aspekter og demonstrerer hvordan &kile; understøtter dem. + + + + &latex; og EPS-grafik + + Hvis du bestemde dig for at bruge den traditionelle &latex; til at lave PS- eller PDF-uddata, støder du formodentlig på visse problemer med grafik. Du skal bruge EPS-grafik (Encapsulated &postscript;), ikke JPEG- eller PNG-filer. Dette skulle ikke være noget problem, eftersom der er mange konverteringsprogrammer såsom convert fra den udmærkede pakke &imagemagick;. Men det kræver naturligvis en vis tid. + + EPS-filerne bruges både af &latex; og DVI-PS konverteringen: + + + &latex; skanner gennem EPS-filen efter den omgivende noks, som fortæller &latex; hvor meget plads der skal reserveres til billedet. + + Konverteringen DVI-PS læser derefter EPS-filen og indsætter billedet i PS-filen. + + + Dette har visse følger: + + + &latex; læser aldrig EPS-filen hvis den omgivende boks parametre angives i kommandoen for at indsætte grafik. + + Eftersom &latex; kun kan læse filer som indeholder ASCII, kan den ikke læse informationen om den omgivende boks fra komprimerede eller andre filer end EPS-grafikfiler. + + EPS-grafikfilen indsættes ikke i DVI-filen. Eftersom EPS-filerne skal være tilgængelige når DVI-filen konverteres til PS, skal EPS-filerne følge med DVI-filerne så snart de flyttes. + + + Nu kan du kalde &latex; og et DVI-PS konverteringsværktøj såsom dvips for at lave dit &postscript;-dokument. Hvis målet er et PDF-dokument, skal du køre dvips med flaget og derefter kalde ps2pdf. Du vil finde mange dokumenter som beskriver denne løsning. + + + + + + &postscript; i &kile; + + &kile; hjælper dig til at finde information om den omgivende boks. Hvis du har installeret pakken &imagemagick;, henter &kile; informationen fra EPS-filen og indsætter den som et tilvalg. Dette gøres automatisk når du vælger grafikfilen. Der er to fordele ved at gå frem på denne måde: + + + Informationen er allerede indlæst i dialogen, og det behøver ikke gøres senere af &latex;. + Endnu vigtigere er at billedets bredde og højde kan beregnes når dets opløsning er kendt. Informationen vises længst oppe i dialogen, og kan fungere som en ledetråd når du vil skalere billedet. + &kile; har også støtte for EPS-filer komprimerede med zip eller gzip, som er meget mindre end ukomprimerede EPS-filer. Men denne funktion kan kun bruges med en særlig systemindstilling, og en ændring af din lokale grafikindstilling, som beskrives i afsnittet Punktafbildet grafik. + + + Måden med &postscript; i &kile; kan slås fra eller til i OpsætningIndstil Kile... Latex Generelt. + + + + + + Måden med &postscript; og punktafbildet grafik + + Hvis systemet tillader shell-escape, understøtter &kile; også en enkelt måde at indsætte punktafbildet grafik, hvis du indstiller &tetex;-systemet rigtigt. Der er intet behov for at konvertere JPEG- eller PNG-grafik, dette kan gøres automatisk når DVI-filen konverteres til PS. + + &latex; behøver nogen information om filendelserne. Pakken graphicx leder efter filen graphics.cfg som skal findes et sted i din søgesti for &latex;-dokumenter. Søg efter indgange så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}{}% + + + og erstat disse linjer med: + +\DeclareGraphicsRule{.pz}{eps}{.bb}{}% + \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}% + \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}% + \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}% + % ændrede eller nye grafikregler + \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}% EPS komprimeret med zip + \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}% EPS komprimeret med gzip + \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-grafik + + + Du finder for eksempel filen under /etc/texmf/latex/graphics.cfg på Debian. Andre distributioner kan bruge et andet sted, men hvert &tetex;-system har en sådan indstillingsfil for grafik. Den bedste måde at gå frem er at kopiere filen til din lokale Tex-søgesti og derefter ændre filen. Se &tetex;-manualen for at finde ud af hvordan du får en liste frem med dine &tex;-mapper. + + Med denne indstillingsfil har du mulighed for at indsætte punktafbildet grafik og EPS-filer komprimerede med zip eller gzip i &latex;. Kommandoen for konvertering gives af dvips. Når du kigger på konverteringskommandoen ser du at ingen ekstra fil laves. Resultatet af konverteringsprocessen sendes direkte til PS-filen. Det eneste som &latex; skal kende til er billedets størrelse, og derfor har vi brug for den omgivende boks, som &kile; sørger for. + + Nogle siger at dette er en usikker måde. Du skal bestemme dig for hvordan du vil arbejde. Under alle omstændigheder behøver du ingen omgivende boks, eftersom &kile; ekstraherer denne information fra alle typer af grafikfiler. + + + + + + PDF&latex; og EPS-grafik + + Som allerede nævnt, kan PDF&latex; ikke håndtere EPS-grafikfiler, men konverteringsværktøjer såsom epstopdf kan hjælpe. Den bedste måde er at inkludere pakken epstopdf, som skal følge med pakken graphicx. + +\usepackage[pdftex]{graphicx} + \usepackage{epstopdf} + + + Nu kan du allerede indsætte EPS-grafik hvis du kører pdflatex med flaget , men vi kan gøre det endnu bedre og også håndtere EPS-filer komprimerede med zip eller gzip. Igen skal vi ændre grafikindstillingsfilen graphics.cfg som ovenfor. Denne gang søger vi efter: + +% pdfTeX is running in pdf mode + \ExecuteOptions{pdftex}% + + + og tilføjer simpelthen nogle linjer. + +% 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 disse linjer kan PDF&latex; håndtere EPS-filer, og forhåbentlig vil der ikke opstå flere problemer angående grafik. + + + + + + + + Hoveddokument + + At definere dokumentet som hoveddokument gør, at du kan arbejde med forskellige filer, hvilket giver et overliggende dokument (eller hoveddokument) og underliggende dokumenter som udgør et helt værk. Efter at have defineret hoveddokumentet, med tilsvarende kommando i menuen Indstillinger, gælder alle kommandoer i menuen Værktøjer kun dette dokument, selv når du arbejder i det underliggende dokument. Du kan til og med lukke hoveddokumentet. + + + + + Fejlhåndtering + + Efter du har kompileret noget, kigger &kile; på de fejlmeddelelser som blev genereret. Hvis der er nogen fejl eller advarsler, rapporteres de i vinduet Log/meddelelser. Man kan tage et nærmere kig på meddelelser ved at vælge Byg Vis log, eller med genvejstasten &Alt;0. Loggen som blev oprettet vises så i vinduet Log/meddelelser, med fejl og advarsler markerede. + + + Vis loggen + + + + + + Vis loggen + + Vis loggen + + + + Du kan nemt springe fra en meddelelse i logfilen til en anden, ved at bruge menuvalgmulighederne Byg Næste/Foregående Latexfejl/advarsel, eller ved at bruge de tilsvarende knapper i værktøjslinjen. + + For at gå til linjen i &latex;-kildekoden hvor fejlen eller advarslen opstod, klikkes blot på fejlen eller advarslen i vinduet Log/meddelelser. &kile; viser så automatisk linjen som forårsagede problemet. + + + + + + Overvågningsfil-tilstand + + Når du starter Hurtigbyg-kommandoen vil en fremviser af en slags normalt blive kaldt efter kompileringen. Hvis du ikke bruger en indlejret fremviser, vil et nyt vindue blive åbnet hver gang. + + Hvis du er ved at justere udsendet af dit dokument, så starter du måske Hurtigbyg meget tit, og får mange fremviservinduer åbne på din desktop; for at undgå denne forvirring, kan du aktivere Overvåg fil-tilstand, som vil forhindre Hurtigbyg i at starte en fremviser. + + For øjeblikket understøtter &kdvi; kontinuert opdatering af den viste DVI-fil, men &kghostview; er ikke så perfekt: for at opdatere dokument efter kompilering, vil su skulle ændre side, og antallet af sider vil ikke blive ændret i &kghostview;'s visualisering. + + Denne tilstand duer selvfølgelig ikke med indlejrede fremvisere, da du skal lukke dem alligevel for at komme tilbage til at redigere dokumentet og kompilere igen. + + + + + + + + Navigering i &latex;-kildekoden + + + + Brug af strukturvisning + + Strukturvisning viser hierarkiet for dokumentet som laves i &kile;, og lader dig hurtigt navigere i det, og vise dets dele. For at navigere i dokumentet er alt du behøver at gøre at venstreklikke på en etiket, et kapitel, et afsnit, et delafsnit, osv., så kommer du til begyndelsen af det tilsvarende område. + + Hvis du inkluderede en separat &latex;-fil i din kilde ved brug af mærkerne \input eller \include, vil disse filer blive refereret til i iStrukturvisningen; et dobbeltklik på deres navne gør at &kile; får den inkluderede fil frem i redigeringsvinduet. + + Hierarki-træet har også en adskilt gren for etiketter der bruges i teksten + + + Brug af strukturvisning + + + + + + Brug af strukturvisning + + Brug af strukturvisning + + + + + + Opdatering af strukturvisningen + + For at opdatere strukturvisningen kan du enten gå til bruge Redigér Genopfrisk struktur, eller du kan gemme dokumentet, hvilket vil få &kile; til at opdatere sin Strukturvisning. + + + + + + + + Bogmærker + + Bogmærker er brugerens reference til en tekstparagraf eller en linje inde i &kile;-omgivelsen. For at bruge et bogmærke, markeres en bestemt linje i dokumentet som du gerne vil kunne komme tilbage til, og derefter trykkes på &Ctrl; B, så tilføjer &kile; automatisk et bogmærke på linjen. Alternativt kan du også tilføje et bogmærke ved at markere linjen du vil kunne komme tilbage til, og vælge menupunktet BogmærkerSlå bogmærke til og fra. + + For at fjerne alle bogmærker, vælges Bogmærker Ryd bogmærker. + + + + + + + + Projekter + + + + Arbejde med projekter + + Du har mulighed for at oprette og arbejde med projekter i &kile;. Et projekt er en gruppering af &latex;, &tex; eller andre dokumenter som indeholder al information som bruges for at bygge det fuldstændige dokument. Et typisk projekt ville være et dokument som består af flere kapitler, skrevne i forskellige .tex-filer. Alle skal så kunne indgå i et projekt, for at gøre hele dokumentet enklere at håndtere. Du kan også opbevare filer som ikke er kildekode, såsom grafikfiler i et projekt. Projektets specifikation opbevares i en særlig fil, med filendelsen .kilepr. + + Et projekt tilføjer følgende funktioner: + + + Du behøver ikke at angive hoveddokument, &kile; gør dette automatisk. + Projektfiler kan nemt arkiveres sammen. + Visningen Filer og projekt viser hvilke filer der er inkluderet i projektet. + Efter et projekt er åbnet, genoprettes alle filer som tidligere var åbne med oprindelig kodning og farvelægning. + + + + + + + Opret et projekt + + For at oprette et projekt, vælges Projekt Nyt projekt.... Du bliver bedt om at give følgende information for at kunne oprette projektet: + + Projektets navn. + Projektfilens navn med filendelsen .kilepr. + Filnavn. + Type af fil som laves: tomt dokument, artikel, bog, brev, rapport. + + + Når du udfylder filnavn-feltet skal du inkludere en relativ sti fra der hvor .kilepr-projektfilerne opbevares til filen. + + + + + + Fil- og projektvisning + + Visningen Filer og projekt vises med en knap som er i sidebjælkemenuen. Fra denne visning kan du se projektets struktur, filerne i projektet og navnet på filen .kilepr som opbevarer projektinformationen. Tilføje filer, fjerne filer, eller ændre tilvalg i projektet gøres via visningen Filer og projekt. + + + Fil- og projektvisning + + + + + + Fil- og projektvisning + + Fil- og projektvisning + + + + + + + + Tilføje og fjerne filer + + For at tilføje en fil til projektet, åbnes en hvilken som helst &tex;-fil, der højreklikkes på navnet i visningen Filer og projekt og Tilføj til projekt vælges. Hvis du har flere åbne projekter, må du vælge projektet hvor filen skal tilføjes i en dialog. + + Eller hvis du har flere filer som skal tilføjes til projektet, kan du vælge projektet i visningen Filer og projekt, højreklikke og derefter vælge Tilføj filer. Du får så mulighed for at vælge filerne i en dialog. + + Du kan også højreklikke på projektets navn i Filer og projekt, og derefter vælge Tilføj filer... for at få en filvalgsdialog frem. + + + Tilføj en fil til et projekt + + + + + + Tilføj en fil til et projekt + + Tilføj en fil til et projekt + + + + For at fjerne en fil fra et projekt, højreklikkes den og så vælges Fjern fil. Dette sletter ikke selve filen, men fjerner den blot fra listen med filer som registreres med filendelsen .kilepr. + + + + + + Projekttilvalg + + &kile; har kun nogle få tilvalg som kan indstilles for projektet. For at ændre dem, højreklikkes på projektets navn og Projekttilvalg vælges, så får du mulighed for at ændre: + + + Projektets titel. + Arkiveringskommandoen. + Filendelser som genkendes for andre filer end kildekodefiler. + Tilvalget at bruge filendelser som regulære udtryk. + + + + + Arkivering af dit projekt + + &kile; tillader dig nemt at sikkerhedskopiere projektet ved at opbevare alle sine filer i et eneste arkiv (ofte kaldet en tarball). For at arkivere projektet, højreklikkes på dets navn i visningen Filer og projekt, eller vælg Projekt Arkivér. + + Normalt tilføjes alle filer i et projekt til arkivet. Hvis du ikke vil tilføje en vis fil til arkivet, højreklikkes den i visningen Filer og projekt og tilvalget Inkludér i arkiv afmarkeres. + + Arkiveringskommandoer er simple skalkommandoer som køres fra projektmappen (hvor filen .kilepr er). Nogle pladsholdere kan bruges når arkiveringskommandoen indskrives: + + + %S: Dette erstattes med filnavnet på projektfilen (uden endelsen .kilepr) + %F: Denne kommando bruges til at erstatte listen af filer som skal indgå i arkivet. + + + + + + + Udvidelser for andre filer end kildekodefiler + + Filer som ikke er kildekode, er filer såsom billeder, PDF- eller &postscript;-filer, osv. som skal tillhøre projektet, men ikke er kildekodefiler med endelsen .tex. Du har mulighed for at bruge egne regulære udtryk for at matche filer som ikke er kildekode. + + + + + + + + Lukning af et projekt + + For at lukke et projekt, vælges visningen Filer og projekt i den lodretteværktøjslinje, der højreklikkes på projektnavnet, og Luk vælges. Dette vil lukke projektet, alle filer som hører sammen med det, og desuden tilføjes projektet som du netop lukkede til dropned-feltet Åbn seneste projekt... i menuen Projekt. + + + + + + + + Sæt dokumentets tegnsæt + + &kile;'s editor tillader dig at læse, konvertere og indstille teksten til det tegnsæt som dokumentet behøver. Det giver dig mulighed for at bruge bogstaver og symboler som ikke er standard. Du kan for eksempel bruge tegn med accent for italiensk, fransk og æøå for dansk. Valg at tegnsæt for et dokument kan gøres på tre måder: + + + En måde at angive kodningen er at bruge dropned-feltet Sæt tegnsæt, som er længst nede i sidebjælkevisningen Åbn fil. + En anden måde er at bruge undermenuen OpsætningIndstil Kile...Editor hvor du kan indstille standardtegnsæt for alle filer. + + Vælg standardtegnsæt + + + + + + Vælg standardtegnsæt + + + + + En tredje måde at angive tegnsættet for dokumentet er at vælge det når du bruger guiden til at oprette et nyt dokument. + + + &latex; selv forstår kun ASCII, et meget begrænset sæt af tegn, så du har ikke mulighed for at bruge bogstaver med accent eller specialtegn direkte. For at bruge bogstaver med accent, lavede &latex; en bestemt syntaks for at komme uden om problemet og kunne inkludere sådanne tegn, f.eks. \ae for æ. Der er en pakke til at hjælpe dig med dette, som hedder inputenc, som kan indsættes i preamblen med \usepackage[latin1]{inputenc}, hvor det valgfrie argument er tegnsættet som du vil bruge (i de fleste tilfælde latin1). Dette beder &latex; om at oversætte alle æ i dokumentet til \ae. Kig venligst i dokumentationen for inputenc for mere information om dette. Sidst men ikke mindst: husk at sikre dig at filen virkelig er kodet med det tegnsæt du angiver til inputenc! + + + Valg af kildekodefilens tegnsæt + + + + + + Valg af kildekodefilens tegnsæt + + Valg af kildekodefilens tegnsæt + + + + Mængden af forskellige tegnsættabeller har givet problemer for mange programmer: for eksempel kan du ikke skrive et kursus i tyrkisk på fransk uden at tabe et af sprogenes særlige tegn. Der er almindelig enighed om at alle, før eller senere, vil skifte til Unicode. Der er mange implementeringer af Unicode, og UTF-8 er den mest vellykkede på Linux. Windows® forlader sig på det mere uhåndterlige og mindre fleksible ucs-2. Visse distributioner, såsom RedHat, er allerede begyndt at indstille tegnsæt til utf-8 som standard, og derfor kan det være meget interessant at bruge utf-8-argumentet med pakken inputenc. + + De dårlige nyheder er at det endnu ikke indgår i &tetex; mens dette dokument skrives. De gode nyheder er at der findes en &latex;-pakke som kan gøre præcis dette, og du kan selv installere den. + + + + Pakken &ucs; + + Du kan hente &ucs;-pakken fra hjemmesiden for Unicode støtte for &latex; af Dominique Unruh fra universitetet i Karlsruhe. + + For at installere den, pakkes den hentede fil op og det ukomprimerede indehold flyttes til en mappe som &tex; kan se. Du vil for eksempel kunne bruge /usr/share/texmf/tex/latex/ucs/ (sørg dig at den virkelig er din søgesti i $TEXMF, eftersom den sommetider ændres afhængig af distributionen du bruger.) Gør mappen læsbar af alle hvis den ikke allerede er det, og undermapperne kørbare, med chmod. Du skal udføre alle handlinger som systemadministrator, så vær forsigtig. + + Når du er klar, startes kommandoen texhash for at få &tex; til at gennemse sine filer, og forhåbentlig finde den nye pakke. Kig i pakkedokumentationen for detaljer, men generelt behøver du intet mere end at indstille følgende i indledningen: + \usepackage{ucs} + \usepackage[utf8x]{inputenc} + + + + + + Støtte for &cjk; + + At tilføje støtte for sprog med ideogrammer er ret besværligt. Når du har gjort det, fungerer det dog rigtigt godt. Foruden at installere pakker, behøves et vist ekstra indstillingsarbejde at udføres. + + Din Linux-distribution har måske allerede pakken &cjk; (Kinesisk, Japansk, Koreansk) klar til dig, så du kan blive sparet for besværet med at installere alt selv. Tjek dette inden du går videre! + + Muligheden for at bruge &ucs;-pakken til at skrive korte stumper med &cjk;-tekst findes, men det har alvorlige begrænsninger eftersom det ikke håndterer blandt andet nye linjer. Vi installerer i stedet den fuldstændige &cjk;-&latex;-pakke og får det til at fungere både for &latex; og PDF &latex;. Meget af materialet er inspireret af Pai H. Chous side om hvordan PDF &latex; indstilles. + + + + Hent pakken &cjk;. Kopiér de udpakkede filer til en passende undermappe under $TEXMF, ligesom du gjorde med pakken &ucs; tidligere (se ). Filerne pakkes op i mappen CJK/X_Y.Z. Det er ikke vigtigt at flytte dem, selvom det dog bliver nemmere at vedligeholde. + + Nu skal du hente en skrifttype som understøtter alle &cjk;-tegn som du behøver. Du kan vælge en hvilken som helst .ttf-fil som dækker dem, men i den her gennemgangen bruger vi Cyberbit. Pak filen op og omdøb Cyberbit.ttf til cyberbit.ttf, eftersom store bogstaver kan forvirre systemet. + Placér cyberbit.ttf i en mappe sammen med Unicode.sfd, og opret filerne *.tfm og *.enc med kommandoen $ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@. Af en eller anden grund laver dette ikke altid de hundredevis af filer som det skal. Hvis dette er tilfældet, kan du hente både *.tfm og *.enc filerne. + Placér .tfm-filerne i en passende mappe, såsom $TEXMF/fonts/tfm/bitstream/cyberbit/, .enc-filerne kan installeres i $TEXMF/pdftex/enc/cyberbit/. + + Nu behøver vi en map-fil til at knytte .enc-filerne sammen med skrifttypen. Hent cyberbit.map og installér den i $TEXMF/pdftex/config/. + + Hent en anden fil, c70cyberbit.fd, og placér den i en passende mappe. Du kan for eksempel vælge $TEXMF/tex/misc/. + + Den sidste fil vi skal oprette er en &postscript; Type 1 skrifttype, som behøves for at læse DVI-filer som laves med &latex;. Kør kommandoen $ ttf2pfb cyberbit.ttf -o cyberbit.pfb og kopiér resultatet cyberbit.pfb til en mappe såsom $TEXMF/fonts/type1/cyberbit/. + + Lad os nu placere cyberbit.ttf blandt skrifttyperne hvor &latex; kan finde den. Du kunne placere den i et mappe som hedder $TEXMF/fonts/truetype/. + + Tjek indstillingsfilen som du finder med $TEXMF/web2c/texmf.cnf, og sørg for at linjen som nævner TTFONTS ikke er bortkommenteret og peger på mappen hvor du gemte cyberbit.ttf. + + For at gøre det muligt for PDF&latex; at bruge dine &cjk;-skrifttyper, er det nødvendigt at tilføje en linje i indstillingsfilen $TEXMF/pdftex/config/pdftex.cfg. Tilføj map +cyberbit.map i filen for at gøre indstillingen af PDF &latex; færdig. + + For at indstille &latex; så du kan lave DVI-filer med &cjk;-tegn, skal du tilføje en linje i filen ttfonts.map. Filen kan findes i en mappe som hedder $TEXMF/ttf2pk/, men du skal formodentlig lede efter den. Tilføj linjen cyberbit@Unicode@ cyberbit.ttf i den. + + Nu behøver du kun at køre texhash så skulle systemet være klart. + + + + For at teste om din indstilling er rigtig, kan du forsøge at kompilere denne testfil. + + + Fejlsøgning af &cjk; + + Der er mange ting som kan gå galt når &cjk;-understøttelse tilføjes manuelt. Hvis noget ikke synes at virke, kan følgende checkliste hjælpe dig: + + + + Eftersom du kører &latex; som en bruger og ikke som systemadministrator, skal du naturligvis tillade almindelige brugere at få adgang til de nye filer. Sørg for at der er adgang til alle mapper og filer med kommandoen chmod. + + Hvis &latex; skriver DVI uden problemer, men du ikke kan vis det, skyldes det næsten sikkert et problem med de automatisk oprettede *.pk-skrifttyper. Det er meningen at de skal laves i farten når en DVI-fil vises, men det kan mislykkes af et antal forskellige grunde: tjek først i ttfonts.map efter din egne linje. Det kan imidlertid indtræffe at kommandoen ttf2pk, som oftest kaldes af DVI-fremviseren, er kompileret uden støtte for bibliotekerne kpathsea. Hvis dette er tilfældet, nævner ttf2pk ikke kpathsea. Eftersom understøttelse for disse biblioteker er nødvendigt, skal du finde et ny pakke eller rekompilere FreeType 1 selv. + + + + + + + + + Hvordan indtaster man &cjk; med Unicode? + + Der er et antal forskellige indtastningsprogrammer, og valget kan afhænge af hvad du personligt foretrækker. Forfatternen bruger Skim, en overførsel af programmet Scim til &kde;. Kig i din distributions dokumentation for at finde ud af hvordan man installerer disse programmer. Indstilling af sådanne programmer kan også være besværligt. I tilfældet Skim skal du definere omgivelsevariablen XMODIFIERS="@im=SCIM" before starting X. + + + + + + + + + + Hjælp + + + + Hjælpedokumenter + + &latex; er et ganske kompliceret system, hvor de grundlæggende funktioner kan udvides med en stor variation af yderligere pakker. &kile; sørger for en mængde forskellige typer af hjælp for at støtte brugeren. + + + + + &latex;-Reference + Et alfabetisk indeks over de almindeligste kommandoer i &latex;. + + + + Tetex-dokumentation + &tetex; leveres med en enorm mængde dokumenter. Dette omfatter dokumentation af &tetex;-distributionen, dokumenter for alle pakker som indgår og en yderligere referencedokumentation for &latex;. &kile;s hjælpemenu deler denne dokumentation op. + + + + Tetex-guide + Denne side er et forsøg på en guidet tur i den enorme mængde dokumentation om &tex; og &latex; som levereres som en del af &tetex;, Unix &tex;- og &latex;-systemet sammensat af Thomas Esser. + + + + Tetex-dokumenter + Dokumentation for de fleste pakker som indgår i &tetex;. + + + + LaTeX + En fuldstændig referencedokumentation for &tex; og tilhørende programmer. Det er ikke kun en beskrivelse af alle programmer, men visse vigtige pakker nævnes også. Det omfatter også en fuldstændig referencemanual for &latex;-kommandoer, ideelt for at slå en vis type af formatering op mens et dokument skrives. Eftersom dokumentet virkelig er udførligt, deler &kile; det op med tre vigtige bogmærker. + + + + Latex-kommando + Et andet alfabetisk indeks over de almindeligste kommandoer i &latex;. + + + + Latex-emne + En beskrivelse af vigtige emner i &latex;. + + + + LaTeX Env + Et alfabetisk indeks over de almindeligste omgivelser i &latex;. + + + + + + + + + Sammenhængsafhængig hjælp + + &kile; understøtter også sammenhængsafhængig hjælp, som kaldes med &Ctrl;&Alt;H, K. I OpsætningIndstil Kile... Kile Hjælp kan du vælge om du vil bruge &kile;s &latex;-reference eller hjælpesystemet i &tetex;, hvilket er standardindstillingen. + + + Punkter + + + + + + Punkter + + + + + + + + + Søg efter nøgleord + + Det er ikke altid let at finde det rette dokument, eftersom &tetex; levereres med en enorm mængde dokumenter. Som en mulig hjælp tilbyder &tetex; et lille program: texdoctk. Det levereres med en database over alle dokumenter, som &kile; bruger for at tilbyde en grænseflade mod dem. + + + Punkter + + + + + + Punkter + + + + + Alle dokumenter er grupperede i forskellige kategorier, med den hovedsagelige fordel er at du kan søge efter pakkenavne eller nøgleord. &kile; viser derefter kun resultaterne. + + + Punkter + + + + + + Punkter + + + + + Et dobbeltklik med musen, eller mellemrumstasten, starter visning af dokumentet. Det kan være et vilkårligt dokument, ikke kun DVI-, PS-, PDF- eller HTML-dokumenter. &kile; bruger indstillingerne i &konqueror; til at starte et passende visningsprogram. + + + + + + + Brugerdefineret hjælp + + Udiover den statiske &tetex;-dokumentation, understøtter &kile; også en anden variabel metode for dokumenter med brugerhjælp. I menuen Hjælp har &kile; en særlig undermenu Brugerhjælp, hvor brugeren kan tilføje dokumenter som han selv vælger. De kan være de vigtigste dokumenter i &tetex;-dokumentationen, eller til og med hjemmelavede dokumenter. Det er til og med muligt at vælge nogle url'er. + + Gå til OpsætningIndstil Kile... KileHjælp og vælg knappen Indstil for at indstille menuen Brugerhjælp. Du kan tilføje, fjerne eller navigere blandt menupunkter, og desuden indsætte adskillere for at få en bedre struktur. + + Ved at klikke på knappen Tilføj vises en anden dialog, hvor du skal redigere menupunktets navn, og vælge tilsvarende fil eller url. Hvis du vælger en url, startes &konqueror; og du skal kopiere den endelige url. + + + Punkter + + + + + + Punkter + + + + + + + + + + + Medvirkende og licens + + &kile; er en brugervenlig &latex;/&tex;-kildekodeeditor med åben kildekode. Den kører på system med &kde;'s desktopomgivelse installeret. &kde; er tilgængelig for flere arkitekturer med Linux installeret. &kile; er også en del af Fink-projektet, hvilket betyder at du også kan køre &kile; en Mac med OS-X. + + Mange tak går til de som anstrenger sig for at &kile;-projektet skal kunne fortsætte, og de mange timers bidrag som kommer fra dem som giver af deres tid for at udvikle værktøjer som vi alle kan bruge under GNU-licensen. Her er en kort liste over de programmører, redaktører, oversættere, forfattere, testere, pakkere, net-udviklere og brugere som har gjort dette projekt muligt. + + Program ophavret 2003 og nuværende udvikler Jeroen Wijnhout Jeroen.Wijnhout@kdemail.net + + Program ophavsret 2002-2003 Pascal Brachet + + Dokumentation ophavsret © 2003 Jonathan Pechta, 2003-2005 Federico Zenith + + Bidrag fra: Rob Lensen, Roland Schulz, Michael Margraf, Holger Danielsson + + Mange tak til alle de involverede. +&underFDL; &underGPL; + + +&documentation.index; + + diff --git a/doc/es/Makefile.am b/doc/es/Makefile.am new file mode 100644 index 0000000..118132c --- /dev/null +++ b/doc/es/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = es +KDE_DOCS=kile diff --git a/doc/es/bullets.png b/doc/es/bullets.png new file mode 100644 index 0000000..e3532f6 Binary files /dev/null and b/doc/es/bullets.png differ diff --git a/doc/es/complete_cmd1.png b/doc/es/complete_cmd1.png new file mode 100644 index 0000000..5c9509b Binary files /dev/null and b/doc/es/complete_cmd1.png differ diff --git a/doc/es/complete_cmd2.png b/doc/es/complete_cmd2.png new file mode 100644 index 0000000..c8b54cc Binary files /dev/null and b/doc/es/complete_cmd2.png differ diff --git a/doc/es/complete_env1.png b/doc/es/complete_env1.png new file mode 100644 index 0000000..6a5c3c2 Binary files /dev/null and b/doc/es/complete_env1.png differ diff --git a/doc/es/complete_env2.png b/doc/es/complete_env2.png new file mode 100644 index 0000000..493807c Binary files /dev/null and b/doc/es/complete_env2.png differ diff --git a/doc/es/config-complete.png b/doc/es/config-complete.png new file mode 100644 index 0000000..8cbb4d0 Binary files /dev/null and b/doc/es/config-complete.png differ diff --git a/doc/es/config-quickpreview.png b/doc/es/config-quickpreview.png new file mode 100644 index 0000000..07637d5 Binary files /dev/null and b/doc/es/config-quickpreview.png differ diff --git a/doc/es/config-userhelp.png b/doc/es/config-userhelp.png new file mode 100644 index 0000000..ad1c584 Binary files /dev/null and b/doc/es/config-userhelp.png differ diff --git a/doc/es/delete.png b/doc/es/delete.png new file mode 100644 index 0000000..fe572de Binary files /dev/null and b/doc/es/delete.png differ diff --git a/doc/es/dialog-addhelp.png b/doc/es/dialog-addhelp.png new file mode 100644 index 0000000..59c4bb8 Binary files /dev/null and b/doc/es/dialog-addhelp.png differ diff --git a/doc/es/dialog-docbrowser1.png b/doc/es/dialog-docbrowser1.png new file mode 100644 index 0000000..937f342 Binary files /dev/null and b/doc/es/dialog-docbrowser1.png differ diff --git a/doc/es/dialog-docbrowser2.png b/doc/es/dialog-docbrowser2.png new file mode 100644 index 0000000..9f2d481 Binary files /dev/null and b/doc/es/dialog-docbrowser2.png differ diff --git a/doc/es/dialog-pstools.png b/doc/es/dialog-pstools.png new file mode 100644 index 0000000..d8c4e17 Binary files /dev/null and b/doc/es/dialog-pstools.png differ diff --git a/doc/es/dialog-tabular.png b/doc/es/dialog-tabular.png new file mode 100644 index 0000000..bf7cdbd Binary files /dev/null and b/doc/es/dialog-tabular.png differ diff --git a/doc/es/environment.png b/doc/es/environment.png new file mode 100644 index 0000000..c16c083 Binary files /dev/null and b/doc/es/environment.png differ diff --git a/doc/es/ico.png b/doc/es/ico.png new file mode 100644 index 0000000..c2194cf Binary files /dev/null and b/doc/es/ico.png differ diff --git a/doc/es/includegraphics.png b/doc/es/includegraphics.png new file mode 100644 index 0000000..374e334 Binary files /dev/null and b/doc/es/includegraphics.png differ diff --git a/doc/es/index.docbook b/doc/es/index.docbook new file mode 100644 index 0000000..cfeb4ee --- /dev/null +++ b/doc/es/index.docbook @@ -0,0 +1,6073 @@ + +Kile"> + ATEX"> + ATEX"> + EX"> + teTEX"> + TeX Live"> + EX"> + + EX"> + + + ImageMagick"> + KDE"> + KDVI"> + dvipng"> + KGhostView"> + KPDF"> + PostScript"> + makeidx"> + Kate"> + CJK"> + ucs"> + URL"> + + + + +]> + + + + +El Manual de &kile; + + + JonathanPechta + FedericoZenith
zenith@chemeng.ntnu.no
 + HolgerDanielsson
holger.danielsson@versanet.de
 + ThomasBraun + MichelLudwig
michel.ludwig@kdemail.net
 + + +RafaelRodríguez Martín
apt-drink@telefonica.net
Traductor SantiagoFernández
santi@kde-es.org
Traductor + + +2003 +Jonathan Pechta + + + +200320052006 +Federico Zenith + + + +20052006 +Holger Danielsson + + + +2007 +Thomas Braun + + + +2007 +Michel Ludwig + + +November 19, 2007 +2.0 + + +&FDLNotice; + + + +&kile; es un editor de archivos de fuentes y un intérprete de órdenes de &latex; y &tex;. + + + +KDE +kdenonbeta +Kile +LaTeX +TeX + + + + + + +Prefacio + + + + Requisitos + + Para ejecutar &kile;, se requiere que tenga instalados los siguientes componentes en su sistema: + + + Entorno de escritorio K (&kde;): &kde; es un popular entorno de escritorio de código abierto. + Qt: Qt es una herramienta de desarrollo en C++ necesaria para compilar &kile;. + &latex;: programa de composición de textos de alta calidad. Lo más seguro es que quiera el paquete &texlive; (o &tetex; en los sistemas antiguos), si está en un sistema de tipo Unix. + + + Algunos de estos elementos podrían estar incluídos en su distribución Linux. Consulte la documentación de su distribución, o el CD o DVD de instalación, para añadir estos paquetes a su sistema. + + El proyecto &kile; incluye varios paquetes diferentes de &kile; que pueden ser fácilmente instalados y ejecutados sin tener que compilar. Compruébelo en la página web oficial de &kile;. + + + + + + Personas a quienes va dirigido este documento + + Este manual puede ser utilizado por cualquier persona, independientemente de su experiencia con &latex;, &kde;, &kile; o Linux. + + No se espera que los usuarios avanzados lean este manual, pero se agradecerá cualquier sugerencia sobre la documentación. Si desea contribuir con este proyecto o con la documentación, consulte la página web oficial de &kile;. + + ¿Necesita respuestas sobre &kile;? ¿Está atrapado en su compilación? ¿Desearía ver una nueva funcionalidad? La mejor manera de plantear cuestiones técnicas o comenzar una discusión es utilizar nuestra lista de correo: kile-devel@lists.sourceforge.net. + + + + + + + + Introducción + + + + Aspectos básicos + + + + Sobre &kile; + + &kile; es un entorno integrado de &latex; para el escritorio &kde;. &kile; le proporciona la habilidad de utilizar todas las funcionalidades de &latex; con una interfaz gráfica, proporcionándole un acceso sencillo, inmediato y personalizado a todas las herramientas para la compilación, post-procesado, depuración, conversión y visualización de &latex;. También ofrece prácticos asistentes, una referencia de &latex;, y potente administración de proyectos. + + + + + + Qué es &latex; + + &latex; es un sistema de procesamiento de textos derivado de &tex;, un programa desarrollado originalmente en 1977 por Donald Knuth para ayudar a los autores a confeccionar su trabajo profesionalmente, obteniendo algo similar a lo producido por un tipógrafo. El tipógrafo es el profesional que proporciona el estilo visual a un documento de acuerdo con las especificaciones para ese tipo de documento. &latex; fue creado por Leslie Lamport para proporcionar a los autores un tipógrafo automático, especialmente cuando se trataba de la costosa y dolorosa escritura de fórmulas y expresiones matemáticas, que no por casualidad están encerradas entre signos de dólar en &latex;. Hoy en día, los procesadores de textos permiten a cualquier usuario ser el tipógrafo, pero lo que usted muchas veces quiere es un documento que se vea bien, no uno en el que tenga que invertir horas en hacer que se vea bien. &latex; se toma esas molestias, y le permite concentrarse en el documento, no en su confección. Y sí, ¡el documento se verá bien! + + + + + + ¿Cómo se pronuncia? ¿Por qué esa escritura tan extraña? + + Hay una curiosa tradición de que los paquetes relacionados con &tex; tengan la pronunciación y escritura lo más raras posibles. Se supone que &tex; proviene del griego τεχ, o tech en letras latinas. Hay muchas explicaciones del porqué, pero lo más seguro es que sea porque &latex; fue originalmente concebido para informes técnicos, y de ahí que su consabido punto fuerte fuera la correción y facilidad en la escritura de fórmulas matemáticas, que por aquellos tiempos era una tarea cara, larga y frustrante. + Se supone que se pronuncia así: T como en español, E como en español, y X como en la ch alemana. Si no sabe cómo suena esta ch, se parece al siseo de un gato. El símbolo de la IPA que lo representa es /ç/. Mucha gente dice que se pronuncia como la h aspirada (símbolo IPA /x/), pero he preguntado personalmente a algunos griegos y puedo confirmar la primera versión. Debe tener en cuenta que mucha gente lo pronuncia mal (/teks/ o /tek/). + Por último, en &latex; la primera LA se pronuncia como la palabra inglesa lay: la idea es que, aunque &tex; en crudo es difícil, hasta un hombre tumbado (lay) puede utilizar las macros &latex;. Una explicación menos inspirada, pero más realista, es que proviene del apellido de Leslie Lamport, el creador de &latex;. ¡Ahora ya lo sabe! + + + + + + + + &latex; 101 + + El sistema de composición de textos &latex; es similar a otros lenguajes de marcas como XML, utilizados para muchos tipos de documentos (incluyendo el que usted está leyendo), o HTML, empleado para páginas web. La idea general es tener un conjunto de palabras especiales, llamadas etiquetas, que le dicen al programa (un procesador de textos, un navegador, o el compilador de &kile;) cómo presentar el texto. &kile; le ofrece un buen número de esas etiquetas en el menú LaTeX de la barra de menú. + + Si bien intentaremos darle una buena idea de lo que es &latex;, éste no es el Libro Definitivo sobre &latex;. Si desea profundizar en el aprendizaje de &latex;, debería comprar un libro especializado. El autor ha tenido una buena experiencia con «A Guide to &latex;» de H. Kopka y P. W. Daly, que todavía guarda en su estantería. + + Al igual que otros lenguajes de marcas, &latex; contiene un preámbulo, que especifica órdenes globales, como el tamaño del papel, la numeración de las páginas y las dimensiones del texto en la página, y un cuerpo que contiene el texto del documento. El preámbulo tiene que contener al menos la orden \documentclass, y precede al cuerpo, que comienza con la orden \begin{document}, y es concluído por la orden \end{document}. + + + + + + Principales características de &kile; + + + + Asistente de inicio rápido + + El asistente integrado con &kile; es una estupenda característica para introducirle en la creación de documentos con &kile; de una forma rápida. Eligiendo el asistente en la barra de menús se le proporcionan diversas opciones para la creación de su documento: artículo, libro, carta, informe, o documento vacío. También puede especificar algunas opciones relacionadas con el propio documento. + + Opciones de clase: + + + Clase de documento: elija el documento que desea crear: artículo, libro, carta, informe, scrartcl, scrreprt, scrbook, prosper, beamer u otro definido por usted mismo. + Tamaño del tipo de letra: indica a &kile; qué tamaño (pt) punto desea utilizar. + Tamaño del papel: selecciona el tamaño o estilo de las hojas. + Codificación: En general es buena idea sus sistemas estándar de codificación. Los sistemas modernos están utilizando cada vez más UTF-8 como estándar de codificación. Si puede utilice utf8x (que es totalmente correcto para la revisión ortográfica en los documentos &latex;). + Otras opciones: permite añadir otras opciones para la impresión, borradores y otras. + + + Paquetes + Lista algunos de los paquetes adicionales más comunes utilizados en &latex;. Marque la casilla para incluirlos. + + Propiedades del documento + + Autor: escriba su nombre aquí. + Título: añada el título de su documento aquí. + Fecha: especifique la fecha. + + + + + + + Plantillas predefinidas + + Las plantillas predefinidas en &kile; son: + + + Documento vacío: ¡los más fanáticos comienzan desde cero! + Artículo: selecciona el formato de artículo, para un documento suficientemente corto como para no estar dividido en capítulos. + Informe: selecciona el formato de informe, para un documento de tamaño medio, con, por ejemplo, numeración de páginas en el borde de éstas. + Libro: selecciona el formato de libro, una opción tan potente que es utilizada para escribir muchos libros de texto universitarios. + Carta: selecciona el formato de carta, que puede automáticamente hacer esas indentaciones de las que realmente nadie se acuerda. + Beamer,HA-Prosper: crea bonitas presentaciones en PDF con un aspecto superior y toda la potencia de &latex;. + Scrartcl,Scrbook,Scrreprt,Scrlttr2: Las clases de documento de KOMA-Script, especialmente adaptados a la tipografía alemana. Utilícelas si escribe textos en alemán. + + + Los nuevos usuarios no deben preocuparse. Estas secciones son simplemente un breve resumen de las características, y se prestará más atención a los detalles de estas tareas más adelante en el . + + + + + + Resaltado de sintaxis + + &kile; es similar a otros programas que tratan con código fuente y edición, y resaltará automáticamente las órdenes, opciones y elementos utilizados (y de los que se abusa). &kile; hace posible detectar fácilmente áreas problemáticas: por ejemplo, si ve un gran espacio de texto de color verde, seguramente se haya olvidado de cerrar un entorno matemático en alguna parte. Se habría dado cuenta de todas maneras al ver el horrible aspecto del archivo de salida, pero el resaltado le ahorrará tiempo y frustración. + + + + + + Autocompletado de entornos + + El autocompletado de entornos significa que cuando comienza un nuevo entorno escribiendo \begin{environment}, &kile; automáticamente añadirá una orden \end{environment}, con una línea en medio para su texto. Por supuesto, puede desactivarlo si así lo desea en PreferenciasConfigurar &kile;...LaTeX. + + + + + + Saltar a un elemento de estructura + + Todos los documentos suelen estar estructurados en una jerarquía de algún tipo. &latex; le permite dividir los documentos en las siguientes jerarquías (siendo «parte» la más alta en la jerarquía, y «subpárrafo» la más baja): + + + \part (parte) + \chapter (capítulo) + \section (sección) + \subsection (subsección) + \subsubsection (subsubsección) + \paragraph (párrafo) + \subparagraph (subpárrafo) + + + Mientras está viendo un documento en la vista de Estructura, puede saltar entre elementos pulsando en el elemento que le gustaría ver. + + + + + + Búsqueda inversa + + Cuando crea su propio archivo &latex;, la búsqueda inversa puede serle muy útil. Una vez creado un archivo DVI (DeVice Independent File -archivo independiente del dispositivo-), cuando pulsa en el botón central del ratón en el visor DVI, &kile; saltará a la línea correspondiente en el código fuente de &latex;. + + Un DVI es un tipo de archivo que contiene una descripción de un documento con formato, así como otra información incluyendo el tipo de letra de los caracteres, y junto con el PDF es la salida usual de &tex; o &latex;. Existen diversas utilidades para ver, convertir e imprimir archivos DVI en varios sistemas y dispositivos. + + + + + + Búsqueda directa + + Cuando se usa la búsqueda inversa, la selección de elementos en el archivo DVI está asociada con el editor, así que cuando pulse sobre el archivo DVI, la ventana principal saltará a la correspondiente sección de código &latex; en el editor. La búsqueda directa es exactamente lo contrario, pues le permitirá pulsar en una sección específica de texto en el código &latex;, y saltar a la posición asociada en la ventana del visor DVI. + + + + + + + + La barra de herramientas + + + Nuevo: comienza un nuevo documento. + Abrir: abre un nuevo documento. + Cerrar: cierra su documento. + Definir el documento actual como «documento maestro»: Se emplea cuando se trabaja con varios archivos. Tener un documento maestro le permitirá incluir otros archivos .tex en su documento. Si está utilizando proyectos, también puede establecer un proyecto completo como documento maestro en Proyecto->Opciones de proyecto. + Generación rápida: compila su código fuente &latex; y muestra los resultados automáticamente, a no ser que el código contuviera errores. + Modo de vigilar archivo: este modo «vigilará» el archivo DVI para ver si cambia, y no ejecutará una nueva instancia de &kdvi; después de Generación rápida. + Ver archivo de registro: muestra el archivo .log, para que pueda examinar los errores. + Anterior error: salta hacia atrás en el archivo .log y resalta los errores en el código fuente. + Siguiente error: salta hacia adelante en el archivo .log y resalta los errores en el código fuente. + Detener: detiene la herramienta actual. + LaTeX: ejecuta &latex; en el documento activo. + Ver DVI: ejecuta el visor DVI. + DVI a PS: convierte el archivo DVI en &postscript; (PS). + Ver PS: inicia el visor &postscript; (PS). + PDFLaTeX: ejecuta &pdflatex; en el documento activo. + Ver PDF: ejecuta el visor de PDF. + DVI a PDF: convierte un DVI a un PDF. + PS a PDF: convierte un PS a un PDF. + Ver HTML: muestra el HTML creado. + Búsqueda directa de Kdvi: salta a la página que corresponde a la línea actual en el editor. + + + Si se fija en la barra de herramientas Editar, observará tres grandes menús desplegables. Los menús desplegables fueron diseñados para permitirle añadir rápidamente características a su documento. El primer menú desplegable se utiliza para dividir su documento en partes, capítulos, secciones, etc. Las órdenes disponibles para añadir segmentos a su código fuente &latex; son: + + + part (parte): el nivel más alto para seccionar un documento. + chapter (capítulo): comienza un nuevo capítulo. + section (sección): crea una nueva sección. + subsection (subsección): crea una nueva subsección. + subsubsection (subsubsección): crea una sección secundaria. Está a caballo entre una subsección y un párrafo. + paragraph (párrafo): crea un nuevo párrafo. + subparagraph (subpárrafo): crea un nuevo subpárrafo. + + + El menú desplegable llamado label (etiqueta) se utiliza para insertar elementos en su documento, como índices, pies de página y referencias. Las órdenes disponibles son: + + + label (etiqueta): Orden que produce una etiqueta para un capítulo, una figura u otro elemento. + index (índice): crea una entrada para el índice. + footnote (nota al pie): crea una nota al pie en su documento. + ref (referencia): utilizado para referirse a una etiqueta predefinida, que puede escoger de una lista desplegable. + pageref: igual que ref, pero se refiere a una página en vez de a un elemento de la estructura. + cite (cita): crea una cita en su documento desde una bibliografía. + citar de ViewBib: pide la herramienta ViewBib para todas las referenicas seleccionadas y las inserta. En estos momentos solo está disponible con &kbib; como herramienta ViewBib. + + + + El menú desplegable Label (etiqueta) + + + + + + El menú desplegable Label (etiqueta) + + El menú desplegable Label (etiqueta) + + + + + Seleccionando una etiqueta para una referencia + + + + + + Seleccionando la etiqueta para una referencia + + Seleccionando la etiqueta para una referencia + + + + Cuando utilice cite (cita), se le mostrará una lista desplegable de bibitems, pero si está utilizando &bibtex; únicamente funcionará si el archivo pertenece a un proyecto. Para editar los archivos &bibtex; se recomienda el uso de editores especializados. El autor ha tenido una buena experiencia con &kbibtex; y &kbib;. Por supuesto, también puede escribir archivos &bibtex; a mano utilizando &kile;. + + El último menú desplegable, etiquetado tiny (pequeño), se utiliza para establecer el tamaño de su texto. Tiene la opción de fijar el tamaño del texto, notas al pie, etc. Las órdenes de que dispone son: + + + tiny: el más pequeño. + scriptsize: muy pequeño. + footnotesize: más pequeño. + small: pequeño. + normalsize: normal. + large: grande. + Large: mayor. + LARGE: más grande. + huge: todavía mayor. + Huge: el mayor de todos. + + + + + + + + Inicio rápido + + + + Escribiendo un documento &latex; con &kile; para principiantes + + Los usuarios de &kile; tiene dos opciones cuando comienzan un documento nuevo: Pueden usar el Asistente para comenzar el documento nuevo, seleccionando el tipo de documento que le gustaría crear y opciones tales como tamaño del tipo de letra, tamaño del papel, etc. La otra opción es escribir el código a mano. + + + \documentclass[12pt]{article} + \begin{document} + Aquí hay un montón de texto codificado en \LaTeX. + \end{document} + + Cada documento en &latex; comienza con la orden \documentclass[argumento opcional]{class}, donde la clase especifica el tipo de documento. + + Escribiendo el código del ejemplo anterior, la caja de texto da la siguiente salida: + + + Texto compilado en la salida DVI + + + + + + Texto compilado en la salida DVI + + Texto compilado en la salida DVI + + + + Los corchetes que vienen después la orden \documentclass contienen las opciones para la orden. La opción [12pt] fija el tamaño del tipo de letra para su artículo. Si no fija el tamaño del tipo de letra al principio, puede hacerlo más adelante en el código. + + Una vez que haya escrito el código de ejemplo del cuadro anterior, necesitará compilar su código fuente &latex;. La manera más sencilla de compilar &latex; es utilizar el menú Generar, o utilizar el botón Construcción rápida. + + &Alt;2 es la combinación de teclas para compilar su código fuente. + + Necesitará guardar su código fuente antes de poder compilarlo. &kile; lo hará automáticamente por usted. + + Si su documento no se compiló, compruebe el registro para buscar errores. Cuando utilice la opción de Construcción rápida, el visor de &kdvi; debería ser iniciado automáticamente. Si no es así, compruebe el registro. + + + + + Entornos + + Un entorno es un segmento de texto que es tratado de forma diferente que el resto de su documento. Por ejemplo, puede crear un informe con un tipo de letra de tamaño 12, pero necesitará cambiar el tamaño de su tipo de letra para unas pocas líneas. La orden \begin{environment}, \huge y \end{environment} le permitirá temporalmente alterar el texto dentro de las órdenes de entorno para tener un tamaño mayor. + + Por tanto, los cambios son sólo efectivos desde \begin{environment} hasta \end{environment}. No hay límites acerca de cuántos cambios puede hacer dentro de un entorno. + + Hay muchas características que puede añadir a su documento que lo hará más legible y amigable. Puede añadir características como tipos de letra específicas, negrita, cursiva, subrayado, etc. a su documento, y estas órdenes finalizarán con un orden \end, o bien al final de su entorno. + + + \begin{emph}: esta orden pone el texto en cursiva, y es válido hasta que se encuentra una orden \end{emph}, \end{emph} o un final de entorno. Para poner en cursiva sólo una palabra en una frase, utilice la sintaxis: esta es \em{mi} frase. + \textbf{Estoy poniendo en negrita el texto entre llaves}: esta orden pone su texto en negrita. + \quote: para crear una cita (no bibliográfica) dentro de su documento, comience su cita con \begin{quote} y termínela con \end{quote}. + \center: centra el texto. + \verse: crea texto desplazado para poemas. + \itemize: crea una lista de elementos. + + + + + + + Utilizando &kile; + + Ahora que le hemos dado cierta base sobre cómo escribir código utilizando el lenguaje de marcas &latex;, le mostraremos cómo crear un documento paso a paso utilizando &kile;. + + + Arranque &kile;. + Seleccione AsistenteInicio rápido. Entonces elija un formato, y seleccione sus preferencias en el asistente. + Una vez el asistente ha introducido texto, personalícelo un poco para hacer el documento más legible. Añada un mínimo de una cita (no bibliográfica), texto en negrita u cursivas, y un verso para ver las diferencias entre órdenes. + Guarde su archivo y llámelo intro.tex. + Construya su documento utilizando &Alt;2 o el botón LaTeX. + Seleccione Ver DVI. + Compruebe su nuevo texto. + Cuando termine de ver su documento pulse con el ratón sobre Vista de editor o pulse &Ctrl;e para volver al editor si está utilizando el visor empotrado, o cierre la ventana si está utilizando un visor separado. + + + ¡Ya está! ¡Ha creado su primer documento &latex;! + + Una vez haya creado su DVI, podrá imprimir su documento o convertirlo en un archivo &postscript; o PDF si así lo desea. ¡Experimente y diviértase! + + + + + + Archivos DVI + + DVI significa archivo independiente del dispositivo (DeViCe Independent). Estos archivos son producidos por &tex; o &latex; para ser leídos por un controlador en su ordenador. Hay muchos tipos diferentes de salidas a las que un .dvi puede ser enviado, como a una impresora, a un archivo &postscript;, a un conversor de archivos PDF, o a la pantalla de su ordenador. + + + + Viendo un DVI + + Ya ha visto como ver un archivo DVI en la pantalla utilizando el botón Ver DVI de la barra de herramientas. + + + + + + Imprimiendo un DVI + + Para imprimir un DVI, puede emplear el mismo proceso que utilizó anteriormente para crear su documento (vea ). En el paso 7, después de pulsar en Ver DVI, elija ArchivoImprimir en el visor, y si tiene la impresora correctamente configurada, el DVI se imprimirá. + + + + + + Convertir archivos DVI + + La barra de herramientas da opciones para exportar un DVI a diferentes formatos. Una vez haya creado un DVI desde su código fuente &latex;, podrá exportarlo al formato que elija utilizando los botones de la barra de herramientas. + + + + + + + + Búsqueda hacia delante en archivos &kile; y &kdvi; + + Las funciones de búsqueda hacia delante le permiten que su editor salte directamente sobre la posición asociada al archivo &DVI;. + &kile; ofrece una configuración con esta opción para todos los binarios &latex;. Vaya a PreferenciasConfigurar Kile... HerramientasGenerar y seleccione siempre la configuración Moderna. + + Para ejecutar una búsqueda directa, sitúe el cursor en una línea del código fuente, y pulse Búsqueda directa de Kdvi para saltar a la posición asociada en la ventana del visor DVI. + + + + + Búsqueda inversa en &kile; y &kdvi; + + La búsqueda inversa es una característica muy práctica cuando escriba un documento &latex;. Si está configurada adecuadamente, puede pulsar en la ventana &kdvi; con el &MMB; (en algunos sistemas, cuando no tiene un ratón con tres botones, puede utilizar los botones izquierdo y derecho simultáneamente). Después de esto kile cargará el archivo fuente &latex; y mostrará el párrafo adecuado. Para utilizar la búsqueda inversa debe tener compilado &latex; con la configuración Moderna. + + La búsqueda inversa no funcionará a no ser que: + + + El archivo de código fuente haya sido compilado correctamente. + &kdvi; sepa qué editor le gustaría usar. + + + Con esta característica de &kdvi;, una pulsación en el botón central del ratón en el documento DVI hará que &kile; abra el correspondiente documento &latex; e intente ir a la línea correspondiente. Recuerde decirle a &kdvi; que utilice &kile; como editor de texto, en la opción de menú de &kdvi; PreferenciasOpciones DVI.... + + + Configurando &kdvi; + + + + + + Configurando &kdvi; + + Configurar &kdvi; + + + + + + + Resolviendo errores + + Si está intentando utilizar la construcción rápida, y el visor DVI no se abre, lo normal es que tenga un error. Si tiene un error, será visible en el área de registro / mensajes, y se visualizará un resumen del error. + + El archivo de registro explicará la fuente del error en su código. En el editor, puede utilizar los botones de la barra de herramientas Anterior error de LaTeX y Siguiente error de LaTeX para saltar a y desde los errores. El registro siempre especifica en qué línea se produjo el error. Para ver la línea en la que ha ocurrido un error, pulse en el error en la ventana del registro, y &kile; le llevará a la línea correspondiente. + + + + + + + Comenzando un nuevo documento + + Cuando pulsa el botón en la barra de herramientas para comenzar un documento nuevo, aparece un diálogo preguntando qué tipo de plantilla desearía emplear para escribir su documento. Las opciones predeterminadas son: + + + Empty document (documento vacío) + Article (artículo) + Beamer + Book (libro) + HA-Prosper + Letter (carta) + Report (informe) + Scrartcl (del paquete KOMA-Script) + Scrbook (del paquete KOMA-Script) + Scrlttr2 (del paquete KOMA-Script) + Scrreprt (del paquete KOMA-Script) + + + Si seleccionó Documento vacío, puede comenzar a escribir un documento desde cero, o bien puede utilizar el Asistente para comenzar rápidamente un nuevo documento (vea ). + + + + + Plantillas + + Los usuarios que utilicen &latex; con frecuencia suelen emplear el mismo preámbulo para casi todos sus documentos. Las plantillas pueden ser creadas, guardadas y cargadas dentro de &kile; para que resulte más sencillo comenzar un nuevo documento. + + + + Crear una nueva plantilla + + Para crear una nueva plantilla, primero debe abrir un archivo &tex; / &latex;, o crear un archivo por su cuenta. &kile; puede generar una plantilla desde un documento existente, abriendo el documento deseado y seleccionando ArchivoCrear una plantilla a partir de un documento. + + + + + + Configurando las sustituciones automáticas + + Cuando se crea un nuevo documento seleccionando una plantilla desde ArchivoNuevo, ciertas combinaciones de caracteres serán sustituídas por datos como su nombre, o el juego de caracteres que esté utilizando. Estas variables pueden ser configuradas en PreferenciasConfigurar Kile... PreferenciasGeneral. + + Si está diseñando su propia plantilla, es útil saber qué combinaciones de caracteres son sustituídas por qué variables de plantilla: + + + $$AUTHOR$$: Esta cadena será sustituida por la variable autor. + $$DOCUMENTCLASSOPTIONS$$: Esta cadena será sustituida por la variable de opciones de clase de documento. Ésto se suele utilizar como sigue: \documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}. + $$INPUTENCODING$$: Si la variable de codificación de las entradas esta fijada, digamos, a latin1 esta cadena es sustituida por \input[latin1]{inputenc}. + + + + + + + Crear una plantilla desde el asistente + + La manera más sencilla de crear una nueva plantilla es iniciar el asistente y entonces añadir órdenes al editor. Una vez tenga su documento configurado como desee: + + + Guarde su archivo. + Vaya a Archivo. + Elija Crear una plantilla a partir de un documento. + Haga cualquier corrección necesaria a la plantilla. + Introduzca un nombre para su nueva plantilla. + Pulse Aceptar para añadir su plantilla al menú. + + + La siguiente vez que comience un nuevo documento podrá elegir su plantilla personalizada además de las predefinidas. + + + + + + Crear una plantilla desde cualquier archivo + + Se puede crear una plantilla desde cualquier archivo &latex;. Si está buscando una manera fácil de configurar una plantilla, encuentre en Internet una que le guste y siga los mismos pasos listados en . + + Por ejemplo, pongamos que quiere crear un póster enorme de tamaño A0. Estos pósters normalmente se ven en conferencias científicas, y &latex; le ayudará a crear uno atractivo y con gancho. Puede obtener una plantilla para pósters A0 en la página de Jonathan Marchini, pero hay muchas otras disponibles. Recuerde que necesitará el paquete a0poster, que normalmente no está en una instalación estándar de tex, así que deberá descargárlo, y copiarlo en l misma carpeta que su archivo de &latex;. + + + + + Eliminando una plantilla + + Para eliminar una plantilla de &kile;, haga lo siguiente: + + + Vaya a ArchivoEliminar plantilla...; + Aparecerá una cuadro de diálogo con todas las plantillas listadas: seleccione una. + Pulse Aceptar y su plantilla será eliminada. + + + Las plantillas marcadas con un asterisco (*) no podrán ser eliminados sin los permisos pertinentes. + + + + + + + + + Editando documentos &latex; + + El editor interno que &kile; utiliza es &kate;. Kate es un editor de texto creado para programadores, que incorpora la habilidad de leer y resaltar muchos tipos diferentes de archivos de texto, entre los que se encuentran &latex; y &bibtex;. Puede acceder a muchas opciones para &kate; directamente desde el menú Herramientas de &kile;. + + Para aprender más acerca de &kate; y sus capacidades, mire el Manual de Kate. Los usuarios de &kile; pueden empezar a leerlo por el capítulo «Trabajando con el editor de Kate». + + + + Manual de referencia de &latex; + + &kile; cuenta con un práctico manual de referencia de etiquetas &latex;, al que puede acceder seleccionando AyudaReferencia LaTeX. Contiene una cuidadosa descripción de casi todas las órdenes que podría utilizar en &latex; y su sintaxis. + + + + + + Movimientos del cursor + + Para seleccionar texto dispone de las siguientes opciones: + + + Mantener pulsado el botón izquierdo del ratón y arrastrarlo para resaltar el texto. + Pulsar una vez en una palabra para mover el cursor a un área diferente. + Pulsar dos veces en una palabra para seleccionar la palabra entera. + Realice una doble pulsación sobre una palabra y pulse &Ctrl; para seleccionar la palabra de tex completa. Esto significa que si pulsa en \par desde \par\bigskip solo se seleccionará \par. + Pulsar tres veces para seleccionar la frase entera. + + + Mantener pulsado el botón izquierdo del ratón y arrastrarlo sobre el texto que desea seleccionar, automáticamente copia el texto seleccionado al portapapeles. + + Mantener pulsada la tecla Mayúsculas y utilizar las teclas de dirección le permite seleccionar porciones de código fuente en la ventana del editor. + + + + + + Paréntesis + + El completado de paréntesis es una herramienta visual que utiliza el editor para indicar cuáles se emparejan entre sí. Si abre cualquier archivo .tex, y seleccione cualquier paréntesis (), corchete [] o llave {}, y el editor lo resaltará (así como a su pareja) en amarillo (este color predeterminado puede ser cambiado). Por ejemplo, si posicionara el cursor en una de las llaves de \section{Introducción}, vería \section{Introducción} en el resaltado amarillo predeterminado, mostrándole la ubicación de las llaves del principio y el final. + + + + + + Resaltado + + &kile; tiene la habilidad de buscar y resaltar diferentes tipos de código. Por ejemplo, las órdenes de &latex; se distinguen del texto normal, y las fórmulas también se resaltan en un color diferente. + + + + + + Marcas + + Algunos asistentes pueden insertar viñetas, un tipo especial de marcadores de texto. Las entradas de menú Editar Viñetas o el correspondiente acceso rápido del teclado le permitirá saltar al siguiente o a la última marca. Esto resaltará esta marca que será borrada cuando introduzca su primera letra. + + + Marcas + + + + + + Marcas + + + + + + + &Ctrl;&Alt;Derecha Siguiente topo + Salta a la siguiente marca de texto si es que existe. + + + &Ctrl;&Alt;Izquierda Topo anterior + Salta a la marca anterior de texto si es que existe. + + + + + + + + + Seleccionar + + Editar es uno de los aspectos principales cuando utiliza un programa similar a &kile;. Aunque &kate; ya tiene grandes capacidades, &kile; añade algunas características, que son especialmente importantes para escribir código fuente &latex;. &latex; necesita muchos entornos y grupos, por eso &kile; soporta órdenes especiales para seleccionarlos. En Editar Seleccionar encontrará las siguientes órdenes para el texto seleccionado. + + + Editar->Seleccionar elementos + + + + + + Editar->Seleccionar elementos + + + + + + &Ctrl;&Alt;S E Entorno (dentro) + Selecciona un entorno sin las etiquetas. + + + &Ctrl;&Alt;S F Entorno (fuera) + Selecciona un entorno incluyendo las etiquetas. + + + &Ctrl;&Alt;S T Grupo TeX (dentro) + Selecciona un grupo TeX dentro de los paréntesis. + + + &Ctrl;&Alt;S U Grupo TeX (fuera) + Selecciona un grupo TeX incluyendo los paréntesis. + + + &Ctrl;&Alt;S M Grupo Math + Selecciona el grupo matemáticas actual incluyendo las órdenes matemáticas. + + + &Ctrl;&Alt;S P Párrafo + Selecciona un párrafo completo, &ie;, un grupo de líneas de texto separadas en ambos lados por líneas vacías. Un párrafo no solo significa líneas continuas de texto, como en los demás editores. El significado extendido también incluye tablas, órdenes &latex; y todas las demás líneas fuente. Lo único importante para &kile; es que el tipo de párrafo esté separado por dos líneas vacías. + + + &Ctrl;&Alt;S L Línea + Selecciona la línea de texto de la posición actual del cursor. + + + &Ctrl;&Alt;S W Palabra TeX + Selecciona la palabra bajo la posición del cursor. Esta selección también tiene un significado extendido, porque esta orden también puede seleccionar órdenes &latex;, que comienzan con una barra invertida y pueden tener un inicio y un final opcional. + + + + + + + + + Borrar + + Para borrar algunas partes de un documento puede realizar la selección y utilizar la tecla Borrar. Pero también Kate proporciona la orden &Ctrl;K que borra la línea. Pero &kile; proporciona una forma rápida que son sus propias órdenes de borrado. En EditarBorrar podrá encontrar las siguientes órdenes de borrado de texto. + + + Editar->Borrar elementos + + + + + + Editar->Borrar elementos + + + + + + &Ctrl;&Alt;T E Entorno (dentro) + Borra un entorno sin incluír las etiquetas. + + + &Ctrl;&Alt;T F Entorno (fuera) + Borra un entorno incluyendo las etiquetas. + + + &Ctrl;&Alt;T T Grupo TeX (dentro) + Borra un grupo TeX dentro de los paréntesis. + + + &Ctrl;&Alt;T U Grupo TeX (fuera) + Borra un grupo TeX incluyendo los paréntesis. + + + &Ctrl;&Alt;T M Grupo Math + Borra un grupo matemático actual incluyendo las órdenes matemáticas. + + + &Ctrl;&Alt;T P Párrafo + Borra un párrafo entero. Vea la orden SeleccionarPárrafo, para ver cómo se definen los párrafos en &kile;. + + + + &Ctrl;&Alt;T I Al final de la línea + Borra desde la posición del cursor hasta la posición del final de la línea. + + + &Ctrl;&Alt;T W Palabra TeX + Borra la palabra o la órden &latex; situada bajo la posición del cursor. + + + + + + + + + Entorno + + Ya se mencionó que los entornos son el punto central en &latex;. Por ello &kile; proporciona otras cinco órdenes en los submenús de EditarEntorno para trabajar con &latex; de una forma sencilla. + + + Editar->Elementos de entorno + + + + + + Editar->Elementos de entorno + + + + + + + &Ctrl;&Alt;E B Ir al principio + Esta orden irá al principio del entorno actual, sin importar en la posición en la que esté. El cursor se colocará delante de la etiqueta de apertura del entorno. + + + &Ctrl;&Alt;E E Ir al final + Esta orden irá al final del entorno actual, sin importar la posición en la que esté. El cursor se colocará detrás de la etiqueta de cierre del entorno. + + + &Ctrl;&Alt;E M Coincidir + Cuando su cursor se coloque delante o sobre la etiqueta \begin{environment}, se desplazará a la del final del entorno y viceversa. + + + &Ctrl;&Alt;E C Cerrar + Al teclear muchas etiquetas de entorno anidadas, puede perder el control de estos entornos. Esta orden cerrará el último entorno abierto, de forma que la estructura de anidación de entornos no se romperá. + + + &Ctrl;&Alt;E A Cerrar todo + Cierra todos los entornos abiertos, no solo el último entorno abierto. + + + + + + + + + Grupo &tex; + + &kile; también ofrece órdenes especiales para los grupos &latex;, que están definidas por llaves {...}. En el submenú EditarGrupo TeX encontrará algunas órdenes importantes, en EditarEntorno. + + + Editar->Grupo TeX + + + + + + Editar->Grupo TeX + + + + + + &Ctrl;&Alt;G B Ir al principio + Salta al principio del grupo actual desde su posición actual. El cursor se colocará delante de la llave de apertura. + + + &Ctrl;&Alt;G E Ir al final + Salta al final del grupo actual desde su posición actual. El cursor se colocará detrás de la llave de cierre. + + + &Ctrl;&Alt;G M Coincidencia + Si el cursor se sitúa delante o detrás de una llave abierta del grupo &tex;, se moverá al final del grupo y viceversa. + + + &Ctrl;&Alt;G C Cerrar + Teclear muchas llaves de grupo anidadas puede ser duro. Esta orden cerrará el último grupo abierto, de forma que la estructura de anidación de grupos de &tex; no se romperá. + + + + + + + + + Comillas dobles + + En &latex;, dos comillas simples se utilizan como comillas dobles. Para ayudarle a insertarlas de forma eficiente, &kile; le permite pulsar " para insertar dos comillas simples de apertura. De la misma forma, para cerrar el entrecomillado deberá pulsar ". &kile; es lo suficientemente inteligente como para reconocer este caso e insertar dos comillas de cierre para &latex;. + + Para conseguir que aparezcan las comillas dobles, pulse dos veces ".Para conseguir que aparezcan las comillas dobles, pulse dos veces ". + + Puede activar o desactivar esta inserción automática de apertura y cierre de dobles comillas en la sección PreferenciasConfigurar Kile...LaTeX. + + + Comillas dobles + + + + + + Comillas dobles + + + + + Si incluye opciones específicas de su idioma o archivos de estilo como ngerman o french, también podrá utilizar las Comillas dobles alemanas o francesas. Hay muchos más idiomas disponibles. + + + + + + Nueva línea inteligente + + Si pulsa &Shift;Intro, &kile; insertará una nueva línea inteligente. Si su posición actual se encuentra dentro de un entorno de lista, como enumerate o itemize, &kile; no solo insertará una línea nueva, sino que también añadirá una orden \item. + + Si está dentro de un entorno tabular, &kile; terminará la línea actual con \\, seguido de una línea nueva. + + Si está dentro de un comentario de &latex;, &kile; comenzará la siguiente línea con un %. + + Incluso mejor, &kile; es lo suficientemente inteligente como para soportar entornos predefinidos de &latex; y definidos por el usuario, que pueden añadirse en la sección PreferenciasConfigurar Kile...LaTeX. + + + + + + Tabulador inteligente + + Algunos usuarios quieren colocar las columnas en entornos tabulares y situar allí todos los caracteres ampersand & unos debajo de otros. &kile; pretende soportar esto. Si pulsa &Shift;&Alt;&, &kile; situará el siguiente tabulador bajo la columna del superior. Sin embargo, a veces no se corresponderá con el tabulador adecuado. &kile; añadirá algunos espacios para ajustarlo a la posición de la columna del tabulador actual. + + + + + + + + Completado de código + + A pesar de que &kate; ofrece un buen modo de completado, el completado de código extendido de &kile; soporta métodos especialmente indicados para &latex;. Existen cinco modos diferentes integrados. Tres de ellos trabajan bajo petición, los otros dos son modos de autocompletado. Todos los modos pueden configurarse para trabajar de formas muy diferentes a través de PreferenciasConfigurar Kile.... + + + + Completado automático de entornos + + Cuando empiece un nuevo entorno, escribiendo por ejemplo \begin{environment}, &kile; automáticamente añadirá una orden \end{environment}, con una línea en medio para su texto. + + El autocompletado se puede desactivar en la sección &latex; de PreferenciasConfigurar Kile... LaTeXEntornos. + + + Completando un entorno de ecuación + + + + + + Completando un entorno de ecuación + + Completando un entorno de ecuación + + + + + + + + Órdenes &latex; + + Cuando teclee algunas letras, puede activar este modo de completado para las órdenes &latex; y palabras normales con EditarCompletadoOrden (La)TeX o el acceso rápido de teclado &Ctrl;Espacio. &kile; lee primero las letras de la posición del cursor hacia la izquierda y se detiene en el primer caracter que no sea una letra o una barra invertida. Si el patrón comienza con una barra invertida, &kile; entrará en modo de completado para las órdenes &tex; o &latex;. Sino entrará en el modo de diccionario normal, donde no encontrará órdenes &latex;. Dependiendo del modo seleccionado, se abrirá un cuadro de completado. Podrá ver todas las órdenes o palabras que comiencen con el patrón actual. Puede navegar con las teclas del cursor por la lista y seleccionar una entrada con &Enter; o con una doble pulsación del ratón. + + + Completando una orden LaTeX + + + + + + Completando una orden LaTeX + + + + + Cuando pulse la tecla &Backspace;, la última letra de su patrón se borrará, y la lista de completado crecerá. Por otra parte, si teclea otra letra el patrón se expandirá y la lista de palabras visibles se reducirá. + + Si decide no seleccionar ninguna sugerencia, podrá mantener este diálogo con &Esc;. + + Podrá ver que todas las órdenes se escriben con una pequeña descripción de sus parámetros. Estas descripciones desaparecen cuando selecciona una orden. Opcionalmente puede dejar que &kile; inserte marcas en estos lugares, de forma que pueda saltar fácilmente a estas posiciones con EditarViñetasSiguiente topo e insertar el parámetro que desee. + + + Completando una orden LaTeX + + + + + + Completando una orden LaTeX + + + + + Vaya a PreferenciasConfigurar Kile... KileCompletado para configurar una o más de estas listas. Puede seleccionar listas de palabras diferentes para las órdenes &tex; y &latex; y el modo diccionario para las palabras normales. + + + + + + Entornos + + El modo de órdenes no es práctico para completar órdenes. Siempre podrá teclear algunas ordenes de \begin, e invocar el modo de completado puede dar como resultado una enorme lista de etiquetas de entorno. Por otra parte, los entornos que &kile; utiliza con cierta frecuencia cuentan con un modo especial para completado de entornos. Olvide la etiqueta de apertura y escriba, por ejemplo, eq. + + Cuando llame al modo de completado con EditarCompletado Entorno o con el acceso rápido &Alt;Espacio, la etiqueta de apertura se añadirá automáticamente y verá \begin{eq}. Después de este cambio, la lista de completado será mucho más reducida. + + + Completando una orden LaTeX + + + + + + Completando una orden LaTeX + + + + + Ahora seleccione un entorno, y verá que también se cierra automáticamente. Incluso más, si &kile; lo reconoce como una lista de entorno, insertará una primera etiqueta \item. + + + Completando una orden LaTeX + + + + + + Completando una orden LaTeX + + + + + Vaya a PreferenciasConfigurar Kile... Kile Completado para configurar una o más de estas listas. Este modo utiliza la misma lista de palabras que el modo de completado de las órdenes &tex; y &latex;. + + + + + + Abreviaturas + + &kile; soporta listas de abreviaturas definidas por el usuario, que se reemplazan bajo petición por largas cadenas de texto. Vaya a PreferenciasConfigurar Kile... KileCompletado para configurar una o más de estas listas. Para el ejemplo dado, se elegirá la lista de abreviaturas en example.cwl. En este archivo encontrará, por ejemplo, la entrada L=\LaTeX. + + Por ejemplo, teclee la letra L. Llame el modo de abreviatura de completado de palabra con EditarCompletadoAbreviatura o con &Ctrl;&Alt;Espacio, y la letra L se reemplazará por la cadena \LaTeX. + + + + + + Modos de autocompletado + + + + Órdenes &latex; + + Puede activar el modo de completado automático para las órdenes &latex;. Cuando se introduce un número de letras (valor predeterminado: 3), se abrirá una ventana con una lista de todas las órdenes &latex; coincidentes. Puede seleccionar una de estas órdenes, o ignorar esta ventana y teclear más letras. Las entradas del cuadro de completado cambiarán para adaptarse a las letras que escriba. + + Vaya a PreferenciasConfigurar Kile... KileCompletado para activar o desactivar este modo o para cambiar el número de palabras. + + + Completando un entorno de ecuación + + + + + + Completando un entorno de ecuación + + + + + + + + + Palabras de documento + + Los diccionarios grandes no son prácticos en el modo autocompletado. Pero, hemos visto que muchas palabras en un documento se teclean más de una vez. Por ello &kile; ofrece un autocompletado para todas las palabras del documento que el usuario haya tecleado anteriormente. + + Si desea activar o desactivar este modo, vaya a PreferenciasConfigurar Kile... KileCompletado. En este diálogo de configuración también podrá cambiar el número de palabras necesarias para que aparezca el cuadro de completado. + + + + + + + + Escribir los propios archivos de completado + + La especificación del formato de archivo de completado puede encontrarse en la especificación del formato de archivo CWL. + + Los archivos de completado pueden instalarse en la carpeta personal del usuario en la carpeta~/.kde/share/apps/kile/complete/<modo>/, donde <modo> se utiliza para abreviatura, diciconario o tex. + + + + + + + Asistentes y diálogos + + + + Incluir gráficos + + El diálogo Incluir gráficos inserta un gráfico de forma sencilla. Por favor, eche un vistazo a y para obtener una visión general de algunos aspectos básicos relacionados con los formatos gráficos. + + + Añadiendo un elemento gráfico + + + + + + Añadiendo un elemento gráfico + + + + + + Seleccione un archivo gráfico. Este puede ser JPEG, PNG, EPS e incluso un archivo EPS comprimido. Si tiene instalado &imagemagick; y también tiene configurado &kile; para utilizarlo (PreferenciasConfigurar Kile... LaTeXGeneral), la anchura y la altura de los gráficos se muestra automáticamente. Si &imagemagick; puede determinar la resolución, el tamaño de los gráficos también se muestra en centímetros. + + Decida si su imagen será centrada en la página. + + Elija entre &latex; tradicional y &pdflatex;. Recuerde que &pdflatex; también puede crear una salida DVI y no solo PDF. + + Puede indicar si el nombre del archivo debería ser relativo. Este es el modo predefinido cuando utiliza una orden \graphicspath. + + De forma predeterminada los archivos gráficos deberían estar en la misma carpeta que el documento maestro para encontrarlos. Sin embargo, es posible colocarlos en otras carpetas para hacer las cosas más fáciles. Sin una orden \graphicspath, &kile; incluirá la ruta para el archivo gráfico. Pero si utiliza \graphicspath, como: + +\graphicspath{{/ruta/a/mis/gráficos}{otra/ruta/a/más/gráficos}} + + + y comprueba esta opción, &kile; solo utilizará el nombre base de los archivos gráficos. + + Otro ejemplo: si configura \graphicspath de forma similar a: + +\graphicspath{{./}{cámara/}{imágenes/}} + + + &latex; buscará en la carpeta actual, a continuación en cámara y finalmente en imágenes para encontrar sus archivos gráficos. + + Si selecciona la anchura o la altura, el gráfico completo se escalará proporcionalmente. Si selecciona dos valores para la anchura y la altura a la vez, la anchura y la altura se escalarán con factores diferentes, y esto puede que no sea lo que desee. Vea también la información cercana a la parte superior del diálogo para saber el tamaño original de los gráficos. + + Inserte un ángulo para rotar el gráfico en el sentido de las agujas del reloj. + + El cuadro con la información relacionada con el archivo gráfico se configurará automáticamente cuando lo elija. Esta información solo será necesaria cuando trabaje con el &latex; tradicional y gráficos de mapas de bits. Vea la discusión referente a los gráficos EPS. + + Su última elección indicará si este gráfico se empotrará en un entorno de figura. Si así lo decide, podrá insertar un subtítulo y una etiqueta. Es buena idea añadir un prefijo diferente para cada tipo de etiqueta. Es habitual utilizar el prefijo fig: para las imágenes. + + + + + + + Asistentes para matrices + + Una de las tareas más aburridas que uno puede hacer en &latex; consiste en escribir una matriz o un entorno de tabla. Se debe llevar la cuenta de todos los elementos, asegurarse de que el entorno está bien formado, y que todas las cosas están donde se supone que deben estar. Una buena indentación ayuda, pero hay una forma más sencilla de hacerlo: utilizar el menú Asistente de &kile;. Contiene Tabla y Matriz (utilizado en entornos matemáticos). Conseguirá un formulario con forma de matriz que puede rellenar fácilmente con sus entradas. Este diálogo también ofrece algunas opciones para seleccionar el tipo del material de la tabla. + + + Insertando un entorno de tabla + + + + + + Insertando un entorno de tabla + + + + + La opción Tabulación mostrará un menú para configurar la tabulación del entorno. En todos estos entornos, puede configurar el número de filas y columnas, así como otras opciones específicas. + + + + + Utilidades &postscript; + + Los archivos PS no son tan populares como los PDF, pero son una excelente base para la manipulación y reordenación de páginas. Si necesita una salida PDF, puede recolocar las páginas con algunas utilidades &postscript; y convertirlas a PDF con ps2pdf. + + El asistente &postscript; le sugerirá las reordenaciones más habituales, pero es libre de hacer su propia elección. El trabajo lo realizan los programas pstops y psselect, que podrá encontrar en la mayor parte de las distribuciones en el paquete psutils. Si uno de estos programas no está disponible, el elemento correspondiente no será visible. + + + Diálogo PSTools + + + + + + Diálogo PSTools + + + + + En primer lugar elija el archivo de entrada. Si &kile; encuentra un archivo PS correspondiente al documento maestro, se utilizará como archivo de entrada, aunque puede escoger otro archivo. A continuación elija un archivo de salida, y seleccione una de las tareas. Finalmente, debe decidir si desea hacer la conversión o solo llamar a &kghostview; para ver el resultado. + + + + + 1 página A5 + página vacía --> A4 + Combina una página A5 con una página vacía en una página A4. Si se combinan juntas dos páginas A5, se girarán 90 grados y se ajustarán en una página A4 en modo horizontal. + + A5 + página vacía + + + + + + A5 + página vacía + + + + + + + + 1 página A5 + duplicado --> A4 + Coloca una página A5 y un duplicado en una página A4. + + duplicar páginas A5 + + + + + + Duplica una página A5 + + + + + + + + 2 páginas A5 --> A4 + Coloca dos páginas A4 consecutivas en una página A4. + + Combina dos páginas A5 + + + + + + Combina dos páginas A5 + + + + + + + + 2 páginas A5L --> A4 + Coloca dos páginas consecutivas A5 horizontales en una página A4. + + + + 4 páginas A5 --> A4 + Combina cuatro páginas consecutivas A5 en una página A4. Las páginas A5 se escalarán utilizando el factor 0,7 para ajustarla a la página. + + 4 páginas A5 --> A4 + + + + + + 4 páginas A5 --> A4 + + + + + + + + 1 página A4 + página vacía --> A4 + Combina una página A4 con una página vacía A4. Cuando dos páginas A4 se combinan en una página A4, tendrán que ser escaladas con un factor 0,7 y se colocarán en modo vertical. + + 1 página A4 + página vacía --> A4 + + + + + + 1 página A4 + página vacía --> A4 + + + + + + + + 1 página A4 + duplicado -->A4 + Coloca una página A4 y un duplicado juntos en una página A4. + + 1 página A4 + duplicado -->A4 + + + + + + 1 página A4 + duplicado -->A4 + + + + + + + + 2 páginas A4 --> A4 + Coloca dos páginas consecutivas A4 juntas en una página A4. + + Combina dos páginas A4 + + + + + + Combina dos páginas A4 + + + + + + + + 2 páginas A4L --> A4 + Coloca dos páginas consecutivas A4 en modo horizontal juntas en una página A4. + + + + seleccionar páginas pares + Selecciona todas las páginas pares de un documento. + + + + seleccionar páginas impares + Selecciona todas las páginas impares de un documento. + + + + seleccionar páginas pares (orden inverso) + Selecciona todas las páginas pares de un documento en orden inverso. + + + + seleccionar páginas impares (orden inverso) + Selecciona todas las páginas pares de un documento en orden inverso. + + + + invertir todas las páginas + Invierte todas las páginas de un documento. + + + + copiar todas las páginas (ordenadas) + Copia todas las partes de un documento. Debe seleccionar el número de copias ordenadas. + + Copiar todas las páginas (ordenadas) + + + + + + Copiar todas las páginas (ordenadas) + + + + + + + + copiar todas las páginas (desordenadas) + Copia todas las páginas de un documento. Debe seleccionar el número de copias no ordenadas. + + Copiar todas las páginas (desordenadas) + + + + + + Copiar todas las páginas (desordenadas) + + + + + + + + pstops: seleccionar parámetro + Existen muchas opciones para las utilidades de &postscript; pstops y psselect. Si necesita una muy especial, puede llamar a pstops con una opción a su elección. Por favor, lea el manual para ver todas las posibles opciones. + + + + psselect: seleccionar parámetro + Puede llamar a psselect con una opción que elija. Por favor, lea el manual para ver todas las opciones posibles. + + + + + + + + Estadísticas del documento + + El diálogo de estadísticas le proporciona una visión general de las estadísticas para una selección, un documento, o para el proyecto completo. Incluye el número de palabras, órdenes/entornos &latex; e incluso el número de caracteres de cada tipo. Los números de las estadísticas se puede copiar al portapapeles como texto o como un texto formateado en un entorno tabular en &latex;. Si desea obtener las estadísticas del proyecto completo puede utilizar ArchivoAbrir todos los archivos del proyecto, que es la forma más sencilla y rápida de abrir todos los archivos fuente de su proyecto. + Tenga un poco de cuidado al interpretar la exactitud de los números. Hemos incluído un poco de lógica para obtener una buena estimación, p.ej. K\"uhler da como resultado una palabra y una orden, formada por seis caracteres. Pero existen combinaciones en las que parte de las órdenes se cuentan como palabras y viceversa. Debe tener en cuenta que el algoritmo se ha verificado para idiomas similares al inglés o alemán, por tanto, no de los números por exactos. Si necesita hacer un informe con números de palabras o caracteres exactos, realice algunas pruebas para verificar si la exactitud de kile satisface sus necesidades. + + + + + + + Etiquetas especiales en &latex; + + + Utilizando la librería de etiquetas de &latex; + + &latex; dispone de miles de etiquetas para símbolos y caracteres especiales. La manera más sencilla de insertar caracteres especiales es empleando el menú de la barra lateral, a la izquierda de la ventana de edición. + + + El menú de barra lateral + + + + + + El menú de la barra lateral + + El menú de la barra lateral + + + Están disponibles los siguientes tipos: + + + Más frecuentemente usado + Relación + Operadores + Flechas + Símbolos matemáticos diversos + Texto diverso + Delimitadores + Griego + Caracteres especiales + Caracteres cirílicos + Definido por el usuario + + Las ayudas visuales de los iconos muestran las órdenes de &latex; y en ocasiones pueden necesitar paquetes. + Pulsar &Shift; y un símbolo dará como resultado que se inserte $\symbolcmd$. De forma similar pulsar &Ctrl; insertará los paréntesis de cierre. + Si inserta una orden que precise un paquete no incluido en su documento &latex;, verá un mensaje de aviso en la ventana de registro. + La primera lista de símbolos Más frecuentemente usado. Los símbolos insertados se añadirán a la lista, para conseguir una referencia rápida y sencilla. La ordenación de los símbolos no cambiará cuando se añadan símbolos nuevos, pero se incrementará un contador de referencia. Si el número de elementos excede de 30, el elemento con un número menor se eliminará. + La lista de símbolos Definidos por el usuario le permite mantener sus propios símbolos. Para crear sus propios símbolos necesita el programa gesymb y el archivo definitions.tex del paquete fuente de kile. También necesitará un compilador &latex; (qué sorpresa) y &dvipng; (versión 1.7 o posterior). El procedimiento consiste en crear un archivo &latex; con \input{definitions}, que hace que las órdenes siguientes estén disponibles, y le permite que gesymb mysymbols.tex usuario (que llama &latex; y &dvipng;) cree los iconos. Después de copiarlos a $HOME/.kde/share/apps/kile/mathsymbols/user/ y restaurar kile puede utilizar sus propios símbolos. + Las siguientes órdenes se definen en difinitions.tex: + + \command[\argumento-opcional]{\símbolo}: Incluye el símbolo \símbolo en la lista, el argumento opcional \argumento-opcional especifica la orden que kile debe insertar. Si no se usa, se utiliza la orden en el argumento obligatorio. + + + \mathcommand[\argumento-opcional]{\símbolo}: Igual que el anterior, con la diferencia de que en el argumento obligatorio se inserta en el modo matemático. + + + \pkgs[argumento]{paquete}: Declara que la orden dada en esta línea necesita el paquete de &latex; paquete con el argumento opcional argumento. Esta orden debe estar frente a la orden \command y sobrescribe cualquier especificación de paquete del entorno neededpkgs. + + + \begin{neededpkgs}[argumentos-paquetes]{paquetes} ... \end{neededpkgs}: Tiene el mismo efecto que la anterior, pero para todas las órdenes encerradas. + + + + A continuación se muestra un ejemplo completo: + \documentclass[a4paper,10pt]{article} + \usepackage{amssymb} + \input{definitions} + % + \begin{document} + \pagestyle{empty} + % + \begin{neededpkgs}{amssymb} + \mathcommand{\surd} + \pkgs{amsmath}\mathcommand[\ddddot{}]{\ddddot{a}} + \mathcommand{\angle} + \end{neededpkgs} + \command{\"A} + \mathcommand{\exists} + \mathcommand[\stackrel{}{}]{\stackrel{abc}{=}} + + %\begin{neededpkgs}[russian,koi8-r,T2C,]{babel,inputenc,fontenc,mathtext} + % + % \end{neededpkgs} + % esto debe incluirse en los paquetes + % \usepackage{mathtext} + % \usepackage[T2C]{fontenc} + % \usepackage[russian]{babel} + % \usepackage[koi8-r]{inputenc} + % solo para explicar el formato + \end{document} + + + + + + + Utilizando Bibitems + + \bibitem es una orden utilizada para introducir una referencia en un entorno thebibliography en su documento. La sintaxis para utilizar \bibitem es\bibitem[etiqueta]{clave}. + + La [etiqueta] opcional es para que añada su propio sistema de etiquetado para esa entrada bibliográfica. Si no se fija ninguna etiqueta, las entradas serán ordenadas numéricamente: [1], [2], [3], etc. + + El argumento {clave} se utiliza para referenciar y enlazar las órdenes \bibitem y \cite así como la información que contienen. La orden \cite contiene la etiqueta asociada con el \bibitem deseado, que está localizado dentro de un entorno thebibliography, y contiene los datos de la referencia. Tanto el \bibitem como el \cite correspondiente deben tener la misma {clave}. La manera más sencilla de organizar las claves es por el apellido del autor. El segundo {} en {thebibliography} denota la mayor etiqueta bibliográfica que puede tener. Es decir, que insertar {} significa que puede tener cualquier etiqueta menor o igual a la expresión foo. Si se equivoca con este parámetro podría conseguir una indentación no demasiado atractiva en su bibliografía. + + La bibliografía es una sección aparte de su documento principal, y un ejemplo de código para la bibliografía podría ser el siguiente: + + + \begin{thebibliography}{50} + \bibitem{Simpson} Homer J. Simpson. \texts]{Mmmmm...donuts}. + Evergreen Terrace Printing Co., Springfield, AlgúnLugarEE.UU., 1998 + \end{thebibliography) + + Por tanto, su código fuente principal contendría la localización de la información relativa al \bibitem empleando \cite. Este código se parecería al siguiente: + + + Mi tesis, sobre la filosofía de Los Simpsons\copyright + proviene de mi libro favorito \cite{Simpson}. + + + Como muchas veces es difícil recordar la clave de una cita bibliográfica una vez que tiene muchas referencias, &kile; proporciona una manera sencilla de insertar una cita. En la barra de herramientas Editar pulse en el segundo menú desplegable (normalmente pone etiqueta) y seleccione cite (cita). Se mostrará una lista con todas las claves de las citas. Seleccione la referencia correcta y se insertará una cita en su documento. Para actualizar la lista de claves, guarde su documento o bien seleccione EditarActualizar estructura o pulse F12. + + El resultado final en la bibliografía de su documento se parecería a algo como esto: + + [1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, AlgúnLugarEE.UU., 1998. + + La manera más sencilla de trabajar con \bibitem y \cite es utilizar la opción marcada como cite (cita) en uno de los menús desplegables de la barra de herramientas. Cuando selecciona una referencia para insertar, se le proporcionará la lista de bibitems que haya creado hasta ahora, y podrá seleccionar la referencia de esa lista. &kile; también puede trabajar junto con aplicaciones de edición de &bibtex;, como &kbibtex;, para ayudarle a hacer las referencias más fácilmente. + + + + + + Etiquetas definidas por el usuario + + &kile; le permite crear sus propias etiquetas. Una etiqueta es similar a un acceso rápido que ejecuta algúna orden o escribe texto empleado frecuentemente. Por ejemplo, Joe Sixpack utiliza frecuentemente las frases Yo prefiero \LaTeX\ a \TeX\ y ¿Qué haría yo sin Linux?. Para crear etiquetas definidas por el usuario para escribir estas frases, él accedería a LaTeXEtiquetas de usuarioEditar etiquetas de usuario..., mostrándose un diálogo en el que podrá crear sus propias etiquetas. + + El cuadro de diálogo para editar etiquetas del usuario + + + + + + El cuadro de diálogo para editar etiquetas del usuario + + El cuadro de diálogo para editar etiquetas del usuario + + + + + Invocando una etiqueta definida por el usuario + + + + + + Llamando una etiqueta definida por el usuario + + Llamando una etiqueta definida por el usuario + + + + Probablemente le daría a cada etiqueta un nombre que la identifique con claridad. El nombre que le da a su etiqueta se introduce en la sección marcada como Elemento de menú, y el texto de la orden frecuentemente usada se debería introducir en la sección Valor. Una vez que las órdenes hayan sido introducidas, puede utilizarlas rápidamente mediante la combinación de teclas &Ctrl;&Shift;1 para la primera etiqueta para introducir Yo prefiero \LaTeX\ a \TeX\, y &Ctrl;&Shift;2 para introducir ¿Qué haría yo sin Linux?. + + + + Localizadores en etiquetas definidas por el usuario + + Existen algunos localizadores que puede utilizar en las etiquetas definidas por el usuario, que son %B, %C, %M y %S. + + + %B: será sustituido por una marca. + %C: indica dónde se posicionará el cursor después de usar una etiqueta definida por el usuario. + %M: el texto seleccionado se inserta en este lugar cuando se utiliza la etiqueta definida por el usuario. + %S: se sustituirá por el nombre del archivo fuente sin la extensión del archivo. + + + Para demostrar cómo funciona, pongamos como ejemplo que tenemos una etiqueta definida por el usuario, que contiene el valor \bfseries{%M}%C, y tengo una selección de texto resaltada en mi documento que quiero pasar a negrita. Entonces resalto la frase Me encantan los viernes, aplico nuestra etiqueta definida por el usuario pulsando &Ctrl;&Shift;1, y obtengo el texto \bfseries{Me encantan los viernes}, con el cursor posicionado al final del texto. + + + + + + + + + + Las herramientas de construcción + + + + Compilar, convertir y ver + + Para ver el resultado de su trabajo, primero necesita compilar el archivo fuente. Todas las herramientas de construcción están agrupadas en los menús GenerarCompilar, GenerarConvertir, y GenerarVer. + + Para compilar su código fuente para los visores en pantalla tales como &kdvi;, &kghostview;, &kpdf; o para realizar la conversión posterior, puede utilizar el acceso rápido &Alt;2. Entonces podrá ver el archivo DVI utilizando su visor predeterminado con &Alt;3, convertir el DVI a un archivo PS con &Alt;4, y ver el archivo PS con &Alt;5. + + + + &bibtex; + + Si está utilizando &bibtex; para sus entradas bibliográficas, usualmente deberá elegir un esquema de compilación especial. Esto implica llamar a &latex; y a continuación a &bibtex; y a continuación &latex; dos veces de nuevo. Afortunadamente &kile; es lo suficientemente inteligente como para detectar automáticamente si es necesario llamar a herramientas adicionales como &bibtex;, &makeidx; y &asymptote;. De forma predeterminada esta lógica está activada y puede cambiarse en PreferenciasConfigurar Kile...HerramientasCompilar en la pestaña General en las herramientas &latex; y &pdflatex;. + + + + + + &makeidx; + + Si está utilizando el paquete &makeidx; para hacer un índice alfabético final para su documento, también debe seguir un cierto patrón en sus compilaciones o dejar que &kile; lo haga de la misma forma que con los archivos &bibtex;. + + + + + + MetaPost y Asymptote + + Si quiere compilar su documento con MetaPost o Asymptote, programa de dibujo de imágenes, puede hacerlo con CompilarCompilarMetapost, o CompilarOtro Asymptote. + + + + + + &pdflatex; + + Existe otra manera de compilar su documento si desea obtener un PDF: ejecutando &pdflatex; compilará el fuente directamente en un archivo PDF, con &Alt;6: podrá ver el archivo compilado pulsando &Alt;7. + + También puede convertir un PS en un PDF con &Alt;8, o directamente un DVI en un PDF con &Alt;9. + + Emplear &pdflatex; en vez de &latex; puede deberse a una cuestión de simplicidad o costumbre, pero a veces el comportamiento de los dos programas puede ser diferente. + + + + + + &latex; para Web + + Finalmente, podría desear publicar su trabajo en la web y no sólo en papel. Puede entonces utilizar el programa latex2html, que puede llamarse desde el menú de &kile; GenerarConvertirLaTeX a HTML. El resultado se colocará en una subcarpeta de la carpeta de trabajo, y podrá ver el resultado de la conversión eligiendo el elemento de menú CompilarVerVer HTML. + + + + + + Pasar parámetros en línea de órdenes + + Si desea pasar algúnos parámetros específicos de línea de órdenes a la compilación, conversión o herramientas de visionado, puede configurar las llamadas en Preferencias Configurar Kile...HerramientasCompilar. + + + + + + + Vista previa rápida + + Necesitará algún tiempo para ver el resultado, cuando trabaje con &latex;. &latex; tiene que compilar las fuentes y llamar al visor. Esto puede ser molesto si sólo ha cambiado algunas letras en una ecuación dificil de presentar. &kile; tiene un modo de Vista previa rápida, con el que puede compilar solo una parte de un documento y ahorrar mucho tiempo. Soporta cuatro modos diferentes, que pueden combinarse con siete configuraciones. + + + Vista previa rápida + + + + + + Vista previa rápida + + + + + Todas las modificaciones se pueden realizar en PreferenciasConfigurar Kile... HerramientasVista previa. + + + Configuración de la vista previa rápida + + + + + + Configuración de la vista previa rápida + + + + + + + Modo de selección + + El usuario debe seleccionar una parte del documento. La entrada del menú GenerarVista previa rápidaSelección o el acceso rápido de teclado &Ctrl;&Alt;P,S iniciarán los programas seleccionados. &kile; tomará el preámbulo del texto original, por eso se incluirán todos los paquetes y órdenes definidas por el usuario. El usuario puede seleccionar una de las siete configuraciones predefinidas: + + + LaTeX+DVI (visor empotrado) + LaTeX+DVI (KDVI) + LaTeX+PS (visor empotrado) + LaTeX+PS (KGhostView) + PDFLaTeX+PDF (visor empotrado) + PDFLaTeX+PDF (KGhostView) + PDFLaTeX+PDF (KPDF) + + + Esto debería ser suficiente para cualquier situación para la que necesite una vista previa rápida. + + + + + + Modo entorno + + Es frecuentemente que quiera previsualizar el entorno actual, y especialmente los entornos matemáticos, que muchas veces pueden ser difíciles de escribir. &kile; ofrece una forma rápida de hacer esto. No se necesita selección, solo escoja GenerarVista previa rápidaEntorno o el acceso rápido de teclado &Ctrl;&Alt;P,E y el entorno actual se compilará y se mostrará. + + + + + + Modo subdocumento + + Si tiene un proyecto muy grande con muchos documentos, compilar el proyecto completo no es buena idea, si solo ha hecho cambios en un documento individual. &kile; es capaz de compilar y mostrar una vista previa del subdocumento actual. Toma el preámbulo del documento maestro, y compila solo la parte actual cuando seleccione CompilarVista previa rápidaSubdocumento o el acceso rápido de teclado &Ctrl;&Alt;P,D. + + + + + + Modo grupo matemático + + El modo de vista previa del grupo matemático le permite obtener la vista previa del grupo matemático que esté editando. &kile; toma el preámbulo de un documento maestro y solo compila el grupo matemático en el que se encuentra el cursor cuando haya seleccionado CompilarVista previa rápidaGrupo matemático o el acceso rápido de teclado &Ctrl;&Alt;P,M. + + + + + + Vista previa rápida en la barra inferior + + En lugar de mostrar la vista previa en un documento nuevo &kile; también puede configurarse para utilizar la barra inferior para las compilaciones de vista previa. Puede activar esta funcionalidad en el panel de configuración de la vista previa rápida. + + + + + + + + Formatos de archivos gráficos + + + + &latex; y &pdflatex; + + &pdflatex; cuando se utiliza con los paquetes graphics o graphicx, puede compilar correctamente archivos PNG y JPG en un DVI o PDF, pero no es capaz de manejar archivos EPS. Inversamente, el proceso de compilar con &latex;, a DVI y convertirlo a PS y tal vez a PDF soporta EPS, pero no soporta PNG ni JPG. + + Muchos usuarios desean crear documentos PDF, pero también desean utilizar el excelente paquete Pstricks para crear gráficos &postscript;, o desean utilizar la salida &postscript; del software matemático y científico específico como Mathematica, Maple o MuPAD. Estos usuarios de &latex; tienen que compilar primero &postscript;, incluso si desean crear documentos PDF, ya que estos programas generan código &postscript; que &pdflatex; no puede gestionar. Sin embargo, esto no es complicado y también se puede hacer con la ayuda de &kile;. + + + + + + Conversión de gráficos + + Para saltarse este frustrante bucle, en el caso de que desee incluir tanto código &postscript; como archivos PNG o JPG, tiene las siguientes posibilidades: + + + Si necesita un archivo en formato PS, pero tiene imágenes JPG o PNG, puede también simplemente usar &pdflatex; con la salida DVI primero, y después ejecutar en la línea de órdenes dvips para crear el archivo PS. Puede ver que &pdflatex; es una buena elección si sus fuentes no contienen código &postscript;. + + Puede convertir los archivos EPS a PNG u otros formatos con utilidades como Gimp o &imagemagick; y emplear &pdflatex;. + + La mejor forma es convertir los gráficos EPS a gráficos PDF con epstopdf, que se incluye en la distribución de &tex; y utilizar &pdflatex;. Genera gráficos de alta calidad, e incluso puede controlar el resultado con alguna de las siguientes opciones: -dAutoFilterColorImages=false + -dAutoFilterGrayImages=false + -sColorImageFilter=FlateEncode + -sGrayImageFilter=FlateEncode + -dPDFSETTINGS=/prepress + -dUseFlateCompression=true + + + + Incluso mejor: si su sistema permite shell-escape, la conversión se puede hacer al vuelo. Todo lo que tiene que hacer es incluír el paquete epstopdf, que se incluye en todas las distribuciones de &tex;, con la orden \usepackage{epstopdf}. Asumiendo que su código es + \includegraphics[width=5cm]{test.eps} + Dónde podrá llamar a &pdflatex; con la opción , el gráfico test.eps se convertirá automáticamente a test.pdf. + + Esta conversión se realizará cada vez que ejecute &pdflatex;. Si sus órdenes graficas se dan implícitamente: + \includegraphics[width=5cm]{test.eps} + epstopdf comprueba si test.pdf se encuentra disponible, para saltarse este paso. + + Puede convertir en el sentido contrario, y utilizar &latex; y la conversión a PS-PDF. Esto no siempre es una buena idea, ya que la encapsulación en EPS de JPG y PNG puede provocar archivos mayores, que derivan en documentos innecesariamente grandes. Sin embargo, esto depende en gran medida de la utilidad gráfica que utilice, ya que EPS puede encapsular otros formatos gráficos, pero no todas las aplicaciones soportan esto correctamente. Algunas podrían intentar generar su imagen JPG con vectores y varios archivos de scripts, que producirían archivos gigantescos. La conversión de todos los formatos gráficos a EPS puede realizarse por &imagemagick;. Otro programa sencillo que ejecuta este proceso correctamente es jpg2ps. + + También puede utilizar la conversión automática. Todos los archivos gráficos se convierten al vuelo a EPS y se insertan en el documento PS. Ésta es una forma cómoda, pero tiene que configurar su sistema de forma adecuada. Ésto se explica en la sección Gráficos EPS. + + + + + + + + Utilizar el archivo adecuado para cada imagen + + + EPS es un tipo de lenguaje de script de vectores gráficos, que describe todas las líneas y puntos que conforman el gráfico. Mantiene un buen aspecto incluso cuando se aumenta su tamaño más allá del predeterminado, y concuerda mejor con diagramas y gráficos vectoriales producidos nativamente en PS, que tienen un aspecto limpio y claro manteniendo un tamaño en bytes muy pequeño. + PNG (o GIF, en desuso) es un formato de archivo con pocas pérdidas, con una buena compresión y calidad. Es muy bueno para diagramas, escaneados de dibujos, o cualquier cosa cuya nitidez desee mantener. A veces no funciona bien cuando se utiliza para fotos. + JPG es un formato con pérdidas que comprime los archivos mejor que PNG al precio de algunas pérdidas en el detalle de la imagen. Esto es por lo general irrelevante para fotos, pero puede causar mala calidad para diagramas, dibujos, y puede directamente hacer desaparecer algunas líneas delgadas. En esos casos, utilice EPS o PNG. + + + Pero recuerde siempre: ¡basura al principio, basura al final! Ninguna conversión obtendrá una imagen buena de una imagen mala. + + + + + + + + Gráficos EPS + + Los archivos gráficos EPS son la forma tradicional de insertar archivos gráficos en documentos &latex;. Como las listas de correo están llenas de preguntas relativas a gráficos EPS, explicaremos algunos aspectos importantes y demostraremos cómo &kile; los soporta. + + + + &latex; y los gráficos EPS + + Si decide utilizar el tradicional &latex; para generar salidas PS o PDF, probablemente tendrá algunos problemas con los gráficos. Debe utilizar gráficos EPS (&postscript; encapsulado), no archivos JPEG o PNG. Ésto no debería ser ningún problema, ya que existen multitud de conversores como convert del excelente paquete &imagemagick;. Pero, ésto lleva su tiempo, por supuesto. + + Los archivos EPS se utilizan tanto por &latex; como por el conversor DVI-PS: + + + &latex; explora el archivo EPS para determinar la línea del borde, lo que le indica a &latex; cuánto espacio reservar para los gráficos. + + El conversor DVI-PS lee a continuación el archivo EPS e inserta el gráfico en el archivo PS. + + + Esto tiene algunas implicaciones: + + + &latex; nunca leerá el archivo EPS si se han especificado los parámetros relativos a los bordes en la orden de inserción del gráfico. + + Como &latex; no puede leer archivos no ASCII, no podrá leer información sobre los bordes a partir de archivos comprimidos o gráficos no EPS. + + Los gráficos EPS no se incluirán en el archivo DVI. Cómo los archivos EPS deben estar presentes cuando el archivo DVI se convierta a PS, los archivos EPS se deben acompañar de los archivos DVI si se mueven. + + + Ahora podrá llamar a &latex;, y a un conversor DVI-PS como dvips para crear su documento &postscript;. Si lo que desea es generar un documento PDF, debería ejecutar dvips con la opción de forma que llame a ps2pdf. Podrá encontrar muchos documentos describiendo esta solución. + + + + + + El &postscript; a través de &kile; + + &kile; le ayudará a obtener información de los bordes. Si tiene instalado el paquete &imagemagick;, &kile; extraerá esta información del archivo EPS y le insertará como opción. Este procedimiento tiene dos ventajas: + + + La información aparecerá en el diálogo, y no necesitará ser obtenida de nuevo por &latex;. + Y lo que es más importante, se calculará la anchura y la altura, cuando se conozca su resolución. Esta información se mostrará cerca de la parte superior del diálogo, y puede servir como pista cuando desee escalar el gráfico. + &kile; también soporta archivos EPS comprimidos con zip o gzip, que son mucho más pequeños que los archivos EPS. Pero, esta características pueden únicamente utilizarse con una configuración especial del sistema y un cambio de la configuración gráfica local, tal y como se describe en la sección Gráficos de mapas de bits. + + + + + + + El &postscript; a través de los gráficos de mapas de bits + + Si su sistema permite shell-escape, &kile; también soporta una forma sencilla de incluir gráficos de mapas de bits, si tiene configurado el sistema &tex; de forma adecuada. No necesitará convertir los gráficos JPEG y PNG, ya que esto se realizará automáticamente cuando el archivo DVI se convierta a PS. + + &latex; necesita alguna información sobre las extensiones de los archivos. El paquete graphicx busca un archivo graphics.cfg, que debe estar en su ruta de búsqueda de documentos para &latex;. Busque unas entradas como: + +\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}{}% + + + y reemplace estas líneas con: + +\DeclareGraphicsRule{.pz}{eps}{.bb}{}% + \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}% + \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}% + \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}% + % cambiadas o reglas para nuevos gráficos + \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}% EPS comprimido con zip + \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}% EPS comprimido con gzip + \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:-}% gráficos PDF + + + Podrá encontrar este archivo, por ejemplo en Debian, en /etc/texmf/latex/graphics.cfg. Lo mejor es copiar este archivo a su ruta local de tex y cambiarlo. Consulte el manual de &tex; para aprender cómo obtener una lista de sus carpetas &tex;. + + Con este archivo de configuración será capaz de insertar gráficos de mapa de bits y archivos EPS comprimidos con zip o gzip en &latex;. La orden para la conversión es dvips. Cuando vea la orden de conversión se dará cuenta de que no se crean archivos extra. El resultado del proceso de conversión se redirige directamente al archivo PS. Lo único que debe saber &latex; es el tamaño de los gráficos, y por eso necesitaremos los bordes, que proporciona &kile;. + + Algunos dicen que este camino es inseguro, usted tiene que decidir cómo trabajar. En cualquier caso, no necesita ningún cuadro con información, ya que &kile; extraerá esta información de los diferentes tipos de gráficos. + + + + + + &pdflatex; y los gráficos EPS + + Como ya se indicó, PDF&latex; no es capaz de manejar archivos gráficos EPS, pero los conversores como epstopdf le pueden ayudar. La mejor forma es incluir el paquete epstopdf, al que le seguirá el paquete graphicx. + +\usepackage[pdftex]{graphicx} + \usepackage{epstopdf} + + + Ahora podrá incluir gráficos EPS, si ejecuta pdflatex con la opción , pero podemos hacerlo incluso mejor manejando archivos EPS comprimidos con zip o gzip. Nuevamente deberemos cambiar el archivo de configuración gráfica graphics.cfg de forma similar a como ya se hizo. Esta vez buscaremos: + +% pdfTeX ejecutándose en modo pdf + \ExecuteOptions{pdftex}% + + + y añadiremos algunas líneas. + +% pdfTeX ejecutándose en modo pdf + \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}}% + }% + + + Con estas líneas, &pdflatex; será capaz de manejar archivos EPS, y esperamos que no tenga más problemas con los gráficos. + + + + + + + + Documento maestro + + Definir su documento como maestro le permite trabajar con archivos separados, lo cual le proporciona un documento padre (o documento maestro) y documentos hijos que se complementan en su trabajo. Después de haber definido su documento maestro con el correspondiente orden en el menú Preferencias, todas las órdenes del menú Herramientas tendrán aplicación sólo en este documento, incluso cuando esté trabajando en los documentos hijos. Puede incluso cerrar el documento maestro. + + + + + Manejo de errores + + Tras compilar algo, &kile; echa un vistazo a los mensajes de error generados. Si hay algún error o aviso, se resumirá brevemente en la ventana de Registro y mensajes. Se puede profundizar más en los mensajes seleccionando CompilarVer archivo de registro, o utilizando el acceso rápido de teclado &Alt;0. El registro generado se mostrará entonces en la ventana de Registro y mensajes, con los errores y los avisos resaltados. + + + Viendo el registro + + + + + + Viendo el registro + + Viendo el registro + + + + Puede fácilmente saltar de un mensaje a otro en el archivo de registro utilizando los elementos del menú GenerarSiguiente / Anterior error /aviso de LaTeX, o utilizando los botones de la barra de herramientas correspondientes. + + Para saltar a la línea en el documento fuente &latex; en la que se produjo el error o aviso, pulse en el error o aviso en la ventana de Registro y mensajes. &kile; le llevará automáticamente a la línea en cuestión. + + + + + + El modo de vigilar archivo + + Cuando ejecute la orden de Construcción rápida, un visor de algún tipo será normalmente llamado tras la compilación. Si no está utilizando un visor empotrado, una nueva ventana se abrirá cada vez. + + Si está ajustando el aspecto de su documento, podría ocurrir que ejecutara Construcción rápida muy a menudo, y tener muchas ventanas del visor abiertas en su escritorio. Para evitar esta confusión, puede activar el Modo de vigilar archivo, que evitará que Construcción rápida ejecute un visor. + + Actualmente, &kdvi; soporta actualización continua del archivo DVI observado, pero &kghostview; no es tan perfecto: para actualizar un documento tras compilar, deberá cambiar de página, y el número de páginas no será cambiado en la visualización de &kghostview;. + + Este modo carece de utilidad con los visores empotrados, ya que tiene que cerrarlos de todas maneras para volver a editar el documento y recompilar. + + + + + + + + Navegando por el código fuente &latex; + + + + Utilizando la vista de estructura + + La vista de Estructura muestra la jerarquía del documento que está siendo creado en &kile;, y le permite rápidamente navegar a través de él, mostrando sus diferentes partes. Para moverse por su documento, todo lo que necesita es pulsar con el botón izquierdo del ratón en cualquier etiqueta, capítulo, sección, subsección, etc., y será llevado al principio del área correspondiente. + + Si incluyó un archivo &latex; en su código fuente empleando las etiquetas \input o \include, estos archivos serán referenciados en la vista de Estructura. Si pulsa dos veces en sus nombres, &kile; mostrará el archivo incluído en la ventana del editor. + + El árbol jerárquico tiene también una rama separada para etiquetas utilizadas en el texto. + + + Utilizando la vista de Estructura + + + + + + Utilizando la vista de Estructura + + Utilizando la vista de Estructura + + + + + + Actualizando la vista de estructura + + Para actualizar su vista de estructura puede o ir a EditarActualizar estructura, pulsar F12, o guardar su documento, lo que hará que &kile; actualice su vista de Estructura. + + + + + + + + Marcadores + + Los marcadores son su referencia a un segmento de texto o una línea dentro del entorno de &kile;. Para utilizar un marcador, seleccione una línea específica de su documento a la que le gustaría volver. Entonces pulse &Ctrl;B, y &kile; añadirá un marcador a esta línea. También puede fijar un marcador resaltando una línea y eligiendo el menú MarcadoresCambiar marcador. + + Para eliminar todos sus marcadores seleccione MarcadoresBorrar marcadores. + + Tenga en cuenta que los marcadores no se guardarán tras salir de &kile;. + + + + + + + + Proyectos + + + + Trabajando con proyectos + + En &kile; puede crear y trabajar con proyectos. Un proyecto es un grupo de &latex;, gráficos, &bibtex; u otros documentos que entre todos contienen la información que se utilizará para completar su documento. Un proyecto típico consistiría en varios capítulos escritos en diferentes archivos .tex. Todos ellos se incluirían en un mismo proyecto, para facilitar el manejo del documento que conforman. Las especificaciones de un proyecto se guardan en un archivo especial, con extensión .kilepr. + + Un proyecto añade las siguientes funcionalidades: + + + No necesita configurar un documento maestro: &kile; lo hace automáticamente. + Los archivos de proyecto se pueden guardar juntos con facilidad a través de la opción CompilarOtroArchivar. + La vista de Archivos y proyectos muestra qué archivos están incluídos en el proyecto. + Después de abrir un proyecto, cualquier archivo que hubiera abierto se restaurará con la codificación y el resaltado originales. + El completado de código funciona con todos los archivos del proyecto. + El completado de referencia funciona con todos los archivos del proyecto. + El completado de citas funciona con todos los archivos del proyecto. + Buscar en todos los archivos del proyecto. + Especifica la orden personalizada quickbuild y &makeidx;. + + + + + + + Creando un proyecto + + Para crear un proyecto, seleccione ProyectoNuevo proyecto... Se le preguntará la siguiente información para crear su proyecto: + + Título del proyecto. + Nombre del archivo de proyecto con extensión .kilepr. + Nombre de archivo. + Tipo de archivo creado: documento vacío (empty document), artículo (article), libro (book), carta (letter), informe (report)... + + + Cuando rellene el campo nombre de archivo, debe incluír una ruta en la que se encuentre el archivo del proyecto .kilepr. + + + + + + La vista de archivos y proyectos + + La vista de Archivos y proyectos es un botón del menú de la barra lateral. Desde esta vista, puede ver la estructura de su proyecto, sus archivos, y el nombre del archivo .kilepr que guarda la información del proyecto. Las opciones para añadir, eliminar o cambiar en su proyecto se realiza mediante la vista de Archivos y proyectos. + + + La vista de archivos y proyectos + + + + + + La vista de archivos y proyectos + + La vista de archivos y proyectos + + + + + + + + Añadir y eliminar archivos + + Para añadir un archivo a su proyecto, abra cualquier archivo &tex;, pulse con el botón derecho en su nombre en la vista de Archivos y proyectos, y seleccione Añadir a proyecto. Si tiene varios proyectos abiertos, un cuadro de diálogo le preguntará a qué proyecto debe añadirse. + + Si quiere añadir múltiples archivos a un proyecto, puede seleccionar el proyecto en la vista de Archivos y proyectos y pulsar con el botón derecho del ratón, y seleccionar Añadir archivos. Podrá entonces seleccionar sus archivos en un cuadro de diálogo. + + Puede también pulsar con el botón derecho del ratón en el nombre del proyecto en la vista de Archivos y proyectos, y seleccionar Añadir archivos... para mostrar el diálogo de selección de archivos. + + + Añadiendo un archivo a un proyecto + + + + + + Añadiendo un archivo a un proyecto + + Añadir un archivo a un proyecto + + + + Para eliminar un archivo de un proyecto, pulse con el botón derecho sobre él y seleccione Eliminar archivo. Esto no elimina su archivo, sólo lo quita de la lista de archivos contenida en el archivo .kilepr. + + + + + + Opciones del proyecto + + &kile; tiene algunas opciones relacionadas con su proyecto que pueden ser configuradas. Para cambiarlas, pulse con el botón derecho del ratón en el título de su proyecto y seleccione Opciones del proyecto, y tendrá la opción de cambiar: + + + El título de su proyecto. + El documento maestro. + La orden para compilación rápida. + Las opciones &makeidx;. + + + + + Guardar su proyecto en un archivo comprimido + + &kile; le permite guardar fácilmente su proyecto almacenando todos los archivos en uno único (habitualmente conocido como tarball). Para archivar un proyecto pulse con el botón derecho del ratón en el nombre del proyecto (en la vista de Archivos y proyectos), o seleccione ProyectoArchivar. + + De forma predeterminada, se añadirán todos los archivos de un proyecto. Si no quiere incluir alguno en el archivo, pulse en él con el botón derecho en la vista de Archivos y proyectos, y deseleccione la opción de Incluir en el archivo. + + Las órdenes de guardado son simples órdenes de línea de órdenes que son ejecutados desde la carpeta del proyecto (donde está guardado el archivo .kilepr). + + + + + + + + + + Cerrando un proyecto + + Para cerrar un proyecto, seleccione la vista de Archivos y proyectos de la barra de herramientas vertical, pulse con el botón derecho del ratón en el título del proyecto y seleccione Cerrar. Esto cerrará su proyecto y todos los archivos asociados con su proyecto y también añadirá el nombre del proyecto que acaba de cerrar a Abrir un proyecto reciente... en el menú Proyecto. + + + + + + + + Codificación del documento + + El editor de &kile; le permite leer, convertir y configurar el texto a la codificación que su documento necesite. Esto le permite utilizar símbolos y letras no estándares. Puede utilizar, por ejemplo, caracteres acentuados para el español, italiano o francés. Puede seleccionar la codificación de su documento de tres maneras: + + + Utilizar el menú desplegable Especificar codificación, localizado en la parte inferior de la vista de barra lateral Abrir archivo. + Otra forma es utilizar el submenú PreferenciasConfigurar Kile...Editor, donde podrá establecer la codificación de caracteres predeterminada para todos los archivos. + + Seleccionando la codificación de caracteres predeterminada + + + + + + Seleccionando la codificación de caracteres predeterminada + + + + + Configurar la opción cuando utiliza el asistente para crear un nuevo documento. + + + &latex; sólo entiende ASCII, un juego de caracteres muy limitado, con el que no podría utilizar caracteres especiales o acentuados directamente. Para emplear letras acentuadas, se ideó una sintaxis especial, como por ejemplo: \"e para ë. Hay un paquete para ayudarle con esto, llamado inputenc, que se incluye en el preámbulo mediante \usepackage[latin1]{inputenc}, donde el argumento opcional es la codificación que desearía emplear (utf8x en la mayoría de los casos). Esto le dice a &latex; que traduzca todas las ë que haya escrito a \"e antes de compilar. Consulte la documentación de inputenc para obtener más información sobre inputenc. Y por último pero no por ellos menos importante: ¡recuerde asegurarse de que su archivo está realmente codificado con la misma codificación que le especificó a inputenc! + + + Seleccionando la codificación del archivo fuente + + + + + + Seleccionando la codificación del archivo fuente + + Seleccionar la codificación del archivo fuente + + + + Esta mezcla de diferentes tablas de codificación de caracteres ha creado problemas en muchas aplicaciones: por ejemplo, no puede escribir un curso de turco en francés sin perder los caracteres especiales de uno de los idiomas. Hay una aceptación general de que, tarde o temprano, todo el mundo se cambiará a Unicode. Hay muchas implementaciones de Unicode, y UTF-8 es la más utilizada en Linux. Windows® en cambio se basa en la más incómoda y menos flexible UCS-2. Algunas distribuciones, como RedHat, han empezado a definir su codificación predeterminada como UTF-8, y por lo tanto usted podría estar muy interesado en utilizar utf8x como argumento para el paquete inputenc. + + + + El paquete &ucs; + Si no tiene instalado el paquete &ucs; puede proceder de la siguiente forma: + + Puede conseguir el paquete &ucs; de la página principal del soporte Unicode para &latex;, de Dominique Unruh de la Universidad de Karlsruhe. + + Para instalarlo, desempaquete el archivo descargado y colóquelo en un directorio listado en su variable de entorno $TEXINPUTS. También lo puede hacer dentro de kile. + + + + \usepackage{ucs} + \usepackage[utf8x]{inputenc} + + + + + + Soporte &cjk; + + Añadir soporte para idiomas ideográficos es un poco difícil. Sin embargo, una vez que lo haya conseguido, funcionará bastante bien. Instalar otros paquetes le permitirá trabajar con configuraciones extra. + + Su distribución Linux puede contener ya algún paquete de &cjk; (chino, japonés, coreano) preparado, y por tanto no vale la pena que lo instale de forma manual. ¡Compruébelo antes seguir adelante! + + Existe la posibilidad de utilizar el paquete &ucs; para escribir pequeños trozos de texto de &cjk;, pero esta opción está muy limitada y no podrá manejar, entre otras cosas, líneas nuevas. No obstante instalará el paquete completo &cjk;-&latex; y hará que funcione para ambos, para &latex; y para &pdflatex;. Gran parte de este material está inspirado en la página sobre como configurar &pdflatex; de Pai H. Chou. + + + + Descargue el paquete &cjk;. Copie los archivos desempaquetados a una subcarpeta apropiada de $TEXTMF, y haga lo mismo que en el caso del paquete &ucs; (Véa ). Los archivos serán desempaquetados en una carpeta CJK/X_Y.Z, aunque esto no es importante una vez que los haya desempaquetado, aunque probablemente sí sea importante para su mantenimiento. + + A continuación debe descargar un tipo de letra que soporte todos los caracteres de &cjk; que necesite. Puede elegir cualquier archivo *.ttf que necesite, aunque en este caso utilizaremos Cyberbit. Descomprima el archivo y renombre Cyberbit.ttf a cyberbit.ttf, puesto que las mayúsculas pueden confundir al sistema. + Coloque cyberbit.ttf en una carpeta con Unicode.sfd, y genere los archivos *.tfm y *.enc con la orden $ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@. Por alguna razón, algunas veces ésto no proporciona los cientos de archivos necesarios. Si este es su caso debería descargar los archivos *.tfm y *.enc. + Coloque los archivos *.tmf en una carpeta adecuada, como $TEXMF/fonts/tfm/bitstream/cyberbit/. Los archivos *.enc se instalarán en $TEXMF/pdftex/enc/cyberbit/. + + Ahora necesitamos un archivo de mapa para conectar los archivos *.enc con la fuente. Descargue cyberbit.map e instálelo en $TEXMF/pdftex/config/. + + Descargue otro archivo, c70cyberbit.fd, y colóquelo en la carpeta adecuado. Puede seleccionar, por ejemplo, $TEXMF/tex/misc/. + + El último archivo que debemos generar es un tipo de letra &postscript; de Tipo 1, necesaria para leer los archivos DVI generados con &latex;. Ejecute la orden $ ttf2pfb cyberbit.ttf -o cyberbit.pfb, y copie el resultado cyberbit.pfb en una carpeta, como por ejemplo, $TEXMF/fonts/type1/cyberbit/. + + Coloque ahora cyberbit.ttf en un lugar en el que &latex; pueda encontrar este tipo de letra. Puede colocarla, por ejemplo, en una carpeta llamado $TEXMF/fonts/truetype/. + + Verifique el archivo de configuración que se encuentra en $TEXMF/web2c/texmf.cnf, y asegúrese de que la línea que contiene TTFONTS esté descomentada y apunte a la carpeta en que haya guardado cyberbit.ttf. + + Para hacer posible que &pdflatex; utilice sus fuentes &cjk;, es necesario añadir la siguiente línea al archivo de configuración $TEXMF/pdftex/config/pdftex.cfg. Añada map +cyberbit.map al archivo para completar la configuración para &pdflatex;. + + Para configurar &latex; y poder generar archivos DVI con caracteres &cjk;, debe añadir una línea al archivo ttfonts.map. El archivo puede encontrarse en una carpeta llamada $TEXMF/ttf2pk/, aunque probablemente deba buscarlo. Añada la línea cyberbit@Unicode@ cyberbit.ttf en él. + + A continuación ejecute la orden texhash y el sistema debería estar listo. + + + + Para verificar si su configuración es correcta, puede intentar compilar este archivo de test. + + + Problemas con &cjk; + + Existen algunas cosas que pueden ir mal cuando se configura el soporte &cjk; de forma manual. Si algunas cosas parecen no funcionar, la siguiente lista puede ayudarle. + + + + Obviamente, si ejecuta &latex; como usuario y no como root, debe permitir a los usuarios normales acceder a los archivos nuevos. Asegúrese de que todos los archivos y carpetas están accesibles utilizando la orden chmod. + + Si &latex; escribe un DVI sin problemas, pero no puede verlo, es posible que existan problemas en la generación automática de las fuentes *.pk. Se supone que se generarán al vuelo cuando se esté viendo un archivo DVI, pero ésto puede fallar por una serie de razones: Verifique nuevamente ttfonts.map de la primera línea personalizada. Puede suceder que su orden ttf2pk, que suele ser llamada por el visor DVI se haya compilado sin soporte para las bibliotecas kpathsea. Si éste es su caso ttf2pk hará que no se creen referencias a kpathsea. Como el soporte para estas bibliotecas es necesario, debería encontrar un paquete nuevo, o recompilar FreeType 1 por si mismo. + + + + + + + + + ¿Cómo puedo hacer entradas &cjk; en Unicode? + + Existen diferentes motores de entrada, y escoger entre uno u otro dependerá de sus preferencias personales. El autor utiliza Skim, que se ha portado a &kde; a partir del motor Scim. Véa la documentación de su distribución para aprender cómo instalar estos programas. La configuración de estos programas puede ser complicado, en el caso de Skim debe definir la variable de entorno XMODIFIERS="@im=SCIM" antes de iniciar las X. + + + + + + + + + + Crear guiones + + + + Guiones en &kile; + + La funcionalidad de guiones para &kile; permite la ejecución de código ECMAScript. Los guiones se pueden administrar a través del panel de guiones de la barra lateral. + + + + + + Referencia del API + + En esta sección descibimos la interfaz de programación de guiones para &kile;. + + + Tenga en cuenta que el API de guiones todavía no se ha terminado. El API descrito a continuación puede cambiar en futuras versiones de &kile;. + + + En primer lugar, el entorno de ejecución de guiones de &kile; proporciona un objeto global llamado «kile», que contiene los siguientes métodos: + + + + (kile).currentTextDocument() + + Devuelve un objeto KileTextDocument que refleja el documento de texto activo actual. Devuelve null si no hay documento de texto activo. + + + + (kile).getInputValue(título, etiqueta) + + Abre un diálogo con el título y la etiqueta. Devuelve el valor que ha introducido el usuario. + + + + + Los objetos del tipo KileTextDocument representan los documentos de texto en &kile;. Tienen las siguientes propiedades: + + + + (KileTextDocument).backspace() + + Borra el caracter que se encuentra localizado inmediatamente antes de la posición del cursor actual y mueve el cursor una posición hacia atrás en el texto. + + + + (KileTextDocument).cursorLeft() + + Mueve el cursor una posición hacia atrás en el texto. + + + + (KileTextDocument).cursorRight() + + Mueve el cursor una posición hacia delante en el texto. + + + + (KileTextDocument).insertText(texto) + + Inserta el texto contenido en la variable texto en el documento en la ubicación actual del cursor. + + + + (KileTextDocument).insertBullet() + + Inserta una viñeta en la posición actual del cursor. + + + + (KileTextDocument).nextBullet() + + Selecciona la primera viñeta que haya en el documento inmediatamente después de la posición actual del cursor. + + + + (KileTextDocument).previousBullet() + + Selecciona la primera viñeta que haya en el documento inmediatamente antes de la posición actual del cursor. + + + + (KileTextDocument).up() + + Mueve el cursor una línea hacia arriba en el documento. + + + + (KileTextDocument).down() + + Mueve el cursor una línea hacia abajo en el documento. + + + + (KileTextDocument).cursorLine() + + Devuelve la línea en la que se encuentra el cursor. + + + + (KileTextDocument).cursorColumn() + + Devuelve la columna en la que está situado el cursor. + + + + (KileTextDocument).setCursorLine(línea) + + Mueve el cursor a la línea número línea. + + + + (KileTextDocument).setCursorColumn(columna) + + Mueve el cursor a la columna número columna. + + + + + + + + + + + Ayuda + + + + Documentos de ayuda + + &latex; es un sistema sofisticado, en el que las funcionalidades básicas se pueden expandir a través de una gran variedad de paquetes adicionales. &kile; proporciona mucha ayuda diferente para dar soporte al usuario. + + + + + Referencia de LaTeX + Un índice alfabético con la mayor parte de las órdenes comunes de &latex;. + + + + Documentación de TeX + &tetex;/&texlive; incluye una cantidad enorme de documentos. Esto incluye la documentación para todos los paquetes incluídos y una referencia adicional de &latex;. + + + + LaTeX + Una referencia completa para &tex; y compañía. No es solo una descripción de todos los programas, sino que también se mencionan algunos paquetes importantes. Incluye un manual de referencia completo de las órdenes— &latex; ideal para buscar un formato concreto mientras escribe un documento. Como este documento es realmente extenso, &kile; lo separa en tres importantes partes. + + + + Órdenes LaTeX + Otro índice alfabético de las órdenes más importantes de &latex;. + + + + Asunto LaTeX + Una descripción de los asuntos importantes de &latex;. + + + + Entorno LaTeX + Un índice alfabético de los entornos más importantes de &latex;. + + + + + + + + + Ayuda sensible al contexto + + &kile; también soporta ayuda sensible al contexto, que se llama con &Ctrl;&Alt;H,K. En PreferenciasConfigurar Kile... KileAyuda puede seleccionar si desea utilizar la referencia &latex; de &kile; o la ayuda del sistema de &tetex;/&texlive;, que es la configuración predeterminada. + + + Marcas + + + + + + Marcas + + + + + + + + + Buscando palabras clave + + No es siempre sencillo encontrar el documento correcto, ya que &tetex;/&texlive; incluye una cantidad enorme de documentos. Como posible ayuda, &tetex;/&texlive; proporciona un pequeño programa, texdoctk. Éste incorpora una base de datos con todos los documentos que &kile; utiliza para ofrecer un interfaz para ella. + + + Marcas + + + + + + Marcas + + + + + Todos los documentos se agrupan en varias categorías, y la principal ventaja es que puede buscar por nombres de paquete o por palabras clave. &kile; solo mostrará los resultados. + + + Marcas + + + + + + Marcas + + + + + Una doble pulsación del ratón o la tecla Espacio iniciará el visor para este documento. Este puede ser cualquier documento, no solo un documento DVI, PS, PDF o HTML. &kile; utilizará la configuración de &konqueror; para iniciar el visor adecuado. + + + + + + + Ayuda definida por el usuario + + Además de la documentación estática de &tetex;/&texlive; , &kile; soporta también otra vía para los documentos de ayuda del usuario. En el menú de Ayuda de &kile; se encuentra un submenú especial Ayuda de usuario, en el que el usuario puede añadir aquellos documentos que él mismo elija. Estos pueden ser más importantes que la documentación de &tetex;/&texlive; , e incluso documentos escritos por él mismo. Incluso es posible elegir algunos URL web. + + Vaya a PreferenciasConfigurar Kile... KileAyuda y seleccione el botón Configurar para configurar este menú de Ayuda de usuario. Podrá añadir, eliminar o navegar por las entradas del menú, así como insertar separadores para obtener una estructura mejor. + + Pulsando el botón Añadir se abrirá otro diálogo en el que podrá editar el nombre de la entrada de menú, y seleccionar el correspondiente archivo o &url; de la web. Si selecciona una &url; de la web, &konqueror; se iniciará de forma que pueda copiar la &url; final. + + + Marcas + + + + + + Marcas + + + + + + + + + + + Créditos y licencia + + &kile; es un programa de código abierto amigable para el usuario para editar código fuente &latex;. Se ejecutará en sistemas con el entorno de escritorio &kde; instalado. &kde; está disponible para diversas arquitecturas con Linux y otros sistemas emparentados con Unix. &kile; es también parte del proyecto Fink, lo que significa que puede ejecutar &kile; en un Mac con OS-X. + + Damos muchas gracias a aquellos que se esfuerzan en continuar el proyecto &kile;, y las muchas horas de contribución realizadas por aquellos que sacrifican su tiempo en desarrollar herramientas que todos podamos usar bajo la licencia GNU. La información sobre la actualización puede encontrarse en el diálogo Acerca de &kile; en el menú Ayuda. + + Colaboraciones importantes de: Rob Lensen, Roland Schulz, Michael Margraf, Holger Danielsson + + ¡Muchas gracias a todos aquellos implicados! +&underFDL; &underGPL; + + +&documentation.index; + + diff --git a/doc/es/psutils1.png b/doc/es/psutils1.png new file mode 100644 index 0000000..9fd015c Binary files /dev/null and b/doc/es/psutils1.png differ diff --git a/doc/es/psutils15.png b/doc/es/psutils15.png new file mode 100644 index 0000000..3ce1fd7 Binary files /dev/null and b/doc/es/psutils15.png differ diff --git a/doc/es/psutils16.png b/doc/es/psutils16.png new file mode 100644 index 0000000..a7c59bb Binary files /dev/null and b/doc/es/psutils16.png differ diff --git a/doc/es/psutils2.png b/doc/es/psutils2.png new file mode 100644 index 0000000..9a09321 Binary files /dev/null and b/doc/es/psutils2.png differ diff --git a/doc/es/psutils3.png b/doc/es/psutils3.png new file mode 100644 index 0000000..b738969 Binary files /dev/null and b/doc/es/psutils3.png differ diff --git a/doc/es/psutils5.png b/doc/es/psutils5.png new file mode 100644 index 0000000..9b31a89 Binary files /dev/null and b/doc/es/psutils5.png differ diff --git a/doc/es/psutils6.png b/doc/es/psutils6.png new file mode 100644 index 0000000..0ff695f Binary files /dev/null and b/doc/es/psutils6.png differ diff --git a/doc/es/psutils7.png b/doc/es/psutils7.png new file mode 100644 index 0000000..d8ba340 Binary files /dev/null and b/doc/es/psutils7.png differ diff --git a/doc/es/psutils8.png b/doc/es/psutils8.png new file mode 100644 index 0000000..a752a5c Binary files /dev/null and b/doc/es/psutils8.png differ diff --git a/doc/es/quickpreview.png b/doc/es/quickpreview.png new file mode 100644 index 0000000..548ac03 Binary files /dev/null and b/doc/es/quickpreview.png differ diff --git a/doc/es/select.png b/doc/es/select.png new file mode 100644 index 0000000..e9dbdb8 Binary files /dev/null and b/doc/es/select.png differ diff --git a/doc/es/snap_autocomplete.png b/doc/es/snap_autocomplete.png new file mode 100644 index 0000000..551bf3d Binary files /dev/null and b/doc/es/snap_autocomplete.png differ diff --git a/doc/es/snap_compile_error.png b/doc/es/snap_compile_error.png new file mode 100644 index 0000000..1c96ade Binary files /dev/null and b/doc/es/snap_compile_error.png differ diff --git a/doc/es/snap_editusertag.png b/doc/es/snap_editusertag.png new file mode 100644 index 0000000..79f3ba7 Binary files /dev/null and b/doc/es/snap_editusertag.png differ diff --git a/doc/es/snap_encoding.png b/doc/es/snap_encoding.png new file mode 100644 index 0000000..b7757b0 Binary files /dev/null and b/doc/es/snap_encoding.png differ diff --git a/doc/es/snap_kdvi_settings.png b/doc/es/snap_kdvi_settings.png new file mode 100644 index 0000000..0b86da1 Binary files /dev/null and b/doc/es/snap_kdvi_settings.png differ diff --git a/doc/es/snap_projectview.png b/doc/es/snap_projectview.png new file mode 100644 index 0000000..b6e5fe0 Binary files /dev/null and b/doc/es/snap_projectview.png differ diff --git a/doc/es/snap_projectview_add.png b/doc/es/snap_projectview_add.png new file mode 100644 index 0000000..4c16e0d Binary files /dev/null and b/doc/es/snap_projectview_add.png differ diff --git a/doc/es/snap_ref_choose.png b/doc/es/snap_ref_choose.png new file mode 100644 index 0000000..b715ef1 Binary files /dev/null and b/doc/es/snap_ref_choose.png differ diff --git a/doc/es/snap_ref_select.png b/doc/es/snap_ref_select.png new file mode 100644 index 0000000..93f0659 Binary files /dev/null and b/doc/es/snap_ref_select.png differ diff --git a/doc/es/snap_sidebarmenu.png b/doc/es/snap_sidebarmenu.png new file mode 100644 index 0000000..fd5b0a4 Binary files /dev/null and b/doc/es/snap_sidebarmenu.png differ diff --git a/doc/es/snap_structview_label.png b/doc/es/snap_structview_label.png new file mode 100644 index 0000000..654a4c0 Binary files /dev/null and b/doc/es/snap_structview_label.png differ diff --git a/doc/es/snap_usertag.png b/doc/es/snap_usertag.png new file mode 100644 index 0000000..b7103c4 Binary files /dev/null and b/doc/es/snap_usertag.png differ diff --git a/doc/es/texgroup.png b/doc/es/texgroup.png new file mode 100644 index 0000000..95e15bb Binary files /dev/null and b/doc/es/texgroup.png differ diff --git a/doc/et/Makefile.am b/doc/et/Makefile.am new file mode 100644 index 0000000..0548248 --- /dev/null +++ b/doc/et/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = et +KDE_DOCS=kile diff --git a/doc/et/index.docbook b/doc/et/index.docbook new file mode 100644 index 0000000..a677f38 --- /dev/null +++ b/doc/et/index.docbook @@ -0,0 +1,6056 @@ + +Kile"> + ATEX"> + ATEX"> + EX"> + teTEX"> + TeX Live"> + EX"> + + EX"> + + + ImageMagick"> + KDE"> + KDVI"> + dvipng"> + KGhostView"> + KPDF"> + PostScript"> + makeidx"> + Kate"> + CJK"> + ucs"> + URL"> + + + + +]> + + + + +&kile; käsiraamat + + + JonathanPechta + FedericoZenith
zenith@chemeng.ntnu.no
 + HolgerDanielsson
holger.danielsson@versanet.de
 + ThomasBraun + MichelLudwig
michel.ludwig@kdemail.net
 + + +MarekLaane
bald@starman.ee
Tõlge eesti keelde + + +2003 +Jonathan Pechta + + + +200320052006 +Federico Zenith + + + +20052006 +Holger Danielsson + + + +2007 +Thomas Braun + + + +2007 +Michel Ludwig + + +November 19, 2007 +2.0 + + +&FDLNotice; + + + +&kile; on &tex;i ja &latex;i lähtetekstide redaktor ning shell. + + + +KDE +kdenonbeta +Kile +LaTeX +TeX + + + + + + +Eessõna + + + + Nõuded + + &kile; kasutamiseks peavad sinu süsteemi olema paigaldatud järgmised komponendid: + + + K töölaua keskkond (&kde;): &kde; on populaarne vaba tarkvara töölaua keskkond. + Qt: Qt on &kile; kompileerimiseks vajalik C++ GUI ja võrguteek. + &latex;: kvaliteetne dokumendi ladumissüsteem. Usutavasti on sul kasutusel &texlive; (või vanemates süsteemides &tetex;) , sest tegemist on ju UNIXilaadse süsteemiga. + + + Enamik loetletuist võivad olla kaasas sinu Linuxi distributsiooniga. Nende paigaldamiseks arvutisse uuri oma distributsiooni dokumentatsiooni või vaata üle paigaldus-CD või -DVD. + + &kile; projekt pakub mitmeid erinevaid &kile; pakette, mida võib hõlpsasti paigaldada ja tööle panna ka ilma kompileerimata. Vaata täpsemalt &kile; koduleheküljelt. + + + + + + Eeldatav kasutajaskond + + See käsiraamat on mõeldud kõigile sõltumata nende kogemustest &latex;i, &kde;, &kile; või Linuxiga. + + Edasijõudnumad kasutajad vaevalt käsiraamatut loevad, küll aga sooviks meie saada nende ettepanekuid dokumentatsiooni parandamise kohta. Kui soovid anda omapoolse panuse projekti või dokumentatsiooni, uuri palun veidi &kile; veebilehekülge. + + Kas sul tekkis &kile; kohta mingeid küsimusi? Või probleeme kompileerimisel? Või soovid näha mõnda uut võimalust? Kõige mõttekam on tehnilist laadi küsimusi esitada või diskussiooni alustada meie meililistis kile-devel@lists.sourceforge.net. + + + + + + + + Sissejuhatus + + + + Põhiasjad + + + + Mis on &kile;? + + &kile; on integreeritud &latex;i keskkond &kde; töölaua tarbeks. &kile; pakub kõiki &latex;i funktsioone graafilises liideses, võimaldades hõlpsat, vahetut ja kohandatavat ligipääsu kõigile &latex;i kompileerimise, järeltöötluse, silumise, teisendamise ja vaatamise vahenditele. Samuti võimaldab see kasutada käepäraseid nõustajaid, &latex;i viiteid ning võimsat projektihaldust. + + + + + + Mis on &latex;? + + &latex; on tekstitöötlussüsteem, mille aluseks on juba 1977. aastal Donald Knuthi loodud programm &tex;, mis püüdis abistada autoreid enda töö professionaalsel esitamisel ladumissüsteemi pakkudes. Ladumissüsteem on professionaalne tekstitöötlemisvahend, mis esitab dokumendi välimuse vastavalt dokumenditüübi spetsifikatsioonile. &latex;i looja Leslie Lamporti eesmärk oli pakkuda autoritele automaatset ladumissüsteemi, mis oleks eriti abiks siis, kui tegemist on töömahuka matemaatiliste valemite ja ja muu sellise kirjapanemisega, mida mitte mingil juhul ei asetata &latex;is dollarimärkide vahele. Tänapäeval pakuvad selliseid võimalusi igale kasutajale paljud tekstitöötlusrakendused, kuid seniajani soovivad paljud, et dokument näeks hea välja, ei soovi aga kulutada tunde sellise väljanägemise kujundamisele. &latex; võtabki selle koorma sinu õlult ning lubab pühendada kogu tähelepanu dokumendi sisule, mitte välimusele. Ja muidugi näebki tulemus hea välja! + + + + + + Kuidas seda hääldada ja miks selle kirjapilt nii imelik on? + + &tex;-iga seotud pakettidel on naljakas komme kasutada kõige veidramat hääldust ja väljanägemist, mida vähegi võib ette kujutada. &tex; tulenevat kreekakeelsest täheühendist τεχ, mis ladina tähtedega näeb välja tech. Selle põhjuste kohta on arvukalt erinevaid seletusi, kuid tõenäoline põhjus on sellest, et &latex; oli algselt mõeldud tehniliste aruannete kirjapanemiseks ning seniajani ongi selle silmatorkavaim omadus matemaatiliste valemite äärmiselt korrektne ja ülilihtne kirjapanek, mis omal ajal nõudis väga palju aega, vaeva ja närvikulu. + Hääldus peaks olema selline: T nagu ikka, E täpselt samuti nagu e ikka ja X kreekapäraselt tugevana, umbes hh. Kui veel täpsem olla, siis see hh on suhteliselt kurguhäälne. Selle IPA sümbol on /ç/. Mõned on pakkunud häälduseks pehmema hh (IPA sümbol /x/), kuid ma pärisin seda mõne kreeklase käest ja nemad kinnitasid, et esimene variant on õige. Aga igatahes ütlevad paljud ka /teks/ või /tek/. + Ja lõpuks tasuks märkida, et &latex;is hääldatakse alguses olevad LA nagu inglise sõnas lay (umbes 'lei'). Seda sellepärast, et kui puhas &tex; on üsna keeruline kasutada, siis isegi lihtinimene (inglise keeles layman) suudab toime tulla &latex;i makrodega. Natuke lihtsam, aga samas usutavam seletus seob need tähed &latex;i looja Leslie Lamporti perekonnanime esitähtedega. Vaat nii! + + + + + + + + &latex;i põhitõed + + &latex;i ladumissüsteem sarnaneb muudele märkekeeltele, näiteks XML, mida tarvitatakse paljudes dokumenditüüpides (ka selles, mida sa parajasti loed), või veebilehekülgedel pruugitav HTML. Põhimõte on kasutada spetsiaalselt vormindatud võtmesõnu ehk silte, mis annavad rakendusele (tekstitöötlusrakendus, veebilehitseja või &latex;i kompilaator) teada, kuidas teksti esitada. &kile; pakub arvukalt silte menüüribalt leitava menüü LaTeX vahendusel. + + Kuigi me püüame sulle võimalikult hästi &latex;it tutvustada, ei ole see kindlasti mitte &latex;i piibel. Kui soovid &latex;it paremini tundma õppida, võiksid pöörduda paremini varustatud raamatukogu poole. Selle käsiraamatu autorile on jätnud väga hea mulle H. Kopka ja P. W. Daley kirjutatud 'A Guide to &latex;', mis on mul seniajani raamaturiiulis. + + Sarnaselt muudele märkekeeltele sisaldab &latex; preambulat, mis määrab ära globaalsed käsud, näiteks paberi suuruse, lehekülgede nummerdamise, teksti mõõtmed leheküljel, ning sisu, mis sisaldab dokumendi teksti. Preambula sisaldab minimaalselt käsku \documentclass ning eelneb sisule, mis algab käsuga \begin{document} ja lõpeb ootuspäraselt käsuga \end{document}. + + + + + + &kile; põhiomadused + + + + Kiirkäivituse nõustaja + + &kile; pakutav nõustaja võimaldab väga hõlpsasti alustada dokumentide loomist &kile;s. Kui valid menüüribalt nõustaja, saad valida mitme dokumendi loomise võimaluse vahel. Samuti saab kohe määrata mõningad dokumenti puudutavad omadused. + + Klassi valikud: + + + Dokumendiklass: millist dokumenti soovid luua? On see artikkel, kiri, aruanne, raamat? + Kirjatüübi suurus: millises punktis kirja peaks &kile; kasutama? + Paberi suurus: millises suuruses või stiilis paberit sinu dokumendi jaoks kasutada? + Kodeering: üldiselt on mõttekas kasutada süsteemi standardset kodeeringut. Nüüdissüsteemides on selleks kõige sagedamini UTF-8. Kui see on nii ka sinu süsteemis, kasuta utf8x (just sel kujul kasutatakse seda &latex;i dokumentides). + Muud valikud: siin saab määrata muid trükkimise ja muu sellisega seonduvaid asju. + + + Paketid + Siin on ära toodud levinumad &latex;is kasutatavad lisapaketid. Märgi kastike kõigi juures, mida soovid kasutada. + + Dokumendi omadused + + Autor: siia läheb tõenäoliselt sinu enda nimi. + Pealkiri: sinu dokumendi pealkiri. + Kuupäev: siin saab määrata kuupäeva. + + + + + + + Eelnevalt määratud mallid + + &kile; kasutab järgmisi eelnevalt määratud malle: + + + Tühi dokument: ässad alustavad kõike nullist! + Artikkel: määratleb artikli vormingu, mis on piisavalt lühike, et sda ei pea jagama peatükkideks. + Aruanne: määratleb aruande vormingu keskmise pikkusega dokumentide jaoks, kus lehekülje numbrid asuvad reeglina välisserval. + Raamat: määratleb raamatu vormingu, mis pakub kõiki võimalusi, isegi sel määral, et selle abil kirjutatakse seniajani paljusid ülikooliõpikuid. + Kiri: määratleb kirja vormingu, mis tekitab automaatselt need neetud taandused, mida muidu ei ole kunagi meeles jälgida. + Beamer, HA-Prosper: võimaldab luua kena esitluse PDF-vormingus, mis näeb väga hea välja ja mõistagi kasutab kõiki &latex;i võimalusi. + Scrartcl, Scrbook, Scrreprt, Scrlttr2: KOMA-skripti dokumendiklassid, mis on spetsiaalselt kohandatud saksa keelele. Neid tasuks kasutada eriti siis, kui kirjutad saksakeelset teksti. + + + Uutel kasutajatel ei pruugi muretseda: siin kirjeldame omadusi väga lühidalt, pikemalt kirjeldab kõiki ülesannete teostamise võimalusi edaspidi . + + + + + + Süntaksi esiletõstmine + + &kile; sarnaneb muudele lähtekoodi redigeerimisega tegelevatele rakendustele, pakkudes võimalust tõsta automaatselt esile käsud, võtmed ning muud vajalikud elemendid. Nii võimaldab &kile; kiiresti tuvastada probleemsed alad: kui näiteks märkad, et mingi suurem tekstiosa on rohelist värvi, on usutav, et unustasid kuskil matemaatikakeskkonna sulgemata. Küllaps oleksid nagunii märganud, kui jube väljundfail välja näeb, aga esiletõstmine säästab märgatavalt sinu aega. + + + + + + Keskkonna automaatne lõpetamine + + &kile; pakub võimalust keskkond automaatselt lõpetada: see tähendab, et kui alustad keskkonda, kirjutades \begin{environment}, lisab &kile; automaatselt käsu \end{environment}, jättes vahele rea sinu teksti tarbeks. Selle võimaluse võib muidugi soovi korral ka välja lülitada (Seadistused Kile seadistamine...LaTeXKeskkonnad). + + + + + + Hüppamine struktuurielementidele + + Kõik dokumendid struktureeritakse tavapäraselt teatud hierarhiasse. &latex; lubab dokumendi jaotamisel kasutada järgmist hierarhiat (kus osa on hierarhias suurim ja alamlõik väikseim jaotis) + + + \osa + \peatükk + \sektsioon + \alamsektsioon + \alamalamsektsioon + \lõik + \alamlõik + + + Dokumenti struktuurivaates vaadates võib elementide vahel liikuda klõpsuga elemendile, mida soovid vaadata. + + + + + + Pöördotsing + + Oma &latex;-faili luues võib pöördotsing päris kasuks tulla. Kui oled loonud DVI-faili (seadmest sõltumatu fail), hüppab &kile; juhul, kui klõpsad DVI näitamise rakenduses hiire keskmise nupuga, vastavale reale &latex;i lähtetekstis. + + DVI (DeVice Independent file) definitsioon: DVI on failitüüp, mis sisaldab vormindatud dokumendi kirjeldust koos muu vajaliku infoga, näiteks kasutatud font. See on tavapärane &tex;/&latex;i väljund. DVI-failide vaatamiseks ja trükkimiseks mitmesugustes süsteemides ja seadmetel on olemas päris palju vahendeid. + + + + + + Edasiotsing + + Pöördotsingut kasutades seostatakse DVI-failis valitud elemendid redaktoriga, nii et kui klõpsata DVI-failis, hüpatakse vastavale kohale &latex;i lähtetekstis. Edasiotsing on täpselt vastupidine: võimaldab klõpsata mingil tekstiosal &latex; lähtetekstis, misjärel hüpatakse sellega seotud tekstosale DVI näitamise aknas. + + + + + + + + Tööriistariba + + + Uus: avab uue dokumendi. + Ava: avab uue dokumendi. + Sulge: sulgeb dokumendi. + Defineeri dokument 'peadokumendina': seda kasutatakse mitme failiga töötades. Peadokument võimaldab kaasata dokumenti muid .tex-faile. Kui kasutad projekte, saad Projekt->Projekti valikud abil määrata ka projekti peadokumendi. + Kiire ehitamine: kompileerib &latex;i lähteteksti ja näitab tulemust automaatselt, kui tekstis ei ole just vigu. + Faili jälgimise režiim: selles režiimis "jälgitakse" DVI-failis tehtavaid muudatusi ning uuendatakse faili automaatselt pärast kiire ehitamise kasutamist ilma &kdvi;d uuesti käivitamata. + Vaata logifaili: näitab .log-faili, mis lubab vaadata vigu. + Eelmine viga: hüppab .log-failis tagasi ja tõstab esile lähtetekstis oleva vea. + Järgmine viga: hüppab .log-failis edasi ja tõstab esile lähtetekstis oleva vea. + Stopp: peatab parajasti täidetava toimingu. + LaTeX: käivitab &latex;i aktiivse dokumendiga. + DVI vaatamine: käivitab DVI näitaja. + DVI->PS: teisendab DVI-faili &postscript; (PS) failiks. + PS vaatamine: käivitab &postscript; (PS) näitaja. + PDFLaTeX: käivitab &pdflatex;i aktiivse dokumendiga. + PDF-i vaatamine: käivitab PDF-i näitaja. + DVI->PDF: teisendab DVI PDF-iks. + PS->PDF: teisendab PS-i PDF-ks. + HTML vaatamine: näitab loodud HTML-teksti. + Kdvi edasiotsing: hüppab leheküljele, mis vastab redaktoris parajasti aktiivsele reale. + + + Kui vaatad redigeerimisriba, näed kolme laia hüpikmenüüd. Need võimaldavad kiiresti lisada dokumenti enamkasutatavaid omadusi. Esimest neist kasutatakse dokumendi kiireks struktureerimiseks osadeks, peatükkideks, lõikudeks jne. Saadaolevad käsud jaotiste lisamiseks &latex;i lähteteksti on järgmised: + + + osa: dokumendi struktuuri kõrgeim tasand. + peatükk: loob uue peatüki. + sektsioon: loob uue sektsiooni. + alamsektsioon: loob uue alamsektsiooni. + alamalamsektsioon: sekundaarne jaotis alamsektsiooni ja lõigu vahel. + lõik: loob uue lõigu. + alamlõik: loob uue alamlõigu. + + + Hüpikmenüü kirjaga pealdis lubab dokumenti sisestada mitmesuguseid elemente, näiteks indekseid, allmärkusi, viiteid. Kasutada saab järgmisi käske: + + + pealdis: käsk, mis tekitab antud tasandile pealdise. + indeks: loob indeksikirje. + allmärkus: loob dokumenti allmärkuse. + viide: kasutatakse viitamiseks eelnevalt määratud pealdisele, mille saab valida hüpikmenüüst. + leheküljeviide: nagu viide, ainult et viitab struktuurielemendi asemel leheküljele. + tsitaat: loob dokumendis bibliograafia põhjal tsitaadi. + tsitaat ViewBibist: ViewBibi tööriistal palutakse lisada kõik valitud viited. Praegu on see kasutatav ainult ViewBibi tööriista &kbib; vahendusel. + + + + Pealdise hüpikmenüü + + + + + + Pealdise hüpikmenüü + + Pealdise hüpikmenüü + + + + + Pealdise valimine viitele + + + + + + Pealdise valimine viitele + + Pealdise valimine viitele + + + + Võimaluse tsitaat kasutamisel pakutakse hüpikmenüüna biblioelemente, aga kui sul on kasutusel &bibtex;, siis toimib see ainult juhul, kui fail kuulub projekti. &bibtex;-failide redigeerimiseks on soovitatav kasutada spetsiaalseid redaktoreid. Autoril on head kogemused rakendustega &kbibtex; ja &kbib;. Samuti võib kirjutada &bibtex;-faile käsitsi. + + Viimane hüpikmenüü kirjaga tilluke võimaldab määrata teksti suuruse. Võimalik on määrata teksti, allmärkuste jne. suurust. Kasutada saab järgmisi käske: + + + tilluke: kõige väiksem. + skript: väga väike. + allmärkus: väiksem. + väike: väike. + normaalne: normaalne. + suur: suur. + Suur: suurem. + SUUR: veel suurem. + hiiglaslik: veelgi suurem. + Hiiglaslik: kõige suurem. + + + + + + + + Kiirülevaade + + + + &latex;i dokumendi kirjutamine &kile;s algajatele + + Igal &kile; kasutajal on uut dokumenti alustades kaks võimalust: ta võib selleks kasutada nõustajat, valides loodava dokumendi tüübi ning muud valikud, näiteks fondi suuruse, paberi suuruse jne., või siis alustada kõige kirjutamist käsitsi. + + + \documentclass[12pt]{article} + \begin{document} + Siia tuleb LaTeXi lähtetekst. + \end{document} + + Iga &latex;i dokument algab käsuga \documentclass[lisaargument]{klass}, kus klass määrab ära dokunmenditüübi. + + Ülaltoodud koodinäite kirjutamisel saadakse selline väljund: + + + Kompileeritud tekst DVI väljundis + + + + + + Kompileeritud tekst DVI väljundis + + Kompileeritud tekst DVI väljundis + + + + Nurksulud pärast käsku \documentclass tähistavad kasutatavat võtit. Võti [12pt] määrab artikli fondi suuruse. Kui fondi suurust ei määrata alguses, võib seda teha ka tekstis hiljem. + + Kui oled toodud näite kirja pannud, tuleb &latex;i lähtetekst ka kompileerida. Lihtsaim viis &latex;i lähteteksti kompileerida on kasutada ehitamisemenüüd või kiire ehitamise nuppu. + + Lähteteksti saab kompileerida ka kiirklahviga &Alt;2. + + Lähtetekst tuleb enne kompileerimist salvestada. &kile; teeb selle sinu eest automaatselt ära. + + Kui dokumendi kompileerimine ei õnnestu, uuri logifaile, kus võib leida vead. Kiire ehitamise nuppu kasutades peaks &kdvi; automaatselt käivituma. Kui seda ei juhtu, uuri logifailist, mis viga. + + + + + Keskkonnad + + Keskkond on käsk, mis võimaldab teatud tekstiosa käsitleda ülejäänud dokumendist erinevalt. Oletame näiteks, et lood raportit fondi suurusega 12, kuid mõne lause jaoks vajad erinevat fondi suurust. Käsud \begin{environment}, \huge ja \end{environment} lubavad muuta teksti keskkonnakäskude vahel hiiglaslikuks. + + Seega rakenduvad muudatused ainult käskude \begin{environment} ja \end{environment} vahel. Keskkonna sees võib teha kui palju tahes muudatusi. + + Dokumendi loetavamaks ja kasutajasõbralikumaks muutmiseks on päris palju võimalusi. Dokumendile võib lisada näiteks spetsiaalseid fonte, rasvast või kaldkirja, allajoonitud teksti jne. Kõik need lõpevad kas käsuga \end või keskkonna lõppedes. + + + \begin{emph}: paneb teksti kaldkirja ja kehtib seni, kuni esineb \begin{emph} või algab teine keskkond. Lauses ühe sõna panemiseks kaldkirja kasuta süntaksit: see on \em{minu} lause. + \textbf{Ma panen selle teksti sulgudes rasvasesse kirja}: muudab teksti rasvaseks. + \quote: tekitab dokumendis jutumärkides osa, mis algab käsuga \begin{quote} ja lõpeb käsuga \end{quote}. + \center: tsentreerib teksti. + \verse: loob luuletustele vajaliku keskkonna. + \itemize: tekitab loendi. + + + + + + + &kile; kasutamine + + Nüüd, kus oleme andnud põgusa ülevaate, kuidas kirjutada teksti &latex;i märkekeeles, näitame samm-sammult, kuidas luua &kile;s dokument. + + + Käivita &kile; + Vali NõustajaKiirstart, seejärel vali vorming ja määra nõustajas oma eelistused. + Kui nõustaja on teksti sisestanud, kohanda dokument loetavamaks, lisa vähemalt üks tsitaat, üks rasvases ja üks kaldkirjas osa ning luuleosa, et näha, mille poolest ja kuidas käsud erinevad. + Salvesta fail ja anna sellele nimeks intro.tex. + Ehita dokument kiirklahviga &Alt;2 või klõpsuga nupul LaTeX. + Vali DVI vaatamine. + Kontrolli põhjalikult oma teksti. + Kui oled lõpetanud, klõpsa redaktorisse naasmiseks nupule Redaktorivaade või vajuta kiirklahvi &Ctrl;e, kui kasutad põimitud redaktorit, või sulge vaatamisrakenduse aken. + + + Ongi kõik! Oledki valmis saanud oma esimese &latex;i dokumendi! + + Kui oled DVI loonud, võid oma dokumendi trükkida või teisendada soovi korral &postscript; või PDF-failiks. Proovi ja katseta! + + + + + + DVI failid + + DVI tähendab seadmest sõltumatu (inglise keeles 'DeVice Independent') fail. Neid loob &tex; või &latex;, et teksti oleks arvutil lihtsam näidata. .dvi-faili võib suunata mitmesugustele väljunditele, näiteks printerile, &postscript; või PDF konverterisse või arvutiekraanile. + + + + DVI vaatamine + + Seda, kuidas DVI-faili ekraanil vaadata, sa juba tead: kasuta selleks tööriistariba nuppu DVI vaatamine. + + + + + + DVI trükkimine + + DVI trükkimiseks saab kasutada sama meetodit, millega dokument luuakse (vaata ). Pärast 7. sammu, kui oled klõpsanud DVI vaatamine, vali vaatajas FailTrüki ning kui printer on korrektselt seadistatud, DVI trükitaksegi. + + + + + + DVI teisendamine + + Tööriistariba võimaldab eksportida DVI mitmesse vormingusse. Kui &latex;i lähtetekstist on loodud DVI, peaks olema seda võimalik tööriistariba nuppude abil eksportida just sulle meelepärasesse vormingusse. + + + + + + + + Edasiotsing &kile; ja &kdvi; vahel + + Edasiotsing võimaldab redaktorist hüpata otse vastavasse asukohta &DVI; failis. + &kile; võimaldab seda kasutada kõigi &latex;i binaarfailidega. Ava SeadistusedKile seadistamine... TööriistadEhitamine ja vali seadistus Modernne. + + Edasiotsing võimaldab klõpsata mingile tekstiosale lähtetekstis ning hüpata käsuga Kdvi edasiotsing vastavale asukohale DVI näitaja aknas. + + + + + Pöördotsing &kile; ja &kdvi; vahel + + Pöördotsing on väga kasulik võimalus, kui kirjutad ise &latex;i dokumenti. Kui kõik on korrektselt seadistatud, võid klõpsata &kdvi; aknas &HKNga; (mõnes süsteemis saab juhul, kui hiirel ei ole kolme nuppu, selle asemel vajutada korraga hiire vasakut ja paremat nuppu). Kile laadib seejärel &latex; lähtefaili ja hüppab õigele lõigule. Pöördotsingu kasutamiseks tuleb &latex;i fail kompileerida seadistusega Modernne. + + Pöördotsing toimib, kui: + + + Lähteteksti fail on edukalt kompileeritud. + &kdvi; teab, millist redaktorit kasutada. + + + See &kdvi; võimalus lubab hiire keskmise nupu klõpsuga DVI dokumendis avada &kile;s vastava &latex;i dokumendi ja hea õnne korral vastavale reale minna. Pea meeles, et sul tuleb anda &kdvi;le korraldus kasutada tekstiredaktorina &kile;t (&kdvi; menüükäsk SeadistusedDVI valikud...). + + + &kdvi; seadistamine + + + + + + &kdvi; seadistamine + + &kdvi; seadistamine + + + + + + + Vigade lahendamine + + Kui kasutasid kiiret ehitamist ning DVI vaataja ei avanenud, on tõenäoline, et tegemist on mingi veaga. Sellisel juhul võib viga näha logifaili/teate alal, kus näidatakse vea kokkuvõtlikku kirjeldust. + + Logifail selgitab, millise veaga lähtetekstis on tegemist. Redaktoris saab kasutada tööriistaribal olevaid nuppe Eelmine LaTeXi viga ja Järgmine LaTeXi viga vigade vahel liikumiseks. Logifail annab alati teada, millisel real viga esines. Kui soovid seda rida näha, klõpsa logiaknas veal ning &kile; viib sind vastavat viga sisaldavale reale. + + + + + + + Uue dokumendi loomine + + Kui klõpsad tööriistaribal uue dokumendi loomise nupule, ilmub dialoog, mis pärib, millist mallitüüpi soovid dokumendi jaoks kasutada. Võimalused on vaikimisi järgmised: + + + Tühi dokument + Artikkel + Beamer + Raamat + HA-Prosper + Kiri + Aruanne + Scrartcl (KOMA-Scripti paketist) + Scrbook (KOMA-Scripti paketist) + Scrlttr2 (KOMA-Scripti paketist) + Scrreprt (KOMA-Scripti paketist) + + + Kui valid tühja dokumendi, võid alustada dokumendi loomist päris tühjalt kohalt või kasutada nõustajat uue dokumendi kiireks tekitamiseks (vaata ). + + + + + Mallid + + &latex;i sagedasemad kasutajad tarvitavad tihtipeale peaaegu igal dokumendil üht ja sama preambulat, mille on hoolsalt just enda maitsele kohandanud. Selleks ongi olemas mallid: iga pidevalt sarnaseid dokumente loov &kile; kasutaja võidab kahtlemata võimalusest luua just enda maitsele vastavaid malle. + + + + Uue malli loomine + + Uue malli loomiseks tuleb esmalt avada &tex;/&latex;-fail või luua uus fail. &kile; võib malli luua olemasoleva dokumendi põhjal, kui avad soovitud dokumendi ja kasutad menüükäsku Fail Loo dokumendi põhjal mall. + + + + + + Kohatäitjate kasutamine + + Kui lood uue dokumendi malli põhjal käsuga FailUus, võidakse teatud sümbolite kombinatsioonid asendada mõningate andmetega, näiteks sinu nime või kasutatava kodeeringuga. Nende muutujate seadistamiseks kasuta menüükäsku SeadistusedKile seadistamine. + + Kui lood malli omal käel, on kasulik teada, millised sümbolite kombinatsioonid milliseid mallimuutujaid tähistavad: + + + $$AUTHOR$$: asendatakse autorimuutujaga. + $$DOCUMENTCLASSOPTIONS$$: asendatakse dokumendiklassi võtme muutujaga. Tavaliselt kasutatakse seda umbes nii: \documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}. + $$INPUTENCODING$$: kui sisendi kodeeringu muutuja väärtuseks on näiteks latin1, asendatakse string \input[latin1]{inputenc}. + + + + + + + Malli loomine nõustajas + + Lihtsaim viis uut malli luua on käivitada nõustaja ning seejärel anda vajalikud käsud paremal redaktoris. Kui dokument on võtnud sulle meelepärase kuju: + + + Salvesta fail + Ava menüü Fail + Vali Loo dokumendi põhjal mall + Vajadusel muuda veel malli + Sisesta oma uue malli nimi + Klõpsa OK malli lisamiseks menüüsse + + + Kui nüüd lood uue dokumendi, võid tavapärasteemallide kõrval valida ka omaloodud malli. + + + + + + Malli loomine mis tahes faili põhjal + + Malli võib luua mis tahes faili põhjal. Kui püüad võimalikult vähese vaevaga läbi ajada, võid otsida vajalikku malli internetis ning siis võtta ette samad sammud, mida kirjeldab . + + Oletame, et soovid luua korralikku A0 posterit, mida kasutatakse tihtipeale teaduskonverentsidel. &latex; mõistagi aitab sul luua väga külgetõmbava ja köitva posteri. A0 posteri malli võid leida Jonathan Marchini koduleheküljelt, kuid neid on märksa enamgi. Pea meeles, et sul läheb vaja paketti a0poster, mida standardse TeXi tarkvaraga kaasas ei ole, nii et sul tuleb see siit alla laadida ja kopeerida &latex;i faili kataloogi. + + + + + Malli eemaldamine + + Malli eemaldamiseks &kile;st: + + + vali FailEemalda mall... + Ilmub kõiki malle näitav dialoog, kus vali mall + Klõpsa OK ja mall eemaldataksegi + + + Malle märkega * ei saa eemaldada, kui sul selleks õigusi pole + + + + + + + + + &latex; dokumentide redigeerimine + + &kile; seesmine redaktor kasutab ära &kate;t. Kate on programmeerijatele loodud tekstiredaktor, mis suudab lugeda ja kasutada esiletõstmist paljude tekstifailide tüüpide korral, sealhulgas &latex; ja &bibtex;. Suurt osa &kate; võimalustest saab kasutada otse &kile;s menüü Tööriistad vahendusel. + + &kate; ja selle võimaluste kohta annab rohkem teavet Kate käsiraamat. &kile; kasutajad võiksid ennekõike vaadata peatükki Töö Katega. + + + + &latex;i viited + + &kile; pakub väga praktilist ülevaadet &latex;i viidetest, mida saab kasutada menüükäsuga AbiLaTeXi viited. See sisaldab peaaegu kõigi &latex;is kasutatavate käskude põhjalikke selgitusi ning süntaksit. + + + + + + Kursori liikumine + + Kui soovid valida teksti, saab seda teha nii: + + + Hoia all hiire vasak nupp ja lohista hiirt teksti äramärkimiseks. + Klõpsa sõnal kursori liigutamiseks uuele alale. + Klõpsa sõnal kaks korda terve sõna valimiseks. + Kogu TeXi sõna valimiseks tee sõnal topeltklõps ja vajuta klahvi &Ctrl;. Sel moel näiteks teksti \par\bigskip osal \par klõpsates valitakse ainult \par. + Klõpsa kolm korda terve lause valimiseks. + + + Hiire vasakut nuppu all hoides ja valitavat teksti lohistades kopeeritakse valitud tekst automaatselt lõikepuhvrisse. + + Klahvi Shift all hoides ning nooleklahve kasutades saab redaktoriaknas valida vajaliku lähteteksti osa. + + + + + + Sulud + + Sulgude lõpetamine on üks visuaalseid vahendeid, mida kasutatakse redaktorivaates paremaks näitamiseks, millised sulud teineteisega kokku lähevad. Kui avad .tex-faili ja valid suvalise sulu, olgu see ümarsulg (), nurksulg [] või looksulg{}, tõstab redaktor esile nii selle kui tema paarilise kollase värviga (seda vaikevärvi saab mõistagi muuta). Kui asetad kursori näiteks looksulule käsus \section{Sissejuhatus}, näeb \section{Sissejuhatus} vaikimisi kollasena esiletõstetuna, näidates sulle sel moel alustavat ja lõpetavat looksulgu. + + + + + + Esiletõstmine + + &kile; suudab tuvastada ja esile tõsta erinevat tüüpi koodi. Nii on näiteks &latex;i käsud eristatud tavalisest tekstist, mis muudab tavalise teksti lugemise hõlpsamaks. Erineva värviga on tähistatud ka valemid. + + + + + + Täpid + + Paljud nõustajad võivad lisada täppe, omamoodi järjehoidjaid tekstis. Menüükäsud RedigeerimineTäpid või vastavad kiirklahvid võimaldavad hüpata järgmisele või viimasele täpile. Täpp ühtlasi valitakse, nii et kui kirjutad mõne sümboli, kustutatakse see automaatselt. + + + Täpid + + + + + + Täpid + + + + + + + &Ctrl;&Alt;Nool paremale Järgmine täpp + Hüppab tekstis järgmisele täpile, kui see on olemas. + + + &Ctrl;&Alt;Nool vasakule Viimane täpp + Hüppab tekstis eelmisele täpile, kui see on olemas. + + + + + + + + + Valimine + + Redigeerimine on mõistagi sellise rakenduse nagu &kile; kasutamise üks tähtsamaid pmadusi. Kuigi ka &kate; on väga võimekas redaktor, lisab &kile; mitmeid olulisi võimalusi, mida läheb eriti vaja &latex;i lähtekoodi kirjutamisel. &latex; vajab alati hulka keskkondi ja gruppe, mistõttu &kile; toetab nende valimise erikäske. Alammenüüs RedigeerimineValimine leiab järgmised teksti valimise käsud. + + + Redigeerimine->Elementide valimine + + + + + + Redigeerimine->Elementide valimine + + + + + + &Ctrl;&Alt;S E Keskkond (sisemine) + Valib keskkonna ilma ümbritsevate siltideta. + + + &Ctrl;&Alt;S F Keskkond (väline) + Valib keskkonna koos ümbritsevate siltidega. + + + &Ctrl;&Alt;S T TeXi grupp (sisemine) + Valib TeXi grupi ümbritsevate sulgude sees. + + + &Ctrl;&Alt;S U TeXi grupp (väline) + Valib eXi grupi koos ümbritsevate sulgudega. + + + &Ctrl;&Alt;S M Matemaatikagrupp + Valib aktiivse matemaatikagrupi koos matemaatikakäskudega. + + + &Ctrl;&Alt;S P Lõik + Valib kogu lõigu, &ie; tekstiridade grupi, mida eraldavad mõlemalt poolt tühjad read. Lõik ei tähenda lihtsalt järjestikusi tekstiridu, nagu teistes tekstiredaktorites. Lõik hõlmab ka tabeleid, &latex;i käske ja kõiki muid lähtekoodiridu. &kile; jaoks on oluline ainult see, et lõik oleks eraldatud kahe tühja reaga. + + + &Ctrl;&Alt;S L Rida + Valib tekstirea, kus paikneb kursor. + + + &Ctrl;&Alt;S W TeXi sõna + Valib kursori asukohas oleva sõna. Ka see valik on laiendatud tähendusega, sest selle käsuga saab valida ka &latex;i käske, mis algavad längkriipsuga ja millel võib lõpus olla tärn. + + + + + + + + + Kustutamine + + Dokumendi teatud osa kustutamiseks võib selle muidugi valida ja vajudata klahvile Delete. Kate pakub lisaks veel kiirklahvi &Ctrl;K, mis kustutab terve rea. Kuid &kile; pakub oma kustutamiskäskudega kiiremaidki võimalusi. Alammenüüs RedigeerimineKustutamine leiab järgmised teksti kustutamise käsud. + + + Redigeerimine->Elementide kustutamine + + + + + + Redigeerimine->Elementide kustutamine + + + + + + &Ctrl;&Alt;T E Keskkond (sisemine) + Kustutab keskkonna ilma ümbritsevate siltideta. + + + &Ctrl;&Alt;T F Keskkond (väline) + Kustutab keskkonna koos ümbritsevate siltidega. + + + &Ctrl;&Alt;T T TeXi grupp (sisemine) + Kustutab TeXi grupi ümbritsevate sulgude sees. + + + &Ctrl;&Alt;T U TeXi grupp (väline) + Kustutab TeXi grupi koos ümbritsevate sulgudega. + + + &Ctrl;&Alt;T M Matemaatikagrupp + Kustutab aktiivse matemaatikagrupi koos matemaatikakäskudega. + + + &Ctrl;&Alt;T P Lõik + Kustutab kogu lõigu. Vaata käsu ValimineLõik kirjeldusest, kuidas &kile; lõiku määratleb. + + + + &Ctrl;&Alt;T I Rea lõpuni + Kustutab teksti alates kursori asukohast rea lõpuni. + + + &Ctrl;&Alt;T W TeXi sõna + Kustutab sõna või &latex;i käsu kursori asukohas. + + + + + + + + + Keskkond + + Juba eespool mainiti, et keskkonnad on &latex;is keskse tähendusega. Seepärast pakub &kile; veel viit käsku &latex;i võimalikult lihtsaks käitlemiseks alammenüüs RedigeerimineKeskkond. + + + Redigeerimine->Keskkonna elemendid + + + + + + Redigeerimine->Keskkonna elemendid + + + + + + + &Ctrl;&Alt;E B Mine algusse + Selle käsuga hüpatakse aktiivse keskkonna algusse. Kursor asetatakse otse keskkonda alustava sildi ette. + + + &Ctrl;&Alt;E E Mine lõppu + Selle käsuga hüpatakse aktiivse keskkonna lõppu. Kursor asetatakse otse keskkonda lõpetava sildi järele. + + + &Ctrl;&Alt;E M Sobivus + Kui kursor asub sildi \begin{keskkond} ees või kohal, viiakse see keskkonna teise otsa ja vastupidi. + + + &Ctrl;&Alt;E C Sulge + Pesastatud keskkonnasiltide vahele teksti sisestades võib kaduda kontroll keskkondade üle. Selle käsuga suletakse viimati avatud keskkond, mis väldib keskkondade pesastatud struktuuri vigu. + + + &Ctrl;&Alt;E A Sulge kõik + Sulgeb kõik keskkonnad, mitte ainult viimatu avatud keskkonna. + + + + + + + + + &tex;i grupp + + &kile; pakub mõningaid erikäske ka &latex;i gruppidele, mida määravad sulud {...}. Alammenüüs RedigeerimineTeXi grupp leiab mitu olulist käsku, mis vastavad alammenüü RedigeerimineKeskkond omadele. + + + Redigeerimine->TeXi grupp + + + + + + Redigeerimine->TeXi grupp + + + + + + &Ctrl;&Alt;G B Mine algusse + Selle käsuga hüpatakse aktiivse grupi algusse. Kursor asetatakse otse gruppi alustava sulu ette. + + + &Ctrl;&Alt;G E Mine lõppu + Selle käsuga hüpatakse aktiivse grupi lõppu. Kursor asetatakse otse gruppi lõpetava sulu järele. + + + &Ctrl;&Alt;G M Sobivus + Kui kursor asub &tex;i gruppi alustava sulu ees või järel, viiakse see grupi lõppu ja vastupidi. + + + &Ctrl;&Alt;G C Sulge + Pesastatud grupisulgude kirjutamine võib üsna vaevaline olla. Selle käsuga suletakse viimati avatud grupp, mis väldib &tex;i gruppide pesastatud struktuuri vigu. + + + + + + + + + Topeltjutumärgid + + &latex; kasutab topeltjutumärkidena kaht ühekordset jutumärki. Nende tõhusaks lisamiseks võimaldab &kile; kaht ühekordset alustavat jutumärki lisada klahvile " vajutades. Kui soovid tsitaadi sulgeda, tuleb samuti vajutada ". &kile; on piisavalt nutikas, et sellest aru saada ja lisada &latex;ile kaks lõpetavat jutumärki. + + Otseste topeltjutumärkide saamiseks vajuta kaks korda ". + + Alustava ja lõpetava topeltjutumärgi automaatse lisamise saab välja lülitada sektsioonis SeadistusedKile seadistamine...LaTeX. + + + Topeltjutumärgid + + + + + + Topeltjutumärgid + + + + + Kui kaasad keelepõhised valikud või stiilifailid, näiteks ngerman või french, saad kasutada ka saksa või prantsuse topeltjutumärke. Saadaval on muidugi veel palju rohkem keeli. + + + + + + Nutikas reavahetus + + Kui vajutad klahve &Shift;Return, lisab &kile; nutika reavahetuse. Kui kursor asub parajasti nimekirjakeskkonnas (näiteks enumerate või itemize), ei lisa &kile; mitte ainult reavahetust, vaid ka käsu \item. + + Kui oled tabelikeskkonnas, lisab &kile; aktiivse rea lõppu \\ ja reavahetuse. + + Kui oled &latex;i kommentaaris, lisab &kile; järgmise rea algusse %. + + Kuid &kile; toetab isegi eelmääratud &latex;i ja kasutaja määratud keskkondi, mida saab lisada sektsioonis SeadistusedKile seadistamine...LaTeX. + + + + + + Nutikas tabulaator + + Mõnele kasutajale meeldib tabelikeskkonnas veerge korraldada ja seada kõik &-märgid üksteise alla. &kile; toetab seda. Kui vajutad &Shift;&Alt;&, otsib &kile; ülalolevas reas järgmist tabeldusmärki. Ehkki see ei pruugi muidugi olla just õige tabeldusmärk, lisab &kile; tühikuid, et sobitada veeru asukoht tabelduskohaga. + + + + + + + + Koodilõpetus + + Kuigi &kate; pakub juba päris häid lõpetamisvõimalusi, on &kile; laiendanud koodilõpetamist, et pakkuda mõningaid spetsiaalselt &latex;ile mõeldud võimalusi. Erinevaid režiime on kokku viis. Kolm neist aktiveeruvad nõudmisel, kaks on aga automaatse lõpetamise võimalused. Kõiki neid saab seadistada dialoogis SeadistusedKile seadistamine... + + + + Keskkonna automaatne lõpetamine + + Kui alustad uut keskkonda näiteks käsuga \begin{keskkond}, lisab &kile; automaatselt käsu \end{keskkond}, jättes nende vahele rea, kuhu saad sisestada oma teksti. + + Automaatse lõpetamise saab välja lülitada dialoogi SeadistusedKile seadistamine... LaTeXKeskkonnad &latex;i sektsioonis. + + + Võrrandikeskkonna lõpetamine + + + + + + Võrrandikeskkonna lõpetamine + + Võrrandikeskkonna lõpetamine + + + + + + + + &latex;i käsud + + Mõned tähed kirjutanud, saab aktiveerida selle lõpetamistüübi &latex;i käskude ja tavaliste sõnade jaoks menüükäsuga RedigeerimineLõpetamine(La)TeXi käsk või kiirklahviga &Ctrl;Tühikuklahv. &kile; loeb kõigepealt tähed kursori asukohast vasakule ja peatub esimese mittetähe või längkriipsu juures. Kui alguses seisab längkriips, võtab &kile; kasutusele &tex;i või &latex;i käskude lõpetamise režiimi. Muul juhul võetakse kasutusele tavalise sõnaraamatu režiim, kust mõistagi &latex;i käske ei leia. Sõltuvalt režiimist avatakse lõpetamiskast. Seal näeb kõiki käske või sõnu, mis sobivad kirjutatud mustriga. Nimekirjas saab liikuda nooleklahvidega, vajalikule kirjele jõudes saab seda kasutada klahviga &Enter; või topeltklõpsuga. + + + LaTeXi käsu lõpetamine + + + + + + LaTeXi käsu lõpetamine + + + + + Kui vajutada klahvi &Backspace;, kustutatakse mustri viimane märk ja lõpetamisnimekiri võib pikeneda. Kui aga kirjutada veel üks märk, siis muster pikeneb ja pakutavade sõnade arv võib väheneda. + + Kui ükski pakkumine sulle ei meeldi, saad dialoogist väljuda klahviga &Esc;. + + Kastis on kõikidele käskudele lisatud nende parameetrite lühikirjeldus. Käsu valimisel neid loomulikult ei lisata. Soovi korral võib lasta &kile;l nende asemele täpid lisada, et saaksid neisse liikuda menüükäsuga RedigeerimineTäpidJärgmine täpp ja vajaliku parameetri sisestada. + + + LaTeXi käsu lõpetamine + + + + + + LaTeXi käsu lõpetamine + + + + + Nimekirjade seadistamiseks ava dialoog SeadistusedKile seadistamine... KileLõpetamine. Seal saab valida erinevaid sõnaloendeid &tex;i ja &latex;i käskude ning sõnaraamatuid tavaliste sõnade jaoks. + + + + + + Keskkonnad + + Käsurežiim ei ole keskkondade lõpetamisel kuigi palju kasuks. Siis tuleb alati kirjutada mõned \begin tähed ning lõpetamisrežiimi väljakutsumine annab tulemuseks tohutu keskkonnasiltide nimekirja. Samas kasutatakse keskkondi nii sageli, et &kile; pakub spetsiaalse režiimi keskkondade lõpetmiseks. Ära mõtle algussildi peale ja kirjuta näiteks eq. + + Lõpetamisrežiimi menüükäsuga RedigeerimineLõpetamineKeskkond või kiirklahviga &Alt;Tühikuklahv välja kutsudes lisatakse automaatselt alustav silt, nii et sisestatu võtab kuju \begin{eq}. Pärast seda on lõpetamisnimekiri palju vähemate võimalustega. + + + LaTeXi käsu lõpetamine + + + + + + LaTeXi käsu lõpetamine + + + + + Nüüd vali keskkond ja näed, et see ka suletakse automaatselt. Veelgi enam, kui &kile; peab seda nimekirjakeskkonnaks, lisatakse ka esimene \item silt. + + + LaTeXi käsu lõpetamine + + + + + + LaTeXi käsu lõpetamine + + + + + Nimekirjade seadistamiseks vali SeadistusedKile seadistamine... KileLõpetamine. See režiim kasutab samu sõnade nimekirju nagu &tex;i ja &latex;i käskude lõpetamisrežiim. + + + + + + Lühendid + + &kile; toetab kasutaja määratud lühendite nimekirju, mis asendatakse nõudmisel pikemate tekstistringidega. Nimekirjade seadistamiseks vali SeadistusedKile seadistamine... KileLõpetamine. Siin toodud näite puhul tuleb valida lühendite nimekiri example.cwl. Selles failis leidub näiteks kirje L=\LaTeX. + + See tähendab, et sa võid kirjutada ainult L. Seejärel kutsu välja sõnalõpetamisrežiim menüükäsuga RedigeerimineLõpetamineLühend või kiirklahviga &Ctrl;&Alt;Tühikuklahv ning täht L asendatakse stringiga LaTeX. + + + + + + Automaatse lõpetamise režiimid + + + + &latex;i käsud + + &latex;i käskude jaoks võib ka sisse lülitada automaatse lõpetamise. Kui kirjutad määratud arvu tähti (vaikimisi 3), ilmub hüpikaken, mis pakub kõiki sobivaid &latex;i käske. Võid nende seast valida vajaliku või neid eirata ja edasi kirjutada. Lõpetamiskastis leiduvad kirjed muutuvad vastavalt sellele, mida sa kirjutad. + + Selle režiimi sisse- või väljalülitamiseks või täheläve muutmiseks vali SeadistusedKile seadistamine... KileLõpetamine. + + + Võrrandikeskkonna lõpetamine + + + + + + Võrrandikeskkonna lõpetamine + + + + + + + + + Dokumendi sõnad + + Suured sõnaraamatud ei ole automaatse lõpetamise seisukohalt kuigi kasulikud. Aga mõnigi kord esineb teatud sõnu dokumendis palju kordi. Seepärast pakub &kile; võimalust lõpetada kõik sõnad, mis esinevad juba dokumendis. + + Selle režiimi sisse- või väljalülitamiseks vali SeadistusedKile seadistamine... KileLõpetamine. Samas dialoogis saad muuta ka läve, mitme tähe kirjutamise järel pakutakse automaatse lõpetamise võimalust. + + + + + + + + Omaenda lõpetamisfailide kirjutamine + + Lõpetamisfailide vormingu spetsifikatsiooni tutvustab lehekülg CWL file format specification. + + Lõpetamisfailid võib paigaldada kasutaja kodukataloogi alamkataloogi ~/.kde/share/apps/kile/complete/<režiim>/, kus <režiim> on kas abbreviation, dictionary või tex. + + + + + + + Nõustajad ja dialoogid + + + + Graafika kaasamine + + Dialoog Graafika kaasamine muudab graafika lisamise võimalikult lihtsaks. Palun uuri osasid ja , kus tutvustatakse mõningaid peamisi graafikavormingutega seotud asju. + + + Graafilise elemendi kaasamine + + + + + + Graafilise elemendi kaasamine + + + + + + Vali graafikafail. See võib olla JPEG, PNG, EPS või isegi zipitud või gzipitud EPS-fail. Kui paigaldatud on &imagemagick; ning &kile; on seadistatud seda kasutada (SeadistusedKile seadistamine... LaTeXÜldine), näidatakse automaatselt graafika laiust ja kõrgust. Kui &imagemagick; suudab kindlaks määrata lahutuse, näidatakse graafika suurust ka sentimeetrites. + + Otsusta, kas pilt tuleb lehekülhel tsentreerida. + + Vali kas traditsiooniline &latex; või &pdflatex;. Arvesta, et &pdflatex; võib luua ka DVI väljundi, mitte ainult PDF-i. + + Vali, kas failinimi peaks olema suhteline. See on soovitatav, kui kasutad käsku \graphicspath. + + Vaikimisi peavad graafikafailid olema samas kataloogis, kus asub põhidokument. Kuid vajaduse korral võib neid paigutada ka teistesse kataloogidesse. Ilma käsuta \graphicspath kaasab &kile; graafikafaili asukoha. Aga kui kasutad käsku \graphicspath, näiteks: + +\graphicspath{{/minu/graafika/asukoht}{teine/minu/graafika/asukoht}} + + + ja märgid selle valiku, kasutab &kile; ainult graafikafaili baasnime. + + Teine näide: kui sinu käsk \graphicspath näeb välja nii: + +\graphicspath{{./}{kaamera/}{pildid/}} + + + otsib &latex; graafikafaili aktiivses kataloogis, seejärel kataloogis kaamera ja siis kataloogis pildid. + + Laiust või kõrgust määrates skaleeritakse kogu graafika proportsionaalselt. Kui määrad nii laiuse kui ka kõrguse, võidakse laius ja kõrgus skaleerida erineva teguriga, mis ei pruugi olla soovitud tulemus. Vaata ka dialoogi ülaosas olevat teavet graafika originaalsuuruse kohta. + + Määra nurk, mille võrra pöörata graafikat vastupäeva. + + Ümbritsev kast lisatakse graafikafaili valimisel automaatselt. Seda läheb vaja ainult juhul, kui kasutad traditsioonilist &latex;i ja bittrastergraafikat. Vaata lähemalt osast EPS graafika. + + Viimane valik puudutab seda, kas põimida graafika kujundi keskkonda. Kui otsustad seda teha, saad määrata ka pealdise ja tiitli. Hea mõte oleks anda igale tiitlitüübile erinev prefiks. Piltide levinud prefiks on fig:. + + + + + + + Massiivinõustaja + + Üks igavamaid asju, mida &latex;is teha, on tabelkeskkonnas maatriksit kirja pana. Selleks tuleb silm peal hoida kõigil elementidel, kontrollida, et keskkond on ikka õigesti vormindatud ja et kõik on seal, kus olema peab. Taanduse kasutamine tuleb siin kasuks, kuid on ka lihtsam meetod: &kile; menüü _Nõustaja. See sisaldab kirjeid Tabel ja Massiiv (kasutatakse matemaatikakeskkonnas). Neid valides saad maatriksikujulise sisendi, mille võid hõlpsasti täita vajalike väärtustega. Dialoogis saab määrata veel mõningad tabeli omadused. + + + Tabelkeskkonna lisamine + + + + + + Tabelkeskkonna lisamine + + + + + Kirje Tabbing näitab lihtsamat menüüd tabbing-keskkonna loomiseks. Kõigis mainitud keskkondades saab määrata ridade ja veergude arvu ning veel mõned spetsiifilisemad omadused. + + + + + &postscript; abivahendid + + PS-failid ei ole nii levinud kui PDF-failid, aga need sobivad suurepäraselt lehekülgede käitlemiseks ja ümberkorraldamiseks. Kui vajad PDF-i väljundit, võib leheküljed ümber korraldada mõne &postscript;i tööriistaga ja seejärel teisendada PDF-iks käsuga ps2pdf. + + &postscript;i nõustaja pakub välja mõned levinumad ümberkorraldused, aga sul on muidugi vabadus seda omal käel teha. Selleks kasutatakse programme pstops ja psselect, mida enamik distributsioone pakub paketis psutils. Kui üks neist pole saadaval, ei ole vastavat elementi näha. + + + PSToolsi dialoog + + + + + + PSToolsi dialoog + + + + + Kõigepealt vali sisendfail. Kui &kile; leiab sinu põhidokumendile vastava PS-faili, on see juba lisatud sisendfailina, kuid sa võib muidugi valida ka mõne muu faili. Seejärel vali väljundfail ning mõni ülesanne. Viimaks tuleb otsustada, kas teha ainult teisendus või kutsuda tulemuse vaatamiseks välja ka &kghostview;. + + + + + 1 A5 leht + tühi leht --> A4 + Üks A5 leht koos ühe tühja lehega mahutatakse ühele A4 lehele. A5 lehtede liitmisel pööratakse neid 90 kraadi ning paigutatakse A4 lehele rõhtsalt. + + A5 + tühi leht + + + + + + A5 + tühi leht + + + + + + + + 1 A5 leht + duplikaat --> A4 + Üks A5 leht ja duplikaat mahutatakse ühele A4 lehele. + + Kaks A5 lehte + + + + + + Kaks A5 lehte + + + + + + + + 2 A5 lehte --> A4 + Kaks järjestikust A5 lehte mahutatakse ühele A4 lehele. + + Kahe A5 lehe liitmine + + + + + + Kahe A5 lehe liitmine + + + + + + + + 2 A5L lehte --> A4 + Kaks järjestikust rõhtpaigutusega A5 lehte mahutatakse ühele A4 lehele. + + + + 4 A5 lehte --> A4 + Neli järjestikust A5 lehte mahutatakse ühele A4 lehele. A5 lehed tuleb mahutamiseks skaleerida teguriga 0,7. + + 4 A5 lehte --> A4 + + + + + + 4 A5 lehte --> A4e + + + + + + + + 1 A4 leht + tühi leht --> A4 + Üks A4 leht ja üks tühi leht mahutatakse ühele A4 lehele. Kui kaks A4 lehte mahutatakse ühele A4 lehele, skaleeritakse neid teguriga 0,7 ning paigutatakse püstiselt. + + 1 A4 leht + tühi leht --> A4 + + + + + + 1 A4 leht + tühi leht --> A4i + + + + + + + + 1 A4 leht + duplikaat --> A4 + Üks A4 leht ja duplikaat mahutatakse ühele A4 lehele. + + 1 A4 leht + duplikaat --> A4 + + + + + + 1 A4 leht + duplikaat --> A4 + + + + + + + + 2 A4 lehte --> A4 + Kaks järjetikust A4 lehte mahutatakse ühele A4 lehele. + + Kahe A4 lehe liitmine + + + + + + Kahe A4 lehe liitmin + + + + + + + + 2 A4L lehte --> A4 + Kaks järjestikust rõhtpaigutusega A4 lehte mahutatakse ühele A4 lehele. + + + + Paarislehekülgede valik + Valitakse dokumendi kõik paarisleheküljed. + + + + Paaritute lehekülgede valik + Valitakse dokumendi kõik paaritud leheküljed. + + + + Paarislehekülgede valik (tagurpidi) + Valitakse dokumendi kõik paarisleheküljed tagurpidi järjekorras. + + + + Paaritute lehekülgede valik (tagurpidi) + Valitakse dokumendi kõik paarisleheküljed tagurpidi järjekorras. + + + + Kõik leheküljed tagurpidi + Kõik dokumendi leheküljed tagurpidi. + + + + Kõigi lehekülgede kopeerimine (sorteeritud) + Kopeeritakse dokumendi kõik leheküljed. Valida tuleb sorteeritud koopiate arv. + + Kõigi lehekülgede kopeerimine (sorteeritud) + + + + + + Kõigi lehekülgede kopeerimine (sorteeritud) + + + + + + + + Kõigi lehekülgede kopeerimine (sorteerimata) + Kopeeritakse dokumendi kõik leheküljed. Valida tuleb sorteerimata koopiate arv. + + Kõigi lehekülgede kopeerimine (sorteerimata) + + + + + + Kõigi lehekülgede kopeerimine (sorteerimata) + + + + + + + + pstops: parameetri valik + &postscript;i tööriistadel pstops ja psselect on hulk valikuid. Kui vajad neist mõnda, tuleb pstops välja kutsuda vajaliku võtmega. Võtmeid tutvustavad programmi manuaalileheküljed. + + + + psselect: parameetri valik + Käsu psselect võib välja kutsuda mõne vajaliku võtmega. Võtmeid tutvustavad programmi manuaalileheküljed. + + + + + + + + Dokumendi statistika + + Statistikadialoog annab ülevaate valikust, dokumendist või kogu projektist. See näitab sõnade arvu ning &latex;i käske ja keskkondi, samuti iga tüübi märkide arvu. Statistikat võib kopeerida tekstina või kenasti vormindatud &latex;i tabelina lõikepuhvrisse. Kui soovid näha kogu projekti statistikat, saad käsuga FailAva kõik projekti failid hõlpsasti ja kiiresti avada kõik oma projekti lähtefailid. + Arvude täpsust tuleb siiski võtta reservatsioonidega. Me kasutame usaldusväärse hinnangu saamiseks teatud loogikat, näiteks K\"uhler tähendab üht sõna ja üht käsku vastavalt kuue ja kahe märgiga. Kuid võib ette tulla kombinatsioone, mille korral käsu osi peetakse sõnadeks ja vastupidi. Samuti tuleb meeles pidada, et algoritm on välja töötatud ja testitud selliste keelte peal, mis sarnanevad inglise või saksa keelele. Seepärast ei tohiks arve pidada absoluutselt tõeseks. Kui pead koostama aruande, kus tuleb ära märkida sõnade või märkide täpne arv, tasuks eelnevalt testida, kas &kile; suudab neid ikka usaldusväärselt kokku lugeda. + + + + + + + &latex;i erisildid + + + &latex;i siltide kasutamine + + &latex; pakub sadu silte, mida saab lisada sümbolite ja erimärkide tähistamiseks. Lihtsaim viis erimärki lisada on kasutada külgriba menüüd vasakul pool redaktoriakent. + + + Külgriba menüü + + + + + + Külgriba menüü + + Külgriba menüü + + + Kasutada saab järgmisi tüüpe: + + + Enimkasutatud + Seos + Operaatorid + Nooled + Mitmesugused matemaatikasümbolid + Mitmesugused tekstisümbolid + Piiritlejad + Kreeka + Võõrtähed + Kirillitsa + Kasutaja määratud + + Ikoonide kohtspikrid näitavad &latex;i käske ja vajalikke lisapakette. + Kui vajutada klahvi &Shift; ja klõpsata sümbolil, lisatakse $\symbolcmd$. Kui teha sama klahviga &Ctrl;, lisatakse see looksulgudes. + Kui lisad käsu, mis vajab paketti, mida sinu &latex;i dokumendis ei leidu, näidatakse logivaates hoiatust. + Esimene sümbolite nimekiri sisaldab enimkasutatud sümboleid. Lisatud sümbolid lisatakse kiireks ja hõlpsaks kasutamiseks just sellesse nimekirja. Uute sümbolite lisamisel ei muudeta sümbolite järjekorda, küll aga loendurit. Kui elementide arv ületab 30, eemaldatakse kõige väiksema esinemisarvuga element. + Kasutaja määratud sümbolite nimekirjas on sinu enda sümbolid. Oma sümbolite loomiseks on vaja programmi gesumb ja faili definitions.tex Kile lähtepaketis. Lisaks on vajalikud &latex;i kompilaator ja &dvipng; (versioon 1.7 või uuem). Seejärel tuleb luua &latex;i fail käsuga \input{definitions}, mis muudab kättesaadavaks allpool toodud käsud, ning lasta käsuga gesymb mysymbols.tex user (see kutsub välja &latex;i ja &dvipng;) luua ikoonid. Kui need nüüd kopeerida asukohta $HOME/.kde/share/apps/kile/mathsymbols/user/ ja Kile taaskäivitada, saadki oma sümboleid kasutada. + Järgmised käsud on defineeritud failis definitions.tex: + + \command[\optarg]{\symbol}: sümboli \symbol lisamine sümbolite nimekirja, lisaargument \optarg määrab käsu, mille Kile peab lisama. Kui seda pole antud, kasutatakse käsku kohustuslikus argumendis. + + + \mathcommand[\optarg]{\symbol}: sama, mis eespool, ainult et käsk kohustuslikus argumendis lisatakse matemaatikarežiimis. + + + \pkgs[arg]{pkg}: deklareerib, et antud real antud käsk vajab &latex;i paketti pkg lisaargumendiga arg. See käsk peab seisma käsu \command ees ja tühistab kõik neededpkgs keskkonna määratud paketid. + + + \begin{neededpkgs}[pkgs-args]{pkgs} ... \end{neededpkgs}: sama, mis eespool, aga kõigi suletud käskude jaoks. + + + + Toome siin ühe täieliku näite: + \documentclass[a4paper,10pt]{article} + \usepackage{amssymb} + \input{definitions} + % + \begin{document} + \pagestyle{empty} + % + \begin{neededpkgs}{amssymb} + \mathcommand{\surd} + \pkgs{amsmath}\mathcommand[\ddddot{}]{\ddddot{a}} + \mathcommand{\angle} + \end{neededpkgs} + \command{\"A} + \mathcommand{\exists} + \mathcommand[\stackrel{}{}]{\stackrel{abc}{=}} + + %\begin{neededpkgs}[russian,koi8-r,T2C,]{babel,inputenc,fontenc,mathtext} + % + % \end{neededpkgs} + % this would need to include the packages + % \usepackage{mathtext} + % \usepackage[T2C]{fontenc} + % \usepackage[russian]{babel} + % \usepackage[koi8-r]{inputenc} + % just to explain the format + \end{document} + + + + + + + Biblioelementide kasutamine + + \bibitem on käsk, mis viitab, et dokumendis on kasutusel thebibliography. Käsu \bibitem süntaks on \bibitem[pealdis]{võti}. + + Võti [pealdis] võimaldab sul lisada bibliograafiakirjele omaenda pealdiste süsteemi. Kui seda ei ole määratud, seatakse kirjed arvulisse järjekorda: [1], [2], [3] jne. + + Argumenti {võti} kasutatakse viitamiseks ja käskude \bibitem ning \cite linkimiseks üksteise ning neis leiduva infoga. Käsk \cite sisaldab pealdist, mis on seotud käsuga \bibitem, mis asub keskkonnas thebibliography ja sisaldab viiteandmeid. Nii \bibitem kui \cite peab sisaldama sama {võti}t. Kõige hõlpsam on võtmeid mõistagi korraldada autori perekonnanime järgi. Sekundaarsed suludkäsus {thebibliography} tähistavad pikimat bibliograafiapealdist, mis sul võib olla. Nii võib {suva} lisamisel pealdis olla maksimaalselt suva pikkune. Kui seda parameetrit korrektselt ei määrata, ei pruugi bibliograafia kuigi atraktiivne välja näha. + + Bibliograafia seisab peadokumendist eraldi, selle näidiskood võib olla selline: + + + \begin{thebibliography}{50} + \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm...donuts}. + Evergreen Terrace Printing Co., Springfield, SomewhereUSA, 1998 + \end{thebibliography) + + Oletame nüüd, et sinu põhilähtetekstis leidub info, mida seob käsuga \bibitem käsk \cite. Lähtetekst näeb siis välja selline: + + + Minu töö aluseks Simpsonite\copyright filosoofia kohta + on mu lemmikraamat \cite{Simpson}. + + Paljude viidete korral on sageli raske meeles hoida täpset tsitaadivõtit, mistõttu &kile; pakub välja hõlpsa võimaluse tsitaadi lisamiseks. Klõpsa redigeerimisribal teisele hüpikkastile (tavaliselt seisab seal pealdis) ja vali tsitaat. Ilmub nähtavale kõigi tsitaadivõtmete loend, kust saab valida vajaliku viite ning tsitaadikirje lisataksegi dokumenti. Võtmete loendi uuendamiseks salvesta fail või vali menüükäsk RedigeerimineVärskenda struktuuri või vajuta klahvi F12. + + Sinu dokumendi bibliograafia näeb lõpuks välja siis selline: + + [1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, SomewhereUSA, 1998. + + Lihtsaim viis käskude \bibitem ja \cite kasutamiseks on tööriistariba rippmenüü kirjaga tsitaat. Kui soovid lisada tsitaadi, pakutakse sulle seni loodud bibitem-ite loendit, millest võid valida vajaliku. &kile; suudab nüüd ka töötada käsikäes &bibtex;i redaktoritega, näiteks &kbibtex;, mis muudab tsiteerimise märgatavalt hõlpsamaks. + + + + + + Kasutaja määratud sildid + + &kile; võimaldab sul luua oma silte. Silt on põhimõtteliselt kiirkorraldus, mis käivitab mingi käsu või kirjutab sinu eest sageli ettetuleva teksti. Oletame näiteks, et Julius Sarvik kasutab sageli väljendeid Ma eelistan \LaTeX\it \TeX\ile ja Mida ma küll hakkaksin peale Linuxita? Kasutaja määratud siltide loomiseks, mis paneks Juliuse eest need fraasid kirja, tuleb tal valida menüükäsk LaTeXKasutaja sildidRedigeeri kasutaja silte... See avab dialoogi, kus Julius saabki luua just selliseid silte, mida tal vaja läheb. + + Kasutaja siltide redigeerimise dialoog + + + + + + Kasutaja siltide redigeerimise dialoog + + Kasutaja siltide redigeerimise dialoog + + + + + Kasutaja määratud sildi sisestamine + + + + + + Kasutaja määratud sildi sisestamine + + Kasutaja määratud sildi sisestamine + + + + Oma kahe sildi loomiseks, mida kirjutamisel sageli vaja läheb, annab Julius neile selgelt eristava nime. Sildile antav nimi tuleb sisestada sektsiooni Menüükirje, vastav tekst aga sektsiooni Väärtus. Kui vajalikud andmed on sisestatud, võib neid silte kasutada kiirklahvidega &Ctrl;&Shift;1, mis lisab esimese sildi teksti Ma eelistan \LaTeX\it \TeX\ile, ning &Ctrl;&Shift; 2, mis lisab teise sildi teksti Mida ma küll hakkaksin peale Linuxita? + + + + Kohanäitajad kasutaja määratud siltides + + Kasutaja määratud siltides saab pruukida mõningaid kohanäitajaid: %B, %C, %M ja %S. + + + %B: asendatakse täpiga. + %C: sinna viiakse kursor pärast kasutaja määratud sildi lisamist. + %M tähistab märgitud teksti; valitud tekst lisatakse kasutaja määratud siltide tarvitamisel selle asemele. + %S: asendab lähtefaili nime (ilma laiendita). + + + Selgitamaks, kuidas see toimib, oletame, et mul on kasutaja määratud silt väärtusega \bfseries{%M}%C ning ma olen dokumendis ära märkinud teksti, mille tahan panna rasvasesse kirja. Seega tõstan esile fraasi Ma armastan reedet, lisan kasutaja määratud sildi, vajutades &Ctrl;&Shift;1 ning tulemuseks on fraas \bfseries{Ma armastan reedet}, kusjuures kursor asetseb fraasi lõpus. + + + + + + + + + + Ehitamistööriistad + + + + Kompileerimine, teisendamine ja vaatamine + + Oma töö tulemuste nägemiseks tuleb kõigepealt lähtetekst kompileerida. Kõik ehitamisvahendid asuvad ilusasti üksteise kõrval menüüs: EhitamineKompileeri, EhitamineTeisenda, and EhitamineVaata + + Lähtekoodi kompileerimiseks ekraaninäitajate tarbeks, nagu &kdvi;, &kghostview;, &kpdf;, või edasiseks teisendamiseks saab kasutada kiirklahvi &Alt;2. Seejärel võib vaadata DVI-faili vaikenäitajas kiirklahviga &Alt;3, teisendada DVI-faili PS-failiks kiirklahviga &Alt;4 ning vaadata PS-faili kiirklahviga &Alt;5. + + + + &bibtex; + + Kui sul on bibliokirjete tarbeks kasutusel &bibtex;, tuleb enamasti järgida spetsiaalset kompileerimismudelit. See tähendab, et välja tuleb kutsuda &latex; ja siis &bibtex; ja siis veel kakskorda &latex;. Õnneks on &kile; piisavalt nutikas ja oskab automaatselt tuvastada, kas on vaja välja kutsuda selliseid lisatööriistu, nagu &bibtex;, &makeidx; ja &asymptote;. See on nii vähemalt vaikimisi, kuigi seda saab ka muuta, kui valida SeadistusedKile seadistamine...TööriistadEhitamine kaardil Üldine &latex;i ja &pdflatex;i tööriistad. + + + + + + &makeidx; + + Kui kasutad oma dokumendile tähestikule indeksi loomiseks tööriista &makeidx;, tuleks samuti kasutada järgmist spetsiaalset kompileerimisvõimalust või lasta &kile;l see ära teha samamoodi, nagu see on võimalik &bibtex;i failide puhul + + + + + + MetaPost ja Asymptote + + Kui soovid kompileerida oma dokumendi pildijoonistamisrakendusega MetaPost või Asymptote, saab seda teha menüükäsuga EhitamineKompileeriMetapost või EhitamineMuuAsymptote. + + + + + + &pdflatex; + + Dokumenti saab veel ühel moel kompileerida, kui soovid saada PDF-faili: käivita &pdflatex;, mis kompileerib lähteteksti otse PDF-failiks, kiirklahviga &Alt;6. Seejärel võib kompileeritud faili vaadata kiirklahviga &Alt;7. + + Teine võimalus on teisendada PS-fail PDF-failiks kiirklahviga &Alt;8 või DVI-fail otse PDF-failiks kiirklahviga &Alt;9. + + &pdflatex;i eelistamine &latex;ile võib olla lihtsuse või harjumuse küsimus, kuid kohati on kahe programmi käitumine üpris erinev. + + + + + + &latex; veebis + + Sul võib olla ka soov avaldada oma töö veebis, mitte aga paberil. Selleks saab kasutada programmi latex2html, mille saab käivitada &kile; menüükäsuga EhitamineTeisendamineLaTeX -> HTML. Tulemus asetatakse sinu töökataloogi alamkataloogi, teisenduse saadust võid näha menüükäsuga EhitamineVaatamineVaata HTML-i. + + + + + + Käsurea parameetrid + + Võib juhtuda, et soovid anda töövahenditele oma failide kompileerimiseks, teisendamiseks või vaatamiseks mõningaid spetsiaalseid käsureaparameetreid. Standardseid tööriistu saab seadistada menüükäsuga Seadistused Kile seadistamine...TööriistadEhitamine + + + + + + + Kiire eelvaatlus + + &latex;iga töötades tuleb alati leida aega oma töö tulemuse uurimiseks. &latex; peab kompileerima lähteteksti ning välja kutsuma dokumendi näitaja. See võib olla tülikas, kui oled muutnud näiteks ainult mõnda tähte võrrandis. &kile; pakub selleks välja kiire eelvaatluse režiimi, kus kompileeritakse ainult osa dokumendist, mis säästab tublisti aega. Toetatud on neli erinevat režiimi, mida saab omavahel kombineerida seitsme seadistusega. + + + Kiire eelvaatlus + + + + + + Kiire eelvaatlus + + + + + Kõiki seadistusi saab määrata ja muuta, kui valida SeadistusedKile seadistamine... TööriistadEelvaatlus + + + Kiire eelvaatluse seadistamine + + + + + + Kiire eelvaatluse seadistamine + + + + + + + Valimise režiim + + Kasutajal tuleb valida dokumendi osa. Valitud programmid käivitab menüükäsk EhitamineKiire eelvaatlusValik või kiirklahv &Ctrl;&Alt;P, S. &kile; kasutab originaalteksti preambulat, mistõttu peavad olema kaasatud kõik paketid ja kasutaja määratud käsud. Kasutaja saab valida seitsme eelnevalt määratud seadistuse vahel: + + + LaTeX+DVI (põimitud näitaja) + LaTeX+DVI (KDVI) + LaTeX+PS (põimitud näitaja) + LaTeX+PS (KGhostView) + PDFLaTeX+PDF (põimitud näitaja) + PDFLaTeX+PDF (KGhostView) + PDFLaTeX+PDF (KPDF) + + + Sellest peaks piisama kõigiks juhtumiteks, kus läheb vaja kiiret eelvaatlust. + + + + + + Keskkonnarežiim + + Sageli võib vaja olla aktiivse keskkonna, eriti matemaatikakeskkonna eelvaatlust, mida on mõnigi kord keeruline kirja panna. &kile; võimaldab seda väga kiiresti. Valikut polegi vaja, vali lihtsalt menüükäsk EhitamineKiire eelvaatlus Keskkond või kasuta kiirklahvi &Ctrl;&Alt;P,E ning aktiivne keskkond kompileeritaksegi ja kuvatakse. + + + + + + Alamdokumendi režiim + + Kui sul on paljude dokumentidega suurem projekt, ei ole kogu projekti kompileerimine arvatavasti kuigi hea mõte, kui oled teinud muudatusi ainult ühes dokumendis. &kile; võib kompileerida ja eelvaatlusena kuvada ka aktiivset alamdokumenti. Preambul võetakse põhidokumendist ning kompileeritakse ainult aktiivne osa, kui valid menüükäsu EhitamineKiire eelvaatlusAlamdokument või kiirklahvi &Ctrl;&Alt;P,D. + + + + + + Matemaatikagrupi režiim + + Matemaatikagrupi eelvaatluse režiim võimaldab näha parajasti redigeeritavat matemaatikagruppi. &kile; võtab preambuli põhidokumendist ning kompileerib ainult matemaatikagrupi, milles asub parajasti kursor, kui valid menüükäsu EhitamineKiire eelvaatlusMatemaatikagrupp või kiirklahvi &Ctrl;&Alt;P,M. + + + + + + Kiire eelvaatlus allribal + + Selle asemel et näidata eelvaatlust uues dokumendis, võib &kile; panna kasutama eelvaatluse näitamiseks ka allriba. Selle valiku saab sisse lülitada kiire eelvaatluse seadistustes. + + + + + + + + Graafikafaili vormingud + + + + &latex; ja &pdflatex; + + Pane tähele, et &pdflatex; suudab pakettide graphics või graphicx kasutamisel kompileerida korrektselt PDF-faili PNG- ja JPG-failid, aga mitte EPS-failid. Ja vastupidi, kompileerimine DVI-failiks ning teisendamine PS- või PDF-failiks toetab EPS-ide kasutamist, aga mitte PNG- ja JPG-faile. + + Paljud kasutajad soovivad luua PDF-dokumente, aga samas kasutada ka suurepärast paketti Pstricks &postscript;i graafika loomiseks või siis selliste matemaatika- ja teadusrakenduste nagu Mathematica, Maple või MuPAD &postscript;i väljundit. Sellised &latex;i kasutajad peavad kõigepealt kompileerima &postscript;i, isegi kui nad soovivad luua PDF-dokumendi, sest need rakendused loovad sellise &postscript;i koodi, millega &pdflatex; ei oska midagi peale hakata. Kuid see pole nii raske, kui esialgu võib tunduda, sest sind abistab siin &kile;. + + + + + + Graafika teisendamine + + Selle kurvastava asjaolu lahendamiseks ning nii EPS- kui ka PNG- ja JPG-failide kaasamiseks &postscript;i koodi kõrval on mitu võimalust: + + + Kui sul on vaja faili PS-vormingus, kuid JPG- või PNG-failidega, võid lihtsalt kasutada kõigepealt &pdflatex;it DVI väljundiga ja seejärel programmi dvips Ps-faili loomiseks. Nagu näed, on &pdflatex; väga hea valik, kui sinu lähtetekst ei sisalda üldse &postscript;i koodi. + + EPS-failid on võimalik teisendada PNG või mõnesse muusse vormingusse näiteks rakendusega Gimp või &imagemagick; ning seejärel kasutada &pdflatex;it. + + Soovitatav on teisendada EPS-graafika PDF-graafikaks programmiga epstopdf, mida pakub iga &tex;i pakett, ning seejärel kasutada &pdflatex;it. See annab tulemuseks väga hea kvaliteediga graafika ning sa saad tulemust isegi juhtida mõnega järgmistest käskudest: -dAutoFilterColorImages=false + -dAutoFilterGrayImages=false + -sColorImageFilter=FlateEncode + -sGrayImageFilter=FlateEncode + -dPDFSETTINGS=/prepress + -dUseFlateCompression=true + + + + Ja mis veel parem: kui sinu süsteem toetab shelli paomärke (shell-escape), saab teisendamist teha lausa lennult. Selleks tuleb vaid kaasata pakett epstopdf, mis kuulub &tex;i koosseisu, käsuga \usepackage{epstopdf}. Oletame, et kood on + \includegraphics[width=5cm]{test.eps} + Kui kutsud &pdflatex;i välja võtmega , teisendatakse graafikafail test.eps automaatselt failiks test.pdf. + + Teisendamine võetakse ette iga kord, kui käivitad &pdflatex;i. Kui graafikakäsk onantud otseselt: + \includegraphics[width=5cm]{test} + kontrollib epstopdf, kas fail test.pdf on juba olemas, nii et teisendamise saab vahele jätta. + + Teisendamise võib ette võtta ka teistpidi ning tarvitada &latex;it ja PS->PDF teisendust. See ei ole siiski soovitatav, sest JPG- või PNG-failid EPS-idena on üldiselt väga suured, mis võib kaasa tuua tarbetult mahukate dokumentide tekkimise. See sõltub siiski suurel määral kasutatavast graafikarakendusest, sest EPS võib kaasata endasse muud graafikat, kuid mitte kõik rakendused ei toeta seda võimalust ühtmoodi hästi. Mõned võivad isegi püüda luua JPG-pilti vektoritega ning mitmesuguste skriptimisega, mis annab tulemuseks hiiglaslikud failid. Igat tüüpi graafikafaile teisendab EPS-iks &imagemagick;. Teine programm, mis tuleb sellega korralikult toime, on jpg2ps. + + Samuti võib kasutada automaatset teisendamist. Sel juhul teisendatakse kõik graafikafailid lennult EPS-iks ja lisatakse PS-dokumenti. See on väga mugav, aga selleks tuleb süsteem vastavalt seadistada. Sellest on juttu osas EPS-graafika. + + + + + + + + Õige faili kasutamine õige graafika jaoks + + + EPS on omamoodi vektorgraafika skriptikeel, mis kirjeldab kõiki jooni ja punkte, millest graafika koosneb. See ei kaota eriti suurendamisel ning sobib kõige paremini skeemide ja vektorgraafika jaoks, mille loomupärane väljund ongi EPS, mis näeb välja väga puhas ja terav, olles samal ajal mahult väike. + PNG (või iganenud GIF) on kaotusteta failivorming korraliku tihenduse ja kvaliteediga. See sobib hästi skeemide, jooniste ja kõige muu jaoks, kus on oluline säilitada teravus. Siiski on see mõnikord liiga ülepakutud fotode jaoks. + JPG on kaotustega vorming, mis tihendab faile paremini kui PNG, ent kaotab sellevõrra omajagu pilditäpsuses. Fotode korral ei ole see tavaliselt oluline, kuid skeemide ja jooniste puhul võib tulemuseks olla kesine kvaliteet ning mõned peenemad read võivad sootuks kaduma minna. Sellisel kuhul on EPS või PNG kindlasti parem valik. + + + Kuid pea alati meeles: kus rämpsu juba on, seal seda vähemaks ei jää! Ükski teisendus ei saa muuta kehva pilti heaks. + + + + + + + + EPS-graafika + + EPS-graafika on traditsiooniline viis graafikafailide lisamiseks &latex;i dokumentidesse. Kõikvõimalikud foorumid ja postiloendid on täis küsimusi EPS-graafika kohta, mistõttu me käsitleme siin mõningaid olulisemaid asju ja näitame, kuidas &kile; neid toetab. + + + + &latex; ja EPS-graafika + + Kui otsustad kasutada EPS- või PDF-väljundi loomiseks traditsioonilist &latex;it, tekivad sul tõenäoliselt graafikaga teatud probleemid. Pead kasutama EPS-graafikat (kapseldatud &postscript;), mitte JPEG- või PNG-faile. See ei tohiks olla üldiselt probleem, sest on terve hulk teisendajaid, näitkes convert suurepärasest &imagemagick; paketist. Kuid loomulikult läheb sul vaja natuke aega. + + EPS-faile kasutavad nii &latex;i kui ka DVI-PS teisendajad: + + + &latex; uurib EPS-faili ümbritseva kasti tuvastamiseks, mis ütleb &latex;ile, kui palju ruumi graafikale jätta. + + DVI-PS teisendaja loeb seejärel EPS-faili sisse ja lisab graafika PS-faili. + + + Sellel on oma tagajärjed: + + + &latex; ei loe EPS-faili, kui ümbritseva kasti parameetrid on määratud graafika lisamise käsuga. + + Et &latex; ei suuda lugeda ASCII-faile, ei suuda ta lugeda ka ümbritseva kasti teavet tihendatud või mitte-EPS-graafikafailidest. + + EPS-graafikat ei kaasata DVI-faili. Kuna EPS-failid peavad DVI-faili teisendamisel PS-failiks olemas olema, peavad EPS-failid alati DVI-faili liigutamisel samuti asukohta vahetama. + + + Nüüd võid välja kutsuda &latex;i ja DVI-PS teisendaja, näiteks dvips'i, et luua oma &postscript;i dokument. Kui eesmärk on PDF-dokument, tuleb dvips käivitada võtmega ja seejärel kutsuda välja ps2pdf. Selle kohta leiab üsna palju dokumendatsiooni. + + + + + + &kile; ja &postscript; + + &kile; aitab hankida teavet ümbritseva kasti kohta. Kui paigaldatud on &imagemagick;, hangib &kile; selle teabe EPS-failist ja lisab selle võtmena. Seda tehakse graafikafaili valimisel automaatselt. Sel on kaks eelist: + + + Teave on dialoogis juba olemas, d&latex; ei pea seda hiljem hankima. + Veel tähtsam on see, et nii saab arvutada pildi laiuse ja kõrguse, kui on teada lahutus. Seda teavet näidatakse dialoogi ülaosas ning sellest võib abi olla, kui soovid graafikat skaleerida. + &kile; toetab ka zipitud või gzipitud EPS-faile. mis on palju väiksemad kui tihendamata EPS-failid. Seda võimalust saab siiski kasutada vaid siis, kui süsteem on vastavalt seadistatud ning muudetud kohalikku graafikaseadistust, nagu seda kirjeldab osa Bittrastergraafika. + + + + + + + &postscript; ja bittrastergraafika + + Kui sinu süsteemis saab shellis kasutada paomärke (shell-escape), toetab &kile; ka väga lihtsat bittrastergraafika kaasamise viisi, kui oled oma &tex;i süsteemi vastavalt seadistanud. Sel juhul pole vaja teisendada JPEG- või PNG-graafikat, seda tehakse DVI-faili teisendamisel PS-failiks automaatselt. + + &latex; vajab veidi teavet faililaiendite kohta. Pakett graphicx otsib faili graphics.cfg, mis peab asuma &latex;i dokumentide otsinguteel. Otsi seal järgmisi kirjeid: + +\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}{}% + + + ja kirjuta nende asemele järgmised read: + +\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 + + + Näiteks Debianis paikneb see fail asukohas /etc/texmf/latex/graphics.cfg. Parim võimalus on kopeerida see oma kohalikku TeXi asukohta ja seda siis seal muuta. Kuidas leida &tex;i katalooge, saab teada &tex;i manuaalilehekülgedelt. + + Selle seadistustefaili abil saab lisada &latex;isse bittrastergraafikat ja zipitud või gzipitud EPS-faile. Teisendamiskäsu annab dvips. Kui uurid teisendamiskäsku, näed, et lisafaile ei looda. Teisendamise tulemus suunatakse otse PS-faili. &latex; peab teadma ainult graafika suurust ja seepärast ongi vaja ümbritsevat kasti, mida pakub &kile;. + + Võidakse öelda, et see ei ole väga turvaline, aga seda pead sa ise otsustama. Igal juhul ei ole vaja ümbritsevat kasti, sest &kile; hangib selle teabe kõigist graafikatüüpidest. + + + + + + &pdflatex; ja EPS-graafika + + Nagu märgitud, ei suuda &pdflatex; käsitseda EPS-graafikafaile, kuid selle juures on abiks teisendajad, näiteks epstopdf. Parim viis on kaasata pakett , millele peab eelnema pakett graphicx. + +\usepackage[pdftex]{graphicx} + \usepackage{epstopdf} + + + Siis saab juba lisada EPS-graafikat, kui käivitada pdflatex võtmega , kuid see on võimalik veelgi paremini, kusjuures käsitleda saab ka zipitud või gzipitud EPS-faile. Taas tuleb muuta graafika seadistustefaili graphics.cfg. Sedakorda otsime seal üles read: + +% pdfTeX is running in pdf mode + \ExecuteOptions{pdftex}% + + + ja lihtsalt lisame mõned raed. + +% 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}}% + }% + + + Nende ridadega suudab &pdflatex; käsitleda EPS-faile ja loodetavasti ei teki graafikaga rohkem probleeme. + + + + + + + + Põhidokument + + Dokumendi määratlemine põhidokumendina võimaldab töötada erinevate failidega, nii et sul on ülemdokument (ehk põhidokument) ja töö juurde käivad alamdokumendid. Pärast põhidokumendi määramist vastava käsuga menüüs Seadistused käivad kõik menüü Tööriistad vahendusel antud käsud ainult selle dokumendi kohta isegi juhul, kui töötatakse alamdokumentidega. Põhimõtteliselt võib peadokumendi isegi sulgeda. + + + + + Veahaldusest lähemalt + + Pärast kompileerimist uurib &kile; lähemalt genereeritud veateateid. Kui esineb vigu või hoiatusi, antakse neist teada logi/teadeteaknas. Teateid saab lähemalt uurida menüükäsuga Ehitamine Vaata logi või kiirklahviga &Alt;0. Genereeritud logi näidatakse siis logi/teadeteaknas ning vead ja hoiatused on esile tõstetud. + + + Logi vaatamine + + + + + + Logi vaatamine + + Logi vaatamine + + + + Logifaili ühelt teatelt teisele saab hõlpsasti hüpata menüükäsuga Ehitamine Järgmine/Eelmine LaTeXi viga/hoiatus või vastavat tööriistariba nuppu klõpsates. + + Hüppamaks &latex;i lähtetekstis reale, kus viga esineb, klõpsa logi/teadeteaknas lihtsalt vastaval veal/hoiatusel. &kile; viib su automaatselt vigasele reale. + + + + + + Faili jälgimise režiim + + Kui käivitad käsu Kiire ehitamine, avatakse tavaliselt pärast kompileerimist mingi vaatamisrakendus. Kui sa ei kasuta põimitud vaatajat, avatakse alati uus aken. + + Dokumendi välimuse kohendamisel võib juhtuda, et käivitad käsku Kiire ehitamine päris sageli ja su töölaud kattub aina uute avanevate akendega. Selle vältimiseks võib sisse lülitada faili jälgimise režiimi, mis takistab käsul Kiire ehitamine vaataja akent avamast. + + Hetkel toetab &kdvi; vaadatava DVI-faili korduvat uuendamist, kuid &kghostview; pole sugugi täiuslik: dokumendi uuendamiseks pärast kompileerimist tuleb sul muuta lehekülge, kuid &kghostview; ei näita leheküljenumbrite muutust. + + Põimitud vaataja korral on see režiim mõistagi kasutu, sest sel juhul sulged nagunii akna, et pääseda tagasi dokumendi redigeerimise ja uue kompileerimise võimaluse juurde. + + + + + + + + Liikumine &latex;i lähtetekstis + + + + Struktuurivaate kasutamine + + Struktuurivaade näitab &kile;s loodava dokumendi struktuuri ning võimaldab selles kiiresti liikuda. Dokumendis liikumiseks on vaja vaid hiire vasaku nupuga klõpsata mis tahes pealdisel, peatükil, sektsioonil, alamsektsioonil ja nii edasi ning sind viiakse vastava ala algusesse. + + Kui kaasad faili &latex;i dokumenti sildiga \input või \include, sisaldab struktuurivaade vastavat faili esindavat elementi. Topeltklõps failinimel paneb &kile; kaasatud faili redaktoriaknas näitama. + + Hierarhiapuus on omaette haru ka tekstis kasutatud pealdistele. + + + Struktuurivaate kasutamine + + + + + + Struktuurivaate kasutamine + + Struktuurivaate kasutamine + + + + + + Struktuurivaate uuendamine + + Struktuurivaate uuendamiseks kasuta menüükäsku RedigeerimineUuenda struktuuri , vajuta klahvi F12 või salvesta dokument, mis samuti sunnib &kile; värskendama struktuurivaadet. + + + + + + + + Järjehoidjad + + Järjehoidjad viitavad tekstiosale või reale &kile; keskkonnas. Järjehoidja tarvitamiseks vali dokumendis rida, mille juurde soovid hiljem naasta, vajuta &Ctrl; B ja &kile; lisabki automaatselt sellele reale järjehoidja. Järjehoidja saab määrata ka siis, kui märkida ära rida, mille juurde soovid hiljem naasta, ja valida menüükäsk JärjehoidjaLülita järjehoidjat. + + Järjehoidjate eemaldamiseks kasuta menüükäsku Järjehoidjad Puhasta järjehoidjad. + + Palun arvesta, et praegu ei salvestata järjehoidjaid, kui väljud &kile;st. + + + + + + + + Projektid + + + + Projektide kasutamine + + &kile; pakub võimalust luua ja kasutada projekte. Projekt on rühm &latex;i, graafika-. &bibtex;i või muid faile, mis kõik on seotud sinu põhidokumendiga. Projekti tüüpiline näide on mitmest peatükist koosnev dokument, kus peatükid kujutavad endast erinevaid .tex-faile. Kõik need võib kaasata projekti, mis muudab tervikdokumendi haldamise märksa hõlpsamaks. Projekti spetsifikatsioon salvestatakse spetsiaalsesse faili laiendiga .kilepr. + + Projekt pakub järgmisi võimalusi: + + + Põhidokumenti pole vaja määrata, &kile; teeb seda automaatselt + Projektifaile saab hõlpsasti üheskoos arhiveerida, kui valida menüükäsk EhitamineMuuArhiiv. + Vaade Failid ja projektid näitab, millised failid on dokumenti kaasatud. + Pärast projekti avamist taastatakse kõik varem avatud failid esialgse kodeeringu ja esiletõstmistega. + Koodilõpetamine toimib kõigis projekti failides. + Viidete lõpetamine toimib kõigis projekti failides. + Tsitaadi lõpetamine toimib kõigis projekti failides. + Otsimine kõigis projekti failides. + Kohandatud kiire ehitamise ja &makeidx; käsu määramine. + + + + + + + Projekti loomine + + Projekti loomiseks vali menüükäsk Projekt Uus projekt.... Projekti loomiseks päritakse sinu käest järgmisi asju: + + Sinu projekti pealkiri + Projektifaili nimi laiendiga .kilepr + Failinimi + Loodava faili tüüp: tühi dokument, artikkel, raamat, kiri, aruanne... + + + Kui täidad kasti failinimi, tuleb määrata ka selle faili asukoht projektifaili (laiendiga .kilepr) suhtes. + + + + + + Faili ja projekti vaade + + Faili ja projekti vaate nupp kujutab endast kaht paberilehte. Selles vaates on võimalik näha projekti struktuuri, selles olevaid faile ning projekti infot sisaldava .kilepr-faili nime. Failide lisamine projekti, nende eemaldamine või projekti seadistamine käibki ennekõike faili ja projekti vaate abil. + + + Faili ja projekti vaade + + + + + + Faili ja projekti vaade + + Faili ja projekti vaade + + + + + + + + Failide lisamine ja eemaldamine + + Faili lisamiseks projekti ava vajalik &tex;-fail, klõpsa selle nimel faili ja projekti vaates hiire parema nupuga ning vali Lisa projekti. Kui sul on avatud mitu projekti, küsib dialoog, millisesse projekti fail lisada. + + Kui tahad lisada projekti mitu faili, vali faili ja projekti vaates projekt, klõpsa sellel hiire parema nupuga ja vali Lisa fail. Seejärel saab vajalikud failid valida ilmuvas dialoogis. + + Samuti võib klõpsata faili ja projekti vaates projekti nimel hiire parema nupuga ning valida Lisa failid.... Seejärel saab vajalikud failid valida ilmuvas dialoogis. + + + Faili lisamine projekti + + + + + + Faili lisamine projekti + + Faili lisamine projekti + + + + Faili eemaldamiseks projektist klõpsa failinimel hiire parema nupuga ja vali Eemalda fail. Sinu fail eemaldataksegi projektist. See ei kustuta faili, vaid ainult eemaldab selle projektifailide (laiendiga .kilepr) nimekirjast. + + + + + + Projekti valikud + + &kile; pakub mõned võimalused muuta projekti seadistusi. Selleks klõpsa hiire parema nupuga projekti pealkirjal ja vali Projekti valikud. Seejärel on võimalik muuta järgmisi asju: + + + Projekti pealkiri + Põhidokument + Kiirehitamise käsk + &makeidx; valikud + + + + + Projekti arhiveerimine + + &kile; võimaldab vähese vaevaga teha projektist varukoopia, salvestades kõik projekti failid ühte arhiivi. Projekti arhiveerimiseks klõpsa faili ja projekti vaates hiire parema nupuga projekti nimele või vali menüükäsk Projekt Arhiveeri. + + Vaikimisi lisatakse arhiivi projekti kõik failid. Kui sa aga ei soovi mõne faili arhiveerimist, klõpsa faili ja projekti vaates hiire parema nupuga vastaval faili ja lülita võimalus Kaasa arhiivi välja. + + Arhiveerimiskäsud on shellikäsud, mis käivitatakse projektikataloogis (koht, kus on salvestatud .kilepr-fail). + + + + + + + + + + Projekti sulgemine + + Projekti sulgemiseks vali faili ja projekti vaade, klõpsa hiire parema nupuga projekti nimel ning vali Sulge. See käsk sulgeb projekti ning kõik sellega seotud failid ja lisab ka suletud projekti nime menüüs Projekt valikusse Ava hiljutine projekt.... + + + + + + + + Dokumendi kodeering + + &kile; üks võimsaid eeliseid on oskus lugeda, teisendada ja määrata tekstile just see kodeering, mida sa vajad. See lubab kasutada mittestandardseid tähti ja sümboleid, nii saab tarvitada näiteks itaalia või prantsuse keele rõhumärkidega tähti. Dokumendi kodeeringu saab valida kolmel moel: + + + Kasutades liitkasti kodeering, mis asub faili avamise vaate allosas. + Teine võimalus on kasutada alammenüüd SeadistusedKile seadistamine...Redaktor, kus saab määrata kõigi failide vaikimisi kodeeringu. + + Vaikimisi kodeeringu määramine + + + + + + Vaikimisi kodeeringu määramine + + + + + Valides vastava võimalus uue dokumendi loomisel nõustajas. + + + Traditsiooniliselt mõistab &latex; ainult piiratud hulka sümboleid (ASCII), mis ei luba rõhumärkidega tähti või erisümboleid vahetult sisestada. Rõhumärkidega tähtede kasutamiseks pruugib &latex; lahendusena süntaksit, mis võimaldab selliseid tähti siiski kasutada, näiteks \"e ë jaoks. Selles aitab kaasa omaette pakett inputenc, mis on kaasatud preambulisse käsuga \usepackage[latin1]{inputenc}, kus lisaargument tähistab kodeeringut, mida tahad kasutada (tänapäeval enamasti sobima utf8x). See annab &latex;ile korralduse tõlgendada kõik ë dokumendis enne kompileerimist kujule \"e. Rohkem infot inputenc kohta leiab inputenc dokumentatsioonist. Kontrolli, et fail oleks ka tegelikult selles kodeeringus, mida väidab inputenc! + + + Lähteteksti kodeeringu valimine + + + + + + Lähteteksti kodeeringu valimine + + Lähteteksti kodeeringu valimine + + + + Erinevate sümbolite hiigelhulk tekitab probleeme paljudele rakendustele, mistõttu on jõutud üldisele veendumusele, et varem või hiljem on vajalik kasutusele võtta Unicode. Unicode erinevaid teostusi liigub päris mitu, Linuxi maailmas on neist kõige edukam olnud UTF-8, samas Windows® kasutab mõneti kohmakamat ja mitte nii paindlikku UCS-2. Mõned distributsioonid, näiteks RedHat, on juba hakanud oma vaikekodeeringuna kasutama UTF-8, mistõttu ka sulle võiks huvi pakkuda argumendi utf8x tarvitamine paketi inputenc korral. + + + + &ucs;-pakett + Kui &ucs;-pakett ei ole paigaldatud, talita nii: + + &ucs;-paketi saab selle koduleheküljelt Unicode support for &latex;, mida haldab Karlsruhe ülikoolis tegutsev Dominique Unruh. + + Paigaldamiseks paki allalaaditud fail lahti ja paiguta see kataloogi, mis leidub keskkonnamuutujast $TEXINPUTS. Selle võib määrata ka Kiles. + + + + \usepackage{ucs} + \usepackage[utf8x]{inputenc} + + + + + + &cjk; toetus + + Ideograafiliste kirjade toetuse lisamine on üsna keerukas. Kui oled aga sellega hakkama saanud, peaks see täiesti korralikult töötama. Lisaks pakettide paigaldamisele tuleb siin ka üht-teist seadistada. + + Võimalik, et sinu Linuxi distributsioon on juba &cjk;-paketi valmis pakendanud, mis vähendab märgatavalt vaeva kõige käsitsi paigaldamisega võrreldes. Kontrolli seda kindlasti! + + Lühikeste &cjk;-tekstijuppide kirjutamiseks saab heal juhul kasutada ka &ucs;-paketti, aga see on tõesti väga piiratud, näiteks ei nii võimalik isegi reavahetusi korralikult määrata. Seepärast oleks mõttekas paigaldada täielik &cjk;-&latex;-pakett ja panna see tööle nii &latex; kui &pdflatex;i tarbeks. Suur osa siinsest tekstist on saanud innustust Pai H. Chou veebileheküljest &pdflatex;i häälestamise kohta. + + + + Laadi alla &cjk;-pakett. Kopeeri selle lahtipakitud failid $TEXMF vastavasse alamkataloogi täpselt nii, nagu see käib &ucs;-paketi puhul (vaata ). Failid pakitakse lahti kataloogi CJK/X_Y.Z. Neid ei ole oluline välja võtta, kuigi see muudab vahest hooldamise hiljem veidi vaevalisemaks. + + Nüüd tuleb alla laadida font, mis toetaks kõiki &cjk; sümboleid, mida sul vaja läheb. Sa võid valida igasuguse sobiva *.ttf-faili, kuid siinkohal on meil näiteks Cyberbit. Paki fail lahti ja nimeta Cyberbit.ttf ümber cyberbit.ttf, sest suured tähed võivad süsteemi segadusse ajada. + Paiguta cyberbit.ttf kataloogi koos failiga Unicode.sfd ning genereeri *.tfm- ja *.enc-failid käsuga $ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@. Vahel ei pruugi see mingil põhjusel tekitada ettenähtud sadu faile. Sellisel juhul võid alla laadida nii *.tfm- kui ka *.enc-failid. + Paiguta *.tfm-failid sobivasse kataloogi, näiteks $TEXMF/fonts/tfm/bitstream/cyberbit/. *.enc-failid võib paigutada näiteks kataloogi $TEXMF/pdftex/enc/cyberbit/. + + Nüüd läheb vaja seosefaili, mis ühendaks *.enc-failid fondiga. Laadi alla cyberbit.map ja paigalda see kataloogi $TEXMF/pdftex/config/. + + Laadi alla ka c70cyberbit.fd ja paiguta see sobivasse kataloogi, näiteks $TEXMF/tex/misc/. + + Lõpuks on meil vaja genereerida &postscript; Type 1 font, mida on tarvis &latex;iga tekitatud DVI-failide lugemisel. Käivita käsk $ ttf2pfb cyberbit.ttf -o cyberbit.pfb ja kopeeri saadud cyberbit.pfb sobivasse kataloogi, näiteks $TEXMF/fonts/type1/cyberbit/. + + Seame nüüd cyberbit.ttf fontide sekka, mida &latex; suudab leida ja kasutada. See tuleks paigutada kataloogi $TEXMF/fonts/truetype/. + + Kontrolli konfiguratsioonifaili $TEXMF/web2c/texmf.cnf ja veendu, et rida, kus seisab TTFONTS, oleks kommenteerimata ning osutaks kataloogile, kuhu salvestasid cyberbit.ttf. + + Et &pdflatex; saaks &cjk; fonte kasutada, tuleb lisada rida konfiguratsioonifaili $TEXMF/pdftex/config/pdftex.cfg. Lisa map +cyberbit.map faili ja &pdflatex; on seadistatud. + + &latex;i seadistamiseks, et see saaks tekitada &cjk; sümbolitega DVI-faile, tuleb lisada rida faili ttfonts.map. Fail võib asuda kataloogis $TEXMF/ttf2pk/, aga võib-olla ka mitte. Lisa sellesse rida cyberbit@Unicode@ cyberbit.ttf. + + Nüüd tuleb käivitada texhash ja süsteem peaks korras olema. + + + + Seadistuse testimiseks võid proovida kompileerida seda testfaili. + + + &cjk; probleemid + + &cjk; toetuse käsitsi lisamisel võib päris palju asju viltu minna. Kui see ei paista korralikult töötavat, võiks kontrollida järgmisi asju. + + + + On selge, et kui kasutada &latex;it kasutajana, mitte administraatorina (root), tuleb sul lubada ka tavalistele kasutajatele ligipääs uutele failidele. Kasuta käsku chmod ning kontrolli, et kõik kataloogid ja failid on selliste õigustega. + + Kui &latex; kirjutab DVI probleemideta, aga sa ei näe seda, on ilmselgelt midagi viga *.pk-fontide automaatse tekitamisega. Need peaks lennult loodama DVI-faili kuvamisel, aga see võib mitmel põhjusel ebaõnnestuda. Kontrolli kõigepealt üle faili ttfonts.map lisatud read. Samuti võib juhtuda, et käsk ttf2pk, mille DVI-näitaja tavaliselt välja kutsub, on kompileeritud ilma kpathsea teekide toetuseta. Sellisel juhul ei ütle käsk ttf2pk midagi kpathsea kohta. Et nende teekide toetus on hädavajalik, tuleks otsida uus pakett või kompileerida FreeType 1 ise uuesti. + + + + + + + + + Kuidas sisestada &cjk; Unicode'is? + + Sisendmootoreid on päris mitu ja valik sõltub rohkem sinu eelistustest. Käesoleva käsiraamatu autori lemmikuks on Skim, mis kujutab endast mootori Scim porti &kde; jaoks. Uuri oma distributsiooni dokumentatsioonist, kuidas neid programme paigaldada. Ka nende programmide seadistamine ei pruugi olla lihtne, näiteks Skimi puhul tuleb defineerida keskkonnamuutuja XMODIFIERS="@im=SCIM" enne X'i käivitamist. + + + + + + + + + + Skriptid + + + + Skriptid ja &kile; + + &kile;s skriptide kasutamise võimalus lubab käivita ECMAScripti koodi. Skripte saab hallata külgribal paikneval skriptipaneelil. + + + + + + API dokumentatsioon + + Selles osas kirjeldatakse &kile; skriptimise programmiliidest. + + + Arvesta, et skriptimise API ei ole veel lõplik. Allpool kirjeldatud API võib &kile; tulevastes versioonides muutuda. + + + Kõigepealt pakub &kile; skriptide käivitamise keskkond globaalse objekti "kile", millele kuuluvad järgmised meetodid: + + + + (kile).currentTextDocument() + + Tagastab KileTextDocument objekti, mis kajastab aktiivset tekstidokumenti. Tagastab null, kui ükski dokument pole aktiivne. + + + + (kile).getInputValue(caption, label) + + Avab määratud pealdise ja nimetusega akna. Tagastab kasutaja sisestatud väärtuse. + + + + + Objektid tüübiga KileTextDocument esindavad &kile; tekstidokumente. Neil on järgmised omadused: + + + + (KileTextDocument).backspace() + + Kustutab sümboli vahetult enne kursori asukohta ja viib kursori tekstis ühe positsiooni võrra tahapoole. + + + + (KileTextDocument).cursorLeft() + + Liigutab kursori tekstis ühe positsiooni võrra tahapoole. + + + + (KileTextDocument).cursorRight() + + Liigutab kursori tekstis ühe positsiooni võrra ettepoole. + + + + (KileTextDocument).insertText(text) + + Lisab muutujas text määratud teksti dokumenti kursori asukohas. + + + + (KileTextDocument).insertBullet() + + Lisab täpi dokumenti kursori asukohas. + + + + (KileTextDocument).nextBullet() + + Valib dokumendis esimese pärast kursori asukohta leiduva täpi. + + + + (KileTextDocument).previousBullet() + + Valib dokumendis viimase kursori asukohale eelneva täpi. + + + + (KileTextDocument).up() + + Liigutab kursori dokumendis ühe rea võrra ülespoole. + + + + (KileTextDocument).down() + + Liigutab kursori dokumendis ühe rea võrra allapoole. + + + + (KileTextDocument).cursorLine() + + Tagastab rea, milles kursor parajasti asub. + + + + (KileTextDocument).cursorColumn() + + Tagastab veeru, milles kursor parajasti asub. + + + + (KileTextDocument).setCursorLine(line) + + Liigutab kursori muutujaga line määratud reale. + + + + (KileTextDocument).setCursorColumn(column) + + liigutab kursori muutujaga line määratud veergu. + + + + + + + + + + + Abi + + + + Abiidokumendid + + &latex; on üpris keeruline süsteem, mille põhiomadusi saab laiendada väga suure hulga lisapakettidega. &kile; pakub kasutajale selles osas palju mitmesugust abi. + + + + + LaTeXi viited + Levinumate &latex;i käskude tähestikuline nimekiri. + + + + TeXi dokumentatsioon + &tetex;/&texlive;'iga on kaasas suur hulk dokumentatsiooni. Selle hulka kuuluvad kõigi kaasatud pakettide dokumentatsioon ning täiendavad &latex;i viited. + + + + LaTeX + Täielik &tex;i ja tema sõprade dokumentatsioon. Lisaks kõigi programmide kirjeldusele mainitakse ka mõningaid olulisemaid pakette. Lisaks sisaldab see täielikku &latex;i käskude käsiraamatut—ideaalne viis uurida teatud kindlat vormindamisvõtet dokumendi kirjutamise ajal. Et see dokumentatsioon on tõepoolest suur, jagab &kile; selle kolme olulisema järjehoidja vahel. + + + + LaTeXi käsk + Veel üks &latex;i levinumate käskude tähestikuline register. + + + + LaTeXi teema + Tähtsamate &latex;i teemade kirjeldus. + + + + LaTeXi keskkond + Levinumate &latex;i keskkondade tähestikuline register. + + + + + + + + + Kontekstitundlik abi + + &kile; toetab ka kontekstitundlikku abi, mille saab avada kiirklahviga &Ctrl;&Alt;H,K. Menüükäsuga SeadistusedKile seadistamine... KileAbi saab valida, kas kasutatakse &kile; &latex;i viiteid või &tetex;/&texlive;'i abisüsteemi, mis on ka vaikimisi valik. + + + Täpid + + + + + + Täpid + + + + + + + + + Võtmesõnade otsimine + + Alati pole lihtne leida õiget dokumenti, sest &tetex;/&texlive; pakub tõesti väga palju dokumentatsiooni. Ühe võimaliku abivahendina pakub &tetex;/&texlive; tillukest programmi texdoctk. See sisaldab kõigi dokumentide andmebaasi, millele &kile; pakub omalt poolt liidese. + + + Täpid + + + + + + Täpid + + + + + Kõik dokumendid on rühmitatud teatud kategooriatesse, mille peamine eelis on see, et saab otsida paketinimede või võtmesõnade järgi. &kile; näitab otsingu tulemusi. + + + Täpid + + + + + + Täpid + + + + + Hiirega topeltklõpsu tehes või klahvile Tühikuklahv vajutades käivitatakse antud dokumendi näitaja. See võib olla suvaline dokument, mitte tingimata DVI-, PS-, PDF- või HTML-dokument. &kile; kasutab sobiliku näitaja avamiseks &konqueror;i seadistusi. + + + + + + + Kasutaja määratud abi + + Lisaks staatilisele &tetex;/&texlive;'i dokumentatsioonile toetab &kile; ka veel üht muutuva loomusega kasutaja dokumentatsiooni meetodit. Menüüs Abi pakub &kile; spetsiaalset alammenüüd Kasutaja abi, kuhu kasutaja saab dokumente lisada omal valikul. Need võivad olla olulised &tetex;/&texlive;'i dokumentatsiooni osad või ka kasutaja enda kirjutatud dokumendid. Võimalik on valida isegi veebi-URL-e. + + Vali SeadistusedKile seadistamine... KileAbi ja klõpsa seal nupule Seadista, mis võimaldabki seadistada alammenüü Kasutaja abi sisu. Menüükirjeid saab lisada ja eemaldada, võib nende järjekorda muuta, samuti lisada eraldajaid, mis lubavad alammenüüd paremini liigendada. + + Klõpsuga nupule Lisa avaneb uus dialoog, kus saab muuta menüükirje nime ning valida vajaliku faili või veebi-&url;-i. Veebi-&url;-i valimisel käivitatakse &konqueror; ja sul tuleb vajalik &url; kopeerida. + + + Täpid + + + + + + Täpid + + + + + + + + + + + Autorid ja litsents + + &kile; on kasutajasõbralik vaba tarkvara &latex;/&tex; lähteteksti redaktor. See töötab süsteemides, kuhu on paigaldatud &kde; töölaua keskkond. &kde; on saadaval erinevate Linuxi ja muude UNIXi-laadsete süsteemide jaoks. &kile; on ka osa projektist Fink, mis tähendab, et &kile;t saab kasutada isegi Mac OS-X tingimustes! + + Suur tänu kuulub kõigile neile, kes on aidanud vedada &kile; projekti ja kulutanud arvukalt tunde arendusvahenditele, mida me kõik võime kasutada vastavalt GNU litsentsile. Värskeimat teavet kaasautorite kohta pakub dialoog &kile; info, mille saab avada menüüst Abi. + + Kaasautorid (paljude teiste seas): Rob Lensen, Roland Schulz, Michael Margraf, Holger Danielsson + + Suur tänu kõigile kaasalöönutele! +&underFDL; &underGPL; + + +&documentation.index; + + diff --git a/doc/it/Makefile.am b/doc/it/Makefile.am new file mode 100644 index 0000000..7505c93 --- /dev/null +++ b/doc/it/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = it +KDE_DOCS=kile diff --git a/doc/it/index.docbook b/doc/it/index.docbook new file mode 100644 index 0000000..43e776d --- /dev/null +++ b/doc/it/index.docbook @@ -0,0 +1,6098 @@ + +Kile"> + ATEX"> + ATEX"> + EX"> + teTEX"> + TeX Live"> + EX"> + + EX"> + + + ImageMagick"> + KDE"> + KDVI"> + dvipng"> + KGhostView"> + KPDF"> + PostScript"> + makeidx"> + Kate"> + CJK"> + ucs"> + URL"> + + + + +]> + + + + +Manuale di &kile; + + + JonathanPechta + FedericoZenith
zenith@chemeng.ntnu.no
 + HolgerDanielsson
holger.danielsson@versanet.de
 + ThomasBraun + MichelLudwig
michel.ludwig@kdemail.net
 + + +Federico Zenith
zenith@chemeng.ntnu.no
 Traduzione della documentazione in italiano + + +2003 +Jonathan Pechta + + + +200320052006 +Federico Zenith + + + +20052006 +Holger Danielsson + + + +2007 +Thomas Braun + + + +2007 +Michel Ludwig + + +November 19, 2007 +2.0 + + +&FDLNotice; + + + +&kile; è un editor di sorgenti e shell di &tex; e &latex;,. + + + +KDE +kdenonbeta +Kile +LaTeX +TeX + + + + + + +Prefazione + + + + Requisiti + + Per eseguire &kile;, ti sarà necessario avere i seguenti componenti installati sulla tuo sistema: + + + Ambiente desktop &kde;: &kde; è un popolare ambiente desktop open source. + Qt: Qt è una libreria per interfacce e di rete in C++ necessario per compilare &kile;. + &latex;: programma tipografico di alta qualità. Quasi sicuramente ti servirà il pacchetto &texlive; (o sui sistemi più vecchi &tetex;), se sei su un sistema di tipo Unix. + + + La maggior parte di questi elementi potrebbero essere inclusi nella tua distribuzione Linux; per piacere riferisciti alla documentazione della tua distribuzione, o riferisciti al tuo CD o DVD di installazione per aggiungere questi pacchetti sul tuo sistema. + + Il progetto &kile; include diversi pacchetti binari di &kile; per diverse distribuzioni che possono essere facilmente installati e avviati senza bisogno di compilazione; controlla la homepage di &kile;. + + + + + + Pubblico + + Questo manuale è pensato per chiunque, indipendentemente dalla sua esperienza con &latex;, &kde;, &kile; o Linux. + + Gli utenti avanzati probabilmente non leggeranno questo manuale, ma tutti i suggerimenti saranno presi in considerazione. Se volessi contribuire a questo progetto o alla documentazione, per piacere consulta la pagina web di &kile;. + + Hai bisogno di risposte su &kile;? Sei bloccato con una compilazione? Vuoi una funzione nuova? Il modo migliore di fare domande tecniche o avviare una discussione è usare la nostra mailing list: kile-devel@lists.sourceforge.net. + + + + + + + + Introduzione + + + + Fatti di base + + + + Informazioni su &kile; + + &kile; è un ambiente &latex; integrato per il desktop &kde;. &kile; ti dà la possibilità di usare tutte le funzionalità di &latex; in un'interfaccia grafica, dandoti un accesso facile, immediato, e personalizzato a tutti i programmi relativi a &latex;, il postprocessing, il debugging, la conversione e la visualizzazione; hai a disposizione anche degli assistenti molto comodi, un riferimento &latex;, e una potente gestione dei progetti. + + + + + + Cos'è &latex; + + &latex; è un sistema di trattamento testi derivato da &tex;, un programma sviluppato originariamente nel 1977 da Donald Knuth per aiutarlo a presentare il suo lavoro professionalmente, ottenendo un lavoro simile a quello di un tipografo; il tipografo è colui che imposta l'aspetto di un documento a seconda delle specifiche del tipo di documento. &latex; è stato creato da Leslie Lamport per dare agli autori un tipografo automatico, specialmente per quanto riguardava la costosa e complicata tipografia delle formule e delle espressioni matematiche, che assolutamente non per caso sono racchiuse da segni del dollaro in &latex;. Oggi, i programmi di trattamento testi permettono a ogni utente di essere il tipografo; ma ciò di cui tu hai bisogno è un bel documento, non uno su cui hai speso ore per renderlo bello. &latex; si fa carico di questo compito, e ti lascia pensare al documento, non alla tipografia. E, sì, sarà bello! + + + + + + Come si pronuncia? Perché si scrive così strano? + + C'è una buffa tradizione per la quale i pacchetti relativi a &tex; hanno la pronuncia e la grafia più strane possibile. Si suppone che &tex; sia arrivato dal greco τεχ, in lettere latine tech. Ci sono molte spiegazioni possibili sul perché, ma la più probabile è che &tex; fu originariamente concepito per i rapporti tecnici, e infatti la sua abilità principale era la scrittura facile e corretta delle formule matematiche, ai tempi un affare estremamente costoso, tedioso e frustrante. + La pronuncia dovrebbe essere come segue: TE come in italiano, e X come nel tedesco ich. Se non sai come suona ch, è più o meno come il suono di un gatto che soffia; il simbolo IPA è /ç/. Molte persone sostengono la diversa pronuncia di ach (simbolo IPA /x/), ma ho personalmente chiesto a dei greci, e posso confermare la prima versione. Dovresti sapere che molti pronunciano erroneamente /teks/ o /tek/. + Infine, in &latex; la parte LA è pronunciata come l'inglese lay (profano): l'idea è che, mentre il &tex; grezzo è difficile, anche un profano può usare le macro di &latex;. Una spiegazione meno suggestiva ma più realistica è che venga dal cognome di Leslie Lamport, il creatore di &latex;. Adesso lo sai! + + + + + + + + Fondamenti di &latex; + + Il sistema di tipografia di &latex; è simile ad altri linguaggi a marcatori come l'XML, usato per molti tipi di documenti (incluso quello che stai leggendo), o l'HTML, usato per le pagine web. L'idea generale è avere parole chiave impacchettate in modo particolare, dette tag, che dicono a un programma (un elaboratore di testi, un browser web, o il compilatore &latex;) come presentare il testo. &kile; ti offre un buon numero di questi tag nel menu LaTeX nella barra dei menu. + + Sebbene proveremo a darti una buona idea di cosa sia &latex;, questa non è La Bibbia Definitiva di &latex;. Se vuoi imparare &latex; bene, potresti prendere un libro nella tua biblioteca. L'autore ha avuto una buona esperienza con il testo A Guide to &latex;, di H. Kopka e P. W. Daly, e lo tiene ancora sullo scaffale. + + Come altri linguaggi a marcatori, &latex; contiene un preambolo, che imposta i comandi globali, come la dimensione della carta, la numerazione delle pagine, le dimensioni del testo sulla pagina, e un corpo, che contiene il testo del documento; il preambolo contiene almeno il comando \documentclass, e precede il corpo, che inizia con il comando \begin{document}, ed è piuttosto prevedibilmente concluso dal comando \end{document}. + + + + + + Funzionalità principali di &kile; + + + + Assistente di avvio rapido + + L'assistente di avvio rapido integrato in &kile; è una utile funzione per iniziare rapidamente a creare documenti con &kile;. Scegliendo l'assistente dalla barra dei menu ti verranno offerte varie scelte per la creazione del tuo documento. Puoi anche specificare subito alcune opzioni relative al documento. + + Opzioni della classe: + + + Tipo del documento: scegli il tipo di documento che vuoi creare: articolo, libro, lettera, rapporto, presentazione Beamer o altri tipi, inclusi quelli che potresti aver definito tu. + Dimensione caratteri: dì a &kile; quale dimensione dei caratteri (in punti) vuoi usare. + Dimensione carta: scegli le dimensioni o lo stile della carta. + Codifica: in genere è una buona idea usare la codifica predefinita del tuo sistema. I sistemi più recenti tendono ad adottare UTF-8 come codifica predefinita. Se puoi, usa utf8x (che è davvero scritto così per i documenti &latex;). + Altre opzioni: questo ti permette di impostare ulteriori opzioni per la stampa, le bozze, e altro. + + + Pacchetti + Questo elenca i pacchetti aggiuntivi più comuni usati in &latex;. Seleziona le caselle per includerli. + + Proprietà dei documenti + + Autore: metti qui il tuo nome. + Titolo: aggiungi qui il titolo del documento. + Data: specifica qui la data. + + + + + + + Modelli predefiniti + + I modelli predefiniti in &kile; sono: + + + Documento vuoto: gli uomini veri partono da zero! + Articolo: imposta il formato articolo, per un documento abbastanza breve da non aver bisogno di essere diviso in capitoli. + Rapporto: imposta il formato rapporto, per documenti di media grandezza, con per esempio la numerazione delle pagine sul margine esterno. + Libro: imposta il formato libro, una versione full optional, così potente da essere usata per scrivere molti testi universitari. + Lettera: imposta il formato lettera, che può automaticamente sistemare quelle noiose indentazioni che nessuno riesce a ricordare. + Beamer, HA-Prosper: crea delle presentazioni di alta qualità in formato PDF con tutte le potenzialità di &latex;. + Scrartcl,Scrbook,Scrreprt,Scrlttr2: le classi di documenti KOMA-Script, particolarmente adatte alla tipografia tedesca. Utili soprattutto per testi in tedesco. + + + I nuovi utenti non si devono preoccupare, queste sezioni sono solo una breve descrizione delle funzionalità, e maggiore attenzione sarà data al completamento nei dettagli di questi obiettivi in . + + + + + + Evidenziazione della sintassi + + &kile; è simile ai programmi che lavorano con codice sorgente, ed evidenzierà automaticamente comandi, opzioni ed elementi, usati e abusati. &kile; rende così possibile avvistare facilmente i problemi: per esempio, se vedi grosse aree di testo verde, è probabile che tu abbia dimenticato di chiudere un ambiente matematico da qualche parte; te ne saresti accorto comunque da quanto scadente sarebbe stato il file di output, ma l'evidenziazione ti risparmia un bel po' di tempo e frustrazioni. + + + + + + Autocompletamento degli ambienti + + L'autocompletamento degli ambienti significa che quando inizi un nuovo ambiente scrivendo \begin{ambiente}, &kile; aggiungerà automaticamente un comando \end{ambiente}, con una riga in mezzo per il tuo testo. Puoi ovviamente disattivarlo, se vuoi, in ImpostazioniConfigura Kile...LaTeXAmbienti. + + + + + + Saltare agli elementi struttura + + Tutti i documenti normalmente sono strutturati con una gerarchia di qualche tipo. &latex; ti permette di spezzare i documenti nella gerarchia seguente (part è l'elemento più alto della gerarchia, e subparagraph il più basso): + + + \part + \chapter + \section + \subsection + \subsubsection + \paragraph + \subparagraph + + + Quando guardi un documento nella vista Struttura, puoi saltare tra gli elementi facendo clic sull'elemento che vuoi vedere. + + + + + + Ricerca all'indietro + + Quando crei i tuoi file &latex;, la ricerca all'indietro può essere molto utile. Una volta che hai creato un file &DVI; (DeVice Independent File, file indipendente dal dispositivo), puoi far clic con il pulsante centrale del mouse nel visore &DVI;, e &kile; salterà alla riga corrispondente nel codice sorgente &latex;. + + Un &DVI; è un tipo di file contenente una descrizione di un documento formattato, insieme ad altre informazioni, incluso il tipo di carattere, e oltre al PDF è l'output tipico di &tex;/&latex;. Esiste un certo numero di programmi per visualizzare, convertire e stampare file &DVI; su vari sistemi e dispositivi. + + + + + + Ricerca in avanti + + Usando la ricerca all'indietro, la selezione di elementi nei file &DVI; è associata all'editor, così quando fai clic sul file &DVI;, la finestra principale salta alla sezione corrispondente di codice &latex; nell'editor. La ricerca in avanti ne è l'esatto opposto. La ricerca in avanti ti permetterà di fare clic su una sezione di testo specifica nel codice &latex;, e saltare alla posizione associata nella finestra del visore &DVI;. + + + + + + + + La barra degli strumenti + + + Nuovo: inizia un nuovo documento. + Apri: apri un nuovo documento. + Chiudi: chiudi il tuo documento. + Definisci il documento come documento principale: questo si usa lavorando con file multipli. Avere un documento principale ti permetterà di lavorare più facilmente con altri file .tex inclusi nel tuo documento. Se stai usando i progetti, puoi anche impostare un documento principale per tutto il progetto in ProgettoOpzioni del progetto. + Costruzione rapida: compila il tuo codice sorgente &latex; e ne mostra i risultati automaticamente, a meno che ci siano errori nel codice. + Sorveglia file: questa modalità sorveglierà eventuali cambiamenti del file &DVI;, e non avvierà una nuova finestra di &kdvi; dopo una Costruzione rapida. + Visualizza file di log: visualizza il file .log, per avvistare gli errori. + Errore precedente: salta all'indietro nel file .log ed evidenzia gli errori nel sorgente. + Errore successivo: salta in avanti nel file .log e evidenzia gli errori nel sorgente. + Ferma: ferma lo strumento attuale. + LaTeX: esegue &latex; sul documento attivo. + Visualizza DVI: avvia il visore &DVI;. + Da DVI a PS: converte un file DVI in un &postscript; (PS). + Visualizza PS: avvia il visore &postscript; (PS). + PDFLaTeX: esegue &pdflatex; sul documento attivo. + Visualizza PDF: avvia il visore PDF. + Da DVI a PDF: converte un DVI in un PDF. + Da PS a PDF: converte un PS in un PDF. + Visualizza HTML: visualizza l'HTML creato. + Ricerca Kdvi in avanti: salta alla pagina che corrisponde alla riga attuale nell'editor. + + + Se guardi la barra degli strumenti Modifica, noterai tre grandi menu a cascata. I menu a cascata sono stati progettati per farti rapidamente aggiungere certe funzionalità comuni nel tuo documento. Il primo menu a cascata è usato per dividere rapidamente il tuo documento in parti, capitoli, sezioni, e così via; i comandi disponibili per aggiungere segmenti al tuo codice sorgente &latex; sono: + + + part: livello massimo di sezionamento per un documento. + chapter: inizia un nuovo capitolo. + section: crea una nuova sezione. + subsection: crea una nuova sottosezione. + subsubsection: una sezione secondaria tra sottosezione e paragrafo. + paragraph: crea un nuovo paragrafo. + subparagraph: crea un nuovo sottoparagrafo. + + + Il menu a cascata chiamato label è usato per inserire nel tuo documento elementi come indici, note a pie' di pagina, referenze. I comandi disponibili sono: + + + label: un comando che produce un un'etichetta per un capitolo, una figura o altro elemento. + index: crea una voce per l'indice. + footnote: crea una nota a pie' di pagina nel tuo documento. + ref: usato per riferirsi a un'etichetta già definita, che scegli da una lista a cascata. + pageref: proprio come ref, ma si riferisce a una pagina invece che a un elemento della struttura. + cite: crea un riferimento con dati da una bibliografia. + cita da vista BibTeX: chiedi tutte le referenze selezionate allo strumento di visualizzazione di BibTeX e inseriscile. Attualmente è disponbile solo con &kbib; come strumento di visualizzazione di BibTeX. + + + + Il menu a cascata label + + + + + + Il menu a cascata label + + Il menu a cascata label + + + + + Selezione dell'etichetta di una referenza + + + + + + Selezione dell'etichetta di una referenza + + Selezione dell'etichetta di una referenza + + + + Usando cite, ti viene presentata una lista a cascata di bibitem, ma se stai usando &bibtex; ciò funzionerà solo se il file appartiene a un progetto. Per modificare i file &bibtex; si raccomanda l'uso di un programma apposito. L'autore ha buona esperienza con l'uso di &kbibtex; e &kbib;. Ovviamente puoi anche scrivere i file &bibtex; a mano all'interno di &kile;. + + L'ultimo menu a cascata, etichettato tiny, è usato per impostare la dimensione del tuo testo. Hai la possibilità di impostare la dimensioni di testo, note a pie' di pagina, e così via; i comandi disponibili sono: + + + tiny: piccolissimo. + scriptsize: molto piccolo. + footnotesize: più piccolo. + small: piccolo. + normalsize: normale. + large: grande. + Large: più grande. + LARGE: ancora più grande. + huge: molto grande. + Huge: grandissimo. + + + + + + + + Avvio rapido + + + + Stesura di un documento &latex; con &kile; per principianti + + Gli utenti di &kile; hanno due scelte quando cominciano un nuovo documento: possono usare l'Assistente per cominciare un nuovo documento, selezionare il tipo di documento che vorrebbero creare, e opzioni come la dimensione dei caratteri, della carta, e così via; altrimenti, possono scrivere il codice a mano. + + + \documentclass[12pt]{article} + \begin{document} + Qui c'è un pacco di codice \LaTeX. + \end{document} + + Ogni documento &latex; comincia con il comando \documentclass[argomento opzionale]{classe}, dove la classe specifica il tipo di documento. + + Inserire l'esempio di codice della casella di testo sopra ti restituirà il seguente output: + + + Testo compilato nell'output DVI + + + + + + Testo compilato nell'output DVI + + Testo compilato nell'output DVI + + + + Le parentesi quadre che vengono dopo il comando \documentclass contengono le opzioni del commando. L'opzione [12pt] imposta la dimensione dei caratteri per il tuo articolo; se non imposti la dimensione dei caratteri all'inizio, la puoi impostare più avanti nel testo. + + Una volta che hai inserito l'esempio di codice dalla casella sopra, dovrai compilare il tuo codice &latex;. Il modo più facile per compilare &latex; è usare il menu Costruzione, o usare il pulsante Costruzione rapida. + + &Alt;2 è la scorciatoia da tastiera per compilare il tuo codice sorgente. + + Devi salvare il tuo codice sorgente prima di poter compilare; &kile; lo farà automaticamente per te. + + Se il tuo documento non è stato compilato correttamente, controlla se ci sono errori nel log. Usando il pulsante Costruzione rapida, il visore &kdvi; dovrebbe essere avviato automaticamente; altrimenti, controlla il log. + + + + + Ambienti + + Un ambiente è un segmento di testo gestito diversamente dal resto del tuo documento. Per esempio, crei un rapporto con dimensione dei caratteri pari a 12, ma hai bisogno di cambiare la dimensione dei caratteri per poche frasi. I comandi \begin{ambiente}, \huge and \end{ambiente} ti permetteranno di alterare temporaneamente il testo all'interno dei comandi ambiente affinché il testo sia di dimensione molto grande. + + I cambiamenti hanno effetto da \begin{ambiente} a \end{ambiente}. Non ci sono limiti a quanti cambiamenti puoi fare all'interno di un ambiente. + + Ci sono molte funzioni che puoi aggiungere al tuo documento che lo renderanno più leggibile e semplice. Puoi aggiungere al tuo documento oggetti come tipi di carattere specifici, grassetto, corsivo, sottolineato, ecc., e questi comandi si concluderanno o con un comando \end, o alla fine del tuo ambiente. + + + \begin{emph}: questo comando scrive il testo in corsivo, ed è valido finché il codice non raggiunge un \end{emph} o un altro ambiente. Per rendere una parola in corsivo in una frase, puoi usare la sintassi: questa è la \emph{mia} frase. + \textbf{Sto scrivendo questo testo all'interno delle parentesi in grassetto}: questo comando scrive il tuo testo in grassetto. + \quote: per creare una citazione all'interno del tuo documento; inizia la tua citazione \begin{quote} e finiscila con \end{quote}. + \center: centra il testo. + \verse: crea un'indentazione adatta alla poesia. + \itemize: fai una lista di oggetti. + + + + + + + Uso di &kile; + + Adesso che ti abbiamo dato un'infarinatura su come scrivere codice usando il linguaggio &latex;, ti mostreremo come creare un documento passo-passo usando &kile;. + + + Avvia &kile;. + Scegli AssistenteAvvio rapido, quindi scegli un formato, e imposta le tue preferenze nell'assistente. + Una volta che l'assistente avrà inserito del testo, fai un po' di personalizzazione per rendere il documento più leggibile, aggiungi almeno una citazione, del testo in grassetto, corsivi, e un verso per vedere le differenze tra i comandi. + Salva il tuo file, e dagli il nome intro.tex. + Compila il tuo file usando &Alt;2, o il pulsante etichettato LaTeX. + Seleziona Visualizza DVI. + Controlla tutto il tuo testo nuovo. + Quando hai finito di guardare il documento, fai clic sul pulsante Vista editor o premi &Ctrl;E per ritornare all'editor se stai usando il visore integrato, o chiudi la finestra del visore se stai usandone uno separato. + + + Ecco fatto! Hai appena creato il tuo primo documento &latex;! + + Una volta che hai creato il tuo DVI, potrai stampare il tuo documento, o cambiarlo in un file &postscript; o PDF, se vuoi. Sperimenta e divertiti! + + + + + + File DVI + + DVI significa file indipendente dal dispositivo (DeVice Independent). Questi file sono prodotti da &tex; o &latex; per essere letti da un driver sul tuo sistema. Ci sono molti tipi diversi di output a cui si può inviare un .dvi, come una stampante, un convertitore a file &postscript; o PDF, o lo schermo del tuo computer. + + + + Visualizzare un DVI + + Hai già visto come visualizzare un file DVI su schermo usando il pulsante Visualizza DVI nella barra degli strumenti. + + + + + + Stampare un DVI + + Per stampare un DVI, puoi usare lo stesso processo che hai usato per creare il tuo documento prima (vedi ). Al passo 7, dopo aver fatto clic su Visualizza DVI, seleziona FileStampa nel visore, e se hai configurato correttamente la tua stampante, potrai stampare il file DVI. + + + + + + Convertire i file &DVI; + + La barra degli strumenti dà la possibilità di convertire un DVI ad altri formati. Una volta che hai creato un DVI dal tuo codice sorgente &latex;, potrai esportarlo in un formato di tua scelta usando i pulsanti della barra degli strumenti. + + + + + + + + Ricerche in avanti tra &kile; e &kdvi; + + Le funzioni di ricerca in avanti ti permettono di passare direttamente dall'editor alla posizione associata del file &DVI;. + &kile; offre di configurare questa opzione per tutti i file binari &latex;. Vai a ImpostazioniConfigura Kile...StrumentiCostruzione e scegli sempre la configurazione Moderna. + + Per eseguire una ricerca in avanti, metti il cursore su una riga di codice sorgente, e fai clic su Ricerca in avanti di Kdvi per saltare alla posizione associata nella finestra del visore DVI. + + + + + Ricerche all'indietro tra &kile; e &kdvi; + + La ricerca inversa è una funzionalità utile quando scrivi un documento &latex;. Se tutto è a posto, puoi fare clic nella finestra di &kdvi; con il &MMB; (su alcuni sistemi, quando non hai un mouse a tre pulsanti, puoi usare contemporaneamente i pulsanti sinistro e destro). Dopodiché, &kile; caricherà il file sorgente &latex; e salterà al paragrafo giusto. Per usare la ricerca all'indietro, devi compilare il file di &latex; con la configurazione Moderna. + + La ricerca all'indietro non può funzionare a meno che: + + + Il file sorgente sia stato compilato correttamente. + &kdvi; sappia quale editor vuoi usare. + + + Con questa funzionalità di &kdvi;, un clic sul pulsante centrale del mouse nel documento &DVI; farà aprire a &kile; il documento &latex; corrispondente, e gli farà cercare di raggiungere la riga corrispondente. Ricordati di dire a &kdvi; di usare &kile; come editor di testo, nell'elemento del menu ImpostazioniOpzioni DVI.... + + + Configurazione di &kdvi; + + + + + + Configurazione di &kdvi; + + Configurare &kdvi; + + + + + + + Risolvere gli errori + + Se stai cercando di usare la Costruzione rapida, e il visore DVI non si apre, è probabile che ci sia un errore. Se c'è un errore, è visibile nell'area dei messaggi e del file di log, e verrà presentato un riassunto degli errori. + + Il file di log spiegherà l'origine dell'errore nel tuo codice. Nell'editor, puoi usare i pulsanti nella barra degli strumenti etichettati Errore LaTeX precedente e Errore LaTeX successivo per saltare avanti e indietro tra gli errori. Il file di log dichiara sempre in quale riga è occorso l'errore. Per vedere la riga dove è avvenuto l'errore, fai clic sull'errore nella finestra del log, e &kile; ti porterà alla riga dell'errore. + + + + + + + Iniziare un nuovo documento + + Quando fai clic sul pulsante nella barra degli strumenti per cominciare un nuovo documento, appare una finestra, che ti chiede quale tipo di modello vorresti usare per scrivere il tuo documento. Le scelte predefinite sono: + + + Documento vuoto + Articolo + Beamer + Libro + HA-Prosper + Lettera + Rapporto + Scrartcl (dal pacchetto di script KOMA) + Scrbook (dal pacchetto di script KOMA) + Scrlttr2 (dal pacchetto di script KOMA) + Scrreprt (dal pacchetto di script KOMA) + + + Se hai selezionato un Documento vuoto, puoi o iniziare a scrivere un documento da zero, o puoi usare l'assistente per iniziare rapidamente un nuovo documento (vedi ). + + + + + Modelli + + Gli utenti frequenti di &latex; usano tipicamente lo stesso preambolo per quasi ogni documento che usano. Si possono creare, salvare e caricare modelli all'interno di &kile; per facilitare l'inizio di un nuovo documento. + + + + Crea un nuovo modello + + Per creare un nuovo modello, devi prima o aprire un file &tex; / &latex;, o crearne uno da te. &kile; può generare un modello da un documento esistente aprendo il documento desiderato e selezionando FileCrea modello da documento. + + + + + + Configurazione delle sostituzioni automatiche + + Nella creazione di un nuovo documento selezionando un modello da FileNuovo, certe combinazioni di caratteri saranno sostituite da dati come il tuo nome, o la codifica che stai usando. Queste variabili possono essere configurate in ImpostazioniConfigura Kile...ImpostazioniGenerale. + + Nella stesura del tuo modello, è utile sapere quali combinazioni di caratteri sono sostituite da quali variabili dei modelli: + + + $$AUTHOR$$: Questa stringa sarà rimpiazzata dalla variabile autore. + $$DOCUMENTCLASSOPTIONS$$: Questa stringa sarà sostituita dalla variabile opzioni del tipo di documento. Tipicamente viene usato come di seguito: \documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}. + $$INPUTENCODING$$: Se la variabile codifica è impostata, per esempio, a latin1 questa stringa è rimpiazzata da \input[latin1]{inputenc}. + + + + + + + Crea modelli con l'assistente + + Il modo più semplice di creare un nuovo modello è partire con l'assistente, e poi aggiungere comandi nell'editor. Una volta che il documento è impostato come vuoi: + + + Salva il tuo file; + Vai a File; + Scegli Crea modello dal documento; + Fai qualsiasi correzione necessaria al modello; + Inserisci un nome per il tuo nuovo modello; + Fai clic su OK per aggiungere il tuo modello al menu. + + + La prossima volta che inizierai un documento, potrai scegliere il tuo modello personalizzato invece dei predefiniti. + + + + + + Creare un modello da un file qualsiasi + + Un modello può essere creato da qualsiasi file &latex;. Se stai cercando un modo facile per configurare un modello, vai a cercarne uno che ti piaccia su Internet e segui gli stessi passi elencati in . + + Per esempio, potresti voler creare un perfetto poster A0. Questi poster si vedono regolarmente alle conferenze scientifiche, e &latex; ti aiuterà a fare un poster accattivante e interessante. Puoi ottenere un modello per poster A0 alla home page di Jonathan Marchini, ma ce ne sono molti altri disponibili. Ricorda che avrai bisogno del pacchetto a0poster, che normalmente non è incluso in nelle installazioni &tex; standard. Scaricalo da qui e mettilo nella stessa cartella del tuo file &latex;. + + + + + Rimuovere un modello + + Per rimuovere un modello da &kile;, fai come segue: + + + Vai a FileRimuovi modello...; + Apparirà un riquadro con elencati tutti i modelli: seleziona un modello; + Fai clic su OK, e il tuo modello sarà rimosso. + + + I modelli segnati con un asterisco (*) non possono essere rimossi senza i permessi appropriati. + + + + + + + + + Modificare i documenti &latex; + + L'editor interno che &kile; usa è Kate. Kate è un editor di testo creato per programmatori, che include la capacità di leggere ed evidenziare molti tipi diversi di file di testo, tra cui &latex; e &bibtex;; puoi accedere a molte opzioni di &kate; direttamente dal menu Strumenti di &kile;. + + Per saperne di più su &kate; e sulle sue possibilità, vedi il manuale di Kate. Gli utenti di &kile; possono iniziare a leggere dal capitolo Lavorare con l'editor Kate. + + + + Il riferimento &latex; + + &kile; include un riferimento &latex; molto pratico, cui puoi accedere attraverso AiutoRiferimento LaTeX. Contiene una descrizione completa di quasi tutti i comandi che userai in &latex; e la loro sintassi. + + + + + + Movimenti del cursore + + Per selezionare del testo, hai le seguenti possibilità: + + + Tieni premuto il pulsante sinistro del mouse, e trascina per evidenziare del testo. + Fai clic una volta su una parola per muovervi il cursore. + Fai clic due volte su una parola per selezionare l'intera parola. + Fai clic due volte su una parola e premi &Ctrl; per selezionare tutta la parola &tex;. Ciò vuol dire che fare clic in questo modo su \par in \par\bigskip seleziona solo \par. + Fai clic tre volte per selezionare l'intera frase. + + + Mantenere premuto il pulsante sinistro del mouse, e trascinare sul testo che vuoi selezionare, copia automaticamente il testo selezionato negli appunti. + + Mantere premuto shift e usare i tasti freccia ti permette di selezionare porzioni del codice sorgente nella finestra dell'editor. + + + + + + Parentesi + + Il completamento delle parentesi è uno strumento visuale che la vista editor usa per indicare quali parentesi corrispondono a quali. Se apri un qualsiasi file .tex, e selezioni delle qualsiasi parentesi, siano esse tonde (), quadre [] o graffe {}, l'editor evidenzierà la parentesi e la sua corrispondente in giallo (questo colore predefinito può essere cambiato). Quindi, per esempio, se posizionassi il cursore sulle graffe di \section{Introduzione}, vedresti \section{Introduzione} nell'evidenziazione gialla predefinita, mostrandoti la posizione delle parentesi iniziale e finale. + + + + + + Evidenziazione + + &kile; ha la capacità di cercare ed evidenziare diversi tipi di codice. Per esempio, i comandi &latex; sono distinti dal testo normale, e anche le formule matematiche sono evidenziate in un colore diverso. + + + + + + Punti + + Molti assistenti possono inserire punti opzionali, una specie di segnalibro nel testo. Le voci del menu ModificaPunti, o le scorciatoie da tastiera corrispondenti, ti permetteranno di saltare al punto successivo o al precedente. Ciò evidenzierà il punto, in modo che sia eliminato automaticamente quando inserisci la prima lettera. + + + Punti + + + + + + Punti + + + + + + + &Ctrl;&Alt;Destra Punto successivo + Passa al punto successivo, se ce n'è uno. + + + &Ctrl;&Alt;Sinistra Punto precedente + Passa al punto precedente, se ce n'è uno. + + + + + + + + + Selezione + + Scrivere è ovviamente uno degli aspetti principali quando si usa un programma come &kile;. Sebbene &kate; abbia già grandi capacità, &kile; aggiunge alcune importanti funzionalità, che sono particolarmente utili quando si scrive un sorgente &latex;. &latex; ha sempre bisogno di molti ambienti e gruppi, perciò &kile; supporta comandi molto speciali per selezionarli. Sotto ModificaSeleziona troverai i seguenti comandi per selezionare il testo. + + + Elementi di Modifica->Seleziona + + + + + + Elementi di Modifica->Seleziona + + + + + + &Ctrl;&Alt;S E Ambiente (dentro) + Seleziona un ambiente, senza i tag che lo delimitano. + + + &Ctrl;&Alt;S F Ambiente (fuori) + Seleziona un ambiente, compresi i tag che lo delimitano. + + + &Ctrl;&Alt;T T Gruppo TeX (dentro) + Seleziona un gruppo TeX dentro le graffe che lo delimitano. + + + &Ctrl;&Alt;T U Gruppo TeX (fuori) + Seleziona un gruppo TeX insieme alle graffe che lo delimitano. + + + &Ctrl;&Alt;S M Gruppo matematico + Seleziona il gruppo matematico attuale insieme ai comandi matematici. + + + &Ctrl;&Alt;S P Paragrafo + Seleziona un intero paragrafo, cioè un gruppo di righe di testo separate su ambo i lati da righe vuote. Un paragrafo non vuol dire solo righe contigue di testo, come in altri editor di testo. Questo significato esteso include anche le tabelle, i comandi &latex; e tutte le altre righe del sorgente. L'unica cosa importante per &kile; è che questo tipo di paragrafo sia separato da due righe vuote. + + + &Ctrl;&Alt;S L Riga + Seleziona la riga di testo alla posizione attuale del cursore. + + + &Ctrl;&Alt;S W Parola TeX + Seleziona la parola alla posizione attuale del cursore. Questa selezione ha anche un significato esteso, perché il comando può anche selezionare i comandi &latex;, che cominciano con una sbarra inversa e possono avere un asterisco opzionale alla file. + + + + + + + + + Elimina + + Per eliminare alcune parti di un documento puoi, ovviamente, selezionarle e usare il tasto Canc. &kate; ha anche il comando &Ctrl;K, che cancella tutta la riga. Però &kile; ha un modo più veloce con i suoi comandi di eliminazione. Sotto ModificaElimina troverai i seguenti comandi per eliminare il testo. + + + Elementi di Modifica->Elimina + + + + + + Elementi di Modifica->Elimina + + + + + + &Ctrl;&Alt;T E Ambiente (dentro) + Elimina un ambiente senza i tag che lo delimitano. + + + &Ctrl;&Alt;T F Ambiente (fuori) + Elimina un ambiente compresi i tag che lo delimitano. + + + &Ctrl;&Alt;T T Gruppo TeX (dentro) + Elimina un gruppo TeX dentro le graffe che lo delimitano. + + + &Ctrl;&Alt;T U Gruppo TeX (fuori) + Elimina un gruppo TeX insieme alle graffe che lo delimitano. + + + &Ctrl;&Alt;T M Gruppo matematico + Elimina il gruppo matematico attuale insieme ai comandi matematici. + + + &Ctrl;&Alt;T P Paragrafo + Elimina un intero paragrafo. Vedi il comando SelezionaParagrafo per come viene definito un paragrafo in &kile;. + + + + &Ctrl;&Alt;T I Alla fine della riga + Elimina il testo dalla posizione attuale del cursore fino alla fine della riga. + + + &Ctrl;&Alt;T W Parola TeX + Elimina una parola o comando &latex; alla posizione attuale del cursore. + + + + + + + + + Ambiente + + È già stato detto che gli ambienti sono un punto centrale di &latex;. Perciò &kile; offre altri cinque comandi per rendere il lavoro con &latex; il più facile possibile nei sottomenu ModificaAmbiente. + + + Elementi di Modifica->Ambiente + + + + + + Elementi di Modifica->Ambiente + + + + + + + &Ctrl;&Alt;E B Vai all'inizio + Questo comando passerà all'inizio dell'ambiente attuale, ovunque tu sia. Il cursore sarà posizionato direttamente davanti al tag di apertura dell'ambiente. + + + &Ctrl;&Alt;E E Vai alla fine + Questo comando passerà alla fine dell'ambiente attuale, ovunque tu sia. Il cursore sarà posizionato direttamente dietro al tag di chiusura dell'ambiente. + + + &Ctrl;&Alt;E M Corrispondente + Quando il tuo cursore viene messo davanti o sopra il tag \begin{ambiente}, sarà fatto passare all'altro capo dell'ambiente e viceversa. + + + &Ctrl;&Alt;E C Chiudi + Scrivendo molti tag annidati, potresti perdere il conto di tutti gli ambienti. Questo comando chiuderà l'ultimo ambiente aperto, in modo che la struttura annidata degli ambienti non sia danneggiata. + + + &Ctrl;&Alt;E C Chiudi tutti + Questo chiude tutti gli ambienti aperti, non solo l'ultimo che hai aperto. + + + + + + + + + Gruppo &tex; + + &kile; offre anche alcuni comandi speciali per i gruppi &latex;, che sono indicati dalle parentesi graffe {...}. Nel sottomenu ModificaGruppo TeX troverai alcuni comandi importanti, che corrispondono a quelli di ModificaAmbiente. + + + Modifica->Gruppo TeX + + + + + + Modifica->Gruppo TeX + + + + + + &Ctrl;&Alt;G B Vai all'inizio + Questo comando passerà all'inizio del gruppo attuale, dovunque tu sia. Il cursore sarà spostato direttamente davanti alla graffa di apertura. + + + &Ctrl;&Alt;G E Vai alla fine + Questo comando passerà alla fine del gruppo attuale, dovunque tu sia. Il cursore sarà posizionato direttamente dietro alla graffa di chiusura. + + + &Ctrl;&Alt;G M Corrispondente + Quando il tuo cursore è posizionato davanti o dietro la graffa di apertura di un gruppo &tex;, sarà spostato all'altro capo del gruppo e viceversa. + + + &Ctrl;&Alt;G C Chiudi + Scrivere molte graffe di gruppi annidati potrebbe essere dura. Questo comando chiuderà l'ultimo gruppo aperto, in modo che la struttura annidata dei gruppi di &tex; non sia danneggiata. + + + + + + + + + Virgolette + + In &latex;, due virgolette singole vengono interpretate come virgolette doppie. Per aiutarti a inserirle efficientemente, &kile; ti permette di premere " per inserire due virgolette singole di apertura. Inoltre, se vuoi chiudere una citazione, dovrai premere ". &kile; sarà abbastanza intelligente da riconoscere questo caso e inserire due virgolette di chiusura per &latex;. + + Per avere un carattere di virgolette doppie sull'altro lato, premi due volte ". + + Puoi abilitare o disabilitare questo inserimento automatico dell'apertura e della chiusura delle virgolette doppie nella sezione ImpostazioniConfigura Kile...LaTeX. + + + Virgolette + + + + + + Virgolette + + + + + Se includi anche opzioni specifiche per la tua lingua come ngerman o french, potrai anche usare le virgolette doppie tedesche o francesi. Sono disponibili molte altre lingue. + + + + + + Ritorno a capo intelligente + + Se premi &Shift;Invio, &kile; inserisce un ritorno a capo intelligente. Se la tua posizione attuale è in un ambiente a elenco come enumerate o itemize, &kile; non solo inserirà un ritorno a capo, ma aggiungerà anche un comando \item. + + Se sei all'interno di un ambiente tabulare, &kile; finirà la riga attuale con \\, seguito da un ritorno a capo. + + Se sei all'interno di un commento &latex;, &kile; comincerà la prossima riga con %. + + Inoltre, &kile; è abbastanza intelligente da supportare ambienti &latex; predefiniti e definiti dall'utente, che possono essere aggiunti nella sezione ImpostazioniConfigura Kile...LaTeX. + + + + + + Tabulatore intelligente + + Alcuni utenti preferiscono ordinare le colonne degli ambienti tabulari e mettere tutti i caratteri ampersand & uno sotto l'altro. &kile; prova ad aiutarli. Se premi &Shift;&Alt;&, &kile; cercherà il prossimo tabulatore nella riga sopra. Sebbene possa non essere il tabulatore corrispondente, &kile; aggiungerà dello spazio per regolare la posizione della colonna con il tabulatore attuale. + + + + + + + + Completamento del codice + + Sebbene &kate; offra già un buon modo di completamento, di &kile; ha esteso il completamento del codice per supportare alcuni metodi particolari per &latex;. Sono stati integrate cinque diverse modalità. Tre di esse funzionano a richiesta, le altre due sono modalità di autocompletamento. Tutte le modalità possono essere configurate per funzionare molto diversamente in ImpostazioniConfigura Kile.... + + + + Completamento automatico degli ambienti + + Quando inizi un nuovo ambiente, scrivendo \begin{ambiente}, &kile; aggiungerà automaticamente un comando \end{ambiente}, con in mezzo una riga per il tuo testo. + + L'autocompletamento può essere disattivato nella sezione &latex; di ImpostazioniConfigura Kile...LaTeXAmbienti. + + + Completamento di un ambiente equazione + + + + + + Completamento di un ambiente equazione + + Completamento di un ambiente equazione + + + + + + + + Comandi &latex; + + Quando scrivi alcune lettere, puoi attivare questa modalità di autocompletamento per i comandi &latex; e le parole normali con ModificaCompletaComando (La)TeX o con la scorciatoia &Ctrl;Spazio. &kile; prima legge le lettere dalla posizione attuale del cursore a sinistra, e si ferma al primo carattere non letterale o sbarra inversa. &kile; entrerà nella modalità di autocompletamento per i comandi &tex; o &latex;. Altrimenti entra nella modalità di dizionario normale, dove non troverai nessun comando &latex;. A seconda della modalità scelta, sarà aperto un riquadro di completamento. Vedrai tutti i comandi o parole il cui inizio coincide con lo schema selezionato. Puoi navigare l'elenco con i tasti cursore, e selezionare una voce con il tasto &Enter; o fare doppio clic con il mouse. + + + Completamento di un comando LaTeX + + + + + + Completamento di un comando LaTeX + + + + + Quando premi il tasto &Backspace;, l'ultima lettera del tuo schema sarà eliminata, e l'elenco di completamento potrebbe aumentare. D'altro canto, se scrivi un'altra lettera, lo schema si allungherà e l'elenco potrebbe ridursi. + + Se decidi di non selezionare nessuno dei suggerimenti, puoi abbandonare questa finestra premendo &Esc;. + + Vedrai che tutti i comandi sono scritti con delle brevi descrizioni dei loro parametri. Queste descrizioni sono ovviamente rimosse quando selezioni un comando. A scelta puoi lasciare che &kile; inserisce dei punti al loro posto, in modo da poter passare facilmente a queste posizioni con ModificaPuntiPunto successivo e inserire il parametro che vuoi. + + + Completamento di un comando LaTeX + + + + + + Completamento di un comando LaTeX + + + + + Vai a ImpostazioniConfigura Kile...KileCompleta per configurare uno o più di questi elenchi. Puoi scegliere diversi elenchi di comandi &tex; e &latex; e diverse modalità dizionario per le parole normali. + + + + + + Ambienti + + La modalità comando non serve a completare gli ambienti. Devi sempre scrivere alcune lettere di \begin, e invocare la modalità di completamento risulterà in un grande elenco di tag di ambienti. D'altro canto, gli ambienti sono usati così spesso che &kile; offre una modalità particolare di completamento degli ambienti. Lascia stare l'apertura e scrivi, per esempio, eq. + + Quando chiami la modalità di completamento con ModificaCompletaAmbiente o la scorciatoia da tastiera &Alt;Spazio, il tag di apertura viene inserito automaticamente, e vedrai \begin{eq}. Dopo questa modifica, l'elenco di completamento è molto meno affollato. + + + Completamento di un comando LaTeX + + + + + + Completamento di un comando LaTeX + + + + + Adesso seleziona un ambiente e vedrai che viene anche chiuso automaticamente. Inoltre, se &kile; lo riconosce come ambiente elenco, inserirà anche un primo tag \item. + + + Completamento di un comando LaTeX + + + + + + Completamento di un comando LaTeX + + + + + Vai a ImpostazioniConfigura Kile...KileCompleta per configurare uno o più di questi elenchi. Questa modalità usa gli stessi elenchi di parole della modalità di completamento dei comandi &tex; e &latex;. + + + + + + Abbreviazioni + + &kile; supporta gli elenchi di abbreviazioni definite dagli utenti, che sono sostituite a richiesta da stringhe di testo più lunghe. Vedi ImpostazioniConfigura Kile...KileCompleta per configurare uno o più di questi elenchi. Nell'esempio qui riportato, deve essere scelto l'elenco di abbreviazioni example.cwl. In questo file troverai, per esempio, la voce L=\LaTeX. + + Per esempio, scrivi solo la lettera L. Adesso chiama la modalità abbreviazione del completamento delle parole con ModificaCompletaAbbreviazione, o la scorciatoia &Ctrl;&Alt;Spazio, e la lettera L verrà sostituita dalla stringa \LaTeX. + + + + + + Modalità di autocompletamento + + + + Comandi &latex; + + Puoi anche abilitare una modalità di autocompletamento per i comandi &latex;. Quando viene inserito un certo numero di lettere (tre come impostazione predefinita), si apre una finestra a comparsa con un elenco di tutti i comandi &latex; corrispondenti. Puoi selezionare uno di questi comandi, o ignorare questa finestra e scrivere altre lettere. Le voci del riquadro di completamento cambieranno sempre e corrisponderanno alla parola che stai scrivendo. + + Vai a ImpostazioniConfigura Kile...KileCompleta per abilitare o disabilitare questa modalità, o cambiare il numero di soglia. + + + Completamento di un ambiente equazione + + + + + + Completamento di un ambiente equazione + + + + + + + + + Parole dei documenti + + I grandi dizionari non sono utili nella modalità di autocompletamento. Però, abbiamo visto che ci sono molte parole che sono scritte più di una volta in un documento. Perciò &kile; offre un completamento per tutte le parole del documento che l'utente ha già scritto. + + Se vuoi attivare o disattivare questa modalità, vai a ImpostazioniConfigura Kile...KileCompleta. In questa finestra di configurazione puoi anche cambiare la soglia a cui appare il riquadro. + + + + + + + + Scrivere i propri file di completamento + + La specifica del formato dei file di completamento può essere trovata nella specifica del formato dei file CWL. + + I file di completamento possono essere installati nella cartella Home di un utente nella cartella ~/.trinity/share/apps/kile/complete/<modalità>/, dove <modalità> sta per abbreviation, dictionary o tex. + + + + + + + Assistenti e finestre + + + + Includi grafica + + La finestra Includi grafica rende il più semplice possibile l'inserimento di elementi grafici. Dai un'occhiata al e al per avere una panoramica di alcuni concetti fondamentali sui formati grafici. + + + Includere un elemento grafico + + + + + + Includere un elemento grafico + + + + + + Scegli un file grafico. Può essere un file JPEG, PNG, EPS o anche un file EPS compresso. Se hai installato &imagemagick; e hai anche configurato &kile; per usarlo (ImpostazioniConfigura Kile...LaTeXGenerale), l'altezza e la larghezza dei file grafici sono mostrate automaticamente. Se &imagemagick; può determinare una risoluzione, la dimensione dell'immagine viene mostrata anche in centimetri. + + Decidi se la tua immagine deve essere nel centro della pagina. + + Scegli il normale &latex; o &pdflatex;. Ricordati che &pdflatex; può anche creare file DVI, non solo PDF. + + Puoi scegliere se il nome del file debba essere inteso come relativo. Questo è il modo preferito quando usi il comando \graphicspath. + + Come impostazione predefinita i file devono essere nella stessa cartella del tuo documento principale. Però è possibile metterli in altre cartelle per mantenere le cose in ordine. Senza un comando \graphicspath, &kile; includerebbe il percorso per il file grafico. Però se usi \graphicspath, come: + +\graphicspath{{/percorso/ai/miei/file/grafici}{altro/percorso/ad/altri/grafici}} + + + e segni questa opzione, &kile; userà solo il nome di base del file grafico. + + Un altro esempio: se imposti il comando \graphicspath come: + +\graphicspath{{./}{macchinaFotografica/}{immagini/}} + + + &latex; cercherà nella cartella attuale, poi in macchinaFotografica, e infine in immagini per trovare il tuo file. + + Se scegli un'altezza o una larghezza, tutto il file sarà riscalato in proporzione. Se imposti i due valori allo stesso tempo, la larghezza e l'altezza potrebbero essere riscalate con fattori diversi, e questo potrebbe non essere quello che avevi in mente. Vedi anche le informazioni in alto nella finestra per conoscere le dimensioni originali dell'immagine. + + Inserisci un angolo di cui ruotare il file in senso antiorario. + + Le informazioni sul riquadro di delimitazione sono impostate automaticamente quando scegli un file di grafica. Queste informazioni sono necessarie solo quando lavori con il &latex; normale e con la grafica bitmap. Vedi il discorso sulla grafica EPS. + + La tua ultima scelta è se incorporare questa immagine in un ambiente di figura. Se decidi di farlo, puoi anche inserire una didascalia e un'etichetta. È una buona idea aggiungere un diverso prefisso a diversi tipi di etichette. È comune usare il prefisso fig: per le immagini. + + + + + + + Assistenza per le matrici + + Uno dei lavori più noiosi che si possano fare in &latex; è scrivere una matrice o un ambiente tabella. Si deve tener conto di tutti gli elementi, assicurarsi che l'ambiente sia ben formato, e che tutte le cose siano dove devono essere. Una buona indentazione aiuta, ma c'è un modo più semplice: usare il menu Assistente di &kile;. Contiene Tabella e Matrice (usato negli ambienti matematici). Apparirà quindi uno schema a forma di matrice che puoi facilmente riempire con le tue voci. Questa finestra offre anche alcune opzioni per impostare il tipo di carattere degli elementi della tabella. + + + Inserimento di un ambiente matrice + + + + + + Inserimento di un ambiente matrice + + + + + L'opzione Tabulazione farà apparire un menu più semplice per impostare un ambiente di tabulazione. In tutti questi ambienti, puoi facilmente impostare il numero di righe e colonne, insieme ad altri parametri specifici. + + + + + Programmi per &postscript; + + I file PS non sono popolari come i PDF, ma sono un ottimo punto di partenza per le manipolazioni e i riordinamenti delle pagine. Se vuoi un file PDF, puoi riordinare le pagine con dei programmi &postscript;, e poi convertire in PDF con ps2pdf. + + L'Assistente &postscript; suggerirà gli ordinamenti più comuni, ma sei libero di fare la tua scelta. Il lavoro viene fatto dai programmi pstops e psselect, che troverai nella maggior parte delle distribuzioni nel pacchetto psutils. Se uno di questi programmi non è disponibile, l'elemento corrispondente non sarà visibile. + + + Finestra degli strumenti PS + + + + + + Finestra degli strumenti PS + + + + + Per prima cosa scegli il tuo file iniziale. Se &kile; trova un file PS corrispondente al tuo documento principale attuale, questo verrà suggerito come file iniziale, ma sei libero di scegliere un altro file. Quindi, scegli un file di output e seleziona uno dei compiti. Infine devi decidere se vuoi solo la conversione o se vuoi anche chiamare &kghostview; per visualizzare il risultato. + + + + + 1 pagina + pagina vuota A5 --> A4 + Metti insieme una pagina A5 con una pagina vuota su una pagina A4. Ogni volta che due pagine A5 sono messe insieme, sono ruotate di 90 gradi e saranno posizionate orizzontalmente su una pagina A4. + + A5 + pagina vuota + + + + + + A5 + pagina vuota + + + + + + + + 1 pagina A5 + duplicato --> A4 + Metti insieme una pagina A5 e una sua copia su una pagina A4. + + duplica pagine A5 + + + + + + Duplica una pagina A5 + + + + + + + + 2 pagine A5 --> A4 + Metti insieme due pagine A5 consecutive su una pagina A4. + + Metti insieme due pagine A5 + + + + + + Metti insieme due pagine A5 + + + + + + + + 2 pagine A5L --> A4 + Metti insieme due pagine A5 orizzontali consecutive su una pagina A4. + + + + 4 pagine A5 --> A4 + Metti insieme quattro pagine A5 consecutive su una pagina A4. Le pagine A5 devono essere riscalate con un fattore di 0,7 per adattarsi alla pagine. + + 4 pagine A5 --> A4 + + + + + + Quattro pagine A5 --> A4 + + + + + + + + 1 pagina A4 + pagina vuota --> A4 + Metti assieme una pagina A4 con una pagina vuota su una pagina A4. Ogni volta che due pagine A4 sono messe assieme in una pagina A4, devono essere riscalate con un fattore di 0,7, e saranno ordinate verticalmente. + + 1 pagina A4 + pagina vuota --> A4 + + + + + + 1 pagina A4 + pagina vuota --> A4 + + + + + + + + 1 pagina A4 + duplicato --> A4 + Metti una pagina A4 e una sua copia in una pagina A4. + + 1 pagina A4 + duplicato --> A4 + + + + + + 1 pagina A4 + duplicato --> A4 + + + + + + + + 2 pagine A4 --> A4 + Metti assieme due pagine A4 consecutive su una pagina A4. + + Metti insieme due pagine A4 + + + + + + Metti insieme due pagine A4 + + + + + + + + 2 pagine A4L --> A4 + Metti assieme due pagine A4 consecutive e orizzontali su una pagina A4. + + + + seleziona pagine pari + Seleziona tutte le pagine pari di un documento. + + + + seleziona pagine dispari + Seleziona tutte le pagine dispari di un documento. + + + + seleziona pagine pari (ordine inverso) + Seleziona tutte le pagine pari di un documento e invertine l'ordine. + + + + seleziona pagine dispari (ordine inverso) + Seleziona tutte le pagine pari di un documento e invertine l'ordine. + + + + inverti tutte le pagine + Inverti tutte le pagine di un documento. + + + + copia tutte le pagine (ordinate) + Copia tutte le pagine di un documento. Devi scegliere il numero di copie ordinate. + + Copia tutte le pagine (ordinate) + + + + + + Copia tutte le pagine (ordinate) + + + + + + + + copia tutte le pagine (non ordinate) + Copia tutte le pagine di un documento. Devi scegliere il numero di copie non ordinate. + + Copia tutte le pagine (non ordinate) + + + + + + Copia tutte le pagine (non ordinate) + + + + + + + + pstops: scegli parametro + Ci sono molte opzioni per i comandi &postscript; pstops e psselect. Se ti serve un'opzione particolare, puoi chiamare pstops con un'opzioni di tua scelta. Riferisciti al manuale per tutte le opzioni possibili. + + + + psselect: scegli parametro + Puoi chiamare psselect con un'opzione di tua scelta. Riferisciti al manuale per tutte le opzioni possibili. + + + + + + + + Statistiche del documento + + La finestra delle statistiche ti dà una panoramica di una selezione, di un documento o di un intero progetto. Include il numero di parole, i comandi e gli ambienti &latex;, e include anche il numero di caratteri per ogni tipo. I numeri possono essere copiati come testo o come un ambiente tabulare &latex; ben formattato. Se vuoi avere statistiche per tutto il progetto puoi usare FileApri tutti i file del progetto per aprire facilmente tutti i file sorgente del tuo progetto. + Si deve fare attenzione all'accuratezza dei numeri. Abbiamo incluso della logica per avere una buona stima, per esempio K\"uhler risulta in una parola, un comando e sei caratteri. Però ci sono altre combinazioni in cui parte dei comandi viene contata come parola e viceversa. Va tenuto a mente che l'algoritmo è stato sviluppato e provato per le lingue simili all'inglese o al tedesco, quindi non considerare i numeri perfetti. Se devi fare un rapporto con un numero esatto di parole o caratteri, fai delle prove per verificare se l'accuratezza di &kile; è adatta a te. + + + + + + + Tag speciali in &latex; + + + Usare la libreria di etichette &latex; + + &latex; ha migliaia di etichette per simboli e caratteri speciali. Il modo più facile per inserirli è usare il menu della barra laterale, a sinistra della finestra dell'editor. + + + Il menu della barra laterale + + + + + + Il menu della barra laterale + + Il menu della barra laterale + + + Sono disponibili i seguenti tipi: + + + Usati più spesso + Relazione + Operatori + Frecce + Matematica varia + Testo vario + Delimitatori + Greco + Caratteri speciali + Caratteri cirillici + Definiti dall'utente + + I suggerimenti delle icone mostrato i comandi &latex; e i pacchetti aggiuntivi necessari. + Premere &Shift; e fare clic su un simbolo farà inserire $\comandosimbolo$. Similmente, premere &Ctrl; lo inserirà tra parentesi graffe. + Se inserisci un comando che richiede un pacchetto non incluso nel tuo documento &latex;, vedrai un messaggio nella finestra del log. + Il primo elenco di simboli contiene i simboli Usati più spesso. I simboli che inserisci saranno aggiunti a questo elenco per poterli ritrovare facilmente. L'ordine dei simboli non verrà cambiato all'aggiunta di nuovi elementi; verrà invece aumentato un contatore. Se il numero di elementi passa oltre i 30, l'elemento con il conto minore sarà rimosso. + L'elenco di simboli Definiti dall'utente può contenere i tuoi simboli. Per crearli devi avere il programma gesimb e il file definitions.tex del pacchetto sorgente di &kile;. Inoltre ti serve un compilatore &latex; e &dvipng; (versione 1.7 o successiva). La procedura è creare un file &latex; con \input{definitions}, che rende disponibili i comandi elencati sotto, ed eseguire gesymb mieisimboli.tex (che chiama &latex; e &dvipng;) per creare le icone. Dopo averle copiate in $HOME/.trinity/share/apps/kile/mathsymbols/user/ e aver riavviato &kile; puoi usare i tuoi simboli. + In definitions.tex sono definiti i seguenti comandi: + + \command[\opzione]{\simbolo}: include il simbolo \simbolo nell'elenco dei simboli; l'argomento opzionale \opzione specifica il comando che &kile; deve inserire. Se non viene dato, viene usato il comando fornito nell'argomento obbligatorio. + + + \mathcommand[\opzione]{\simbolo}: come sopra, tranne che il comando nell'argomento obbligatorio viene inserito in modalità matematica. + + + \pkgs[argomento]{pacchetto}: dichiara che il comando dato su questa riga ha bisogno del pacchetto &latex; pacchetto con l'argomento opzionale argomento. Questo comando deve stare davanti al comando \command e sostituisce qualsiasi specificazione di pacchetti da parte dell'ambiente neededpkgs. + + + \begin{neededpkgs}[argomenti]{pacchetti} ... \end{neededpkgs}: ha lo stesso effetto come sopra, ma per tutti i comandi inclusi nell'ambiente. + + + + Per completezza, viene qui dato un esempio: + \documentclass[a4paper,10pt]{article} + \usepackage{amssymb} + \input{definitions} + % + \begin{document} + \pagestyle{empty} + % + \begin{neededpkgs}{amssymb} + \mathcommand{\surd} + \pkgs{amsmath}\mathcommand[\ddddot{}]{\ddddot{a}} + \mathcommand{\angle} + \end{neededpkgs} + \command{\"A} + \mathcommand{\exists} + \mathcommand[\stackrel{}{}]{\stackrel{abc}{=}} + + \begin{neededpkgs}[russian,koi8-r,T2C,]{babel,inputenc,fontenc,mathtext} + % + % \end{neededpkgs} + % this would need to include the packages + % \usepackage{mathtext} + % \usepackage[T2C]{fontenc} + % \usepackage[russian]{babel} + % \usepackage[koi8-r]{inputenc} + % just to explain the format + \end{document} + + + + + + + Usare i bibitem + + \bibitem è un comando usato per inserire una referenza in un ambiente thebibliography nel tuo documento. La sintassi per usare \bibitem è \bibitem[etichetta]{chiave}. + + L'[etichetta] opzionale ti serve per aggiungere il tuo sistema di etichettamento per la voce della bibliografia. Se non viene impostata nessuna etichetta, le voci saranno poste in ordine numerico: [1], [2], [3], ecc. + + L'argomento {chiave} è usato per referenziare e collegare i comandi \bibitem e \cite l'uno all'altro e le informazioni che essi contengono. Il comando \cite contiene l'etichetta associata al \bibitem desiderato, che è situato all'interno di un ambiente thebibliography, e contiene i dati della referenza. Sia \bibitem che il corrispondente \cite devono avere la stessa {chiave}; il modo più semplice per organizzare le chiavi è il cognome dell'autore. Le graffe secondarie in {thebibliography} indicano l'etichetta più lunga che ti aspetti di avere nella bibliografia. Quindi, inserire {pippo} indica che puoi avere qualsiasi etichetta più corta o lunga uguale all'espressione pippo. Impostare male questo parametro potrebbe risultare in un'indentazione non troppo gradevole nella tua bibliografia. + + La bibliografia è una sezione separata dal tuo documento principale, e un esempio di codice per la bibliografia è il seguente: + + + \begin{thebibliography}{50} + \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm... ciambelle}. + Evergreen Terrace Printing Co., Springfield, DaqualchepartenegliUSA, 1998 + \end{thebibliography) + + Poi, il tuo codice sorgente principale conterrebbe l'indirizzo dell'informazione relativa al \bibitem usando \cite. Quel codice sorgente assomiglierebbe a questo: + + + La mia tesi riguardo alla filosofia dei Simpson\copyright + viene dal mio libro preferito \cite{Simpson}. + + Siccome spesso è difficile ricordarsi l'esatta chiave di citazione una volta che hai molte referenze, &kile; ti dà un modo semplice per inserire una citazione. Sulla barra degli strumenti Modifica, fai clic sul secondo menu a cascata (normalmente c'è scritto label), e seleziona cite. Comparirà un elenco con tutte le chiavi di citazione, seleziona la referenza corretta, e una citazione sarà inserita nel tuo documento. Per aggiornare la lista delle chiavi, salva il file, seleziona ModificaAggiorna Struttura o premi F12. + + Il prodotto finale nella bibliografia del tuo documento sarebbe più o meno come questo: + + [1] Homer J. Simpson. Mmmmm... ciambelle. Evergreen Terrace Printing Co., Springfield, DaqualchepartenegliUSA, 1998. + + Il modo più facile di lavorare con i \bibitem e \cite è usare l'opzione del menu a cascata chiamato cite. Quando selezioni una citazione da inserire, ti sarà data la lista dei bibitem che hai creato fino a quel momento, e potrai scegliere la referenza da quella lista. &kile; può anche lavorare insieme ad applicazioni &bibtex;, come &kbibtex;, per renderti le citazioni più facili. + + + + + + Etichette utente + + &kile; ti dà la possibilità di fare le tue etichette. Un'etichetta è simile a una scorciatoia che avvia qualche comando o scrive del testo frequentemente usato. Per esempio, Pinco Pallino usa spesso le frasi Preferisco \LaTeX a \TeX e Cosa farei senza Linux?. Per creare etichette utente per scrivere queste frasi, dovrebbe andare a LaTeXEtichette utenteModifica etichette utente...; ciò farà apparire una finestra dove potrà creare le sue etichette utente. + + La finestra Modifica etichette utente + + + + + + La finestra Modifica etichette utente + + La finestra Modifica etichette utente + + + + + Chiamare un'etichetta utente + + + + + + Chiamare un'etichetta utente + + Chiamare un'etichetta utente + + + + Probabilmente darebbe a ogni etichetta un nome che la possa identificare chiaramente. Il nome che dài alla tua etichetta viene inserito nella sezione chiamata Elemento del menu, e il testo del comando dovrebbe essere inserito nella sezione etichettata Valore. Una volta che i comandi sono inseriti, li può usare rapidamente usando la scorciatoia &Ctrl;&Shift;1 affinché la mia prima etichetta inserisca Preferisco \LaTeX a \TeX e &Ctrl;&Shift;2 per inserire Cosa farei senza Linux?. + + + + Segnaposti nelle etichette utente + + Ci sono alcuni segnaposti che puoi usare nelle etichette utente: sono %B, %C, %M, e %S. + + + %B: sarà sostituito da un punto. + %C: questo è dove il cursore sarà posizionato dopo l'inserimento di un'etichetta definita dall'utente. + %M: questo sta per il testo evidenziato; il testo selezionato è inserito al suo posto quando si inseriscono le etichette definite dall'utente. + %S: sarà sostituito il nome del file sorgente senza estensione. + + + Per mostrarti come funziona, diciamo per esempio di avere un'etichetta utente che contenga il valore \bfseries{%M}%C, e di avere una selezione di testo evidenziata nel nostro documento che vogliamo trasformare in grassetto. Quindi, evidenziamo la frase Adoro i venerdì, applichiamo la nostra etichetta utente premendo &Ctrl;&Shift;1, e otteniamo il testo \bfseries{Adoro i venerdì}, con il cursore posizionato alla fine dell'espressione. + + + + + + + + + + Gli strumenti di costruzione + + + + Compilazione, conversione e visualizzazione + + Per visualizzare il risultato del tuo lavoro, devi prima compilarne il sorgente. Tutti gli strumenti di costruzione sono raggruppati nei menu CostruzioneCompila, CostruzioneConverti, e CostruzioneVisualizza. + + Per compilare il tuo codice sorgente per visori come &kdvi;, &kghostview;, &kpdf; o conversioni successive, puoi usare la scorciatoia &Alt;2. Poi puoi visualizzare il file DVI usando il tuo visore predefinito con &Alt;3, convertire il DVI a un file PS con &Alt;4, e visualizzare il file PS con &Alt;5. + + + + &bibtex; + + Se usi &bibtex; per le tue voci bibliografiche, normalmente devi seguire uno schema di compilazione speciale. Ciò vuol dire chiamare &latex; e poi &bibtex; e poi di nuovo &latex;. Fortunatamente &kile; è abbanstanza intelligente da rilevare da solo se è necessario chiamare strumenti aggiuntivi come &bibtex;, &makeidx; e &asymptote;. Questa logica è attivata come impostazione predefinita, ma ciò può essere cambiato a ImpostazioniConfigura Kile...StrumentiCostruzione nella scheda Generale negli strumenti &latex; e &pdflatex;. + + + + + + &makeidx; + + Se stai usando il pacchetto &makeidx; per fare un indice analitico finale per il tuo documento, devi anche seguire un certo schema di compilazione, o fallo fare a &kile; come per i file &bibtex;. + + + + + + MetaPost e Asymptote + + Se vuoi compilare il tuo documento con MetaPost o Asymptote, dei programmi di disegno, puoi farlo con CostruzioneCompilaMetapost o CostruzioneAltroAsymptote. + + + + + + &pdflatex; + + C'è anche un altro modo per compilare il tuo documento, se vuoi un PDF: puoi eseguire &pdflatex;, che compilerà il sorgente direttamente in un file PDF, con &Alt;6: puoi quindi visualizzare il file premendo &Alt;7. + + Alternativamente, puoi convertire un PS in un PDF con &Alt;8, o un DVI direttamente in un PDF con &Alt;9. + + Usare &pdflatex; invece di &latex; può essere solo una questione di semplicità o d'abitudine, ma a volte il comportamento dei due programmi può differire. + + + + + + Da &latex; a Web + + Infine, potresti voler pubblicare il tuo lavoro sul Web, e non solo su carta. Puoi allora usare il programma latex2html, che può essere chiamato dal menu CostruzioneConvertiDa LaTeX a Web di &kile;. Il risultato sarà posizionato in una sottocartella della cartella di lavoro, e potrai vedere il risultato della conversione scegliendo l'elemento CostruzioneVisualizzaVisualizza HTML. + + + + + + Passare parametri da riga di comando + + Se vuoi passare alcuni parametri da riga di comando specifici agli strumenti di compilazione, conversione e visualizzazione, puoi configurarne la chiamata in ImpostazioniConfigura Kile...StrumentiCostruzione. + + + + + + + Anteprima veloce + + Lavorando con &latex;, ti servirà sempre un po' di tempo per vedere il risultato. &latex; deve compilare il sorgente, e deve essere avviato il visore. Ciò potrebbe essere fastidioso se hai solo cambiato qualche lettera in un'equazione difficile da scrivere. &kile; offre una modalità di Anteprima rapida, dove puoi compilare solo parte del documento e risparmiare molto tempo. Supporta quattro diverse modalità, che possono essere combinate con sette configurazioni. + + + Anteprima rapida + + + + + + Anteprima rapida + + + + + Tutte le impostazioni devono essere fatte in ImpostazioniConfigura Kile...StrumentiAnteprima. + + + Configurazione dell'anteprima rapida + + + + + + Configurazione dell'anteprima rapida + + + + + + + Modalità di selezione + + L'utente deve selezionare una parte del documento. La voce del menu CostruzioneAnteprima rapidaSelezione o la scorciatoia da tastiera &Ctrl;&Alt; P,S avvierà i programmi selezionati. &kile; prende il preambolo del testo originale, in modo che tutti i pacchetti e i comandi definiti dall'utente siano inclusi. L'utente può scegliere una configurazione tra sette predefinite: + + + LaTeX+DVI (visore incorporato) + LaTeX+DVI (KDVI) + LaTeX+PS (visore incorporato) + LaTeX+PS (KGhostView) + PDFLaTeX+PDF (visore incorporato) + PDFLaTeX+PDF (KGhostView) + PDFLaTeX+PDF (KPDF) + + + Ciò dovrebbe bastare per tutte le situazioni per cui ci sia bisogno di una anteprima rapida. + + + + + + Modalità ambientale + + Molto spesso vorresti avere un'anteprima dell'ambiente attuale, e in particolare gli ambienti matematici, che a volte sono difficili da scrivere. &kile; offre un modo molto veloce di farlo. Non c'è bisogno di selezionare, basta scegliere CostruzioneAnteprima rapidaAmbiente o la scorciatoia da tastiera &Ctrl;&Alt;P,E, e l'ambiente attuale sarà compilato e visualizzato. + + + + + + Modalità sottodocumento + + Se hai dei progetti con molti documenti, compilare tutto il progetto non è una buona idea, se hai fatto cambiamenti in un documento solo. &kile; può compilare e mostrare un'anteprima del sottodocumento attuale. Prende il preambolo del documento principale e compila solo la parte attuale quando selezioni CostruzioneAnteprima rapidaSottodocumento o la scorciatoia da tastiera &Ctrl;&Alt;P,D. + + + + + + Modalità gruppo matematico + + La modalità di anteprima del gruppo matematico ti permette di vedere il gruppo matematico che stai attualmente modificando. &kile; prende il preambolo del documento principale e compila solo il gruppo matematico in cui il cursore si trova quando scegli CostruzioneAnteprima rapidaGruppo matematico o la scorciatoia da tastiera &Ctrl;&Alt;P, M. + + + + + + Anteprima rapida nella barra in basso + + Invece di mostrare l'anteprima in un nuovo documento, &kile; può anche essere configurato per usare la barra in basso per fare un'anterprima delle compilazioni. Puoi attivare questa funzionalità nel pannello di configurazione dell'anteprima rapida. + + + + + + + + Formati di file grafici + + + + &latex; e &pdflatex; + + &pdflatex;, quando usato con i pacchetti graphics o graphicx, può compilare correttamente i file PNG e JPG nei DVI e PDF, ma non è in grado di gestire i file EPS. Di converso, il processo di compilazione &latex; in DVI e conversione a PS e infine PDF supporta EPS, ma non supporta PNG e JPG. + + Molti utenti vogliono creare dei documenti PDF, ma vogliono anche usare l'ottimo pacchetto Pstricks per creare grafica &postscript;, o vogliono usare i grafici &postscript; prodotti da programmi matematici e scientifici come Mathematica, Maple o MuPAD. Questi utenti di &latex; devono prima compilare in &postscript;, anche se vogliono creare documenti PDF, perché questi programmi producono del codice &postscript; che non può essere gestito da &pdflatex;. Però non è così difficile, perché &kile; può aiutare. + + + + + + Conversione della grafica + + Per superare questa impasse, se vuoi includere sia codice &postscript; che file PNG o JPG, hai a disposizione una serie di soluzioni: + + + Se hai bisogno di un file in formato PS, ma hai file grafici JPG o PNG, puoi semplicemente usare prima &pdflatex; con output DVI, e poi usare dvips per creare il file PS. &pdflatex; è un'ottima scelta, se il tuo sorgente non contiene nessun codice &postscript;. + + Puoi convertire i file EPS a PNG o altri formati con applicazioni come Gimp o &imagemagick;, e quindi usare &pdflatex;. + + Un modo preferibile è convertire la grafica EPS in PDF con il comando epstopdf, presente in ogni distribuzione di &tex;, e quindi usare &pdflatex;. Produce grafica di alta qualità, e puoi anche controllarne il risultato con alcune delle seguenti opzioni: -dAutoFilterColorImages=false + -dAutoFilterGrayImages=false + -sColorImageFilter=FlateEncode + -sGrayImageFilter=FlateEncode + -dPDFSETTINGS=/prepress + -dUseFlateCompression=true + + + + Ancora meglio, se il tuo sistema permette shell-escape, la conversione può essere fatta al volo. Tutto quello che devi fare è includere il pacchetto epstopdf, che fa parte delle distribuzioni &tex;, con il comando \usepackage{epsdopdf}. Supponendo che il tuo codice sia + \includegraphics[width=5cm]{prova.eps} +Quando chiami &pdflatex; con l'opzione , il file grafico prova.eps viene convertito automaticamente in prova.pdf. + + Questa conversione avverrà ogni volta che esegui &pdflatex;. Se il tuo comando per la grafica viene dato implicitamente + \includegraphics[width=5cm]{test} +epstopdf controllerà se c'è già un prova.pdf disponibile, in modo da poter saltare la conversione. + + Puoi convertire nell'altro senso, e usare &latex; e la conversione PS-PDF. Questa non è sempre una buona idea, perché l'incapsulazione EPS di file JPG o PNG può produrre file più grandi, che a loro volta producono documenti inutilmente grandi; questo però dipende molto dall'applicazione grafica che usi, perché EPS può incapsulare altri file grafici, ma non tutte le applicazioni supportano perfettamente questa possibilità. Alcune potrebbero anche cercare di costruire la tua immagine JPG con vettori e vari script, che risulterà in file giganteschi. La conversione di tutti i file grafici in EPS può essere fatta con &imagemagick;. Un altro semplice programma che fa correttamente questo processo è jpg2ps. + + Puoi anche usare una conversione automatica. Tutti i file grafici sono convertiti al volo in EPS, e inseriti nel documento PS. Questa è una modalità comoda, ma devi impostare correttamente il tuo sistema. Ciò viene discusso nella sezione sulla grafica EPS. + + + + + + + + Usa il formato giusto per il grafico giusto + + + EPS è una specie di linguaggio script a vettori, che descrive tutte le linee e punti di cui il grafico è composto; non perde molto quando viene ingrandito oltre la sua dimensione predefinita, e si adatta al meglio ai diagrammi e alla grafica vettoriale prodotta nativamente in EPS, che hanno un aspetto chiaro e netto pur mantenendo una dimensione molto ridotta. + PNG (o lo sconsigliato GIF) è un formato senza perdita, con buone compressione e qualità. È molto buono per diagrammi, scansioni di disegni, o qualsiasi cosa di cui vuoi mantenere la definizione. È a volte esagerato per le foto. + JPG è un formato con perdita, che comprime i file meglio di PNG al prezzo di qualche perdita nei dettagli delle immagini. Questo è normalmente irrilevante per le foto, ma potrebbe causare una cattiva qualità per diagrammi e disegni, e potrebbe far sparire del tutto le linee più sottili; in questi casi usa EPS o PNG. + + + Ma ricorda sempre il principio di conservazione della rumenta: nessuna conversione abbellirà una cattiva immagine. + + + + + + + + Grafica EPS + + I file grafici EPS sono il modo tradizionale di inserire i file grafici nei documenti &latex;. Siccome le mailing list sono piene di domande sulla grafica EPS, discuteremo alcuni aspetti importanti e dimostreremo come &kile; li supporta. + + + + &latex; e la grafica EPS + + Se hai deciso di usare il classico &latex; per produrre file PS o PDF, probabilmente incorrerai in alcuni problemi con la grafica. Devi usare la grafica EPS (Encapsulated &postscript;), senza file JPEG o PNG. Non dovrebbe essere un problema, perché ci sono molti convertitori come convert dell'eccellente pacchetto &imagemagick;. Però ci vuole un po' di tempo. + + I file EPS vengono usati sia da &latex; che dai convertitori DVI-PS: + + + &latex; scansiona il file EPS per trovare la linea del riquadro di delimitazione, che dice a &latex; quanto spazio riservare per la grafica. + + Il convertitore DVI-PS legge il file EPS e inserisce la grafica nel file PS. + + + Ciò comporta alcune conseguenze: + + + &latex; non legge mai il file EPS se i parametri del riquadro di delimitazione sono specificati nel comando di inserimento della grafica. + + Siccome &latex; non può leggere file non ASCII, non può leggere le informazioni sul riquadro di delimitazione da file di grafica compressi o non EPS. + + La grafica EPS non viene inclusa nel file DVI. Siccome i file EPS devono essere presenti nella conversione del file DVI in PS, i file EPS devono accompagnare i file DVI ovunque. + + + Ora puoi chiamare &latex; e un convertitore DVI-PS come dvips per creare il tuo documento &postscript;. Se il tuo obbiettivo è un documento PDF, dovresti eseguire dvips con l'opzione , e quindi chiamare ps2pdf. Troverai molti documenti che descrivono questo soluzione. + + + + + + L'approccio a &postscript; di &kile; + + &kile; ti aiuta a ottenere le informazioni sul riquadro di delimitazione. Se hai installato il pacchetto &imagemagick;, &kile; estrarrà queste informazioni dal file EPS e le inserirà come opzioni. Ciò viene fatto automaticamente, quando selezioni il file di grafica. Ci sono due vantaggi in questa procedura: + + + L'informazione viene scansionata nella finestra, e non deve essere fatta da &latex; in seguito. + È ancora più importante che saranno calcolate la larghezza e l'altezza dell'immagine, quando ne sarà nota la risoluzione. Queste informazioni saranno mostrate in alto nella finestra, e potranno servire da suggerimento quando vorrai riscalare la grafica. + &kile; può anche supportare i file EPS compressi con zip o gzip, che sono molto più piccoli dei file EPS non compressi. Però questa funzionalità può essere usata solo con una particolare configurazione di sistema, come descritto nella sezione sulla grafica bitmap. + + + + + + + L'approccio a &postscript; e la grafica bitmap + + Se il tuo sistema permette shell-escape, &kile; supporta anche un modo semplice di includere la grafica bitmap, se hai impostato correttamente il tuo sistema &tex;. Non è necessario convertire la grafica JPEG o PNG, si può fare automaticamente quando il file DVI viene convertito in PS. + + &latex; ha bisogno di alcune informazioni sui suffissi dei file. Il pacchetto graphicx cerca un file graphics.cfg, che deve essere da qualche parte nel tuo percorso di ricerca per i documenti &latex;. Cerca voci come: + +\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}{}% + + + e sostituisci queste righe con: + +\DeclareGraphicsRule{.pz}{eps}{.bb}{}% + \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}% + \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}% + \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}% + % regole cambiate o nuove + \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}% EPS zip + \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}% EPS gzip + \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:-}% grafica PDF + + + Potrai trovare questo file, per esempio in Debian, in /etc/texmf/latex/graphics.cfg. Il modo migliore di procedere è copiare questo file nel tuo percorso &tex; locale, e poi cambiarlo. Vedi il manuale della tua distribuzione di &tex; per sapere come ottenere un elenco delle tue cartelle &tex;. + + Con questo file di configurazione puoi inserire grafica bitmap e file EPS compressi con zip o gzip in &latex;. Il comando per la conversione è dato da dvips. Quando guardi al comando di conversione vedrai che non viene creato nessun file aggiuntivo. Il risultato di questo processo di conversione viene incanalato direttamente nel file PS. L'unica cosa che &latex; deve sapere è la dimensione della grafica, e quindi abbiamo bisogno del riquadro di delimitazione, che viene fornito da &kile;. + + Alcuni dicono che questo modo non è sicuro, devi decidere tu in che modo lavorare. In ogni caso non hai bisogno di un riquadro di delimitazione, perché &kile; estrarrà questa informazione da tutti i tipi di grafica. + + + + + + &pdflatex; e la grafica EPS + + Come già notato, &pdflatex; non è in grado di gestire i file di grafica EPS, ma i convertitori come epstopdf saranno d'aiuto. Il modo migliore è includere il pacchetto epstopdf, che deve seguire il pacchetto graphicx. + +\usepackage[pdftex]{graphicx} + \usepackage{epstopdf} + + + Adesso puoi già includere la grafica EPS, se esegui pdflatex con l'opzione , ma possiamo ancora migliorare le cose e gestire anche i file EPS compressi con zip o gzip. Di nuovo, dobbiamo cambiare il file di configurazione grafica graphics.cfg, come sopra. Questa volta cerchiamo: + +% pdfTeX is running in pdf mode + \ExecuteOptions{pdftex}% + + + e aggiungiamo alcune righe. + +% 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}}% + }% + + + Con queste righe, &pdflatex; è in grado di gestire i file EPS, e ciò dovrebbe risolvere tutte le questioni di grafica. + + + + + + + + Documento principale + + Definire il tuo documento come principale ti permette di lavorare con file separati, che vuol dire avere un documento principale e documenti figli che costituiscono un'opera completa. Dopo aver definito il tuo documento principale, tutti i comandi del menu Strumenti si applicheranno solo a questo documento, anche se starai lavorando sui documenti figli. Puoi anche chiudere il documento principale. + + + + + Gestione degli errori + + Dopo aver compilato qualcosa, &kile; dà un'occhiata ai messaggi d'errore che sono stati generati. Se ci sono errori o avvertimenti, saranno riportati brevemenet nella finestra Log e messaggi. Si può dare un'occhiata ai messaggi più da vicino selezionando CostruzioneVisualizza log, o usando la scorciatoia da tastiera &Alt;0. Il log generato è quindi mostrato nella vista Log e messaggi; gli errori e gli avvertimenti sono evidenziati. + + + Visualizzazione del log + + + + + + Visualizzazione del log + + Visualizzazione del log + + + + Puoi facilmente saltare da un messaggio all'altro nel file di log usando gli elementi del menu CostruzioneErrore / Avvertimento LaTeX Successivo / Precedente, o usando i pulsanti corrispondenti nella barra degli strumenti. + + Per saltare alla riga del codice &latex; dove è avvenuto l'errore o l'avvertimento, fai clic sull'errore o avvertimento nella vista Log e messaggi. &kile; ti porterà automaticamente alla riga incriminata. + + + + + + La modalità Sorveglia file + + Quando avvii il comando Costruzione rapida, un visore di qualche tipo sarà chiamato dopo la compilazione. Se non stai usando un visore integrato, ogni volta sarà aperta una nuova finestra. + + Se stai sistemando l'aspetto del tuo documento, potresti avviare Costruzione rapida molto spesso, e avere molte finestre di visori aperte sul tuo desktop; per evitare questa confusione, puoi attivare la modalità Sorveglia file, che impedirà a Costruzione rapida di avviare un visore. + + Al momento, &kdvi; supporta l'aggiornamento continuo del file DVI visualizzato, ma &kghostview; non è altrettanto perfetto: per aggiornare il documento dopo la compilazione, dovrai cambiare pagina, e il numero di pagine non sarà cambiato nella visualizzazione di &kghostview;. + + Questa modalità è ovviamente inutile con i visori integrati, perché devi chiuderli comunque per tornare a modificare il documento e ricompilare. + + + + + + + + Navigare nel sorgente &latex; + + + + Uso della vista Struttura + + La vista Struttura mostra la gerarchia del documento creato in &kile;, e ti permette di navigarci rapidamente, mostrandone la segmentazione. Per navigare nel tuo documento, tutto quello che devi fare è fare clic sinistro su un qualsiasi etichetta, capitolo, sezione, sottosezione, etichetta, eccetera, e sarai portato all'inizio dell'area corrispondente. + + Se includi un file separato nel tuo sorgente &latex; usando le etichette \input o \include, questi file saranno rappresentati nella vista Struttura; fare doppio clic sui loro nomi farà mostrare a &kile; il file incluso nella finestra dell'editor. + + L'albero di gerarchia ha anche un ramo a parte per le etichette di riferimento usate nel testo. + + + Uso della vista Struttura + + + + + + Uso della vista Struttura + + Uso della vista Struttura + + + + + + Aggiornare la vista struttura + + Per aggiornare la tua vista struttura puoi andare a ModificaAggiorna Struttura, premere F12, o puoi salvare il tuo documento, che farà aggiornare a &kile; la sua vista Struttura. + + + + + + + + Segnalibri + + I segnalibri sono il tuo riferimento a un segmento di testo o una riga all'interno dell'ambiente di &kile;. Per usare un segnalibro, seleziona una riga di testo specifica del tuo documento alla quale vorresti tornare, quindi premi &Ctrl;B, e &kile; aggiungerà un segnalibro a quella riga. Alternativamente, puoi anche impostare un segnalibro evidenziando la riga alla quale vorresti tornare, e scegliere il menu chiamato SegnalibriCommuta Segnalibri. + + Per rimuovere tutti i tuoi segnalibri, seleziona SegnalibriPulisci i segnalibri. + + Nota che attualmente i segnalibri non sono salvati all'uscita di &kile;. + + + + + + + + Progetti + + + + Lavorare con i progetti + + In &kile; puoi creare e lavorare con progetti. Un progetto è un gruppo di file &latex;, grafici, &bibtex;, o di altro tipo, che contengono tutte le informazioni relative al tuo documento completo. Un progetto tipico sarebbe un documento costituito da diversi capitoli, scritti in diversi file .tex; tutti potrebbero essere inclusi in un progetto, per rendere più facile da gestire il documento complessivo. Le specificazioni del progetto sono conservate in un file speciale, con estensione .kilepr. + + Un progetto aggiunge le seguenti funzionalità: + + + Non devi impostare un documento principale, &kile; lo fa automaticamente. + I file di progetto possono facilmente essere archiviati assieme andando a CostruzioneAltroArchivio. + La vista File e progetto mostra quali file sono inclusi nel tuo progetto. + Dopo aver aperto un progetto, ogni file precedentemente aperto sarà ripristinato con la codifica e l'evidenziazione originali. + Il completamento del codice funziona in tutti i file del progetto. + Il completamento delle referenze funziona in tutti i file del progetto. + Il completamento delle citazioni funziona in tutti i file del progetto. + Cerca in tutti i file del progetto. + Specifica la generazione rapida personalizzata e il comando &makeidx;. + + + + + + + Creare un progetto + + Per creare un progetto, seleziona ProgettoNuovo progetto.... Ti saranno chieste le seguenti informazioni per creare il tuo progetto: + + Titolo del tuo progetto. + Nome del file progetto con estensione .kilepr. + Nome file. + Tipo del file da creare: Documento vuoto, Articolo, Libro, Lettera, Rapporto, ... + + + Quando riempi la casella Nome file, devi includere un percorso relativo da dove il file progetto .kilepr è conservato al file. + + + + + + La vista File e progetto + + La vista File e progetto è un pulsante della barra laterale. Da questa vista, puoi vedere la struttura del tuo progetto, i suoi file, e il nome del file .kilepr in cui sono salvate le informazioni del progetto. Aggiunta, rimozione o cambiamento delle opzioni del tuo progetto si fanno attraverso la vista File e progetto. + + + La vista File e progetto + + + + + + La vista File e progetto + + La vista File e progetto + + + + + + + + Aggiunta e rimozione di file + + Per aggiungere un file al tuo progetto, apri un qualsiasi file &tex;, fai clic destro sul suo nome nella vista File e progetto, e seleziona Aggiungi al progetto. Se hai più progetti aperti, una finestra ti chiederà a quale progetto debba essere aggiunto. + + Se hai più file da aggiungere a un progetto, puoi selezionare il progetto dalla vista File e progetto e fare clic destro, quindi selezionare Aggiungi file; potrai quindi selezionare i tuoi file in un riquadro. + + Puoi anche fare clic destro sul nome del progetto nella vista File e progetto, e selezionare Aggiungi file... per far apparire una finestra di selezione file. + + + Aggiunta di un file a un progetto + + + + + + Aggiunta di un file a un progetto + + Aggiunta di un file a un progetto + + + + Per rimuovere un file da un progetto, fai clic destro su di esso e seleziona Rimuovi dal progetto. Ciò non elimina il tuo file (e nemmeno lo chiude), ma lo rimuove soltanto dalla lista dei file contenuta nel file con estensione .kilepr. + + + + + + Opzioni dei progetti + + &kile; ha alcune opzioni relative al tuo progetto che possono essere impostate. Per cambiarle, fai clic destro sul titolo del tuo progetto e seleziona Opzioni progetto, e avrai la possibilità di cambiare: + + + Il titolo del tuo progetto. + Il documento principale. + Il comando di costruzione rapida. + Le opzioni di &makeidx;. + + + + + Archiviazione del tuo progetto + + &kile; ti permette di fare facilmente una copia di sicurezza del tuo progetto salvandone tutti i file in un singolo archivio (spesso conosciuto come tarball). Per archiviare il tuo progetto fai clic destro sul nome del progetto nella vista File e progetto, o seleziona ProgettoArchivia. + + Come impostazione predefinita, tutti i file di un progetto sono aggiunti all'archivio. Se non vuoi includere un certo file nell'archivio, fai clic destro su di esso nella vista File e progetto, e deseleziona l'opzione Includi in archivio. + + I comandi di archiviazione sono semplici comandi shell che vengono eseguiti dalla cartella del progetto (dove è situato il file .kilepr). + + + + + + + + + + Chiusura di un progetto + + Per chiudere un progetto, seleziona la vista File e progetto dalla barra degli strumenti verticale, fai clic destro sul titolo del tuo progetto, e quindi seleziona Chiudi. Questo chiuderà il tuo progetto, tutti i file associati con il progetto, e inoltre ne aggiungerà il nome in Apri progetto recente... nel menu Progetto. + + + + + + + + Codifica dei documenti + + L'editor &kile; ti permette di leggere, convertire e impostare il testo nella codifica che serve al tuo documento. Questo ti permette di usare lettere e simboli non standard; puoi usare, per esempio, i caratteri accentati per l'italiano e il francese. La selezione della codifica può essere fatta in tre modi: + + + Un modo di impostare la codifica è usare la casella combinata Imposta codifica, situata in fondo alla vista Apri file della barra laterale. + Un altro modo è usare il sottomenu ImpostazioniConfigura Kile...Editor, dove puoi impostare la codifica dei caratteri predefinita per tutti i file. + + Imposta la codifica dei caratteri predefinita + + + + + + Imposta la codifica dei caratteri predefinita + + + + + Un terzo modo per impostare la codifica di un documento è impostarne l'opzione quando usi l'assistente per creare un nuovo documento. + + + &latex; di per sé capisce solo ASCII, un insieme molto limitato di caratteri, quindi non potresti usare caratteri accentati o speciali direttamente. Per usare lettere accentate, è stata creata una sintassi speciale: come per esempio \"e per ë. C'è un pacchetto per aiutarti in ciò, chiamato inputenc, ed è incluso nel preambolo usando \usepackage[latin1]{inputenc}, dove l'argomento opzionale è la codifica che vuoi usare (oggi, nella maggior parte dei casi utf8x). Ciò dice a &latex; di tradurre tutte le ë che hai scritto in \"e prima di compilare. Per piacere riferisciti direttamente la documentazione di inputenc per ulteriori informazioni. In ultimo, ma non certo per importanza: ricordati di assicurarti che il file sia davvero codificato nella stessa codifica che hai indicato a inputenc! + + + Scelta della codifica del file sorgente + + + + + + Scelta della codifica del file sorgente + + Scelta della codifica del file sorgente + + + + La schiera di diverse codifiche di caratteri ha creato problemi su molte applicazioni: per esempio, non puoi scrivere un corso di turco in francese senza perdere i caratteri speciali di una lingua. C'è accordo generale sul fatto che, prima o poi, tutti si sposteranno a Unicode. Ci sono molte implementazioni di Unicode, e UTF-8 è la più popolare su Linux; Windows® si affida invece alla più ingombrante e meno flessibile UCS-2. Alcune distribuzioni, come RedHat, hanno già cominciato a impostare la loro codifica predefinita a UTF-8, e quindi ti potrebbe interessare molto usare l'argomento utf8x per il pacchetto inputenc. + + + + Il pacchetto &ucs; + Se non hai il pacchetto &ucs;, puoi procedere come segue: + + Prendi il pacchetto &ucs; dalla pagina Web per il supporto Unicode per &latex;, di Dominique Unruh dell'università di Karlsruhe. + + Per installarlo, scompatta il file scaricato e mettilo in una cartella elencata nella tua variabile d'ambiente $TEXINPUTS. Questa può essere impostata anche all'interno di &kile;. + + + + \usepackage{ucs} + \usepackage[utf8x]{inputenc} + + + + + + Supporto &cjk; + + Aggiungere il supporto per le lingue ideografiche è piuttosto complicato. Tuttavia, una volta che hai finito, funzionerà piuttosto bene. Oltre a installare dei pacchetti, c'è da fare del lavoro di configurazione aggiuntivo. + + La tua distribuzione Linux potrebbe già avere un pacchetto &cjk; (cinese, giapponese, coreano) pronto per te, quindi ti potresti risparmiare la fatica di installare tutto a mano. Controlla prima di andare avanti! + + C'è la possibilità di usare il pacchetto &ucs; per scrivere brevi inserti di testo &cjk;, ma quell'opzione è seriamente limitata perché non gestisce, tra l'altro, i ritorni a capo. Noi invece installeremo il pacchetto &cjk;-&latex; completo e lo faremo funzionare sia per &latex; che per &pdflatex;. Molto di questo materiale è stato ispirato alla pagina Web su come configurare &pdflatex; di Pai H. Chou. + + + + Scarica il pacchetto &cjk;. Copiane i file scompattati in una sottocartella appropriata di $TEXMF, come hai fatto prima per il pacchetto &ucs; (vedi ). I file saranno scompattati in una cartella CJK/X_Y.Z, non è fondamentale che li estrai, anche se ti sarà poi più facile mantenerli. + + Adesso devi scaricare un tipo di carattere che supporti tutti i caratteri &cjk; di cui hai bisogno. Puoi scegliere qualsiasi file *.ttf che li contenga, ma in questa guida useremo Cyberbit. Scompatta il file e rinomina Cyberbit.ttf in cyberbit.ttf, perché le maiuscole potrebbero confondere il tuo sistema. + Posiziona cyberbit.ttf in una cartella insieme a Unicode.sfd, e genera i file *.tfm e *.enc con il comando $ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@. Per qualche motivo, a volte questo non produce le centinaia di file che dovrebbe. Se fosse il tuo caso, puoi scaricare sia i file *.tfm che *.enc. + Posiziona i file *.tfm in una cartella appropriata, diciamo $TEXMF/fonts/tfm/bitstream/cyberbit/; i file *.enc possono essere installati in $TEXMF/pdftex/enc/cyberbit/. + + Adesso abbiamo bisogno di un file di mappatura per connettere i file *.enc al tipo di carattere. Scarica cyberbit.map e installalo in $TEXMF/pdftex/config/. + + Scarica un altro file, c70cyberbit.fd, e posizionalo in una cartella appropriata. Puoi scegliere, per esempio, $TEXMF/tex/misc/. + + L'ultimo file che dobbiamo generare è un tipo di carattere PostScript Type 1, necessario per leggere i file DVI generati con &latex;. Esegui il comando $ ttf2pfb cyberbit.ttf -o cyberbit.pfb, e copia il file risultante cyberbit.pfb in una cartella come $TEXMF/fonts/type1/cyberbit/. + + Ora mettiamo cyberbit.ttf tra i tipi di carattere dove &latex; lo può trovare. Puoi posizionarlo in una cartella di nome $TEXMF/fonts/truetype/. + + Controlla il file di configurazione che trovi a $TEXMF/web2c/texmf.cnf, e assicurati che la riga contenente TTFONTS non sia commentata e punti alla cartella dove hai salvato cyberbit.ttf. + + Per fare sì che &pdflatex; usi i tuoi caratteri &cjk;, è necessario che aggiungi una riga nel file di configurazione $TEXMF/pdftex/config/pdftex.cfg. Aggiungi map +cyberbit.map nel file per completare la configurazione di &pdflatex;. + + Per configurare &latex; in modo da poter produrre file DVI con caratteri &cjk;, devi aggiungere una riga nel file ttfonts.map. Il file potrebbe essere in una cartella di nome $TEXMF/ttf2pk/, ma probabilmente dovrai cercarlo. Aggiungici la riga cyberbit@Unicode@ cyberbit.ttf. + + Adesso, devi solo eseguire texhash e il sistema dovrebbe essere pronto. + + + + Per controllare se la tua configurazione è corretta, puoi provare a compilare questo file di testo. + + + Risoluzione dei problemi con &cjk; + + Ci sono molte cose che possono andare storte quando si imposta il supporto &cjk; manualmente. Se qualcosa sembra non funzionare, l'elenco seguente ti potrebbe aiutare. + + + + Ovviamente, siccome usi &latex; come utente e non come root, devi permettere agli utenti normali di accedere ai nuovi file. Assicurati che tutte le cartelle e i file siano accessibili usando il comando chmod. + + Se &latex; scrive un DVI senza problemi, ma non può visualizzarlo, è quasi sicuramente a causa di problemi nella generazione automatica dei caratteri *.pk. Dovrebbero essere generati al volo quando si visualizza un file DVI, ma ciò potrebbe non riuscire per vari motivi: per prima cosa ricontrolla accuratamente di aver inserito la nuova riga in ttfonts.map. Tuttavia, potrebbe capitare che il tuo comando ttf2pk, che è normalmente chiamato dal visore DVI, sia stato compilato senza supporto per le librerie kpathsea. Se è questo il caso, $ ttf2pk --version non nominerà kpathsea. Siccome il supporto di queste librerie è necessario, potresti dover trovare un nuovo pacchetto, o ricompilare da te FreeType 1. + + + + + + + + + Come scrivo &cjk; in Unicode? + + Ci sono una serie di diversi motori di inserimento, e la scelta può dipendere anche dai gusti personali. L'autore usa Skim, un trasferimento su &kde; del motore Scim. Riferisciti alla documentazione della tua distribuzione per sapere come installare questi programmi. Anche la configurazione di questi programmi può essere difficile, nel caso di Skim dovrai definire una variabile d'ambiente XMODIFIERS="@im=SCIM" prima di avviare X. + + + + + + + + + + Script + + + + Script con &kile; + + La funzionalità di script di &kile; permette l'esecuzione di codice ECMAScript. Gli script possono essere gestiti con il pannello degli script nella barra laterale. + + + + + + Riferimento API + + In questa sezione descriviamo l'interfaccia alla programmazione di script di &kile;. + + + Nota che l'API degli script non è stata ancora completata. L'API descritta sotto potrebbe cambiare in versioni successive di &kile;. + + + Innanzi tutto, l'ambiente di esecuzione di script di &kile; fornisce un oggetto globale chiamato kile, che ha i seguenti metodi: + + + + (kile).currentTextDocument() + + Restituisce un oggetto KileTextDocument che riflette il documento di testo attualmente attivo. Restituisce null se nessun documento di testo è attivo. + + + + (kile).getInputValue(didascalia, etichetta) + + Apre una finestra con la didascalia e l'etichetta date. Restituisce il valore inserito dall'utente. + + + + + Gli oggetti del tipo KileTextDocument rappresentano i documenti di testo di &kile;, e hanno le seguenti proprietà: + + + + (KileTextDocument).backspace() + + Elimina il carattere posizionato immediatamente prima della posizione attuale del cursore e sposta il cursore una posizione indietro nel testo. + + + + (KileTextDocument).cursorLeft() + + Sposta il cursore di una posizione indietro nel testo. + + + + (KileTextDocument).cursorRight() + + Sposta il cursore di una posizione avanti nel testo. + + + + (KileTextDocument).insertText(testo) + + Inserisce il testo contenuto nella variabile testo nel documento alla posizione attuale del cursore. + + + + (KileTextDocument).insertBullet() + + Inserisce un elemento di una lista a puntata nel documento alla posizione attuale del cursore. + + + + (KileTextDocument).nextBullet() + + Seleziona il primo elemento di una lista puntata nel documento dopo la posizione attuale del cursore. + + + + (KileTextDocument).previousBullet() + + Seleziona il primo elemento di una lista puntata nel documento prima della posizione attuale del cursore. + + + + (KileTextDocument).up() + + Sposta il cursore di una riga in su nel documento. + + + + (KileTextDocument).down() + + Sposta il cursore di una riga in giù nel documento. + + + + (KileTextDocument).cursorLine() + + Restituisce la riga sulla quale si trova il cursore. + + + + (KileTextDocument).cursorColumn() + + Restituisce la colonna sulla quale si trova il cursore. + + + + (KileTextDocument).setCursorLine(riga) + + Sposta il cursore alla riga indicata da riga. + + + + (KileTextDocument).setCursorColumn(colonna) + + Sposta il cursore alla colonna indicata da colonna. + + + + + + + + + + + Aiuto + + + + Documenti di aiuto + + &latex; è un sistema piuttosto sofisticato, dove le funzionalità di base possono essere espanse da una moltitudine di pacchetti aggiuntivi. &kile; fornisce molti aiuti diversi per supportare l'utente. + + + + + Riferimento LaTeX + Un indice alfabetico dei comandi &latex; più comuni. + + + + Documentazione TeX + &tetex; e &texlive; includono una gran quantità di documenti. Ciò comprende una documentazione per tutti i pacchetti inclusi e un riferimento &latex; aggiuntivo. + + + + LaTeX + Un riferimento completo per &tex; e compagnia. Non è solo una descrizione di tutti i programmi, sono inclusi anche alcuni pacchetti importanti. Include anche un manuale di riferimento completo dei comandi &latex;, ideale per cercare un particolare comando di formattazione quando si scrive un documento. Siccome questo documento è molto grande, &kile; lo separa con tre segnalibri importanti. + + + + Comando LaTeX + Un altro indice alfabetico dei comandi &latex; più comuni. + + + + Soggetto LaTeX + Una descrizione dei soggetti &latex; più importanti. + + + + Ambienti LaTeX + Un indice alfabetico degli ambienti &latex; più comuni. + + + + + + + + + Aiuto contestuale + + &kile; supporta anche un aiuto contestuale, richiamato con &Ctrl;&Alt;H,K. In impostazioniConfigura Kile...KileAiuto puoi scegliere se vuoi usare il riferimento &latex; di &kile; o il sistema di aiuto di &tetex; o &texlive;, che è l'impostazione predefinita. + + + Punti + + + + + + Punti + + + + + + + + + Ricerca delle parole chiave + + Non è sempre facile trovare il documento giusto, perché &tetex; e &texlive; includono una quantità impressionante di documenti. Un aiuto possibile è che &tetex; e &texlive; forniscono un programmino, texdoctk. Contiene una banca dati dei documenti che &kile; usa per offrirne un'interfaccia. + + + Punti + + + + + + Punti + + + + + Tutti i documenti sono raggruppati in alcune categorie, e il vantaggio principale è che puoi cercare i nomi dei pacchetti o delle parole chiave. Quindi, &kile; mostrerà solo i risultati. + + + Punti + + + + + + Punti + + + + + Un clic doppio del mouse o del tasto Spazio avvierà il visore del documento. Questo può essere un documento qualsiasi, non solo un documento DVI, PS, PDF o HTML. &kile; userà le impostazioni di &konqueror; per avviare un visore appropriato. + + + + + + + Aiuto definito dall'utente + + Oltre alla documentazione statica di &tetex; e &texlive;, &kile; supporta anche un'altra modalità variabile per i documenti di aiuto all'utente. Nel menu Aiuto, &kile; ha un sottomenu speciale Aiuto dell'utente, dove l'utente può aggiungere dei documenti a sua scelta. Questi possono essere i documenti &tetex; o &texlive; più importanti o anche documenti scritti da sé. È anche possibile scegliere degli &url; Web. + + Vai a ImpostazioniConfigura Kile...KileAiuto e scegli il pulsante Configura per configurare questo menu Aiuto dell'utente. Puoi aggiungere, rimuovere o navigare nelle voci, e anche inserire dei separatori per avere una struttura migliore. + + Premere il pulsante Aggiungi aprirà un'altra finestra, dove devi modificare il nome della voce del menu e scegliere il file corrispondente o &url; Web. Se scegli un &url; Web, verrà avviato &konqueror;, e dovresti copiare l'&url; finale. + + + Punti + + + + + + Punti + + + + + + + + + + + Riconoscimenti e licenza + + &kile; è un editor di codice sorgente &latex; e &tex; open source e facile da usare. Funzionerà sui sistemi con ambiente desktop &kde; installato. &kde; è disponibile per diverse architetture con Linux e altri sistemi simili a Unix. &kile; è anche parte del progetto Fink, il che vuol dire che puoi far funzionare &kile; anche su un Mac con OS-X. + + Molti ringraziamenti sono dovuti a tutti coloro che lavorano per continuare il progetto &kile;, per le molte ore contribuite a sviluppare gli strumenti che possiamo usare tutti sotto la licenza GNU. Le informazioni aggiornate sui partecipanti si trovano nella finestra Informazioni su &kile; nel menu Aiuto. + + Contributi da, tra gli altri: Rob Lensen, Roland Schulz, Michael Margraf, Holger Danielsson + + Molte grazie a tutti i partecipanti! +&underFDL; &underGPL; + + +&documentation.index; + + diff --git a/doc/it/snap_autocomplete.png b/doc/it/snap_autocomplete.png new file mode 100644 index 0000000..288eabd Binary files /dev/null and b/doc/it/snap_autocomplete.png differ diff --git a/doc/it/snap_compile_error.png b/doc/it/snap_compile_error.png new file mode 100644 index 0000000..25478d0 Binary files /dev/null and b/doc/it/snap_compile_error.png differ diff --git a/doc/it/snap_editusertag.png b/doc/it/snap_editusertag.png new file mode 100644 index 0000000..7b238c3 Binary files /dev/null and b/doc/it/snap_editusertag.png differ diff --git a/doc/it/snap_encoding.png b/doc/it/snap_encoding.png new file mode 100644 index 0000000..8212cc0 Binary files /dev/null and b/doc/it/snap_encoding.png differ diff --git a/doc/it/snap_kdvi_settings.png b/doc/it/snap_kdvi_settings.png new file mode 100644 index 0000000..833a5c2 Binary files /dev/null and b/doc/it/snap_kdvi_settings.png differ diff --git a/doc/it/snap_projectview.png b/doc/it/snap_projectview.png new file mode 100644 index 0000000..d4e2659 Binary files /dev/null and b/doc/it/snap_projectview.png differ diff --git a/doc/it/snap_projectview_add.png b/doc/it/snap_projectview_add.png new file mode 100644 index 0000000..62b164f Binary files /dev/null and b/doc/it/snap_projectview_add.png differ diff --git a/doc/it/snap_ref_choose.png b/doc/it/snap_ref_choose.png new file mode 100644 index 0000000..3b1424f Binary files /dev/null and b/doc/it/snap_ref_choose.png differ diff --git a/doc/it/snap_ref_select.png b/doc/it/snap_ref_select.png new file mode 100644 index 0000000..9b8faed Binary files /dev/null and b/doc/it/snap_ref_select.png differ diff --git a/doc/it/snap_sidebarmenu.png b/doc/it/snap_sidebarmenu.png new file mode 100644 index 0000000..2d4c02d Binary files /dev/null and b/doc/it/snap_sidebarmenu.png differ diff --git a/doc/it/snap_structview_label.png b/doc/it/snap_structview_label.png new file mode 100644 index 0000000..002e1a6 Binary files /dev/null and b/doc/it/snap_structview_label.png differ diff --git a/doc/it/snap_usertag.png b/doc/it/snap_usertag.png new file mode 100644 index 0000000..f9e4043 Binary files /dev/null and b/doc/it/snap_usertag.png differ diff --git a/doc/it/snap_wizardry.png b/doc/it/snap_wizardry.png new file mode 100644 index 0000000..d690c93 Binary files /dev/null and b/doc/it/snap_wizardry.png differ diff --git a/doc/nl/Makefile.am b/doc/nl/Makefile.am new file mode 100644 index 0000000..d9cd6d2 --- /dev/null +++ b/doc/nl/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = nl +KDE_DOCS=kile diff --git a/doc/nl/index.docbook b/doc/nl/index.docbook new file mode 100644 index 0000000..f90eae5 --- /dev/null +++ b/doc/nl/index.docbook @@ -0,0 +1,2909 @@ + +Kile"> + ATEX"> + EX"> + teTEX"> + EX"> + GnuPlot"> + KDE"> + KDVI"> + pyBliographer"> + gBib"> + makeidx"> + Kate"> + XFig"> + + + + +]> + + + + +Het handboek van &kile; + + + JonathanPechta
jrpechta@yahoo.com
 + FedericoZenith
zenith@chemeng.ntnu.no
 + JeroenWijnhout
Jeroen.Wijnhout@kdemail.net
+ + + + +&Claire.Lotion;&Tom.Albers; + + +2003 +Jonathan Pechta + + + +20032004 +Federico Zenith + + +2003-11-29 +1.6 + + +&FDLNotice; + + + +&kile; is een broncode-editor voor &latex;, een &tex;-shell en een frontend voor &gnuplot;. + + + +KDE +kdenonbeta +Kile +LaTeX +TeX + + + + + + +Inleiding + + + + Vereisten + + Om &kile; uit te voeren, dient u de volgende componenten op uw systeem geïnstalleerd te hebben: + + + Trinity Desktop Environment (&tde;): &tde; is een populaire open-source desktop environment. + Qt: QT is een hulpmiddel voor ontwikkeling met C++ en is nodig om &kile; te compileren. + &latex;: programma van hoogwaardige kwaliteit om documenten te zetten. Hoogst waarschijnlijk hebt (of wilt) u het pakket &tetex;, aangezien u op een UNIX-gelijkend systeem werkt. + + + Optionele pakketten: + + + &kdvi;: viewer voor DVI-bestanden voor &kde;. + &gnuplot;: wettenschappelijk pakket om te plotten. + &xfig;: tekenprogramma voor X. + + + Een aantal van deze componenten maakt misschien deel uit van uw Linux-distributie; raadpleegt u hiervoor de documentatie bij uw distributie, of raadpleeg de installatie-cd of -dvd, om deze pakketten op uw computer te installeren. + + Het project &kile; bevat een aantal binaire pakketten van &kile; voor verschillende distributies. Deze zijn eenvoudig te installeren zonder dat u ze hoeft te compileren. Kijk voor meer informatie op de webpagina van &kile;. + + + + + + Beoogd publiek + + Dit handboek is bedoeld voor iedereen, ongeacht zijn of haar ervaring met &latex;, &kde;, &kile; of Linux. + + Gevorderde gebruikers zullen dit handboek waarschijnlijk niet gebruiken, maar alle suggesties voor de documentatie zullen in ogenschouw genomen worden. Indien u een bijdrage zou willen leveren aan dit project of de documentatie, raadpleeg dan de webpagina van &kile;. Commentaar betreffende de documentatie kan gestuurd worden aan zenith@chemeng.ntnu.no. + + Antwoorden nodig over &kile;? Vastgelopen bij het compileren? Wilt u een nieuwe functie? Stel technische vragen of start een discussie bij voorkeur op onze mailinglijst: kile-devel@lists.sourceforge.net. + + + + + + + + Inleiding + + + + Basisfeiten + + + + Over &kile; + + &kile; is een geïntegreerde omgeving voor &latex; voor de &kde;-desktop. &kile; geeft u de capaciteit om alle functionaliteiten van &latex; te gebruiken in een grafische interface, die u eenvoudige, directe, en aangepaste toegang geeft tot alle programma's voor het compileren, nabewerken, debuggen, converteren van &latex; en tot hulpprogramma's om het bekijken. U krijgt ook een uiterst praktische assistent, een &latex;-referentie, interfaces met &gnuplot; en &xfig; en projectbeheer. + + + + + + Wat is &latex; + + &latex; is een tekstverwerkingssysteem afgeleid van &tex;, een programma dat oorspronkelijk ontwikkeld is in 1977 door Donald Knuth om auteurs te helpen hun werk professioneel op te maken en werk te krijgen dat lijkt op dat van een zetter; de zetter stileert professioneel de opmaak van een document volgens de specificaties voor het type document. &latex; werd door Leslie Lamport gecreëerd om auteurs een automatische zetter te geven, vooral wanneer het aankwam op het dure en nauwkeurig zetten van mathematische formules en expressies, die niet bij toeval omsloten worden door dollartekens in &latex;. Vandaag de dag, laten tekstverwerkingsprogramma's iedere gebruiker een zetter zijn; maar wat u vaak wilt, is een document dat goed oogt, en geen document waar u uren aan besteedt om het er goed uit te laten zien. &latex; neemt deze last op zich, en laat u denken aan het document, niet aan de opmaak. En ja, het zal er goed uitzien! + + + + + + Hoe spreek je het uit? Waarom die rare typografie? + + Er is een rare traditie van &tex;-gerelateerde pakketten om de vreemdst mogelijke uitspraak en typografie mogelijk te hebben. &tex; werd geacht van het Griekse τεχ gehaald te zijn, in Latijnse letters tech. Er zijn veel verklaringen waarom, maar de meest waarschijnlijke is omdat &latex; van origine bedacht werd voor technische rapporten en zijn belangrijkste vermogen inderdaad het correct en eenvoudig zetten van mathematische formules was, toen een uiterst dure, tijdrovende en frustrerende zaak. + De uitspraak dient als volgt te zijn: T zoals u zou verwachten, E zoals is in zet, en X zoals in het Duitse ich. Als u niet weet hoe ch klinkt, het klinkt min of meer als een sissende kat; het IPA-symbool is /ç/. Veel mensen rapporteren de andere uitspraak van ach (IPA-symbool /x/), maar ik heb het persoonlijk aan een aantal Grieken gevraagd, en zij bevestigen de eerste versie. U dient zich ervan bewust te zijn dat een groot aantal mensen het verkeerd uitspreken als /teks/ of /tek/. + Tenslotte, in &latex; wordt de eerste letter LA uitgesproken als lay: het idee is dat, terwijl het ruwe &tex; moeilijk is, zelfs een layman (leek) er &latex;-macro's kan gebruiken. Een minder inspirerende, maar meer realistische verklaring is dat het afgeleid is van de achternaam van Leslie Lamport, de schepper van &latex;. Nu weet u het! + + + + + + + + &latex; 101 + + Het &latex;-typografiesysteem lijkt op andere markeertalen zoals XML, dat gebruikt wordt voor vele types documenten (inclusief dat wat u nu aan het lezen bent), of HTML, dat gebruikt wordt voor webpagina's. Het algemene idee is om op speciale wijze omsloten trefwoorden te gebruiken, tags genaamd, die aan een programma vertellen hoe de tekst gepresenteerd dient te worden. &kile; biedt u een flink aantal van dergelijke tags in het menu LaTeX in de menubalk. + + Alhoewel we trachten u een goede indruk te geven van wat &latex; is, is dit niet Het Definitieve Boek over &latex;. Als u goed &latex; wilt leren, wilt u wellicht een boek lenen uit uw bibliotheek. De schrijver heeft een goede ervaring met A Guide to &latex; geschreven dor H. Kopka en P.W. Daly, en houdt het nog steeds op de boekenplank. + + Evenals andere markeertalen, bevat &latex; een preambule, dat de globale commando's instelt, zoals papiergrootte, paginanummering, dimensies van de tekst op de pagina en een body, die start met het commando \begin{document}, en zoals goed te voorspellen is afgesloten wordt met het commando \end{document}. + + + + + + De belangrijkste kenmerken van &kile; + + + + Snelstart + + De assistent die is ingebouwd in &kile; is een nuttige functie om snel te beginnen documenten te maken in &kile;. Het kiezen van de assistent uit de menubalk levert u een aantal keuzemogelijkheden voor het aanmaken van uw document: artikel, boek, brief, rapport of leeg. U kunt ook meteen een aantal opties specificeren die gerelateerd zijn aan het document. + + Opties van de assistent: + + + Documentklasse: kies het type document dat u wilt aanmaken: artikel, brief, boek of een ander met aangepaste definitie. + Tekengrootte: vertelt &kile; welke tekengrootte in punten u wilt gebruiken. + Papiergrootte: kiest de grootte of stijl van bladen. + Codering: u zult bijna altijd Latin 1 of UTF-8 als codering willen gebruiken, omdat deze u toestaan direct woorden in te voeren zoals naïveté, en niet via de ASCII-ficatie na\"\ivet\'e; er zijn echter veel meer opties beschikbaar, zoals Latin 5 of Turks. + Auteur: schrijf hier uw naam op. + Titel: voeg hier uw documenttitel toe. + Overige opties: dit staat u toe verder opties in te stellen zoals printen, concept, en andere. + + + + + + + Voorgedefinieerde sjablonen + + De voorgedefinieerde sjablonen in &kile; zijn: + + + Leeg document: echte mannen beginnen met helemaal niets! + Artikel: stelt de opmaak artikel in, voor een document dat kort genoeg is om niet in hoofdstukken opgedeeld te hoeven worden. + Rapport: stelt de opmaak rapport in, voor een middelgroot document, bijvoorbeeld met paginanummering op de buitenste rand van de pagina. + Boek: stelt de opmaak boek in, een volwaardige variant, die zo krachtig is dat hij gebruikt wordt om veel leerboeken voor de universiteit te schrijven. + Brief: stelt de opmaak brief in, dat automatisch die vervelende inspringen kan aanbrengen die niemand echt onthoudt. + + + Nieuwe gebruikers hoeven zich geen zorgen te maken, dit is slechts een korte beschrijving van de functies, en er zal later meer aandacht aan besteed worden om deze taken tot in het detail uit te voeren in . + + + + + + Accentuering van de syntaxis + + &kile; lijkt op programma's die met broncode en editing omgaan, en accentueert commando's, opties en onderdelen die gebruikt en misbruikt worden. &kile; maakt het zo mogelijk om op eenvoudige wijze probleemgebieden te ontdekken: bijvoorbeeld, wanneer u ziet dat grote delen van de tekst groen zijn geworden, dan heeft u waarschijnlijk ergens vergeten een wiskundige omgeving te sluiten. U zou sowieso opgemerkt hebben hoe waardeloos het uitvoerbestand eruit zou hebben gezien, maar accentuering bespaart u echt tijd en frustraties. + + + + + + Automatische aanvulling van omgevingen + + Het automatisch aanvullen van omgevingen houdt in dat, wanneer u met een nieuwe omgeving begint door \begin{environment} in te typen, &kile; automatisch het bijbehorende commando \end{environment} invoegt, met een regel ertussen voor uw tekst. U kunt het natuurlijk deactiveren als u dat wilt in Instellingen &kile; instellen...LaTeX. + + + + + + Het element spring naar structuur + + Alle documenten worden normaliter gestructureerd in een zekere hiërarchie. &latex; staat u toe documenten op te breken in de volgende hiërarchie (met deel (part) als hoogste in de hiërarchie, en sub-alinea (subparagraph) als laagste): + + + \part + \chapter + \section + \subsection + \subsubsection + \paragraph + \subparagraph + + + Wanneer u een document in de weergave Structuur bekijkt, kunt u tussen de tekstelementen springen door te klikken op het element dat u wilt zien. + + + + + + Terugzoeken (Inverse search) + + Wanneer u uw eigen &latex;-bestand maakt, kan inverse search (terugzoeken) zeer nuttig zijn. Zodra u DVI-bestand (DeVice Independent File) hebt gemaakt, zal &kile;, wanneer u in de DVI-viewer de middelste muisknop indrukt, naar de overeenkomstige regel in de &latex;-broncode springen. + + Een DVI-bestand is een type bestand dat een beschrijving bevat van een opgemaakt document, samen met andere informatie , waaronder het lettertype, en de gebruikelijke uitvoer van &tex; of &latex;. Er bestaat een aantal hulpmiddelen om DVI-bestanden te bekijken en uit te printen op uiteenlopende systemen en apparaten. Een DVI-bestand is soms ook bekend als een meta-bestand. + + + + + + Vooruit zoeken (Forward Search) + + Wanneer gebruik gemaakt wordt van inverse search, wordt de selectie van onderdelen in het DVI-bestand geassocieerd met de editor. Dus wanneer u op een DVI-bestand klikt, springt het hoofdvenster naar de overeenkomstige sectie van de &latex;-code in de editor. Vooruit zoeken is precies het tegenovergestelde hiervan. Vooruit zoeken staat u toe op een specifiek deel van de tekst in de &latex;-code aan te klikken, en te springen naar de hiermee geassocieerde positie in het venster van de DVI-viewer. + + + + + + + + De taakbalk: een referentiegids voor functies + + + Nieuw: begin een nieuw document. + Openen: open een nieuw document. + Sluiten: sluit het document af. + Huidig document als hoofddocument definieren: dit wordt gebruikt wanneer met meerdere bestanden gewerkt wordt. Het hebben van een hoofddocument laat u eenvoudiger werken met andere .tex-bestanden die in uw document zijn opgenomen. + Snel bouwen: compileert uw broncode in &latex; en toont automatisch de resultaten, tenzij u fouten in de code heeft zitten. + Bestanden observeren: deze modus "observeert" of het DVI-bestand veranderingen bevat, en zal geen nieuwe sessie van &kdvi; opstarten na Snel bouwen. + Logbestand tonen: laat u het .log-bestand zien, zodat u fouten kunt ontdekken. + Vorige LaTeX-fout: springt achterwaarts door het .log-bestand en accentueert fouten in de broncode. + Volgende LaTeX-fout: springt voorwaarts door het .log-bestand en accentueert fouten in de broncode. + Stoppen: breekt de huidige functie af. + LaTeX: voert het commando &latex; uit op het actieve document. + DVI tonen: start de DVI-viewer op. + DVI naar PS: converteert een DVI-bestand naar een PostScript-bestand (PS). + PS tonen: start de PostScript (PS) viewer op. + PDFLaTeX: maakt een pdf-bestand van &latex;-code, indien u een &latex;-header hebt. + PDF tonen: laat u het pdf-bestand zien. + DVI naar PDF: converteert een DVI- naar een pdf-bestand. + PS naar PDF: converteert een ps- naar een pdf-bestand. + LaTeX naar HTML: genereert HTML-code van &latex;-code. + HTML tonen: toont gegenereerde HTML. + Kdvi vooruit zoeken: springt naar een pagina die overeenkomt met de huidige regel in de editor. + + + Als u naar de werkbalk Bewerken kijkt, zult u drie lange menu's opmerken. De menu's zijn voor u ontwikkeld om snel bepaalde veelvoorkomende functies aan uw document te kunnen toevoegen. Het eerste vak wordt gebruikt om uw document te verdelen in delen, hoofdstukken, paragrafen enzovoorts. De beschikbare commando's om segmenten aan uw &latex;-broncode toe te voegen zijn: + + + Gedeelte: hoogste indelingsniveau voor een document. + Hoofdstuk: begint een nieuw hoofdstuk. + Sectie: maak een nieuwe paragraaf. + Subsectie: maak een nieuwe subparagraaf. + Subsubsectie: een secundaire paragraaf, qua hiërarchie tussen subparagraaf en alinea in. + Paragraaf: maak een nieuwe alinea. + Subparagraaf: maak een nieuwe subalinea. + + + Het uitvouwveld genaamd label wordt gebruikt om zaken aan uw document toe te voegen, zoals indexen, voetnoten, en referenties. De beschikbare commando's zijn: + + + label: een commando dat een label produceert voor hoofdstuk, een figuur of een ander element. + index: maak een ingang voor de index aan. + voetnoot: maakt een voetnoot in uw document. + ref: wordt gebruikt om te verwijzen naar een voorgedefinieerd label, dat u kunt kiezen uit een uitvouwlijst. + pageref: net als ref, maar verwijst naar een pagina in plaats van een structuurelement. + cite: maakt een referentie aan met gegevens uit een bibliografie. + + + + Het menu Label + + + + + + Het menu Label + + + + + + Het label selecteren voor een verwijzing + + + + + + Het label selecteren voor een verwijzen + + + + + Wanneer u cite gebruikt, wordt er een uitvouwlijst met bib-items gepresenteerd, maar als u &bibtex; gebruikt zal dit alleen werken wanneer het bestand onderdeel uitmaakt van een Project. U kunt dan &gbib; of &pybliographer; gebruiken, of het met de hand doen. + + Het uitvouwvak dat het label tiny draagt, wordt gebruikt om de grootte van de tekst in te stellen. U kunt de grootte van de hoofdtekst of voetnoten, enz. instellen. De beschikbare commando's zijn: + + + tiny: kleinst. + scriptsize: zeer klein. + footnotesize: kleiner. + small: klein. + normalsize: normaal. + large: groot. + Large: groter. + LARGE: nog groter. + huge: nog steeds groter. + Huge: grootst. + + + + + + + + + Snelstart + + + + Een document in &latex; schrijven voor beginners + + Gebruikers van &kile; hebben twee keuzes wanneer ze aan een nieuw document beginnen: ze kunnen de Assistent gebruiken om een nieuw document te beginnen, aangeven welk type document zie zouden willen maken en opties zoals lettertype, papiergrootte, enzovoorts; of anders kunnen ze de code handmatig invoeren. + + + \documentclass[12pt]{article} + \begin{document} + Hier is wat broncode voor tekst geschreven in LaTeX. + \end{document} + + Ieder document in &latex; begint met het commando \documentclass{TypeOfDocument}, tenzij u een oudere versie van &latex; gebruikt; dan is het commando \documentstyle{TypeOfDocument}. Er zijn momenteel twee versies van &latex; die veel voorkomen en die u tegen kunt komen: versie 2.09, die gebruik maakt van \documentstyle, en versie 2ε, die \documentclass gebruikt om een document te beginnen. Het commando \documentclass volgt altijd de syntaxis \documentclass[optional argument]{class}. + + Door de voorbeeldcode hierboven uit het tekstvak in te typen krijgt u de volgende uitvoer: + + + Hier is wat tekst geschreven in LaTeX-code. + + + De haakjes die na het commando \documentclass komen bevatten de opties voor het commando. De optie [12pt] stelt de grootte in van het lettertype voor uw artikel; als u de tekengrootte niet in het begin instelt, kunt u het later in de tekst instellen. + + Zodra u het codevoorbeeld uit het kader hierboven hebt ingetypt, zult u uw &latex;-broncode moeten compileren. De meest eenvoudige manier voor u om &latex; te compileren is gebruik te maken van het menu Bouwen, of door de knop Snel bouwen te gebruiken. + + Alt2 is de sneltoetscombinatie om uw broncode te compileren. + + U dient uw broncode op te slaan voor u kunt compileren. &kile; zal dit automatisch voor u doen. + + Controleert u het logbestand, indien uw document niet werd gecompileerd. Wanneer u de knop Snel maken gebruikt, dient de viewer &kdvi; automatisch geopend te worden; bekijkt u het logbestand, als dit niet gebeurt. + + + + + Omgevingen + + Een omgeving is een deel van de tekst dat anders behandeld wordt dan de rest van het document. Bijvoorbeeld wanneer u een rapport wilt maken met tekengrootte 12, maar u voor een paar regels de tekengrootte wenst aan te passen. De commando's \begin{environment}, \huge en \end{environment} laten u tijdelijk de tekst aanpassen binnen de omgeving tot "zeer groot". + + Veranderingen hebben alleen effect tussen \begin{environment} en \end{environment}. U kunt een onbeperkt aantal veranderingen maken binnen een omgeving. + + Er zijn veel attributen die u aan uw document kunt toevoegen om de tekst leesbaarder en gebruikersvriendelijker te maken. U kunt attributen aan uw document toevoegen zoals speciale lettertypen, vet, cursief, onderstreept, enz., en deze commando's zullen eindigen met commando \end, of aan het einde van uw omgeving. + + + \begin{emph} of \begin{em}: dit commando maakt de tekst cursief, en is actief tot in de code een commando \end{em}, \end{emph} of een andere omgeving wordt aangetroffen. Om één woord in een zin cursief te maken kunt u gebruik maken van de schrijfwijze: dit is \em{mijn} zin. + \bfseries{Ik maak deze tekst binnen de accolades vet}: dit commando maakt uw tekst vetgedrukt. Het commando vetgedrukt loopt zal doorwerken totdat een afsluitende accolade is gevonden. + \quote: om een citaat te maken in uw document; begin uw citaat met \begin{quote} en sluit het af met \end{quote}. + \center: centreert de tekst. + \verse: laat de tekst inspringen, bijvoorbeeld voor gedichten. + \itemize: maakt een lijst of opsomming met opsommingsteken. + + + + + + + &kile; gebruiken + + Nu we u enige achtergrond gegeven hebben over hoe u broncode kunt schrijven met de markeringstaal &latex;, zullen we u stap voor stap laten zien hoe u een document kunt maken met behulp van &kile;. + + + Start &kile; op. + Maak een document aan met BestandNieuwLeeg document. + Selecteer AssistentSnelstart, kies dan een formaat, en vul uw voorkeuren in de assistent in. + Breng, zodra de assistent tekst heeft ingevoegd, wat aanpassingen aan om het document leesbaarder te maken, voeg minimaal één citaat toe, wat vetgedrukte tekst, cursieve, en een vers om het verschil tussen de commando's te zien. + Sla uw bestand op onder de naam intro.tex. + Bouw uw document met Alt 2 of met de knop met de label LaTeX. + Selecteer DVI bekijken. + Bekijk al uw nieuwe tekst. + Wanneer u de ingebedde viewer gebruikt, kunt u, wanneer u klaar bent met het document te bekijken, op de knop Editor-weergave klikken om terug te keren naar de editor . Of sluit het venster van de viewer af als u een aparte viewer gebruikt. + + + Dat is het! U heeft zojuist uw eerste document in &latex; geschreven! + + Zodra u uw DVI-bestand heeft gemaakt, kunt u, als u dat wilt, uw document afdrukken, of het converteren naar een postscript- of pdf-bestand. Experimenteert u hier maar mee en veel plezier! + + + + + + DVI-bestanden + + DVI staat voor DeVice Independent bestand. Dit type bestand wordt gegenereerd door &tex; of &latex; om ingelezen te worden door een driver op uw computer. Er zijn veel verschillende typen uitvoer waar een .DVI-bestand naartoe gestuurd kan worden, zoals een printer, postscript- of pdf-bestand omzetter, of naar uw beeldscherm. + + + + Een DVI-bestand bekijken + + U heeft reeds gezien hoe u een DVI-bestand op het scherm kunt bekijken door gebruik te maken van de knop DVI-bestand bekijken op de werkbalk. + + + + + + Een DVI-bestand afdrukken + + U kunt dezelfde procedure gebruiken om een DVI-bestand uit te printen als die u gebruikt hebt om uw document te maken (zie ). Selecteer dan bij stap 7, na het klikken op DVI-bestand bekijkenBestandAfdrukken in de viewer. Als uw printer goed is geconfigureerd kunt u het DVI-bestand afdrukken. + + + + + + Handmatig afdrukken van een DVI-bestand vanuit de console + + Gebruik om een DVI-bestand handmatig af te drukken van een console eerst het commando dvips intro.dvi. Dit commando zal uw DVI-bestand omzetten in een postscript-bestand. Zodra uw bestand is geconverteerd, kunt u het afdrukken met het commando lpr intro.ps. + + + + + + Een DVI-bestand exporteren + + De werkbalk geeft de beschikbare opties om een DVI-bestand naar andere formaten te exporteren. Nadat u een DVI-bestand heeft gemaakt van uw &latex;-broncode, zult u dit kunnen exporteren naar een formaat van uw keuze met de knoppen op de werkbalk. + + + + + + + + Voorwaarts en achterwaarts zoeken tussen &kile; en &kdvi; + + + + Vooruit zoeken (Forward Search) + + Het commando Voorwaarts Zoeken gebruikt &kdvi; en een extra bestand (in &latex; wordt naar additionele bestanden packages / pakketten genoemd) genaamd srcltx.sty. U zult uw harde schijf moeten afzoeken om te zien of uw distributie scrltx.sty reeds heeft geïnstalleerd. Indien het niet inbegrepen is, kunt u het downloaden en het naar een &tex;-map kopiëren, bijvoorbeeld /usr/share/texmf/tex/latex/srcltx/. Voer daarna texhash uit zodat &latex; weet waar het bestand zich bevindt. Daarna kunt u het volgende commando in de preambule plaatsen: + + + \documentclass[12pt, a4paper]{book} + \usepackage[active]{srcltx} + \pagestyle{empty} + \renewcommand{\baselinestretch}{2} + \begin{document} + \begin{verse} + The KDE \LaTeX\ source code editor &kile; is my favorite. + + \emph{Because} it is easy to use! + \end{verse} + \end{document} + + Nadat u het pakket srcltx heeft toegevoegd, kunt u &kdvi; open laten. Plaats om een voorwaartse zoekactie uit te voeren de cursor op een regel broncode, en klik op Kdvi Voorwaarts Zoeken om te springen naar de overeenkomstige positie in het venster van de DVI-viewer. + + + + + + Terugzoeken (Inverse search) + + Inverse search werkt niet, tenzij: + + + srcltx.sty wordt gebruikt. + Het broncode-bestand met succes is gecompileerd. + &kdvi; weet welke editor u wilt gebruiken. + + + Met deze functie van &kdvi;, zal het klikken met de middelste muisknop in het DVI-document &kile; openen en proberen naar de overeenkomstige regel te gaan. Vergeet niet &kdvi; te vertellen om &kile; als editor te gebruiken, in het menuonderdeel InstellingenDVI-opties.... + + + &kdvi; configureren; + + + + + + &kdvi; configureren + + + + + + + + Fouten verhelpen + + Als u probeert om Snel maken te gebruiken en de DVI-viewer niet geopend wordt, heeft u waarschijnlijke ergens een fout zitten. Indien u een fout heeft, zal dit zichtbaar zijn in het logbestand / het berichtenvenster en zal een samenvatting van de fout gegeven worden. + + Het logbestand legt dan uit wat de oorzaak van de fout in uw code is. In de editor, kunt u de knoppen gelabeld Vorige LaTeX-fout en Volgende LaTeX-fout gebruiken om naar en van fouten te springen.Het logbestand meldt altijd in welke regel de fout is optrad. Om de regel waarin een fout optrad te bekijken, kunt u op de fout in het logvenster klikken, en &kile; zal u dan naar de desbetreffende regel brengen. + + + + + + + + + + Een nieuw document beginnen + + Wanneer u op de werkbalk klikt op de knop om een nieuw document te beginnen, dan verschijnt er een dialoogvenster, waarin gevraagd wordt welk type sjabloon u wilt gebruiken om uw document te schrijven. De standaard keuzemogelijkheden zijn: + + + Leeg document + Brief + Boek + Artikel + Rapport + + + Als u een Leeg document document selecteert, kunt u ofwel beginnen een geheel nieuw document te schrijven, danwel gebruik maken van de assistent om snel een nieuw document te beginnen (zie ). + + + + + Sjablonen + + Frequente gebruikers van &latex; gebruiken in het algemeen dezelfde preambule voor bijna ieder document dat zij gebruiken. Sjablonen kunnen aangemaakt, opgeslagen en geladen worden binnen &kile; om het eenvoudiger te maken een nieuw document te beginnen. + + + + Een nieuw sjabloon maken + + Om een nieuw sjabloon te maken, dient u eerst een bestaand &tex;/&latex;-bestand te openen of zelf een bestand te maken. &kile; kan een sjabloon genereren van een bestaand document door het gewenste document te openen en de optie BestandSjabloon van document maken te selecteren. + + + + + + Automatische vervangingen configureren + + Wanneer u een nieuw document begint door te kiezen voor een sjabloon via BestandNieuw, worden bepaalde karaktercombinaties vervangen door data zoals uw naam of de karaktercodering die u gebruikt. Deze variabelen kunnen geconfigureerd worden in Instellingen&kile; instellen. + + Wanneer u uw eigen sjabloon aan het ontwerpen bent, is het nuttig te weten welke karaktercombinaties vervangen worden door welke variabelen in het sjabloon: + + + $$AUTHOR$$: deze term wordt vervangen door de auteur die bij deze variabele is ingevuld. + $$DOCUMENTCLASSOPTIONS$$: Deze term wordt vervangen door de variabele documentclass options. Dit wordt in het algemeen als volgt gebruikt: \documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}. + $$INPUTENCODING$$: Indien de variabele inputencoding ingesteld is, bijvoorbeeld latin1, zal deze term vervangen worden door \input[latin1]{inputenc}. + + + + + + + Een sjabloon maken vanuit de assistent + + De eenvoudigste manier om een nieuw sjabloon te maken is het starten van de assistent en dan commando's toe te voegen in de editor. Zodra u uw document hebt ingedeeld zoals u wilt: + + + Sla uw bestand op; + Ga naar Bestand; + Kies Sjabloon van document maken; + Voer indien nodig de benodigde correcties door in het sjabloon; + Type een naam in voor uw nieuwe sjabloon; + Klik op OK om uw sjabloon aan het menu toe te voegen. + + + De volgende keer dat u een nieuw document begint, zult u uw aangepaste sjabloon kunnen kiezen in plaats van de standaard sjablonen. + + + + + + Een sjabloon van een bestand maken + + Van ieder &latex;-bestand kan een sjabloon gemaakt worden. Als zoekt naar een eenvoudige manier om een sjabloon te configureren, gaat u dan op zoek op het internet en volgt u dezelfde stappen die opgesomd zijn in . + + U wilt bijvoorbeeld een volwaardige A0-poster. Deze posters zijn meestal te zien op wetenschappelijke conferenties, en &latex; zal u helpen een aantrekkelijke, opvallende poster te maken.U kunt een sjabloon voor A0 posters verkrijgen op De home page van Jonathan Marchini's , maar er zijn er veel meer beschikbaar. Onthoudt dat u het pakket a0poster nodig zult hebben, dat meestal niet bij een standaard installatie van &tetex; zit, dus u zult het moeten downloaden, kopiëren naar een &tex;-map, bijvoorbeeld /usr/share/texmf/tex/latex/a0poster/, en texhash uit moeten voeren zodat &latex; weet dat het bestaat. Vergeet u niet de bestandsrechten in te stellen zodat iedereen het bestand kan lezen. + + + + + + Een sjabloon verwijderen + + Doet u het volgende om een sjabloon te verwijderen uit &kile; : + + + Ga naar InstellingenSjabloon verwijderen...; + Er zal een dialoogvenster verschijnen met een lijst van alle sjablonen: selecteert u een sjabloon; + Klik u dan op OK en uw sjabloon wordt verwijderd. + + + Sjablonen die gemarkeerd zijn met een asterisk (*) kunnen niet verwijderd worden zonder de juiste rechten. + + + + + + + + + + &latex;-documenten bewerken + + De interne editor die &kile; gebruikt is &kate;. Kate is een teksteditor gemaakt voor programmeurs, die de mogelijkheid bevat om veel verschillende typen tekstbestanden te lezen en markeren, waaronder &latex; en &bibtex;; u heeft direct vanuit het menu &kile; Hulpmiddelen toegang tot veel opties voor &kate; . + + Bekijkt u om meer te leren over &kate; en zijn mogelijkheden het Handboek van Kate. Gebruikers van &kile; kunnen beginnen te lezen vanaf het hoofdstuk Werken met de Kate Editor. + + + + De &latex;-referentie + + &kile; bevat een uiterst praktische tag-referentie voor &latex;, waar u bij kunt komen door HelpLaTeX Referentiete kiezen. Het bevat een grondige beschrijving van bijna alle commando's die u kunt gebruiken in &latex; en hun syntaxis. + + + + + + Bewegingen met de cursor + + Om tekst te selecteren heeft u de volgende opties: + + + Houd de linkermuisknop ingedrukt en sleep de muis naar de gemarkeerde tekst. + Klik dan op een woord om de cursor naar een nieuw gebied te verplaatsen. + Klik tweemaal op een woord om het gehele woord te selecteren. + Klik driemaal om de hele zin te selecteren. + + + Het ingedrukt houden van de linkermuisknop en slepen van de tekst die u wilt selecteren, kopieert de geselecteerde tekst automatisch naar het klembord. + + Het ingedrukt houden van shift en gebruiken van de pijl-toetsen stelt u in staat delen van de broncode te selecteren in het venster van de editor. + + + + + + Haakjes aanvullen en doen overeenstemmen + + Het aanvullen van haakjes in een visueel hulpmiddel dat de editorweergave gebruikt om u aan te geven welke haak bij welke hoort. Als u een willekeurig .tex-bestand opent, en een haakje selecteert dan zal, ongeacht of het ronde haken (), rechte haken [] of accolades {} zijn, de editor de haak en de overeenkomende haak in het geel markeren (deze standaardkleur kan veranderd worden). Dus, als u bijvoorbeeld de cursor positioneert in \section{Inleiding}, dan ziet u \section{Inleiding} in de standaardkleur geel gemarkeerd, om u de locatie van de haakjes openen en sluiten te tonen. + + + + + + Markeren + + &kile; heeft de mogelijkheid om verschillende typen code te zoeken en te markeren. &latex;-commando's, bijvoorbeeld, worden van normale tekst onderscheiden, en formules wonder ook gemarkeerd in een andere kleur. + + + + + + Automatische aanvulling van omgeving + + Wanneer u een nieuwe omgeving begint, door \begin{environment} te typen, voegt &kile; automatisch een commando \end{environment} toe, met een regel ertussen voor uw tekst. + + Automatische aanvulling kan uitgeschakeld worden in de &latex;-sectie van Instellingen&kile; configureren. + + + Een Equation Environment completeren + + + + + + Een Equation Environment completeren + + + + + + + + + Toverkunsten met array + + Een van de saaiste klusjes die men in &latex; kan doen, is het schrijven van een matrix of een tabelomgeving. Men dient alle elementen bij te houden, te verzekeren dat de omgeving goed gevormd is, en dat alles is waar het verondersteld wordt te zijn. Goede inspringing helpt, maar er is een eenvoudigere manier: het menu Assistent van &kile; gebruiken. Buiten de optie Snelstart , bevat het Tabel en Array (wordt gebruikt in wiskundige omgevingen). U heeft dan een matrixvormige invoervorm die u eenvoudig in kunt vullen met uw ingangen. De optie Tabulators toont een eenvoudiger menu om een tab-omgeving in te stellen. In al deze omgevingen, kunt u op eenvoudige wijze het aantal rijen instellen, naast andere specifieke opties. + + + Een tabular-omgeving invoegen + + + + + + Een tabular-omgeving invoegen + + + + + + + + + + + Speciale elementen (tags) in &latex; + + + Gebruiken van de elementenbibliotheek van &latex; + + &latex; heeft honderden elementen voor symbolen en speciale karakters. De meest eenvoudige manier om een speciaal karakter in te voegen is het gebruik maken van het menu van de zijbalk, links in het venster van de editor. + + + Het menu in de zijbalk + + + + + + Het menu in de zijbalk + + + + + Klikt u op het type karakter dat u wilt toevoegen om een speciaal karakter toe te voegen. U kunt de volgende typen karakters toevoegen: + + + Relatiesymbolen + Griekse letters + Pijlen + Begrenzingstekens + Diverse symbolen + Buitenlandse karakters + + + + + + + Bibitems gebruiken + + \bibitem is een commando dat gebruikt wordt om een referentie in een omgeving thebibliography in te voeren in uw document. De syntaxis voor het gebruik van \bibitem is \bibitem[label]{key}. + + Het optionele [label] is voor u om uw eigen labelsysteem toe te voegen voor het bibliografie-item Als er geen label ingesteld is, worden de items op numerieke volgorde geplaatst: [1], [2], [3], etc. + + Het argument {key} wordt gebruikt om te verwijzen en om de commando's \bibitem en \cite aan elkaar en 'aan de informatie die zij bevatten te koppelen. Het commando \cite bevat het label dat overeenkomt met het bedoelde \bibitem, dat zich bevindt in een omgeving thebibliography, en de referentiegegevens bevat. + + De bibliografie is een apart onderdeel van uw hoofddocument, en een voorbeeld van de code voor de bibliografie ziet er als volgt uit: + + + \begin{thebibliography}{50} + \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm...doughnuts}. + Evergreen Terrace Printing Co., Springfield, SomewhereUSA, 1998 + \end{thebibliography) + + Uw hoofd-broncode bevat dan de locatie van de informatie met betrekking tot het \bibitem dat gebruik maakt van \cite. Die broncode lijkt hierop: + + + Mijn thesis, over de filosofie van De Simpsons\copyright + komt uit mijn favoriete boek \cite{Simpson}. + + Daar het vaak moeilijk is de exacte sleutel voor de referentie te onthouden wanneer u veel verwijzingen heeft, biedt &kile; een eenvoudige manier om een verwijzing in te voegen. Klik op de werkbalk Bewerken op het tweede dropdown veld (gewoonlijk staat er label) en selecteer cite. Er verschijnt dan een lijst met alle sleutels voor verwijzingen: selecteer de correcte referentie en er wordt een verwijzing ingevoegd in uw document. Sla het bestand op of kies BewerkenDocumentstructuur verversen om de lijst met sleutels bij te werken. + + Het eindproduct in de bibliografie van uw document ziet er dan zo uit: + + [1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, SomewhereUSA, 1998. + + De meest eenvoudige manier om te werken met \bibitem en \cite is op de werkbalk het dropdown veld dat met cite gemarkeerd is te gebruiken. Wanneer u een verwijzing selecteert om in te voegen, wordt aan u een lijst van bibitems gepresenteerd die u tot dusver gemaakt heeft, en kunt u kiezen uit de referenties uit de lijst. &kile; kan ook samenwerken met editorapplicaties voor &bibtex;' zoals &gbib; en &pybliographer;, om te helpen verwijzingen eenvoudiger te maken. + + + + + + Gebruikergedefinieerde tags + + &kile; geeft u de mogelijkheid uw eigen tags te maken. Een tag is als een snelkoppeling die een aantal commando's start of veelgebruikte tekst schrijft. Joe Sixpack gebruikt bijvoorbeeld vaak de zinnen Ik heb liever \LaTeX\ dan \TeX\ en Wat zou ik doen zonder Linux?. Om gebruikergedefinieerde tags te creëren om deze zinnen te schrijven, kan hij gebruik maken van GebruikerGebruikergedefineerde tagsTags bewerken; dit presenteert hem een dialoogscherm waar hij zijn eigen gebruikergedefinieerde tags kan creëren. + + + Het dialoogscherm Gebruikergedefinieerde tags bewerken + + + + + + Het dialoogscherm Gebruikergedefinieerde tags bewerken + + + + + + Een gebruikergedefinieerde tag aanroepen + + + + + + Een gebruikergedefinieerde tag aanroepen + + + + + Hij zou waarschijnlijke iedere tag een naam geven die deze duidelijk kan identificeren. De naam die u aan uw tag geeft wordt ingevoerd in de sectie die gemarkeerd is met Menu-item, en de tekst van het veelgebruike commando dient ingevoerd te worden in de sectie met als label Waarde. Wanneer de commando's eenmaal ingevoerd zijn, kan hij ze snel gebruiken met de sneltoetscombinatie CtrlShift 1 voor de eerste tag om Ik prefereer \LaTeX\ boven \TeX\ enCtrlShift 2 om Wat zou ik doen zonder Linux? in te voeren. + + + + Plaatshouders in gebruikergedefinieerde tags + + Er is een aantal plaatshouders dat u kunt gebruiken in gebruikergedefinieerde tags: dit zijn %S, %M, en %C. + + + %S: wordt vervangen door de naam van het broncode-bestand. + %M: dit staat voor gemarkeerde tekst; de geselecteerde tekst wordt ingevoegd op zijn plaats wanneer gebruikergedefinieerde tags worden gebruikt. + %C: dit is waar de cursor geplaatst zal worden na gebruik van een gebruikergedefinieerde tag. + + + Om u te laten zien hoe dit werkt, stel dat we bijvoorbeeld een gebruikergedefinieerde tag willen, die de waarde \bfseries{%M}%C bevat, en ik heb een selectie van de tekst gemarkeerd met mijn document dat we in vetgedrukte tekst willen veranderen. Dan markeren we dus de frase I love Fridays, passen onze gebruikergedefinieerde tag toe door CtrlShift1 in te drukken , en krijgen we de tekst \bfseries{I love Fridays}, met de cursor geplaatst aan het einde van de tekst. + + + + + + + + + + De hulpmiddelen om te bouwen gebruiken + + + + Compileren, converteren en bekijken + + Om het resultaat van uw werk te bekijken, dient u eerst de broncode te compileren. Al de hulpmiddelen om te bouwen zijn dichtbijeen gegroepeerd in de menu's BouwenCompileren, BouwenConverteren en BouwenBeeld. + + Om uw broncode te compileren voor scherm-viewers zoals &kdvi;, andere DVI-viewers of verdere conversie, kunt u de sneltoetscombinatie Alt2 gebruiken. Dan kunt u het DVI-bestand bekijken gebruik makend van uw standaard viewer met Alt3, het DVI- naar een ps-bestand converteren met Alt4, en het ps-bestand bekijken met Alt5. + + + + &bibtex; + + Als u &bibtex; gebruikt voor uw bibliografie-ingangen, dient u de volgende speciale procedure voor het compileren te volgen. + + + Voer &latex; uit met Alt2. + Voer &bibtex; uit met Alt-: dit compileert uw bibliografie-bestand. + Voer weer tweemaal &latex; uit, om het de gecompileerde informatie van de bibliografie in te voegen, en om verwijzingen en kruisverwijzingen goed in te stellen. + + + U kunt het &bibtex;-bestand ook met uw editor naar keuze voor &bibtex; (bijvoorbeeld &gbib;) bekijken door BouwenBeeldView Bibtex te kiezen; u kunt de standaard viewer voor &bibtex; veranderen in InstellingenKile instellen...Hulpmiddelen. + + + + + + MakeIndex + + Als u het pakket &makeidx; gebruikt om een uiteindelijke alfabetische index voor uw document te maken, dient u ook een bepaald compilatiepatroon te volgen. + + + Voer &latex; uit met Alt2. + Maak de index met Alt=: dit compileert het indexbestand. + Voer &latex; weer uit, om de gecompileerde informatie over de index op te nemen. + + + + + + + MetaPost + + Als u uw document wilt compileren met MetaPost, een programma om afbeeldingen te tekenen, kunt u het doen met BouwenCompilerenMpost. + + + + + + PDF&latex; + + Er is tevens een andere wijze om uw document te compileren, als u een pdf-bestand wilt: u kunt PDF&latex; uitvoeren, dat de broncode direct tot een pdf-bestand compileert, met Alt6: u kunt dan het gecompileerde bestand bekijken door te drukken op Alt7. + + Als alternatief, kunt u een ps- in een pdf-bestand converteren met Alt8, of direct een DVI- in een pdf-bestand met Alt9. + + Gebruik van PDF&latex; in plaats van &latex; kan slechts een kwestie van eenvoud of gewoonte zijn, maar soms verschilt het gedrag van de twee programma's. + + + + + + &latex;2HTML + + Tenslotte, wilt u misschien uw werk publiceren op het web en niet alleen op papier. U kunt het programma latex2html gebruiken, dat aangeroepen kan worden vanuit het menu BouwenConverterenLaTeX to HTML van &kile; 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 BouwenBeeldView HTML. + + + + + + Parameters aan 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. + + + + + + + + Formaten voor grafische bestanden + + PDF&latex; kan, indien het gebruikt wordt met de pakketten graphics of graphicx op correcte wijze png- en jpg-bestanden compileren in het pdf-bestand, maar kan niet met eps-bestanden overweg. Omgekeerd ondersteunt het proces om DVI-bestanden te compileren en het converteren van ps-, en uiteindelijk pdf-bestanden wel eps-, maar geen png- en jpg-bestanden. Om deze frustrerende cirkel te doorbreken, in het geval dat u zowel eps- als png- of jpg-bestanden wilt invoegen, heeft u een aantal manieren om hier omheen te werken: + + + U kunt eps-bestanden naar png- of andere formaten converteren met hulpmiddelen als the Gimp en PDF&latex; gebruiken. + U kunt ook andersom converteren en &latex; en ps-pdf-conversie gebruiken; dit is niet altijd een goed idee, aangezien eps andere grafische zaken kan inkapselen, maar niet alle toepassingen dit perfect ondersteunen; sommige proberen misschien zelfs uw jpg-beeld met vectoren en verscheidene scripts te schrijven, die in gigantische bestanden zullen resulteren. Een eenvoudig programma dat dit proces op correcte wijze uitvoert is jpg2ps. + Als u een bestand in ps-formaat nodig heeft , maar jpg- of png-afbeelding heeft, kunt u ook eenvoudig eerst PDF&latex; gebruiken, en dan de instructie pdftops voor de commandoregel, of, nog beter, uw eigen gebruikerstag implementeren om dat voor u te doen (zie ). + + + 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 gif) 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. + + + + + + Hoofddocument + + Het definieren van uw document als hoofddocument laat u toe 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 / berichten. Men kan de fouten gedetailleerder bekijken door te kiezen voor BouwenLogbestand bekijken of door de sneltoetscombinatie Alt0. Het gegenereerde logbestand wordt weergegeven in de weergave Loggegevens / berichten; fouten en waarschuwingen worden gemarkeerd. + + + Het logbestand bekijken + + + + + + Het logbestand bekijken + + + + + U kunt eenvoudig van het ene bericht in het logbestand naar het andere springen door de menu-onderdelen BouwenVolgende/ Vorige LaTeX-fout /-waarschuwing te gebruiken, of door de overeenkomstige knoppen van de taakbalk te gebruiken. + + Klik om in de &latex;-broncode naar de regel te springen waar de foutmelding of waarschuwing voorkwam op de fout of waarschuwing in de weergave Loggegevens/berichten. &kile; brengt u automatisch naar de regel die problemen geeft. + + + + + + De modus Bestanden observeren gebruiken + + Wanneer u het commando Snel maken start, zal normaliter een viewer aangeroepen worden na de compilatie. Als u geen ingebedde viewer gebruikt, zal er iedere keer een nieuw venster geopend worden. + + Als u de opmaak van uw document aan het aanpassen bent, voert u misschien erg vaak Snel maken, 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 Snel maken voorkomt. + + Momenteel ondersteunt &kdvi; het continu actualiseren van het DVI-bestand dat bekeken wordt, maar &kghostview; is nog niet zo perfect: om het document te actualiseren na het compileren, dient u de pagina te veranderen, en het aantal pagina's zal niet veranderd worden in de visualisatie van &kghostview;. + + 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. + + + + + + + + Door de &latex; broncode navigeren + + + + De weergave Structuur gebruiken + + De weergave Structuur toont de hiërarchie van het document dat gecreëerd wordt in &kile;, en staat u toe er snel doorheen te navigeren, door de opdeling in segmenten te tonen. Om door uw document te navigeren, dient u slechts te klikken op een label, hoofdstuk, paragraaf, subparagraaf, etc., en u zult naar het begin van het overeenkomstige gebuid gebracht worden. + + Indien u een los &latex;-document in uw broncode heeft besloten met de tags \input of \include, zal in de weergave Structuur verwezen worden; dubbelklikken op hun namen in deze weergave doet &kile; het ingevoegde bestand openen in het editor-venster. + + De hiërarchische boomstructuur heeft ook een aparte tak voor labels die gebruikt worden in de tekst. + + + De weergave Structuur gebruiken + + + + + + De weergave Structuur gebruiken + + + + + + + De weergave Structuur actualiseren + + Om uw weergave van de structuur te actualiseren kunt u ofwel gaan naar BewerkenDocumentstructuur verversen of u kunt uw document opslaan, hetgeen &kile; de weergave Structuur doet actualiseren. + + + + + + + + Bladwijzers + + Bladwijzers zijn uw verwijzingen naar een tekstsegment of een regel in de &kile;-omgeving. Selecteer om een bladwijzer te gebruiken een specifieke regel van uw document waar u naartoe terug wilt keren, druk dan Ctrl B, en &kile; voegt een bladwijzer toe aan deze regel. Als alternatief kunt u ook een bladwijzer instellen door een regel te markeren en het menu gelabeld BladwijzersToggle Bookmark. + + Selecteer om al uw bladwijzers te verwijderen Bladwijzers Bladwijzers verwijderen. + + + + + + + + Projecten + + + + Werken met projecten + + in &kile; kunt u projecten aanmaken en ermee werken. Een project is een groep van &latex;-, &tex;- of andere documenten die alle informatie bevatten die gebruikt wordt om uw complete document te maken. Een typisch project zou een document zijn bestaand uit een aantal hoofdstukken, geschreven in verschillende .tex-bestanden. Zij kunnen allemaal bijgevoegd worden in een project, om het hele document eenvoudiger te beheren te maken. U kunt ook niet-broncodebestanden opslaan, zoals grafische beelden, in een project. De specificaties van het project worden opgeslagen in een speciaal bestand, met extensie .kilepr. + + Een project voegt de volgende functionaliteiten toe: + + + U hoeft geen hoofddocument in te stellen, &kile; doet dit automatisch. + Projectbestanden kunnen eenvoudig samen gearchiveerd worden. + De weergave Bestanden en projecten toont welke bestanden deel uitmaken van het project. + Na het openen van een project wordt elk bestand dat eerder geopend was hersteld met de originele codering en markering. + + + + + + + Een project aanmaken + + Selecteer om een project aan te maken ProjectNieuw project.... U wordt gevraagd de volgende informatie te geven om uw project aan te maken: + + Titel van uw project. + Naam van het projectbestand met de extensie .kilepr. + Bestandsnaam. + Type bestand dat aangemaakt wordt: leeg document, artikel, book, brief, rapport. + + + Wanneer u het veld bestandsnaam invult, dient u een relatief pad op te nemen vanuit waar het projectbestand met extensie.kilepr wordt opgeslagen naar het bestand. + + + + + + De weergave Bestanden en projecten gebruiken + + De weergave Bestanden en projecten is een knop op het menu van de zijbalk. In deze weergaven, kunt u de structuur van uw project, de bestanden, en de naam van het bestand .kilepr dat de projectinformatie laat zien. Toevoegen, verwijderen en wijzigenvan opties in uw project wordt gedaan via de weergave Bestanden en Projecten. + + + De weergave Bestanden en projecten + + + + + + De weergave Bestanden en projecten + + + + + + + + + Bestanden toevoegen en verwijderen + + Open een willekeurig &tex;-bestand en klik met de rechtermuisknop op de bestandsnaam in de weergave Bestanden en projecten en selecteer Aan project toevoegen om het bestand aan uw project toe te voegen. Indien u meerdere projecten open heeft staan, vraagt een dialoogvenster aan welk project het bestand toegevoegd dient te worden. + + Indien u meerdere bestanden heeft die aan een project toegevoegd moeten worden, kunt u het project selecteren in de weergave Bestanden en projecten en rechtsklikken en dan Bestanden toevoegen selecteren; u kunt dan uw bestanden in een dialoogvenster selecteren. + + U kunt ook rechtsklikken op de projectnaam in de weergave Bestanden en projecten, en Bestanden toevoegen... selecteren om een dialoogvenster voor het selecteren van bestanden te doen verschijnen. + + + Bestanden aan een project toevoegen + + + + + + Bestanden aan een project toevoegen + + + + + Klik met de rechtermuisknop op het bestand en selecteer dan Bestand verwijderen om een bestand uit een project te verwijderen. Dit wist uw bestand niet, maar verwijderd het uit de lijst van bestanden die het bestand met de extensie .kilepr bevat. + + + + + + Uw projectopties veranderen + + &kile; heeft een aantal opties gerelateerd aan uw project, die ingesteld kunnen worden. Klik met de rechtermuisknop op de titel van uw project en selecteer Projectopties om hen te wijzigen. U heeft de mogelijkheid om te veranderingen aan te brengen in: + + + De titel van uw project. + Het archiveercommando. + Herkende extensies voor niet-broncodebestanden. + De optie om de bestandsnaamextensies als reguliere expressies te gebruiken. + + + + + Uw project archiveren + + &kile; laat u op eenvoudige wijze een reservekopie van uw project maken door al zijn bestanden in een enkel archief (vaak bekend als tarball) op te slaan. Klik met de rechtermuisknop op de naam van uw project in de weergave Bestanden en projecten, of selecteer ProjectArchiveren om uw project te archiveren. + + Standaardworden alle bestanden in een project toegevoegd aan het archief. Als u een bepaald bestand niet wilt toevoegen aan het archief, dient u in de weergave Bestanden en projecten rechts te klikken en de optie Insluiten in archief uit te vinken. + + Archiveercommando's zijn eenvoudige shell-commando's die uitgevoerd worden vanuit de projectmap (waarin het .kilepr-bestand zich bevind). Een aantal plaatshouders kunnen gebruikt worden wanneer een archiveercommando geschreven wordt: + + + %S: dit wordt vervangen door de naam van uw projectbestand zonder de extensie .kilepr. + %F: dit commando wordt gebruikt om de lijst van bestanden te vervangen die ingesloten worden in het archief. + + + + + + + Extensies voor niet-broncodebestanden + + Niet-broncodebestanden zijn bestanden zoals afbeeldingen, pdf- ,of PostScript-bestanden, etc. die in het project worden opgenomen, maar geen broncodebestanden zijn met de extensie .tex. U heeft de optie om uw eigen reguliere expressies te gebruiken om met niet-broncodebestanden overeen te komen. + + + + + + + + Een project sluiten + + Selecteer om een project te sluiten de weergave Bestanden en projecten in de verticale werkbalk, klik met de rechtermuisknop op uw projecttitel, en selecteer dan Sluiten. Dit sluit uw project af, en alle bestanden die met uw project geassocieerd worden, en voegt ook de naam van het project dat u net heeft afgesloten toe aan Recent project openen... in het menu Project. + + + + + + + + De codering van het document instellen + + De editor &kile; laat u de tekst lezen, converteren en instellen in de codering die uw document nodig is voor uw document. Dit staat u toe niet-standaard letters en symbolen te gebruiken; u kunt bijvoorbeeld karakters met een accent gebruiken voor Italiaans of Frans. Het selecteren van de codering voor uw document kan op drie manieren gedaan worden: + + + Één manier om de codering in te stellen is het combinatieveld Codering instellen te gebruiken, dat zich aan de onderkant bevindt van de weergave Bestand openen van de zijbalk. + Een andere manier is om het submenu BeeldCodering instellen te gebruiken. + Een derde manier om de codering van een document in te stellen is de om de optie in te stellen wanneer u de assistent om een nieuw document te maken gebruikt. + + + &latex; begrijpt zelf alleen ASCII, een zeer beperkte verzameling van karakters, dus u zou niet direct een letters met een accent of speciale letters kunnen gebruiken. Om letters met een accent te gebruiken is een speciale syntaxis gecreëerd: zoals bijvoorbeeld \"evoor ë. Er is een pakket dat u hierbij helpt, inputenc genaamd, en het wordt opgenomen in de preambule met \usepackage[latin1]{inputenc}, waarin het argument voor de optie de codering is die u wenst te gebruiken (in de meeste gevallen latin1). Dit vertelt &latex; om alle ë's die u geschreven heeft te vertalen in \"e's voor het compileren. Raadpleeg alstublieft de direct de documentatie van inputenc voor meer informatie over inputenc. Tenslotte: denkt u eraan zich ervan te verzekeren dat uw bestand daadwerkelijk in dezelfde codering is gecodeerd als u aangegeven heeft bij inputenc! + + + De codering van het broncodebestand kiezen + + + + + + De codering van het broncodebestand kiezen + + + + + Dit legioen van verschillende coderingstabellen voor karakters heeft veel problemen veroorzaakt voor vele toepassingen: u kunt bijvoorbeeld geen cursus Turks in het Frans schrijven zonder de speciale karakters van één taal te verliezen. Er is een algemene overeenkomst gesloten dat, vroeger of later, iedereen zal overstappen op Unicode. Er zijn vele implementaties van Unicode, en UTF-8 is de meest succesvolle onder Linux; Windows® vertrouwt daarentegen op het lastigere en minder flexibele ucs-2. Sommige distributies, zoals RedHad, zijn al begonnen hun standaard codering in te stellen op UTF-8, en daarom vindt u het wellicht zeer interessant om een UTF-8 argument te gebruiken voor het pakket inputenc. + + Het slechte nieuws is, dat het nog niet opgenomen is in &tetex; gedurende het schrijven van dit document; het goede nieuws is , dat er een &latex;-pakket is dat precies dat kan doen, en u het zelf kunt installeren. + + Gaat u maar naar de thuispagina van Unicode-ondersteuning voor &latex;, door Dominique Unruh van de universiteit van Karlsruhe. Volg de instructies daar om het pakket te installeren en te gebruiken. + + + + + + Dankbetuiging en licentie + + &kile; is een open-source gebruikersvriendelijke broncode-editor voor &latex;/&tex;. Het draait op systemen waarop de &kde; Bureaubladomgeving is geïnstalleerd. &kde; is beschikbaar voor verscheidene architecturen met Linux en andere Unix-achtige systemen geïnstalleerd. &kile; is ook deel van het project Fink, hetgeen betekent dat &kile; op een Mac met OS-X uitgevoerd kan worden. + + Er is veel dank verschuldigd aan diegenen die streven het project &kile; voort te zetten, en de bijdragen van vele uren door diegenen die hun tijd opofferen om de hulpmiddelen te ontwikkelen die wij allemaal kunnen gebruiken onder de GNU -licentie. Hier is een korte lijst van de programmeurs, redacteurs, vertalers, schrijvers, debuggers, inpakkers, webontwikkelaars en gebruikers die dit project mogelijk maakten. + + Programma copyright 2003 en momenteel beheerd door Jeroen Wijnhout Jeroen.Wijnhout@kdemail.net + + Programma copyright 2002-2003 Pascal Brachet + + &kile; bevat broncode van het gratis (GPL) programmaXgfe (X Windows GUI front-end voor &gnuplot;), Copyright © 1998 David Ishee + + Documentatie Copyright© 2003 Jonathan Pechta, 2003-2004 Federico Zenith (laatste aanpassingen) + + Bijdragen door: Rob Lensen, Roland Schulz, Michael Margraf + + Vertalers: Thomas Basset (fr), Kris Luyten (nl), Alexander Hunziger (de), Stefan Asserhall (se), Alfredo Beaumont (eu), Leopold Palomo Avellaneda (ca), Federico Zenith (it), Quique (es), Maciej Woloszyn (pl). + + Hartelijk dan aan iedereen die betrokken is! +&underFDL; &underGPL; + +&documentation.index; + + diff --git a/doc/pt/Makefile.am b/doc/pt/Makefile.am new file mode 100644 index 0000000..a6d8e59 --- /dev/null +++ b/doc/pt/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = pt +KDE_DOCS=kile diff --git a/doc/pt/index.docbook b/doc/pt/index.docbook new file mode 100644 index 0000000..c9d79a5 --- /dev/null +++ b/doc/pt/index.docbook @@ -0,0 +1,5724 @@ + +Kile"> + ATEX"> + EX"> + teTEX"> + EX"> + GnuPlot"> + ImageMagick"> + KDE"> + KDVI"> + KGhostView"> + KPDF"> + PostScript"> + pyBliographer"> + gBib"> + makeidx"> + Kate"> + XFig"> + CJK"> + ucs"> + URL"> + + + + +]> + + + + +O Manual do &kile; + + + JonathanPechta + FedericoZenith
zenith@chemeng.ntnu.no
 + HolgerDanielsson
holger.danielsson@t-online.de
 + JeroenWijnhout
Jeroen.Wijnhout@kdemail.net
+ + + + +JoséPires
jncp@netcabo.pt
Tradução + + +2003 +Jonathan Pechta + + + +200320052006 +Federico Zenith + + + +20052006 +Holger Danielsson + + +2006-01-19 +1.9 + + +&FDLNotice; + + + +O &kile; é um editor de código e uma linha de comandos de &tex; e &latex;. + + + +KDE +kdenonbeta +Kile +LaTeX +TeX + + + + + + +Prefácio + + + + Requisitos + + Para executar o &kile;, necessita dos seguintes componentes instalados no seu sistema: + + + Ambiente de Trabalho K (&kde;): &kde; é um popular ambiente de trabalho "open source". + Qt: Qt é uma ferramenta de desenvolvimento em C++ necessária para compilar o &kile;. + &latex;: um programa de formatação de documentos de alta qualidade. O mais provável é que você tenha (ou queira) o pacote &tetex;, dado que está num sistema semelhante ao Unix. + + + Pacotes opcionais: + + + &kdvi;: Visualizador de DVIs do &kde;. + &gnuplot;: pacote de desenho científico. + &xfig;: programa de desenho para o X. + + + Alguns destes itens poderão estar incluídos na sua distribuição de Linux; por favor veja a documentação da sua distribuição ou veja o CD ou DVD de instalação da mesma para adicionar estes pacotes ao seu computador. + + O projecto &kile; inclui vários pacotes binários do &kile; para várias distribuições que poderão ser facilmente instaladas e executadas sem ter de compilada nada; verifique a página pessoal do &kile;. + + + + + + Público Alvo + + Este manual é destinado a qualquer indivíduo, independentemente da sua experiência com o &latex;, o &kde;, o &kile; ou o Linux. + + Os utilizadores avançados provavelmente não irão ler este manual, mas todas as sugestões sobre a documentação serão tidas em consideração. Se quiser contribuir para este projecto ou para a documentação, por favor consulte a página Web do &kile;. Os comentários sobre a documentação poderão ser entregues em zenith@chemeng.ntnu.no. + + Necessita de respostas sobre o &kile;? Está preso com a sua compilação? Deseja ver alguma funcionalidade nova? A forma preferida de fazer questões técnicas ou iniciar uma discussão é usar a nossa lista de correio: kile-devel@lists.sourceforge.net. + + + + + + + + Introdução + + + + Factos básicos + + + + Acerca do &kile; + + O &kile; é um ambiente integrado de &latex; para o ambiente de trabalho do &kde;. O &kile; dá-lhe a possibilidade de usar todas as funcionalidades do &latex; numa interface gráfica, dando-lhe um acesso simples, imediato e personalizado a todos os programas de compilação, pós-processamento, depuração, conversão e visualização do &latex;; irá também obter assistentes bastante úteis, uma referência ao &latex;, as interfaces com o &gnuplot; e o &xfig;, assim como a gestão dos projectos. + + + + + + O que é o &latex; + + O &latex; é um sistema de processamento de texto derivado do &tex;, um programa desenvolvido originalmente em 1977 por Donald Knuth para ajudar aos autores a formatarem profissionalmente o seu trabalho, obtendo um trabalho semelhante a um tipógrafo; este é o profissional que ajusta a aparência de um documento de acordo com as especificações do tipo de documento. O &latex; foi criado pelo Leslie Lamport para dar aos autores um tipógrafo automático, especialmente na árdua tarefa de formatar as fórmulas e expressões matemáticas, as quais de forma alguma estão rodeadas por cifrões no &latex;. Hoje em dia, os programas de processamento de texto permitem a qualquer utilizador ser o tipógrafo, mas o que normalmente precisa é de um documento que pareça bonito, não um em que você perde a horas a tentar fazê-lo parecer bonito. O &latex; liberta-o desse fardo e permite a si pensar no documento, não na formatação. E sim, ele irá ficar bonito! + + + + + + Como é que se pronuncia? Porquê a formatação estranha? + + Existem algumas traduções engraçadas dos pacotes relacionados com o &tex; para ter que têm a pronúncia e a formatação mais estranha possível. O &tex; foi supostamente derivado do grego τεχ, o que em letras latinas equivale a teq. Existem várias explicações para a razão, mas a mais provável é porque o &latex; foi originalmente concebido para relatórios técnicos e, de facto, a sua melhor capacidade era a formatação correcta e simples de fórmulas matemáticas, o que era então uma tarefa bastante dispendiosa, morosa e frustrante. + A pronúncia é supostamente a seguinte: o T é como será de esperar, o E como em metro e o X como o ich do Alemão. Se não souber como é que soa o ch soa, é mais ou menos como um gato assanhado; o símbolo do IPA é o /ç/. Muitas pessoas usam a pronúncia diferente do acho (símbolo do IPA /x/), mas foi perguntado pessoalmente a alguns Gregos que confirmaram a primeira versão. Deverá ter a noção que várias pessoas pronunciam de forma errada /teks/ ou /tek/. + Por último, no &latex; os primeiros LA são pronunciado de forma semelhante a lei: a ideia é que, ainda que o &tex; em bruto seja difícil, até mesmo um homem lay (leigo) poderá usar macros de &latex;. Uma forma menos inspiradora, mas mais realista, é o facto de poder derivar do apelido de Leslie Lamport, o criador do &latex;. Agora já sabe! + + + + + + + + Introdução ao &latex; + + O sistema de formatação &latex; é semelhante a outras linguagens de formatação como o XML, que é usado para vários tipos de documentos (incluindo o que você está a ler) ou o HTML, usado para as páginas Web. A ideia geral tem a ver com a utilização de palavras-chave especiais chamadas marcas ou tags, que dizem a um programa (um processador de texto, um navegador na Web ou o compilador do &kile;) como apresentar o texto. O &kile; oferece-lhe um conjunto razoável destas marcas no menu LaTeX. + + Embora se tente dar ao utilizador uma boa ideia do que é o &latex;, este não é o Livro Definitivo sobre o &latex;. Se quiser aprender bem o &latex;, poderá querer adquirir um livro na sua biblioteca. O escritor tem tido uma boa experiência com o A Guide to &latex; do H. Kopka e P. W. Daly, e continua a tê-lo na prateleira. + + Como outras linguagens de formatação, o &latex; contém um preâmbulo, que define comandos globais como o tamanho do papel, a numeração das páginas e um conteúdo ou corpo, que contém o texto; o preâmbulo contém pelo menos o comando \documentclass e antecede o corpo do documento, que começa com o comando \begin{document} e é, previsivelmente, terminado pelo comando \end{document}. + + + + + + Características Principais do &kile; + + + + Assistente de Arranque Rápido + + O assistente incorporado no &kile; é uma funcionalidade útil para começar a criar rapidamente documentos no &kile;. A selecção do assistente no menu dá-lhe várias opções para a criação do seu documento: artigo, livro, carta, relatório ou vazio. Poderá também indicar algumas opções relacionadas com o documento logo à partida. + + Opções do assistente: + + + A Classe do Documento: escolha o tipo do documento que deseja criar: artigo, carta, relatório livro ou outro tipo personalizado. + Tamanho da Letra: indique ao &kile; qual o tamanho de letra que irá usar. + Tamanho do Papel: escolha o tamanho ou o estilo das folhas. + Codificação: você irá querer usar normalmente as codificações Latin 1 ou UTF-8, para lhe permitir introduzir directamente palavras do tipo naïveté e não através da ASCII-ficação na\"\ivet\'e; contudo, existem muitas mais opções disponíveis, como o Latin 5 para o Turco. + Nome do autor: coloque aqui o seu nome. + Título do Documento: adicione aqui o título do seu documento. + Outras opções: isto permite-lhe definir mais opções como a impressão, os rascunhos, entre outras. + + + + + + + Modelos Predefinidos + + Os modelos predefinidos no &kile; são: + + + Documento vazio: os verdadeiros homens começam do zero! + Artigo: define o formato do artigo para um documento que seja curto o suficiente para não ser dividido em capítulos. + Relatório: define o formato de relatório para um documento de tamanho médio com, por exemplo, a numeração das páginas no extremo exterior da página. + Livro: define o formato de um livro, uma variante completa, tão poderosa que é usada para escrever vários textos de livros universitários. + Carta: define o formato de carta, o qual poderá fazer todas aquelas indentações estranhas que, de facto, ninguém se lembra de facto. + + + Os utilizadores novos não precisam de se preocupar. Esta lista é apenas uma breve descrição das funcionalidades, e será dada mais alguma atenção para completar estas tarefas em detalhe na secção de . + + + + + + Realce de Sintaxe + + O &kile; é semelhante aos programas que lidam com o código-fonte e com a edição e irá automaticamente realçar os comandos, opções e itens que são usados e abusados. O &kile; torna assim possível a localização de áreas problemáticas com facilidade: por exemplo, se você ver as área de texto principais a ficarem verdes, provavelmente será porque se esqueceu de fechar um ambiente 'math' algures; iria então ver quão horrível o ficheiro iria ficar, mas o realce realmente poupa-lhe tempo e frustrações. + + + + + + Auto-Completação de Ambientes + + A completação automática de ambientes significa que, quando você começar um novo ambiente com o comando \begin{ambiente}, o &kile; irá inserir automaticamente um \end{ambiente}, com uma linha entre eles para o seu texto. Você poderá, obviamente, desactivar esta opção se quiser na janela em Configuração Configurar o Kile...LaTeXAmbientes. + + + + + + Saltar para Elemento Estrutural + + Todos os documentos estão normalmente estruturados numa hierarquia de algum tipo. O &latex; permite-lhe repartir os documentos na hierarquia seguinte (sendo o 'part' o mais elevado na hierarquia e o 'subparagraph' o mais baixo): + + + \part + \chapter + \section + \subsection + \subsubsection + \paragraph + \subparagraph + + + Ao ver um documento na área de Estrutura, poderá saltar entre elementos ao carregar no elemento que deseja ver. + + + + + + Procura Inversa + + Ao criar o seu próprio ficheiro de &latex;, a pesquisa inversa poderá ser bastante útil. Logo que tenha criado um ficheiro DVI (DeVice Independent File - Ficheiro Independente do Dispositivo), ao carregar com o botão do meio no visualizador do DVI, o &kile; irá saltar para a linha correspondente no ficheiro de código em &latex;. + + Um ficheiro DVI é um tipo de ficheiro que contém uma descrição de um documento formatado, em conjunto com outras informações, incluindo o tipo de letra do texto e é o resultado normal do &tex; ou do &latex;. Existe uma quantidade de utilitários para ver e imprimir os ficheiros DVI nos vários sistemas e dispositivos. Um ficheiro DVI é também conhecido às vezes como um meta-ficheiro. + + + + + + Pesquisa Normal + + Ao usar a pesquisa inversa, a selecção dos itens no ficheiro DVI está associada com o editor, por isso, quando carregar no ficheiro DVI, a janela principal salta para a secção correspondente de código em &latex; do editor. A pesquisa normal é o oposto disto. A pesquisa normal permitir-lhe-á carregar numa dada secção de texto no código de &latex;, saltando para a posição associada na janela do visualizador de DVIs. + + + + + + + + A Barra de Ferramentas + + + Novo: começa um novo documento. + Abrir: abre um novo documento. + Fechar: fecha o documento. + Definir o documento como mestre: este é usado quando se lida com vários ficheiros. Se tiver um documento-mestre, poderá lidar mais facilmente com outros ficheiros .tex incluídos no seu documento. + Construção Rápida: compila o seu código de &latex; e mostra os resultados automaticamente, a menos que tenha erros de código. + Modo de vigia de ficheiros: este modo irá "vigiar" as alterações no ficheiro DVI e não irá lançar nenhuma sessão nova do &kdvi; após a Construção Rápida. + Ver o ficheiro de registo: vê o ficheiro .log, onde poderá localizar erros. + Erro anterior: recua no ficheiro .log e assinala os erros no código. + Erro seguinte: avança no ficheiro .log e assinala os erros no código. + Parar: para a função actual. + LaTeX: executa o &latex; sobre o documento activo. + Ver DVI: inicia o visualizador de DVIs. + DVI para PS: converte o ficheiro DVI para &postscript; (PS). + Ver PS: iniciar o visualizador de &postscript; (PS). + PDFLaTeX: cria um PDF do documento &latex;, se tiver um cabeçalho &latex;. + Ver PDF: vê o PDF. + DVI para PDF: converte um DVI para PDF. + PS para PDF: converte um PS para PDF. + LaTeX para HTML: cria código HTML do documento &latex;. + Ver HTML: vê o HTML criado. + Pesquisa Normal do Kdvi: salta para a página que corresponde à linha actual no editor. + + + Se você olhar para a barra de ferramentas Editar, irá reparar em três sub-menus. Estes menus foram desenhados para você ser capaz de adicionar certas funcionalidades comuns ao seu documento. A primeira lista é usada para dividir rapidamente o seu documento por partes, capítulos, secções e assim por diante; os comandos disponíveis para adicionar segmento ao seu código-fonte de &latex; são: + + + part: o nível mais elevado de seccionamento de um documento. + chapter: cria um novo capítulo. + section: cria uma nova secção. + subsection: cria uma nova subsecção. + subsubsection: uma secção secundária entre a subsecção e o parágrafo. + paragraph: cria um novo parágrafo. + subparagraph: cria um novo sub-parágrafo. + + + A lista chamada label é usada para inserir itens no seu documento, como índices, notas de rodapé e referências; os comandos disponíveis são: + + + label: um comando que produz uma legenda para um capítulo, uma figura ou outro elemento. + index: cria uma entrada no índice. + footnote: adiciona uma nota de rodapé ao documento. + ref: é usado para se referir a uma legenda predefinida, a qual poderá escolher numa lista. + pageref: tal como o ref, mas referindo-se a uma página em vez de um elemento da estrutura. + cite: cria uma referência com dados de uma bibliografia. + + + + O menu Label + + + + + + O menu Label + + O menu Label + + + + + Seleccionar a legenda de uma referência + + + + + + Seleccionar a legenda de uma referência + + Seleccionar a legenda de uma referência + + + + Ao usar o cite, ser-lhe-á apresentada uma lista de itens bibliográficos, mas se estiver a usar o &bibtex; isto só irá funcionar se o ficheiro pertencer a um projecto. Poderá também usar o &gbib; ou o &pybliographer;, ou fazê-lo mesmo à mão. + + A última lista chamada pequena é usada para indicar o tamanho do texto. Poderá definir o tamanho do texto principal, das notas de rodapé e assim por diante. Os comandos disponíveis são: + + + tiny: o mais pequeno. + scriptsize: muito pequeno. + footnotesize: mais pequeno. + small: pequeno. + normalsize: normal. + large: grande. + Large: maior. + LARGE: ainda maior. + huge: muito maior. + Huge: o maior. + + + + + + + + Arranque Rápido + + + + Escrever um Documento em &latex; com o &kile; para Principiantes + + Os utilizadores do &kile; tem duas opções ao iniciar um documento novo: poderão usar o Assistente para iniciar um documento novo, seleccionar o tipo de documento que gostariam de criar e as opções como o tamanho da letra, do papel e assim por diante; caso contrário, poderão escrever o código à mão. + + + \documentclass[12pt]{article} + \begin{document} + Aqui está um bocado de texto escrito em \LaTeX. + \end{document} + + Todos os documentos no &latex; começam com o comando \documentclass{TipoDeDocumento}, a menos que esteja a usar uma versão mais antiga do &latex;, onde nesse caso o comando é \documentstyle{TipoDeDocumento}. Existem de momento duas versões comuns do &latex; que poderá estar a usar: a versão 2.09, que usa o \documentstyle, e a versão 2ε, que usa o \documentclass para iniciar um documento. O comando \documentclass segue sempre a sintaxe \documentclass[argumento opcional]{class}. + + A escrita do exemplo de código acima no campo de texto dar-lhe-á o seguinte resultado: + + + Aqui está um bocado de texto escrito em &latex;. + + Os parêntesis que vêm a seguir ao comando \documentclass contêm as opções para o comando. A opção [12pt] define o tamanho da letra para o seu artigo; se não definir o tamanho da letra no início, podê-lo-á fazer mais tarde no texto. + + Logo que tenha escrito o exemplo de código no campo acima, terá de compilar o seu código-fonte de &latex;. A forma mais simples para você compilar o &latex; é usar o menu Criar ou usando o botão Criação Rápida. + + O &Alt;2 é o atalho de teclado para compilar o seu código-fonte. + + Terá de gravar o seu código-fonte antes de poder compilar; o &kile; fará isso automaticamente por si. + + Se o seu documento não compilou, verifique os erros no registo. Ao usar a opção Criação Rápida, o visualizador &kdvi; deverá ser lançado automaticamente; se não o fizer, dê uma vista de olhos no registo. + + + + + Ambientes + + Um ambiente é um segmento de texto que é gerido de forma diferente do resto do documento. Por exemplo, você cria um relatório com um tamanho de letra 12, mas precisa de alterar o tamanho da sua letra para algumas frases. Os comandos \begin{ambiente}, \huge e \end{ambiente} permitir-lhe-ão alterar temporariamente o texto dentro dos comandos de controlo para ter um tamanho enorme. + + As alterações só são efectivas desde o \begin{ambiente} até ao \end{ambiente}. Não existem limites para o número de alterações que poderá fazer dentro de um ambiente. + + Existem várias funcionalidades que poderá adicionar ao seu documento que o poderão tornar mais legível e amigável. Você poderá adicionar funcionalidades como, por exemplo, tipos de letra diferentes, negritos, itálicos, sublinhados, etc., ao seu documento e estes comandos irão terminar com um comando \end ou no fim do seu ambiente. + + + \begin{emph} ou \begin{em}: este comando coloca o texto em itálico e isto é válido até que o código passe por um \end{em}, \end{emph} ou outro ambiente. Para colocar uma palavra em itálico, poderá usar a sintaxe: esta é a \em{minha} frase. + \bfseries{Vou tornar este texto dentro dos parêntesis negrito}: este comando coloca o seu texto a negrito. O comando 'bold' (negrito) irá continuar até que um parêntesis de fecho apareça. + \quote: para criar uma citação dentro do seu document; coloque a sua citação com um \begin{quote} e termine-a com um \end{quote}. + \center: centra o texto. + \verse: cria algum texto de deslocamento para poemas. + \itemize: cria uma lista de itens. + + + + + + + Utilizar o &kile; + + Agora que já lhe foram dadas algumas bases sobre como escrever código com a linguagem de formatação &latex;, vai-se mostrar a si como criar um documento com o &kile;, passo-a-passo. + + + Inicie o &kile;. + Crie um documento novo, usando a opção FicheiroNovoDocumento Vazio. + Seleccione o AssistenteArranque Rápido, depois escolha um formato e defina as suas preferências no assistente. + Logo que o assistente tenha introduzido algum texto, faça algumas configurações para tornar o documento mais legível, adicione no mínimo uma citação, algum texto em negrito, itálico e um verso para ver a diferença entre os comandos. + Grave o seu ficheiro e dê-lhe o nome intro.tex. + Crie (compile) o seu documento com a sequência &Alt;2 ou com o botão intitulado LaTeX. + Seleccione Ver Dvi. + Verifique todo o novo texto. + Agora que você acabou de ver o seu documento, carregue no botão Janela do Editor para voltar ao editor se você estiver a usar o visualizador incorporado ou feche a janela de visualização se estiver a utilizar um programa separado. + + + É tudo! Acabou agora de criar o seu primeiro documento em &latex;! + + Logo que tenha criado o seu DVI, você será capaz de imprimir o seu documento ou transformá-lo num ficheiro &postscript; ou PDF se o desejar. Experimente e divirta-se! + + + + + + Ficheiros DVI + + O DVI significa DeVice Independent ou Independente do Dispositivo. Estes ficheiros são produzidos pelo &tex; ou pelo &latex; para serem lidos por um controlador de determinado tipo no seu computador. Existem vários tipos de resultado para onde poderá ser enviado um ficheiro DVI, como uma impressora, um conversor para ficheiros PostScript ou PDF ou para o ecrã do seu computador. + + + + Ver um DVI + + Já acabou de ver como visualizar um ficheiro DVI com a opção Ver o DVI na barra de ferramentas. + + + + + + Imprimir um DVI + + Para imprimir um DVI, poderá usar o mesmo processo que usou para criar o seu documento anteriormente (veja em ). No passo 7, depois de ter carregado em Ver o DVI, seleccione a opção FicheiroImprimir no visualizador e, se já tiver a sua impressora devidamente configurada, será capaz de imprimir o DVI. + + + + + + Imprimir manualmente um DVI da consola + + Para imprimir um DVI manualmente a partir da consola, use primeiro o comando dvips intro.dvi. Este comando irá converter o seu DVI num ficheiro &postscript;. Logo que o seu ficheiro seja convertido, poderá então imprimi-lo com o comando lpr intro.ps. + + + + + + Exportar um DVI + + A barra de ferramentas dá-lhe as opções para exportar um DVI para outros formatos. Logo que tenha criado um ficheiro DVI a partir do seu código-fonte em &latex;, será capaz de o exportar para um formato à sua escolha com os botões da barra de ferramentas. + + + + + + + + Pesquisa Normal entre o &kile; e o &kdvi; + + As funções de pesquisa normal permitem-lhe saltar directamente do seu editor para a posição associada no ficheiro &DVI;. + Todos os binários recentes do &tex;/&latex; incluem a informação necessária automaticamente. Se você usar a versão 2 ou posterior da distribuição do &tetex;, poderá usar a opção src-specials da linha de comandos do &tex; ou &latex;, como se segue: latex --src-specials o_meu_ficheiro.tex + + + + O &kile; oferece uma configuração com esta opção para todos os executáveis de &latex;. Vá a ConfiguraçãoConfigurar o Kile...FerramentasCompilar e escolha sempre a configuração Moderna. + + Para executar uma pesquisa normal, posicione o cursor sobre uma linha de código e carregue em Pesquisa Normal do Kdvi para saltar para a posição associada na janela de visualização do DVI. + + + + + Pesquisa Inversa entre o &kile; e o &kdvi; + + A pesquisa inversa é uma funcionalidade muito útil quando está a escrever um documento de &latex; você mesmo. Se tudo estiver configurado convenientemente, poderá carregar na janela do &kdvi; com o &MMB; do rato (em alguns sistemas, quando não tem um rato de três botões, poderá usar em simultâneo o botão esquerdo e o direito). Depois disso, o seu editor favorito irá abrir, carregar o ficheiro de código de &latex; e saltar para o parágrafo correspondente. Para usar a pesquisa inversa, terá de compilar o seu ficheiro de &latex; com a configuração Moderna. + + A pesquisa inversa não poderá funcionar a menos que: + + + O ficheiro de código tenha sido compilado com sucesso. + O &kdvi; saiba qual o editor que desejaria usar. + + + Com esta funcionalidade do &kdvi;, um 'click' com o botão do meio do rato no documento DVI, fará com que o &kile; abra o documento de &tex; e tente ir para a linha correspondente. Lembre-se de indicar ao &kdvi; para usar o &kile; como um editor de texto, no item do &kdvi; ConfiguraçãoOpções do DVI.... + + + Configurar o &kdvi; + + + + + + Configurar o &kdvi; + + Configurar o &kdvi; + + + + + + + + Resolver Erros + + Se você está a tentar usar a criação rápida e o visualizador do DVI não abrir, as hipóteses serão que você tenha um erro. Se for o caso, ele ficará visível na área de mensagens/ficheiros do registo e o resumo do erro será indicado. + + O ficheiro de registo irá explicar a origem do erro no seu código. No editor, poderá usar os botões da barra de ferramentas Erro de LaTeX Anterior e Erro de LaTeX Seguinte para saltar de um erro para outro. O ficheiro de registo indica sempre em que linha ocorreu o erro. Para ver a linha em que ocorreu um determinado erro, carregue no erro na janela de registo, para que o &kile; o leve para essa linha. + + + + + + + Iniciar um Novo Documento + + Quando carregar no botão da barra de ferramentas para iniciar um documento novo, irá aparecer uma janela que lhe perguntará o tipo de modelo que gostaria de usar para escrever o seu documento. As escolhas por omissão são: + + + Documento vazio + Carta + Livro + Artigo + Relatório + Scrartcl (do pacote KOMA-Script) + Scrbook (do pacote KOMA-Script) + Scrlttr2 (do pacote KOMA-Script) + Scrreprt (do pacote KOMA-Script) + + + Se tiver seleccionado um Documento vazio, poderá tanto começar a escrever um documento do zero como poderá usar o assistente para iniciar rapidamente um documento novo (veja em ). + + + + + Modelos + + Os utilizadores frequentes do &latex; usam tipicamente o mesmo preâmbulo para quase todos os documentos que usam. Os modelos poderão ser criados, gravados e carregados no &kile; para tornar mais fácil o início de um documento novo. + + + + Criar um Novo Modelo + + Para criar um modelo novo, você precisa de abrir primeiro um ficheiro &tex; / &latex; ou criar um ficheiro por si só. O &kile; poderá gerar um modelo a partir de um documento existente se abrir o documento desejado e seleccionar a opção FicheiroCriar Modelo a Partir de Documento. + + + + + + Configurar as Substituições Automáticas + + Ao criar um novo documento através da selecção de um modelo na opção FicheiroNovo, certas combinações de caracteres serão substituídas por alguns dados como o seu nome ou a codificação que estiver a usar. Estas variáveis poderão ser configuradas em ConfiguraçãoConfigurar o Kile...ConfiguraçãoGeral. + + Ao desenhar o seu próprio modelo, é útil saber quais as combinações de caracteres que são substituídas por determinadas variáveis-modelo: + + + $$AUTHOR$$: Este texto será substituído pela variável do autor. + $$DOCUMENTCLASSOPTIONS$$: Este texto será substituído pela variável das opções do 'documentclass' (classe do documento). Tipicamente é usado da seguinte forma: \documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}. + $$INPUTENCODING$$: Se a variável da codificação de entrada estiver configurada, por exemplo, como latin1 este texto será substituído por \input[latin1]{inputenc}. + + + + + + + Criar Modelo utilizando o Assistente + + A forma mais simples de criar um novo modelo é iniciar o assistente e adicionar então os comandos no editor. Logo que tenha o seu documento configurado da forma que desejar: + + + Grave o seu ficheiro; + Vá a Ficheiro; + Escolha Criar Modelo a partir do Documento; + Efectue quaisquer correcções necessárias ao modelo; + Indique um nome para o novo modelo; + Carregue em OK para adicionar o seu modelo ao menu. + + + Da próxima vez que iniciar um documento novo, será então capaz de escolher o seu modelo personalizado em vez dos modelos predefinidos. + + + + + + Criar Modelo a partir de qualquer Ficheiro + + Um modelo poderá ser criado a partir de qualquer ficheiro em &latex;. Se estiver à procura de uma forma simples de configurar um modelo, procure um modelo na Internet e siga os mesmos passos indicados em . + + Por exemplo, poderá querer criar um poster completo em A0. Estes posters são normalmente vistos nas conferências científicas e o &latex; ajudá-lo-á a criar um poster bonito e interessante. Poderá obter um modelo para os posters em A0 na página pessoal de Jonathan Marchini, mas existem muitas mais disponíveis. Lembre-se que irá necessitar do pacote a0poster, o qual não está normalmente incluído numa distribuição normal do &tetex;, por isso terá de o obter e copiar para uma pasta do &tex;, como por exemplo a /usr/share/texmf/tex/latex/a0poster/ e executar o texhash para que o &latex; saiba que este existe. Não se esqueça de alterar as permissões do ficheiro para que toda a gente o possa ler. + + + + + + Remover um Modelo + + Para remover um modelo do &kile;, faça o seguinte: + + + Vá a ConfiguraçãoRemover Modelo...; + Irá aparecer uma janela com todos os modelos listados: seleccione um deles; + Carregue em OK e o modelo será removido. + + + Os modelos marcados com um asterisco (*) não poderão ser removidos sem a devida permissão. + + + + + + + + + Editar Documentos &latex; + + O editor interno que o &kile; usa é o &kate;. O Kate é um editor de texto criado para programadores e que incorpora a capacidade de ler e realçar vários tipos diferentes de ficheiros de texto, entre os quais o &latex; e o &bibtex;; poderá aceder a várias opções do &kate; directamente a partir do menu Ferramentas do &kile;. + + Para aprender mais sobre o &kate; e as suas capacidades, veja o Manual do Kate. Os utilizadores do &kile; poderão começar a ler a partir do capítulo Trabalhar com o Editor Kate. + + + + A Referência de &latex; + + O &kile; oferece uma referência das marcas de &latex; muito prática, à qual poderá aceder se escolher a opção AjudaReferência de LaTeX. Ela contém uma descrição detalhada de quase todos os comandos que poderá usar no &latex; e a sua sintaxe. + + + + + + Movimentos de Cursor + + Para seleccionar texto, tem as seguintes opções: + + + Mantenha carregado o botão esquerdo do rato e arraste o rato para seleccionar algum texto. + Carregue uma vez sobre uma palavra para mover o cursor para uma nova área. + Carregue duas vezes numa palavra para seleccionar a palavra inteira. + Carregue três vezes para seleccionar a frase inteira. + + + Se mantiver carregado o botão esquerdo do rato e arrastar o texto que deseja seleccionar, irá copiar automaticamente o texto seleccionado para a área de transferência. + + Se carregar no Shift e usar as teclas de cursores, poderá seleccionar partes do código-fonte na janela do editor. + + + + + + Parêntesis + + A completação de parêntesis é uma ferramenta visual que o editor usa para lhe indicar qual o parêntesis que corresponde a outro. Se você abrir qualquer ficheiro .tex e seleccionar qualquer parêntesis, seja ele um normal (), recto [] ou chaveta {}, o editor irá realçar o parêntesis recto e a sua correspondência a amarelo (esta cor predefinida poderá ser alterada). Por isso, por exemplo, se posicionar o cursor nas chavetas em \section{Introdução}, irá ver o \section{Introdução} no realce amarelo por omissão, mostrando-lhe a localização dos parêntesis inicial e final. + + + + + + Realce + + O &kile; tem a capacidade de procurar e realçar vários tipos diferentes de código. Por exemplo, os comandos de &latex; são distinguidos do texto normal e as fórmulas são também realçadas com uma cor diferente. + + + + + + Pontos + + Vários assistentes poderão introduzir pontos opcionais, uma espécie de marcadores de favoritos no texto. Os itens do menu EditarPontos ou os atalhos de teclado correspondentes permitir-lhe-ão saltar para o próximo ou último ponto. Isso irá também realçar este ponto, de modo que seja removido automaticamente, sempre que você introduzir a sua primeira letra. + + + Pontos + + + + + + Pontos + + + + + + + &Ctrl;&Alt;Direita Próximo Ponto + Salta para o próximo ponto do texto, se existir. + + + &Ctrl;&Alt;Esquerda Último Ponto + Salta para o ponto anterior no texto, se existir. + + + + + + + + + Seleccionar + + A edição é, obviamente, um dos aspectos principais quando você usar um programa como o &kile;. Ainda que o &kate; já tenha óptimas capacidades, o &kile; adiciona algumas funcionalidades importantes, as quais são especialmente necessárias para escrever código em Latex. O &latex; necessita sempre de vários ambientes e grupos, como tal o &kile; suporta comandos muito especiais para os seleccionar. Sob o menu EditarSeleccionar, irá encontrar os seguintes comandos para seleccionar texto. + + + Pontos + + + + + + Pontos + + + + + + &Ctrl;&Alt;S E Ambiente (dentro) + Selecciona um ambiente, sem as marcas envolventes. + + + &Ctrl;&Alt;S F Ambiente (fora) + Selecciona um ambiente, incluindo as marcas envolventes. + + + &Ctrl;&Alt;S T Grupo de TeX (dentro) + Selecciona um grupo de TeX, dentro dos parêntesis envolventes. + + + &Ctrl;&Alt;S U Grupo de TeX (fora) + Selecciona um grupo de TeX, incluindo os parêntesis envolventes. + + + &Ctrl;&Alt;S P Parágrafo + Selecciona um parágrafo inteiro, i.e., um grupo de linhas de texto separadas em ambos os lados por linhas vazias. Como tal, um parágrafo não significa apenas linhas contínuas de texto, como está habituado nos editores de texto normais. Este significado extendido também inclui tabelas, comandos de &latex; e outras linhas de código. A única coisa importante do &kile; é que o parágrafo é separado por duas linhas vazias. + + + &Ctrl;&Alt;S L Linha + Selecciona a linha de texto na posição actual do cursor. + + + &Ctrl;&Alt;S W Palavra do TeX + Selecciona a palavra sob a posição actual do cursor. Esta selecção tem também um significado extendido, dado que este comando também permite seleccionar comandos de &latex;, que comecem por uma barra invertida e que possam também ter um asterisco opcional no fim. + + + + + + + + + Apagar + + Para remover algumas partes de um documento, poderá seleccioná-lo e usar então a tecla Delete. Contudo, o &kile; oferece uma forma mais rápida com os seus próprios comandos de remoção. Estes diferem dos comandos de selecção apenas numa posição, dado que o comando Remover uma Linha não está implementado. O &kate; já oferece um comando destes com a combinação &Ctrl;K, de modo que não há necessidade de adicionar outro. Em EditarRemover, irá encontrar os seguintes comandos para remover texto. + + + Pontos + + + + + + Pontos + + + + + + &Ctrl;&Alt;T E Ambiente (dentro) + Remove um ambiente, sem as marcas envolventes. + + + &Ctrl;&Alt;T F Ambiente (fora) + Remove um ambiente, incluindo as marcas envolventes. + + + &Ctrl;&Alt;T T Grupo de TeX (dentro) + Remove um grupo de TeX, dentro dos parêntesis envolventes. + + + &Ctrl;&Alt;T U Grupo de TeX (fora) + Remove um grupo de TeX, incluindo os parêntesis envolventes. + + + &Ctrl;&Alt;T P Parágrafo + Remove um parágrafo completo. Veja o comando SeleccionarParágrafo para saber como se define um parágrafo no &kile;. + + + &Ctrl;&Alt;T W Palavra do TeX + Remove a palavra ou comando de &latex; sob a posição actual do cursor. + + + + + + + + + Ambiente + + Já foi mencionado anteriormente que os ambientes são um ponto central no &latex;. Como tal, o &kile; oferece outros quatro comandos para facilitar ao máximo o trabalho com o &latex;, sob os submenus EditarAmbiente . + + + Pontos + + + + + + Pontos + + + + + + + &Ctrl;&Alt;E B Ir Para o Início + Este comando irá saltar para o início do ambiente actual, seja qual for a sua posição actual. O cursor será colocado directamente à frente da marca de abertura do ambiente. + + + &Ctrl;&Alt;E E Ir Para o Fim + Este comando irá saltar para o fim do ambiente actual, seja qual for a sua posição actual. O cursor será colocado directamente atrás da marca de fecho do ambiente. + + + &Ctrl;&Alt;E M Correspondência + Quando o seu cursor estiver à frente ou por cima da marca \begin{ambiente}, ele irá parar no extremo oposto do ambiente, e vice-versa. + + + &Ctrl;&Alt;E C Fechar + Se escrever um conjunto de marcas aninhadas, poderá perder o controlo de todos esses ambientes. Este comando irá fechar o último ambiente aberto, de modo que a estrutura aninhada dos ambientes não se quebre. + + + + + + + + + Grupo de &tex; + + O &kile; também oferece alguns comandos especiais para os grupos de &latex;, os quais são determinados pelas chavetas {...}. No submenu EditarGrupo de TeX, irá encontrar alguns comandos importantes que correspondem aos do EditarAmbiente. + + + Pontos + + + + + + Pontos + + + + + + &Ctrl;&Alt;T B Ir Para o Início + Este comando irá saltar para o início do grupo actual, seja qual for a sua posição actual. O cursor será colocado directamente à frente do parêntesis de abertura. + + + &Ctrl;&Alt;T E Ir Para o Fim + Este comando irá saltar para o fim do grupo actual, seja qual for a sua posição actual. O cursor será colocado directamente antes do parêntesis de fecho. + + + &Ctrl;&Alt;T M Correspondência + Quando o seu cursor estiver à frente ou por cima da chaveta de abertura de um grupo do &tex;, ele irá parar no extremo oposto do grupo, e vice-versa. + + + &Ctrl;&Alt;T B Fechar + Se escrever um conjunto de chavetas de grupos aninhados, poderá perder o controlo de todos esses grupos. Este comando irá fechar o último grupo aberto, de modo que a estrutura aninhada dos grupos não se quebre. + + + + + + + + + Aspas + + No &latex;, são usadas duas plicas como aspas. Para o ajudar a inseri-las de forma eficiente, o &kile; permite-lhe carregar em " para inserir duas plicas de abertura. Para além disso, se quiser fechar as aspas, terá também de carregar em ". O &kile; será suficientemente inteligente para reconhecer este caso e introduz duas plicas de fecho no &latex;. + + Para obter umas aspas literais do outro lado, carregue duas vezes em ". + + Poderá activar ou desactivar esta inserção automática das aspas de abertura e fecho em ConfiguraçãoConfigurar o Kile...LaTeX. + + + Pontos + + + + + + Pontos + + + + + Se também incluir opções específicas da língua ou ficheiros de estilos como o ngerman ou o french, poderá também ser capaz de usar as aspas alemãs ou francesas. + + Estas aspas serão também usadas nas outras línguas. Veja a sua documentação do &tetex; para descobrir qual a opção ou o ficheiro de estilo a usar para a sua língua. + + + + + + Mudança de Linha Inteligente + + Se carregar em &Shift;Return, o &kile; irá inserir uma mudança de linha inteligente. Se a sua posição actual for dentro do ambiente de uma lista, como o enumerate ou o itemize, o &kile; não só irá inserir uma mudança de linha, como também irá adicionar um comando \item. + + Se estiver dentro do ambiente de uma tabela, o &kile; irá terminar a linha actual com um \\, seguido da linha nova. + + Ainda melhor, o &kile; é inteligente o suficiente para suportar o &latex; predefinido e o ambiente definido pelo utilizador, que poderá ser adicionado na secção ConfiguraçãoConfigurar o Kile...LaTeX. + + + + + + Tabulação Inteligente + + Alguns utilizadores gostam de organizar as colunas nos ambientes de tabelas e colocar todos os caracteres de E-comerciais & por baixo uns dos outros. O &kile; tenta suportar isto. Se carregar em &Shift;&Alt;&, o &kile; irá procurar a próxima tabulação na linha acima. Ainda que isto possa não corresponder à tabulação certa, o &kile; irá adicionar alguns espaços para ajustar a posição da coluna à página actual. + + + + + + + + Completação de Código + + Ainda que o &kate; já ofereça um bom modo de completação, a completação de código extendida do &kile; suporta alguns métodos especiais para o &latex;. Estão integrados seis modos diferentes. Três deles funcionam a pedido, enquanto os outros dois são modos de completação automática. Todos os modos podem ser configurados para funcionar de forma bastante diferente em ConfiguraçãoConfigurar o &kile;.... + + + + Completação Automática de Ambientes + + Quando você começa um ambiente novo, se escrever \begin{ambiente}, o &kile; irá adicionar automaticamente um \end{ambiente}, com uma linha no meio para o seu texto. + + A completação automática poderá ser desactivada na secção do &latex; na opção ConfiguraçãoConfigurar o Kile...LaTeXAmbientes. + + + Completar um Ambiente de Equação + + + + + + Completar um Ambiente de Equação + + Completar um Ambiente de Equação + + + + + + + + Comandos de &latex; + + Quando você escrever algumas letras, poderá activar este modo de completação para os comandos de &latex; e para as palavras normais com a opção de menu EditarCompletarComando de LaTeX ou com o atalho de teclado &Ctrl;Espaço. O &kile; irá ler primeiro as letras da posição actual do cursor à esquerda e pára no primeiro carácter que não seja uma letra ou uma barra invertida. Se este padrão começar por uma barra invertida, o &kile; irá entrar no modo de completação de comandos de &tex; ou &latex;. Caso contrário, irá entrar no modo normal de dicionário, onde não irá encontrar quaisquer comandos do &latex;. Dependendo do modo escolhido, será aberta uma janela de completação. Irá ver todos os comandos ou palavras, onde o início corresponde ao padrão actual. Poderá navegar com as teclas de cursores por esta lista e seleccionar um item com a tecla Return ou Enter, ou ainda com um duplo-click com o rato. + + + Completar um Comando do LaTeX + + + + + + Completar um Comando do LaTeX + + + + + Quando você carregar na tecla &Backspace;, a última letra do seu padrão será removida e a lista de palavras da completação poderá crescer automaticamente. Por outro lado, se escrever outra letra, o padrão será extendido e a lista de palavras visíveis poderá diminuir. + + Se optar por não seleccionar nenhuma das propostas, poderá sair desta janela com o &Esc;. + + O utilizador irá ver que todos os comandos estão escritos com uma pequena descrição dos seus parâmetros. Estas descrições estão, claro, cortadas quando você seleccionar um comando. Opcionalmente, poderá deixar que o &kile; introduza pontos nestes locais, para que possa saltar facilmente para estas posições com a opção EditarPontosPróximo Ponto e inserir o parâmetro que deseja. + + + Completar um Comando do LaTeX + + + + + + Completar um Comando do LaTeX + + + + + Vá a ConfiguraçãoConfigurar o Kile...KileCompletação para configurar uma ou mais listas deste tipo. Poderá então escolher listas de palavras diferentes para os comandos de &tex; e &latex;, bem como um modo de dicionário para as palavras normais. + + + + + + Ambientes + + O modo de comandos não é útil para ambientes completos. Terá sempre de escrever algumas letras do \begin e invocar o modo de completação, o que irá resultar numa lista enorme de marcas de ambientes. Por outro lado, os ambientes são usados com tanta frequência que o &kile; oferece um modo especial para completar os ambientes. Esqueça a marca de abertura e, simplesmente, escreva eq, por exemplo. + + Quando agora invocar o modo de completação com a opção EditarCompletarAmbiente ou o atalho de teclado &Alt;Espaço, a marca de abertura é adicionada automaticamente e você verá o \begin{eq}. Após esta alteração, a lista de completação estará muito mais limpa. + + + Completar um Comando do LaTeX + + + + + + Completar um Comando do LaTeX + + + + + Agora, seleccione um ambiente para ver este a fechar-se automaticamente. Para além disso, se o &kile; reconhecer um ambiente de listas, irá também introduzir uma primeira marca \item. + + + Completar um Comando do LaTeX + + + + + + Completar um Comando do LaTeX + + + + + Vá a ConfiguraçãoConfigurar o &kile;...KileCompletação para configurar uma ou mais listas deste tipo. Este modo usa as mesmas listas de palavras que o modo de completação dos comandos de &tex; e &latex;. + + + + + + Abreviaturas + + O &kile; suporta as listas de abreviaturas definidas pelo utilizador, as quais são substituídas a pedido por sequências de texto maiores. Veja em ConfiguraçãoConfigurar o &kile;...KileCompletação para configurar uma ou mais listas destas. Para o exemplo acima indicado, a lista de abreviaturas em exemplo.cwl deverá ser escolhido. Neste ficheiro, irá encontrar o item L=\LaTeX, por exemplo. + + Vamos começar agora e escrever, por exemplo, apenas a letra L. Agora, invoque o modo de abreviatura da completação de palavras com EditarCompletarAbreviaturas ou com o atalho de teclado &Ctrl;&Alt;Espaço para a letra L ser substituída pelo texto \LaTeX. + + + + + + Modos de Auto-Completação + + + + Comandos de &latex; + + Poderá também activar um modo de completação para os comandos de &latex;. Quando se atingir um dado limite de letras (por omissão: 3), aparece uma janela com uma lista de todos os comandos de &latex; correspondentes. Poderá seleccionar um destes comandos ou ignorar esta janela e escrever mais letras. Os itens da área de completação irão sempre alterar e corresponder à sua palavra escrita. Este modo está restrito aos comandos de &latex;, porque dicionários grandes necessitam de bastante memória e tempo. + + Vá a ConfiguraçãoConfigurar o &kile;...KileCompletação para activar e desactivar este modo ou mudar o limite. + + + Completar um Ambiente de Equação + + + + + + Completar um Ambiente de Equação + + + + + + + + + Palavras do Documento + + Os dicionários bons não são úteis no modo de completação. Porém, já se viu que algumas das palavras de um documento são escritas mais que uma vez. Como tal, o &kile; oferece a completação de todas as palavras do documento que o utilizador já escreveu anteriormente. + + Se quiser activar ou desactivar este modo, vá a ConfiguraçãoConfigurar o &kile;...KileCompletação. Nesta janela de configuração, poderá também alterar o valor-limite a partir do qual aparece a janela de completação. + + + + + + + + + + Assistentes e Janelas + + + + Incluir Gráficos + + A janela Incluir Gráficos torna a inserção de imagens a mais simples possível. Veja por favor as secções Formatos de Ficheiro Gráficos e Imagens EPS para ter uma ideia geral de alguns factos relacionados com os formatos gráficos. + + + Incluir um elemento gráfico + + + + + + Incluir um elemento gráfico + + + + + + Escolha um ficheiro gráfico. Este poderá ser um ficheiro JPEG, PNG, EPS ou ainda um ficheiro EPS comprimido com o 'zip' ou o 'gzip', se tiver um sistema de &tetex; configurado convenientemente. Se tiver instalado o ImageMagick e também tiver configurado o &kile; para o usar (ConfiguraçãoConfigurar o KileLaTeXGeral), a largura e a altura da imagem será mostrada automaticamente. Se o ImageMagick conseguir determinar uma resolução, o tamanho da imagem será também mostrado em centímetros. + + Decida se a sua imagem deverá ficar centrada na página. + + Escolha entre o &latex; tradicional e o PDF&latex;. Lembre-se que o PDF&latex; pode também criar resultados em DVI, não apenas em PDF. + + Poderá escolher se o nome do ficheiro é relativo ou não. Esta é a forma preferida, quando você usa um comando \graphicspath. + + Por omissão, os ficheiros gráficos terão de estar na mesma pasta que o seu documento-mestre, para os encontrar. Contudo, é possível colocá-los noutras pastas para tornar as coisas mais claras. Sem um comando \graphicspath, o &kile; iria incluir a localização do ficheiro de imagem. Mas, se usar o \graphicspath da seguinte forma: + +\graphicspath{{/localizacao/das/minhas/imagens}{outro/local/para/mais/imagens}} + + + e assinalar esta opção, o &kile; irá usar apenas o nome de base do ficheiro da imagem. + + Outro exemplo: se configurar o comando \graphicspath da seguinte forma: + +\graphicspath{{./}{camara/}{imagens/}} + + + o &latex; irá procurar na pasta actual, depois na camara e finalmente em imagens, para descobrir o seu ficheiro de imagem. + + Se indicar uma largura ou uma altura, a imagem completa será redimensionada de forma proporcional. Por favor, não define dois valores para a largura e para a altura ao mesmo tempo. Isto redimensiona a imagem com factores diferentes para a largura e a altura, o que de certeza não será o que deseja. Veja também a informação perto do topo da janela, para ver o tamanho original da imagem. + + Indique um ângulo, para a imagem ser rodada no sentido contrário ao dos ponteiros do relógio. + + A informação da caixa envolvente é configurada automaticamente, quando você escolher um ficheiro gráfico. Esta informação só é necessária quando você trabalhar com o &latex; tradicional e com imagens rasterizadas. Veja a discussão sobre as imagens EPS. + + A sua última escolha passa por incorporar esta imagem num ambiente de figuras. Se optar por fazê-lo, poderá também atribuir um título e uma legenda. É uma boa ideia dar prefixos diferentes aos vários tipos de legenda. O &kile; sugere o prefixo fig: para as imagens. + + + + + + + Assistência nas Listas + + Um dos trabalhos mais aborrecidos que uma pessoa poderá fazer no &latex; é criar uma matriz ou um ambiente de tabelas. Terá de ter uma ideia de todos os elementos, garantir que o ambiente está definido de forma válida e que todas as coisas estão no seu sítio correcto. Uma boa indentação ajuda, mas existe uma forma mais simples: usando o menu do Assistente do &kile;. Para além da opção do Arranque Rápido, contém o Tabular e o Vector (usados nos ambientes matemáticos). Irá ter então um formulário em forma de matriz onde poderá preencher facilmente os seus itens. Esta janela também oferece algumas opções para escrever o material da tabela. + + + Inserir um ambiente tabular + + + + + + Inserir um ambiente tabular + + + + + A opção Tabelas irá mostrar um menu mais simples para configurar um ambiente em tabelas. Em todos estes ambientes, poderá configurar facilmente o número de linhas e colunas, em conjunto com outras opções específicas. + + + + + Utilitários de &postscript; + + Os ficheiros PS não são tão conhecidos como os ficheiros PDF, mas são uma base excelente para as manipulações e reorganizações das páginas. Se precisar de um resultado em PDF, poderá reorganizar as páginas com alguns utilitários de &postscript; e depois convertê-las para PDF com o comando ps2pdf. + + O Assistente de &postscript; sugerir-lhe-á as reorganizações mais conhecidas, mas você está à vontade para fazer as suas próprias escolhas. O trabalho é feito pelos programas pstops e psselect, os quais irá encontrar, na maioria das distribuições, no pacote psutils. Se um destes programas não estiver disponível, os itens correspondentes não ficarão visíveis. + + + Inserir um ambiente tabular + + + + + + Inserir um ambiente tabular + + + + + Escolha primeiro o seu ficheiro de entrada. Se o &kile; encontrar um ficheiro PS, que corresponda ao seu documento-mestre actual, este estará já preenchido como ficheiro de entrada. Porém, você está à vontade para escolher outro ficheiro. Escolha então um ficheiro de saída, bem como uma das tarefas. Finalmente, terá de decidir se só pretende fazer a conversão ou também invocar o &kghostview; para ver o resultado. + + + + + 1 página A5 + página vazia --> A4 + Combinar uma página A5 em conjunto com uma página vazia numa página A4. Sempre que duas páginas A5 forem combinadas em conjunto, estas são rodadas 90 graus e serão organizadas numa página DIN A4 no modo de paisagem. + + A5 + página vazia + + + + + + A5 + página vazia + + + + + + + + 1 página A5 + duplicado --> A4 + Colocar uma página A5 e um duplicado em conjunto numa página A4. + + páginas A5 duplicadas + + + + + + Duplicar uma página A5 + + + + + + + + 2 páginas A5 --> A4 + Colocar sempre duas páginas A5 consecutivas numa única página A4. + + combinar duas páginas A5 + + + + + + combinar duas páginas A5 + + + + + + + + 2 páginas A5L --> A4 + Colocar duas páginas A5 consecutivas no modo paisagem em conjunto numa página A4. + + + + 4 páginas A5 --> A4 + Combina quatro páginas A5 consecutivas em conjunto, numa única página A4. As páginas A5 terão de ser redimensionadas com um factor de 0,7 para caber na página. + + 4 páginas A5 --> A4 + + + + + + 4 páginas A5 --> A4 + + + + + + + + 1 página A4 + página vazia --> A4 + Combinar uma página A4 em conjunto com uma página vazia numa página A4. Sempre que duas páginas A4 forem combinadas em conjunto numa única página A4 resultante, estas terão de ser redimensionadas com um factor de 0,7 e organizadas numa página A4 no modo de retrato. + + 1 página A4 + página vazia --> A4 + + + + + + 1 página A4 + página vazia --> A4 + + + + + + + + 1 página A4 + duplicado --> A4 + Colocar uma página A4 e um duplicado em conjunto numa página A4. + + 1 página A4 + duplicado --> A4 + + + + + + 1 página A4 + duplicado --> A4 + + + + + + + + 2 páginas A4 --> A4 + Colocar sempre duas páginas A4 consecutivas numa única página A4. + + combinar duas páginas A4 + + + + + + combinar duas páginas A4 + + + + + + + + 2 páginas A4L --> A4 + Colocar duas páginas A4 consecutivas, no modo de paisagem, numa única página A4. + + + + escolher as páginas pares + Seleccionar todas as páginas pares de um documento. + + + + escolher as páginas ímpares + Seleccionar todas as páginas ímpares de um documento. + + + + escolher as páginas pares (ordem inversa) + Seleccionar todas as páginas pares de um documento e inverter a ordem. + + + + escolher as páginas ímpares (ordem inversa) + Seleccionar todas as páginas pares de um documento e inverter a ordem. + + + + inverter todas as páginas + Inverter todas as páginas de um documento. + + + + copiar todas as páginas (ordenado) + Copiar todas as páginas de um documento. Terá de escolher o número de cópias ordenadas. + + Copiar todas as páginas (ordenado) + + + + + + Copiar todas as páginas (ordenado) + + + + + + + + copiar todas as páginas (não ordenado) + Copiar todas as páginas de um documento. Terá de escolher o número de cópias não ordenadas. + + Copiar todas as páginas (sem ordem) + + + + + + Copiar todas as páginas (sem ordem) + + + + + + + + pstops: escolha o parâmetro + Existem muitas mais possibilidades para usar os utilitários de &postscript; pstops e psselect. Se necessitar de uma opção muito especial, poderá invocar o comando pstops com uma opção à sua escolha. Leia por favor o manual para conhecer todas as opções possíveis. + + + + psselect: escolha o parâmetro + Poderá invocar o comando psselect com uma opção à sua escolha. Veja por favor o manual para descobrir todas as opções possíveis. + + + + + + + + Estatísticas do Documento + + A janela de estatísticas dá-lhe uma ideia geral de uma selecção, um documento ou um projecto inteiro. Inclui o número de palavras, comandos/ambientes do &latex; e inclui também o número de caracteres de cada tipo. Os números estatísticos podem ser copiados como texto ou como uma tabela formatada devidamente em &latex; para a área de transferência. Se quiser obter estatísticas para todo o projecto, poderá usar a opção Abrir Todos os Ficheiros do Projecto para uma forma simples e rápida de abrir todos os ficheiros de código do seu projecto. + Terá de ser referida uma nota de atenção sobre a precisão dos valores. Foi incluída alguma lógica para obter uma boa estimativa; p.ex., K\"uhler dá uma palavra e um comando, com seis e dois caracteres, respectivamente. Mas existem outras combinações, com as quais partes dos comandos contam como palavras e vice-versa. Também tem de se recordar que o algoritmo foi desenvolvido e testado para línguas semelhantes ao inglês ou ao alemão. Por isso, não assuma os números como certos. Se tiver de fazer um relatório com um número exacto de palavras ou caracteres, faça alguns testes para verificar se a precisão do Kile satisfaz as suas necessidades. + + + + + + + + Marcas Especiais em &latex; + + + Usar a Biblioteca de Marcas do &latex; + + O &latex; tem centenas de marcas para os símbolos e caracteres especiais. A forma mais simples de inserir caracteres especiais é usar o menu lateral, à esquerda da janela do editor. + + + O Menu da Barra Lateral + + + + + + O Menu da Barra Lateral + + A Barra Lateral + + + + Para adicionar um carácter especial, carregue no tipo de carácter que deseja adicionar. Poderá adicionar os seguintes tipos de caracteres: + + + Símbolos de relação + Letras Gregas + Setas + Delimitadores + Símbolos diversos + Caracteres estrangeiros + + + + + + + Usar os Itens Bibliográficos + + O \bibitem é um comando usado para introduzir uma referência num ambiente thebibliography (a bibliografia) do seu documento. A sintaxe para usar o using \bibitem é \bibitem[legenda]{chave}. + + A [legenda] opcional é para você adicionar o seu próprio sistema de legendagem para o item da bibliografia. Se não estiver definida nenhuma legenda, os itens serão definidos por ordem numérica: [1], [2], [3], etc. + + O argumento {chave} é usado para referenciar e associar os comandos \bibitem e \cite um ao outro, bem como a informação que estes contêm. O comando \cite contém a legenda associada com o \bibitem pretendido, o qual se localiza dentro de um ambiente thebibliography e que contém os dados de referência. Ambos os comandos \bibitem e \cite deverão ter a mesma {chave}; a forma mais simples de organizar as chaves é pelo último nome do autor. Os parêntesis secundários no ambiente thebibliography indicam a legenda mais longa que poderá ter. Por isso, se introduzir um {xpto} significa que você poderá ter qualquer legenda mais pequena ou tão grande quanto a expressão xpto. Se não definir este parâmetro correctamente, poderá obter uma indentação não tão atractiva da sua bibliografia. + + A bibliografia é uma secção à parte do seu documento principal e um exemplo de código para a bibliografia seria semelhante ao seguinte: + + + \begin{thebibliography}{50} + \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm...donuts}. + Evergreen Terrace Printing Co., Springfield, Estados Unidos, 1998 + \end{thebibliography) + + Neste caso, o seu código-fonte principal iria conter a localização da informação referente ao \bibitem, usando o \cite. Este código-fonte seria semelhante a este: + + + A minha tese sobre a filosofia dos Simpsons\copyright + vem do meu livro favorito \cite{Simpson}. + + Dado que é normalmente difícil de recordar a chave de citação correcta, quando tiver várias referências, o &kile; oferece uma forma simples de inserir uma citação. Na barra de ferramentas para Editar, carregue na segunda lista (onde se lê normalmente label) e seleccione cite. Aí, irá aparecer uma lista com todas as chaves de citação: seleccione a referência correcta para inserir uma citação no seu documento. Para actualizar a lista de chaves, pode gravar o ficheiro ou escolha a opção EditarActualizar Estrutura. + + O produto final da bibliografia do seu documento iria então ficar parecido com o seguinte: + + [1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, Estados Unidos, 1998. + + A forma mais simples de trabalhar com o \bibitem e o \cite é usar a lista da barra de ferramentas chamada cite. Quando seleccionar uma citação para a inserir, ser-lhe-á dada a lista de bibitems que tiver criado até agora e será capaz de seleccionar a referência da lista. O &kile; pode também lidar com aplicações de edição do &bibtex;, como o &gbib; e o &pybliographer;, para tornar as citações ainda mais simples. + + + + + + Marcas Definidas pelo Utilizador + + O &kile; dá-lhe a possibilidade de criar as suas próprias marcas. Uma marca é semelhante a um atalho que invoca algum comando ou escreve algum texto usado frequentemente. Por exemplo, o Zé Maria usa com frequência as frases Prefiro o \LaTeX\ ao \TeX\ e O que faria sem o Linux?. Para criar marcas definidas pelo utilizador para escrever estas frases, ele iria aceder à opção UtilizadorMarcas do UtilizadorEditar as Marcas do Utilizador; isto irá apresentar-lhe uma janela em que ele poderá criar as suas próprias marcas. + + + A Janela de Edição de Marcas do Utilizador + + + + + + A Janela de Edição de Marcas do Utilizador + + A Janela de Edição de Marcas do Utilizador + + + + + Invocar uma Marca Definida pelo Utilizador + + + + + + Invocar uma Marca Definida pelo Utilizador + + Invocar uma Marca Definida pelo Utilizador + + + + Ele iria dar provavelmente a cada marca um nome que a pudesse identificar claramente. O nome que der à sua marca é indicado na secção chamada Item do menu e o texto do comando usado frequentemente seria indicado no campo Valor. Logo que os comandos forem introduzidos, ele podê-los-á usar rapidamente com o atalho CtrlShift 1 para a primeira marca para introduzir Prefiro o \LaTeX\ ao \TeX\ e o CtrlShift 2 para introduzir o O que faria sem o Linux?. + + + + Substituições nas Marcas Definidas pelo Utilizador + + Existem algumas substituições que poderá usar nas marcas definidas pelo utilizador: elas são o %S, o %B, o %M e o %C. + + + %B: será substituído por um ponto. + %C: aqui é onde o cursor será colocado depois de usar uma marca do utilizador. + %M: corresponde ao texto marcado; o texto seleccionado é inserido no seu lugar ao usar as marcas definidas pelo utilizador. + %S: será substituído pelo nome do ficheiro de código. + + + Para lhe mostrar como é que isto funciona, vai-se ver um exemplo em que existe uma marca definida pelo utilizador que contém o valor \bfseries{%M}%C e foi seleccionado o texto realçado no documento e que deseja passar a negrito. Deste modo, seleccionar-se-á a frase Adoro as Sextas-Feiras, aplica-se a marca definida pelo utilizador com o &Ctrl;&Shift;1 e obter-se-á o texto \bfseries{Adoro as Sextas-Feiras}, com o cursor colocado no fim do texto. + + + + + + + + + + As Ferramentas de Construção + + + + Compilar, converter e visualizar + + Para ver o resultado do seu trabalho, precisa primeiro de compilar o código. Todas as ferramentas de compilação estão agrupadas nos menus CriarCompilar, CriarConverter e CriarVer. + + Para compilar o seu código-fonte para os visualizadores como o &kdvi;, os outros visualizadores de DVIs ou outras conversões, poderá usar o atalho &Alt;2. Aí, poderá ver o ficheiro DVI com o seu visualizador por omissão com o &Alt;3, converter o DVI para um ficheiro PS com o &Alt;4 e ver o ficheiro PS com o &Alt;5. + + + + &bibtex; + + Se estiver a usar o &bibtex; para os seus itens bibliográficos, terá de seguir um esquema de compilação especial. + + + Execute o &latex; com &Alt;2. + Execute o &bibtex; com o &Alt;-: isto irá compilar o ficheiro da bibliografia. + Execute duas vezes o &latex; de novo, para incorporar a informação da bibliografia compilada e para ter as citações e as referências cruzadas correctas. + + + Poderá ver também o ficheiro do &bibtex; com o seu editor do &bibtex; (como por exemplo o &gbib;) se escolher a opção CriarVerVer o Bibtex; poderá alterar o visualizador do &bibtex; por omissão em ToolsConfigurar o Kile...Ferramentas. + + + + + + MakeIndex + + Se estiver a usar o pacote &makeidx; para criar um índice final e alfabético para o seu documento, terá também de seguir um certo padrão de compilação. + + + Execute o &latex; com &Alt;2. + Crie o índice com o &Alt;=: isto irá compilar o ficheiro do índice. + Execute o &latex; de novo para incorporar a informação de índice compilada. + + + + + + + MetaPost + + Se quiser compilar o seu documento com o MetaPost, um programa de desenho de imagens, podê-lo-á fazer com a opção CriarCompilarMpost. + + + + + + PDF&latex; + + Existe também outra forma de compilar o seu documento, se quiser um PDF: poderá executar o PDF&latex;, que irá compilar o código directamente para um ficheiro PDF, com o &Alt;6: poderá então ver o ficheiro compilado se carregar em &Alt;7. + + Em alternativa, poderá converter um PS num PDF com o &Alt;8 ou, directamente, um DVI para um PDF com o &Alt;9. + + Se usar o PDF&latex; em vez do &latex;, poderá ser uma questão de simplicidade ou hábito, mas em algumas ocasiões o comportamento dos dois programas poderá ser diferente. + + + + + + &latex;2HTML + + Finalmente, poderá querer publicar o seu trabalho na Web e não apenas no papel. Poderá então, neste caso, usar o programa latex2html, que poderá ser invocado a partir do menu do &kile; em CriarConverterLaTeX para HTML. O resultado será colocado numa subpasta da pasta de trabalho, sendo para si possível ver o resultado da conversão com o item CriarVerVer o HTML. + + + + + + Passar Parâmetros da Linha de Comandos + + Se quiser passar alguns parâmetros específicos da linha de comandos para as ferramentas de compilação, conversão ou visualização, poderá configurar as invocações das mesmas em Configuração Configurar o Kile...Ferramentas. + + + + + + + + Antevisão Rápida + + + Irá necessitar sempre de algum tempo para ver o resultado, ao trabalhar com o &latex;. O &latex; tem de compilar o código e o visualizador terá de ser invocado. Isto poderá ser incómodo, quando alterou apenas algumas letras de uma equação, o que é difícil de escrever. O &kile; oferece agora um modo de Antevisão Rápida, onde poderá compilar apenas uma parte de um documento e poupar bastante tempo. Ele suporta três modos diferentes, os quais poderão ser combinados em sete configurações. + + + Pontos + + + + + + Pontos + + + + + Toda a configuração deverá ser feita em ConfiguraçãoConfigurar o Kile...FerramentasAntevisão. + + + Pontos + + + + + + Pontos + + + + + + + Modo de Selecção + + O utilizador terá de seleccionar uma parte do documento. O item do menu CompilarAntevisão RápidaSelecção ou o atalho de teclado &Ctrl;&Alt;PS irá iniciar os programas seleccionados. O &kile; usa o preâmbulo do texto original, de modo que todos os pacotes e os comandos definidos pelo utilizador serão incluídos. O utilizador poderá então escolher uma das sete configurações predefinidas: + + + LaTeX+DVI (visualizador incorporado) + LaTeX+DVI (KDVI) + LaTeX+PS (visualizador incorporado) + LaTeX+PS (KGhostView) + PDFLaTeX+PDF (visualizador incorporado) + PDFLaTeX+PDF (KGhostView) + PDFLaTeX+PDF (KPDF) + + + Isto deverá ser suficiente para todas as situações necessárias numa antevisão rápida. + + + + + + Modo do Ambiente + + Muitas das vezes, poderá querer antever o ambiente actual. Especialmente no caso de ambientes matemáticos, o que poderá ser difícil de escrever. O &kile; oferece uma forma muito rápida para o fazer. Não é necessária qualquer selecção, bastando para tal escolher CompilarAntevisão RápidaAmbiente ou o atalho de teclado &Ctrl;&Alt;PE, para que o ambiente actual seja compilado e apresentado. + + + + + + Modo de Sub-Documento + + Também é frequente que você tenha projectos com vários documentos. Se compilar todo o projecto, não será uma boa ideia, no caso de ter feito apenas alterações num único documento. O &kile; será capaz de compilar e mostrar uma antevisão do sub-documento actual. Ele retira o preâmbulo de uma documento-mestre definido e compila apenas este único documento, quando você escolher a opção CompilarAntevisão RápidaSub-documento ou o atalho de teclado &Ctrl;&Alt;PD. + + + + + + + + Formatos de Ficheiros Gráficos + + + + O &latex; e o PDF&latex; + + O PDF&latex;, quando for usado com os pacotes graphics ou o graphicx, poderá compilar correctamente os ficheiros PNG e JPG no PDF, mas não é capaz de lidar com os ficheiros EPS. Por outro lado, o processo de compilação para um DVI e a conversão para PS e, eventualmente, PDF suporta os EPS, mas não os ficheiros PNG e JPG. + + Diversos utilizadores desejam criar documentos PDF mas, por exemplo, tiram partido do pacote excelente Pstricks para criar imagens &postscript;; ou, por outro lado, desejam usar o resultado em &postscript; do 'software' matemático/científico, como o Mathematica, o Maple ou o MuPAD. Todos estes utilizadores de &latex; têm de seleccionar o formato PostScript, mesmo que desejem criar documentos PDF, dado que estes programas produzem código PostScript que não pode ser gerido pelo PDF&latex;. Todavia, não é assim tão complicado como parece, dado que o &kile; irá ajudar. + + + + + + Conversão de Imagens + + Para dar a volta a este ciclo frustrante, no caso de desejar tanto o código em &postscript; como os ficheiros PNG ou JPG, tem um conjunto de soluções alternativas: + + + Se necessitar de um ficheiro no formato PS, mas se tiver imagens JPG ou PNG, poderá também usar simplesmente o PDF&latex; com o resultado em DVI e depois usar a instrução da linha de comandos dvips. Irá ver que o PDF&latex; é uma escolha muito boa, se o seu código não tiver qualquer código em &postscript;. + + Poderá converter os ficheiros EPS para PNG ou outros formatos com alguns utilitários como o Gimp ou o ImageMagick e usar o PDF&latex;. + + Uma das formas preferidas é converter as imagens EPS para imagens PDF com o epstopdf, que vem com cada distribuição do &tetex; e então usar o PDF&latex;. Produz imagens de alta qualidade e poderá até controlar o resultado com algumas das opções seguintes: -dAutoFilterColorImages=false + -dAutoFilterGrayImages=false + -sColorImageFilter=FlateEncode + -sGrayImageFilter=FlateEncode + -dPDFSETTINGS=/prepress + -dUseFlateCompression=true + + + + Ainda melhor: se o seu sistema permitir o shell-escape, a conversão poderá ser feita na altura. Tudo o que terá de fazer é incluir o pacote epstopdf, que faz parte de todas as distribuições do &tetex;, com o comando \usepackage{epstopdf}. Assumindo que o seu código é + \includegraphics[width=5cm]{teste.eps} + Ao invocar o PDF&latex; com a opção pdflatex --shell-input, a imagem teste.eps é convertida automaticamente para teste.pdf. + + Esta conversão irá tomar lugar de cada vez que você executar o PDF&latex;. Se o seu comando gráfico é dado implicitamente + \includegraphics[width=5cm]{teste} +, o epstopdf verifica se o teste.pdf já está disponível, de modo que o passo de conversão poderá ser ignorado. + + Poderá converter da forma inversa e usar o &latex; e a conversão PS-PDF; esta nem sempre é uma boa ideia, dado que o encapsulamento em EPS dos JPGs ou PNGs poderá criar ficheiros maiores, que por sua vez geram documentos desnecessariamente grandes; isto é, contudo, altamente dependente do utilitário gráfico que usar, dado que o EPS pode encapsular outros gráficos, mas nem todas as aplicações suportam isto perfeitamente; algumas poderão, de facto, tentar criar a sua imagem JPG com vectores e programação diversa, o que irá resultar em ficheiros gigantes. A conversão de todos os formatos gráficos para EPS poderá ser conseguida com o ImageMagick. Outro programa simples que faz este processo correctamente é o jpg2ps. + + Poderá também usar uma forma automática de conversão. Todos os ficheiros gráficos são convertidos na altura para EPS e introduzidos no documento PS. Esta é uma forma confortável, mas o utilizador terá de configurar o seu sistema convenientemente. Isto é discutido na secção das Imagens EPS. + + + + + + + + Use o ficheiro correcto para a imagem correcta + + + O EPS é uma espécie de linguagem de programa de gráficos vectoriais, descrevendo todas as linhas e pontos que constituem o gráfico; parece bastante bom, mesmo quando é ampliado para além do seu tamanho por omissão e adequa-se bem a diagramas e a imagens vectoriais produzidas nativamente em EPS, parecendo bastante claro e definido e mantendo à mesma um tamanho de ficheiro bastante pequeno. + O PNG (ou o desactualizado GIF) é um formato de ficheiro sem-perdas, com boa compressão e qualidade. É bastante bom para diagramas, digitalizações de desenhos ou todo o tipo de imagens em que queira manter a definição. Pode-se tornar um grande abuso quando é usado para fotos. + O JPG é um formato com perdas que comprime melhor os ficheiros do que o PNG, conduzindo por outro a algumas perdas dos detalhes das imagens. Isto é normalmente irrelevante para as fotos, para poderá causar uma má qualidade para os diagramas, desenhos e poderá fazer com que algumas linhas finas desapareçam; nesses casos, use o EPS ou o PNG. + + + Porém lembre-se sempre: entra lixo, sai lixo! Não há nenhuma conversão que transforme uma imagem má numa boa. + + + + + + + + Imagens EPS + + Os ficheiros gráficos EPS são a forma tradicional de inserir ficheiros gráficos em documentos do &latex;. Dado que as listas de correio estão cheias de dúvidas no que respeita às imagens EPS, serão discutidos alguns aspectos importantes e será demonstrada a forma como o &kile; irá suportar esta tarefa. + + + + O &latex; e as Imagens EPS + + Se optou por usar o &latex; tradicional para produzir resultados em PS ou PDF, é provável que tenha alguns problemas com as imagens. Terá de usar as imagens EPS (Encapsulated &postscript;), e não os ficheiros JPEG ou PNG. Isto não deverá ser qualquer problema, dado que existem vários conversores, como o convert do excelente pacote que é o &imagemagick;. Contudo, é necessário algum tempo, como é óbvio. + + Os ficheiros EPS são usados tanto pelo &latex; como pelos conversores DVI-PS: + + + O &latex; procura no ficheiro EPS pela linha da caixa envolvente, a qual indica ao &latex; quanto espaço deverá reservar para a imagem. + + O conversor DVI-PS lê então o ficheiro EPS e insere a imagem no ficheiro PS. + + + Isto tem algumas implicações: + + + O &latex; nunca lê o ficheiro EPS se os parâmetros da caixa envolvente forem indicados no comando de inserção da imagem. + + Dado que o &latex; não consegue ler ficheiros que não sejam ASCII, não consegue ler a informação da caixa envolvente a partir de ficheiros comprimidos ou que não sejam EPS. + + As imagens EPS não são incluídas no ficheiro DVI. Dado que os ficheiros EPS deverão estar presentes quando o ficheiro DVI for convertido para PS, os ficheiros EPS deverão acompanhar os ficheiros DVI, sempre que estes forem movidos. + + + Agora poderá invocar o &latex;, e um conversor DVI-PS como o dvips para criar o seu documento em PostScript. Se o seu objectivo for um documento PSD, deverá executar o dvips com a opção -Ppdf e depois invocar o ps2pdf. Irá encontrar bastantes documentos que descrevem esta solução. + + + + + + O Formato &postscript; do &kile; + + O &kile; ajuda-o a obter a informação da Caixa Envolvente. Se tiver instalado o &imagemagick;, o &kile; irá extrair esta informação do ficheiro EPS e inseri-la como uma opção. Isto é feito automaticamente, quando você seleccionar o ficheiro da imagem. Existem duas vantagens para este procedimento: + + + A informação já está extraída durante a janela e não é preciso fazê-lo de novo pelo &latex;. + Ainda mais importante é o facto de também a largura e a altura da imagem poderem ser calculadas, quando a resolução da imagem for conhecida. Esta informação será apresentada perto do topo da janela e poderá servir como uma pista, sempre que o utilizador desejar dimensionar as imagens. + O &kile; poderá também suportar ficheiros EPS comprimidos com o 'zip' ou com o 'gzip', os quais são muito mais pequenos que os ficheiros EPS não comprimidos. Contudo, esta funcionalidade só poderá ser usada com uma configuração especial do sistema e com uma alteração na sua configuração local de imagens, como está descrito na secção Imagens Rasterizadas. + + + O Formato &postscript; do Kile poderá ser desligado ou ligado com a opção ConfiguraçãoConfigurar o Kile...LaTeXGeral. + + + + + + O Formato &postscript; e as Imagens Rasterizadas + + Se o seu sistema permitir o shell-escape, o &kile; também suporta uma forma simples de incluir imagens rasterizadas, se você configurar o seu sistema &tetex; convenientemente. Não existe a necessidade de converter as imagens JPEG ou PNG, sendo que isto pode ser feito automaticamente quando o ficheiro DVI for convertido para PS. + + O &latex; necessita de alguma informação acerca dos sufixos de ficheiros. O pacote graphicx irá procurar por um ficheiro graphics.cfg, que deverá estar algures no seu local de procura de documentos do &latex;. Procure por itens do género: + +\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}{}% + + + e substitua estas linhas por: + +\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}% EPS 'zipado' + \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}% EPS 'gzipado' + \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:-}% imagens PDF + + + Irá encontrar este ficheiro, por exemplo no Debian com a localização /etc/texmf/latex/graphics.cfg. As outras distribuições poderão ter outro local, mas cada sistema &tetex; tem um destes ficheiros de configuração para as imagens. A melhor forma de proceder é copiar este ficheiro para o local do seu 'tex' e então alterar este ficheiro. Veja o manual do &tetex; para saber como obter uma lista das suas pastas do &tex;. + + Com este ficheiro de configuração, você poderá ser capaz de introduzir imagens rasterizados e EPS comprimidos no &latex;. O comando de conversão é dado pelo dvips. Quando você olhar para o comando de conversão, irá ver que não será criado qualquer ficheiro extra. O resultado do processo de conversão é directamente encaminhado para o ficheiro PS. A única coisa que o &latex; precisa de saber é o tamanho da imagem e, como tal, é necessária a Caixa Envolvente, que é fornecida pelo &kile;. + + Algumas pessoas dizem que esta forma é insegura; terá de decidir como irá funcionar. Em qualquer um dos casos, não será necessária a caixa envolvente, atendendo a que o &kile; irá extrair esta informação de todos os tipos de imagens. + + + + + + O PDF&latex; e as Imagens EPS + + Tal como foi dito, o PDF&latex; não é capaz de lidar com ficheiros gráficos EPS; contudo, os conversores como o epstopdf poderão ajudar. A melhor forma é incluir o pacote epstopdf, o que deverá ser feito após carregar o pacote graphicx. + +\usepackage[pdftex]{graphicx} + \usepackage{epstopdf} + + + Agora já pode incluir imagens EPS, se executar o pdflatex com a opção . Mas poderemos fazer ainda melhor e lidar também com ficheiros EPS comprimidos com o 'zip' e o 'gzip'. Mais uma vez, terá de alterar o ficheiro de configuração de imagens graphics.cfg, como descrito acima. Desta vez, o texto a procurar será: + +% pdfTeX is running in pdf mode + \ExecuteOptions{pdftex}% + + + e bastará apenas adicionar algumas linhas. + +% 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}}% + }% + + + Com estas linhas, o PDF&latex; será capaz de lidar com os ficheiros EPS e, provavelmente, não existirão mais dúvidas no que respeite às imagens. + + + + + + + + Documento-Mestre + + Ao definir o seu documento como mestre permite-lhe trabalhar com ficheiros separados, o que lhe concede um documento-pai (ou documento-mestre) e os documentos-filhos, compondo assim um trabalho completo. Depois de ter definido o seu documento-mestre, com o comando respectivo no menu Configuração, todos os comandos do menu Ferramentas aplicar-se-ão só a este documento, mesmo que esteja a lidar com os documentos-filhos. Poderá até fechar o documento-mestre. + + + + + Tratamento de Erros + + Depois de ter compilado algo, o &kile; dá uma vista de olhos nas mensagens de erros que foram geradas. Se ocorreram alguns erros ou avisos, eles são mostrados brevemente na janela de Registo / Mensagens. Pode-se dar uma vista de olhos com atenção às mensagens ao seleccionar a opção CriarVer o Ficheiro de Registo ou usando o atalho de teclado &Alt;0. O registo gerado é então apresentado na janela de Registo / Mensagens; os erros e os avisos ficam então realçados. + + + Ver o registo + + + + + + Ver o registo + + Ver o registo + + + + Poderá saltar facilmente de uma mensagem no ficheiro de registo para outra com as opções CriarAviso / Erro de LaTeX Anterior / Seguinte ou usando os botões correspondentes na barra de ferramentas. + + Para saltar para a linha do ficheiro de &latex; onde ocorreu o erro ou o aviso, carregue neste na janela de Registo / Mensagens. O &kile; levá-lo-á automaticamente para a linha correspondente. + + + + + + O Modo de Vigiar Ficheiro + + Quando invocar a Construção Rápida, irá aparecer algum visualizador depois da compilação. Se não estiver a usar um visualizador incorporado, será aberta uma nova janela de cada vez. + + Se estiver a ajustar a aparência do seu documento, poderá invocar a Construção Rápida com bastante frequência e ter várias janelas de visualização abertas no seu ecrã; para evitar esta confusão, poderá activar o modo para Vigiar o ficheiro, o que irá evitar que a Construção Rápida lance um visualizador. + + De momento, o &kdvi; suporta a actualização contínua do ficheiro DVI visualizado, mas o &kghostview; não é tão perfeito: para actualizar o documento depois da compilação, você precisa de mudar de página, assim como o número de páginas não será alterado na visualização do &kghostview;. + + Este modo é obviamente inútil com os visualizadores incorporados, dado que tem de os fechar à mesma antes de voltar a editar o documento e a recompilar. + + + + + + + + Navegar no Código &latex; + + + + Utilizar a Vista de Estrutura + + A área da Estrutura mostra a hierarquia do documento que está a ser criado no &kile; e permite-lhe navegar rapidamente por ela, mostrando a sua segmentação. Para navegar pelo seu documento, tudo o que precisa é de carregar em qualquer legenda, capítulo, secção, sub-secção, etc., para que vá para o início da área correspondente. + + Se incluiu um ficheiro de &latex; separado no sue código com as marcas \input ou \include, estes ficheiros ficarão referenciado na área da Estrutura; se fizer duplo-click nos seus nomes, irá fazer com que o &kile; abra o ficheiro incluído na janela do editor. + + A árvore da hierarquia também tem um ramo em separado para as legendas usadas no texto. + + + Utilizar a Vista de Estrutura + + + + + + Utilizar a Vista de Estrutura + + Utilizar a Vista de Estrutura + + + + + + Actualizar a Vista de Estrutura + + Para actualizar a sua área da estrutura, poderá tanto ir ao item EditarActualizar Estrutura ou poderá gravar o seu documento, o que fará com que o &kile; actualize a sua área de Estrutura. + + + + + + + + Favoritos + + Os favoritos são a sua referência para um segmento de texto ou uma linha no ambiente do &kile;. Para usar um favorito, seleccione uma linha específica do seu documento para a qual gostaria de ir, carregando para tal em &Ctrl; B, para que o &kile; adicionasse um favorito a esta linha. Em alternativa, poderá também definir um favorito se seleccionar uma linha e escolher o menu FavoritoComutar o Favorito. + + Para remover todos os seus favoritos, seleccione os Favoritos Limpar os Favoritos. + + + + + + + + Projectos + + + + Trabalhar com Projectos + + No &kile;, poderá criar e trabalhar com os projectos. Um projecto é um grupo de documentos de &latex;, &tex; ou de outro formato que contenham toda a informação usada para criar o seu documento completo. Um projecto típico seria um documento que consiste em vários capítulos, estando cada um deles escrito em ficheiros .tex diferentes; todos eles poderiam ser incluídos num projecto, para tornar o documento inteiro mais fácil de gerir. Poderá também guardar ficheiros que não sejam de código, como por exemplo as imagens, num projecto. As definições do projecto são gravadas num ficheiro especial com a extensão .kilepr. + + Um projecto adiciona as seguintes funcionalidades: + + + Não precisa de definir nenhum documento-mestre; o &kile; fará isto automaticamente. + Os ficheiros do projecto poderão ser facilmente arquivados em conjunto. + A área dos Ficheiros e Projecto mostra quais os ficheiros que estão incluídos no projecto. + Depois de abrir um projecto, todos os ficheiros que foram abertos anteriormente serão repostos com a codificação e realce originais. + + + + + + + Criar um Projecto + + Para criar um projecto, seleccione a opção Projecto Novo Projecto.... Ser-lhe-ão pedidas as seguintes informações para criar o seu projecto: + + Título do seu projecto. + Nome do ficheiro de projecto com a extensão .kilepr. + Nome do ficheiro. + O tipo do ficheiro a criar: Documento Vazio, Artigo, Livro, Carta, Relatório. + + + Quando preencher o campo do nome do ficheiro, terá de incluir uma referência relativa do local onde o ficheiro .kilepr está guardado para o ficheiro do documento em si. + + + + + + A Área dos Ficheiros e do Projecto + + A área dos Ficheiros e do Projecto é um botão do menu lateral. Nesta área, poderá ver a estrutura do seu projecto, os seus ficheiros e o nome do ficheiro .kilepr que guarda a informação do projecto. As opções para adicionar, remover e modificar o seu projecto são feitas com a área dos Ficheiros e do Projecto. + + + A Área dos Ficheiros e do Projecto + + + + + + A Área dos Ficheiros e do Projecto + + A Área dos Ficheiros e do Projecto + + + + + + + + Adicionar e Remover Ficheiros + + Para adicionar um ficheiro ao seu projecto, abra qualquer ficheiro de &tex;, carregue com o botão direito no seu nome na área dos Ficheiros e Projecto e seleccione a opção Adicionar ao Projecto. Se tiver vários projectos abertos, aparecerá uma janela que lhe perguntará em que projecto será adicionado o ficheiro. + + Se tiver vários ficheiros para adicionar a um projecto, poderá seleccionar o projecto em si na área dos Ficheiros e Projecto e carregar com o botão direito e seleccionar a opção Adicionar Ficheiros; poderá então seleccionar os seus ficheiros numa janela. + + Poderá também carregar com o botão direito do rato no nome do projecto na área dos Ficheiros e Projecto e seleccionar a opção Adicionar Ficheiros... para mostrar uma janela de selecção de ficheiros. + + + Adicionar um ficheiro a um projecto + + + + + + Adicionar um ficheiro a um projecto + + Adicionar um ficheiro a um projecto + + + + Para remover um ficheiro de um projecto, carregue com o botão direito do rato nele e seleccione a opção Remover o Ficheiro. Isto não remove de facto o seu ficheiro, mas só o retira da lista de ficheiros contida no ficheiro .kilepr. + + + + + + Opções do Projecto + + O &kile; tem algumas opções relacionadas com o seu projecto que poderão ser definidas. Para as alterar, carregue com o botão direito no título do seu projecto e seleccione as Opções do Projecto, onde poderá então alterar: + + + O título do seu projecto. + O comando de arquivo. + Extensões reconhecidas de ficheiros que não sejam código. + A opção de utilizar a lista de extensões como expressões regulares. + + + + + Arquivar o seu Projecto + + O &kile; permite-lhe arquivar ou salvaguardar o seu projecto, gravando todos os seus ficheiros num único pacote (chamado normalmente de pacote TAR ou tarball). Para arquivar o seu projecto, carregue com o botão direito no seu nome na área dos Ficheiros e Projecto ou seleccione a opção ProjectoArquivar. + + Por omissão, todos os ficheiros de um projecto serão adicionados ao pacote. Se não quiser incluir um dado ficheiro no pacote, carregue com o botão direito na área dos Ficheiros e Projecto e desligue a opção Incluir no Arquivo. + + Os comandos de arquivo são simples comandos da consola que são executados a partir da pasta do projecto (onde se encontra o ficheiro .kilepr). Poderão ser usadas algumas substituições ao usar o comando de arquivo: + + + %S: isto é substituído pelo nome do ficheiro do seu projecto sem a extensão .kilepr. + %F: este comando é usado para substituir pela lista dos ficheiros a serem incluídos no pacote. + + + + + + + Extensões dos Ficheiros que Não São Código + + Os ficheiros não referentes a código são por exemplo as imagens, os ficheiros PDF ou &postscript;, etc. que deverão ser incluídos no projecto, mas que não são ficheiros do .tex. Terá a opção de usar as suas próprias expressões regulares que correspondam aos ficheiros não referentes a código. + + + + + + + + Fechar um Projecto + + Para fechar um projecto, seleccione a área Ficheiros e Projecto na barra de ferramentas vertical, carregue com o botão direito do rato e seleccione então a opção Fechar. Isto irá fechar o seu projecto, todos os ficheiros a ele associados e irá também adicionar o nome do projecto que fechou à opção Abrir um Projecto Recente... do menu Projecto. + + + + + + + + Codificação do Documento + + O editor &kile; permite-lhe ler, converter e configurar o texto para a codificação que o seu documento necessita. Isto permite-lhe usar letras e símbolos fora do normal; poderá usar, por exemplo, os caracteres acentuados do Português, do Francês ou do Italiano. A selecção da codificação do seu documento poderá ser feita de três formas: + + + Uma das formas é usar a lista Escolher a codificação, localizada no fundo da área lateral para Abrir um Ficheiro. + Outra forma é usar o submenu ConfiguraçãoConfigurar o Kile...Editor onde poderá definir a codificação predefinida para todos os ficheiros. + + Definir a codificação predefinida + + + + + + Definir a codificação predefinida + + + + + Uma terceira hipótese é definindo a codificação para o documento com a opção que usa ao criar um documento novo. + + + O &latex; propriamente dito só compreende o ASCII, um conjunto muito limitado de caracteres, como tal não podia usar directamente os caracteres acentuados ou especiais. Para usar os caracteres acentuados, foi criada uma sintaxe especial, como por exemplo o \"e para o ë. Existe um pacote que o ajuda nisto chamado inputenc, e é incluído no preâmbulo ao usar o comando \usepackage[latin1]{inputenc}, em que o argumento da opção é a codificação que gostaria de usar (na maioria dos casos é o latin1). Isto diz ao &latex; para traduzir todos os ë's que escrever em \"e's antes da compilação. Por favor veja a documentação do inputenc directamente para mais informações sobre o inputenc. Por último, mas não menos importante: lembre-se de confirmar que o seu ficheiro está de facto codificado com a mesma codificação que indicou no inputenc! + + + Escolher a codificação do ficheiro de código + + + + + + Escolher a codificação do ficheiro de código + + Escolher a codificação do ficheiro de código + + + + Este tipo de tabelas de codificação de caracteres diferentes tem criado alguns problemas em várias aplicações: por exemplo, não pode escrever um curso de Turco em Francês, sem que perca os caracteres especiais de uma das línguas. Existe um consenso geral de que, mais cedo mais tarde, todos irão mudar para o Unicode. Existem várias implementações do Unicode e a UTF-8 é a melhor sucedida no Linux; o Windows® baseia-se na codificação mais estranha e menos flexível que é a UCS-2. Algumas distribuições, como a RedHat, já começaram a configurar a sua codificação por omissão como sendo a UTF-8, por isso poderá estar bastante interessado em usar um argumento utf-8 no pacote inputenc. + + As más notícias é que isto ainda não está incluído no &tetex; até à altura em que este documento foi escrito; as boas notícias é que existe um pacote do &latex; que poderá fazer isso mesmo e que você poderá instalar por si próprio. + + + + O Pacote &ucs; + + Pode obter o pacote &ucs; na página pessoal do Suporte de Unicode para o &latex;, por Dominique Unruh da Universidade de Karlsruhe. + + Para o instalar, descomprima o pacote obtido e mova o conteúdo descomprimido para uma pasta que o &tex; consiga ver; poderá, por exemplo, usar a /usr/share/texmf/tex/latex/ucs/ (certifique-se que esta é, de facto, a sua pasta em $TEXMF, dado que poderá algumas vezes mudar de acordo com a distribuição que você usa!). Torne a pasta globalmente legível se não estiver já assim, bem como o executável das subpastas, com o comando chmod. Terá de efectuar todas estas acções como 'root', por isso tenha cuidado. + + Quando tiver terminado, lance o comando texhash para que o &tex; reveja os seus ficheiros e, assim se espere, descubra o pacote novo. Beja a documentação do pacote para mais detalhes embora, de uma forma geral, pouco mais necessite do que configurar o seguinte no seu preâmbulo: + \usepackage{ucs} + \usepackage[utf8x]{inputenc} + + + + + + Suporte de &cjk; + + A adição do suporte para línguas ideográficas tem bastantes truques. Contudo, logo que tenha conseguido, irá funcionar bastante bem. Para além da instalação dos pacotes, é necessária alguma configuração extra. + + A sua distribuição de Linux poderá já ter um pacote &cjk; (Chinês, Japonês, Coreano) pronto para si, como tal poderá poupar o trabalho de instalar manualmente tudo. Verifique tudo antes de seguir em diante! + + Existe a possibilidade de usar o pacote &ucs; para escrever alguns excertos de texto do &cjk;, mas essa opção é seriamente limitada, dado que não lida, entre outras coisas, com mudanças de linha. Será instalado em alternativa o pacote completo do &cjk;-&latex; e será posto a funcionar tanto para o &latex; como para o PDF&latex;. Bastante material deste é inspirado pela página de Pai H. Chou sobre como configurar o PDF&latex;. + + + + Obtenha o pacote do &cjk;. Copie os seus ficheiros descomprimidos para uma subpasta apropriada do $TEXMF, tal como fez com o pacote &ucs; anterior (veja em ). Os ficheiros serão extraídos para uma pasta CJK/X_Y.Z; não é importante que os retire, ainda que sejam mais difíceis de manter. + + Agora, terá de obter um tipo de letra que suporte todos os caracteres do &cjk; que necessita. Poderá escolher qualquer ficheiro *.ttf que os cubra mas, neste caso, será usado o Cyberbit. Descomprima o ficheiro e mude o nome de Cyberbit.ttf para cyberbit.ttf, dado que as maiúsculas poderão confundir o seu sistema. + Coloque o cyberbit.ttf numa pasta em conjunto com o Unicode.sfd e gere os ficheiros *.tfm e *.enc com o comando $ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@. Por algumas razões, isto às vezes poderá não produzir as centenas de ficheiros que deveria produzir. Se for esse o caso, poderá obter tanto os ficheiros *.tfm como os *.enc. + Coloque os ficheiros *.tfm numa pasta apropriada, como por exemplo $TEXMF/fonts/tfm/bitstream/cyberbit/; os ficheiros *.enc poderão estar instalados na pasta $TEXMF/pdftex/enc/cyberbit/. + + Agora, é necessário um ficheiro de mapa para ligar os ficheiros *.enc ao tipo de letra. Obtenha o cyberbit.map e instale-o em $TEXMF/pdftex/config/. + + Obtenha outro ficheiro, o c70cyberbit.fd e coloque-o numa pasta apropriada. Poderá escolher, por exemplo, o $TEXMF/tex/misc/. + + O último ficheiro que terá de ser gerado é um tipo de letra PostScript Type 1, que é necessário para ler os ficheiros DVI gerados com o &latex;. Execute o comando $ ttf2pfb cyberbit.ttf -o cyberbit.pfb e copie o ficheiro resultante cyberbit.pfb numa pasta como a $TEXMF/fonts/type1/cyberbit/. + + Coloque-se então o cyberbit.ttf entre os tipos de letra, onde o &latex; o possa encontrar. Poderá colocá-lo numa pasta chamada $TEXMF/fonts/truetype/. + + Verifique o ficheiro de configuração que encontra em $TEXMF/web2c/texmf.cnf e certifique-se que a linha que menciona o TTFONTS está sem comentários e aponta para a pasta onde gravou o cyberbit.ttf. + + Para possibilitar ao PDF&latex; usar os seus tipos de letra do &cjk;, é necessário que adicione uma linha ao ficheiro de configuração $TEXMF/pdftex/config/pdftex.cfg. Adicione o texto map +cyberbit.map no ficheiro para completar a configuração no PDF&latex;. + + Para configurar o &latex; de modo a que possa produzir ficheiros DVI com caracteres do &cjk;, terá de adicionar uma linha ao ficheiro ttfonts.map. O ficheiro poderá estar numa pasta chamada $TEXMF/ttf2pk/, mas poderá ter de procurar por ela. Adicione a linha cyberbit@Unicode@ cyberbit.ttf a ele. + + Agora, só terá de correr o texhash para que o sistema fique pronto. + + + + Para testar se a sua configuração ficou correcta, poderá tentar compilar este ficheiro de teste. + + + Resolução de Problemas com &cjk; + + Existem várias coisas que poderão correr mal ao configurar o suporte para o &cjk; manualmente. Se algo parecer não funcionar, a seguinte lista podê-lo-á ajudar. + + + + Obviamente, dado que executa o &latex; como um utilizador normal e não como 'root', deverá permitir aos utilizadores normais acederem aos ficheiros novos. Certifique-se que todas as pastas e ficheiros estão acessíveis com o comando chmod. + + Se o &latex; escrever um DVI sem problemas, mas não o conseguir ver, é quase de certeza devido a alguns problemas na geração automática dos ficheiros de tipos de letra *.pk. Supostamente, estes são gerados na altura ao ver um ficheiro DVI, mas isto poderá correr mal por um conjunto de razões: verifique bem o ttfonts.map à procura da sua linha personalizada, em primeiro lugar. Contudo, poderá acontecer que o seu comando ttf2pk, que é invocado normalmente pelo visualizador de DVIs, tenha sido compilado sem o suporte para as bibliotecas do kpathsea. Se for este o caso, o $ ttf2pk não fará menção alguma ao kpathsea. Como o suporte para estas bibliotecas é necessário, poderá ter de encontrar um novo pacote ou recompilar você mesmo o FreeType 1. + + + + + + + + + Como é que introduzo caracteres do &cjk; em Unicode? + + Existe um conjunto de diferentes motores de introdução de dados, e a escolha poderá também depender das preferências pessoais. O autor usa o Skim, uma versão para o &kde; do motor Scim. Veja na documentação da sua distribuição para aprender como instalar estes programas. A configuração dos mesmos poderá também ser complicada; no caso do Skim, terá de definir uma variável de ambiente XMODIFIERS="@im=SCIM" antes de iniciar o X. + + + + + + + + + + Ajuda + + + + Documentos de Ajuda + + O &latex; é um sistema relativamente complicado, onde as funcionalidades básicas poderão ser expandidas com uma grande variedade de pacotes adicionais. O &kile; oferece diversas ajudas para suportar o utilizador. + + + + + Referência de LaTeX + Um índice alfabético com os comandos mais comuns do &latex;. + + + + Documentação TeTeX + O &tetex; vem com uma quantidade enorme de documentos. Isto inclui a documentação da distribuição do &tetex;, os documentos de todos os pacotes incluídos e uma referência adicional do &latex;. O menu de ajuda do &kile; divide esta documentação. + + + + Guia do TeTeX + Esta página é uma tentativa de uma visita guiada por toda a quantidade enorme de documentação do &tex; e do &latex; que vem como parte do &tetex;, o sistema Unix do &tex; e do &latex;, reunido por Thomas Esser. + + + + Documentação do TeTeX + A documentação da maioria dos pacotes que vêm com o &tetex;. + + + + LaTeX + Uma referência completa para o &tex; e os seus amigos. Isto é não só uma descrição de todos os programas, sendo que alguns pacotes importantes são também mencionados. Inclui também um manual de referência completo dos comandos do &latex; - o que é ideal para procurar por uma determinada peça de formatação, ao escrever um documento. Dado que este documento é realmente extenso, o &kile; dividiu-o em três blocos importantes. + + + + Comando LaTeX + Outro índice alfabético dos comandos mais comuns do &latex;. + + + + Assunto LaTeX + Uma descrição de assuntos importantes do &latex;. + + + + Env LaTeX + Um índice alfabético dos ambientes de &latex; mais comuns. + + + + + + + + + Ajuda de Contexto + + O &kile; suporta também uma ajuda dependente do contexto, a qual é invocada com o comando &Ctrl;&Alt;HK. Em ConfiguraçãoConfigurar o Kile...KileAjuda, poderá escolher se deseja usar a referência de &latex; do &kile; ou o sistema de ajuda do &tetex;, o qual é também a configuração predefinida. + + + Pontos + + + + + + Pontos + + + + + + + + + Procurar por Palavras-Chave + + Nem sempre é fácil procurar o documento correcto, dado que o &tetex; vem com uma quantidade enorme de documentos. Como ajuda possível, o &tetex; oferece um programa minúsculo chamado texdoctk. Ele vem com uma base de dados com todos os documentos, o qual é também avaliado pelo &kile;, oferecendo também uma janela para esta base de dados. + + + Pontos + + + + + + Pontos + + + + + Todos os documentos são agrupados em algumas categorias e a principal vantagem é que você poderá procurar pelos nomes dos pacotes e por palavras-chave. O &kile; irá então mostrar apenas os resultados. + + + Pontos + + + + + + Pontos + + + + + Se fizer duplo-click com o rato ou carregar na tecla Espaço, irá iniciar o visualizador para este documento. Poderá ser um documento qualquer, não apenas um documento DVI, PS, PDF ou HTML. O &kile; irá usar a configuração do &konqueror; para iniciar um visualizador apropriado. + + + + + + + Ajuda Definida pelo Utilizador + + Para além desta documentação estática do &tetex;, o &kile; suporta também outra forma variável para a documentação de ajuda ao utilizador. No menu Ajuda, o &kile; suporta um submenu especial Ajuda do utilizador, onde o utilizador poderá adicionar documentos à sua escolha. Estes poderão ser os documentos mais importantes da documentação do &tetex;, como também poderão ser documentos escritos pelo próprio. É também possível escolher alguns URLs da Web. + + Vá a ConfiguraçãoConfigurar o Kile...KileAjuda e escolha o botão Configurar para modificar este menu Ajuda do utilizador. Poderá adicionar, remover ou navegar pelos itens do menu, assim como inserir separadores para obter uma estrutura melhor. + + Se carregar no botão Adicionar, irá obter outra janela, onde deverá editar o nome do item do menu e escolherá o ficheiro ou &url; Web correspondente. Se escolher um &url; da Web, o konqueror será iniciado e você deverá escolher o &url; final. + + + Pontos + + + + + + Pontos + + + + + + + + + + + Créditos e Licença + + O &kile; é um editor de código de &latex; / &tex; aberto e amigável. Ele irá correr nos sistemas que tenham o Ambiente de Trabalho &kde;. O &kde; está disponível para várias arquitecturas com o Linux e outros sistemas do tipo do Unix instalados. O &kile; faz também parte do projecto Fink, o que significa que poderá executar o &kile; num Mac com o OS-X. + + Devem-se muitos agradecimentos a todos os que se esforçam por prosseguir com o projecto do &kile; e às várias horas de contribuições feitas por aqueles que sacrificam o seu tempo a desenvolver ferramentas que todos poderão usar segundo a licença da GNU. Aqui está um lista breve dos programadores, editores, tradutores, escritores, depuradores, criadores de pacotes, programadores Web e utilizadores que tornaram este projecto possível. + + Programa copyright 2003 e mantido actualmente por Jeroen Wijnhout Jeroen.Wijnhout@kdemail.net + + Programa copyright 2002-2003 Pascal Brachet + + Documentação Copyright © 2003 Jonathan Pechta, 2003-2005 Federico Zenith (ajustes finais) + + Contribuições de: Rob Lensen, Roland Schulz, Michael Margraf, Holger Danielsson + + Muito obrigado a todos os envolvidos! +&underFDL; &underGPL; + + +&documentation.index; + + diff --git a/doc/sv/Makefile.am b/doc/sv/Makefile.am new file mode 100644 index 0000000..4207ed7 --- /dev/null +++ b/doc/sv/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = sv +KDE_DOCS=kile diff --git a/doc/sv/bullets.png b/doc/sv/bullets.png new file mode 100644 index 0000000..ade6d93 Binary files /dev/null and b/doc/sv/bullets.png differ diff --git a/doc/sv/config-complete.png b/doc/sv/config-complete.png new file mode 100644 index 0000000..91275b0 Binary files /dev/null and b/doc/sv/config-complete.png differ diff --git a/doc/sv/config-dblquotes.png b/doc/sv/config-dblquotes.png new file mode 100644 index 0000000..e78bb99 Binary files /dev/null and b/doc/sv/config-dblquotes.png differ diff --git a/doc/sv/config-encoding.png b/doc/sv/config-encoding.png new file mode 100644 index 0000000..1bca73f Binary files /dev/null and b/doc/sv/config-encoding.png differ diff --git a/doc/sv/config-quickpreview.png b/doc/sv/config-quickpreview.png new file mode 100644 index 0000000..257dc7f Binary files /dev/null and b/doc/sv/config-quickpreview.png differ diff --git a/doc/sv/config-userhelp.png b/doc/sv/config-userhelp.png new file mode 100644 index 0000000..499bfea Binary files /dev/null and b/doc/sv/config-userhelp.png differ diff --git a/doc/sv/delete.png b/doc/sv/delete.png new file mode 100644 index 0000000..7010bfb Binary files /dev/null and b/doc/sv/delete.png differ diff --git a/doc/sv/dialog-addhelp.png b/doc/sv/dialog-addhelp.png new file mode 100644 index 0000000..cba10e0 Binary files /dev/null and b/doc/sv/dialog-addhelp.png differ diff --git a/doc/sv/dialog-docbrowser1.png b/doc/sv/dialog-docbrowser1.png new file mode 100644 index 0000000..e47702f Binary files /dev/null and b/doc/sv/dialog-docbrowser1.png differ diff --git a/doc/sv/dialog-docbrowser2.png b/doc/sv/dialog-docbrowser2.png new file mode 100644 index 0000000..1b6eb66 Binary files /dev/null and b/doc/sv/dialog-docbrowser2.png differ diff --git a/doc/sv/dialog-pstools.png b/doc/sv/dialog-pstools.png new file mode 100644 index 0000000..2082e4c Binary files /dev/null and b/doc/sv/dialog-pstools.png differ diff --git a/doc/sv/dialog-tabular.png b/doc/sv/dialog-tabular.png new file mode 100644 index 0000000..c7f9a21 Binary files /dev/null and b/doc/sv/dialog-tabular.png differ diff --git a/doc/sv/environment.png b/doc/sv/environment.png new file mode 100644 index 0000000..563b717 Binary files /dev/null and b/doc/sv/environment.png differ diff --git a/doc/sv/includegraphics.png b/doc/sv/includegraphics.png new file mode 100644 index 0000000..3d14f71 Binary files /dev/null and b/doc/sv/includegraphics.png differ diff --git a/doc/sv/index.docbook b/doc/sv/index.docbook new file mode 100644 index 0000000..fdf60b3 --- /dev/null +++ b/doc/sv/index.docbook @@ -0,0 +1,6041 @@ + +Kile"> + ATEX"> + ATEX"> + EX"> + teTEX"> + TeX Live"> + EX"> + + EX"> + + + ImageMagick"> + KDE"> + KDVI"> + dvipng"> + KGhostView"> + KPDF"> + PostScript"> + makeidx"> + Kate"> + CJK"> + ucs"> + URL"> + + + + +]> + + + + +Handbok &kile; + + + JonathanPechta + FedericoZenith
zenith@chemeng.ntnu.no
 + HolgerDanielsson
holger.danielsson@versanet.de
 + ThomasBraun + MichelLudwig
michel.ludwig@kdemail.net
 + + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + +2003 +Jonathan Pechta + + + +200320052006 +Federico Zenith + + + +20052006 +Holger Danielsson + + + +2007 +Thomas Braun + + + +2007 +Michel Ludwig + + +November 19, 2007 +2.0 + + +&FDLNotice; + + + +&kile; är en &tex;- och &latex;-källkodseditor och skal. + + + +KDE +kdenonbeta +Kile +Latex +Tex + + + + + + +Förord + + + + Krav + + För att köra &kile;, krävs att du har följande komponenter installerade på din dator: + + + K-skrivbordsmiljön (&kde;): &kde; är en populär skrivbordsmiljö med öppen källkod. + Qt: Qt är ett C++ grafiskt gränssnitt och nätverksbibliotek som behövs för att kompilera &kile;. + &latex;: Typsättningsprogram för dokument med hög kvalitet. Troligen ska du använda paketet &texlive; (eller &tetex; på äldre system), om du har ett Unix-liknande system. + + + De flesta av dessa paket kan ingå i din Linux-distribution, kontrollera distributionens dokumentation eller installations-cd eller dvd för att lägga till paketen i datorn. + + &kile;-projektet omfattar flera binärpaket med &kile; för olika distributioner som enkelt kan installeras och köras, utan att behöva kompilera. Titta på &kile;s hemsida. + + + + + + Tilltänkt publik + + Den här handboken är avsedd för vem som helst, oavsett vilken erfarenhet de har av &latex;, &kde;, &kile; eller Linux. + + Avancerade användare läser troligen inte handboken, men alla förslag om dokumentationen tas hänsyn till. Om du skulle vilja bidra till projektet eller dokumentationen, konsultera &kile;s webbsida. + + Behöver du svar på frågor om &kile;? Har du fastnat vid kompilering? Vill du se en ny funktion? Sättet som föredras för att fråga tekniska frågor eller börja en diskussion, är att använda vår e-postlista: kile-devel@lists.sourceforge.net. + + + + + + + + Inledning + + + + Grundläggande fakta + + + + Om &kile; + + &kile; är en integrerad &latex;-miljö för &kde;-skrivbordet. &kile; ger dig möjlighet att utnyttja alla funktioner som finns i &latex; i ett grafiskt gränssnitt, vilket ger dig en enkel, omedelbar och anpassningsbar möjlighet att komma åt alla program för att kodkomplettera, kompilera, efterbehandla, felsöka, konvertera och visa &latex;. Du får också mycket bekväma guider, en referensmanual till &latex;, och kraftfull projekthantering. + + + + + + Vad är &latex; + + &latex; är ett textbehandlingssystem som är härlett från &tex;, ett program som ursprungligen utvecklades under 1977 av Donald Knuth, för att hjälpa honom skapa en professionell layout av hans arbete, och uppnå ett resultat som liknar det som en sättare kan åstadkomma. Sättaren är yrkesmannen som formger dokumentet enligt dokumenttypens specifikation. &latex; skapades av Leslie Lamport för att ge författare automatisk sättning, särskilt när det gäller den dyra och mödosamma sättningen av matematiska formler och uttryck, som inte av en slump omges av dollartecken i &latex;. Idag låter ordbehandlingsprogram alla användare vara sättare, men vad man ofta vill ha är ett dokument som ser bra ut, inte ett som man måste spendera timmar på för att det ska se bra ut. &latex; tar hand om den bördan, och låter dig tänka på dokumentet, inte layouten. Och ja, resultatet ser bra ut! + + + + + + Hur uttalas det? Varför det konstiga sättet att skriva det på? + + Det finns en rolig tradition att paket som hör ihop med &tex; ska ha konstigast möjliga uttal och skrivsätt. &tex; antas ha hämtats från det grekiska τεχ, med latinska bokstäver tech. Det finns många förklaringar, men den troligaste är att &latex; ursprungligen var tänkt för tekniska rapporter, och dess främsta förmåga var riktig och enkel sättning av matematiska formler, vilket på den tiden var en extremt dyr, tidsödande och frustrerande uppgift. + Uttalet ska vara som följer: T som väntat, E som vokalen i lätt, och X som i tyska ch. Om du inte vet hur ch låter, är det mer eller mindre som en fräsande katt. I det fonetiska alfabetet är symbolen /ç/. Många rapporterar det annorlunda uttalet ach (fonetiska symbolen /x/), men jag har personligen frågat några greker, och kan bekräfta den första versionen. Du bör vara medveten om att många använder det felaktiga uttalet /teks/ eller /tek/. + Till sist, i &latex; uttalas det första LA som lej: idén är att även om ren &tex; är svår, kan till och med en nybörjare (på engelska layman) använda &latex;-makron. En mindre inspirerande, men mer realistisk förklaring är att det har sitt ursprung i &latex; skapares efternamn, Leslie Lamport. Så nu vet du! + + + + + + + + Grundkurs i &latex; + + &latex; typsättningssystem liknar andra taggspråk som XML, som används för många dokumenttyper (inklusive det du läser nu), eller HTML, som används för webbsidor. Den övergripande idén är att ha särskilda omgivande nyckelord, som kallas taggar, som talar om för ett program (en ordbehandlare, en webbläsare, eller &latex;-kompilatorn) hur texten ska presenteras. &kile; erbjuder ett avsevärt antal sådana taggar i menyn Latex på menyraden. + + Även om vi försöker ge dig en god idé om vad &latex; är, kan detta inte vara den definitiva guiden till &latex;. Om du vill lära dig &latex; väl, kanske du kan låna en bok på biblioteket. Författaren har bra erfarenhet av "A Guide to &latex;" av H.Kopka och P. W. Daly, och har den fortfarande i bokhyllan. + + Som andra taggspråk har &latex; en inledning som ställer in globala kommandon, som pappersstorlek, sidnumrering, textens dimensioner på sidan, och en huvuddel, som innehåller dokumentets text. Inledningen innehåller åtminstone kommandot \documentclass, och föregår huvuddelen, som börjar med kommandot \begin{document}, och som väntat avslutas med kommandot \end{document}. + + + + + + &kile;s huvudfunktioner + + + + Snabbstartsguide + + Snabbstartsguiden som är inbyggd i &kile; är en användbar funktion för att snabbt börja skapa dokument i &kile;. Genom att välja guiden i menyraden, får du flera olika val för att skapa ett dokument. Du kan också direkt ställa in vissa alternativ som hör ihop med dokumentet. + + Klassalternativ: + + + Dokumentklass: Välj typ av dokument du vill skapa: artikel, bok, brev, rapport, scrartcl, scrreprt, scrbook, prosper, beamer eller annat egendefinierat. + Typsnittsstorlek: Tala om för &kile; vilken punktstorlek (pt) du vill använda. + Pappersstorlek: Välj storlek eller typ av papper. + Kodning: I allmänhet är det en god idé att använda systemets standardkodning. Moderna system går mer och mer över till UTF-8 som standardkodning. Om du kan, använd utf8x (som verkligen är rätt stavning för &latex;-dokument). + Övriga alternativ: Det här låter dig ställa in ytterligare alternativ såsom utskrift, utkast med mera. + + + Paket + Här listas några av de vanligaste ytterligare paket som används i &latex;. Markera kryssrutan för att inkludera det. + + Dokumentegenskaper + + Författare: Skriv in ditt namn här. + Titel: Lägg till dokumentets titel här. + Datum: Ange datum. + + + + + + + Fördefinierade mallar + + De fördefinierade mallarna i &kile; är: + + + Empty document: Riktiga fantaster börjar från början! + Article: Ställer in format för en artikel, ett dokument kort nog att inte behöva uppdelas i kapitel. + Report : Ställer in format för en rapport, ett dokument av mellanstorlek, med till exempel sidnumrering vid sidans ytterkant. + Book: Ställer in bokformatet, en fullständig variant, så kraftfull att den används för att skriva många universitetsläroböcker. + Letter: Ställer in formatet för ett brev, som automatiskt kan göra de otrevliga indenteringarna som ingen egentligen kommer ihåg. + Beamer, HA-Prosper: Skapa trevliga presentationer i PDF med ett överlägset utseende och hela &latex; kapacitet. + Scrartcl,Scrbook,Scrreprt,Scrlttr2: KOMA-skript dokumentklasser, särskilt anpassade för tysk typografi. Använd dem när du skriver text på tyska. + + + Nya användare behöver inte oroa sig, den här listan är bara en kortfattad beskrivning av funktioner och mer uppmärksamhet kommer att ägnas åt att göra färdigt uppgifterna i detalj senare, i avsnittet . + + + + + + Syntaxfärgläggning + + &kile; liknar program som hanterar källkod och redigering, och färglägger automatiskt kommandon, alternativ och objekt som används (eller missbrukas). På så sätt gör &kile; det möjligt att enkelt upptäcka problemområden. Om du till exempel ser att stora delar av texten blir grön, är det troligt att du glömt avsluta en matematisk omgivning någonstans. Du skulle ha märkt det ändå, genom att resultatet skulle ha sett förfärligt ut, men färgläggning sparar verkligen tid och bekymmer. + + + + + + Automatisk komplettering av omgivningar + + Automatisk komplettering av omgivningar betyder att när du påbörjar en ny omgivning genom att till exempel skriva \begin{omgivning}, lägger &kile; automatiskt till kommandot \end{omgivning}, med en rad för din text innan. Du kan förstås inaktivera funktionen om du vill från Inställningar Anpassa Kile... LatexOmgivningar. + + + + + + Gå till strukturelement + + Alla dokument är normalt strukturerade i en hierarki av någon typ. &latex; låter dig dela upp dokument i följande hierarki (part är längst upp i hierarkin och subparagraph längst ner): + + + \part + \chapter + \section + \subsection + \subsubsection + \paragraph + \subparagraph + + + När ett dokument betraktas i strukturvyn, kan du flytta dig mellan element genom att klicka på elementet som du vill se. + + + + + + Omvänd sökning + + När du skapar dina egna &latex;-filer, kan omvänd sökning vara till stor hjälp. När du väl har skapat en DVI-fil (DeVice Independent-fil), kan du klicka med musens mittenknapp i DVI-visaren, och då går &kile; till motsvarande rad i &latex;-källkoden. + + En DVI är en sorts fil som innehåller en beskrivning av ett formaterat dokument, tillsammans med annan information, inklusive typsnitt för tecken, och är förutom PDF den vanligaste utdatan från &tex; eller &latex;. Ett antal verktyg finns för att visa, konvertera och skriva ut DVI-filer på olika system och enheter. + + + + + + Sökning framåt + + När omvänd sökning används, associeras val av objekt i DVI-filen med editorn, så att när du klickar i en DVI-fil, går huvudfönstret till motsvarande plats i editorns &latex;-kod. Sökning framåt är den exakta motsatsen till detta. Sökning framåt låter dig klicka på en särskild del av texten i &latex;-koden, och gå till motsvarande plats i DVI-visarens fönster. + + + + + + + + Verktygsraden + + + Ny: Påbörja ett nytt dokument. + Öppna: Öppna ett nytt dokument. + Stäng: Stäng dokumentet. + Definiera aktuellt dokument som 'Huvuddokument': Det här används när du arbetar med flera filer. Genom att ha ett huvuddokument, kan du enklare arbeta med andra .tex-filer som ingår i dokumentet. Om du använder projekt kan du också ställa in ett huvuddokument för hela projektet med Projekt Projektalternativ. + Snabbygg: Kompilerar all &latex;-källkod och visar automatiskt resultaten, om du inte har fel i koden. + Filbevakningsläge: Det här läget "bevakar" DVI-filen om den ändras, och startar inte en ny &kdvi;-session efter Snabbygg. + Visa loggfil: Visar .log-filen, så att du kan upptäcka fel. + Föregående fel: Går bakåt genom .log-filen och markerar fel i källkoden. + Nästa fel: Går framåt genom .log-filen och markerar fel i källkoden. + Stoppa: Stoppar aktuellt verktyg. + Latex: Kör &latex; för det aktiva dokumentet. + Visa DVI: Startar DVI-visaren. + DVI till PS: Konverterar DVI till &postscript; (PS). + Visa PS: Startar &postscript;-visaren (PS). + PDFLatex: Kör &pdflatex; för det aktiva dokumentet. + Visa PDF: Startar PDF-visaren. + DVI till PDF: Konverterar en DVI till en PDF. + PS till PDF: Konverterar PS till PDF. + Visa HTML: Visar HTML som skapats. + Kdvi framåtsökning: Gå till sidan som motsvarar nuvarande rad i editorn. + + + Om du tittar på redigeringsverktygsraden, ser du tre stora kombinationsrutor. De är konstruerade för att användaren snabbt ska kunna lägga till vissa vanliga funktioner i dokumentet. Den första kombinationsrutan används för att snabbt dela upp dokumentet i delar, kapitel, avsnitt och så vidare. Tillgängliga kommandon för att lägga till delar i &latex;-källkoden är: + + + Part: Högsta sektionsnivån i ett dokument. + Chapter: Inleder ett nytt kapitel. + section: Skapar en ny sektion. + Subsection: Skapar en ny delsektion. + Subsubsection: Ett sekundärt avsnitt som ligger mellan avsnitt och stycke. + paragraph: Skapar ett nytt stycke. + subparagraph: Skapar ett nytt delstycke. + + + Kombinationsrutan som heter label, används för att infoga objekt i dokumentet, såsom index, fotnoter och referenser. De tillgängliga kommandona är: + + + label: Ett kommando som skapar en rubrik för ett kapitel, figur eller ett annat element. + index: Skapar en post i indexet. + footnote: Skapar en fotnot i dokumentet. + ref: Används för att hänvisa till en fördefinierad rubrik, som du kan välja i en kombinationsruta. + pageref: Precis som ref, men hänvisar till en sida istället för ett strukturelement. + cite: Skapar en referens med data från en bibliografi. + cite från ViewBib: be ViewBib-verktyget om alla markerade referenser och infoga dem. För närvarande är det bara tillgängligt med &kbib; som ViewBib-verktyg. + + + + Kombinationsrutan Label + + + + + + Kombinationsrutan Label + + Kombinationsrutan Label + + + + + Välja etikett för en referens + + + + + + Välja etikett för en referens + + Välja etikett för en referens + + + + När cite används visas en kombinationsruta med bibliografiposter, men om du använder &bibtex; fungerar det bara om filen hör till ett projekt. Vid redigering av &bibtex;-filer rekommenderas användning av en specialiserad editor. Författaren har goda erfarenheter av &kbibtex; och &kbib;. Du kan förstås också skriva &bibtex;-filen för hand inne i &kile;. + + Den sista kombinationsrutan som heter tiny, används för att ställa in textens storlek. Du har möjlighet att ange huvudtextens storlek, fotnoters storlek och så vidare. Tillgängliga kommandon är: + + + tiny: minst. + scriptsize: mycket litet. + footnotesize: mindre. + small: litet. + normalsize: normalt. + large: stort. + Large: större. + LARGE: ännu större. + huge: större än stor. + Huge: störst. + + + + + + + + Komma igång + + + + Skriva ett &latex;-dokument med &kile; för nybörjare + + Användare av &kile; har två möjligheter när de påbörjar ett nytt dokument. De kan använda guiden för att påbörja dokumentet, välja vilken dokumenttyp de vill skapa, och alternativ som teckenstorlek, pappersstorlek och så vidare. Annars kan de skriva in koden för hand. + + + \documentclass[12pt]{article} + \begin{document} + Här är en massa text kodad med \LaTeX. + \end{document} + + Alla dokument i &latex; börjar med kommandot \documentclass[optional argument]{klass}, där klass anger dokumenttypen. + + Genom att skriva in kodexemplet ovan från textrutan får du följande utmatning: + + + Kompilerad text i DVI-utdata + + + + + + Kompilerad text i DVI-utdata + + Kompilerad text i DVI-utdata + + + + Hakparenteserna som följer kommandot \documentclass innehåller alternativen för kommandot. Alternativet [12pt] ställer in teckenstorleken för artikeln. Om du inte ställer in teckenstorleken i början, kan du ställa in den senare i texten. + + När du väl har skrivit in kodexemplet i rutan ovan, måste du kompilera &latex;-källkoden. Det enklaste sättet du kan kompilera &latex; är att använda menyn Bygg eller knappen Snabbygg. + + &Alt;2 är snabbtangenten för att kompilera din källkod. + + Du måste spara källkoden innan du kan kompilera, &kile; gör det automatiskt åt dig. + + Om dokumentet inte kompilerades, kontrollera loggen efter fel. När tangenten Snabbygg används, ska &kdvi;-visaren startas automatiskt. Om den inte gör det, titta på loggen. + + + + + Omgivningar + + En omgivning är ett textstycke som hanteras annorlunda jämfört med resten av dokumentet. Du skapar till exempel en rapport med teckenstorleken 12 punkter, men du behöver ändra teckenstorleken för några få meningar. Kommandona \begin{omgivning}, \huge och \end{omgivning}, låter dig tillfälligt ändra texten mellan omgivningskommandona så att den blir större än stor. + + Ändringar gäller bara från \begin{omgivning} till \end{omgivning}. Det finns inga begränsningar för hur många ändringar du kan göra inne i en omgivning. + + Det finns många funktioner du kan lägga till i dokumentet för att göra det mer läsbart och användarvänligt. Du kan lägga till funktioner som speciella teckensnitt, fetstil, kursivstil, understrykning, etc. i dokumentet, och kommandona avslutas antingen med \end eller med slutet på omgivningen. + + + \begin{emph}: Det här kommandot gör texten kursiv, och gäller till koden kommer fram till ett \end{emph} eller en annan omgivning. För att kursivera ett ord i en mening, kan man använda syntaxen: Det här är \emph{min} mening. + \textbf{Jag gör texten mellan parenteserna till fetstil}: Kommandot gör texten till fetstil. + \qoute: För att skapa ett citat i dokumentet, inled det med \begin{quote} och avsluta det med \end{quote}. + \center: Centrerar texten. + \verse: Skapar indragen text för en vers. + \itemize: Skapar en punktlista. + + + + + + + Att använda &kile; + + Nu när vi har givit dig en viss bakgrund om hur man skriver kod med &latex; taggspråk, visar vi hur ett dokument skapas steg för steg med användning av &kile;. + + + Starta &kile;. + Välj GuideSnabbstart, och välj därefter ett format och ställ in vad du önskar i guiden. + När guiden väl har lagt till text, gör några anpassningar för att få dokumentet mer läsbart. Lägg till minst ett citat, lite text med fetstil,kursivstil och en vers för att se skillnaden mellan kommandona. + Spara filen och ge den namnet intro.tex. + Bygg dokumentet med &Alt;2 eller knappen som heter Latex. + Välj Visa DVI. + Kontrollera all din nya text. + När du är klar med att titta på dokumentet, klicka på knappen Visa editor eller tryck på &Ctrl;e för att återgå till editorn om du använder den inbyggda visningen, eller stäng visningsfönstret om du använder separat visning. + + + Det är allt! Du har just skapat ditt första &latex;-dokument. + + När du väl har skapat DVI-filen, kan du skriva ut dokumentet eller konvertera det till &postscript; eller en PDF-fil om du vill. Roa dig med att experimentera! + + + + + + DVI-filer + + DVI betyder DeVice Independent (enhetsoberoende). Filerna skapas av &tex; eller &latex; för att läsas av en drivrutin av någon typ på datorn. Det finns många typer av utmatning som kan användas med .dvi, som en skrivare, PDF, &postscript; eller datorns skärm. + + + + Visa en DVI-fil + + Du har redan sett hur man visar en DVI-fil på skärmen genom att använda knappen Visa DVI i verktygsraden. + + + + + + Skriva ut en DVI-fil + + För att skriva ut en DVI-fil, kan du använda samma process som du tidigare använde för att skapa dokumentet (se ). Vid steg 7, istället för att klicka på Visa DVI, välj Arkiv Skriv ut i visaren, och om skrivaren är riktigt inställd, kommer du att kunna skriva ut DVI-filen. + + + + + + Konvertera DVI-filer + + Verktygsraden ger möjlighet att konvertera en DVI-fil till andra format. När du väl har skapat en DVI-fil från din &latex;-källkod, kan du exportera den till formatet du vill ha med knapparna i verktygsraden. + + + + + + + + Sökning framåt mellan &kile; och &kdvi; + + Funktionen för sökning framåt låter dig direkt gå från editorn till motsvarande position i &DVI;-filen. + &kile; erbjuder en inställning för det här alternativet med alla &latex; binärfiler. Gå till Inställningar Anpassa Kile...VerktygBygg och välj alltid Modern inställning. + + För att utföra en sökning framåt, placera markören på en rad i källkoden och klicka på KDVI sökning framåt för att hoppa till motsvarande position i DVI-visarens fönster. + + + + + Omvänd sökning mellan &kile; och &kdvi; + + Omvänd sökning är en mycket användbar funktion när du skriver ett &latex;-dokument själv. Om allt är riktigt inställt, kan du klicka på &kdvi;s fönster med musens mittenknapp (på vissa system som inte har en mus med tre knappar, kan du använda vänster och höger musknapp samtidigt). Därefter laddar &kile; &latex;-källkodsfilen och går till rätt stycke. För att använda omvänd sökning, måste du kompilera din &latex;-fil med inställningen Modern. + + Omvänd sökning kan inte fungera om inte: + + + Källkodsfilen har kompilerats med lyckat resultat. + &kdvi; vet vilken editor du vill använda. + + + Med den här funktionen i &kdvi;, gör ett klick på musens mittenknapp i DVI-dokumentet att &kile; öppnar motsvarande &latex;-dokument och försöker gå till motsvarande rad. Kom ihåg att tala om för &kdvi; att &kile; ska användas som texteditor med &kdvi;s menyalternativ Inställningar DVI-alternativ.... + + + Anpassa &kdvi; + + + + + + Anpassa &kdvi; + + Anpassa &kdvi; + + + + + + + Lösa upp fel + + Om du försöker använda snabbygg, men DVI-visaren inte öppnas, är det stor chans att du har ett fel. Om du har ett fel, syns det i loggfilen eller meddelandefönstret, och en summering av felet ges. + + Loggfilen förklarar orsaken till felet i din kod. I editorn kan du använda knapparna i verktygsraden som heter Föregående Latexfel och Nästa Latexfel för att gå mellan olika fel. Loggfilen anger alltid på vilken rad som felet uppstod. För att se raden där ett fel uppstod, klicka på felet i loggfönstret så går &kile; till raden som motsvarar felet. + + + + + + + Påbörja ett nytt dokument + + När du klickar på knapparna i verktygsraden för att påbörja ett nytt dokument, visas en dialogruta som frågar om vilken sorts mall du vill använda för att skriva dokumentet. Standardvalen är: + + + Tomt dokument + Artikel + Beamer + Bok + HA-Prosper + Brev + Rapport + Scrartcl (från KOMA-skriptpaketet) + Scrbook (från KOMA-skriptpaketet) + Scrlttr2 (från KOMA-skriptpaketet) + Scrreprt (från KOMA-skriptpaketet) + + + Om du väljer Tomt dokument, kan du antingen börja skriva dokumentet från början, eller använda guiden för att snabbt påbörja ett nytt dokument (se ). + + + + + Mallar + + De som ofta använder &latex; har typiskt samma inledning för nästan alla dokument de skapar. Mallar kan skapas, sparas och laddas inne i &kile; för att göra det enklare att påbörja ett nytt dokument. + + + + Skapa en ny mall + + För att skapa en ny mall, måste du först antingen öppna en &tex;- eller &latex;-fil, eller påbörja en egen fil. &kile; kan skapa en mall från ett befintligt dokument genom att öppna önskat dokument och välja Arkiv Skapa mall från dokument. + + + + + + Anpassa automatiska ersättningar + + När ett nytt dokument skapas genom att välja en mall med Arkiv Ny, ersätts vissa teckenkombinationer med data som ditt namn eller teckenkodningen du använder. Dessa variabler kan ställas in under Inställningar Anpassa Kile... Allmänt. + + När du skapar dina egna mallar är det användbart att veta vilka teckenkombinationer som ersätts med vilka mallvariabler: + + + $$AUTHOR$$: Den här strängen ersätts med variabeln författare. + $$DOCUMENTCLASSOPTIONS$$: Den här strängen ersätts med variabeln dokumentklassalternativ. Typiskt används detta enligt följande: \documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}. + $$INPUTENCODING$$: Om variabeln inmatningskodning är inställd till, låt oss säga latin1, ersätts strängen av \input[latin1]{inputenc}. + + + + + + + Skapa en mall från guiden + + Det enklaste sättet att skapa en ny mall är att starta guiden, och därefter lägga till kommandon i editorn. När du väl har fått dokumentet som du vill ha det: + + + Spara filen. + Gå till Arkiv. + Välj Skapa mall från dokument. + Gör alla nödvändiga ändringar i mallen. + Skriv in ett namn på den nya mallen. + Klicka på Ok för att lägga till mallen i menyn. + + + Nästa gång du startar ett nytt dokument, kommer du kunna välja din anpassade mall istället för standardmallarna. + + + + + + Skapa en mall från godtycklig fil + + En mall kan skapas från vilken &latex;-fil som helst. Om du söker efter ett enkelt sätt att anpassa en mall, hämta en fil du tycker om på Internet, och följ samma steg som anges under . + + Du kan till exempel vilja skapa en fullständig A0-affisch. Sådana affischer visas ofta på vetenskapliga konferenser, och &latex; hjälper dig skapa en attraktiv affisch som väcker uppmärksamhet. Du kan hämta en mall för A0-affischer på Jonathan Marchinis hemsida, men många fler är tillgängliga. Kom ihåg att du behöver paketet a0poster, som normalt inte ingår i en vanlig tex-distribution. Ladda ner det härifrån, och placera det i samma katalog som din &latex;-fil. + + + + + Ta bort en mall + + För att ta bort en mall från &kile;, gör följande: + + + Gå till Arkiv Ta bort mall.... + En dialogruta visas där alla mallar listas. Välj en mall. + Klicka på Ok, så tas mallen bort. + + + Mallar markerade med en asterisk (*) kan inte tas bort utan lämpliga rättigheter. + + + + + + + + + Redigera &latex;-dokument + + Den interna editorn som &kile; använder är &kate;. Kate är en texteditor skapad för programmerare, som innehåller möjlighet att läsa och färglägga många olika sorters textfiler, bland annat &latex; och &bibtex;. Du kan komma åt många av &kate;s alternativ direkt från menyn Verktyg i &kile;. + + För att lära dig mer om &kate;, och dess möjligheter, se Kates handbok. Användare av &kile; kan börja läsa i kapitlet Arbeta med Kate-editorn. + + + + &latex;-referens + + &kile; erbjuder en mycket praktisk taggreferens för &latex;, som du kan komma åt genom att välja Hjälp Latex-referens. Den innehåller en omfattande beskrivning av nästan alla kommandon som du kan använda i &latex; och deras syntax. + + + + + + Flytta markören + + För att markera text, har du följande möjligheter: + + + Håll nere vänster musknapp och dra för att markera text. + Klicka en gång på ett ord för att flytta markören till en ny plats. + Klicka två gånger på ett ord för att välja hela ordet. + Klicka två gånger på ett ord och håll nere &Ctrl; för att markera hela Tex-ordet. Det innebär att klicka på detta sätt på \par i \par\bigskip bara markerar \par. + Klicka tre gånger för att välja hela meningen. + + + Genom att hålla nere musknappen och dra över texten du vill välja, kopieras den automatiskt till klippbordet. + + Genom att hålla nere skift-tangenten och använda piltangenterna kan du välja delar av källkoden i editorfönstret. + + + + + + Parenteser + + Komplettering av parenteser är ett visuellt verktyg som editorn använder för att visa dig vilka parenteser som hör ihop. Om du öppnar en fil med filändelsen .tex, och markerar vilken parentestyp som helst, som parenteser (), hakparenteser [] eller klamrar {}, så färgläggs matchande parentestyp i gult (den här standardfärgen kan ändras). Om du till exempel placerar markören på en klammer i \section{Introduktion}, ser du färgläggning av \section{Introduktion} med standardfärgen gult, som visar dig platsen för den inledande och avslutande klammern. + + + + + + Färgläggning + + &kile; har möjlighet att leta efter och färglägga olika sorters kod. &latex;-kommandon skiljs till exempel från normal text, och även matematiska formler färgläggs med en annan färg. + + + + + + Punkter + + Många guider kan infoga valfria punkter, en särskild sorts bokmärke i texten. Menyalternativen RedigeraPunkter eller motsvarande snabbtangenter låter dig gå till nästa eller föregående punkt. Det markerar också punkten så att den automatiskt tas bort när du skriver in den första bokstaven. + + + Punkter + + + + + + Punkter + + + + + + + &Ctrl;&Alt;Högerpil Nästa punkt + Gå till nästa punkt i texten om det finns någon. + + + &Ctrl;&Alt;Vänsterpil Föregående punkt + Gå till föregående punkt i texten om det finns någon. + + + + + + + + + Markera + + Redigering är förstås en av huvudaspekterna när du använder ett program som &kile;. Även om &kate; har stora möjligheter, lägger &kile; till vissa viktiga funktioner, som särskilt behövs för att skriva &latex;-källkod. &latex; behöver alltid en stor mängd omgivningar och grupper, så &kile; stöder mycket speciella kommandon för att markera dem. Under Redigera Markera hittar du följande kommandon för att markera text: + + + Redigera -> Markera objekt + + + + + + Redigera -> Markera objekt + + + + + + &Ctrl;&Alt;S E Omgivning (inne i) + Markera en omgivning utan de omgivande taggarna. + + + &Ctrl;&Alt;S F Omgivning (utanför) + Markera en omgivning inklusive de omgivande taggarna. + + + &Ctrl;&Alt;S T Tex-grupp (inne i) + Markera en Tex-grupp innanför de omgivande klamrarna. + + + &Ctrl;&Alt;S U Tex-grupp (utanför) + Markera en Tex-grupp inklusive de omgivande klamrarna. + + + &Ctrl;&Alt;S M Matematisk grupp + Markera den nuvarande matematiska gruppen inklusive matematikkommandon. + + + &Ctrl;&Alt;S P Stycke + Markera ett helt stycke, dvs. en grupp med textrader åtskilda på båda sidor av tomma rader. Ett stycke betyder inte bara kontinuerliga textrader, som i andra texteditorer. Den utökade betydelsen omfattar också tabeller, &latex;-kommanon och andra källkodsrader. Det enda viktiga för &kile; är att alla sorters stycken är omgivna av två tomma rader. + + + &Ctrl;&Alt;S L Rad + Markera textraden på markörens nuvarande position. + + + &Ctrl;&Alt;S W Tex-ord + Markera ordet under nuvarande markörposition. Markeringen har också en utökad mening, eftersom kommandot också kan markera &latex;-kommandon som börjar med ett bakstreck och dessutom kan ha en valfri asterisk i slutet. + + + + + + + + + Ta bort + + För att ta bort delar av ett dokument kan du förstås markera dem, och därefter använda tangenten Delete. &kate; erbjuder också kommandot &Ctrl;K som tar bort hela raden. Men &kile; erbjuder ett snabbare sätt med sina egna borttagningskommandon. Under RedigeraTa bort hittar du följande kommandon för att ta bort text: + + + Redigera -> Ta bort objekt + + + + + + Redigera -> Ta bort objekt + + + + + + &Ctrl;&Alt;T E Omgivning (inne i) + Ta bort en omgivning utan de omgivande taggarna. + + + &Ctrl;&Alt;T F Omgivning (utanför) + Ta bort en omgivning inklusive de omgivande taggarna. + + + &Ctrl;&Alt;T T Tex-grupp (inne i) + Ta bort en Tex-grupp innanför de omgivande klamrarna. + + + &Ctrl;&Alt;T U Tex-grupp (utanför) + Ta bort en Tex-grupp inklusive de omgivande klamrarna. + + + &Ctrl;&Alt;T M Matematisk grupp + Ta bort den nuvarande matematiska gruppen inklusive matematikkommandon. + + + &Ctrl;&Alt;T P Stycke + Ta bort ett helt stycke. Titta på kommandot MarkeraStycke, för att se hur ett stycke definieras i &kile;. + + + + &Ctrl;&Alt;T I Till radslut + Ta bort texten från markörens nuvarande position till radens slut. + + + &Ctrl;&Alt;T W Tex-ord + Ta bort ordet eller &latex;-kommandot på markörens nuvarande position. + + + + + + + + + Omgivning + + Det har redan nämnts att omgivningar spelar en central roll i &latex;. &kile; erbjuder alltså fem andra kommandon, för att göra arbetet med &latex; så enkelt som möjligt, i undermenyerna Redigera Omgivning. + + + Redigera -> Omgivningsobjekt + + + + + + Redigera -> Omgivningsobjekt + + + + + + + &Ctrl;&Alt;E B Gå till start + Kommandot går till början av nuvarande omgivning, var än den aktuella positionen är. Markören placeras direkt före omgivningens inledande tagg. + + + &Ctrl;&Alt;E E Gå till slut + Kommandot går till slutet av nuvarande omgivning, var än den aktuella positionen är. Markören placeras direkt efter omgivningens avslutande tagg. + + + &Ctrl;&Alt;E M Matcha + När markören är placerad framför eller ovanför taggen \begin{omgivning}, flyttas den till motsatt ända av omgivningen och tvärtom. + + + &Ctrl;&Alt;E C Stäng + När du skriver en mängd omgivningstaggar inne i varandra, kan du förlora kontroll på alla omgivningarna. Det här kommandot avslutar den senast inledda omgivningen, så att ordningen i omgivningarnas struktur inte bryts. + + + &Ctrl;&Alt;E A Stäng alla + Det här stänger alla inledda omgivningar, inte bara den senaste omgivningen. + + + + + + + + + &tex;-grupp + + &kile; erbjuder också några specialkommandon för &latex;-grupper, som bestäms av parenteser {...}. I undermenyn RedigeraTex-grupp hittar du några viktiga kommandon, som motsvarar de från RedigeraOmgivning. + + + Redigera -> Tex-grupp + + + + + + Redigera -> Tex-grupp + + + + + + &Ctrl;&Alt;G B Gå till början + Kommandot går till början av nuvarande grupp, var än den aktuella positionen är. Markören placeras direkt före den inledande parentesen. + + + &Ctrl;&Alt;G E Gå till slut + Kommandot går till slutet av nuvarande grupp, var än den aktuella positionen är. Markören placeras direkt efter den avslutande parentesen. + + + &Ctrl;&Alt;G M Matcha + När markören är placerad framför eller efter en inledande parentes i en &tex;-grupp, flyttas den till motsatt ända av gruppen och vice versa. + + + &Ctrl;&Alt;G C Stäng + Att skriva många parenteser för grupper inne i varandra kan vara hårt arbete. Kommandot avslutar den senast inledda gruppen, så att ordningen av &tex;-grupper inte bryts. + + + + + + + + + Dubbla citationstecken + + I &latex; används två enkla citationstecken som dubbla citationstecken. För att hjälpa dig att infoga dem effektivt, låter &kile; dig trycka på " för att infoga två inledande enkla citationstecken. Om du dessutom vill avsluta ett citat, måste du också trycka på ". &kile; är smart nog att känna igen detta fall och infoga två avslutande citationstecken för &latex;. + + För att istället få ett verkligt dubbelt citationstecken, tryck två gånger på ". + + Du kan aktivera eller inaktivera att automatiskt infoga inledande och avslutande dubbla citationstecken i InställningarAnpassa Kile...Latex. + + + Dubbla citationstecken + + + + + + Dubbla citationstecken + + + + + Om du dessutom inkluderar språkspecifika alternativ som ngerman eller french, kan du också använda tyska eller franska dubbla citationstecken. Många ytterligare språk är tillgängliga. + + + + + + Smart nyrad + + Om du trycker på &Shift;Retur, infogar &kile; en intelligent nyrad. Om din nuvarande position är inne i en listomgivning som enumerate eller itemize, infogar &kile; inte bara en nyrad, utan lägger också till kommandot \item. + + Om du är inne i en tabellomgivning, avslutar &kile; aktuell rad med \\, följt av nyraden. + + Om du är inne i en &latex;-kommentar, inleder &kile; nästa rad med %. + + Ännu bättre är att &kile; är smart nog att stödja fördefinierade &latex;-omgivningar och användardefinierade omgivningar, som kan läggas till under InställningarAnpassa Kile... Latex. + + + + + + Smart tabulator + + Vissa användare tycker om att arrangera kolumner i tabellomgivningar och placera alla och-tecken & under varandra. &kile; försöker stödja det. Om du alltså trycker på &Shift;&Alt;&, tittar &kile; efter nästa tabulatortecken i raden ovanför. Även om det inte motsvarar tabulatorn, lägger &kile; till några mellanslag för att justera kolumnpositionen till nuvarande tabulator. + + + + + + + + Kodkomplettering + + Även om &kate; erbjuder ett bra kompletteringsläge, utökar &kile; kodkomplettering för att stödja vissa speciella metoder för &latex;. Fem olika metoder är införlivade. Tre av dem fungerar på begäran, medan de två övriga är automatiska kompletteringslägen. Alla metoder kan ställas in att arbeta på mycket olika sätt med InställningarAnpassa Kile.... + + + + Automatisk komplettering av omgivning + + När du påbörjar en ny omgivning genom att skriva \begin{omgivning}, lägger &kile; automatiskt till kommandot \end{omgivning}, med en rad för din text emellan. + + Automatisk komplettering kan stängas av på sidan &latex; under InställningarAnpassa Kile... LatexOmgivningar. + + + Komplettering av en ekvationsomgivning + + + + + + Komplettering av en ekvationsomgivning + + Komplettering av en ekvationsomgivning + + + + + + + + &latex;-kommandon + + När du skrivit några bokstäver kan du aktivera kompletteringsläget för &latex;-kommandon och normala ord med RedigeraKomplettera(La)tex kommando eller snabbtangenten &Ctrl;Mellanslag. &kile; läser först bokstäver från markörens nuvarande position åt vänster och stannar vid det första tecknet som inte är en bokstav eller vid ett bakstreck. Om mönstret börjar med ett bakstreck, går &kile; in i kompletteringsläget för &tex;- eller &latex;-kommandon. Annars går &kile; in i normalt ordläge, där du inte hittar några &latex;-kommandon. Beroende på valt läge, visas en kompletteringsruta. Du ser alla kommandon eller ord vars början matchar nuvarande mönster. Du kan navigera med piltangenterna i listan och välja en post med returtangenten eller ett dubbelklick med musen. + + + Komplettering av ett Latex-kommando + + + + + + Komplettering av ett Latex-kommando + + + + + När du trycker på backstegstangenten, tas den sista bokstaven i mönstret bort, och kompletteringslistan kan växa. Å andra sidan, om du skriver en bokstav till utökas mönstret och den synliga listan med ord kan minska. + + Om du bestämmer dig för att inte välja något av förslagen, kan du lämna dialogrutan med Esc. + + Du märker att alla kommandon skrivs med en kort beskrivning av deras parametrar. Beskrivningarna plockas förstås bort när du väljer ett kommando. Allternativt kan du låta &kile; infoga punkter på platserna, så att du enkelt kan hoppa till platserna med RedigeraPunkterNästa punkt och infoga parametern du vill använda. + + + Komplettering av ett Latex-kommando + + + + + + Komplettering av ett Latex-kommando + + + + + Gå till InställningarAnpassa Kile...Kile Komplettera för att ställa in en eller flera av listorna. Du kan välja olika ordlistor för &tex;- och &latex;-kommandon och ordlisteläge för vanliga ord. + + + + + + Omgivningar + + Kommandoläget är inte användbart för att komplettera omgivningar. Du måste alltid skriva in några bokstäver av \begin, och att aktivera kompletteringsläge ger en enorm lista med omgivningstaggar som resultat. Å andra sidan används omgivningar så ofta att &kile; erbjuder ett särskilt sätt att komplettera omgivningar. Glöm den inledande taggen och skriv till exempel eq. + + När du anropar kompletteringsläget med RedigeraKompletteraOmgivning eller snabbtangenten &Alt;Mellanslag, läggs den inledande taggen automatiskt till, och du ser \begin{eq}. Efter den ändringen är kompletteringslistan mycket mindre nerskräpad. + + + Komplettering av ett Latex-kommando + + + + + + Komplettering av ett Latex-kommando + + + + + Markera nu en omgivning, så ser du att den automatiskt avslutas. Förutom det, om &kile; känner igen den som en listomgivning, infogas också den första taggen \item. + + + Komplettering av ett Latex-kommando + + + + + + Komplettering av ett Latex-kommando + + + + + Gå till InställningarAnpassa Kile... Kile Komplettera för att ställa in en eller flera av listorna. Metoden använder samma ordlistor som komplettering för &tex;- och &latex;-kommandon. + + + + + + Förkortningar + + &kile; stöder användardefinierade listor med förkortningar, som ersätts på begäran av längre textsträngar. Titta på InställningarAnpassa Kile... KileKomplettera för att ställa in en eller flera av listorna. För exemplet som ges här måste förkortningslistan i example.cwl väljas. I den filen hittar du till exempel posten L=\LaTeX. + + Skriv till exempel bara bokstaven L. Aktivera nu ordkompletteringens förkortningsläge med RedigeraKompletteraFörkortning eller snabbtangenten &Ctrl;&Alt;Mellanslag, så ersätts bokstaven L av strängen \LaTeX. + + + + + + Automatiska kompletteringslägen + + + + &latex;-kommandon + + Du kan också aktivera automatisk komplettering för &latex;-kommandon. När en given tröskel av bokstäver (förval: 3) skrivs in, dyker ett fönster upp med en lista över alla &latex;-kommandon som matchar. Du kan välja ett av kommandona, eller ignorera fönstret och skriva fler bokstäver. Posterna i kompletteringsrutan ändras alltid och matchar det ord du för närvarande har skrivit. + + Gå till InställningarAnpassa Kile... KileKomplettera för att aktivera eller inaktivera läget, eller för att ändra tröskeln. + + + Komplettering av en ekvationsomgivning + + + + + + Komplettering av en ekvationsomgivning + + + + + + + + + Dokumentord + + Stora ordlistor är inte användbara i automatiskt kompletteringsläge. Men vi har märkt att många ord i ett dokument skrivs mer än en gång. &kile; erbjuder alltså komplettering av alla ord i dokumentet som användaren redan tidigare har skrivit. + + Om du vill aktivera eller inaktivera läget, gå till InställningarAnpassa Kile... Kile Komplettera. I inställningsdialogrutan kan du också ändra tröskel då kompletteringsrutan dyker upp. + + + + + + + + Skriva egna kompletteringsfiler + + Specifikationen av filformatet för kompletteringsfiler finns i specifikationen av CWL-filformatet. + + Kompletteringsfiler kan installeras i en användares hemkatalog i underkatalogen ~/.trinity/share/apps/kile/complete/<typ>/, där <typ> antingen är abbreviation, dictionary eller tex. + + + + + + + Guider och dialogrutor + + + + Infoga grafik + + Dialogrutan Infoga grafik gör det så enkelt som möjligt att infoga grafik. Ta gärna en titt på och för att få en översikt av några grundläggande fakta rörande grafikformat. + + + Infoga element från grafik + + + + + + Infoga element från grafik + + + + + + Välj en grafikfil. Det kan vara en JPEG-fil, PNG-fil, EPS-fil eller till och med en EPS-fil komprimerad med zip eller gzip. Om du har installerat &imagemagick; och dessutom ställt in &kile; att använda det (InställningarAnpassa Kile... Latex Allmänt), visas grafikens höjd och bredd automatiskt. Om &imagemagick; kan bestämma upplösningen, visas också grafikens storlek i centimeter. + + Bestäm om bilden ska vara centrerad på sidan. + + Välj antingen traditionell &latex; eller &pdflatex;. Kom ihåg att &pdflatex; också kan skapa DVI-utdata, inte bara PDF. + + Du kan välja om filnamnet ska vara relativt. Det är sättet som föredras när du använder kommandot \graphicspath. + + Normalt måste grafikfiler finnas i samma katalog som ditt huvuddokument. Det är dock möjligt att placera dem i andra kataloger för att göra saker och ting snyggare. Utan kommandot \graphicspath, skulle &kile; inkludera sökvägen till grafikfilen. Men om du använder \graphicspath, som: + +\graphicspath{{/sökväg/till/min/grafik}{annan/sökväg/till/mer/grafik}} + + + och markerar alternativet, använder &kile; bara grafikfilens basnamn. + + Ett annat exempel: Om du anger kommandot \graphicspath som: + +\graphicspath{{./}{kamera/}{bilder/}} + + + söker &latex; i aktuell katalog, därefter i kamera och till sist i bilder för att hitta din grafikfil. + + Om du antingen väljer bredd eller höjd, skalas hela grafiken proportionellt. Om du ställer in två värden samtidigt för bredd och höjd, kan bredd och höjd skalas med olika faktorer, och det kanske inte är vad du vill. Se också informationen längst upp i dialogrutan för att få reda på grafikens originalstorlek. + + Ange en vinkel som grafiken ska roteras moturs. + + Information om omgivande ruta ställs automatiskt in när du väljer en grafikfil. Informationen behövs bara när du arbetar med traditionell &latex;-grafik och punktavbildad grafik. Se beskrivningen av EPS-grafik. + + Det sista valet är om grafiken ska inbäddas i en figuromgivning. Om du väljer att göra det, kan du också infoga en rubrik och en etikett. Det är en god idé att lägga till olika prefix för varje typ av etikett. Det är vanligt att använda prefixet fig: för bilder. + + + + + + + Fältguide + + En av de tråkigaste uppgifterna man kan göra i &latex; är att skriva en matris eller tabellomgivning. Man måste hålla reda på alla element, försäkra sig om att omgivningen är riktigt inmatad, och att allt finns där det är meningen att det ska vara. Bra indentering hjälper till, men det finns ett enklare sätt: Använd &kile;s meny Guide. Den innehåller Tabell och Fält (som används i matematiska omgivningar). Då får du ett matrisformat inmatningsformulär, som du enkelt kan fylla i med dina värden. Dialogrutan erbjuder också inställningar för att typsätta tabellmaterialet. + + + Infoga en tabellomgivning + + + + + + Infoga en tabellomgivning + + + + + Alternativet Tabulering visar en enkel meny för att ställa in en tabuleringsomgivning. I alla dessa omgivningar kan du enkelt ställa in antal rader och kolumner, tillsammans med andra specifika alternativ. + + + + + &postscript;-verktyg + + PS-filer är inte så populära som PDF-filer, men är en utmärkt grund för behandling och omarrangering av sidor. Om du behöver PDF-utmatning, kan du arrangera om sidor med några &postscript;-verktyg, och därefter konvertera till PDF med ps2pdf. + + &postscript;-guiden föreslår de populäraste omändringarna, men du har frihet att göra dina egna val. Arbetet utförs av programmen pstops och psselect, som du hittar i de flesta distributioner i paketet psutils. Om ett av programmen inte är tillgängligt, är inte motsvarande post synlig. + + + Dialogrutan Postscript-verktyg + + + + + + Dialogrutan Postscript-verktyg + + + + + Välj först indatafil. Om &kile; hittar en PS-fil som motsvarar det nuvarande huvuddokumentet, är den redan ifylld som indatafil, men du har också frihet att välja en annan fil. Välj därefter utdatafil, och välj en av uppgifterna. Till sist måste du välja om du bara vill göra konverteringen, eller också starta &kghostview; för att titta på resultatet. + + + + + 1 A5-sida + tom sida --> A4 + Kombinera en A5-sida med en tom sida på en A4-sida. Så fort två A5-sidor kombineras, roteras de 90 grader och arrangeras på A4-sidan med liggande format. + + A5 + tom sida + + + + + + A5 + tom sida + + + + + + + + 1 A5-sida + duplikat --> A4 + Placera en A5-sida och ett duplikat tillsammans på en A4-sida. + + duplicera A5-sidor + + + + + + Duplicera en A5-sida + + + + + + + + 2 A5-sidor --> A4 + Placera två på varandra följande A5-sidor tillsammans på en A4-sida. + + Kombinera två A5-sidor + + + + + + Kombinera två A5-sidor + + + + + + + + 2 A5 liggande sidor --> A4 + Placera två på varandra följande liggande A5-sidor tillsammans på en A4-sida. + + + + 4 A5-sidor --> A4 + Kombinera fyra på varandra följande A5-sidor tillsammans på en A4-sida. A5-sidorna måste skalas med faktorn 0,7 för att få plats på sidan. + + 4 A5-sidor --> A4 + + + + + + 4 A5-sidor --> A4 + + + + + + + + 1 A4-sida + tom sida --> A4 + Kombinera en A4-sida med en tom sida på en A4-sida. Så fort två A4-sidor kombineras på en A4-resultatsida, måste de skalas med faktorn 0,7 och arrangeras med stående format. + + 1 A4-sida + tom sida --> A4 + + + + + + 1 A4-sida + tom sida --> A4 + + + + + + + + 1 A4-sida + duplikat --> A4 + Placera en A4-sida och ett duplikat tillsammans på en A4-sida. + + 1 A4-sida + duplikat --> A4 + + + + + + 1 A4-sida + duplikat --> A4 + + + + + + + + 2 A4-sidor --> A4 + Placera två på varandra följande A4-sidor tillsammans på en A4-sida. + + Kombinera två A4-sidor + + + + + + Kombinera två A4-sidor + + + + + + + + 2 A4 liggande sidor --> A4 + Placera två på varandra följande liggande A4-sidor tillsammans på en A4-sida. + + + + välj jämna sidor + Välj alla jämna sidor i ett dokument. + + + + välj udda sidor + Välj alla udda sidor i ett dokument + + + + välj jämna sidor (omvänd ordning) + Välj alla jämna sidor i ett dokument och vänd på ordningen. + + + + välj udda sidor (omvänd ordning) + Välj alla jämna sidor i ett dokument och vänd på ordningen. + + + + vänd alla sidor + Vänd alla sidor i ett dokument. + + + + kopiera alla sidor (sorterade) + Kopiera alla sidor i ett dokument. Du måste välja antal sorterade kopior. + + Kopiera alla sidor (sorterade) + + + + + + Kopiera alla sidor (sorterade) + + + + + + + + kopiera alla sidor (osorterade) + Kopiera alla sidor i ett dokument. Du måste välja antal osorterade kopior. + + Kopiera alla sidor (osorterade) + + + + + + Kopiera alla sidor (osorterade) + + + + + + + + pstops: välj parameter + Det finns många väljare för &postscript;-verktygen pstops och psselect. Om du vill ha en mycket speciell, kan du starta pstops med en egen väljare. Läs i manualen om alla tillgängliga väljare. + + + + psselect: välj parameter + Du kan starta psselect med en egen väljare. Läs i manualen om alla tillgängliga väljare. + + + + + + + + Dokumentstatistik + + Statistikdialogrutan ger dig en statistisk översikt av en markering, ett dokument eller ett helt projekt. Den omfattar antal ord, kommandon och omgivningar i &latex; och innehåller också antalet tecken av varje typ. Statistikvärden kan kopieras som text eller en trevligt formaterad &latex;-tabellomgivning till klippbordet. Om du vill ha statistik för hela projektet kan du använda Arkiv Öppna alla projektfiler som ett snabbt och enkelt sätt att öppna alla källfiler i projektet. + Ett varningens ord måste sägas om noggrannheten hos värdena. En del logik för att få en bra uppskattning har inkluderats, t.ex. ger K\"old ett ord och ett kommando, med fyra respektive två tecken. Det finns dock andra kombinationer där delar av kommandon räknas som ord och tvärtom. Man bör också tänka på att algoritmen utvecklades och provades med språk som liknar engelska eller tyska. Ta alltså inte värdena för givet. Om du måste skapa en rapport med ett exakt antal ord eller tecken, gör några försök för att se om &kile;s noggrannhet uppfyller dina behov. + + + + + + + Specialtaggar i &latex; + + + Använda &latex;-taggbibliotek + + &latex; har tusentals taggar för symboler och specialtecken. Det enklaste sättet att infoga ett specialtecken är att använda menyn i sidoraden, till vänster om redigeringsfönstret. + + + Sidoradens meny + + + + + + Sidoradens meny + + Sidoradens meny + + + Följande typer är tillgängliga: + + + Oftast använda + Relationer + Operatorer + Pilar + Diverse matematik + Diverse text + Avgränsare + Grekiska + Specialtecken + Kyrilliska tecken + Användardefinierade + + Ikonernas verktygstips visar &latex;-kommandon och ytterligare paket som behövs. + Att hålla nere &Shift; och klicka på en symbol gör att $\symbolcmd$ infogas. På liknande sätt infogas krullparenteser genom att hålla nere &Ctrl;. + Om du infogar ett kommando som kräver ett paket som inte ingår i &latex;-dokumentet, ser du en varning i loggfönstret. + Den första listan med symboler innehåller Oftast använda symboler. Infogade symboler läggs till i listan för snabb och enkel åtkomst. Symbolernas ordning ändras inte när nya symboler läggs till, utan istället ökas en referensräknare. Om antalet objekt skulle överstiga 30, tas objektet med lägst antal referenser bort. + Symbollistan Användardefinierade kan innehålla dina egna symboler. För att skapa egna symboler behöver du programmet gesymb och filen definitions.tex från Kiles källkodspaket. Dessutom behöver du en &latex;-kompilator (ingen överraskning) och &dvipng; (version 1.7 eller senare). Proceduren är att skapa en &latex;-fil med \input{definitions}, som gör kommandona listade nedan tillgängliga, och låter gesymb mysymbols.tex user skapa ikonerna (då anropas &latex; och &dvipng;). Efter att de har kopierats till $HOME/.trinity/share/apps/kile/mathsymbols/user/ och Kile har startats om, kan du använda dina egna symboler. + Följande kommandon är definierade i definitions.tex: + + \command[\optarg]{\symbol}: Inkludera symbolen \symbol i symbollistan, det valfria argumentet \optarg anger kommandot som Kile ska infoga. Om det inte anges används kommandot i argumentet som krävs. + + + \mathcommand[\optarg]{\symbol}: Samma som ovan, förutom att kommandot i argumentet som krävs infogas i matematikläge. + + + \pkgs[arg]{pkg}: Deklarerar att kommandot som anges på raden kräver &latex;-paketet pkg med det valfria argumentet arg. Kommandot måste vara framför kommadot \command och överskrider eventuella paketspecifikationer av omgivningen neededpkgs. + + + \begin{neededpkgs}[pkgs-args]{pkgs} ... \end{neededpkgs}: Har samma effekt som ovan, men för alla omslutna kommandon. + + + + För fullständighetens skull anges ett exempel här: + \documentclass[a4paper,10pt]{article} + \usepackage{amssymb} + \input{definitions} + % + \begin{document} + \pagestyle{empty} + % + \begin{neededpkgs}{amssymb} + \mathcommand{\surd} + \pkgs{amsmath}\mathcommand[\ddddot{}]{\ddddot{a}} + \mathcommand{\angle} + \end{neededpkgs} + \command{\"A} + \mathcommand{\exists} + \mathcommand[\stackrel{}{}]{\stackrel{abc}{=}} + + %\begin{neededpkgs}[russian,koi8-r,T2C,]{babel,inputenc,fontenc,mathtext} + % + % \end{neededpkgs} + % this would need to include the packages + % \usepackage{mathtext} + % \usepackage[T2C]{fontenc} + % \usepackage[russian]{babel} + % \usepackage[koi8-r]{inputenc} + % just to explain the format + \end{document} + + + + + + + Att använda bibliografiposter + + \bibitem är ett kommando som används för att lägga till en referens i dokumentet till omgivningen bibliografin. Syntaxen för att använda kommandot \bibitem är \bibitem[rubrik]{nyckel}. + + Det valfria [rubrik] är till för att du ska kunna lägga till ditt eget rubriksystem för bibliografiposten. Om ingen rubrik anges, läggs posterna till i numerisk ordning: [1], [2], [3] etc. + + Argumentet {nyckel} används för att referera och länka kommandona \bibitem och \cite till varandra och informationen de innehåller. Kommandot \cite innehåller referensen som hör ihop med önskad \bibitem, som finns i omgivningen bibliografin och innehåller referensdata. Båda samhörande \bibitem och \cite måste ha samma {nyckel}. Det enklaste sättet att organisera nycklar är med författarens efternamn. De andra klamrarna i omgivningen bibliografin anger den längsta bibliografireferensen du kan ha. Så att skriva {999}, betyder att du kan ha referenser kortare eller lika långa som 999. Anges inte parametern på ett riktigt sätt, kan det orsaka mindre attraktiva indenteringar i bibliografin. + + Bibliografin är en separat sektion åtskild från huvuddokumentet. Ett exempel på kod för bibliografin skulle kunna se ut som följer: + + + \begin{bibliografin}{50} + \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm...munkar}. + Evergreen Terrace Printing Co., Springfield, Någonstans i U.S.A, 1998 + \end{bibliografin} + + Därefter skulle din huvudkällkod innehålla platsen för informationen som har att göra med detta \bibitem genom att använda \cite. Källkoden skulle se ut ungefär så här: + + + Min uppsats om filosofin i Simpsons\copyright + kommer från min favoritbok \cite{Simpson}. + + Eftersom det ofta är svårt att komma ihåg den exakta hänvisningsnyckeln när du har många referenser, tillhandahåller &kile; ett enkelt sätt att infoga en referens. Klicka på den andra kombinationsrutan i redigeringsverktygsraden (oftast visar den label) och välj cite. En lista med alla hänvisningsnycklar visas. Välj den rätta referensen, så infogas en hänvisning i dokumentet. För att uppdatera listan med nycklar, spara antingen filen eller välj Redigera +Uppdatera struktur eller tryck på F12. + + Slutprodukten i dokumentets bibliografi ser då ut så här: + + [1] Homer J. Simpson. Mmmmm...munkar. Evergreen Terrace Printing Co., Springfield, Någonstans i U.S.A., 1998. + + Det enklaste sättet att arbeta med \bibitem och \cite är att använda verktygsradens kombinationsruta som heter cite. När du väljer hänvisning att infoga, visas en lista med alla bibitem som du hittills har skapat och du kan välja referensen från listan. &kile; kan nu arbeta med &bibtex; editorprogram som &kbibtex; för att göra hänvisningar enklare. + + + + + + Användardefinierade taggar + + &kile; gör det möjligt att skapa egna taggar. En tagg liknar en snabbtangent som startar ett kommando, eller skriver text som ofta används. Om en vanlig användare exempelvis ofta behöver meningarna Jag föredrar \LaTeX\ framför \TeX\ och Vad skulle jag göra utan Linux?, skulle han använda Användare Användartaggar Redigera användartaggar... för att skapa användardefinierade taggar som skriver meningarna. Då visas en dialogruta där egna användardefinierade taggar kan anges. + + Dialogrutan Redigera användartaggar + + + + + + Dialogrutan Redigera användartaggar + + Dialogrutan Redigera användartaggar + + + + + Aktivera en användardefinierad tagg + + + + + + Aktivera en användardefinierad tagg + + Aktivera en användardefinierad tagg + + + + Han skulle troligen ge varje tagg ett namn som enkelt identifierar den. Namnet som taggarna får skulle skrivas in i på raden Menyalternativ och texten för ofta använda kommandon skulle skrivas in i rutan Värde. När kommandona väl har skrivits in, kan han snabbt användas dem med snabbtangenten &Ctrl;&Shift;1 för den första taggen, för att skriva in Jag föredrar \LaTeX\ framför \TeX\ och &Ctrl;&Shift;2 för att skriva in Vad skulle jag göra utan Linux?. + + + + Platsmarkörer i användardefinierade taggar + + Det finns några platsmarkörer som du kan använda i användardefinierade taggar. De är %B, %C, %M och %S. + + + %B: Ersätts med en punkt. + %C: Det här är platsen där markören placeras efter en användardefinierad tagg infogats. + %M: Det här står för markerad text, där den markerade texten infogas när användardefinierade taggar infogas. + %S: Ersätts med källkodsfilens namn utan filändelse. + + + För att visa hur det fungerar, låt oss anta att vi har en användardefinierad tagg som innehåller värdet \bfseries{%M}%C, och ett textstycke är markerat som ska omvandlas till fetstil. Alltså markerar vi texten Jag älskar fredagar, tillämpar den användardefinierade taggen genom att trycka på &Ctrl;&Shift;1 och får texten \bfseries{Jag älskar fredagar} med markören placerad efter texten. + + + + + + + + + + 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 &kdvi;, &kghostview;, &kpdf; eller för ytterligare konvertering, kan du använda snabbtangenten &Alt;2. Därefter kan du visa DVI-filen med ditt eget förvalda visningsprogram med &Alt;3, konvertera DVI till en PS-fil med &Alt;4, och visa PS-filen med &Alt;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. + + + + + + &makeidx; + + Om du använder paketet &makeidx; för att skapa ett slutligt, alfabetiskt index för dokumentet, måste du också följa ett särskilt kompileringsmönster, eller låta &kile; göra det åt dig på samma sätt som med &bibtex;-filer. + + + + + + MetaPost och Asymptote + + Om du vill kompilera dokumentet med MetaPost eller Asymptote, program för att rita bilder, kan du göra det med ByggKompileraMetaPost eller ByggÖvrigtAsymptote. + + + + + + &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 &Alt;6. Därefter kan du direkt titta på den kompilerade filen genom att trycka på &Alt;7. + + Du kan alternativt konvertera PS till PDF med &Alt;8, eller direkt från DVI till PDF med &Alt;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 &kile;s 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 HTML. + + + + + + Skicka med kommandoradvä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... VerktygBygg. + + + + + + + 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ällningarAnpassa Kile... Verktyg Förhandsgranskning. + + + Anpassa snabbgranskning + + + + + + Anpassa snabbgranskning + + + + + + + Markeringsläge + + Användaren måste markera en del av dokumentet. Menyalternativet ByggSnabbgranskningMarkering eller snabbtangenten &Ctrl;&Alt;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 sju fördefinierade inställningar: + + + Latex+DVI (inbäddad visning) + Latex+DVI (KDVI) + Latex+PS (inbäddad visning) + Latex+PS (Kghostview) + PDFLatex+PDF (inbäddad visning) + PDFLatex+PDF (Kghostview) + PDFLatex+PDF (KPDF) + + + 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 ByggSnabbgranskningOmgivning eller snabbtangenten &Ctrl;&Alt;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 ByggSnabbgranskningUnderdokument eller snabbtangenten &Ctrl;&Alt;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 ByggSnabbgranskningMatematisk grupp eller snabbtangenten &Ctrl;&Alt;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 till DVI eller PDF, men kan inte hantera EPS-filer. Tvärtom så stöds EPS av processen att kompilera DVI med &latex; och konvertera till PS och PDF, men 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 &postscript;-grafik, eller vill använda &postscript;-utmatning från matematisk eller vetenskaplig programvara som Mathematica, Maple eller MuPAD. Dessa användare av &latex; måste först kompilera &postscript; även om de vill skapa PDF-dokument, eftersom programmen skapar &postscript;-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, om du vill inkludera både &postscript; 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;, 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 &postscript;-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 , 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 GIF) är ett filformat utan förlust, med bra komprimering och kvalitet. Det är mycket bra för diagram, inlästa ritningar, eller någonting vars skärpa måste behå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 &postscript;), 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 DVI-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 DVI-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 DVI-filen. Eftersom EPS-filerna måste vara tillgängliga när DVI-filen konverteras till PS, måste EPS-filerna följa med DVI-filerna så fort de flyttas. + + + Nu kan du anropa &latex; och ett DVI-PS konverteringsverktyg som dvips för att skapa ditt &postscript;-dokument. Om målet är ett PDF-dokument, ska du köra dvips med väljaren och därefter anropa ps2pdf. Du hittar många dokument som beskriver denna lösningen. + + + + + + Sättet med &postscript; 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 av 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 dess upplösning ä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 &postscript; 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 &tetex;-systemet riktigt. Det finns inget behov av att konvertera JPEG- eller PNG-grafik, det kan göras automatiskt när DVI-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}{}% + % ändrade eller nya grafikregler + \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}% EPS komprimerad med zip + \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}% EPS komprimerad med gzip + \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-grafik + + + 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 filen. 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 , 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 &Alt;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. + + För närvarande stöder &kdvi; kontinuerlig uppdatering av den visade DVI-filen, men &kghostview; är inte riktigt så perfekt. För att uppdatera dokumentet efter kompilering, måste du byta sida, och antalet sidor ändras inte i &kghostview;s visning. + + 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. + + + + + + + + Navigera i &latex;-källkoden + + + + Användning av strukturvyn + + Strukturvyn visar hierarkin för dokumentet som skapas i &kile;, och låter dig snabbt navigera i dokumentet, genom att visa dokumentets delar. För att navigera i dokumentet är allt du behöver göra att vänsterklicka på en rubrik, ett kapitel, ett avsnitt, ett delavsnitt, etc., så kommer du till början av motsvarande område. + + Om du inkluderar en separat fil i &latex;-dokumentet med taggarna \input eller \include, refereras de till i strukturvyn. Ett dubbelklick på namnet i den gör att &kile; visar den inkluderade filen i redigeringsfönstret. + + Strukturträdet har också en särskild gren för LABELS som används i texten. + + + Användning av strukturvyn + + + + + + Användning av strukturvyn + + Användning av strukturvyn + + + + + + Uppdatera strukturvyn + + För att uppdatera strukturvyn kan du antingen använda Redigera Uppdatera struktur, trycka på F12, eller spara dokumentet, vilket gör att &kile; uppdaterar strukturvyn. + + + + + + + + Bokmärken + + Bokmärken är användarens referens till ett textstycke eller en rad inne i &kile;-miljön. För att använda ett bokmärke, markera en viss rad i dokumentet som du skulle vilja kunna komma tillbaka till, och tryck därefter &Ctrl; B, så lägger &kile; automatiskt till ett bokmärke på raden. Som ett alternativ kan du också lägga till ett bokmärke genom att markera raden du skulle vilja kunna komma tillbaka till, och välja menyalternativet BokmärkenVäxla bokmärke. + + För att ta bort alla bokmärken, välj Bokmärken Rensa bokmärken. + + Observera att för närvarande sparas inte bokmärken efter &kile; har avslutats. + + + + + + + + Projekt + + + + Arbeta med projekt + + Du har möjlighet att skapa och arbeta med projekt i &kile;. Ett projekt är en gruppering av &latex;, &bibtex; eller andra filer som innehåller all information som används för att bygga det fullständiga dokumentet. Ett typiskt projekt skulle vara ett dokument som består av flera kapitel, skrivna i olika .tex-filer. Alla skulle då kunna ingå i ett projekt, för att göra hela dokumentet enklare att hantera. Projektets specifikation lagras i en särskild fil, med filändelsen .kilepr. + + Ett projekt lägger till följande funktioner: + + + Du behöver inte ange huvuddokument, utan &kile; gör det automatiskt. + Projektfiler kan enkelt arkiveras tillsammans genom att välja Bygg Övrigt Arkivera. + Vyn Filer och projekt visar vilka filer som ingår i projektet. + Efter ett projekt har öppnats, återställs alla filer som tidigare var öppna med ursprunglig kodning och färgläggning. + Kodkomplettering fungerar över alla projektfiler. + Referenskomplettering fungerar över alla projektfiler. + Hänvisningskomplettering fungerar över alla projektfiler. + Sök i alla projektfiler. + Ange egna snabbygg- och &makeidx;-kommandon. + + + + + + + Skapa ett projekt + + För att skapa ett projekt, välj Projekt Nytt projekt.... Du blir tillfrågad om att ge följande information för att kunna skapa projektet: + + Projektets namn. + Projektfilens namn med filändelsen .kilepr. + Filnamn. + Typ av fil som skapas: tomt dokument, artikel, bok, brev, rapport, ... + + + När du fyller i rutan filnamn, måste du ta med en relativ sökväg från platsen där projektfilen .kilepr är lagrad till filen. + + + + + + Fil- och projektvyn + + Vyn Filer och projekt visas med en knapp i sidoradens meny. I vyn kan du se projektets struktur, dess filer och namnet på filen .kilepr som lagrar projektinformationen. Lägga till filer, ta bort filer, eller ändra alternativ i projektet görs via vyn Filer och projekt. + + + Fil- och projektvyn + + + + + + Fil- och projektvyn + + Fil- och projektvyn + + + + + + + + Lägga till och ta bort filer + + För att lägga till en fil i projektet, öppna vilken &tex;-fil som helst, högerklicka på namnet i vyn Filer och projekt och välj Lägg till i projekt. Om du har flera öppna projekt, får du välja projektet där filen ska läggas till i en dialogruta. + + Eller om du har flera filer som ska läggas till i projektet, kan du välja projektet i vyn Filer och projekt, högerklicka och därefter välja Lägg till filer. Du får då möjlighet att välja filerna i en dialogruta. + + Du kan också högerklicka på projektets namn i vyn Filer och projekt, och välja Lägg till filer... för att visa en filvalsdialogruta. + + + Lägga till en fil i ett projekt + + + + + + Lägga till en fil i ett projekt + + Lägga till en fil i ett projekt + + + + För att ta bort en fil från ett projekt, högerklicka på den och välj Ta bort fil. Det här tar inte bort själva filen (och stänger den inte heller), utan tar bara bort den från listan med filer som finns i filen med filändelsen .kilepr. + + + + + + Projektalternativ + + &kile; har bara några få alternativ som kan ställas in för projektet. För att ändra dem, högerklicka på projektets namn och välj Projektalternativ, så får du möjlighet att ändra: + + + Projektets namn. + Huvuddokumentet. + Snabbyggkommandot. + Väljare för &makeidx;. + + + + + Arkivera projekt + + &kile; låter dig enkelt säkerhetskopiera projektet genom att lagra alla dess filer i ett enda arkiv. För att arkivera projektet, högerklicka på dess namn i vyn Filer och projekt, eller välj Projekt Arkivera. + + Normalt läggs alla filer i ett projekt till i arkivet. Om du inte vill lägga till en viss fil i arkivet, högerklicka på den i vyn Filer och projekt och avmarkera alternativet Inkludera i arkiv. + + Arkiveringskommandon är enkla skalkommandon som körs från projektkatalogen (där filen .kilepr finns). + + + + + + + + + + Stänga ett projekt + + För att stänga ett projekt, välj vyn Filer och projekt i den vertikala verktygsraden, högerklicka på projektnamnet, och välj Stäng. Då stängs projektet, alla filer som hör ihop med det, och dessutom läggs projektet som du just stängde till i kombinationsrutan Öppna senaste projekt... i menyn Projekt. + + + + + + + + Dokumentkodning + + &kile;-editorn låter dig läsa, konvertera och ställa in texten till kodningen som dokumentet behöver. Det ger dig möjlighet att använda bokstäver och symboler som inte är standard. Du kan till exempel använda tecken med accent för italienska, franska eller svenska. Att välja kodning för ett dokument kan göras på tre sätt: + + + Ett sätt att ange kodningen är att använda kombinationsrutan Ange kodning, som finns längst ner i sidovyn Öppna fil. + Ett annat sätt är att använda undermenyn InställningarAnpassa Kile...Editor där du kan ställa in förvald teckenkodning för alla filer. + + Välja förvald teckenkodning + + + + + + Välja förvald teckenkodning + + + + + Ett tredje sätt att ange kodningen för dokumentet är att välja den när du använder guiden för att skapa ett nytt dokument. + + + &latex; själv förstår bara ASCII-tecken, en mycket begränsad uppsättning tecken, så du har inte möjlighet att använda bokstäver med accent eller specialtecken direkt. För att använda bokstäver med accent, skapades en särskild syntax, som till exempel \"a för ä. Det finns ett paket för att hjälpa dig med detta, som heter inputenc, som infogas i inledningen med \usepackage[utf8x]{inputenc}, där det valfria argumentet är kodningen som du vill använda (i de flesta fall utf8x). Det talar om för &latex; att översätta alla ä i dokumentet till \"a innan kompilering. Titta gärna i dokumentationen om inputenc för mer information om det. Sist men inte minst, kom ihåg att försäkra dig om att filen verkligen är kodad med samma kodning som du anger till inputenc. + + + Välja källkodsfilens kodning + + + + + + Välja källkodsfilens kodning + + Välja källkodsfilens kodning + + + + Mängden olika tabeller för teckenkodning har orsakat problem för många program. Du kan till exempel inte skriva en kurs i turkiska på franska utan att ett av språkens specialtecken går förlorade. Det finns en allmän överenskommelse att alla, förr eller senare, ska byta till Unicode. Det finns många implementeringar av Unicode, och UTF-8 är den mest lyckade på Linux. Windows® förlitar sig på det mer ohanterliga och mindre flexibla UCS-2. Vissa distributioner, som RedHat, har redan börjat ställa in förvald kodning till UTF-8, och därför kan det vara mycket intressant att använda argumentet utf8x för paketet inputenc. + + + + Paketet &ucs; + Om du inte har installerat &ucs;-paketet, kan du fortsätta på följande sätt: + + Hämta &ucs;-paketet på hemsidan Unicode stöd för &latex; av Dominique Unruh från universitetet i Karlsruhe. + + Packa upp den nerladdade filen och placera den i en katalog som anges i miljövariabeln $TEXINPUTS, för att installera det. Det kan också ställas in i Kile. + + + + \usepackage{ucs} + \usepackage[utf8x]{inputenc} + + + + + + Stöd för &cjk; + + Att lägga till stöd för språk med ideogram är rätt besvärligt. När du väl har gjort det, fungerar det dock riktigt bra. Förutom att installera paket, behöver visst extra inställningsarbete utföras. + + Din Linux-distribution kanske redan har paketet &cjk; (kinesiska, japanska, koreanska) klart åt dig, så du kan bli besparad besväret att installera allt för hand. Kontrollera det innan du går vidare! + + Möjligheten att använda &ucs;-paketet för att skriva korta snuttar med &cjk;-text finns, men alternativet har allvarliga begränsningar eftersom det inte hanterar bland annat nyrader. Vi installerar istället det fullständiga &cjk;-&latex; paketet och får det att fungera både för &latex; och &pdflatex;. Mycket av materialet här är inspirerat av Pai H. Chous sida om hur &pdflatex; ställs in. + + + + Ladda ner paketet &cjk;. Kopiera de uppackade filerna till en lämplig underkatalog under $TEXMF, precis som du gjorde med paketet &ucs; tidigare (se ). Filerna packas upp i katalogen CJK/X_Y.Z. Det är inte viktigt att flytta dem, även om det blir snyggare att underhålla. + + Nu måste du ladda ner ett teckensnitt som stöder alla &cjk;-tecken som du behöver. Du kan välja vilken .ttf-fil som helst som täcker dem, men i den här genomgången använder vi Cyberbit. Packa upp filen och byt namn på Cyberbit.ttf till cyberbit.ttf, eftersom stora bokstäver kan förvirra systemet. + Placera cyberbit.ttf i en katalog tillsammans med Unicode.sfd, och skapa filerna *.tfm och *.enc med kommandot $ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@. Av någon anledning skapar detta inte alltid de hundratals filer som det ska. Om det är fallet, kan du ladda ner både *.tfm och *.enc filerna. + Placera .tfm-filerna i lämplig katalog, såsom $TEXMF/fonts/tfm/bitstream/cyberbit/, .enc-filerna kan installeras i $TEXMF/pdftex/enc/cyberbit/. + + Nu behöver vi en avbildningsfil för att koppla ihop .enc-filerna med teckensnittet. Ladda ner cyberbit.map och installera den i $TEXMF/pdftex/config/. + + Ladda ner en annan fil, c70cyberbit.fd, och placera den i lämplig katalog. Du kan till exempel välja $TEXMF/tex/misc/. + + Den sista filen vi måste skapa är ett &postscript; Typ 1 teckensnitt, som behövs för att läsa DVI-filer som skapas med &latex;. Kör kommandot $ ttf2pfb cyberbit.ttf -o cyberbit.pfb och kopiera resultatet cyberbit.pfb till en katalog som $TEXMF/fonts/type1/cyberbit/. + + Låt oss nu placera cyberbit.ttf bland teckensnitten där &latex; kan hitta den. Du skulle kunna placera den i en katalog som heter $TEXMF/fonts/truetype/. + + Kontrollera inställningsfilen som du hittar med $TEXMF/web2c/texmf.cnf, och försäkra dig om att raden som nämner TTFONTS inte är bortkommenterad och pekar på katalogen där du sparade cyberbit.ttf. + + För att göra det möjligt för &pdflatex; att använda dina &cjk;-teckensnitt, är det nödvändigt att lägga till en rad i inställningsfilen $TEXMF/pdftex/config/pdftex.cfg. Lägg till map +cyberbit.map i filen för att färdigställa inställningen av &pdflatex;. + + För att ställa in &latex; så att du kan skapa DVI-filer med &cjk;-tecken, måste du lägga till en rad i filen ttfonts.map. Filen kan finnas i en katalog som heter $TEXMF/ttf2pk/, men du måste troligen leta efter den. Lägg till raden cyberbit@Unicode@ cyberbit.ttf i den. + + Nu behöver du bara köra texhash så ska systemet vara klart. + + + + För att testa om din inställning är riktig, kan du försöka kompilera den här testfilen. + + + Felsökning av &cjk; + + Det finns många saker som kan gå fel när &cjk;-stöd läggs till för hand. Om något inte verkar fungera, kan följande checklista hjälpa dig: + + + + Eftersom du kör &latex; som en användare och inte som systemadministratör, måste du förstås tillåta vanliga användare att komma åt de nya filerna. Försäkra dig om att alla kataloger och filer kan kommas åt med kommandot chmod. + + Om &latex; skriver DVI utan problem, men du inte kan visa det, beror den nästan säkert på något problem med de automatiskt skapade *.pk-tecknensnitten. Det är meningen att de ska skapas i farten när en DVI-fil visas, men det kan misslyckas av ett antal olika orsaker: kontrollera först i ttfonts.map efter din egna rad. Det kan dock inträffa att kommandot ttf2pk, som oftast anropas av DVI-visaren, har kompilerats utan stöd för biblioteken kpathsea. Om så är fallet, nämner ttf2pk inte kpathsea. Eftersom stöd för dessa bibliotek är nödvändigt, måste du hitta ett nytt paket eller kompilera om FreeType 1 själv. + + + + + + + + + Hur matar man in &cjk; med Unicode? + + Det finns ett antal olika inmatningsprogram, och valet kan bero på vad du personligen föredrar. Upphovsmannen använder Skim, en överföring av programmet Scim till &kde;. Titta i din distributions dokumentation för att ta reda på hur man installerar programmen. Inställning av sådana program kan också vara besvärlig. I fallet med Skim måste du definiera miljövariabeln XMODIFIERS="@im=SCIM" innan du startar X. + + + + + + + + + + Skriva skript + + + + Skriva skript i &kile; + + &kile;s skriptfunktion gör det möjligt att köra ECMA-skript kod. Skript kan hanteras via skriptrutan i sidoraden. + + + + + + Referens till programmeringsgränssnitt + + I det här avsnittet beskriver vi &kile;s programmeringsgränssnitt för skript. + + + Observera att programmeringsgränssnitt inte ännu är färdigställt. Det programmeringsgränssnitt som beskrivs nedan kan komma att ändras i framtida versioner av &kile;. + + + För det första tillhandahåller &kile;s exekveringsmiljö för skript ett globalt objekt benämnt "kile", som innehåller följande metoder: + + + + (kile).currentTextDocument() + + Returnerar ett KileTextDocument-objekt som motsvarar textdokumentet som för närvarande är aktivt. Returnerar null om inget textdokument är aktivt. + + + + (kile).getInputValue(rubrik, etikett) + + Öppnar en dialogruta med angiven rubrik och etikett. Returnerar värdet som användaren matar in. + + + + + Objekt av typen KileTextDocument representerar textdokument i &kile;. De har följande egenskaper: + + + + (KileTextDocument).backspace() + + Tar bort tecknet som är placerat omedelbart innan markörens nuvarande position och flyttar markören en position bakåt i texten. + + + + (KileTextDocument).cursorLeft() + + Flyttar markören en position bakåt i texten. + + + + (KileTextDocument).cursorRight() + + Flyttar markören en position framåt i texten. + + + + (KileTextDocument).insertText(text) + + Infogar texten som finns i variabeln text i dokumentet på markörens nuvarande plats. + + + + (KileTextDocument).insertBullet() + + Infogar en punkt i dokumentet på markörens nuvarande position. + + + + (KileTextDocument).nextBullet() + + Markerar den första punkten som hittas i dokumentet omedelbart efter markörens nuvarande position. + + + + (KileTextDocument).previousBullet() + + Markerar den första punkten som hittas i dokumentet omedelbart före markörens nuvarande position. + + + + (KileTextDocument).up() + + Flyttar markören en rad uppåt i dokumentet. + + + + (KileTextDocument).down() + + Flyttar markören en rad neråt i dokumentet. + + + + (KileTextDocument).cursorLine() + + Returnerar raden som markören för närvarande är placerad på. + + + + (KileTextDocument).cursorColumn() + + Returnerar kolumnen som markören för närvarande är placerad på. + + + + (KileTextDocument).setCursorLine(rad) + + Flyttar markören till raden angiven av rad. + + + + (KileTextDocument).setCursorColumn(kolumn) + + Flyttar markören till kolumnen angiven av kolumn. + + + + + + + + + + + Hjälp + + + + Hjälpdokument + + &latex; är ett ganska komplicerat system, där de grundläggande funktionerna kan utökas med en stor variation av ytterligare paket. &kile; tillhandahåller en mängd olika typer av hjälp för att stödja användaren. + + + + + Latex-referens + Ett alfabetiskt index över de vanligaste kommandona i &latex;. + + + + Tex-dokumentation + &tetex; och &texlive; levereras med en enorm mängd dokument. Det omfattar dokumentation av alla paket som ingår och ytterligare referensdokumentation för &latex;. + + + + Latex + En fullständig referensdokumentation för &tex; och tillhörande program. Det är inte bara en beskrivning av alla program, utan vissa viktiga paket nämns också. Det omfattar också en fullständig referensmanual för &latex;-kommandon, ideal för att slå upp en viss typ av formatering medan ett dokument skrivs. Eftersom dokumentet verkligen är utförligt, delar &kile; upp det med tre viktiga bokmärken. + + + + Latex-kommando + Ett annat alfabetiskt index över de vanligaste kommandona i &latex;. + + + + Latex-ämne + En beskrivning av viktiga ämnen i &latex;. + + + + Latex-omgivning + Ett alfabetiskt index över de vanligaste omgivningarna i &latex;. + + + + + + + + + Sammanhangsberoende hjälp + + &kile; stöder också sammanhangsberoende hjälp, vilken anropas med &Ctrl;&Alt;H, K. I InställningarAnpassa Kile... Kile Hjälp kan du välja om du vill använda &kile;s &latex;-referens eller hjälpsystemet i &tetex; eller &texlive;, som är förvald inställning. + + + Punkter + + + + + + Punkter + + + + + + + + + Söka efter nyckelord + + Det är inte alltid lätt att hitta rätt dokument, eftersom &tetex; och &texlive; levereras med en enorm mängd dokument. Som en möjlig hjälp erbjuder &tetex; och &texlive; ett litet program: texdoctk. Det levereras med en databas över alla dokument, som &kile; använder för att erbjuda ett gränssnitt mot dem. + + + Punkter + + + + + + Punkter + + + + + Alla dokument är grupperade i olika kategorier, med den huvudsakliga fördelen är att du kan söka efter paketnamn eller nyckelord. &kile; visar därefter bara resultaten. + + + Punkter + + + + + + Punkter + + + + + Ett dubbelklick med musen, eller mellanslagstangenten, startar visning av dokumentet. Det kan vara ett godtyckligt dokument, inte bara DVI-, PS-, PDF- eller HTML-dokument. &kile; använder inställningarna i &konqueror; för att starta lämpligt visningsprogram. + + + + + + + Användardefinierad hjälp + + Förutom den statiska &tetex;- och &texlive;-dokumentationen, stöder &kile; också ett annat ändringsbart sätt för dokument med användarhjälp. I menyn Hjälp har &kile; en särskild undermeny Användarhjälp, där användaren kan lägga till dokument som han själv väljer. De kan vara de viktigaste dokumenten i &tetex;- och &texlive;-dokumentationen, eller till och med egenframställda dokument. Det är till och med möjligt att välja några webbadresser. + + Gå till InställningarAnpassa Kile... KileHjälp och välj knappen Anpassa för att ställa in menyn Användarhjälp. Du kan lägga till, ta bort eller navigera bland menyalternativ, och dessutom infoga avskiljare för att få en bättre struktur. + + Genom att klicka på knappen Lägg till visas en annan dialogruta, där du måste redigera menyalternativets namn, och välja motsvarande fil eller webbadress. Om du väljer en webbadress, startas &konqueror; och du måste kopiera den slutliga webbadressen. + + + Punkter + + + + + + Punkter + + + + + + + + + + + Tack till och licens + + &kile; är en användarvänlig &latex;/&tex;-källkodseditor med öppen källkod. Den kör på system med &kde;:s skrivbordsmiljö installerad. &kde; är tillgängligt för flera arkitekturer med Linux installerad. &kile; är också en del av Fink-projektet, vilket betyder att du också kan köra &kile; på en Mac med OS-X. + + Stort tack går till de som anstränger sig för att &kile;-projektet ska kunna fortsätta, och de många timmars bidrag som kommer från de som ger av sin tid för att utveckla verktyg som vi alla kan använda under GNU-licens. Aktuell information om bidragsgivare finns i dialogrutan Om &kile; från Hjälp-menyn. + + Bidrag bland annat från: Rob Lensen, Roland Schulz, Michael Margraf, Holger Danielsson + + Många tack till alla inblandade! +&underFDL; &underGPL; + + +&documentation.index; + + diff --git a/doc/sv/latex_example.png b/doc/sv/latex_example.png new file mode 100644 index 0000000..21732a8 Binary files /dev/null and b/doc/sv/latex_example.png differ diff --git a/doc/sv/quickpreview.png b/doc/sv/quickpreview.png new file mode 100644 index 0000000..d4f0fd7 Binary files /dev/null and b/doc/sv/quickpreview.png differ diff --git a/doc/sv/select.png b/doc/sv/select.png new file mode 100644 index 0000000..6e856e2 Binary files /dev/null and b/doc/sv/select.png differ diff --git a/doc/sv/snap_autocomplete.png b/doc/sv/snap_autocomplete.png new file mode 100644 index 0000000..3d06374 Binary files /dev/null and b/doc/sv/snap_autocomplete.png differ diff --git a/doc/sv/snap_compile_error.png b/doc/sv/snap_compile_error.png new file mode 100644 index 0000000..c6634be Binary files /dev/null and b/doc/sv/snap_compile_error.png differ diff --git a/doc/sv/snap_editusertag.png b/doc/sv/snap_editusertag.png new file mode 100644 index 0000000..b7b0168 Binary files /dev/null and b/doc/sv/snap_editusertag.png differ diff --git a/doc/sv/snap_encoding.png b/doc/sv/snap_encoding.png new file mode 100644 index 0000000..8a0457b Binary files /dev/null and b/doc/sv/snap_encoding.png differ diff --git a/doc/sv/snap_kdvi_settings.png b/doc/sv/snap_kdvi_settings.png new file mode 100644 index 0000000..07b5d5a Binary files /dev/null and b/doc/sv/snap_kdvi_settings.png differ diff --git a/doc/sv/snap_projectview.png b/doc/sv/snap_projectview.png new file mode 100644 index 0000000..6eefa1e Binary files /dev/null and b/doc/sv/snap_projectview.png differ diff --git a/doc/sv/snap_projectview_add.png b/doc/sv/snap_projectview_add.png new file mode 100644 index 0000000..7d9fa48 Binary files /dev/null and b/doc/sv/snap_projectview_add.png differ diff --git a/doc/sv/snap_ref_choose.png b/doc/sv/snap_ref_choose.png new file mode 100644 index 0000000..013fade Binary files /dev/null and b/doc/sv/snap_ref_choose.png differ diff --git a/doc/sv/snap_ref_select.png b/doc/sv/snap_ref_select.png new file mode 100644 index 0000000..f3b4bbd Binary files /dev/null and b/doc/sv/snap_ref_select.png differ diff --git a/doc/sv/snap_sidebarmenu.png b/doc/sv/snap_sidebarmenu.png new file mode 100644 index 0000000..c2ba24b Binary files /dev/null and b/doc/sv/snap_sidebarmenu.png differ diff --git a/doc/sv/snap_structview_label.png b/doc/sv/snap_structview_label.png new file mode 100644 index 0000000..a9f4573 Binary files /dev/null and b/doc/sv/snap_structview_label.png differ diff --git a/doc/sv/snap_usertag.png b/doc/sv/snap_usertag.png new file mode 100644 index 0000000..65bc495 Binary files /dev/null and b/doc/sv/snap_usertag.png differ diff --git a/doc/sv/texgroup.png b/doc/sv/texgroup.png new file mode 100644 index 0000000..d7bc71b Binary files /dev/null and b/doc/sv/texgroup.png differ