El manual del Kate

El manual del Kate

Lund, Anders

Rothberg, Seth

Haumann, Dominik

Hollingsworth, T.C.

Traductor: Antoni Bella
revisió Aplicacions 18.08 (22 d'abril de 2018)

El Kate és un editor de texts per a programadors pel KDE.

Aquest manual documenta la versió 18.08 del Kate


Sumari

1. Introducció
2. Els fonaments
Començant amb el Kate
Des del menú
Des de la línia d'ordres
Arrossegar i deixar
Treballant amb el Kate
Inici ràpid
Dreceres
Treballar amb el MDI del Kate
Vista general
L'àrea de l'editor
Usar les sessions
Obtenir ajuda
Amb el Kate
Amb els vostres fitxers de text
Articles sobre el Kate
3. Treballar amb l'editor Kate
4. Treballar amb els connectors
Connectors de l'aplicació Kate
Connector del navegador de traça inversa
Ús del connector del navegador de traça inversa
Configuració
Connector de construcció
Introducció
Ús del connector de construcció
Estructura del menú
Agraïments i reconeixements
Connector de tancament excepte/com
Introducció
Ús del connector de tancament excepte/com
Estructura del menú
Connector de CTags
Introducció
Configuració
Ús del connector de CTags
Estructura del menú
Connector de Vista prèvia del document
Introducció
Estructura del menú
Interfície
Connector del commutador de documents
Estructura del menú
Navegador del sistema de fitxers
Estructura del menú
Interfície
Configuració
La llista Documents
Introducció
Estructura del menú
Configuració
Connector de GDB
Introducció
Estructura del menú i de la barra d'eines
La vista del depurador
La pila de crides i locals
Agraïments i reconeixements
Connector de Lumen
Connector Obre les capçaleres
Ús del connector Obre les capçaleres
Estructura del menú
Connector de projecte
Introducció
Vista estructurada dels fitxers
Canviar de projecte
Cerca i substitueix en projectes
Compleció automàtica simple
Obre fitxers ràpidament
Implementació per a construir el projecte
Crear projectes
Projecte actual
El menú Projectes
El connector Compleció del codi per al Rust
Cercar i substituir
Introducció
Interfície
Estructura del menú
Retalls del Kate
Introducció
Estructura del menú
Plafó pels retalls
Ús dels retalls
Agraïments i reconeixements
Connector SQL
Introducció
Connectar a una base de dades
Executar les consultes
Navegar
Estructura del menú
Agraïments i reconeixements
Connector Visor de símbols
Ús del connector de tancament excepte/com
Estructura del menú
Configuració
Connector per a la vista d'eina del terminal
Estructura del menú
Configuració
Connector de filtre de text
Ús del connector Filtre de text
Estructura del menú
Validació XML
Estructura del menú
Agraïments i reconeixements
Compleció XML
Com usar-la
Característiques i limitacions
Estructura del menú
Agraïments i reconeixements
5. Eines d'edició avançades
6. Estendre el Kate
Introducció
Treballar amb el ressaltat de la sintaxi
Crear scripts amb JavaScript
Connectors (C++) de l'aplicació Kate
7. El mode d'entrada del Vi
8. Les entrades del menú
El menú Fitxer
El menú Edita
El menú Visualitza
El menú Punts
El menú Sessions
El menú Eines
Els menús Arranjament i Ajuda
9. Configuració del Kate
Vista general
El diàleg principal de configuració
La configuració de l'aplicació Kate
General
Sessions
Connectors
La configuració del component d'edició
Configuració amb variables de document
10. Crèdits i llicència
A. Expressions regulars
B. Instal·lació
Capítol 1. Introducció

Capítol 1. Introducció

Benvingut al Kate, un editor de text per a programadors pel KDE. Algunes de les moltes característiques del Kate inclouen el ressaltat configurable de la sintaxi per a llenguatges de programació des del C i C++ fins a l'HTML i els scripts de bash, l'habilitat de crear i mantenir projectes, una interfície de múltiples documents (MDI) i un emulador de terminal contingut en el mateix.

Però el Kate és molt més que un editor per a programadors. La seva capacitat d'obrir diversos fitxers simultàniament és ideal per editar molts fitxers de configuració d'UNIX®. Aquest document s'ha escrit amb el Kate.

Editant aquest manual...

Capítol 2. Els fonaments

Capítol 2. Els fonaments

Traductor: Antoni Bella

Si alguna vegada heu emprat un editor de text, no hauríeu de tenir cap problema en usar el Kate. En les següents dues seccions, Començant amb el Kate i en Treballant amb el Kate, es mostrarà tot el que necessiteu per a posar-vos en marxa ràpidament.

Començant amb el Kate

Podeu iniciar el Kate des del llançador d'aplicacions o des de la línia d'ordres.

Des del menú

Obriu el menú de programes del KDE fent clic a la icona del llançador d'aplicacions que hi ha a la barra d'eines a la part inferior esquerra de la vostra pantalla. En fer-ho apareixerà un menú. Moveu el cursor fins a l'element AplicacionsUtilitatsEditor de text avançat Kate del menú.

Des de la línia d'ordres

Podeu iniciar el Kate introduint el seu nom a la línia d'ordres. Si indiqueu un nom de fitxer, com a l'exemple de sota, s'obrirà o crearà aquest fitxer.

%kate fitxer.txt

Si disposeu d'una connexió activa, i de permís, podreu beneficiar-vos de la transparència a xarxa del KDE per obrir fitxers en Internet.

%kate ftp://ftp.kde.org/pub/kde/README

Per a canviar el directori pels fitxers temporals, el qual està establert per omissió a /tmp, establiu la variable d'entorn TMPDIR abans d'iniciar el Kate, p. ex.

%mkdir /tmp/kate -p && export TMPDIR=/tmp/kate && kate

Opcions de la línia d'ordres

El Kate accepta les següents opcions de la línia d'ordres:

kate --help

Llistarà les opcions disponibles a la mateixa línia d'ordres.

kate -s --start nom

Inicia el kate amb la sessió nom. Es crea una sessió si encara no existeix. Si existeix una instància del Kate per a la sessió especificada, els fitxers especificats seran carregats en aquesta instància.

kate -p --pid PID

Tan sols torna a usar una instància amb el PID especificat (ID del procés).

kate -e --encoding codificació URL

Usa la codificació especificada per al document.

kate -l --line línia URL

Es desplaça a la línia especificada després d'obrir el document.

kate -c --column columna URL

Es desplaça a la columna especificada després d'obrir el document.

kate -i --stdin

Llegeix el contingut del document des de l'entrada estàndard. És similar a l'opció - usada en molts programes de línia d'ordres, i permet redirigir la sortida de les ordres al Kate.

kate --startanon

Inicia el Kate amb una sessió anònima nova, implica l'argument -n.

kate -n --new

Força l'inici d'una nova instància del Kate (s'ignorarà si s'ha usat start i una altra instància del Kate ja té la sessió indicada oberta), forçada si no se li proporcionen paràmetres ni URL.

kate -b --block

Si s'està usant una instància del Kate en execució, la bloqueja fins que sortiu, si se li han proporcionat els URL a obrir.

Podeu utilitzar aquesta opció amb el Kate com a editor per a escriure missatges de confirmació per als sistemes de control de versions com Git o Subversion. Aquests sistemes esperen bloquejar l'editor fins que heu introduït el missatge, atès que a continuació obren el fitxer temporal, el qual resta buit si el kate torna immediatament a la crida.

Aquesta opció també és necessària amb KIO (l'entrada/sortida del KDE), si obriu un fitxer remot (que s'ha baixat a un de temporal) i l'heu de tornar a pujar, per a fer-ho, deseu-lo.

kate --tempfile

Quan s'utilitza, els fitxers especificats es tractaran com si fossin fitxers temporals i se suprimiran (si són fitxers locals i teniu els permisos suficients per a fer-ho) en tancar-la, llevat que s'hagin modificat una vegada oberts.

kate --desktopfile nom_fitxer

El nom del fitxer base de l'entrada de l'escriptori per aquesta aplicació.

Això és especialment útil per a aplicacions d'embolcall i aplicacions que en general tenen múltiples fitxers d'escriptori. D'aquesta manera, cada fitxer d'escriptori pot tenir la seva pròpia línia d'ordres per a l'entrada Exec.

kate --author

Llista als autors del Kate a la finestra de terminal.

kate -v --version

Llista la informació de la versió del Kate.

kate --license

Mostra informació sobre la llicència.

Arrossegar i deixar

El Kate utilitza el protocol arrossega i deixa del KDE. Els fitxers es poden arrossegar i deixar dins del Kate des de l'escriptori, el gestor de fitxers Dolphin o algun servidor remot de FTP obert en una de les finestres del Dolphin.

Treballant amb el Kate

Treballant amb el Kate

Inici ràpid mostrarà com canviar quatre simples opcions que permeten configurar algunes de les característiques més potents del Kate. Dreceres mostra algunes de les dreceres de teclat per omissió per aquells que no poden o no volen emprar un ratolí.

Inici ràpid

Aquesta secció descriu alguns dels elements en el menú Visualitza de manera que podreu configurar ràpidament el Kate perquè funcioni com voleu.

Quan inicieu el Kate per primera vegada veureu dues finestres amb fons blanc. Per sobre de les finestres hi ha una barra d'eines amb les icones usualment anomenades com de costum. I per sobre d'aquesta, una barra de menús.

A mà esquerra de la finestra es troba una barra lateral. Combina les finestres Documents i Navegador del sistema de fitxers. Canvieu entre les dues fent clic a sobre de les pestanyes a la part superior de la finestra.

Si heu iniciat el Kate amb un fitxer, la finestra de la dreta el mostrarà per a editar-lo i el Documents a la barra lateral en mostrarà el nom. Empreu la finestra Navegador del sistema de fitxers per a obrir els fitxers.

Podeu activar o desactivar totes les barres laterals de les finestres des del menú Visualitza+Vistes d'eina o utilitzeu la drecera Ctrl+Alt+Maj+F. Aquest menú deixa entreveure la potència i la flexibilitat del Kate.

A les Vistes d'eina tindreu una llista de tots els connectors activats. Feu clic a la casella de selecció situada davant de cada element o feu clic amb el botó esquerre del ratolí sobre els botons d'eina que hi ha a la barra lateral per alternar aquesta vista d'eina.

Dreceres

Moltes de les ordres a les tecles (dreceres de teclat) del Kate són configurables a través del menú Arranjament. Per omissió, el Kate observa les següents associacions de tecles.

F1

Ajuda

Maj+F1

Què és això?

Ctrl+N

Document nou

Ctrl+L

Desa-ho tot

Ctrl+O

Obre un document

Ctrl+Alt+O

Obertura ràpida

Ctrl+Maj+F

Mode de pantalla completa

Ctrl+Maj+,

Configura el Kate

Ctrl+W / Ctrl+Esc

Tanca

Ctrl+Q

Surt -tanca la còpia activa de l'editor-.

Ctrl+Alt+Maj+F

Mostra les barres laterals

Ctrl+Maj+T

Divideix horitzontalment

Ctrl+Maj+L

Divideix verticalment

F8

Vista dividida següent

Maj+F8 / Ctrl+Esc

Vista dividida anterior

Ctrl+Maj+R

Tanca la vista actual

Alt+Fletxa dreta

Pestanya següent

Alt+Fletxa esquerra

Pestanya anterior

A més, podeu utilitzar les dreceres proporcionades pel component KatePart i per qualsevol connector del Kate que hi hagi activat.

Treballar amb el MDI del Kate

Treballar amb el MDI del Kate

Vista general

Finestra, Vista, Document, Marc, Editor... Què signifiquen en la terminologia del Kate i com extreure'n el màxim rendiment? Aquest capítol explicarà tot això i algunes coses més.

La finestra principal

La finestra principal del Kate és una finestra d'aplicació estàndard del KDE, amb l'afegit de vistes d'eina que contenen barres laterals. Teniu una barra de menús amb tots els menús comuns i algun més, i una barra d'eines que proveeix accés a les ordres utilitzades amb més freqüència.

La part més important de la finestra és l'àrea d'edició, que per omissió mostra un únic component d'edició de text, en el qual podreu treballar amb els vostres documents.

L'habilitat d'acoblar de la finestra s'utilitza per a les finestres d'eines de qualsevol connector activat al diàleg de configuració.

Les vistes d'eina es poden situar en qualsevol barra lateral, per a moure una eina feu clic dret a sobre seu i seleccioneu-la des del menú del botó dret del ratolí

Una vista d'eina es pot marcar com a persistent en el menú del botó dret del ratolí per al seu botó en la barra lateral. La barra lateral pot contenir més eines alhora, de manera que mentre una eina sigui persistent es poden mostrar altres eines de manera simultània.

Si un connector té opcions de configuració, podreu emprar el primer element al menú contextual per obrir la pàgina corresponent en el diàleg de configuració del Kate.

L'àrea de l'editor

El Kate és capaç de tenir més d'un document obert alhora i també de dividir l'àrea d'edició en qualsevol nombre de marcs, de forma similar a com ho fan, per exemple, el Konqueror o el popular editor de texts emacs. D'aquesta manera podreu veure diversos documents alhora o fins i tot diverses sessions del mateix document, el qual és d'utilitat, per exemple, si el vostre document conté definicions al començament i a les que us aneu referint habitualment al llarg del text. O podeu veure el codi font d'un programa en un marc, mentre editeu el fitxer d'implementació en un altre.

Quan un document està disponible en més d'un editor, els canvis realitzats en un d'ells seran reflectits en els altres de forma immediata. Això inclou tant el canvi de text, com la seva selecció. Les operacions de cerca o de moviment del cursor, només es reflecteixen en l'editor actual.

En aquest moment no és possible tenir obertes diverses sessions d'un mateix document amb la intenció que els canvis que es produeixin en una no afectin les altres.

En dividir un editor en dos marcs, aquest es dividirà en dos marcs de la mateixa grandària i ambdós mostraran el document que s'està editant. El nou marc estarà a la part inferior (en el cas d'una divisió horitzontal) o a la part dreta (si la divisió és vertical). El nou marc obtindrà el focus, el qual es representa visualment per la barra del cursor parpellejant en el marc amb el focus.

Usar les sessions

Usar les sessions

Les sessions són la manera que el Kate permet mantenir més d'una llista de fitxers i configuracions de la IGU. Podeu tenir tantes sessions com vulgueu, i podeu utilitzar sessions amb nom o anònimes per als fitxers que tan sols vulgueu utilitzar una vegada. En aquests moments el Kate pot desar la llista de fitxers oberts, i la configuració de la finestra general en la sessió. En futures sessions del Kate s'afegiran més característiques que es desaran en les sessions. Amb la introducció de les sessions, el Kate també permet obrir qualsevol nombre d'instàncies de l'aplicació en comptes de tan sols una tal com solia fer en el comportament per omissió.

Les sessions estan suportades en tres àrees:

Quan s'inicia una nova sessió, es carrega la configuració de la IGU anomenada Sessió per omissió. Per a desar la configuració de la finestra com a sessió per omissió us caldrà desar la configuració de la finestra a la pàgina de configuració Sessions del diàleg de configuració, i a continuació carregar la sessió per omissió, podent configurar la finestra com vulgueu i desar la sessió una altra vegada.

Quan es carrega una sessió amb nom, el Kate mostrarà el nom de la sessió en el títol de la finestra, la qual tindrà la forma «Nom de la sessió: Nom del document o URL - Kate».

Quan els fitxers oberts a la línia d'ordres amb --start nom o si una sessió se selecciona utilitzant el selector de sessions, la sessió especificada abans que els fitxers especificats a la línia d'ordres. Per obrir fitxers des de la línia d'ordres en una sessió nova sense nom, configureu el kate per a iniciar una sessió nova per omissió dintre de la pàgina Sessions del diàleg de configuració, o utilitzeu -- start amb una cadena buida: ''.

Des del Kate 2.5.1 el PID de la instància actual s'exporta a la variable d'entorn KATE_PID. Quan obri fitxers des d'una terminal inclosa, el Kate seleccionarà automàticament la instància actual si no s'indica una altra cosa a la línia d'ordres.

Obtenir ajuda

Obtenir ajuda

Amb el Kate

Aquest manual

Ofereix documentació detallada sobre totes les ordres del menú, opcions de configuració, eines, diàlegs, connectors, etc. així com descripcions de la finestra del Kate, l'editor i diversos conceptes utilitzats en l'aplicació.

Per a veure aquest manual premeu F1 o utilitzeu el menú AjudaManual del Kate.

Què és aquesta ajuda

Què és això? Ofereix ajuda immediata amb els elements aïllats de les finestres gràfiques, tal com els botons o d'altres àrees de la finestra.

Intentem proveir ajuda del tipus «Què és això?» per a qualsevol element en què tingui sentit. Aquesta està disponible a través del diàleg de configuració i també a molts altres diàlegs.

Per emprar l'ajuda «Què és això?», premeu Maj+F1 o utilitzeu l'element AjudaQuè és això del menú per activar aquest mode. El cursor es transformarà en una fletxa amb un interrogant, i ara podreu fer clic en qualsevol element en la finestra per a llegir l'ajuda «Què és això?» per a aquest element, si és disponible.

Botons d'ajuda en els diàlegs

Alguns diàlegs tenen un botó Ajuda. Prement-lo s'iniciarà el KHelpCenter i aquest obrirà la documentació corresponent.

Amb els vostres fitxers de text

El Kate no proveeix (encara!) cap mitjà per a llegir documents relacionats amb la documentació. Depenent del fitxer que estigueu editant, podreu trobar ajuda en l'Emulador de terminal inclòs, a on podreu veure les pàgines del manual d'UNIX® o de la documentació info relacionades o per aquesta fi també podeu emprar el Konqueror.

Articles sobre el Kate

La pàgina principal del Kate proveeix alguns Articles i Com es fa amb informació més enllà de l'abast d'aquest manual.

Capítol 3. Treballar amb l'editor Kate

Capítol 3. Treballar amb l'editor Kate

Per obtenir informació sobre el bàsic de treballar amb el component d'edició subjacent del Kate, vegeu el capítol Treballar amb l'editor de la KatePart al manual de la KatePart.

Capítol 4. Treballar amb els connectors

Capítol 4. Treballar amb els connectors

Lund, Anders

Traductor: Antoni Bella

El Kate ofereix diversos connectors. Hi ha dos tipus d'aquests connectors: alguns estan escrits en C++ natiu, mentre que altres estan escrits en el llenguatge de programació Python. Hi ha diferències subtils en aquests, que es descriuen a continuació.

Podeu activar qualsevol tipus de connector en el diàleg de configuració, el qual també proveeix accés a les opcions de configuració addicionals per als connectors que ho requereixin.

Connectors de l'aplicació Kate

Els connectors del Kate són funcionalitats addicionals per a l'editor Kate. Poden afegir menús extres i dreceres, i estendre les característiques del Kate. Podeu instal·lar-ne tants com vulgueu, des del Kate. Obriu el diàleg de configuració del Kate amb ArranjamentConfigura el Kate.... Seleccioneu AplicacióConnectors per escollir els connectors que requeriu.

Els connectors d'aplicació disponibles són:

Connector del navegador de traça inversa

Connector del navegador de traça inversa

Ús del connector del navegador de traça inversa

Aquest connector és per a desenvolupadors i probablement de poca utilitat pels usuaris. Mostra una traça enrere pel «gdb» en una vista de llista en una vista d'eina del Kate. En fer clic sobre un element, s'obrirà el fitxer seleccionat i saltarà al número de línia correcta. Funciona per a traces enrere generades en la vostra pròpia màquina, si no que també funcionarà per a traces enrere d'altra gent, és a dir, amb /home/dummy/qt-copy/…/qwidget.cpp encara es trobarà en altres màquines. Perquè això funcioni, haureu d'indexar els directoris on es troba el codi font.

A vegades hi ha diversos fitxers amb el mateix nom, p. ex.

kdegraphics/okular/generators/dvi/config.h
kdepim-runtime/resources/gmail/saslplugin/config.h

Per escollir la millor opció, el connector escull les dues últimes parts de l'URL, en aquest cas, això seria

dvi/config.h
saslplugin/config.h

I després, generalment el connector troba el correcte.

Indexar el «master» i algunes branques, òbviament donarà lloc a un conflicte.

Configuració

A la pàgina de configuració, afegeix les carpetes que contenen el codi font.

Configura els camins a la vista d'eina Navegador de traça inversa

En fer clic a D'acord s'iniciarà la indexació. Un cop finalitzada, obriu la vista d'eina Navegador de traça inversa.

Ara podeu carregar una traça inversa des del porta-retalls (p. ex., fent clic a Copia al porta-retalls al DrKonqi) o des d'un fitxer.

Connector de construcció

Connector de construcció

Sultana, Salma

Hollingsworth, T.C.

Introducció

El connector de construcció permet executar accions com la construcció, neteja i compilació d'un projecte.

Ús del connector de construcció

El connector de construcció afegeix una vista d'eina Sortida de la construcció a la part inferior i un menú Construeix a la barra de menús. La vista d'eina es pot utilitzar per a configurar l'arranjament de l'objectiu a construir, mentre que el menú es pot utilitzar per dur a terme les accions de construcció, neteja i compilació.

La vista d'eina Sortida de la construcció disposa dues pestanyes:

  • Arranjament de l'objectiu

  • Sortida

La pestanya Arranjament de l'objectiu

La pestanya arranjament de l'objectiu es pot utilitzar per a configurar diversos objectius de construcció i definir conjunts d'objectius.

Per a canviar els noms o les ordres feu doble clic sobre les entrades de la taula i utilitzeu la llista desplegable per a seleccionar l'ajust de l'objectiu actiu. Utilitzeu la casella de selecció al davant de cada objectiu per a definir un valor per omissió.

Un conjunt d'objectius conté diverses opcions de configuració:

Directori de treball

Aquí podeu establir el camí cap al projecte. Deixar el camp buit per utilitzar el directori on es troba el document actual.

Construeix

Aquesta opció permet definir l'ordre per executar la construcció. Per omissió s'estableix a make.

Neteja

Aquesta opció permet definir l'ordre per executar la neteja. Per omissió s'estableix a make clean.

Configuració

Aquesta opció permet definir l'ordre per executar la configuració. Per omissió s'estableix a cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../.

A la part superior d'aquest connector hi ha una barra d'eines amb els següents botons:

Construeix l'objectiu seleccionat
Afegeix un objectiu de construcció nou
Crea un conjunt d'objectius de construcció nou
Copia l'ordre o el conjunt d'objectius
Elimina l'ordre actual o el conjunt d'objectius

La pestanya Sortida

La pestanya Sortida mostra la sortida de consola generada per l'última ordre.

Utilitzeu el control lliscant a la part superior per a mostrar o amagar les categories de la sortida:

Sortida completa, Sortida analitzada, Errors i avisos o Només els errors

Cada línia conté un missatge, el nom de fitxer i el número de línia si està disponible. En fer clic sobre l'error o l'avís se us indicarà el fitxer corresponent i es col·locarà el cursor sobre el número de línia corresponent.

Per navegar cap a l'error anterior, premeu Alt+Maj+Fletxa esquerra. Per navegar cap a l'error següent, premeu Alt+Maj+Fletxa dreta.

Estructura del menú

ConstrueixSelecciona l'objectiu

Selecciona des d'una llista d'objectius configurats per l'usuari.

ConstrueixConstrueix l'objectiu per defecte

Construeix l'objectiu definit per defecte en el conjunt actiu d'objectius.

ConstrueixConstrueix l'objectiu anterior

Canvia a l'objectiu configurat anteriorment per l'usuari.

ConstrueixAtura

Atura la construcció d'un objectiu.

ConstrueixError anterior (Ctrl+Alt+Fletxa esquerra)

Mou el cursor a la ubicació de l'anterior error en el document.

ConstrueixError següent (Ctrl+Alt+Fletxa dreta)

Mou el cursor a la ubicació del següent error en el document.

Agraïments i reconeixements

El connector construcció del Kate va ser escrit per en Kåre Särs.

Un agraïment especial al Google Code-in 2011, a la participant Salma Sultana per escriure gran part d'aquesta secció.

Connector de tancament excepte/com

Connector de tancament excepte/com

Introducció

Aquest connector permet tancar un grup de documents en funció de la seva extensió i el camí.

Ús del connector de tancament excepte/com

Suposeu que teniu aquests documents oberts al Kate:

/tmp/subfolder/test.h
/tmp/test.cpp
/tmp/test.txt

Llavors teniu les següents opcions per a tancar documents com es mostra a la captura de pantalla:

Utilitzeu la casella de selecció en l'últim element de la llista per activar o desactivar un diàleg de confirmació. L'opció seleccionada s'aplicarà en ambdues accions de tancar.

Estructura del menú

FitxerTanca excepte

Tanca tots els documents oberts, excepte aquells que coincideixin amb el camí o extensió de fitxer seleccionat en el submenú.

FitxerTanca com

Tanca tots els documents oberts que coincideixin amb el camí o extensió de fitxer seleccionat en el submenú.

Connector de CTags

Connector de CTags

Introducció

CTags genera un fitxer d'índex (o d'etiquetes) dels objectes del llenguatge trobats en els fitxers de codi font, permet que aquests elements estiguin ubicats de forma ràpida i fàcil utilitzant aquest connector al Kate.

Una etiqueta significa un objecte del llenguatge per a la qual hi ha disponible una entrada d'índex (o, si no, es crearà una entrada d'índex per a aquest objecte).

La generació d'etiquetes és acceptada amb aquests llenguatges de programació.

Configuració

El connector de CTags utilitza dos fitxers de bases de dades diferents per a l'índex.

A la pàgina de configuració de CTags a la configuració del Kate, podeu afegir o eliminar directoris que contenen el codi font i regenerar la base de dades de CTags comuna.

Índex comú

Configura la base de dades global de CTags

A la part inferior de la pàgina d'ajustaments podeu adaptar l'Ordre de CTags.

Per obtenir més informació sobre totes les opcions disponibles, si us plau, llegiu la pàgina man de CTags. Aquesta pàgina man està disponible al KHelpCenter i també podeu introduir l'URL man/:ctags directament al Konqueror

En fer clic a Actualitza s'iniciarà la indexació. Un cop finalitzada, es tancarà el diàleg.

Índex de la sessió

Per a configurar l'índex de la sessió, obriu la vista de CTags.

Objectius de l'índex

En aquesta pestanya podeu afegir o eliminar els directoris que contenen el codi font i regenerar manualment la base de dades específica de la sessió de CTags.

Base de dades
Configurant la base de dades per a la sessió de CTags

Seleccioneu un altre fitxer de base de dades de CTags, configureu l'ordre de CTags o torneu a l'ordre predeterminada.

Ús del connector de CTags

Situeu el cursor del ratolí sobre l'objecte del llenguatge com una funció, símbol, etc. que us interessa i després seleccioneu una de les accions en el Menú de CTags per saltar a la línia i al fitxer on es defineix o declara aquest objecte.

Per omissió, les accions al menú CTags no tenen dreceres assignades. Utilitzeu l'editor de dreceres de teclat per a configurar les vostres pròpies dreceres.

Alternativament, podeu utilitzar el camp de cerca a la pestanya Cerca de la vista de CTags.

En introduir caràcters en el camp de cerca s'iniciarà la cerca i mostrarà els noms dels objectes del llenguatge que coincideixen com funcions, classes, símbols, etc. juntament amb el tipus i nom de fitxer.

Seleccioneu un element a la llista per saltar a la línia corresponent al fitxer de codi font.

Estructura del menú

CTagsFes un pas enrere

Navega cap enrere en l'historial de l'última etiqueta visitada.

CTagsCerca el text actual

Obre la pestanya Cerca de la vista de CTags i mostra a la llista tots els objectes del llenguatge que concordin amb la selecció de text actual.

CTagsVés a la declaració

Si el cursor està en un objecte de definició, si cal, això obrirà el document que conté la declaració corresponent, activarà la seva vista i situarà el cursor al començament de la declaració.

CTagsVés a la definició

Si el cursor està en un objecte de declaració, si cal, això obrirà el document que conté la definició corresponent, activarà la seva vista i situarà el cursor al començament de la definició.

Connector de Vista prèvia del document

Connector de Vista prèvia del document

Introducció

El connector permet una vista prèvia en viu a la barra lateral del document de text actualment editat en el format final. De manera que quan editeu p. ex., un text de Markdown o una imatge SVG, el resultat serà immediatament visible al costat del text d'origen.

Per a la visualització, el connector utilitza el connector KParts, el qual està seleccionat com a preferit per al tipus MIME del document. Si no hi ha cap connector de KParts per a aquest tipus, no hi haurà cap visualització prèvia.

Per a canviar el connector preferit, obriu el mòdul Associacions de fitxer a l'Arranjament del sistema i editeu Ordre de preferència dels serveis a la pestanya Incrustat.

Taula 4.1. Alguns connectors disponibles del KParts

Tipus MIMEConnector del KParts
Text del MarkdownKMarkdownWebViewPart o OkularPart
Imatge SVGSVGPart
Fitxers UI de les QtKUIViewerPart
Fitxers de grafs DotKGraphviewerPart

Estructura del menú

VisualitzaVistes d'einaMostra la vista prèvia

Mostra o oculta la vista prèvia del document del Kate a la barra lateral.

Interfície

Els botons a la part superior de la finestra de vista prèvia proporcionen aquestes accions:

  • Bloqueja la vista prèvia en un document determinat. Si seleccioneu aquesta opció, assegurareu que si es canvia el focus a un altre document a la mateixa finestra del Kate, la vista prèvia no seguirà a aquest document, sinó que continuarà previsualitzant aquest document.

  • Habilita o inhabilita les actualitzacions de la vista prèvia per al contingut del document actual

  • Actualitzeu manualment la vista prèvia del contingut del document actual

  • Un menú desplegable amb accions del connector de KParts

Connector del commutador de documents

Connector del commutador de documents

Estructura del menú

VisualitzaVistes emprades per darrera vegada (Ctrl+Tab), VisualitzaVistes emprades per darrera vegada (a l'inrevés) (Ctrl+Maj+Tab)

Obre una llista amb els últims documents visualitzats:

Manteniu premudes les tecles Ctrl i Tab per avançar a través de la llista. A més, premeu la tecla Maj per invertir la direcció.

Manteniu premuda la drecera Ctrl+Tab i podeu utilitzar les tecles Fletxa amunt, Fletxa avall, Inici o Fi per a navegar per la llista. En prémer una tecla de caràcter se circularà consecutivament a través de tots els elements amb la primera coincidència de la llista. Si deixeu anar les tecles de drecera, la vista canviarà al document seleccionat a la llista.

Navegador del sistema de fitxers

Navegador del sistema de fitxers

El navegador del sistema de fitxers és un visor de carpetes, permet obrir fitxers d'una carpeta que es mostra en el marc actual.

Estructura del menú

VisualitzaVistes d'eina Mostra Navegador del sistema de fitxers

Mostra o oculta la presència del navegador del sistema de fitxers del Kate.

Interfície

De dalt a baix, el navegador del sistema de fitxers consta dels següents elements:

Una barra d'eines

Aquesta conté els botons d'eines per a la navegació estàndard:

Enrere

Fa que la vista de carpeta faci un cd a la carpeta que s'ha mostrat anteriorment en l'historial. Aquest botó està desactivat, si no hi ha un element anterior.

Endavant

Fa que la vista de carpeta faci un cd a la carpeta que s'ha mostrat seguidament en l'historial. Aquest botó està desactivat, si no hi ha un element següent.

Punts

Obre un submenú per a editar o afegir punts i afegir una nova carpeta de punts.

Carpeta de documents actual

Aquest botó farà que la vista de carpeta faci un cd a la carpeta del document actiu, si és possible. Aquest botó estarà desactivat, si el document actiu és un fitxer nou i sense desar, o resideix en una carpeta sobre la que no es pot decidir.

Opcions
Vista breu

Només mostra els noms de fitxer.

Vista detallada

Mostra el Nom, Data i Mida dels fitxers.

Vista en arbre

Com una vista breu, però les carpetes es poden expandir per veure'n el contingut.

Vista en arbre detallada

Això també permet que les carpetes s'expandeixin, però mostra les columnes addicionals disponibles a la vista detallada.

Mostra els fitxers ocults

Mostra els fitxers normalment ocults pel vostre sistema operatiu.

Sincronitza automàticament amb el document actual

Quan aquesta opció està habilitada, el navegador del sistema de fitxers automàticament farà cd a la carpeta del document obert actualment en l'àrea d'edició cada vegada que aquest canvia.

Una entrada de la ubicació

Mostra un camí de navegació cap a la carpeta oberta, similar al Dolphin. Podeu fer clic sobre una carpeta qualsevol per anar-hi, o fer clic sobre una de les fletxes a l'esquerra d'una carpeta per a seleccionar les carpetes de sota. També podeu seleccionar des de la llista de llocs fent clic sobre la icona de l'esquerra en el camí de navegació, el qual mostrarà una icona que representarà el lloc actual.

També podeu fer clic a la dreta del camí per a canviar a un quadre de text on podreu escriure el camí d'una carpeta per navegar. L'entrada de l'URL manté una llista dels camins que heu escrit. Per triar-ne un, utilitzeu el botó de fletxa a la dreta de l'entrada.

Suggeriment

L'entrada de l'URL disposa de compleció automàtica. El mètode de compleció es pot ajustar mitjançant el menú del botó dret del ratolí de l'entrada de text.

Una vista de carpeta

Aquesta és una vista de carpeta estàndard del KDE.

Una entrada de filtre

L'entrada de filtre permet introduir un filtre per als fitxers mostrats a la vista de carpeta. El filtre utilitza llenguatge estàndard, els patrons han d'estar separats per espais en blanc. Exemple: *.cpp *.h *.moc

Per a mostrar tots els fitxers, escriviu un asterisc *.

L'entrada de filtre desa els últims 10 filtres d'entrada entre les sessions. Per utilitzar-lo, premeu la fletxa a la dreta de l'entrada i seleccioneu la cadena de filtre desitjada. Podeu desactivar el filtre prement el botó Neteja el text a l'esquerra de la fletxa de compleció automàtica.

Configuració

Aquest connector es pot configurar a la pàgina Navegador del sistema de fitxers de la configuració del Kate.

Barra d'eines

Configura els botons de la barra d'eines del navegador del sistema de fitxers movent els que vulgueu activar cap a la llista Accions seleccionades, i el seu ordre utilitzant els botons de fletxa al costat de la llista.

La llista Documents

La llista Documents

Introducció

La llista Documents mostra una llista de tots els documents actualment oberts al Kate. Els fitxers modificats tindran una petita icona d'un disquet a la seva esquerra per indicar el seu estat.

A la part superior de la llista Documents hi ha una barra d'eines amb els següents botons:

Crea un document nou
Obre un document existent
Document anterior
Document següent
Desa el document actual
Desa el document actual sota un nom nou

Per omissió, la llista Documents apareix en el Mode en arbre, que mostra l'estructura de les carpetes envoltant tots els documents oberts. També està disponible el Mode de llista, que mostra una llista simple de tots els documents oberts. Podeu canviar els modes fent clic dret sobre la llista i seleccionant-ho des del menú Mode de vista.

Si s'obren dos o més fitxers amb el mateix nom (ubicats en diferents carpetes) en el Mode de llista, el nom del segon prendrà la forma «(2)» i així successivament. El consell d'eina per al fitxer mostrarà el seu nom complet incloent el camí, permetent-vos escollir el que vulgueu.

Per a mostrar un document en el marc actiu, feu clic al nom del document en la llista.

El menú contextual té algunes accions comunes al menú Fitxer.

A més, hi ha accions del gestor de fitxers per a reanomenar o suprimir el fitxer. Amb Copia el nom del fitxer podreu copiar el camí complet del document al porta-retalls.

Podeu ordenar la llista de diferents formes fent clic amb el botó dret en la llista i seleccionant la desitjada des del menú Ordena per. Les opcions són:

Nom del document

Llista els documents segons l'ordre alfabètic del seu nom.

Camí del document

Llista els documents segons l'ordre alfabètic del seu camí.

Ordre d'obertura

Llista els documents en l'ordre d'obertura.

La llista documents de forma predeterminada mostrarà el vostre historial ombrejant les entrades dels documents més recents amb un color de fons. Si el document fou editat, s'utilitzarà una combinació de colors. Els documents més recents tindran colors més intensos, de forma que pugueu trobar amb més facilitat els documents amb els que heu treballat. Aquesta característica es pot desactivar a la pàgina Documents del diàleg de configuració.

La localització per omissió de la llista Documents a la finestra del Kate es troba a l'esquerra de l'àrea d'edició.

Estructura del menú

VisualitzaDocument anterior (Alt+Fletxa amunt)

Obre el document mostrant-lo per sobre del document obert actualment a la llista Documents.

VisualitzaDocument següent (Alt+Fletxa avall)

Obre el document mostrant-lo per sota del document obert actualment a la llista Documents.

VisualitzaMostra els actius

Mostra el document obert a la llista Documents.

Configuració

Ombra del fons

Aquesta secció permet activar o desactivar la visualització de l'ombra del fons de la vostra activitat recent, i triar quins colors utilitzar si està activada.

Ordena per

Estableix la manera com s'ordenarà la llista Documents. Això també es pot configurar des del menú del botó dret del ratolí a la llista Documents.

Mode de vista

Ofereix dues opcions que afecten la visualització de la vista d'eina Documents. L'opció Vista en arbre mostrarà els documents en un arbre sota les carpetes on es trobin, mentre que l'opció Vista de llista mostrarà una llista plana dels documents.

Mostra el camí sencer

Quan la vista en arbre i aquesta opció estan activades, les entrades de carpeta mostrades a la vista d'eina Documents mostrarà el camí complet cap als fitxers de la carpeta, a més del nom de la carpeta. No té cap efecte a la vista de llista.

Connector de GDB

Connector de GDB

Gergov, Martin

Hollingsworth, T.C.

Introducció

El connector de GDB pel Kate proporciona un frontal senzill per al popular depurador de projectes de GNU.

Important

L'experiència prèvia amb GDB és molt recomanable. Per obtenir més informació sobre l'ús de GDB, visiteu el lloc web de GDB.

Podeu activar el connector de GDB a la secció Connectors per a la configuració del Kate.

Perquè el connector funcioni correctament, haureu de tenir un fitxer d'origen (de qualsevol tipus suportat per GDB) i un executable.

Suggeriment

Si compileu amb gcc/g++ és possible que vulgueu utilitzar l'argument de la línia d'ordres -ggdb.

Una vegada fets aquests preparatius, obriu el fitxer d'origen en el Kate, introduïu el camí cap a l'executable a la pestanya Arranjament de la vista d'eina Vista del depurador i seleccioneu DepuraInicia la depuració des del menú per a començar.

Estructura del menú i de la barra d'eines

Totes aquestes opcions estan disponibles en els menús del Kate, i moltes estan disponibles a la barra d'eines de depuració, així.

VisualitzaVista d'einaMostra Vista del depurador

Mostra una vista d'eina que conté la sortida de GDB, la línia d'ordres de GDB utilitzada, i altres ajustaments.

VisualitzaVista d'einaMostra Locals i pila

Mostra una llista de totes les variables actualment carregades, els seus valors i les traces enrere del GDB.

DepuraObjectius

Un submenú que conté una llista d'objectius (executables).

DepuraInicia la depuració

Inicia el GDB amb un objectiu.

DepuraMata/atura la depuració

Atura el GDB.

DepuraReinicia la depuració

Reinicia el GDB.

DepuraCommuta entre punt d'interrupció/interrupció

Estableix un punt d'interrupció a la ubicació actual del cursor.

DepuraAvança per dins

Executa la sentència present (la crida a la funció serà depurada).

DepuraPassa per sobre

Executa la sentència present (la crida a la funció no serà depurada).

DepuraAvança per fora

Reprèn l'execució fins que finalitza el programa que s'està executant.

DepuraMou el CP

Mou el comptador del programa (propera execució).

DepuraExecuta fins al cursor

Executa el programa fins que arriba a la posició actual del cursor.

DepuraContinua

Ignora qualsevol punt d'interrupció i executa el programa fins que acaba (amb èxit o no).

DepuraImprimeix el valor

Imprimeix el valor de la variable a la que el cursor està apuntant.

ArranjamentBarres d'eines mostradesConnector de GDB

Mostra la barra d'eines de depuració.

La vista del depurador

La vista d'eina Vista del depurador consisteix de diverses pestanyes:

Sortida del GDB

Conté la sortida del GDB i una línia d'ordres del GDB.

La pestanya Sortida.

La pestanya Sortida mostra la sortida des d'una sessió de depuració.

Arranjament
Executable

Camí cap a l'objectiu (executable) per a la depuració.

Directori de treball

El directori de treball actual que proporciona l'objectiu.

Arguments

Arguments passats al programa.

Mantén el focus

Mantén el focus a la línia d'ordres del GDB.

Redirigeix la E/S

Obre una nova pestanya E/S a la Vista del depurador on podreu veure la sortida i proveir entrades al programa en execució.

El diàleg d'arranjament

El diàleg Arranjament mostra la configuració d'una sessió de depuració.

ES

Conté una àrea que mostra la sortida del programa en execució i una línia d'ordres des d'on podeu proveir entrades a aquest.

La pestanya ES.

La pestanya ES mostra la sortida des d'una prova simple del programa.

La pila de crides i locals

La vista d'eina Pila de crides conté una llista amb format de traces inverses retornada per GDB.

La vista d'eina Pila de crides.

La vista d'eina Pila de crides del connector de GDB.

La vista d'eina Locals conté una llista de totes les variables actualment carregades i els seus valors corresponents.

La vista d'eina Locals.

La vista d'eina Locals del connector de GDB.

Agraïments i reconeixements

Un agraïment especial al Google Code-in 2011, al participant Martin Gergov per escriure gran part d'aquesta secció.

Connector de Lumen

Connector de Lumen

El Lumen és un connector que proporciona compleció del codi per al llenguatge de programació D. Només es tracta d'una connexió entre l'editor i el dimoni de compleció de D (un servidor que proporciona tota la informació) anomenat DCD. El connector actualment implementa les principals característiques del servidor de compleció: alimentar el servidor amb els fitxers importats, presentar la documentació i diversos tipus de compleció:

Importacions:

Compleció bàsica:

Compleció (funció sobrecarregada):

Consells per a les crides:

Per a fer funcionar Lumen heu d'instal·lar el DCD, utilitzant la informació proporcionada per la comunitat D.

Després d'instal·lar el DCD, editeu ~/.config/dcd/dcd.conf (creeu-lo si no existeix) i afegiu-hi un camí cap als vostres fitxers «include/import» de D, p. ex., /usr/include/dlang/dmd o /usr/include/d.

A més, el Lumen tractarà de llegir un .lumenconfig a cada carpeta pare del fitxer de codi font en D actualment obert i afegeix cada línia en aquest fitxer com el camí «include» al servidor de DCD. Afegeix totes les dependències del vostre projecte actual a aquest fitxer.

Ara inicieu el servidor de compleció amb dcd-server, activeu el connector de Lumen als vostres ajustaments i tindreu la compleció del codi per al llenguatge de programació D al Kate.

Connector Obre les capçaleres

Connector Obre les capçaleres

Ús del connector Obre les capçaleres

Durant l'edició de codi en C o C++, aquesta ordre canviarà entre un fitxer de capçalera i el seu corresponent fitxer en C/C++ o viceversa.

Per exemple, si esteu editant meva_classe.c, aquesta acció canviarà a meva_classe.h si aquest fitxer està disponible a la mateixa carpeta.

Funcionarà amb les parelles de les següents extensions del nom de fitxer:

Fitxers de capçalera: h, H, hh, hpp
Fitxers font: c, cpp, cc, cp, cxx

Estructura del menú

FitxerObre .h/.cpp/.c (F12)

Obre la capçalera corresponent o fitxers de codi font per al document actiu.

Connector de projecte

Connector de projecte

Introducció

La idea bàsica del connector Projecte és tenir una llista estructurada dels fitxers que pertanyen al projecte amb les següents propietats:

  1. Proporciona una vista estructurada dels fitxers

  2. Fa que sigui molt fàcil i ràpid obrir i canviar de projecte

  3. Implementa la cerca i substitució per a un projecte

  4. Proporciona una compleció automàtica simple

  5. Fa que sigui senzill obrir ràpidament fitxers en el projecte

  6. Implementa la construcció del projecte

Vista estructurada dels fitxers

Una vegada es carrega el connector Projecte a la pàgina de configuració del Kate, obriu un fitxer en un projecte i apareixerà una barra lateral que llistarà tots els projectes, així com els fitxers de projecte de la següent manera:

Com podeu veure, el projecte actualment actiu és el «Kate», i el seu contingut apareix a la vista en arbre. En fer clic sobre algun dels fitxers a la vista en arbre, aquest s'obrirà a l'editor. A més, proporciona un menú contextual amb el que podreu obrir els fitxers amb altres aplicacions, com per exemple un fitxer .ui amb el Qt Designer.

Podeu filtrar els elements escrivint parts del nom de fitxer que esteu cercant a la barra de cerca a la part inferior de la llista.

Canviar de projecte

La idea és que mai hàgiu d'obrir un projecte de forma manual, això encara no s'admet en absolut. Per tant, què passa si obriu un fitxer, el connector Projecte ràpidament escanejarà la carpeta i les seves carpetes pare per a un fitxer .kateproject. Si el troba, el projecte serà carregat automàticament.

D'altra banda, si obriu un altre document al Kate, que pertanyi a un altre projecte, el connector Projecte canviarà automàticament el projecte actual. Fent-ho de manera intuïtiva, sempre restarà actiu el projecte correcte. Per descomptat, també podeu canviar el projecte actiu en aquest moment utilitzant el quadre combinat.

Cerca i substitueix en projectes

El Kate té un connector Cerca i substitueix que apareix a la barra lateral inferior. Si es carrega un projecte, s'obrirà la barra lateral Cerca i substitueix, i canviarà al mode de cerca i substitueix al projecte actual:

Compleció automàtica simple

Amb el coneixement de tots els fitxers pertanyents a un projecte, el connector Projecte proporciona instal·lacions per a la compleció automàtica senzilla basada en CTags. Si s'obre un projecte inicialment, el CTags analitzarà tots els fitxers de projecte en un fil en segon pla i desarà la informació CTags a /tmp. Aquest fitxer s'utilitza per emplenar la finestra emergent de compleció automàtica al Kate.

Per contra, sense aquesta compleció automàtica, el Kate només serà capaç de mostrar els elements de compleció automàtica a partir de les paraules del fitxer actual. Pel que la compleció automàtica proporcionada pel connector Projecte és molt més potent.

Si no es troba CTags, una finestra emergent passiva advertirà sobre aquest problema. També és notable, que el fitxer CTags a /tmp es netejarà quan se surti del Kate, de manera que el connector no contaminarà cap carpeta amb fitxers no desitjats.

Obre fitxers ràpidament

Com fer clic als fitxers a la vista en arbre no és la manera més ràpida per obrir-los, El Kate proporciona un mecanisme ràpid d'obertura que podeu activar amb Ctrl+Alt+O. Obtindreu una llista com aquesta:

Podeu filtrar escrivint parts del nom de fitxer que esteu cercant, i també podeu navegar amb les tecles de fletxa i pàgina amunt/avall a través de la llista. Prémer Retorn activarà el fitxer seleccionat, mentre que Esc ocultarà la vista Obertura ràpida.

A més, l'obertura ràpida recordarà el fitxer anterior. De manera que quan canvieu a la vista d'obertura ràpida, el fitxer prèviament activat serà seleccionat automàticament i només haureu de prémer Retorn, el qual de vegades és molt útil.

Implementació per a construir el projecte

Una altra característica és tenir implementat el connector Construeix, el qual es configura correctament de forma automàtica.

Crear projectes

Carregar automàticament els projectes

El connector Projecte té una característica de càrrega automàtica. Podeu llegir la llista de fitxers des del sistema de control de versions. Amb aquesta finalitat, la càrrega automàtica per al sistema de control de versions respectiu necessita ser activada als ajustaments (activada per omissió):

Crear projectes manualment

Només haureu de crear un fitxer .kateproject a la carpeta arrel del projecte. Per exemple, el fitxer .kateproject del «Kate» es veu així:

{
  "name": "Kate"
, "files": [ { "git": 1 } ]
}

El contingut del fitxer s'escriu en la sintaxi JSON. El nom del projecte és «Kate», i els fitxers continguts s'han de llegir des de git.

També en comptes de git hi ha implementats el subversion a través de svn i el mercurial a través de hg. Si no voleu llegir des d'un sistema de control de versions, podeu dir-li que carregui els fitxers de forma recursiva des dels directoris com segueix:

{
  "name": "Kate"
, "files": [ { "directory": "kate", "filters": ["*.cpp", "*.h", "*.ui", "CMakeLists.txt", "Find*.cmake"], "recursive": 1 } ]
}

Aquí, les subcarpetes i filtres defineixen el que forma part del projecte. També podeu barrejar el control de versions i els fitxers basats en filtres.

Si voleu afegir implementació per al connector Construeix, podeu escriure un .kateproject com aquest:

{
  "name": "Kate"
, "files": [ { "git": 1 } ]
, "build": {
    "directory": "build"
  , "build": "make all"
  , "clean": "make clean"
  , "install": "make install"
  }
}

Projecte actual

Utilitzant ProjectesVés a (Alt+1) podeu obrir la vista Projecte actual a la part inferior de la finestra de l'editor amb quatre pestanyes:

Terminal

Un emulador de terminal començant a la carpeta arrel del projecte.

Índex del codi

En introduir caràcters a la barra de cerca s'iniciarà la cerca i mostrarà els noms coincidents de les funcions, classes, símbols, etc., juntament amb el tipus, nom de fitxer i número de línia.

Seleccioneu un element a la llista per saltar a la línia corresponent al fitxer de codi font.

Anàlisi del codi

Feu clic a Inicia l'anàlisi per a realitzar una anàlisi estàtica del codi per a C i C++ utilitzant el cppcheck i generar un informe que mostri el nom de fitxer, número de la línia, la severitat (estil, avís, etc.) i el problema trobat.

Seleccioneu un element a la llista per saltar a la línia corresponent al fitxer de codi font.

Notes

El text introduït en aquesta pestanya es desa al fitxer nom_del_projecte.kateproject.notes.

El menú Projectes

El menú Projectes permet canviar entre els projectes actualment oberts. És mostrat pel connector Projectes.

ProjectesEnrere (Ctrl+Alt+Fletxa esquerra)

Canvia al projecte anterior.

ProjectesEndavant (Ctrl+Alt+Fletxa dreta)

Canvia al projecte següent.

ProjectesVés a (Alt+1)

Obre la vista Projecte actual a la part inferior de la finestra de l'editor.

El connector Compleció del codi per al Rust

El connector Compleció del codi per al Rust

Aquest connector proporciona la compleció del codi per al llenguatge de programació Rust.

Una vegada hàgiu activat l'element per a la compleció del codi en Rust a la pàgina del connector, apareixerà una pàgina nova al vostre diàleg de configuració del Kate.

Edita una ordre per executar Racer, una utilitat destinada a proporcionar compleció del codi en Rust als editors.

També necessitareu codi font en Rust i haureu de proporcionar el camí cap a l'arbre de l'origen.

Mentre escriviu el codi, apareixerà una llista emergent amb els elements per a la compleció:

A més de finestres emergents per a la compleció del codi, el connector també instal·la una acció Vés a la definició al menú Edita i al menú contextual. També podeu configurar una drecera de teclat.

Aquesta acció obrirà el document que conté la definició, activarà la seva vista i situarà el cursor al començament de la definició.

Cercar i substituir

Cercar i substituir

Hollingsworth, T.C.

Introducció

El connector Cerca i substitueix del Kate permet fer cerques de text o amb expressions regulars en diferents fitxers a la vegada. Podeu cercar a tots els fitxers oberts, o a tots els fitxers en un directori, i de manera opcional els seus subdirectoris, o en tots els fitxers al projecte actual. Fins i tot es poden filtrar per nom de fitxer, per exemple, cercar només als fitxers que acabin amb una extensió de fitxer en particular.

Interfície

Consulta de la cerca

Les següents opcions estan sempre a la part superior de la vista d'eina cerca en fitxers:

Podeu tenir tantes cerques com vulgueu obrir alhora. Simplement feu clic al botó de pestanya nova a la part superior esquerra de la vista d'eina de cerca i s'obrirà una pestanya de resultats, de manera que podreu fer una altra cerca.

El botó a la cantonada superior dreta de la vista d'eina cerca en fitxers commutarà la meitat inferior de la vista d'eina entre veure les opcions addicionals per al mode cerca en carpeta i veure els resultats de la cerca.

Cerca

Aquí és on escriviu el que es vol trobar. Podeu introduir text estàndard, o una expressió regular si està activat.

Substitueix (quadre de text)

El text de substitució que s'afegirà al/s fitxer/s, en lloc del text al quadre de text Cerca.

Cerca

En acabar de configurar-ho tot, només haureu de prémer el botó Cerca per a realitzar la cerca. Podeu prémer la tecla Retorn en el quadre de text de consulta per a fer el mateix.

Substitueix

En acabar de configurar-ho tot, només haureu de prémer el botó Substitueix per a realitzar la substitució entre els quadres de text Cerca amb el que heu introduït a Substitueix. Podeu prémer la tecla Retorn en el quadre de text Substitueix per a fer el mateix.

Següent

Va a la següent coincidència de la vostra consulta de cerca, si és necessari alterna entre els fitxers.

Substitueix les verificades

El mateix que Substitueix, però només realitzarà les substitucions en els fitxers que es comproven en el plafó de sota.

Opcions de cerca en carpeta

Aquestes opcions que es mostren a sota, esmenten les opcions per a la consulta. Si en el seu lloc es mostren els resultats de cerca, premeu el botó per a mostrar-les.

Cerca a

Hi ha tres opcions. Seleccioneu Als fitxers oberts per cercar a tots els fitxers oberts actualment al Kate. Seleccioneu A la carpeta per cercar dins d'una carpeta i, opcionalment, les seves subcarpetes. Seleccioneu Al fitxer actual per a només cercar al fitxer actiu.

Si està carregat el connector Projectes, també podeu cercar en el Projecte actual o a Tots els projectes oberts.

Coincidència de majúscules

Restringeix els resultats de cerca a aquells que tenen la combinació exacta de majúscules i minúscules, com la vostra consulta de cerca.

Expressions regulars

Permet utilitzar expressions regulars en lloc de text simple com a consulta de cerca.

Expandeix els resultats

Mostra tots els resultats trobats en cada fitxer, en lloc de només una llista dels fitxers que contenen la consulta de cerca.

Carpeta

Podeu introduir el camí de la carpeta en la que voleu cercar. Per exemple, podeu introduir ~/development/kde/kate/ si voleu cercar al codi font del Kate. Aquesta opció només estarà disponible quan s'utilitzi el mode de Carpeta.

Diàleg d'obertura de fitxer

Premeu aquest botó per a localitzar la carpeta al navegador de carpetes de l'escriptori. Aquest botó només estarà disponible quan s'utilitzi el mode de Carpeta.

Premeu aquest botó per canviar Carpeta a la carpeta pare actualment seleccionada. Aquest botó només estarà disponible quan s'utilitzi el mode de Carpeta.

Aquest botó establirà l'entrada Carpeta a la carpeta on es troba el document actualment obert. Aquest botó només estarà disponible quan s'utilitzi el mode de Carpeta.

Filtre

Permet cercar només els noms de fitxer que coincideixen amb un patró en particular. Per exemple, per cercar només als fitxers escrits en C++, canvieu-la a *.cpp. Per cercar només als fitxers que comencin amb kate, canvieu-la a kate*. Podeu introduir diversos filtres separats amb una coma (,). Per utilitzar-ho per excloure fitxers de la cerca, afegiu un signe menys (-) a la llista. Aquesta opció només estarà disponible quan s'utilitzi el mode de Fitxers oberts.

Excloure

Al contrari de Filtre, aquest impedeix que el Kate cerqui als fitxers que coincideixin amb els patrons especificats. Com amb Filtre, podeu introduir diversos patrons separats per una coma (,). Aquesta opció només estarà disponible quan s'utilitzi el mode de Fitxers oberts.

Recursiu

Si aquesta opció està activada, el Kate també cercarà a totes les subcarpetes de la carpeta seleccionada. Aquesta opció només estarà disponible quan s'utilitzi el mode de Carpeta.

Inclou els ocults

Si aquesta opció està activada, el Kate també cercarà als fitxers o carpetes que normalment resten ocults/es pel vostre sistema operatiu. Aquesta opció només estarà disponible quan s'utilitzi el mode de Carpeta.

Segueix els enllaços simbòlics

El connector cerca en fitxers en general no segueix els enllaços simbòlics. Quan aquesta opció està activada, el connector els seguirà al seu lloc i cercarà dins dels fitxers o carpetes als que fan referència. Aquesta opció només estarà disponible quan s'utilitzi el mode de Carpeta.

Avís

És possible que els enllaços simbòlics facin referència a una carpeta que sigui la pare de la carpeta on se cerca, o a altres carpetes que continguin enllaços simbòlics a la seva carpeta pare. Si hi ha un enllaç a la carpeta on se cerca i aquesta opció està activada, el Kate seguirà l'enllaç de manera repetida (en bucle) i cercarà a la carpeta, de manera que la cerca mai es completarà.

Inclou els fitxers binaris

Si està activada, el Kate també cercarà a tots els fitxers que no aparenten ser fitxers de text.

Resultats de la cerca

Els resultats de la cerca es mostren a sota de les opcions de consulta. Si es mostren les opcions del mode cerca en carpeta, simplement premeu el botó per a mostrar-los. També es mostraran automàticament tan bon punt es realitzi una cerca.

Els resultats de cerca mostren una llista de fitxers que contenen el text que coincideix amb la consulta de cerca, seguit pel nombre de coincidències trobades en aquest fitxer.

Per a veure una llista de les coincidències en aquest fitxer, simplement feu clic a la fletxa d'expansió a l'esquerra del nom de fitxer. (Si heu seleccionat l'opció Expandeix els resultats, això ja es farà automàticament). Es mostrarà el número de línia per a cada coincidència, seguit pel contingut d'aquesta línia, amb la consulta de cerca indicada en negreta.

Per obrir el fitxer del vostre resultant de la cerca, simplement feu doble clic s'obre seu. Si cal, el Kate obrirà el fitxer. També podeu moure el cursor a la ubicació d'una coincidència en particular fent-hi doble clic en lloc del nom de fitxer.

Estructura del menú

EditaCerca en fitxers (Ctrl+Alt+E)

Llança una vista d'eina Cerca i substitueix.

EditaVés a la coincidència següent

Va a la següent coincidència en una cerca realitzada pel connector Cerca i substitueix.

EditaVés a la coincidència anterior

Va a la coincidència anterior en una cerca realitzada pel connector Cerca i substitueix.

VisualitzaVistes d'einaMostra Cerca i substitueix

Canvia la pantalla del Kate a l'eina Cerca i substitueix.

Retalls del Kate

Retalls del Kate

Gergov, Martin

Hollingsworth, T.C.

Introducció

El Retalls del Kate és un connector utilitzat per estalviar una mica de temps, afegint una implementació per als anomenats «retalls» (codi font reutilitzable, codi de màquina o text). El connector també és compatible amb la compleció del codi i JavaScript.

Estructura del menú

VisualitzaVistes d'einaMostra Retalls

Mostra el plafó de retalls, el qual conté tots els retalls en el vostre repositori que són per al tipus de fitxer actualment obert.

EinesCrea un retall

Crea un retall nou, el qual és un fragment reutilitzable de text que podeu inserir en qualsevol part de qualsevol document.

Plafó pels retalls

El plafó pels retalls del Kate.

El plafó pels retalls del Kate.

Al plafó hauríeu de veure una llista dels repositoris de retalls, juntament amb les opcions per crear el vostre, obtenir-los des d'Internet o carregar-los des d'un fitxer local. Cada repositori té una casella de selecció que es pot utilitzar per activar o desactivar. També hi ha botons per editar i eliminar els repositoris existents.

Carregar fitxers des del repositori de retalls

Podeu baixar repositoris de retalls des d'Internet. Simplement feu clic a Obtén retalls nous i s'obrirà una finestra amb una llista amb repositoris de retalls. Després de baixar el retall desitjat, assegureu-vos que l'heu activat.

Crear i editar els repositoris

Per a crear un repositori nou de retalls, feu clic a Afegeix un repositori. Ara s'hauria de mostrar un diàleg que demani pel nom del fitxer de retall, la llicència i l'autor. Després de triar les opcions desitjades, feu clic D'acord.

L'editor del repositori.

La interfície de l'editor del repositori.

L'editor pel repositori de retalls conté les següents opcions:

Nom

Apareix a la llista dels retalls a la vista d'eina i també se cercarà quan s'utilitzi la característica de compleció del codi.

Espai de nom

Prefix utilitzat durant l'ús de la compleció de codi.

Llicència

Selecciona la llicència pel vostre repositori de retalls.

Autors

Introduïu el/s nom/s de l'autor/s del fitxer de retall.

Tipus de fitxer

Seleccioneu el/s tipus de fitxer/s que voleu aplicar al repositori de retalls. Per omissió s'estableix a «» -es deixa buit-, de manera que el repositori ho aplicarà a tots els fitxers. Podeu canviar-ho a quelcom com C++, o seleccionar des d'una llista fent clic en els elements. Podeu especificar més d'un tipus de fitxer prement la tecla Maj mentre s'afegeixen els tipus.

Crear i editar els retalls

L'editor de retalls.

La interfície de l'editor de retalls.

Nom

El nom es mostrarà a la llista de compleció.

Drecera

En prémer aquesta drecera s'inserirà el retall en el document.

Retall

El text que heu retallat s'inserirà en el document.

Un retall pot contenir camps editables. Es poden alternar prement la tecla Tab. Es poden utilitzar les següents expressions en el text de la plantilla per a crear camps:

${nom_camp} crea un camp senzill i editable. Totes les ocurrències posteriors crearan camps que reflecteixin el contingut del primer durant l'edició.

${nom_camp=omissió} es pot utilitzar per especificar un valor per omissió per al camp. omissió pot ser qualsevol expressió en JavaScript.

Utilitzeu ${nom_camp=text} per especificar una cadena fixa com a valor per omissió.

${func(altre_camp_1, altra_camp_2, «...»)} ho podeu utilitzar per a crear un camp que avaluï una funció de JavaScript en cada edició i que conté el seu contingut. Vegeu la pestanya Scripts per a més informació.

${cursor} es pot utilitzar per a marcar la posició final del cursor després que tot s'hagi omplert.

Scripts

Funcions auxiliars en JavaScript per utilitzar en els vostres retalls.

Totes les funcions en JavaScript han de retornar el contingut que voleu situar a un camp de la plantilla com una cadena.

Les funcions es criden en un àmbit que conté el contingut de tots els camps editables de la plantilla com a variables locals. Per exemple, en un retall que conté ${camp}, hi haurà present una variable anomenada camp, que contindrà el contingut actualitzat del camp de la plantilla. Les variables o bé es poden utilitzar a la funció estàtica o passar com a arguments, mitjançant l'ús de la sintaxi ${func(camp)} o ${camp_2=func(camp)} a la cadena del retall.

Podeu utilitzar l'API per crear scripts del Kate per obtenir el text seleccionat, el text complet, el nom del fitxer i més utilitzant els mètodes apropiats dels objectes document i vista. Referiu-vos a la documentació de l'API per a la creació de scripts per obtenir més informació

Ús dels retalls

Accedint als retalls del Kate des d'una vista d'eina i una llista desplegable.

Seleccionant des d'una llista de retalls.

Podeu cridar als retalls de dues maneres:

  • Escollint el retall des de la vista d'eina.

  • Mentre escriviu, podeu prémer Ctrl+Espai, el qual mostrarà tots els retalls en una finestra convenient des de la qual podreu escollir. Aquesta combinació de tecles proporciona una funcionalitat similar a la compleció del codi.

Si el retall conté variables (a més de ${cursor}), el cursor passarà automàticament a la primera ocurrència d'una variable i esperarà perquè escriviu quelcom. En acabar, podeu prémer Tab per passar a la següent variable, i així successivament.

Agraïments i reconeixements

Els retalls del Kate han estat escrits per en Joseph Wenninger.

Un agraïment especial al Google Code-in 2011, al participant Martin Gergov per escriure gran part d'aquesta secció.

Connector SQL

Connector SQL

ORUÇ, Ömer

Hollingsworth, T.C.

Introducció

El llenguatge de consulta estructurada (Structured Query Language - SQL) és un llenguatge especialitzat per actualitzar, suprimir i demanar informació des de bases de dades.

El connector SQL del Kate us permet:

  • Crear una base de dades

  • Connectar a una base de dades existent

  • Inserir i suprimir dades des d'una base de dades

  • Executar consultes

  • Mostrar els resultats en una taula

Connectar a una base de dades

Seleccioneu Afegeix una connexió des del menú SQL o des de la barra d'eines, i llavors seleccioneu el controlador de bases de dades de les Qt que voleu utilitzar (incloses QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7 i QPSQL). Si no podeu veure el controlador desitjat, caldrà que l'instal·leu. A continuació, premeu Següent.

Si la base de dades seleccionada utilitza un fitxer, simplement indiqueu la ubicació de la base de dades i premeu el botó Següent. Si requereix connectar a un servidor, introduïu el nom del servidor, nom d'usuari i contrasenya, i qualsevol altra informació que aquest controlador en particular pugui requerir. A continuació, premeu Següent.

Finalment, doneu-li un nom a la vostra connexió, i premeu Acaba.

Executar les consultes

INSERT/DELETE/UPDATE

Podeu inserir, suprimir i actualitzar dades utilitzant el connector SQL just com ho faríeu des de la línia d'ordres o des d'un programa. Simplement cal introduir una consulta i prémer el botó Executa una consulta a la barra d'eines o utilitzar SQLExecuta una consulta (Ctrl+E).

Exemple 4.1. Algunes consultes d'exemple

INSERT
INSERT INTO nom_taula ("característica1", "característica2", "característica3", "característica4", "característica5")
VALUES ("valor1", "valor2", "valor3", "valor4", "valor5" )
DELETE
DELETE FROM nom_taula WHERE name = "text"
UPDATE
UPDATE nom_taula SET "característica1" = "text", "característica2" = "text", "característica3" = "text", "característica4" = "text", "característica5" = "text"

SELECT

Després d'executar una consulta SELECT, podeu veure els resultats com una taula que apareixerà a la vista d'eina Sortida de dades SQL a la part inferior del Kate, o com a text a la vista d'eina Sortida de text SQL. Si hi ha un error, es podrà veure a la sortida de text.

Exemple 4.2. Exemple de consulta SELECT

SELECT * FROM nom_taula

La vista d'eina Sortida de dades SQL disposa de diversos botons:

Redimensiona les columnes al contingut

Canvia la mida de les columnes per ajustar-les al seu contingut.

Redimensiona les files al contingut

Canvia la mida de les files per ajustar-les al seu contingut.

Copia

Selecciona tots els continguts de la taula i els copia al cau del porta-retalls.

Exporta

Exporta tots els continguts de la taula a un fitxer, al porta-retalls, o al document actual en el format de valors separats per comes.

Neteja

Ho elimina tot de la vista de taula.

Ara podeu canviar els colors mostrats en la taula a la secció SQL de ArranjamentConfigura el Kate.

Navegar

Podeu navegar per la base de dades utilitzant la vista d'eina Esquema de la base de dades del navegador a l'esquerra. La informació que mostra variarà en funció del controlador de base de dades que estigueu utilitzant.

Per actualitzar aquesta llista, feu clic dret a qualsevol lloc en la vista d'eina i seleccioneu Refresca. Per a generar una consulta sobre qualsevol entrada a la llista, feu clic sobre una entrada, seleccioneu Genera, i seleccioneu el tipus de consulta (SELECT, UPDATE, INSERT o DELETE) des del submenú que aparegui.

Estructura del menú

SQLAfegeix una connexió...

Afegeix una nova connexió utilitzant qualsevol controlador de base de dades.

SQLElimina la connexió

Elimina la connexió seleccionada.

SQLEdita la connexió...

Edita els ajustaments de la connexió actual.

Connexions

Totes les connexions de base de dades que heu creat s'enumeren entre els elements de menú Edita la connexió i Executa una consulta. Seleccioneu-ne una per executar consultes o fer-hi modificacions.

SQLExecuta una consulta (Ctrl+E)

Executa la vostra consulta.

Agraïments i reconeixements

El connector SQL va ser escrit per en Marco Mentasti.

Un agraïment especial al Google Code-in 2011, al participant Ömer Faruk ORUÇ per escriure gran part d'aquesta secció.

Connector Visor de símbols

Connector Visor de símbols

Ús del connector de tancament excepte/com

Permet als desenvolupadors veure els símbols (funcions, macros i estructures) des del codi font.

En fer clic, amb la informació analitzada es podrà explorar amb facilitat el codi.

De moment s'admeten els següents llenguatges:

C/C++, Java, Perl, PHP, Python, Ruby, XSLT, Tcl/Tk, Fortran

Llista de característiques:

Mode de llista/en arbre
Activa/desactiva l'ordenació
Mostra/oculta els paràmetres de les funcions
Desplega/plega l'arbre de carpetes
Actualitza automàticament els canvis en el document
Analitza el codi en base a l'entorn de treball per a ressaltat de la sintaxi dels Frameworks del KDE

Estructura del menú

VisualitzaVistes d'einaMostra Llista de símbols (Ctrl+\)

Mostra o oculta la presència de la llista de símbols del Kate per a mostrar les funcions, macros i estructures del codi font en el document actiu.

Configuració

Escull les opcions per omissió de l'analitzador

Connector per a la vista d'eina del terminal

Connector per a la vista d'eina del terminal

L'emulador de terminal incrustat és una còpia de l'aplicació de terminal Konsole del KDE, per a la vostra comoditat. Està disponible des de l'element VisualitzaVistes d'einaMostra Terminal del menú i n'obtindreu el focus quan es mostri. De forma addicional, si teniu activada l'opció Sincronitza automàticament el terminal amb el document actual quan sigui possible, aquesta farà que es canviï cap al directori del document actual en el cas d'existir o quan aquest canviï.

La seva localització per omissió a la finestra del Kate és a la part inferior, a sota de l'àrea d'edició.

Podeu configurar el Konsole emprant el seu menú en el botó dret del ratolí, per a més informació, vegeu el manual del Konsole.

L'emulador de terminal integrat és proporcionat pel connector Vista d'eina del terminal.

Estructura del menú

VisualitzaVistes d'einaMostra Terminal

Mostra o oculta la presència de l'emulador de terminal integrat.

Quan s'activa la primera vegada, es crearà el terminal.

Quan es mostra l'emulador de terminal, aquest obtindrà el focus, de manera que pugueu començar a introduir ordres immediatament. Si l'opció Sincronitza automàticament el terminal amb el document actual quan sigui possible està activada a la pàgina Terminal del diàleg principal de configuració, la sessió de l'intèrpret d'ordres se situarà en el directori del document actiu, si aquest és un fitxer local.

EinesCondueix al terminal

Envia el text seleccionat cap a l'emulador de terminal incrustat. No s'afegirà una línia nova després del text.

EinesSincronitza el terminal amb el document actual

Això farà que el terminal encastat faci cd al directori del document actiu.

Altrament podeu configurar el Kate per a mantenir sincronitzat sempre el terminal amb el document actual. Per a més informació, vegeu «Configuració».

Eines[Dóna el focus al/Treu el focus del] terminal

Canvia el focus des del document actual al terminal i viceversa.

Configuració

Podeu configurar el connector per a la vista d'eina Terminal a la pàgina Terminal del diàleg de configuració.

Hi ha disponibles les següents opcions:

Sincronitza automàticament el terminal amb el document actual quan sigui possible

Això causarà que el terminal incrustat canviï al directori del document actiu en iniciar-se i que quan se seleccioni un document nou doni el focus a aquest directori. Si no està activada, haureu de navegar pel vostre compte en el terminal.

Estableix la variable d'entorn EDITOR a «kate -b»

Estableix la variable d'entorn EDITOR de manera que els programes que s'executin en el terminal integrat, obrin automàticament un fitxer a l'editor, obrint-lo en el Kate en lloc de l'editor per omissió configurat en el vostre intèrpret d'ordres. No podreu seguir utilitzant el terminal fins que tanqueu el fitxer al Kate, de manera que el programa cridat és conscient que l'heu acabat d'editar.

Connector de filtre de text

Connector de filtre de text

Ús del connector Filtre de text

Podeu utilitzar aquest connector per executar ordres de la línia d'ordres. S'utilitzarà una selecció com a argument per a una ordre de l'intèrpret d'ordres, la sortida substituirà la selecció o la copiarà al porta-retalls.

Exemples:

  • less /etc/fstab - enganxa el contingut d'aquest fitxer o el copia al porta-retalls

  • wc - compta les línies, paraules i caràcters de la selecció i ho enganxa en el document, o ho copia al porta-retalls

  • sort - ordena les línies de la selecció i enganxa el resultat en el document, o el copia al porta-retalls

Estructura del menú

EinesFiltre de text (Ctrl+\)

Obre el diàleg Filtre de text:

Introduïu una ordre de l'intèrpret d'ordres al quadre combinat o seleccioneu una ordre anterior de l'historial.

Copia el resultat en lloc d'enganxar-lo

Copia el resultat al porta-retalls, deixant el document sense canvis.

Fusiona STDOUT i STDERR

Si està activada, es fusionarà la sortida de STDOUT i STDERR, i no s'informarà de cap error. En cas contrari, STDERR es mostrarà com un missatge passiu.

Validació XML

Validació XML

Naber, Daniel

Aquest connector comprova que els fitxers XML estiguin ben formats i que són vàlids.

Aquest connector comprova el fitxer actual. A la part inferior de la finestra principal del Kate apareixerà una llista d'avisos i errors. Podeu fer clic sobre un missatge d'error per a saltar al lloc corresponent en el fitxer. Si el fitxer té una «DOCTYPE», la DTD indicada amb aquest tipus de document serà utilitzada per a comprovar la validesa del fitxer. S'espera que la DTD estigui al lloc corresponent en el fitxer actual, p. ex. si el tipus de document fa referència a «DTD/xhtml1-transitional.dtd» i el fitxer és /home/pere/prova.xml, s'esperarà que la DTD es trobi a /home/pere/DTD/xhtml1-transitional.dtd. De tota manera, també es poden especificar DTD remotes a través d'http.

Si el fitxer no té un tipus de document (doctype), es comprovarà que estigui format correctament.

Per aprendre més sobre XML aneu a les pàgines oficials de l'XML del W3C.

Internament. aquest connector crida a l'ordre externa xmllint, la qual forma part de la biblioteca libxml2. Si aquesta ordre no està correctament instal·lada al vostre sistema, el connector no funcionarà.

Per a carregar aquest connector obriu el diàleg de configuració del Kate a ArranjamentConfigura el Kate.... A continuació, seleccioneu Validació XML que apareixerà a la secció Aplicació / Connectors i tanqueu el diàleg.

Estructura del menú

XMLValida l'XML

Aquest iniciarà la comprovació, tal com s'ha descrit.

Agraïments i reconeixements

Copyright del connector «Validació XML» del Kate, 2002 per en Naber, Daniel .

Copyright de la documentació, 2002 per en Naber, Daniel

Compleció XML

Compleció XML

Naber, Daniel

Aquest connector ofereix consells sobre el que està permès en una determinada posició en un fitxer XML, segons la DTD del fitxer. Es mostrarà una llista de possibles elements, atributs, valors d'atributs o entitats, en funció de la posició del cursor (p. ex., totes les entitats seran llistades si el caràcter a l'esquerra del cursor és «&»). També és possible tancar l'etiqueta d'obertura més propera a l'esquerra.

La DTD ha d'existir en format XML, presentada pel programa dtdparse de Perl. Cridarem una DTD en aquest format «meta DTD». Se subministren algunes meta DTD. Es troben instal·lades a katexmltools/ a qtpaths --paths GenericDataLocation, la qual també és la carpeta per omissió quan trieu Assigna la meta DTD.... Per a produir la vostra pròpia meta DTD, aconseguiu l'ordre dtdparse des de http://dtdparse.sourceforge.net.

Com usar-la

Inicieu el Kate i obriu el diàleg de configuració a ArranjamentConfigura el Kate.... A continuació, seleccioneu Compleció XML que apareix a la pàgina Aplicació/Connectors i tanqueu el diàleg. Després d'això, seleccioneu XMLAssigna la meta DTD.... Si el document no conté una «DOCTYPE» o el tipus de document és desconegut, haureu de triar una meta DTD des del sistema de fitxers. En cas contrari, la meta DTD que coincideixi amb el DOCTYPE del document actual serà carregada automàticament.

Ara podeu utilitzar el connector per escriure el vostre text:

< (menys que)

Donarà lloc a una llista de possibles elements menors al cursor que ja es troben dins d'una etiqueta. Tingueu en compte que actualment no es pot utilitzar per inserir l'element de nivell superior (p. ex., «<html>»).

</ (menys que + barra)

En introduir aquests caràcters se'ns ofereix tancar l'element actual (el més proper a un obert a l'esquerra del cursor). Premeu Retorn per a acceptar el suggeriment. A diferència de l'element Tanca l'element del menú, això només funciona amb una DTD assignada.

" (cometes dobles)

La clau de cotització activarà una llista de possibles valors de l'atribut (si n'hi ha) si es troba dins d'una etiqueta.

  (espai)

Aquesta clau activarà una llista de possibles atributs per a l'element actual si es troba dins d'una etiqueta.

& (ampersand)

Aquesta clau activarà una llista d'entitats amb nom.

Característiques i limitacions

Podeu provar totes les funcions i limitacions carregant les katexmltools/testcases.xml a qtpaths --paths GenericDataLocation en el Kate i seguint les instruccions.

Estructura del menú

XMLInsereix un element... (Ctrl+Retorn)

Obre un diàleg que permet inserir un element XML. Els caràcters <, > i l'etiqueta de tancament s'inseriran automàticament. Si heu seleccionat text quan aquest element de menú està seleccionat, el text seleccionat serà envoltat per l'etiqueta d'obertura i de tancament. El diàleg també ofereix la compleció de tots els elements que es poden inserir a la posició actual del cursor si s'ha assignat una meta DTD mitjançant l'ús d'Assigna la meta DTD....

XMLTanca l'element (Ctrl+<)

Cerca el text d'una etiqueta que encara no està tancada i la tancarà mitjançant la inserció de l'etiqueta de tancament corresponent. La cerca comença a la posició del cursor i va cap a l'esquerra. Si no pot trobar una etiqueta d'obertura no fa res.

XMLAssigna la meta DTD...

Li indicarà al connector quina meta DTD utilitzar per al document actual. Tingueu en compte que aquesta assignació no es desarà. Ho haureu de repetir en iniciar el Kate.

Agraïments i reconeixements

Copyright del connector «Compleció XML» del Kate, 2001, 2002 per en Naber, Daniel .

Copyright de la versió SC 4 del KDE, 2010 per en Tomáš Trnka

Copyright de la documentació, 2001, 2002 per en Naber, Daniel

Capítol 5. Eines d'edició avançades

Capítol 5. Eines d'edició avançades

Per obtenir informació sobre les eines d'edició avançades incloses amb el Kate, vegeu el capítol Eines d'edició avançades al manual de la KatePart.

Capítol 6. Estendre el Kate

Capítol 6. Estendre el Kate

Hollingsworth, T.C.

Traductor: Antoni Bella

Introducció

Igual que qualsevol editor de text avançat, el Kate ofereix una varietat de maneres d'estendre la seva funcionalitat. Podeu escriure scripts senzills per afegir funcionalitat amb JavaScript, o afegir encara més funcionalitat a l'editor amb els Connectors de l'aplicació Kate escrits en C++. Finalment, un cop estengueu el Kate, sereu benvingut a unir-vos amb nosaltres i compartir les vostres millores amb el món!

Treballar amb el ressaltat de la sintaxi

Treballar amb el ressaltat de la sintaxi

Per obtenir informació sobre com afegir o modificar les definicions de ressaltat de la sintaxi, vegeu la secció Treballar amb el ressaltat de la sintaxi al manual de la KatePart.

Crear scripts amb JavaScript

Crear scripts amb JavaScript

Per obtenir informació sobre com crear scripts amb JavaScript, vegeu la secció Crear scripts amb JavaScript al manual de la KatePart.

Connectors (C++) de l'aplicació Kate

Connectors (C++) de l'aplicació Kate

Els connectors de l'aplicació Kate estenen la funcionalitat del mateix editor Kate d'una manera com bo us podeu imaginar, utilitzant el mateix llenguatge de programació en què està escrit el Kate, C++.

Per començar, vegeu la Escrivint una guia d'aprenentatge per a connectors del Kate al lloc web del Kate.

Capítol 7. El mode d'entrada del Vi

Capítol 7. El mode d'entrada del Vi

Per obtenir informació sobre el mode d'entrada del VI pel Kate, vegeu el capítol Mode d'entrada del VI al manual de la KatePart.

Capítol 8. Les entrades del menú

Capítol 8. Les entrades del menú

El menú Fitxer

FitxerNou (Ctrl+N)

Aquesta ordre inicia un document nou a la finestra d'edició. A la llista Documents a l'esquerra del nou fitxer, aquest s'anomena Sense títol.

FitxerObre... (Ctrl+O)

Mostra un diàleg estàndard Obre fitxer de KDE. Utilitzeu la vista de fitxer per a seleccionar el que voleu obrir i feu clic a Obre per obrir-lo.

FitxerObre recent

Aquesta és una drecera per a obrir els últims documents desats. Fent clic sobre aquest element, s'obrirà una llista al costat del menú amb diversos fitxers desats recentment. Fent clic sobre un fitxer en concret, fareu que s'obri en aquesta aplicació -si el fitxer encara resideix en el mateix lloc-.

FitxerObre amb

Aquest submenú presenta una llista d'aplicacions conegudes per a manejar el tipus MIME del document actual. Activar una entrada obrirà el document actual amb aquesta aplicació.

A més, una entrada Altres... llança un diàleg que permet seleccionar una altra aplicació per obrir el fitxer actiu. El fitxer a més restarà obert al Kate.

FitxerDesa (Ctrl+S)

Desa el document actual. Si ja s'havia desat anteriorment aquest document, sobreescriurà l'anterior sense preguntar a l'usuari. Si és la primera vegada que es desa, apareixerà el diàleg (que es descriu tot seguit) desar com.

FitxerDesa com a... (Ctrl+Maj+S)

Permet que un document sigui desat amb un nom nou. Això es fa a través del diàleg de fitxers descrit anteriorment a la secció Obre d'aquest fitxer d'ajuda.

FitxerDesa amb la codificació...

Desa un document amb un nom de fitxer nou en una codificació diferent.

FitxerDesa una còpia com a...

Desa una còpia del document amb un nom de fitxer nou i continua editant el document original.

FitxerDesa-ho tot (Ctrl+L)

Aquesta ordre desa tots els fitxers modificats que es troben oberts.

FitxerRecarrega (F5)

Torna a carregar el fitxer actiu des del disc. Aquesta ordre és útil si un altre programa o procés ha canviat el fitxer mentre el teníeu obert en aquesta aplicació.

FitxerActualitza-ho tot

Torna a carregar tots els fitxers oberts.

FitxerImprimeix... (Ctrl+P)

Obre un senzill diàleg d'impressió que permet a l'usuari especificar què, a on i com imprimir.

FitxerExporta com a HTML...

Desa el document obert com un fitxer HTML, el qual serà formatat amb els ajustaments actuals pel ressaltat de la sintaxi i l'esquema de color.

FitxerTanca (Ctrl+W)

Aquesta ordre tanca el fitxer actiu. Si heu fet canvis que no han estat desats, se us demanarà desar el fitxer abans que el Kate el tanqui.

FitxerTanca els altres

Tanca els altres documents oberts.

FitxerTanca-ho tot

Aquesta ordre tanca tots els fitxers que tingueu oberts al Kate.

FitxerTanca els orfes

Tanca tots els documents de la llista de fitxers que no es poden tornar a obrir durant l'inici, perquè ja no són accessibles.

FitxerSurt (Ctrl+Q)

Aquesta ordre tanca el Kate i qualsevol fitxer que estiguéssiu editant. Si heu realitzat canvis en algun dels fitxers que estàveu editant i que encara no han estat desats, se us demanarà si els voleu desar.

El menú Edita

El menú Edita

EditaDesfés (Ctrl+Z)

Desfà l'última ordre d'edició (escriure, copiar, tallar, etc.)

Nota

Es poden desfer diverses ordres d'edició de forma simultània, com escriure caràcters.

EditaRefés (Ctrl+Maj+Z)

Revertirà els canvis més recents (si n'hi ha) realitzats emprant Desfés.

EditaRetalla (Ctrl+X)

Suprimeix la selecció actual i la col·loca en el porta-retalls. El porta-retalls funciona de forma transparent i proveeix una manera de transferir les dades entre aplicacions.

EditaCopia (Ctrl+C)

Copia el text seleccionat al porta-retalls de manera que es pugui enganxar on es vulgui. El porta-retalls funciona de manera transparent i proveeix una manera de transferir les dades entre les aplicacions.

EditaEnganxa (Ctrl+V)

Inserirà el primer element al porta-retalls a la posició del cursor. El porta-retalls funciona de manera transparent i proveeix una manera de transferir les dades entre les aplicacions.

Nota

Si Sobreescriure la selecció està activat, el text enganxat sobreescriurà la selecció, si n'hi ha.

EditaHistorial del porta-retalls

Aquest submenú mostra el començament de porcions de text recentment copiades al porta-retalls. Seleccioneu un element d'aquest menú per enganxar-lo al fitxer actualment obert.

EditaCopia com a HTML

Copia la selecció com a HTML, formatat utilitzant els ajustaments actuals pel ressaltat de la sintaxi i l'esquema de color.

EditaSelecciona-ho tot (Ctrl+A)

Selecciona tot el document. Això pot resultar molt útil per a copiar tot el fitxer a una altra aplicació.

EditaDesselecciona (Ctrl+Maj+A)

Desselecciona el text seleccionat a l'editor (si n'hi ha).

EditaMode de selecció per blocs (Ctrl+Maj+B)

Canvia el mode de selecció. Quan el mode de selecció sigui BLOC, la barra d'estat contindrà [BLOC] i podreu fer seleccions verticals, p. ex., seleccionar des de la columna 5 a la 10 en les línies 9 a la 15.

EditaModes d'entrada

Canvia entre una visió normal i com el vi, el mode d'edició. El mode d'entrada com el vi suporta les ordres més utilitzades i els moviments del mode normal i visual del vim i té una barra d'estat opcional per al mode vi. Aquesta barra d'estat mostra les ordres mentre s'estan introduint, la seva sortida i el mode actual. El comportament d'aquest mode es pot configurar a la secció Mode d'entrada del vi a la pàgina Edició del diàleg de configuració d'aquesta aplicació.

EditaMode sobreescriure (Inser)

Canvia entre els modes Insereix/Sobreescriu. Quan el mode és INS, inseriu els caràcters on està el cursor. Quan el mode és SOB, els caràcters escrits substituiran als caràcters actuals, si el cursor es col·loca abans de qualsevol caràcter. La barra d'estat mostra l'estat actual del Mode sobreescriure, ja sigui INS o SOB.

EditaCerca... (Ctrl+F)

Obre la barra de cerca incremental a la part inferior de la finestra de l'editor. Al costat esquerre de la barra hi ha un botó amb una icona per a tancar la barra, seguit d'un petit quadre de text per introduir el patró de cerca.

Quan comenceu a escriure caràcters del patró de cerca, aquesta s'iniciarà immediatament. Si hi ha una coincidència en el text, aquesta serà ressaltada i el color de fons del camp d'entrada canviarà a una llum verda. Si el patró de cerca no coincideix amb cap cadena en el text, això s'indicarà amb un color de fons de llum vermella en el camp d'entrada.

Utilitzeu els botons o per a saltar a la següent o anterior coincidència en el document.

Les coincidències en el document seran ressaltades, fins i tot quan tanqueu la barra de cerca. Per a netejar el ressaltat, premeu la tecla Esc.

Podeu decidir si la cerca ha de ser amb majúscules i minúscules. Seleccionant es limitarà la cerca d'entrades amb el cas (majúscules i minúscules) de cadascun dels caràcters en el patró de cerca.

Feu clic sobre el botó al costat dret de la barra de cerca incremental per a canviar entre la cerca i la substitució.

EditaCerca variantsCerca següent (F3)

Repeteix l'última operació de cerca, si n'hi ha cap, sense cridar la barra de cerca incremental, i cercant endavant pel document començant per la posició del cursor.

EditaCerca variantsCerca anterior (Maj+F3)

Repeteix l'última operació de cerca, si n'hi ha cap, sense cridar la barra de cerca incremental, i cercant pel document cap enrere en comptes de cap endavant.

EditaCerca variantsCerca la selecció (Ctrl+H)

Cerca la següent ocurrència del text seleccionat.

EditaCerca variantsCerca la selecció cap enrere (Ctrl+Maj+H)

Cerca l'ocurrència anterior del text seleccionat.

EditaSubstitueix... (Ctrl+R)

Obre la barra de cerca i substitueix. A la part inferior de la finestra de l'editor, al costat esquerre de la barra hi ha un botó amb una icona per a tancar la barra, seguit d'un petit quadre de text per introduir el patró de cerca.

Podeu controlar el mode de cerca seleccionant les opcions Text net, Paraules completes, Seqüències d'escapada o Expressió regular des de la llista desplegable.

Si s'ha marcat Seqüències d'escapada o Expressions regulars, l'element Afegeix del menú, al final del menú contextual dels quadres de text, podreu afegir elements d'expressions regulars a la cadena de cerca a partir d'una llista predefinida.

Utilitzeu els botons o per a saltar a la següent o anterior coincidència en el document.

Introduïu el text a substituir en el quadre de text Substitueix i feu clic al botó Substitueix per a substituir només el text seleccionat o el botó Substitueix-ho tot per a substituir el text de cerca en tot el document.

Podeu modificar el comportament de cerca i substitueix seleccionant les diferents opcions a la part inferior de la barra. Seleccionant es trobaran les entrades que coincideixin amb (majúscules o minúscules) cadascun dels caràcters en el patró de cerca. , només cercarà i substituirà dins de la selecció actual. El botó Cerca-ho tot ressaltarà totes les coincidències en el document i en mostrarà el nombre en una petita finestra emergent.

Feu clic al botó a la part dreta de la barra de cerca i substitueix per a veure la barra de cerca incremental.

EditaVés aMou al parèntesi que coincideixi (Ctrl+6)

Mou el cursor al parèntesi d'obertura o tancament associat.

EditaVés aSelecciona fins al parèntesi que coincideixi (Ctrl+Maj+6)

Selecciona el text entre els parèntesis d'obertura i de tancament associats.

EditaVés aMou a la línia modificada anterior

Les línies que s'han canviat des que es va obrir el fitxer s'anomenen línies modificades. Aquesta acció saltarà a la línia modificada anterior.

EditaVés aMou a la línia modificada següent

Les línies que s'han canviat des que es va obrir el fitxer s'anomenen línies modificades. Aquesta acció saltarà a la línia modificada següent.

EditaVés aVés a la línia... (Ctrl+G)

Obre la barra de línia «vés a» a la part inferior de la finestra que s'utilitza per tenir el salt del cursor a una línia en particular (especificada pel número) en el document. El número de la línia es pot introduir directament en el quadre de text o gràficament fent clic sobre les fletxes amunt i avall situades al costat del quadre de text. La fletxa cap amunt incrementarà el número de la línia i la fletxa cap avall la disminuirà. Tanqueu la barra amb un clic al botó amb una icona al costat esquerre de la barra.

El menú Visualitza

El menú Visualitza

VisualitzaFinestra nova

Obre una altra instància del Kate. La nova instància serà idèntica a la instància prèvia.

VisualitzaPestanya següent (Alt+Fletxa dreta)

Activa la següent pestanya de la barra de pestanyes.

VisualitzaPestanya anterior (Alt+Fletxa esquerra)

Activa la pestanya anterior de la barra de pestanyes.

VisualitzaObertura ràpida (Ctrl+Alt+O)

Mostra un camp de cerca i una llista dels fitxers oberts a l'àrea d'edició. En introduir text al camp de cerca els noms dels documents i els URL del document se cercaran per a text coincident. En introduir text al camp de cerca podreu utilitzar les tecles Fletxa amunt i Fletxa avall per a navegar a la vista de llista. Prement la tecla Retorn o fent doble clic sobre un element de la llista es canviarà la vista per al document seleccionat a la vista de llista. Això fa més fàcil el canvi entre documents, si n'hi ha una gran quantitat d'oberts.

Aquesta acció també està disponible emprant la icona a la part superior dreta de la finestra de l'editor.

VisualitzaDivideix la vistaVista dividida anterior (Maj+F8)

Dóna el focus a la vista de document anterior, si teniu dividida l'àrea d'edició en més vistes.

VisualitzaDivideix la vistaVista dividida següent (F8)

Dóna el focus a la vista de document següent, si teniu dividida l'àrea d'edició en més vistes.

VisualitzaDivideix la vistaDivideix en vertical (Ctrl+Maj+L)

Aquesta opció dividirà el marc (el qual pot ser l'àrea d'edició principal) en dos marcs de la mateixa mida, el nou a l'esquerra de l'actual. El nou marc serà l'actiu, i mostrarà el mateix document que l'antic.

Vegeu també Treballar amb el MDI del Kate.

EinesDivideix la vistaDivideix en horitzontal (Ctrl+Maj+T)

Divideix el marc actual (el qual pot ser l'àrea d'edició principal) en dos marcs de la mateixa mida, el nou a sota de l'actual. El nou marc obtindrà el focus, i mostrarà el mateix document que l'antic.

Vegeu també Treballar amb el MDI del Kate.

VisualitzaDivideix la vistaAlterna l'orientació

Canvia entre la divisió horitzontal i vertical.

VisualitzaDivideix la vistaTanca la vista actual (Ctrl+Maj+R)

Tanca el marc actiu, el qual es pot identificar perquè mostra un cursor parpellejant. Aquesta opció restarà desactivada si tan sols hi ha un marc (l'àrea d'edició principal).

En tancar un marc, mai es tancarà un document, si no que romandrà disponible en el menú Visualitza, així com a la llista de fitxers.

Vegeu també Treballar amb el MDI del Kate.

VisualitzaDivideix la vistaTanca les vistes inactives

Tanca tots els marcs excepte el marc actiu (el que té un cursor parpellejant). Aquesta opció restarà desactivada si tan sols hi ha un marc (l'àrea d'edició principal).

En tancar un marc, mai es tancarà un document, si no que romandrà disponible en el menú Visualitza, així com a la llista de fitxers.

VisualitzaDivideix la vistaOculta les vistes inactives

Oculta totes les vistes dividides, excepte l'actualment activa.

VisualitzaDivideix la vistaMou el divisor a l'esquerra

Quan està activada la vista dividida, això mourà la vora entre dos documents dividits en vertical una mica més cap a l'esquerra.

VisualitzaDivideix la vistaMou el divisor a la dreta

Quan està activada la vista dividida, això mourà la vora entre dos documents dividits en vertical una mica més cap a la dreta.

VisualitzaDivideix la vistaMou el divisor amunt

Quan està activada la vista dividida, això mourà la vora entre dos documents dividits en horitzontal una mica més cap amunt.

VisualitzaDivideix la vistaMou el divisor avall

Quan està activada la vista dividida, això mourà la vora entre dos documents dividits en horitzontal una mica més cap avall.

Nota

Algunes accions comunes al menú Visualitza Divideix la vista estan disponibles emprant el botó a la cantonada superior dreta de la finestra de l'editor

VisualitzaVistes d'eina
VisualitzaVistes d'einaMostra la barra lateral (Ctrl+Alt+Maj+F)

Mostra o oculta les files de botons de la barra lateral. Als estris de contingut de la barra lateral no els afecta aquesta ordre, qualsevol barra lateral que sigui visible romandrà visible, i també podeu assignar dreceres a aquestes ordres.

VisualitzaVistes d'einaMostra el connector

Una llista de tots els connectors activats. Utilitzeu la casella de selecció que hi ha al davant de cada element per canviar la visualització de la vista d'eina.

VisualitzaCanvia a la línia d'ordres (F7)

Aquesta ordre canvia la presentació de la línia d'ordres encastada.

VisualitzaAugmenta el tipus de lletra (Ctrl++)

Augmenta la mida del tipus de lletra a visualitzar.

VisualitzaMinva el tipus de lletra (Ctrl+-)

Minva la mida del tipus de lletra a visualitzar.

VisualitzaEsquema

Aquest menú llista els esquemes de color disponibles. Aquí el podeu canviar per a la vista actual. Per a canviar l'esquema per omissió necessitareu utilitzar la pàgina Tipus de lletra i colors del diàleg de configuració.

VisualitzaAjust de les paraulesAjust dinàmic de les paraules (F10)

Canvia l'ajust dinàmic de les paraules a la vista actual. L'ajust dinàmic de les paraules fa que tot el text es mostri a la vista visible sense necessitat de desplaçament horitzontal, visualitzant una línia real en més línies sempre que sigui necessari.

VisualitzaAjust de les paraulesIndicadors de l'ajust dinàmic de les paraules

Escull quan i com es mostraran els indicadors d'ajust dinàmic de les paraules. Tan sols estarà disponible si l'opció Ajust dinàmic de les paraules està marcada.

VisualitzaAjust de les paraulesMostra els marcadors per a l'ajust estàtic de les paraules

Mostra o oculta una línia vertical indicativa de la posició de l'ajust de les paraules tal com s'ha configurat al diàleg de configuració. Aquesta característica necessita que utilitzeu un tipus de lletra d'amplada fixa.

VisualitzaVoresMostra la vora per a les icones (F6)

Aquest element és un commutador. Si està marcat, farà visible una vora per a les icones al costat esquerre de l'editor actiu, i viceversa. La vora per a les icones indica les posicions de les línies marcades a l'editor.

VisualitzaVoresMostra els números de les línies (F11)

Aquest element és un commutador. Si està marcat, crearà un plafó al costat esquerre de l'editor actiu mostrant visibles els números de les línies del document, i viceversa.

VisualitzaVoresMostra les marques de la barra de desplaçament

Mostra i oculta la visualització dels punts (i altres marques) a la barra de desplaçament vertical. Quan està activada, les marques són representades per una línia fina en el color de la marca a la barra de desplaçament. Fent clic amb el botó mig del ratolí sobre la línia, es desplaçarà la vista a la posició més propera a la marca.

VisualitzaVoresMostra un mapa en miniatura a la barra de desplaçament

Substitueix a la barra de desplaçament amb una visualització del document actual. Per a més informació sobre el mapa en miniatura a la barra de desplaçament, vegeu la secció Mapa en miniatura a la barra de desplaçament al manual de la KatePart.

VisualitzaPlega el codi

Aquestes opcions pertanyen a Usar el plegat del codi:

Mostra els marcadors plegables (F9)

Mostra o oculta el plafó de marques de plegat a la part esquerra de la vista.

Contrau el node actual

Contrau la regió que conté el cursor.

Expandeix el node actual

Expandeix la regió que conté el cursor.

Contrau els nodes de nivell superior (Ctrl+Maj+-)

Contrau totes les regions al nivell superior en el document. Feu clic al triangle situat a la dreta per expandir totes les regions al nivell superior.

Expandeix els nodes de nivell superior (Ctrl+Maj++)

Expandeix totes les regions que hi ha al document.

Mostra els espais no imprimibles

Mostra/oculta el contenidor al voltant dels espais no imprimibles.

El menú Punts

El menú Punts

A sota de les entrades aquí descrites, hi haurà disponible una entrada per a cada punt en el document actiu. El text estarà format per les primeres paraules de la línia marcada. Escolliu un element per a moure el cursor cap al començament de la línia. L'editor es desplaçarà fins que la línia sigui visible.

PuntsDefineix un punt (Ctrl+B)

Estableix o elimina un punt a la línia actual del document actiu (si hi és, l'elimina, si no hi és, l'estableix).

PuntsNeteja tots els punts

Eliminarà tots els punts en el document així com la llista de punts situada a la part inferior d'aquest element de menú.

PuntsAnterior (Alt+Re Pàg)

Desplaçarà el cursor al començament de la línia anterior amb un punt. El text de l'element del menú inclourà el número de la línia i la primera part del text en aquesta. Aquest element tan sols estarà disponible quan hi hagi un punt en una línia per sobre del cursor.

PuntsSegüent (Alt+Av Pàg)

Desplaçarà el cursor al començament de la següent línia amb un punt. El text de l'element del menú inclourà el número de la línia i la primera part del text en aquesta. Aquest element tan sols estarà disponible quan hi hagi un punt en una línia per sota del cursor.

El menú Sessions

El menú Sessions

Aquest menú conté entrades per a l'ús i la gestió de les sessions al Kate. Per obtenir més informació, vegeu Usar les sessions.

SessionsNova

Crea una nova sessió buida. Tots els fitxers actualment oberts seran tancats.

SessionsObre una sessió...

Obre una sessió existent. Es mostrarà el diàleg per a la selecció de sessions per a deixar-vos escollir-ne una.

SessionsObre ràpidament una sessió

Aquest submenú permet obrir una sessió existent.

SessionsDesa la sessió

Desa la sessió actual. Si la sessió és anònima, se us demanarà un nom.

SessionsDesa la sessió com a...

Desa la sessió actual amb un nom nou. Se us demanarà el nom a usar.

SessionsGestiona les sessions...

Mostra el diàleg per a la Gestió de les sessions el qual permet reanomenar i suprimir les sessions.

El menú Eines

El menú Eines

EinesMode de només lectura

Estableix el document actual al mode de només lectura. Això evita que es pugui afegir text o canvis en el format del document.

EinesMode

Escolliu l'esquema de tipus de fitxer que preferiu per al document actiu. Aquest sobreescriurà el mode de tipus de fitxer establert globalment a ArranjamentConfigura el Kate... a la pestanya Tipus de fitxer, només per al document actual.

EinesRessaltat

Escolliu l'esquema de ressaltat que preferiu per al document actiu. Aquest sobreescriurà el mode de ressaltat establert globalment a ArranjamentConfigura l'editor..., només per al document actual.

EinesSagnat

Escolliu l'estil de sagnat que voleu per al vostre document actiu. Aquest sobreescriurà el mode de sagnat establert globalment a ArranjamentConfigura l'editor..., només per al document actual.

EinesCodificació

Podeu sobreescriure la codificació establerta per omissió a ArranjamentConfigura l'editor... a la pàgina Obre/Desa per establir una codificació diferent per al vostre document actual. La codificació aquí assignada només serà vàlida per al vostre document actual.

EinesFinal de línia

Escolliu el mode de final de línia preferit per al document actiu. Això sobreescriurà el mode de final de línia configurat globalment a ArranjamentConfigura l'editor... només per al vostre document actual.

EinesAfegeix una marca d'ordre de byte (BOM)

Seleccionant aquesta acció de forma explícita, podeu afegir una marca d'ordre de byte pels documents codificats amb Unicode. La marca d'ordre de byte (BOM) és un caràcter Unicode utilitzat per indicar l'ordre dels bytes en un fitxer de text o un flux, per obtenir més informació, vegeu La marca d'ordre de byte.

EinesScripts

Aquest submenú conté una llista de totes les accions dels scripts. La llista es pot modificar per escriure scripts propis. D'aquesta manera, el Kate es pot estendre amb les eines definides per l'usuari.

Hi ha una llista completa dels scripts a la documentació de la KatePart.

EinesInvoca la compleció del codi (Ctrl+Espai)

Invoca manualment la compleció d'ordres, utilitzant normalment una drecera limitada a aquesta acció.

EinesCompleció de paraules

Reutilitza la paraula de més avall (Ctrl+9) i Reutilitza la paraula de més amunt (Ctrl+8) completen el text escrit actualment mitjançant la cerca de paraules similars cap enrere o cap endavant des de la posició actual del cursor. Compleció d'ordres fa aparèixer un quadre de compleció amb les entrades coincidents.

EinesOrtografiaVerificació automàtica de l'ortografia (Ctrl+Maj+O)

Quan està activada, el text mal escrit és subratllat en el document sobre la marxa.

EinesOrtografiaOrtografia...

Això inicia el programa de correcció ortogràfica -un programa dissenyat per ajudar l'usuari a detectar i corregir els errors ortogràfics-.

Per obtenir més informació sobre com utilitzar el programa de correcció ortogràfica del KDE, vegeu la secció Comprovar l'ortografia a la documentació Fonaments del KDE.

EinesOrtografiaOrtografia (des del cursor)...

Això inicia el programa de correcció ortogràfica però començant a la posició actual del cursor en comptes des del començament del document.

EinesOrtografiaCorregeix la selecció...

Realitza la correcció ortogràfica en la selecció actual.

EinesOrtografiaCanvia el diccionari

Mostra una llista desplegable amb tots els diccionaris disponibles per a revisar l'ortografia a la part inferior de la finestra de l'editor. Això permet un canvi fàcil del diccionari de correcció ortogràfica, p. ex., per a la correcció ortogràfica automàtica de text en diferents idiomes.

EinesNeteja el sagnat

Neteja el sagnat per a la selecció actual o per a la línia en la que es trobi el cursor. Netejar el sagnat assegura que tot el text seleccionat segueixi el mode de sagnat que heu escollit.

EinesAlinea

Causa una realineació de la línia actual o de les línies seleccionades utilitzant el mode de sagnat i els ajustaments del sagnat en el document.

EinesComenta (Ctrl+D)

Afegeix un espai al començament de la línia en la que estigui el cursor de text o al començament del conjunt de qualsevol línia seleccionada.

EinesDescomenta (Ctrl+Maj+D)

Elimina un espai (si n'hi ha cap) del començament de la línia en la que estigui situat el cursor de text o des del començament del conjunt de qualsevol línia seleccionada.

EinesMajúscules (Ctrl+U)

Canvia el text seleccionat o la lletra després del cursor a majúscules.

EinesMinúscules (Ctrl+Maj+U)

Canvia el text seleccionat o la lletra després del cursor a minúscules.

EinesCapitalitza (Ctrl+Alt+U)

Capitalitza el text seleccionat o la paraula actual.

EinesUneix les línies (Ctrl+J)

Uneix les línies seleccionades, o la línia actual i la línia anterior amb un espai en blanc com a separació. Eliminarà els espais en blanc inicials/finals unint les línies pels extrems afectats.

EinesAplica l'ajust de les paraules

Aplica l'ajust estàtic de les línies en tot el document. Això vol dir que s'iniciarà automàticament una nova línia de text quan la línia excedeixi de la longitud especificada per l'opció Ajusta les paraules a: a la pestanya Edició a ArranjamentConfigura l'editor....

Els menús Arranjament i Ajuda

Els menús Arranjament i Ajuda

El Kate té la configuració comuna al KDE i els elements Arranjament i Ajuda del menú, per obtenir més informació llegiu les seccions sobre El menú Arranjament i El menú Ajuda dels fonaments del KDE amb dues entrades addicionals:

ArranjamentMostra les pestanyes

Les pestanyes són mòbils emprant el botó esquerre del ratolí i tenen accions en el menú contextual per tancar els documents, copiar el camí al porta-retalls o obrir la carpeta del document en el gestor de fitxers. Utilitzant el botó Obertura ràpida es facilitarà la commutació entre els documents. Feu clic al botó amb el botó esquerre del ratolí per obrir un menú amb les accions des del menú Visualitza Divideix la vista.

ArranjamentMostra el camí a la barra de títol

Si està activada, es mostrarà el camí complet del document actiu, en cas contrari només el nom del fitxer. És útil si editeu diversos fitxers amb el mateix nom, per a distingir-los.

Capítol 9. Configuració del Kate

Capítol 9. Configuració del Kate

Lund, Anders

Traductor: Antoni Bella

Vista general

El Kate ofereix algunes maneres de configurar l'aplicació perquè es comporti com es vol. Les més importants són:

El diàleg de configuració

La principal eina de configuració, permet configurar l'aplicació Kate, el component de l'edició i l'ús dels connectors.

El menú Arranjament

Permet canviar les opcions utilitzades molt sovint i llançar els diàlegs de configuració.

El menú Visualitza

Permet dividir el marc actual, així com mostrar les icones i el plafó amb els números de les línies per al document que s'està editant.

El terminal incrustat utilitza la configuració definida a Arranjament del sistema, i també es pot configurar fent clic del botó dret del ratolí per a mostrar un menú contextual.

El diàleg principal de configuració

El diàleg principal de configuració

El diàleg de configuració del Kate mostra un arbre de temes sobre la part esquerra, i una pàgina de configuració corresponent al tema seleccionat sobre la part dreta.

La configuració està dividida en dos grups, anomenats:

La configuració de l'aplicació Kate

La configuració de l'aplicació Kate

Aquest grup conté pàgines per a configurar l'aplicació principal del Kate

General

Aquesta secció conté unes poques opcions globals per al Kate

Comportament
Avisa quant a fitxers modificats per processos externs

Quan està activada, el Kate us avisarà quan aplicacions externes modifiquin els fitxers una vegada que rebin el focus. Podreu treballar amb diversos fitxers modificats a la vegada, podreu tornar a carregar, desar o descartar els fitxers canviats en grups.

Si no està activada, el Kate us demanarà què voleu fer quan es produeixi una modificació externa del fitxer i l'aplicació rebi el focus.

Meta-informació
Conserva la meta-informació de les sessions antigues

Quan està activada, el Kate desarà la meta-informació tal com punts i configuració de la sessió fins i tot quan tanqueu els vostres documents. Les dades s'utilitzaran si el document es torna a obrir sense canvis.

Suprimeix la meta-informació sense usar després de

Estableix el nombre màxim de dies per a mantenir la meta-informació dels fitxers prèviament oberts. Això us ajudarà a mantenir la base de dades de la meta-informació en una mida raonable.

Sessions

Aquesta secció conté les opcions relatives a l'ús de les sessions.

Elements de la sessió
Inclou la configuració de les finestres

Si està activada, el Kate desarà la configuració de la finestra amb cada sessió.

Comportament de l'aplicació en iniciar-se

Seleccioneu el comportament que voleu per al Kate durant l'inici. Aquesta configuració es pot canviar especificant què fer sobre la línia d'ordres.

Inicia una sessió nova

Amb aquesta opció, el Kate iniciarà una sessió nova sense nom quan inicieu l'aplicació.

Carrega l'última sessió usada

El Kate utilitzarà la sessió oberta més recentment a l'inici. Això és bo si voleu utilitzar sempre el mateix nom de sessió o canviar-lo en comptades ocasions.

Escull manualment una sessió

El Kate mostrarà un petit diàleg que us permetrà escollir la vostra sessió preferida, o desar la sessió per omissió si no n'hi ha desada cap. Aquest és el comportament per omissió. És adequat si utilitzeu sovint moltes sessions diferents.

Qualsevol canvi a les dades de la sessió (fitxers oberts i, si s'activa, la configuració de la finestra) sempre seran desats.

Connectors

Aquesta pàgina proveeix una llista dels connectors instal·lats per al Kate. Cada connector està representat pel seu nom i una petita descripció. Podeu marcar la casella de selecció d'un element per activar el connector que representa.

Si un connector proveeix opcions de configuració, apareixerà una secció d'aquesta pàgina per a poder-lo configurar.

Per a més informació sobre els connectors disponibles, vegeu Capítol 4, Treballar amb els connectors.

La configuració del component d'edició

Per obtenir informació sobre aquesta secció del diàleg de configuració, vegeu la secció Configuració del component d'edició al manual de la KatePart.

Configuració amb variables de document

Per obtenir informació completa sobre l'ús de les variables de document amb el Kate, vegeu la secció Configuració amb variables de document al manual de la KatePart.

Capítol 10. Crèdits i llicència

Capítol 10. Crèdits i llicència

Copyright del programa Kate, 2000, 2001, 2002-2005 per l'equip de desenvolupament del Kate.

L'equip del Kate:

Cullmann, Christoph

Administrador del projecte i principal desenvolupador

Lund, Anders

Principal desenvolupador, ressaltat de sintaxi de Perl, documentació

Wenninger, Joseph

Principal desenvolupador, ressaltat de sintaxi

Michael Bartl

Desenvolupador principal

Phlip

El compilador del projecte

Bastian, Waldo

El magnífic sistema de memòria cau

Matt Newell

Proves...

Michael McCallum

Desenvolupador principal

Jochen Wilhemly

Autor del KWrite

Koch, Michael

Port del KWrite a KParts

Gebauer, Christian

Sense especificar

Hausmann, Simon

Sense especificar

Glen Parker

Historial de desfer per a KWrite, integració de KSpell

Scott Manson

Suport del ressaltat de sintaxi XML de KWrite

Firebaugh, John

Diversos pedaços

Haumann, Dominik

Desenvolupador, Assistent de ressaltat

Moltes altres persones han contribuït:

Matteo Merli

Ressaltat per a fitxers d'especificació RPM (*.spec), diff i més

Rocky Scaletta

Ressaltat per a VHDL

Yury Lebedev

Ressaltat per a SQL

Chris Ross

Ressaltat per a Ferite

Nick Roux

Ressaltat per a ILERPG

Firebaugh, John

Ressaltat per a Java™ i molt més

Niehaus, Carsten

Ressaltat per a LaTeX

Per Wigren

Ressaltat per a Makefiles, Python

Jan Fritz

Ressaltat per a Python

Naber, Daniel

Petits pegats per a errors, connector XML

Copyright de la documentació, 2000, 2001 per en Rothberg, Seth

Copyright de la documentació, 2002, 2003, 2005 per en Lund, Anders

Traductor/Revisor de la documentació: Antoni Bella

Aquesta documentació està llicenciada sota els termes de la Llicència de Documentació Lliure de GNU.

Aquest programa està llicenciat sota els termes de la Llicència Pública General de GNU.

Apèndix A. Expressions regulars

Apèndix A. Expressions regulars

Per obtenir informació sobre l'ús de les expressions regulars al Kate, vegeu l'apèndix expressions regulars al manual de la KatePart.

Apèndix B. Instal·lació

Apèndix B. Instal·lació

Per aprendre com instal·lar el Kate i altres aplicacions del KDE al vostre sistema, vegeu el capítol Instal·lació a la documentació Fonaments del KDE.