Manual d'usuari de Quanta Plus
Dret de reproducció © 2002, 2003, 2004, 2005 L'equip de desenvolupament de Quanta Plus
Es concedeix permís per a copiar, distribuir i/o modificar aquest document sota els termes de la Llicència Lliure Pública de GNU, Versió 1.1 o qualsevol versió publicada posteriorment per la Free Software Foundation; amb seccions no variants, sense text a la portada i sense text a la contraportada. S'inclou una còpia d'aquesta llicència en la secció titulada "GNU Free Documentation License".
Quanta Plus és un IDE per a web que mira de ser neutral i transparent per a tots els llenguatges de marques, en admetre els llenguatges d'script populars basats en web, CSS i d'altres recomanacions del W3C® que van emergent.
Sumari
Índex d'exemples
Quanta Plus és una eina de desenvolupament web per a l'entorn d'escriptori K. Quanta Plus està dissenyat per al desenvolupament web i ràpidament s'està convertint en un editor madur i amb un gran nombre de característiques. El nostre següent objectiu és el de crear el millor entorn de desenvolupament web. Sabem que ens cal molta més gent en actiu per aconseguir-ho, així que estem bolcats en desenvolupar millores dirigides a facilitar als desenvolupadors web el personalitzar, estendre i millorar Quanta Plus. Aviat us demanarem als desenvolupadors web, que contribuïu amb les vostres característiques millorades. Les organitzarem de manera que els desenvolupadors web de Quanta Plus puguin trobar els recursos, extensions i connectors personalitzats que us calguin per a ser els desenvolupadors més professionals i fiables que hagi hagut. | ||
| --Eric Laffoon a http://quanta.sourceforge.net | ||
Mentre s'esforçaven en aconseguir el millor editor HTML, els desenvolupadors de Quanta Plus començaren a donar voltes a una idea intrigant: “I si Quanta Plus fos un editor genèric i extensible de llenguatges de marques?” Bé, doncs això tan sols seria possible amb el millor entorn de desenvolupament web per a KDE! Això és el que hem fet.
Sense les limitacions de l'HTML, Quanta Plus està ara en el bon camí per arribar a convertir-se en un entorn de desenvolupament web de propòsit general. Essencialment, si podeu definir-lo en XML, llavores Quanta Plus hauria de ser-vos útil com a IDE.
Ara, i desprès de l'explicació, s'ha de tenir en compte que Quanta Plus és un avenç dels esforços que s'estan duent a terme i que s'estan reunint en la comunitat de desenvolupament de KDE Quanta Plus, en commemoració del codi obert, usa la idea “Perquè escriure quelcom que algú ja ha escrit?” Gràcies a l'entorn de treball KDE, això no tan sols és possible, si no que també permet als nostres desenvolupadors i usuaris estendre Quanta Plus fins que compleixi cadascuna de les seves necessitats particulars.
Quanta Plus proveeix als desenvolupadors web d'una interfície de múltiples documents poderosa i intuitìva (MDI). Podeu incrementar exponencialment la seva productivitat. Mitjançant l'ús d'accions personalitzades, scripts i barres d'eines, podeu automatitzar gairebé qualsevol tasca. Amb l'ús de Kommander, podeu estendre Quanta Plus d'una forma en la que mai més haureu de tornar a recordar la sintaxi dels scripts per als comandaments. (Podeu trobar més informació quant a això en Capítol 7, Estendre el Quanta Plus).
Hi ha diversos conceptes clau en Quanta Plus. Per a comprendre'ls i aprofitar els avantatges de Quanta Plus, primer heu d'aprendre aquests conceptes, els fonaments. Aquest capítol us explicarà i us mostrarà aquests conceptes, sense els que Quanta Plus seria primitiu.
Quanta Plus divideix l'espai de treball en tres àmbits: Global, local i projecte. Aquestes distincions afecten a diversos components en Quanta Plus.
Els ítems globals estan disponibles per a tothom que usi Quanta Plus. Des de les barres d'eines fins les accions, tot el que està marcat com a global es desa en l'estructura comú de carpetes de Quanta Plus. Té l'efecte de permetre a un grup d'administradors desar certes barres d'eines, accions i plantilles en l'arbre global, que es pot usar, per tant, per a mantenir una instal·lació comú de Quanta Plus per a múltiples usuaris en el sistema.
Els ítems locals es componen de la col·lecció personal de recursos de desenvolupament web de l'usuari. Aquests ítems són plantilles i barres d'eines de l'usuari. Els ítems locals es desen en la carpeta de l'usuari. Això fa que tots els ítems locals de l'usuari tan sols estiguin disponibles per a ús personal.
Els ítems del projecte tan sols estan disponibles per a un projecte en particular. Poden ser qualsevol cosa, des d'una plantilla CSS fins a una barra d'eines amb accions personalitzades que realitzen alguna tasca específica sobre els fitxers del projecte. En essència, aquest és l'àmbit més limitat. Tots els ítems es desen en l'espai de treball del projecte, en l'arbre de carpetes d'aquest, permetent-vos compartir les vostres eines especialitzades i les vostres plantilles amb qualsevol amb qui compartiu el vostre projecte.
Quanta Plus edita el document que esteu llegint ara.
El MDI de Quanta Plus està dividit en diverses parts: La finestra de l'editor, els arbres d'informació ràpida, les pestanyes addicionals i les barres d'eines. Si us plau, per a més informació quant a aquestes parts consulteu “La finestra de l'editor”, “Les vistes d'eina”, “Les pestanyes informatives” i “Les barres d'eines”.
La finestra de l'editor de Quanta Plus.
La finestra de l'editor de Quanta Plus permet tenir oberts a la vegada múltiples fitxers. Quan tan sols hi ha un fitxer obert, el document ocupa la finestra de l'editor al complet. En quant s'obre el segon document, una petita quantitat de l'espai inferior de l'editor s'ocupa per a permetre que es mostrin les pestanyes amb els noms dels fitxers i una icona d'estat. La imatge de a sota mostra una icona de disquet junt al nom de fitxer, el que indica que el fitxer ha estat modificat i que s'ha de desar.
Podeu fer clic dret sobre les pestanyes per accedir a un menú de context amb opcions relatives al document actual, tals com tancar el document, tancar un altra document o tancar totes les pestanyes. També permet passar a d'altres pestanyes, tornar a carregar, eliminar o publicar el document, passar a una línia amb un marcador i realitzar operacions de CVS en el document actual.
Si feu clic dret en l'àrea de l'editor tindreu accés a un altra menú de context relacionat amb el contingut del document que esteu editant, tals com accions bàsiques d'edició (copia, talla i enganxa), editar l'etiqueta que estigui sota el cursor, seleccionar l'àrea coberta per l'etiqueta que hi ha sota el cursor, obtenir ajuda de context sobre la paraula que hi hagi sota el cursor o obrir un fitxer, si la cadena que hi ha sota el cursor apunta cap a un fitxer.
A la part superior de la finestra de l'editor es troba establerta la barra d'eines d'edició. Actualment, Quanta Plus per omissió està a HTML 4.01 Transitional, el qual te el joc per omissió de barres d'eines que es carreguen. A mesura que progresseu a Quanta Plus, les barres d'eines s'aniran actualitzant per acomodar-se a les necessitats dels usuaris i per a usar les noves característiques.
L'ús de la barra d'eines és força simple. Si voleu inserir una etiqueta bàsica com <p> en el vostre document, podeu fer clic sobre la icona que representa l'etiqueta. Ara podeu indicar les dades per a l'etiqueta que acabeu d'inserir. Si voleu inserir una etiqueta que requereix de certs atributs (tal com un ancoratge), se us mostrarà una caixa de diàleg amb els diversos camps que haureu d'omplir.
El diàleg de l'ancoratge (<a>).
Les vistes d'eina.
Les vistes d'eina o els arbres d'informació ràpida (QIT) us permeten navegar, obrir i obtenir informació en Quanta Plus. El seu format amb pestanya presenta els fitxers, el projecte, les plantilles, l'estructura del document, els scripts, els atributs i els arbres de documentació.
Explicació dels QIT
Aquí podeu navegar per tot el sistema de fitxers. Se us mostren dos arrels de nivell superior del sistema de fitxers. La primera es la vostra carpeta d'inici i la segona és la carpeta arrel del sistema de fitxers, /. Useu-les per a trobar els fitxers que estan en la vostra màquina i que voleu editar o afegir a un projecte actiu. En fer clic amb el botó del ratolí sobre un fitxer en aquesta vista se us mostren diverses opcions per a gestionar el fitxer seleccionat i també us permet inserir el fitxer en el projecte actiu, si n'hi ha cap, o alternar entre la vista en arbre i la de llista.
La gestió del projecte és una de les múltiples i poderoses eines que us ofereix Quanta Plus. Aquesta pestanya mostra tots els fitxers del vostre projecte i us permet gestionar els fitxers en aquest a cop de clic amb el botó del ratolí. Les accions tals com afegir, eliminar, publicar o eliminar per complet fitxers del disc es poden realitzar a través d'aquest menú .
Una altra característica de Quanta Plus és la de plantilles. Les plantilles poden ser qualsevol cosa que vulgueu. Imatges, retalls de codi, una pàgina web sencera, etc..
Les plantilles són ordenades en tres categories, basades a la seva vegada en àmbits i en el context en el que s'usen. Aquests àmbits deriven de l'espai de treball de Quanta Plus. Les plantilles globals es poden usar sempre, les plantilles locals tan sols les pot usar l'usuari actual i les plantilles de projecte tan sols es poden usar en el projecte indicat. Es pot trobar més informació sobre les plantilles en “Plantilles”.
Aquí trobareu informació sobre els diferents scripts que teniu a la vostra disposició. El concepte global, local i projecte també s'aplica aquí. En seleccionar les entrades amb el botó del ratolí tindreu accés a tota la informació disponible sobre l'script. I el clic amb el botó del ratolí us permetrà realitzar unes quantes accions tals com executar, editar i enviar per correu l'script, per exemple.
Aquesta pestanya mostra la representació interna de l'analitzador per al vostre document. En fer clic amb el botó del ratolí sobre un element, el cursor es desplaçarà fins la posició de l'element en el document. En fer clic amb el botó del ratolí sobre un element se us mostraran diverses accions que tracten sobre la navegació i l'actualització de l'arbre.
Aquest arbre apareix sota tots els altres QIT. En aquest podeu editar ràpidament els atributs i els espais de nom. L'entrada del sistema que te el focus de contingut us permet modificar tots els atributs disponibles amb uns quants clics de ratolí.
Arbre d'atributs
Aquí podeu trobar documentació completa sobre les tecnologies web que guien el vostre desenvolupament. Podeu descarregar la documentació empaquetada per a Quanta Plus en el lloc de la documentació de Quanta Plus, podeu crear la vostra pròpia documentació, i, si afegiu una carpeta anomenada "doc" a un projecte, podeu afegir, editar i veure la documentació específica del projecte.
Pestanyes informatives de Quanta Plus.
Per omissió, Quanta Plus te dues pestanyes localitzades a la part inferior de la finestra, des de les que podeu obtenir valuosa informació. Són la finestra de missatges i la de problemes.
Aquesta pestanya mostra informació dels scripts que s'executen en quanta. Per exemple, la DTD que s'usarà per al document actual i es mostrarà qualsevol canvi a la DTD.
Aquesta pestanya mostra qualsevol error en el marcat del document actual. Els scripts de Quanta Plus que executeu mostraran també en aquesta pestanya els missatges d'error (si es que n'hi han).
Les barres d'eines HTML de Quanta Plus.
Les barres d'eines de Quanta Plus s'estenen amb facilitat i són molt fàcils d'entendre. Feu clic sobre el botó i es realitzarà l'acció associada a aquest. L'interessant de les barres d'eines és que podeu definir gràficament les vostres pròpies accions amb Quanta Plus.
La gestió de barres d'eines amb Quanta Plus és fàcil. Seleccioneu el menú i disposareu de les opcions carrega, desa, afegeix, elimina i envia les barres d'eines per correu electrònic. Quan escolliu carregar una barra d'eines, podeu escollir entre algun dels tres espais de treball de Quanta Plus. En desar una barra d'eines que heu creat, la podeu desar en l'àmbit local o en l'àmbit del projecte. Si voleu fer que una barra d'eines nova estigui disponible en l'àmbit global, demaneu al vostre administrador que la posi en la carpeta global de Quanta Plus.
Una altra característica de Quanta Plus és la capacitat d'enviar les vostres barres d'eines per correu electrònic. Quanta Plus envia la barra d'eines com a un fitxer empaquetat amb tar i compremut amb gzip a través de KMail. Si rebeu en un correu electrònic una barra d'eines, podeu desar-la (i carregar-la) en Quanta Plus com a qualsevol altra barra d'eines.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Aquest capítol descriu les parts de Quanta Plus amb les que interactuareu en la majoria dels casos. No tan sols fan el vostre treball més productiu, si no que també us permeten personalitzar Quanta Plus.
Com ja s'ha mencionat, les barres d'eines de Quanta Plus es gestionen principalment des del menú . L'ús i la creació són quelcom diferents. La creació de barres d'eines es tracta en una secció anterior titulada “Crear barres d'eines.”
Usar barres d'eines és força simple. Quan feu clic sobre una icona per a un ítem o acció desitjada, pot succeir una d'aquestes tres possibilitats: L'element és inserit (opcionalment, amb un element de tanca); s'activa un diàleg d'element, permetent-vos omplir els atributs en un diàleg; o, per últim, s'activa una acció i fa quelcom amb ingeni sobre el fitxer o projecte actual. Si us trobeu fent quelcom avorrit o escrivint de forma redundant per a un element en particular, i el que esteu fent no està en Quanta Plus, el podeu afegir. Per a més informació “Paquet d'edició del tipus de document (DTEP)”.
Es poden configurar les barres d'eines i els elements usant el menú de context (clic dret sobre la barra d'eines), des d'on podeu crear una Acció nova, una Barra d'eines nova. Podeu realitzar d'altres accions, com Elimina barra d'eines, Renomena barra d'eines o Configura les barres d'eines, en aquest cas apareixerà un diàleg en el que podreu indicar quines accions han de ser visibles en aquesta i en les altres barres d'eines.
Si invoqueu el menú de context sobre una acció (icona) d'una barra d'eines, a més de les anteriors accions, podreu veure les entrades Elimina acció i Edita acció, que s'expliquen per sí mateixes.
Les barres d'eines i les accions que hi ha en aquestes es poden configurar usant les entrades de menú -> i ->.
Podeu llegir més quant a les accions definibles per l'usuari en “Accions definides per l'usuari”.
Un diàleg d'etiqueta com el següent:
Un diàleg d'etiqueta com a exemple.
La imatge de dalt és el diàleg de l'etiqueta ancoratge. Si coneixeu HTML/XHTML, us haureu donat compte de que estan disponibles tots els atributs d'un ítem d'ancoratge. Fixeu-vos en les pestanyes de dalt per a Principal, Nucli i i18n, Esdeveniments i Focus, llavores estan tots els atributs per a aquesta etiqueta, disposats segons el seu propòsit. Tot el que teniu que fer és omplir els espais buits per als atributs que voleu en l'ancoratge, ometre els atributs que no voleu i fer clic en Bé. Ara ja teniu un ancoratge ben format a la posició actual del cursor.
L'assistent de projectes de Quanta Plus (->) fa de la creació d'un projecte quelcom molt simple.
L'assistent de projectes.
Els camps són força simples i s'omplen millor de dalt cap avall, ja que en complimentar el nom del projecte us evitarà teclejar tota l'estructura de directoris per a la resta del projecte. Totes aquestes rutes i els camps d'informació quant a l'autor es configuren en aquest punt i més tard des de l'arbre de menús en -> (Majús.+F7).
Opcions generals del projecte
Aquí heu d'omplir el nom del projecte. Per exemple, anomenarem el nostre “foo.” Quan ompliu el Nom, s'omplirà de forma automàtica Fitxer.
Aquest és el nom de fitxer del projecte de Quanta Plus. Per omissió, és el nom del vostre projecte, però en minúscules i sense espais. Usa l'extensió webprj (p.ex., foo.webprj. Aquest fitxer es desa en la carpeta principal del projecte.
Aquí heu de seleccionar el protocol que usareu per accedir al projecte. Si el vostre projecte està en la mateixa màquina en la que esteu usant Quanta Plus, deixeu el valor a local. La llista de protocols que es mostra dependrà de la configuració del sistema. Entre els protocols disponibles estan SSH, FTP, NFS, SMB, WebDAV i d'altres. La potencia de l'arquitectura KIOSlave de KDE amplia les possibilitats de protocols en la llista. Aquest entorn permet que totes les aplicacions de KDE puguin accedir fàcilment tant a informació remota com local.
Aquí heu d'omplir l'adreça del servidor de la màquina a la que voleu accedir, a no ser que esteu treballant amb el protocol local. Aquí podeu posar tant el nombre d'una màquina (nom_maquina.exemple.com) o una adreça IP (127.0.0.1).
El nom d'usuari per accedir a la màquina remota. Sensible a majúscules.
La contrasenya per accedir a la màquina remota. Sensible a majúscules.
Deixeu buit aquest camp per a usar el port per omissió per al protocol que esteu usant. Segons la configuració del servidor, pot ser necessari que canvieu aquest valor.
És la carpeta arrel en la que es desaran tots els fitxers i carpetes del projecte.
Aquí és a on es desen les plantilles per a aquest projecte. És una ruta relativa al projecte i, per omissió, apunta cap a templates. Si teniu una serie de fitxers que useu en diversos projectes, us pot resultar útil fer que aquest camp apunti cap aquest lloc, en comptes de cap al per omissió.
Aquí és a on es desen les barres d'eines per a aquest projecte. És una ruta relativa al projecte i, per omissió, apunta cap a toolbars. Si teniu una serie de barres d'eines que useu en diversos projectes, us pot resultar útil fer que aquest camp apunti cap aquest lloc, en comptes de cap al per omissió.
Us permet afegir fitxers des del sistema de fitxers local. Podeu escollir diversos fitxers o carpetes al complet.
Aquesta opció és molt bona si teniu una web de contingut estàtic que voleu descarregar i modificar. Per a scripts al costat del servidor (p.ex. PHP, Python, etc..) haureu d'obtenir els fitxers d'una altra manera.
Insereix fitxers al projecte
Marqueu-lo si voleu incloure fitxers que estiguin en la ruta de la carpeta principal. Deixeu-lo sense marcar si esteu començant un projecte des de cero.
Si escolliu aquesta opció, tan sols inserirà al vostre projecte els fitxers amb marcat, scripts i imatges.
Si escolliu aquesta opció, se us mostraran tots els fitxers i carpetes de la carpeta principal i se us permetrà ser més específic en les vostres eleccions.
Mostra una llista amb els fitxers en la carpeta principal. Podeu escollir els fitxers que voleu per al vostre projecte, marcant-los (per incloure'ls) o manllevant-los la marca (per a excloure'ls).
Més opcions del projecte
Inseriu aquí el vostre nom (o àlies).
L'adreça a la que voleu que vagin dirigits els correus electrònics referents a aquest projecte.
Escolliu el llenguatge de marcat amb el que treballareu de mode més freqüent en aquest projecte.
Escolliu la codificació de caràcters amb la que voleu que s'obrin i es desin els fitxers del projecte.
Marqueu-lo per a usar vistes prèvies. Us permetrà definir els prefixos per a les rutes a quelcom més que sistemes de fitxers locals. És d'utilitat per a pàgines que tenen contingut dinàmic i que depenen del processament del servidor (com ara PHP, JSS, Python, etc.). Simplement, escriviu la primera part de l'adreça tal i com està en el servidor i Quanta Plus completarà el final de la ruta. Per exemple, si teniu el domini bar.com i esteu editant la pàgina index.html, el podeu editar en la màquina remota (foo.bar.com), publicar-lo en el servidor i prémer F6 per a veure el resultat de www.bar.com en comptes del sistema de fitxers local.
Introduïu aquí el prefix que voleu usar.
Això copia les plantilles globals en l'arbre de carpetes dels vostres projectes.
Això copia les plantilles locals en l'arbre de carpetes dels vostres projectes.
La última pantalla de l'assistent de projectes nous te 3 preferències que poden fer la vostra vida més fàcil. Aquestes preferències les podeu canviar des de l'arbre de menú -> en la pestanya "Perfils de publicació" o amb la drecera de teclat Majús.+F7.
El diàleg de propietats del projecte té aquest aspecte:
La pàgina d'opcions generals
Alguns dels ítems són els mateixos que en l'assistent de projectes, i es descriuen en “Projectes nous”. Els ítems extra es descriuen a continuació.
Opcions generals del projecte
Una llista de noms de fitxer (es poden usar jòquers) que seran ignorats de les operacions relatives al projecte, com .
Una opció complementaria a l'anterior, que indica excloure també del projecte els fitxers que estiguin llistats en el fitxer.cvsignore.
La vista que s'ha de carregar quan s'obri el projecte. Podeu llegir més quant a les vistes dels projectes en “Vistes del projecte”.
Seleccioneu el depurador que voleu usar. Actualment, tan sols funciona Gubed. Podeu trobar més informació sobre Gubed a http://gubed.sourceforge.net. El connector del depurador es pot configurar amb el botó Arranjament. Podeu llegir “Depuració en Quanta Plus” per a aprendre més quant a la depuració.
La vista que s'ha de carregar quan s'obri el projecte. Podeu llegir més quant a les vistes dels projectes en “Vistes del projecte”.
En la pàgina Perfils de publicació podeu configurar els perfils de publicació (més informació en “Perfils de publicació”), així com habilitar la mostra d'una vista en arbre amb el contingut del servidor per a cada perfil, marcant la caixa de selecció Mostra una vista en arbre per a cada perfil.
En la pàgina Configuració de l'equip podeu afegir, editar i eliminar membres del projecte, així com definir una llista de correu. Per a més detalls llegiu “Equip de desenvolupament”.
En la pàgina Configuració dels esdeveniments podeu Habilita les accions d'esdeveniments, afegir, modificar i eliminar aquestes accions. Les accions d'esdeveniment s'executen quan succeeix algun dels esdeveniments predefinits, com desar un fitxer. Per a més detalls consulteu “Accions d'esdeveniments”.
Per omissió, Quanta Plus obrirà l'últim projecte al que es va accedir l'última vegada que es va carregar. Per ara, no aquest comportament no és configurable.
Per a obrir un altra projecte, seleccioneu des del menú o la icona Obre projecte de la barra d'eines. Se us mostrarà el diàleg per a obrir projectes i podreu triar el projecte que voleu. La extensió dels projectes és webprj.
Al tancar Quanta Plus, es desarà automàticament el vostre fitxer de projecte. Se us demanarà que deseu qualsevol canvi abans de sortir si Quanta Plus detecta un canvi en qualsevol fitxer. Això mateix succeeix si es carrega un projecte nou.
La vista en arbre del projecte us ofereix un accés il·limitat als fitxers del vostre projecte. Aquí és a on gestioneu els fitxers del vostre projecte actual.
Amb els fitxers, un clic botó del ratolí fa aparèixer el següent menú:
Aquests ítems són auto-explicatius i es deixa al lector la part d'exploració.
Les carpetes són similars, però no tenen els ítems ni del menú botó del ratolí:
Aquests ítems també es deixen per a que el lector els explori.
El diàleg "Publica projecte":
El diàleg "Publica projecte".
Aquí es a on podeu escollir els diferents perfils. El perfil conté informació sobre a on s'han d'ubicar els fitxers que es publiquen. Per a més informació “Perfils de publicació”.
Aquest botó us permet crear nous perfils de publicació.
Us permet editar el perfil de publicació seleccionat en aquest moment.
Us permet eliminar el perfil actual. Si tan sols hi ha un perfil disponible, el botó és de color gris per a evitar que sigui eliminat.
La contrasenya es desa en memòria i es perd tan aviat com es tanca el programa. Aquesta opció és d'utilitat si publiqueu els fitxers amb freqüència i no voleu usar l'opció “Desa contrasenya al disc”, la qual és més insegura.
Selecciona tots els fitxers en el vostre projecte per a publicar-los.
Selecciona tots els fitxers modificats per a publicar-los.
Deselecciona tots els fitxers en la llista.
Selecciona/deselecciona tots els fitxers en la llista.
Expandeix totes les carpetes.
Contrau totes les carpetes.
Refresca la llista.
Inicia la publicació
Avortarà la vostra transferència en progrés o simplement sortirà del diàleg si canvieu d'idea abans de començar la publicació.
Amb Quanta Plus podeu definir múltiples perfils de publicació i, d'aquesta manera, publicar el vostre projecte (o parts del vostre projecte) en diferents servidors. Quan editeu o creeu un perfil, accedireu al següent diàleg:
Introduïu aquí el nom que voleu donar al perfil.
Aquest és el nom del servidor al que esteu copiant els fitxers. Es necessita un nom de domini plenament qualificat o una adreça IP.
Protocol de transferència a usar per a la publicació. Segons la versió de KDE, la llista pot ser diferent. En qualsevol cas, almenys heu de poder escollir FTP, file (és a dir, local) i NFS.
Port per a la transferència. Normalment, no l'haureu de canviar, a no ser que l'administrador de la vostra xarxa estigui allotjant un servei en un port diferent de l'estàndard.
Nom d'usuari per a l'autenticació.
Contrasenya per a l'autenticació.
Segons el vostre nivell de paranoia, aquesta característica us pot estalviar temps o ser un perill. Useu-la segons el vostre propi criteri. La contrasenya es desa en el disc com a text en un format opac, per a que no sigui tan simple accedir-hi. De tota manera, algú amb nocions de programació podria manllevar dita opacitat.
Aquesta és la ruta base en la màquina remota a la que aneu a copiar els fitxers.
Us permet marcar el perfil el perfil que s'està veient actualment com a per omissió.
Una vista del projecte no és més que un conjunt de fitxers i barres d'eines. Podeu tenir diverses vistes en un projecte, el qual vol dir que canviant la vista podeu carregar diversos fitxers i barres d'eines que substituiran als fitxers i barres d'eines oberts actualment.
Les vistes es poden desar, obrir o eliminar usant el menú o la Barra d'eines de projecte, als que podeu accedir mitjançant ->->.
Podeu tenir una vista per omissió (que es carregi quan s'obri el projecte). Més informació en “Configurar els projectes”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Les plantilles són bàsicament esquelets de documents, trossos de codi i fitxers als que enllaçar. Quanta Plus usa plantilles fonamentalment com a un sistema de fitxers estàndard amb una organització i interfície avançats. Les podeu copiar, moure o enllaçar amb qualsevol repositori que estigui actualment al vostre sistema en l'arbre de plantilles. Penseu en que les plantilles de Quanta Plus tenen les mateixes limitacions que les que podeu imaginar per al vostre sistema de fitxers.
Les plantilles existeixen en carpetes aniuades. No hi ha límit de profunditat en l'aniuament. De tota manera, Quanta Plus espera que en qualsevol carpeta indicada hi hagi una acció consistent per al tipus de plantilla base que es descriu a sota. A més, les plantilles per abans i després del text es poden concatenar amb plantilles de tipus que no siguin documents. Això facilita la creació d'etiquetes. La següent actualització seguit de la introducció està planificada per afegir la capacitat de passar variables al text, tal com informació sobre la mida de la imatge per a que assisteixi en la creació de l'etiqueta.
El nostre objectiu amb les plantilles és estendre-les per a que incloguin el “concepte” de múltiples fitxers, d'utilitat per a coses com posar un ordre o crear una secció "Quant a". De manera ideal, aquesta serà una eina per a fer més productiu i dinàmic el vostre treball. Un objectiu eventual és tenir un mode de disseny de plantilla estructural que tracti sobre la disposició i estructura del lloc amb el que podreu usar per a dissenyar i actualitzar de forma interactiva els vostres llocs. Si us voleu implicar, visiteu la nostra pàgina web en sol·licitud d'ajuda.
Algunes de les plantilles que es distribueixen amb Quanta Plus tenen condicions d'ús. Si us plau, llegiu amb cura les condicions d'ús, a la part superior de cada plantilla, abans d'usarla.
Quanta Plus admet diversos tipus de plantilla. Aquests són:
| Plantilles de binari |
| Plantilles de document |
| Retalls de text |
| Plantilles de lloc |
Els binaris són qualsevol cosa que no s'identifiqui com a text pur. Poden ser qualsevol tipus de fitxer que no sigui de text, com ara fitxers d'imatge, fitxers PDF, fitxers flash, etc. Les plantilles de binari es solen incloure en el document mitjançant enllaços (és a dir, com les imatges <img src=/src/url>). Hi ha alguns exemples en l'arbre de plantilles sota plantilles globals. Si us plau, per a més informació consulteu “Les vistes d'eina” sobre l'arbre Plantilles..
Els documents poden ser qualsevol tipus de document de text. Podeu crear documents nous segons aquestes plantilles. Generalment voldreu aniuar els documents més específics o diversos en subcarpetes. Aquí podeu construir el vostre propi entorn de treball bàsic, de manera que tingueu organitzat el vostre treball i pugueu augmentar el vostre rendiment i eficiència. Hi ha alguns exemples en l'arbre de plantilles que hi ha dintre de les plantilles globals. Si us plau, consulteu “Les vistes d'eina” per a més informació quant a l'arbre de Plantilles..
Aquest tipus de plantilla és d'utilitat quan no voleu crear un document nou basant-vos en una plantilla, si no que voleu inserir la mateixa àrea de text una i una altra vegada en els vostres documents. Pot contenir qualsevol cosa, des d'un comentari fins a un menú sencer que es gestioni amb mètodes de JavaScript o amb scripts de perl. Hi ha alguns exemples en l'arbre de plantilles que hi ha dins de les plantilles globals. Si us plau, consulteu “Les vistes d'eina” per a més informació quant a l'arbre de Plantilles.
Com el seu propi nom indica, són útils per a construir un lloc complet a partir d'una plantilla. Són una col·lecció de diversos documents que es poden organitzar en una estructura de directori, tot plegat compremut en un fitxer tar. En el moment d'escriure aquest manual no hi havia exemples de plantilles de lloc en Quanta Plus.
Les plantilles són accessibles en base al seu espai de treball establert en Quanta Plus
Creeu l'estructura de document que preferiu (XML, HTML, DocBook, etc.) i feu clic sobre ->->.
Una vegada fet, advertireu que (tot i que l'heu desat com a una plantilla del projecte), la plantilla no es mostra en la vista de pestanyes del projecte. Mireu en la vista de plantilla per a trobar la vostra plantilla en la pestanya de plantilles del projecte.
Seleccioneu quelcom de text en el vostre document i feu clic sobre ->->. Alternativament, podeu usar la característica d'arrossegar i deixar per arrossegar la selecció cap a la vista en arbre Plantilles.
La creació d'una plantilla de binari és molt simple: Simplement copieu el fitxer en una carpeta 'template'. Podeu usar les funcions estàndard de gestió de fitxers per a fer-ho, com arrossegar i deixar o copiar i enganxar des del Konqueror o des de l'Arbre de fitxers.
En les vistes en arbre l'Arbre de fitxers o dels Fitxers del projecte, feu clic dret sobre una carpeta i seleccioneu Crea plantilla de lloc, escolliu un nom per a la plantilla i deseu-la. Per omissió, s'intentarà desar en la carpeta 'template' del projecte, però, per descomptat, també podeu escollir desar-la com a una plantilla local o global.
Les plantilles de projecte us permeten centrar-vos millor. Podeu crear capçaleres, peus o passar al dinamisme amb els fitxers include de PHP i enllaçar-los. A més, hi ha algunes coses del més útils que hem de tenir molt en compte quan s'usen plantilles en els projectes.
Al crear un projecte, podeu optar per copiar al vostre projecte local totes les plantilles globals i d'usuari existents. Els projectes heretats tenen per omissió la capacitat d'usar plantilles, així que no heu perdut res. Podeu triar a on localitzar els vostres fitxers de plantilla per a que puguin estar en l'arrel del vostre servidor i poder-los publicar amb facilitat o poder fer-los més segurs enllaçant-los per sota de l'arrel del vostre servidor, un bon truc. Quan enllaceu amb fitxers que no estan en les plantilles del projecte, se us demanarà si s'ha de copiar el fitxer a les plantilles del projecte en comptes d'enllaçar-lo. Això evitarà els enllaços no vàlids a l'hora de la publicació. Sempre tindreu el control de a on ubicar les vostres plantilles, per a que podeu escollir a on moure-les. De tota manera, Quanta Plus no en seguirà la pista si cal canviar els enllaços.
La estructura de plantilles de la pestanya de plantilles es basa en els fitxers que es troben en $ i KDEDIR/share/apps/quanta/templates$. En cadascuna d'aquestes carpetes s'especifica un d'aquests quatre tipus de contenidor, tal i com s'ha explicat a dalt.. HOME/.kde/share/apps/quanta/templates
Per a definir el comportament de cada carpeta, feu clic amb el botó del ratolí en la vista de plantilla de la carpeta i escolliu. Apareixerà el següent diàleg:
Diàleg de propietats.
La llista desplegable amb els tres tipus s'ha tractat anteriorment; fitxers, text, plantilles. Aquesta caixa s'obscurirà si heu marcat la caixa Hereta atribut pare.
<foo>)Per omissió està marcat i és adequat per a totes les carpetes de nivell superior en l'arbre de plantilles. Si la carpeta de nivell superior el té marcat, bàsicament es desactivaran les plantilles per a aquesta carpeta i per a totes aquelles que estiguin per sota d'aquestes i no s'hagi definit explícitament. Si no és una carpeta de nivell superior, <blah> dirà quelcom com Retall de text. Si no diu res, llavores és perquè esteu en una carpeta de nivell superior.
Habilita el text pre i post per a les plantilles en aquesta carpeta. Podria tractar-se d'una capçalera/peu per a totes les plantilles d'un projecte en concret i copiar les plantilles de contingut a aquesta carpeta, i tendreu una pàgina completa amb una capçalera/peu com a punt de partida.
El text real que s'inserirà abans del contingut de les plantilles.
El text real que s'inserirà al darrera del contingut de les plantilles.
A més, si mireu en les seves opcions amb el botó del ratolí, veureu les eines de gestió de fitxers al complet per a crear carpetes o copiar i enganxar plantilles d'una localització a una altra.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
L'editor de Disposició visual de la pàgina (VPL) (també conegut com a WYSIWYG (What You See Is What You Get -el que veieu és el que hi ha-)) us permet editar un document HTML o XHTML mentre veieu els canvis al vol. Igual que en el vostre processador de text favorit, podeu fer clic en el document i veureu aparèixer un cursor, que us permetrà introduir text, inserir imatges, aplicar decoracions de text, etc. L'objectiu de VPL és permetre-us crear pàgines web grans i vàlides sense necessitat de conèixer els llenguatges de marcat de Internet.
Quanta Plus us ofereix dos modes: Editor VPL i Editor VPL i font, als que podeu accedir des del menú . El primer substitueix a l'Editor de font amb l'Editor VPL, i el segon divideix la finestra de l'editor en dues parts: La de l'Editor font i la de l'Editor VPL.
L'Editor VPL funciona així: Carrega un document com a una pàgina HTML o XHTML i apareix un cursor. Després la podeu editar i tornar a l'Editor font, veure que els canvis que heu realitzat en l'Editor VPL s'han inclòs en l'Editor font.
Al treballar en l'Editor VPL amb un document que contingui PHP, veureu una petita icona verda que representa el codi PHP. No el podeu editar directament amb l'Editor VPL. Per editar PHP, haureu d'usar l'Editor font. No hi ha plans de canvi per a aquesta funcionalitat.
El segon mode es comporta exactament igual que el primer, excepte en que podeu veure instantàniament l'impacte dels canvis que heu realitzat, bé en l'Editor font o bé en l'Editor VPL, i els cursors de l'editor de codi font i de l'Editor VPL estan sincronitzats. En prémer F9 es carrega aquest mode, però, si ja està carregat, mourà el focus d'una vista a l'altra, mantenint la mateixa localització del document.
Es poden configurar els intervals de refresc entre l'Editor VPL i l'Editor font. Aneu a ->. Escolliu la pestanya . Podeu escollir si voleu refrescar una vista tan sols quan es faci clic sobre seu o que es faci automàticament. Si escolliu que es faci automàticament, podeu escollir un interval de refresc. La recomanació general és: Un número petit per a ordinadors ràpids i un número més gran per a les més lentes.
El mode Editors VPL i font.
Ara, diguem que voleu editar el títol de la vostra pàgina web. Com fer-ho? Simplement, obriu ->. Aquesta eina permet l'edició d'etiquetes “invisibles” quan useu l'Editor VPL. El diàleg Propietats del document també es carrega quan creeu un document nou en l'Editor VPL. Això és per a reduir la quantitat de codificació manual que us cal realitzar. De manera que podeu editar:
El títol del document.
Les etiquetes meta us permeten desar informació quant al propi document, p.ex., paraules clau per als motors de recerca d'Internet. Podeu afegir o eliminar Ítems meta prement els dos botons de a sota, i editar-los fent clic en la llista, p.ex., poseu “paraules clau” en la columna “nom” i “paraula_clau1 paraula_clau2” en la columna “contingut”.
Les Regles CSS són la nova forma de dir-li al navegador com presentar la pàgina. Les podeu afegir o eliminar prement els botons de a sota. També podeu omplir els camps com els Ítems meta. Encara no està suportada l'edició de les Regles CSS.
També podeu enllaçar amb un full d'estil CSS extern. Simplement, feu clic sobre el botó Navega i seleccioneu el vostre fitxer.
Podeu usar el cursor de la mateixa manera que en un processador de text, movent-lo amb les fletxes. Pot arribar un moment en el que el cursor no vulgui anar cap a on li indiqueu (un error un tant molest). La selecció també funciona com és normal. Podeu inserir text teclejant-lo i eliminar-lo prement la tecla Retrocés o Supr.
Ara anem amb la inserció d'etiquetes. Podeu inserir imatges, applets, decoracions de text tals com negreta i similars usant les mateixes barres d'eines que useu en l'editor de codi font. Tingueu present que la inserció d'etiquetes no eliminarà les etiquetes idèntiques anteriors, p.ex. si inseriu una etiqueta d'ancoratge que torna a un text, podeu eliminar qualsevol altra ancoratge que la retorni.
Alguns ítems de la barra d'eines es deshabilitaran, com l'Assistent de taules o l'Assistent ràpid de llistes. En algun moment funcionarà en VPL, però, en aquesta versió, hauríeu d'usar les barres d'eines Taules o Llistes.
Per a editar una etiqueta (que sigui una imatge, un applet o qualsevol altra cosa), passeu a l'Arbre d'atributs, al qual s'accedeix mitjançant ->. Feu clic sobre l'etiqueta que vulgueu editar o, si no podeu accedir, feu clic sobre un objecte en la que estigui continguda. L'Arbre d'atributs us mostrarà el nom de l'etiqueta actual així com la llista de tots els seus pares i atributs. Actualment, VPL no suporta, diguem, XHTML+MathML, però veureu que podeu editar espais de nom amb aquesta vista. Simplement podeu fer clic sobre el camp Valor i modificar qualsevol cosa que vulgueu. Si voleu accedir al pare de l'etiqueta actual, seleccioneu-la i l'Arbre d'atributs la carregarà.
Per eliminar una etiqueta, useu l'Arbre d'atributs. Us heu adonat de dues petites creus roges en la cantonada superior dreta? La primera elimina tan sols l'etiqueta que estigui seleccionada en aquest moment i, si l'especificació HTML/XHTML no permet que alguns fills de l'etiqueta eliminada siguin fills de l'etiqueta pare del conjunt d'etiquetes que es va a eliminar, també s'eliminen i així successivament. La segona creu eliminarà l'etiqueta seleccionada, així com tots els seus fills, de manera que tingueu cura!
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Aquest capítol explica les diverses funcions que es poden trobar en la barra de menú.
Crea un fitxer nou, en blanc.
Cerca en el sistema de fitxers per obrir un fitxer existent.
Llista ràpida dels últims fitxers que ha obert per a facilitar el seu ús. Aquesta llista canviarà cada vegada que obriu un fitxer que no hi estigui, esborrant els més antics.
Desa els canvis del fitxer actiu.
Desa el fitxer actiu amb un altra nom.
Això us permet desar trossos de codi i fitxers complets amb una plantilla per al seu posterior ús. Consulteu la secció sobre les plantilles. Si intenteu desar el fitxer/text seleccionat fora del directori de plantilles local/del projecte, llavores rebreu un error.
Us permet desar un fitxer com a una plantilla dins de l'àmbit local.
Us permet desar un fitxer com a una plantilla dins de l'àmbit del projecte.
Us permet desar el text seleccionat (p.ex., un tros de codi) en un fitxer de plantilla local.
Us permet desar el text seleccionat (p.ex., un tros de codi) en un fitxer de plantilla del projecte.
Desa tots els fitxers modificats en l'editor.
Torna a carregar el document que te el focus actualment.
Realment podeu imprimir els vostres documents. Usa la interfície kprinter.
Surt de Quanta Plus
Desfà la última acció realitzada.
Refà la última acció desfeta.
Talla el bloc de text actual i posa els seus continguts en el portapapers.
Copia el bloc de text actual al portapapers.
Enganxa el contingut del portapapers a la posició actual del cursor.
Converteix els caràcters especials HTML del text en el portapapers a entitats HTML abans d'enganxar-lo en el cos del text, de manera que es mostrin adequadament quan es visualitzin i no estiguin seleccionats com a etiquetes en el fullejador client.
Converteix el text del portapapers en una URL codificada, la qual és la manera correcta d'incloure caràcters especials i espais en les URL. Principalment s'usa per enganxar una URL en una etiqueta d'ancoratge.
Selecciona tot el text en el document actual.
Deselecciona tot el text en el document actual.
Activa/desactiva el ressaltat del bloc. Us permet seleccionar blocs de text amb el vostre teclat sense mantenir premuda la tecla Majús..
Solapa la tecla Insert.
Cadena o expressió regular a cercar en el document actual.
Repeteix la recerca en el document cap avall des de la localització actual.
Repeteix la recerca en el document cap amunt des de la localització actual.
Cadena o expressió regular de text a substituir en el fitxer actual.
Va directament al número de línia especificat. Això realment és útil quan els scripts PHP us estan tornant boig!
Cerca una cadena o expressió regular en els fitxers de la carpeta seleccionada. És quelcom així com un GUI per a grep o sed amb alguns espais per a patrons predefinits que us seran d'ajuda.
Expandeix els abreujaments. Es poden definir aquests abreujaments en el diàleg ->.
Torna a formatar el codi font amb les mateixes regles amb les que la part VPL insereix les etiquetes.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Mostra o oculta l'arbre de fitxers.
Mostra o oculta l'arbre del projecte.
Mostra o oculta l'arbre de plantilles.
Mostra o oculta l'arbre dels scripts.
Mostra o oculta l'arbre de l'estructura del document.
Mostra o oculta l'arbre dels atributs.
Mostra o oculta l'arbre de la documentació.
Mostra o oculta la finestra dels missatges. Aquesta és la finestra en la que veureu la sortida de les accions de qualsevol script i el depurador.
Mostra o oculta l'Informador de problemes, al final de la finestra principal de Quanta Plus. L'Informador de problemes s'activa quan es canvia a Estructura en arbre.
Mostra la vista de les anotacions. Podeu llegir “Anotacions” per accedir a més detalls.
Mostra els fitxers en el servidor per a un perfil de publicació.
Mostra o oculta la vora de les icones a l'esquerra de la finestra d'edició principal. Aquesta barra us permet fer clic per a posar marcadors.
Mostra o oculta els números de línia al costat de la finestra d'edició principal.
Activa i desactiva el format automàtic del text al vol segons un ample especificat.
Canvia a les fonts d'un document per a editar-les.
Canvia a l'Editor VPL per editar un document.
Canvia al mode de pantalla partida per editar un document.
Vista prèvia del document actual.
Navega una passa cap enrere en la vista prèvia.
Navega una passa cap endavant en la vista prèvia desprès d'haver anat enrere en la mateixa vista prèvia.
Torna a carregar la vista prèvia des del disc.
Visualitza el fitxer actual amb el Konqueror.
Visualitza el fitxer actual amb el navegador Mozilla Firefox.
Visualitza el fitxer actual amb el Mozilla®.
Visualitza el fitxer actual amb el Netscape®.
Visualitza el fitxer actual amb el Opera.
Visualitza el fitxer actual amb el Lynx (un navegador basat en text).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Estableix un marcador a la localització de la línia actual en el fitxer actual.
Neteja tots els marcadors establerts en el document actual.
Si teniu marcadors en el fitxer actual, apareixerà en el menú junt amb un ítem Previ o Següent, segons la posició del cursor en el document.
Si teniu marcadors en d'altres documents oberts, apareixerà en el menú agrupat pel nom de fitxer dels altres documents.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
L'ús de projectes en Quanta Plus es descriu en “Projectes”.
Llança l'assistent de creació de projectes.
Obre un fitxer de projecte existent des del disc. Els projectes de Quanta Plus es desen amb la extensió .webprj.
Us dona una llista dels projectes usats més recentment per a un ràpid accés.
Tanca el projecte actual.
Obre una “Vista”, una combinació específica de fitxers oberts que heu desat prèviament.
Desa el conjunt actual de fitxers oberts com a una “Vista”.
Desa el conjunt de fitxers actualment oberts com a una “Vista” sota un altra nom.
Elimina una “Vista”.
Presenta un diàleg que us permet seleccionar fitxers per afegir-los al vostre projecte actual. Aquests fitxers seran copiats en el directori del projecte per a ser editats.
Insereix una carpeta i tot el seu contingut en el projecte actual.
Cerca en la carpeta del projecte els fitxers nous que hi pugui haver. Això us permet copiar gràfics a la carpeta o a una subcarpeta del vostre projecte per a després afegir-los al projecte.
Publica els fitxers en el vostre projecte al servidor. La llista de transports disponibles dependrà de la versió de KDE que esteu executant i de si heu descarregat o no els esclaus KIO extra.
Les opcions que afecten a la forma en la que Quanta Plus gestiona el vostre projecte. Per a més detalls consulteu la secció projectes de Quanta.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Carrega una barra d'eines definida globalment. Per omissió, aquestes barres d'eines es desen en $. KDEDIR/share/apps/quanta/toolbars
Carrega una barra d'eines definida localment. Per omissió, aquestes barres d'eines es desen en $. HOME/.kde/share/apps/quanta/toolbars
Carrega una barra d'eines del projecte. Per omissió, aquestes barres d'eines es desen en DirProjecte/toolbars
Diàleg per a desar les vostres barres d'eines. Us permet seleccionar el tipus de barra d'eines; local o del projecte.
Desa com barra d'eines local a $ HOME/.kde/share/apps/quanta/toolbars
Desa com a una barra d'eines del projecte en DirProjecte/toolbars
Fa aparèixer un diàleg per a crear una barra d'eines nova. Això tan sols crea el nom. Les accions es poden afegir des de l'ítem -> del menú. Les barres d'eines es desen mitjançant el menú -> o al tancar les barres d'eines no desades us demanarà si les voleu desar.
Elimina l'ús d'una barra d'eines. Això no l'esborra del disc. Si no l'heu desat quan l'elimineu, us demanarà per desar-la.
Us permet canviar el nom a una barra d'eines.
Això és un afegit per a enviar per correu electrònic la vostra barra d'eines personalitzada a algú (pot ser a l'equip de Quanta Plus per a que s'inclogui en la propera versió) per al seu ús. Obre una finestra de correu electrònic i hi adjunta el fitxer de la vostra barra d'eines automàticament.
També us permet publicar una barra d'eines en el servidor de recursos principal. Més informació en “Compartir recursos”.
Us permet publicar les barres d'eines en el servidor principal, des d'on d'altres la poden descarregar. Més informació en “Compartir recursos”.
Us permet descarregar barres d'eines des de la Internet. Més informació en “Obtenir recursos”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Fa aparèixer una caixa de diàleg que us permet canviar la DTD (definició del tipus de document) del document actual.
Fa possible canviar el fitxer de configuració description.rc per a un DTEP.
Carrega una DTD creada i la converteix en el format de descripció natiu de Quanta Plus.
Carrega/actualitza les entitats d'una DTD. És d'utilitat si voleu actualitzar les entitats d'un DTEP sense tenir que tornar a generar el DTEP sencer. En el cas de que el DTEP sigui global i no disposeu de permís d'escriptura sobre el directori global de KDE, fallarà la càrrega de les entitats.
Carrega el vostre propi DTEP.
Envia el vostre DTEP a un amic mitjançant el KMail.
Us permet publicar els DTEP. Més informació en “Compartir recursos”.
Us permet descarregar els DTEP des de la Internet. Més informació en “Obtenir recursos”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Aquest menú conté una llista de les etiquetes que estan actualment carregades en les barres d'eines. Per exemple, si heu carregat la barra d'eines estàndard (HTML), el menú contindrà un submenú que contindrà la llista d'etiquetes/accions d'aquesta barra d'eines.
Us permet accedir al diàleg opcions de l'etiqueta de marcat actual, si és que n'hi ha. Aquesta entrada sempre es presenta, seguida de submenús específics de la DTD.
Ressalta l'àrea de l'etiqueta actual. L'àrea de l'etiqueta comença en el punt en el que està situat el cursor.
Activa i desactiva la inserció intel·ligent d'etiquetes. Actualment, tan sols funciona amb les DTD (X)HTML. La inserció intel·ligent vol dir que Quanta Plus refusarà inserir una etiqueta usant la barra d'eines si l'etiqueta no pot estar present en la localització actual.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
El menú mostra la llista de connectors disponibles. Feu clic sobre aquests per activar-los. Feu clic sobre un connector activat per a desactivar-lo.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Tria el mode de ressaltat de la sintaxi per al fitxer actual. La llista d'esquemes de ressaltat disponibles varia segons la vostra versió de Kate.
Selecciona el tipus de codificació per al fi de línia. D'utilitat si teniu amics que usen d'altres sistema operatiu com a plataformes de desenvolupament. Escolliu entre , o .
Mou el bloc de text seleccionat un tabulador cap a la dreta.
Mou el bloc de text seleccionat un tabulador cap a l'esquerra.
Elimina tot el sagnat.
Posa com comentari en el text seleccionat.
Manlleva el comentari del text seleccionat.
Ajusta el text de la finestra actual a un ample predefinit.
Comprova la ortografia en el document actual.
Edita les propietats específiques d'un document carregat en aquest moment usant l'Editor VPL.
Converteix els caràcters de totes les etiquetes i els atributs a majúscules o minúscules.
Comprova la sintaxi del document actual contra la DTD seleccionada, usant l'aplicació externa tidy.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Tanca la pestanya actual (document, connector, vista prèvia o documentació).
Tanca totes les pestanyes obertes.
Canvi al vol entre diversos modes de la IU (interfície d'usuari). Degut a algunes limitacions de les biblioteques de KDE, el canvi pot trigar una estona i provocar alguns efectes col·laterals un tant lleigs. Els modes que es recomana usar són el Mode IDEAl, que és el predefinit, o el Mode pàgina a pestanyes, el qual és el mateix mode que estava present en les versions 3.2 i anteriors de Quanta Plus.
A més, aquest menú conté una entrada per a cada pestanya oberta. Si la seleccioneu, la pestanya a la que pertany es convertirà en la activa.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Mostra o oculta les barres d'eines que no siguin d'usuari.
Mostra o oculta la barra d'eines específica de la DTD.
Mostra o oculta la barra d'estat a la part inferior de la finestra principal de Quanta Plus.
Configura el comportament de Quanta Plus.
Configura el comportament de la vista prèvia integrada.
Els canvis que es fan en el diàleg tenen efecte en cada aplicació que usi la part KHTML, entre les que s'inclou el fullejador web Konqueror.
Aquí es a on definiu les accions que aneu a usar en les barres d'eines. Més informació en “Accions definides per l'usuari”.
Aquí es a on podeu definir i modificar els connectors.
Configura el comportament de la finestra d'edició. Per a més detalls mireu la documentació de Kate.
El diàleg que us permet afegir/esborrar ítems a/des de les barres d'eines i canviar l'ordre en el que apareixen les icones.
Us permet configurar les múltiples dreceres de l'editor disponibles en Quanta Plus.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Quanta Plus te el menú estàndard de KDE, amb els següents ítems addicionals:
Hauria de produir ajuda basada en el context del punter actual. A l'hora d'escriure això, aquesta característica no estava implementada.
Quanta Plus és un producte d'alta qualitat disponible gratuïtament i amb llicència lliure, però com en d'altres projectes de codi obert, els seus desenvolupadors necessiten ajuda. Si voleu donar suport econòmic al desenvolupament de Quanta Plus, aquí trobareu com fer-ho.
Els ítems del menú d'ajuda estàndard de KDE són els següents:
Inicia el sistema d'ajuda del KDE mostrant les pàgines d'ajuda per a aquesta aplicació. (Aquest document).
Canvia el cursor del ratolí a una combinació entre fletxa i interrogant. Clicant a sobre dels ítems de aquesta aplicació se us obrirà una finestra d'ajuda (si existeix per a aquest ítem en particular) explicant la funció de dit ítem.
Obre un diàleg d'informe d'errors a on podreu informar d'un error o requerir una característica “wishlist”.
Us mostrarà informació quant a la versió i el seu autor.
Us mostrarà informació quant a la versió del KDE i d'altra informació bàsica.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Aquest capítol descriu com podeu controlar el comportament de Quanta Plus.
Els diàlegs de configuració són accessibles des del menú Arranjament. Aquí tractarem tan sols algunes d'aquestes opcions. La resta no són específiques de Quanta Plus i es pot trobar una breu descripció a “El menú ”.
El diàleg de configuració es pot invocar usant +. El diàleg disposa de diverses pàgines, que es descriuran d'una en una.
Podeu canviar el comportament de Quanta Plus relacionat amb les etiquetes, inclòs l'autocompletat. Les entrades són:
Escriure etiquetes en: majúscules o minúscules en les etiquetes inserides automàticament. Majús/minús per omissió vol dir que les etiquetes s'inseriran tal i com són descrites en els fitxers tagXML.
Escriure atributs en: Majúscules o minúscules en els atributs inserits automàticament. Majús/minús per omissió vol dir que els atributs s'inseriran tal i com són descrits en els fitxers tagXML.
Citat de l'atribut: Com citar els atributs inserits per Quanta Plus.
Tanca automàticament les etiquetes opcionals: Si està marcada, s'inserirà automàticament una etiqueta de tanca quan s'escrigui el tancament de l'etiqueta d'obertura ">".
Tanca automàticament les etiquetes no úniques i no opcionals: El mateix que l'anterior per a la resta d'etiquetes, excepte per a les etiquetes úniques.
Usa autocompletat: Activa o desactiva l'autocompletat d'etiquetes, atributs, funcions, etc.
Actualitza automàticament les etiquetes obre i tanca: Si està habilitada, quan canvieu l'etiqueta d'obertura, també es modificarà l'etiqueta de tancament corresponent i viceversa.
Substitució automàtica dels caràcters accentuats: Si està habilitada, els caràcters accentuats seran substituts pels seus codis a mesura que els escriviu.
Una pàgina que controla l'entorn i algunes opcions per omissió.
Tipus MIME: Els tipus mime que s'usen per a reconèixer diversos tipus de fitxers. Useu el botó Torna a per omissió per omplir les entrades amb les opcions preestablertes.
Codificació de caràcters per omissió: La codificació dels nous fitxers que es van creant, o dels fitxers que es carreguen d'altra manera que no sigui -> (a on podeu indicar la codificació). Quan es carrega un projecte aquesta opció no preval sobre la del mateix nom en les Propietats del projecte.
DTD per omissió: La DTD que s'usa per als nous fitxers creats, o per als fitxers en que la DTD no es pugui reconèixer. Quan es carrega un projecte aquesta opció no preval sobre la del mateix nom en les Propietats del projecte.
Crea còpia de seguretat: Quanta Plus crearà periòdicament fitxers de còpia de seguretat, per a que en el cas de falles elèctriques o de caiguda es pugui restaurar el document des d'aquesta còpia de seguretat. No és el mateix que la còpia de seguretat creada en desar el fitxer. Fins i tot per als documents que encara no s'han desat es crea una còpia de seguretat.
Opcions d'inici: S'explica per si mateixa atès que controla què succeeix durant l'inici.
Aquí podeu controlar l'aparença de Quanta Plus.
La vista prèvia i la documentació poden aparèixer en l'àrea de l'editor o en una eina de vista separada, en aquest cas també és possible mirar la documentació, la vista prèvia i el codi font.
També és possible configurar l'aparença de l'eina de vista i de les pestanyes de documents.
Reinicia la disposició de la finestra als valors per omissió en el següent inici: És d'utilitat quan s'ha espatllat la interfície d'usuari, canviant els modes MDI i ancorant/desancorant les eines de vista. És el mateix que usar l'opció --resetlayout en la línia de comandaments.
Aquest també és el lloc per a controlar el comportament dels arbres de fitxers.
La secció Missatges d'avís és d'utilitat per habilitar o deshabilitar els missatges d'avís que podeu haver omès per tenir marcada la caixa No tornis a preguntar.
El lloc per a canviar el comportament de VPL. Podeu fer que es mostri una icona en comptes dels scripts, així com configurar la sincronització del VPL i la vista del codi font quan està actiu el mode dividit. Consulteu “El menú ” per aprendre a activar els diferents modes.
Aquí podeu ajustar els detalls de l'analitzador i de l'estructura en arbre, la qual és la representació visual que te l'analitzador dels nodes en el document.
En Clics sobre els ítems de l'estructura en arbre és possible canviar les accions assignades als botons del ratolí quan feu clic en l'estructura en arbre.
En Aparença i comportament de l'estructura en arbre és possible configurar quins tipus de nodes seran visibles en l'arbre, la freqüència amb la que s'haurà d'actualitzar mentre s'està editant i amb quina profunditat s'ha d'obrir automàticament l'estructura en arbre. Els nodes buits són els nodes de text amb espais buits, mentre que els grups buits són grups per als que no es troba un element en el document actual.
El lloc per a definir abreujaments (quelcom així com plantilles), que es poden expandir com a text quan s'està en l'edició. Els abreujaments s'organitzen en grups. Cada grup pot ser vàlid per a més d'una DTEP. Això vol dir que podeu tenir un grup vàlid per a PHP en el que la plantilla d'abreujament "ifclause" signifiqui quelcom semblant en un grup vàlid per a JavaScript.
La creació i edició d'accions definibles per a l'usuari es descriuen en “Accions definides per l'usuari”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Aquí podeu gestionar els vostres connectors. Els connectors són aplicacions de KPart, escrites per a terceres parts que es poden tornar a usar en qualsevol aplicació que admeti KPart, la més coneguda és el Konqueror. Quan creeu un connector haureu d'especificar el:
Nom: El nom visible de l'usuari.
Finestra de sortida: Els connectors poden aparèixer en una pestanya de l'àrea de l'editor o a la part inferior en una eina de vista separada.
Localització: La ruta cap al connector, si no està localitat en els llocs estàndard, tal com $ .KDEDIR/lib
Nom de fitxer: La ruta relativa i el nom de fitxer per al fitxer de biblioteca del connector, tal com kde3/libcervisiapart.la
Entrada: El connector obtindrà aquesta informació a l'inici, de manera que obrirà el Fitxer actual, la carpeta del fitxer actual (Ruta al fitxer actual) o la Carpeta del projecte.
Part de tan sols lectura: Marqueu-la si el connector refusa la càrrega. Les KPart de tan sols lectura normalment refusen la càrrega si aquesta opció no està marcada.
Valida el connector: Si està marcada, Quanta Plus comprovarà si la informació introduïda és o no correcta. Desmarqueu-la si el connector encara no està disponible, però l'instal·lareu més endavant, de manera que podreu tancar el diàleg.
Consulteu “El menú ” i “Usar els connectors” per a més informació sobre com usar els connectors.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Aquest capítol apunta les característiques avançades de Quanta Plus i com usar-les.
La versió 3.2 de Quanta Plus ve amb moltes característiques i eines XML noves. Les eines són úniques en la seva integració amb Quanta Plus. Totes aquestes eines usen Kommander com a interfície i libxml2 i libxslt com a rerefons del programa. La combinació d'ambdós fa d'aquestes ràpides, eficients, productives i completes.
Quanta Plus suporta dues de les eines de documentació principals de KDE: meinproc i checkXML.
Qualsevol que hagi treballat amb la documentació de KDE coneix meinproc i el superb que és. Bé, doncs doneu-li una oportunitat a una gran interfície gràfica. No cal tornar a un intèrpret de comandaments. Simplement feu clic sobre la icona que sembla un processador i ja està!
Aquesta aplicació espera que estigui present en la carpeta un fitxer index.docbook. Si index.docbook està en la carpeta de treball actual, simplement deixeu marcat Carpeta de treball actual. Si no ho està, desmarqueu Carpeta de treball actual i indiqueu la carpeta que voleu processar en el camp Altra carpeta.
Els fitxers de sortida són situats en la mateixa carpeta que els fitxers font. Tots els fitxers HTML seran eliminats cada vegada que s'executi meinproc.
Altra vegada, qualsevol que hagi treballat amb la documentació de KDE coneix aquesta útil aplicació. De nou, Quanta Plus proveeix una petita i alhora gran interfície gràfica.
Si el fitxer que està obert actualment és index.docbook, simplement deixeu marcat Carpeta de treball actual. Si no, desmarqueu Carpeta de treball actual i indiqueu la carpeta en la que es trobi index.docbook.
Si hi ha sortida, llavores el vostre fitxer no és vàlid. Si us plau, corregiu els errors que informi i proveu-ho una altra vegada.
Quanta Plus disposa d'una gran eina de validació XML, la qual usa com a programa de rerefons xmllint.
Si el fitxer que es validarà te actualment el focus en Quanta Plus, simplement deixeu marcat Fitxer actual. Si no, desmarqueu Fitxer actual i escolliu el fitxer a validar des del selector de fitxers Un altra fitxer.
Si tan sols voleu saber si el fitxer està ben format, feu clic sobre la caixa de selecció Tan sols comprovar si estan ben formats.
Si esteu usant una DTD i s'especifica en el fitxer XML, llavores seleccioneu la DTD (interna) (per omissió), d'altra manera seleccioneu la DTD (externa) i localitzeu la DTD amb el selector de fitxers de la URI de definició. Es necessiten tan l'esquema W3C® XML com la validació RelaxNG per a ser definit externament mitjançant el selector de fitxers URI de definició.
Sí, Quanta Plus també disposa d'una eina de processament XSL! Aquesta usa l'eina xsltproc proveïda amb libxml2.
Si el fitxer a processar te el focus en Quanta Plus, llavores simplement deixeu marcat Fitxer actual. Si no és així, desmarqueu Fitxer actual i escolliu el fitxer a processar des del selector Un altra fitxer.
Selecciona el fitxer XSL que usareu.
Indiqueu el nom de fitxer que voleu per al fitxer resultant. Per omissió, el fitxer de sortida es situa a la vostra carpeta inici.
Aquesta aplicació manca de flexibilitat. Ho sentim. Intentarem fer-ho millor la propera vegada.
Quanta Plus pot carregar connectors, els quals són KParts. L'entorn de treball KPart és un altra dels potents entorns de KDE. Una KPart és un contenidor de funcionalitat relativament petit i reutilitzable. Permet als desenvolupadors de KDE basar-se en el treball d'altres programadors. Un exemple d'això és el mateix Quanta Plus. L'editor Quanta Plus usa la KPart de Kate. La KPart de Kate ja disposa de tota la funcionalitat que necessita Quanta Plus, com el ressaltat de la sintaxi. En integrar-la amb Quanta Plus, els desenvolupadors de Quanta Plus es poden permetre centrar la seva feina en el que podria fer Quanta Plus, en comptes de tenir que afrontar els molts problemes que duria l'escriptura des de cero d'una KPart/component editor.
Els connectors que carrega Quanta Plus poden no tenir res a veure amb el propi Quanta Plus. Això el fa un sistema de connectors molt potent. Podeu beneficiar-vos de funcionalitats extres i no heu d'esperar a que algú les integri en Quanta Plus! Els connectors es poden carregar dintre d'un nombre d'elements del GUI. Més endavant se'n parla.
Per a instal·lar un connector o una KPart es fa des del menú ->. Això farà aparèixer el següent diàleg:
El diàleg Edita connector.
Aquest diàleg us permet gestionar tots els connectors definits i afegir-n'hi de nous. Aquí es descriu cada element del GUI:
Aquí podeu completar una patró de recerca. En afegir un connector sense Localització, Quanta Plus cercarà en aquestes rutes per a trobar-lo.
Farà aparèixer un diàleg que us permetrà afegir un connector nou.
Us permet canviar les preferències d'un connector en particular.
Elimina el connector que estigui actualment seleccionat.
Refresca el contingut del diàleg.
Consulteu “Configurar els connectors” per a saber més quant als connectors.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Sovint hi ha més d'una persona treballant en el projecte, i hi ha algun tipus de relació jeràrquica entre els membres de l'equip. Quanta Plus admet la noció de membres de l'equip, i es pot configurar en el diàleg -> (Majús.+F7).
El diàleg d'edició de membres de l'equip
Les entrades Nom i Correu electrònic s'expliquen per si mateixes. Sobrenom és l'àlies de l'usuari i s'usa com a identificador únic.
Paper especifica el paper del membre en el projecte i pot ser un dels següents:
Líder de l'equip
Líder del subprojecte
Líder de la tasca
Membre
Tasca: És una descripció de la tasca assignada a aquest membre.
Subprojecte: Podeu seleccionar una llista de subprojectes. Els subprojectes es poden crear i configurar fent clic sobre el botó Edita els subprojectes. Cada subprojecte disposa d'un nom visible d'usuari i una entrada de localització, aquesta última indicant una ruta relativa cap a un directori en l'arbre del projecte. Això vol dir que un subprojecte és un directori sota el projecte principal. Per exemple, el projecte principal pot ser el lloc web de la vostra empresa, i un subprojecte podria ser el lloc web de la intranet, localitzat sota la carpeta intranet en el projecte.
Un membre pot tenir més d'un paper en el projecte, com per exemple líder de l'equip i líder del subprojecte.
L'usuari haurà de seleccionar-se a si mateix des de la llista de membres de l'equip. Es pot fer seleccionant un membre de l'equip des de la llista i prement el botó Estableix a mi mateix. El membre actualment seleccionat (la vostra identitat) apareixerà en negreta al darrera del text Vos sou:.
Els sobrenoms i la definició de la vostra pròpia identitat és important en relació a la missatgeria i les anotacions. Consulteu “Anotacions” per aprendre més a sobre de les anotacions.
A més de seguir la pista del vostre equip, hi ha un avantatge més si s'estableixen els membres de l'equip: Podeu configurar un esdeveniment per a informar als líders de l'equip que ha succeït quelcom. Hi ha més informació a sobre de com fer-ho en “Accions d'esdeveniments”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Les accions d'esdeveniments es produeixen quan succeeix algun esdeveniment en el projecte. Un exemple seria registrar quan s'obre i es tanca el projecte, de manera que pugueu revisar amb posterioritat quan s'ha treballat en el projecte, o enviar un correu quan un fitxer sigui desat, o s'afegeixi un fitxer al CVS amb l'ajuda d'un script. I la llista continua.
En la pàgina Configuració dels esdeveniments del diàleg -> (Majús.+F7) podeu crear, editar i eliminar accions d'esdeveniment.
El diàleg edició dels esdeveniments
Les entrades en el diàleg són:
L'acció es porta a terme quan succeeix l'esdeveniment seleccionat de la llista. Els noms dels esdeveniments s'expliquen per si mateixos.
El tipus d'acció que es porta a terme. Les opcions possibles són:
Una acció que no sigui un script definit per l'usuari . Podeu veure en “Accions definides per l'usuari” algunes accions d'usuari.
Nom de l'acció especifica l'acció a executar quan succeeixi l'esdeveniment.
Quan succeeix l'acció s'envia un correu-e al destinatari seleccionat en la llista Destinatari. El destinatari pot ser un equip o un líder del subprojecte. A “Equip de desenvolupament” podeu veure com definir aquests líders.
L'esdeveniment es registra en un fitxer. Els arguments per aquesta acció són:
El nom de fitxer, amb la ruta completa.
Quanta informació ha de contenir el registre.
Si crear o sobreescriure el fitxer de registre existent, o si afegir al que ja hi ha el nou esdeveniment que es registri.
Una acció d'script definida per l'usuari. Consulteu “Accions definides per l'usuari” per a les accions d'usuari.
Nom de l'acció especifica l'acció a executar quan succeeixi l'esdeveniment.
Les demés entrades depenen del tipus d'Acció tal i com s'ha descrit.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Les anotacions són comentaris especials en els documents. Es diferencien dels comentaris normals en els següents aspectes:
La informació la recopila Quanta i es mostra en la vista de l'eina Anotacions.
La informació es pot dirigir a un membre de l'equip
Introduir anotacions és simple. Podeu usar l'entrada Anota des del menú de context de l'editor o introduir la clau @annotation en una àrea de comentaris, seguida del text de l'anotació.
Exemple 6.1. Exemple d'anotació en XML
<!-- @annotation És possible que aquest codi sigui incorrecte. -->
<!-- @annotation Anotació amb diverses línies. -->
Exemple 6.2. Exemple d'anotació en PHP
/* @annotation Usar els comentaris de PHP quan l'anotació estigui en una àrea PHP. */
Les anotacions es poden dirigir a membres específics del vostre equipo. En aquest cas, la sintaxi serà @annotation(sobrenom) o @annotation(paper), a on sobrenom serà l'àlies del membre de l'equip, mentre que paper serà un rol del projecte d'entre els següents ítems:
team leader (líder de l'equip)
task leader (líder de la tasca)
subproject leader (líder del subprojecte)
Exemple 6.3. Crear una nota per a un integrant de l'equip amb el sobrenom pere
<-- @annotation(pere) Pere, si us plau, fés una ullada a això. Jordi -->
Exemple 6.4. Informar al líder de l'equip
<-- @annotation(team leader) Això és molt important per a l'equip. -->
Exemple 6.5. Informar al líder del subprojecte PHP
// @annotation(subproject leader:PHP) Què us sembla això?
Els sobrenoms i els noms dels papers no són sensibles a majúscules, però els espais junt als parèntesis i els dos punts : fan que les anotacions no siguin vàlides.
Teniu més informació quant als membres dels equips, papers i sobrenoms en “Equip de desenvolupament”
Les anotacions que es troben en el projecte es poden inspeccionar en la vista Anotacions. Consta de tres pestanyes:
L'anotació que es troba en el fitxer actual.
Anotacions del projecte dirigides a vos. Les entrades s'agrupen per fitxers.
Les anotacions que es troben a tots els fitxers del projectes, agrupades per fitxers.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Amb la versió 3.3 de Quanta Plus s'ha tornat a implementar la gestió del depurador. S'ha eliminat el suport per al PHP (3) atès que és obsolet, així com el suport per al depurador dbg. En el seu lloc, s'ha desenvolupat un sistema de connectors de depuració, per a permetre diferents implementacions dels connectors.
En aquest moment tan sols hi ha un connector disponible, el qual afegeix suport per a usar Gubed PHP Debugger amb Quanta Plus.
Per a usar un depurador per al vostre projecte, obriu les opcions del projecte i escolliu un connector del depurador adequat a les vostres necessitats. Per alterar les opcions específiques del depurador, premeu el botó "Opcions" que hi ha junt a la llista desplegable del connector del depurador.
Una vegada un projecte disposa d'un depurador activat, apareixeran alguns ítems addicionals en la interfície d'usuari de Quanta Plus:
Apareixerà un menú nou des d'on podreu accedir a la majoria de les funcionalitats del depurador.
Una barra d'eines amb accés als comandaments de depuració més comuns.
Una vista d'eina en la que es mostra el contingut de les variables d'inspecció. Per omissió apareix en la part esquerra.
Una vista d'eina en la que es llisten els punts d'interrupció, les línies i les condicions. Apareix per omissió en la part inferior.
Una barra de vista en la que es mostra la sortida del depurador (com en HTML). Apareix per omissió en la part inferior.
Segons el que suporti el connector del depurador, estarà disponible tota o un subconjunt de la següent funcionalitat.
Aquesta acció s'usa per a connectar amb el depurador, si fora necessari, o per a indicar-li que comenci a escoltar les peticiones de depuració. Aquesta acció es produeix per omissió quan s'obre un projecte que usa el depurador, pel que normalment no us haureu de capficar en això.
Tot l'oposat de ->->. Tanca una connexió amb el depurador o deixa d'atendre els resultats.
Envia una petició HTTP al servidor per a iniciar una petició de depuració. Usar aquesta acció és equivalent a usar un navegador per a veure el document actual. La sortida de la petició finalitza al començament de la sortida de depuració.
Pausa l'execució d'un script
Li diu al depurador que comenci a executar l'script i que enviï la informació de les variables d'inspecció i de la línia d'execució actual mentre avança. Si es fa mentre l'script està aturat, l'execució continuarà. Si es fa abans de que s'hagi iniciat una petició de depuració, l'script començarà a funcionar tan aviat com s'hagi iniciat la petició.
Li diu al depurador que comenci a executar l'script i que enviï la informació de les variables d'inspecció i de la línia d'execució actual mentre avança. Si es fa mentre l'script està aturat, l'execució continuarà. Si es fa abans de que s'hagi iniciat una petició de depuració, l'script començarà a funcionar tan aviat com s'hagi iniciat la petició.
Li diu al depurador que executi la següent instrucció en l'script, sense entrar en les funcions ni en les inclusions.
Li diu al depurador que executi la següent instrucció en l'script, avançant en les funcions o inclusions, si és possible.
Li diu al depurador que executi fins sortir de la funció actual.
Li diu al depurador que ometi la següent instrucció i que continuï amb la següent, tal com si l'actual no existís.
Li diu al depurador que mati l'script que s'està executant.
Obre una caixa de diàleg a on podeu especificar els punts d'interrupció condicionals.
Alterna entre posar i treure un punt d'interrupció en la línia actual del cursor
Neteja tots els punts d'interrupció.
Obre una caixa de diàleg a on podeu indicar una variable o expressió que voleu observar. El valor del que s'observi apareixerà en la barra de vista d'eina de variables.
Obre una caixa de diàleg a on podeu introduir un nou valor per a una variable.
KXsldbg és la creació de Keith Isdale, així com aquesta secció de la documentació. KXsldbg és una interfície de KDE i una KPart per a xsldbg, el qual el podeu trobar en http://xsldbg.sf.net, junt amb molts d'altres treballs d'en Keith.
Per a iniciar KXsldbg, seleccioneu ->.
Si us plau, referiu-vos a la documentació de KXsldbg per a obtenir més informació a sobre del seu ús.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Aquest capítol descriu com personalitzar Quanta Plus per a les vostres necessitats particulars i com podeu ajudar a que Quanta Plus sigui millor.
Els paquets d'edició del tipus de document (els DTEP) s'usen en Quanta Plus per afegir suport per a llenguatges de marques, d'script i CSS. Permet que Quanta Plus proveeixi característiques com autocompletat i arbres de nodes. La seva simplicitat i flexibilitat converteixen a Quanta Plus en un acollidor IDE per als desenvolupadors web. Són els que fan de Quanta Plus un entorn productiu i fàcil d'usar.
Els DTEP venen en dos sabors. La Family 1, que són els marcadors, i la Family 2, que són els llenguatges d'script i CSS. Els DTEP es componen de dues parts, la carpeta "Tag" (etiqueta) i "Toolbars" (barres d'eines). Les carpetes d'etiquetes es componen de dos tipus de fitxers, description.rc i TagXML, que duen la extensió '.tag'. Les barres d'eines són pestanyes de botons orientades a icones (per sobre de la finestra d'edició), que posen text en un document a més velocitat de la que un usuari el pugui teclejar.
Els DTEP es poden crear manualment (podeu veure-ho a sota), descarregar o crear-los automàticament des d'una DTD existent. Per a més detalls quant a la conversió consulteu “Convertir una DTD en un DTEP”.
Aquest document descriu com fer els fitxers TagXML, description.rc i toolbars. En resum, un DTEP.
Els fitxers TagXML (.tag) defineixen tant els atributs específics per a una etiqueta com la disposició i contingut de la caixa de diàleg de propietats que mostra Quanta Plus per a l'etiqueta. El fitxer description.rc proveeix regles i informació sobre el DTEP mateix. Toolbars proveeix una mesura ràpida per afegir etiquetes a un document sense preocupar-se d'errors d'escriptura ni similars.
Les carpetes tan sols són això, carpetes. Es componen de tan sols els fitxers description.rc i TagXML. Les carpetes Tag duen el nom i la versió del llenguatge de marques, si és aplicable. (Per exemple, html-4.01-strict)
La taula de a sota mostra les llistes dels elements definits en TagXML i declara si són o no requerits. Tot i que no tots siguin requerits, es recomana que n'useu tants com pugueu per a que d'altres usuaris tinguin una millor experiència i més informació amb la que treballar.
| Element | Ús per omissió | Casos d'ús |
|---|---|---|
| TAGS | requerit | sempre |
| tag | requerit | sempre |
| label | opcional | requerit per a crear una caixa de diàleg de propietats |
| attr | opcional | requerit per a definir un atribut |
| tooltip | opcional | requerit per a que una caixa de diàleg de propietats mostri un consell |
| whatsthis | opcional | requerit per a que la caixa de diàleg de propietats mostri un “Què és això?” |
| list | opcional | necessari quan un attr és del tipus “list” |
| item | opcional | necessari quan s'usa <list> |
| textlocation | opcional | sempre |
| location | opcional | requerit quan s'usa 'label' |
| text | opcional | requerit quan s'usa 'label' |
| children | opcional | llista d'etiquetes que poden aparèixer en l'etiqueta que s'està definint |
| child | requerit | una entrada fill |
| stoppingtags | opcional | llista d'etiquetes que indiquen a una altra etiqueta que finalitzi |
| stoppingtag | requerit | una entrada que atura les etiquetes |
Les següents seccions descriuen al detall cada element. Tots els que hi poden anar estan disposats d'una manera fàcil.
Aquest es l'element arrel d'un document TagXML. Pot aparèixer en un document una sola vegada. Pot contenir la definició de múltiples etiquetes. És un element de tipus únic.
| Pare(s) | Fills |
|---|---|
| CAP | tag |
Entorn per a l'etiqueta que s'està definint. És un element de tipus únic.
| Pare(s) | Fills |
|---|---|
| TAGS | label, attr, stoppingtags |
| Atribut | Tipus | Valors | Omissió | Ús | Descripció |
|---|---|---|---|---|---|
| nom | cadena (string) | requerit | Especifica el nom de l'etiqueta que s'està definint. | ||
| Senzill | boolean | opcional | Especifica si l'etiqueta necessita o no una etiqueta de tancament </(nom_etiq)>. | ||
| tipus | cadena (string) | xmltag | opcional | Especifica el tipus de l'etiqueta que s'està definint. | |
| xmltag | El tipus de l'etiqueta està basat en XML. (Tan sols família 1). | ||||
| entity | L'etiqueta que descriu una entitat. (Tan sols família 1). | ||||
| property | El tipus d'etiqueta està relacionat amb CSS. (Tan sols família 2). | ||||
| funció | El tipus de l'etiqueta en una funció d'script. En usar <attr> es converteix en els arguments de la funció. (Tan sols família 2). | ||||
| classe | El tipus de l'etiqueta és una classe d'script. (Tan sols família 2). | ||||
| mètode | El tipus de l'etiqueta es un mètode de la classe. (Tan sols família 2). | ||||
| returnType | cadena (string) | void | opcional | Especifica el tipus retornat per l'etiqueta que s'està definint. (Tan sols família 2). | |
| void | El tipus d'etiqueta retorna 'void' (nul). | ||||
| int | El tipus de l'etiqueta retorna 'int' (enter). | ||||
| float | El tipus de l'etiqueta retorna 'float' (decimal). | ||||
| long | El tipus de l'etiqueta retorna 'long' (enter llarg). | ||||
| cadena (string) | El tipus de l'etiqueta retorna 'string' (cadena de caràcters). | ||||
| versió | cadena (string) | opcional | Indica la versió del llenguatge per al que és vàlida aquesta etiqueta. | ||
| extends | cadena (string) | opcional | Tan sols vàlida si el tipus de l'etiqueta és "classe". El nom de la classe base per aquesta classe. (Tan sols Family 2). | ||
| classe | cadena (string) | opcional | Tan sols vàlida si el tipus és "mètode". Indica el nom de la classe a la qual pertany aquest mètode. (Tan sols família 2). | ||
| comú | boolean | opcional | Si és "yes" (sí), l'etiqueta especifica un grup d'atributs comuns i els atributs que hi hagi dins d'aquesta etiqueta s'han d'adjuntar a qualsevol altra etiqueta. (Tan sols família 1). | ||
| comentari | cadena (string) | opcional | la cadena de comentari que apareix al costat del nom de l'etiqueta en la caixa de completat |
Posa una rètol en la caixa de diàleg. El text s'indica en l'etiqueta <text>. És un element de tipus únic.
| Pare(s) | Fills |
|---|---|
| tag | text, location |
Defineix un atribut de l'etiqueta. Aquest element ha d'aparèixer una vegada per a cada atribut. Defineix el nom i el tipus de l'atribut. També conté etiquetes addicionals que especifiquen com s'ha demostrar l'atribut, etc. És un element de tipus únic.
| Pare(s) | Fills |
|---|---|
| tag | location, list, tooltip, whatsthis, textlocation |
| Atribut | Tipus | Valors | Omissió | Ús | Descripció |
|---|---|---|---|---|---|
| nom | cadena (string) | requerit | Especifica el nom de l'atribut que s'està definint. | ||
| tipus | cadena (string) | input | requerit | Especifica el tipus de l'atribut que s'està definint. | |
| input | El camp admet entrades de text lliure (camp de text). | ||||
| comprovació | El valor del camp és booleà (caixa de selecció). | ||||
| color | El valor del camp és un color. | ||||
| url | El valor del camp és una URL. (Fitxer local al que fa referència). | ||||
| list | El valor de camp és un ítem d'una llista especificada. | ||||
| estatus | cadena (string) | opcional | requerit | Especifica si es requereix o no l'argument. (Tan sols família 2). | |
| opcional | L'argument és opcional. | ||||
| requerit | L'argument és requerit. | ||||
| implied | L'argument és implícit. | ||||
| codi font | cadena (string) | opcional | Especifica el codi font usat per a omplir l'entrada per a l'atribut en el diàleg d'edició d'etiquetes i en l'arbre d'atributs. | ||
| selection | El text seleccionat s'usa com codi font | ||||
| dcop | El resultat d'un mètode dcop s'usa com a codi font. | ||||
| interfície | cadena (string) | opcional | Requereix source="dcop". La interfície dcop que hi ha dins de Quanta Plus s'usa per a obtenir les dades del codi font. | ||
| mètode | cadena (string) | opcional | Requereix source="dcop" i un nom d'interfície. El nom per al mètode dcop que hi ha dins de Quanta Plus s'usa per a obtenir les dades del codi font. | ||
| arguments | cadena (string) | opcional | Requereix source="dcop", una interfície i un nom de mètode. Els arguments són passats al mètode. Pot ser buit o "%tagname%", el qual vol dir el nom de l'etiqueta actual. |
Defineix el consell per al camp en la caixa de diàleg. És un element de tan sols text.
Actualment, tan sols admet text pla (no podeu usar cap marca).
| Pare(s) | Fills |
|---|---|
| attr | CAP |
Defineix l'ajuda de "Què és això?" per a un camp en el diàleg. És un element de tan sols text.
Actualment, tan sols admet text pla (no podeu usar cap marca).
| Pare(s) | Fills |
|---|---|
| attr | CAP |
Una etiqueta contenidora que agrupa els ítems en una llista. Tan sols pot aparèixer una vegada per a cada descripció de l'atribut. És un element de tipus únic.
| Pare(s) | Fills |
|---|---|
| attr | item |
Indica la posició de l'atribut de text d'una etiqueta en un diàleg. Aquesta etiqueta tan sols pot aparèixer una vegada per a cada atribut en el diàleg (és a dir, una per a cada etiqueta <attr>). Aquest element és buit.
| Pare(s) | Fills |
|---|---|
| attr | CAP |
| Atribut | Tipus | Ús | Descripció |
|---|---|---|---|
| row | EnterNoNegatiu | requerit | Especifica la fila en la disposició del diàleg d'un camp o rètol. |
| col | EnterNoNegatiu | requerit | Especifica la columna en la disposició del diàleg d'un camp o rètol. |
| rowspan | EnterNoNegatiu | opcional | Especifica el número de files que ha d'ocupar un camp. |
| colspan | EnterNoNegatiu | opcional | Especifica el número de columnes que ha d'ocupar un camp. |
Especifica la posició i la mida d'un camp en el diàleg. Aquesta etiqueta tan sols ha d'aparèixer una vegada en cada camp del diàleg (és a dir, una per a cada etiqueta <attr> i <label>). Aquest element és buit.
| Pare(s) | Fills |
|---|---|
| label, attr | CAP |
| Atribut | Tipus | Ús | Descripció |
|---|---|---|---|
| row | EnterNoNegatiu | requerit | Especifica la fila en la disposició del diàleg d'un camp o rètol. |
| col | EnterNoNegatiu | requerit | Especifica la columna en la disposició del diàleg d'un camp o rètol. |
| rowspan | EnterNoNegatiu | opcional | Especifica el número de files que ha d'ocupar un camp. |
| colspan | EnterNoNegatiu | opcional | Especifica el número de columnes que ha d'ocupar un camp. |
Defineix el text per a un rètol o caixa de selecció. És un element de tan sols text.
| Pare(s) | Fills |
|---|---|
| label, attr | CAP |
Defineix una llista d'elements que poden aparèixer dins de l'etiqueta que s'està especificant. És un element de tipus únic.
| Pare(s) | Fills |
|---|---|
| tag | child |
Defineix una etiqueta fill. Aquest element és buit.
| Pare(s) | Fills |
|---|---|
| children | CAP |
| Atribut | Tipus | Valors | Ús | Descripció |
|---|---|---|---|---|
| nom | cadena (string) | requerit | Especifica una etiqueta que pot aparèixer amb una altra certa etiqueta. | |
| usage | cadena (string) | opcional | Especifica la relació amb el pare. | |
| requerit | El pare ha de tenir almenys un fill amb aquest nom. |
Defineix una llista d'elements que forcen a finalitzar una etiqueta. És un element de tipus únic.
| Pare(s) | Fills |
|---|---|
| tag | stoppingtag |
Tots els fitxers TagXML han de començar amb la declaració XML: <?xml version="1.0" encoding="UTF-8"?> i han d'estar aniuats i tancats de forma correcta.
Els espais no afecten a res, però tingueu cura amb els caràcters & i <. S'haurien de substituir amb & i <, respectivament, en elements com <tooltip>, <whatsthis>, i <text>. De no fer-ho es causarà una caiguda, per això haureu de tenir cura per a que no desaparegui el vostre treball.
Per a validar els vostres fitxers TagXML, simplement feu clic en en el diàleg emergent “Eines” de la part superior de Quanta Plus i seleccioneu “Valida TagXML”. Se us mostrarà un diàleg i tan sols haureu de seguir unes directrius simples.
Aquesta característica actualment no està present. Actualment la validació tan sols succeeix quan els fitxers TagXML estan carregats en Quanta Plus.
A continuació es mostra un fitxer TagXML vàlid de Family 1. Aquest fitxer descriu l'element <schema> de l'esquema XML del W3C®. El nom de fitxer per aquest TagXML hauria de ser schema.tag. Simple, oi?
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE TAGS> <TAGS> <tag name="schema"> <label> <text >id</text> <location col="0" row="0"/> </label> <attr name="id" type="input"> <tooltip >Un ID únic per a l'element.</tooltip> <whatsthis >Un ID únic per a l'element.</whatsthis> <location col="1" row="0"/> </attr> <label> <text >version</text> <location col="0" row="1"/> </label> <attr name="version" type="input"> <tooltip >Versió de l'esquema.</tooltip> <whatsthis >Versió de l'esquema.</whatsthis> <location col="1" row="1"/> </attr> <label> <text >targetNamespace</text> <location col="0" row="2"/> </label> <attr name="targetNamespace" type="input"> <tooltip >URI de referència de l'espai de nom d'aquest esquema.</tooltip> <whatsthis >URI de referència de l'espai de nom d'aquest esquema.</whatsthis> <location col="1" row="2"/> </attr> <label> <text >xmlns</text> <location col="0" row="3"/> </label> <attr name="xmlns" type="input"> <tooltip >URI de referència per a un o més espais de nom a usar en aquest esquema. Sinó s'usa prefix, llavores els components d'aquest espai de nom es podran usar sense qualificar.</tooltip> <whatsthis >URI de referència per a un o més espais de nom a usar en aquest esquema. Sinó s'usa prefix, llavores els components d'aquest espai de nom es podran usar sense qualificar.</whatsthis> <location col="1" row="3"/> </attr> <label> <text >attributeFormDefault</text> <location col="0" row="4"/> </label> <attr name="attributeFormDefault" type="list"> <items> <item >qualified</item> <item >unqualified</item> </items> <tooltip >Formulari per omissió per a tots els atributs amb aquest esquema.</tooltip> <whatsthis >Formulari per omissió per a tots els atributs amb aquest esquema.</whatsthis> <location col="1" row="4"/> </attr> <label> <text >elementFormDefault</text> <location col="0" row="5"/> </label> <attr name="elementFormDefault" type="list"> <items> <item >qualified</item> <item >unqualified</item> </items> <tooltip >Formulari per omissió per a tots els elements amb aquest esquema.</tooltip> <whatsthis >Formulari per omissió per a tots els elements amb aquest esquema.</whatsthis> <location col="1" row="5"/> </attr> <label> <text >blockDefault</text> <location col="0" row="6"/> </label> <attr name="blockDefault" type="input"> <location col="1" row="6"/> </attr> <label> <text >finalDefault</text> <location col="0" row="7"/> </label> <attr name="finalDefault" type="input"> <location col="1" row="7"/> </attr> </tag> </TAGS>
A continuació es mostra un fitxer TagXML vàlid de Family 2. Aquest fitxer descriu la funció 'overload' de PHP. El nom de fitxer per aquest TagXML hauria de ser overload.tag.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE tags> <tags> <tag name="overload" type="function" returnType="void"> <attr name="class_name" type="string" status="optional"/> </tag> </tags>
El fitxer description.rc també és força simple, i hi ha un editor per a aquest tipus de fitxers en ->. Amb el qual editareu el description.rc per a un DTEP seleccionat des d'una llista. Per editar el description.rc d'un DTEP nou, haureu de crear un description.rc simple amb les següents entrades:
[General] Version = Usar 1 per a Quanta Plus versió <=3.1.2 i la 2 per a majors. Name = Cadena de definició DTD. (-//W3C®//DTD HTML 4.01 Transitional//EN) NickName = El nom guarnit de la DTD. (HTML 4.01 Transitional). Si està sense definir s'usarà el Name com a NickName.
Una vegada l'heu creat, poseu-lo junt als fitxers d'etiquetes, carregueu la nova DTEP amb -> i una vegada carregat, podeu seguir endavant i editar les opcions del DTEP. Seleccioneu els consells i el text de "Què és això?" en el diàleg d'edició per a entendre el significat de cada entrada. A més, podeu llegir quanta/data/dtep/dtd-description.txt des del fitxer original de fonts, el qual conté una descripció quant al format.
Les accions són molt comunes en totes les aplicacions. Sovint les necessiteu quan useu les aplicacions. Al fer clic sobre una icona de la barra d'eines, al seleccionar un ítem del menú o en usar una drecera es sòl executar una acció. En Quanta Plus, les accions us porten fins al següent nivell. En comptes d'accions estàtiques (les que crea el programador de l'aplicació a nivell de codi font), és possible que un usuari qualsevol crei i modifiqui les accions, de manera que les pugui crear i modificar afegint una nova funcionalitat a Quanta Plus. Aquestes accions són les definides per l'usuari, i moltes de les accions estàndard de Quanta Plus també són accions definides (i modificables) per l'usuari.
Hi ha tres tipus d'accions definibles per l'usuari:
Podeu crear una acció si aneu a ->. Feu clic en i trobareu un diàleg similar a:
El nom de l'acció, visible per a l'usuari.
La icona assignada a aquesta acció. Feu-hi clic per a canviar la icona actual.
Descripció breu del que fa l'acció.
La drecera assignada a aquesta acció. Feu clic en A mida o en el botó proper per assignar una drecera. Feu clic sobre Cap per eliminar la drecera assignada actualment.
Les barres d'eines definides per l'usuari en les que ha d'aparèixer aquesta acció. Consulteu “Crear barres d'eines”.
Opcions específiques per als diferents tipus d'accions. Seguiu llegint.
D'utilitat per a inserir etiquetes XML que, per descomptat, també podeu usar per a qualsevol altra propòsit.
El nom de l'etiqueta.
Si està marcada quan s'executa l'acció, aquest text serà inserit com a una tanca de l'etiqueta. Si hi ha alguna àrea seleccionada en el document abans d'executar l'acció, la <tag> serà inserida abans de l'àrea seleccionada i </tag> després.
Si està marcada i hi ha un fitxer tagXML per a aquesta etiqueta, es mostrarà un diàleg d'edició d'etiqueta en el document, per a que pugueu afinar els atributs de l'etiqueta.
Primer heu d'introduir el nom del vostre script, així com l'intèrpret. Exemple: sh /home/meuDirInici/meuScript.sh.
Tot i que podeu usar rutes completes, es recomana usar la variable %scriptdir en la línia de comandaments, tal com sh %scriptdir/meuScript.sh. D'aquesta manera, el Quanta Plus intentarà localitzar l'script en els següents llocs:
Carpeta global d'scripts: $KDEDIR/share/apps/quanta/scripts
Carpeta local d'scripts: $KDEHOME/share/apps/quanta/scripts
La vostra ruta: $PATH
%f: Es substitueix amb la URL del document actual. En el cas de documents locals, s'ometrà file:/ des del document.
%input: Es substitueix per l'entrada seleccionada. Veure a sota.
%projectbase: Es substitueix amb la URL del projecte actual. Restarà buida si no hi ha cap projecte carregat.
%pid: Es substitueix amb el PID (id. del procés) amb el que s'estigui executant el Quanta Plus. Si el Quanta Plus s'està executant en mode únic, el text "únic" serà afegit al número del PID. D'utilitat quan s'usa DCOP per a controlar Quanta Plus des d'un script extern.
%userarguments: D'utilitat en el cas d'esdeveniments. Aquesta entrada serà substituïda per les propietats de l'esdeveniment, seguint aquest ordre:
L'id únic de l'script
el nom de l'esdeveniment
els paràmetres de l'esdeveniment, normalment el nom de fitxer del document actual, o la ruta del fitxer de projecte.
A més dels mètodes anteriors, l'script pot rebre l'entrada des de l'entrada estàndard de Quanta Plus. En la llista desplegable Entrada podeu seleccionar què enviar a l'entrada estàndard. Les opcions són:
Res: No s'envia res a l'script.
Document actual: El document sencer és enviat l'script.
Text seleccionat: S'envia a l'script l'àrea seleccionada del document. Usar la variable %input usualment tan sols sòl prendre sentit quan s'usa aquesta opció.
De manera similar la Entrada pot recollir la sortida de l'aplicació que s'executa. Hi ha dos tipus de sortida:
sortida normal, mostrada en la sortida estàndard;
missatges d'error, mostrats en la sortida d'error estàndard.
Res: S'ignora la sortida de l'aplicació.
Insereix a la posició del cursor: La sortida serà inserida a la posició del cursor del document actual.
Substitueix la selecció: L'àrea seleccionada del document serà substituïda amb la sortida.
Substitueix la selecció: L'àrea seleccionada del document serà substituïda amb la sortida.
Crea un document nou: Es crearà un document nou i contindrà tota la sortida de l'script.
Substitueix el document actual: Es substitueix el document sencer amb la sortida.
Finestra de missatges: La sortida apareixerà en la vista d'eina Missatges.
Les opcions per a la sortida d'error estàndard (Error) són les mateixes que les de la sortida normal.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
A continuació se us mostrarà com crear barres d'eines per a un DTEP. Les barres d'eines són elements gràfics que són assignats a accions. Les accions, en Quanta Plus, són la base per a gairebé totes les extensions que te Quanta Plus i que obtindreu en el futur. El mateix mecanisme que defineix una acció en Quanta Plus també habilita l'autocompletat i els diàlegs de les etiquetes. Amb les accions, el límit del que voleu fer és virtualment il·limitat. A veure un exemple, usarem HTML tidy en les nostres pàgines web.
Per a començar, ens caldrà crear una barra d'eines d'usuari. Seleccioneu ->.
Si hi ha masses etiquetes per al llenguatge de marcat, es recomana dividir les etiquetes en grups lògics. Haureu de crear una nova barra d'eines d'usuari per a cada grup. En aquest cas, no n'hi ha moltes, així que crearem una barra d'eines i l'anomenarem amb el nom del marcat.
Una vegada heu creat les barres d'eines, heureu d'afegir i configurar les accions. Per a fer-ho, escolliu-> .
Les parts d'aquesta finestra són força fàcils. Feu clic al botó al final de la finestra per a entrar en el mode d'edició.
Ompliu tots els camps necessaris i afegiu l'etiqueta a la(es) barra(es) d'eines adequada.
Completar la resta i, si l'etiqueta conté atributs i penseu usar-los sempre, marqueu la caixa Executa diàleg "Edita etiqueta" si es pot per a que es mostri cada vegada que s'usi l'acció.
Ara hauríeu de tenir quelcom semblant al següent.
Premeu el botó i veureu afegida l'acció a la(es) barra(es) d'eines que heu seleccionat.
Vaja! És una icona horrible. Com recordaré que aquesta icona representa aquesta acció? La substituïm abans de trobar problemes.
Per a crear una icona que descrigui amb major precisió aquesta acció, usarem KIconEdit. Seleccioneu-lo des del Menú , -> (o allà a on l'ha col·locat la vostra distribució).
KIconEdit fa que la mida per omissió sigui 32x32 píxels, però el que ens cal és 22x22. Per a canviar-la, seleccioneu ->.
Tingueu present que creareu una icona que no tan sols us ajudarà a vos mateix a recordar el que fa una acció, si no també a d'altres usuaris del DTEP.
Ja que l'etiqueta per a la que estic creant la icona s'anomena “inici”, he decidit crear un “símbol d'inici”. Usant el color verd (el verd sovint s'interpreta com a “vés”, “comença” o “procedeix”) haurà, o almenys, hauria de transmetre a l'usuari el missatge de que al fer clic sobre aquesta acció posarà l'etiqueta <inici> en el document actual.
Ara que he finalitzat de crear la icona, la deso.
Una vegada creada(es) la(es) icona(es), haureu d'associar la icona amb l'acció. Per a fer-ho, torneu a obrir -> (en Quanta Plus) i seleccioneu l'acció per a la que heu creat la icona. Al costat del camp Text veureu un botó, feu-hi clic.
Seleccioneu Altres icones i després feu clic sobre el botó .
Aneu a la carpeta en la que heu desat la icona, seleccioneu-la i feu clic a .
Premeu el botó i seguiu fent el mateix amb les altres etiquetes, si n'hi ha, o bé feu clic sobre per a finalitzar.
Posem que us agradaria afegir algunes funcions comunes de Quanta Plus a la vostra barra d'eines o potser penseu que la barra d'eines podria estar més ben organitzada, amb separadors per agrupar les accions. Obriu el diàleg Configura barres d'eines usant ->. Assegureu-vos de que està seleccionada la vostra barra d'eines.
Escolliré el separador (a dalt de la columna esquerra) per a la meva barra d'eines. Una vegada heu seleccionat l'ítem que voleu afegir a la barra d'eines, premeu el botó de cursor dret. Tot seguit s'afegirà a la vostra barra d'eines.
Suposo que us agradaria tenir una manera d'accedir ràpidament a Veure amb Konqueror. El selecciono i l'afegeixo a la barra d'eines,
Mireu com el separador ajuda a agrupar. Algú que tingui un primer contacte amb la meva barra d'eines podria haver pensat que el botó de Konqueror era igual o el contrari al botó de començament.
Apliqueu els vostres canvis i, quan ho tingueu fet, premeu per a finalitzar.
Ah, mireu quant de fantàstica és la barra d'eines nova! Ara es molt més útil.
Recordeu provar la vostra barra d'eines, fent clic sobre tots els botons per a verificar que la sortida és correcta.
Ara, per a desar la barra d'eines, escollirem ->->.
Desar-la a la carpeta adequada. Ja que no hi ha NeXML, la desaré en la carpeta principal, però hauríeu de desar les vostres barres d'eines en la carpeta adequada. Assegureu-vos d'ajustar el vostre description.rc per a que carregi la(es) vostra(es) barra(es) d'eines quan es crei un fitxer nou d'aquest tipus.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Probablement els afegits més notables en Quanta Plus per a l'usuari general siguin l'afegit de documentació per al llenguatge de marcat o d'script que preferiu. Amb aquesta finalitat, aquest capítol explicarà com he creat l'arbre de documentació PHP per al meu ús personal.
Abans de començar a crear la vostra pròpia documentació, potser voleu comprovar el repositori de Quanta Plus per a veure si algú ja ho ha fet.
Hi ha dues parts en aquest procés. Primer, obtenir la documentació existent per al llenguatge de marcat/script/etc. que voleu. Segon, heu de crear el fitxer docrc. El primer es cosa vostra, el segon és el que es tracta aquí.
La forma general del fitxer docrc és la següent:
#Fitxer de configuració del KDE
[Tree]
Doc dir=ruta, relativa a aquest fitxer, dels fitxers html de la documentació p.ex. php42/
#elements de nivell superior
Top Element=La vostra descripció d'aquesta documentació p.ex. PHP 4.2 documentation
Section 1=Section1.html
Section 2=#Sec2.1,#Sec2.2,#Sec2.3
Sec2.1=Sec2.1.html
Sec2.2=Sec2.2.html
Sec2.3=Sec2.3.html
...
[Context]
ContextList=func1,func2,tag1,tag2,tag3
func1=func1.html
func2=func2.html
tag1=tag1.html
tag2=tag2.html
tag3=tag3.html
El docrc està dividit en dues seccions: L'arbre i el context.
La secció 'Tree' (arbre) defineix l'aspecte de la presentació de la documentació en la pestanya de documentació. Per exemple, veureu que en la documentació PHP teniu quelcom semblant a això:
En relació a l'anterior, el meu docrc de PHP té aquest aspecte:
#Fitxer de configuració del KDE [Tree] Doc dir=php42/ #elements de nivell superior Top Element=PHP 4.2 documentation PHP 4.2 documentation=Table of Contents,#Getting Started,#Language Reference Table of Contents=index.html Getting Started=Introduction, ... Introduction=introduction.html ... Language Reference=Basic syntax, ... Basic syntax=language.basic-syntax.html ...
Tingueu present el # que està davant de “Getting Started” (començar) i de “Language Reference” (referència del llenguatge). Indica que són subcontenidors de l'arbre i tenen contingut propi. No crec que hi hagi establert un límit de profunditat (més del que sigui raonable) — empreu el vostre bon judici.
Per a la Taula de contingut, haureu notat que es fa referència directa a un fitxer (i per tant, es mostra al final de la vista en arbre — les carpetes primer!).
Els espais no afecten negativament a res, però tingueu cura amb els caràcters & i <. Els heu de substituir amb & i < respectivament en tots els fitxers font de Quanta Plus basats en XML.
Context és la secció del fitxer docrc que s'usa per a facilitar l'ajuda de context. Per exemple, si esteu escrivint un script PHP i us agradaria veure la documentació per a la funció mysql_fetch_array. Simplement ressalteu la funció i després premeu Ctrl+H per accedir a l'ajuda de context. Immediatament es mostrarà la documentació de mysql_fetch_array. Aquí tan sols hi ha dos tipus d'entrades: ContextList i les línies d'associació de fitxers.
Realment simple. És una llista separada per comes amb els ítems del context que voleu que estiguin disponibles (per a PHP, són les funcions pròpies de PHP).
Són de la forma ítem_de_context=pàgina_de_doc_html». p.ex., acos=function.asoc.html
Una versió reduïda de la secció Context del meu docrc és:
#Paraules clau per a l'ajuda de context [Context] ContextList=abs,acos,acosh,addcslashes,addslashes,... abs=function.abs.html acos=function.acos.html acosh=function.acosh.html addcslashes=function.addcslashes.html addslashes=function.addslashes.html ...
Now you can just save your docrc file, save it in $ or HOME/.kde/share/apps/quanta/doc$ for local or global use respectively. Then create a folder (the one specified in your KDEDIR/share/apps/quatna/docdocrc file) in the same folder as your docrc file and copy your HTML pages in there.
Caldrà reiniciar el Quanta Plus per a veure la vostra documentació.
Una vegada esteu segur de que és prou bo per a compartir-lo, envieu el fitxer docrc junt amb una descripció de qualsevol informació pertinent sobre quins documents heu usat al repositori de Quanta Plus per a que el pugui usar la comunitat de Quanta Plus. No us fareu ric, però us sentireu gran sabent que heu contribuït al desenvolupament de la millor plataforma de desenvolupament web.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Amb Quanta Plus no us sentireu sòl. És possible compartir amb els demés els diversos recursos (paquets DTEP, barres d'eines amb accions, scripts, plantilles). Hi ha dues formes de fer-ho:
Els recursos es poden enviar per correu electrònic als vostres amics, companys o a qui es vulgui. Podeu accedir a l'entrada del menú Envia per correu-e des de varis llocs, com ->, ->, en el menú de context dels fitxers i carpetes en els arbres Plantilles i Scripts.
Els recursos es poden publicar en el repositori principal, des d'on els poden descarregar tots els demés usuaris de Quanta Plus. Els enviaments es revisen i tan sols es publiquen si el nostre equip els considera correctes i d'utilitat. Per a fer un enviament vàlid, es suggereix signar les fonts, per al que us caldrà una clau GPG/PGP. Aquesta informació s'usa per a que tant el nostre equip com aquells que la descarreguin puguin verificar l'origen.
Per a saber com obtenir els recursos des del servidor principal, podeu veure “Obtenir recursos”.
Quan aneu a publicar, se us demanarà una frase de pas per a la vostra clau GPG secreta (la frase de pas no serà desada) o, en el cas de que tingueu més claus secretes, podreu escollir la que voleu usar. En la caixa de diàleg Compartir les novetats, ompliu els camps d'entrada (la URL de la vista prèvia pot romandre buida) i inicieu la publicació fent clic sobre Bé.
Es pot iniciar la publicació des de ->, ->, en el menú de context dels fitxers i de les carpetes en els arbres Plantilles i Scripts.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
És possible actualitzar Quanta Plus sense obtenir una versió nova, i tan sols obtenint fonts noves com paquets DTEP, barres d'eines amb accions, plantilles, scripts i documentació. Una possibilitat és que heu obtingut les fonts per correu electrònic o que les heu descarregat des d'un servidor web, en aquests casos normalment les haureu d'instal·lar manualment. Si teniu sort, també podreu obtenir un script d'instal·lació del lloc de procedència de les fonts. Però Quanta Plus té un servidor dedicat a hostatjar fonts que, o bé no s'han inclòs en la distribució principal per la seva mida o el seu escàs ús, o s'han fet arribar més tard, i dits recursos s'instal·len automàticament. Per a descarregar-los s'usen les diverses entrades del menú Descarrega. Les podeu trobar a ->, ->, en el menú de context d'una àrea buida o d'un ítem de nivell superior en els arbres Plantilles, Scripts i Documentació.
Una vegada descarregats els recursos, però abans d'haver-los instal·lat, Quanta Plus comprova si el recurs és vàlid, comprovant la integritat i la signatura. En el cas d'haver-hi problemes, us avisarà i deixarà en les vostres mans la decisió de continuar o no. Si us plau, llegiu amb atenció els diàlegs d'avís. En el cas de que la integració sigui correcta i de que el recurs estigui signat correctament, també es mostrarà un diàleg informatiu, per a que pugueu veure qui va crear el recurs.
Assegureu-vos de que instal·leu els recursos, especialment les barres d'eines i els scripts, tan sols des de llocs de confiança!
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
És possible treballar amb llenguatges XML que encara no estiguin suportats per Quanta Plus, creant un paquet DTEP. Però en la creació podeu trigar força temps, atès que haureu de crear cents de fitxers d'etiquetes en format tagXML. Per descomptat, hi ha una manera més agradable de fer-ho, que és convertir automàticament la DTD en un paquet DTEP.
La conversió es pot iniciar des del menú ->. Seleccioneu el fitxer .dtd que defineixi la DTD que voleu usar i després veureu el següent diàleg:
Les entrades són:
Nom del directori de destí: el DTEP creat anirà amb aquest nom a la carpeta $KDEHOME/share/apps/quanta/dtep
Nom: el nom (cadena de definició) de la DTD
Sobrenom: el nom d'usuari visible del DTEP
Línia de definició !DOCTYPE: la cadena que hauria d'aparèixer en l'etiqueta !DOCTYPE, tal com HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"
URL de la DTD: la URL que apunta cap al fitxer de la DTD
Extensió per omissió: la extensió que es sol usar per als fitxers que siguin escrits segons aquesta DTD
Etiquetes i atributs sensibles a les majúscules: s'explica per sí mateix, normalment és certa per a totes les variants del llenguatge XML
Afinar el DTEP després de la conversió: si està marcada, després de la conversió Quanta Plus mostrarà l'editor de description.rc, per a poder afinar el DTEP creat. Es recomana deixar aquesta opció sense marcar.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Perdoneu si he escrit o lletrejat incorrectament el vostre nom!
Moltes gràcies a tots els que han gastat el seu temps col·laborant!
L'equip de desenvolupament de Quanta Plus:
Editor CSS original.
Kommander, diverses característiques i correcció d'errors.
Pantalla de presentació per a moltes versions
Disposició visual de la pàgina i el sistema de desfer/refer
Depurador de PHP4
Assistent de marcs
Varies correccions, codi fundacional per al anàlisis de DTD i treball relacionat amb la DTD
Traducció al danès
The Anal XML Guy i la documentació
XSL 1.0 DTEP, KXsldbg
Documentació, correccions d'errors i entorn del depurador de PHP.
Gestor de projecte i administració del lloc web.
Desenvolupador principal
Codificació, documents TagXML originals i més
Documentació
Documentació
Afegit i manteniment de les DTD
Antic desenvolupador del nucli — ho va deixar per la versió comercial
Diàleg de pujada basat en arbre
Antic desenvolupador del nucli — ho va deixar per la versió comercial
Gràcies en especial a:
Els escriptors de libxml2 i libxslt.
Quanta Plus © 2000, 2001, 2002, 2003 l'equip de desenvolupament de Quanta Plus.
Manual d'usuari de Quanta Plus © 2002, 2003 l'equip de desenvolupament de Quanta Plus.
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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
aquesta aplicació forma part del projecte KDE http://www.kde.org/.
aquesta aplicació pot trobar-se en el paquet kdewebdev en ftp://ftp.kde.org/pub/kde/, el servidor FTP principal del projecte KDE.
Per a poder compilar i instal·lar aquesta aplicació al vostre sistema, introduiu el següent en el directori arrel de la distribució de aquesta aplicació:
%./configure%make%make install
Donat que aquesta aplicació empra autoconf i automake no hauria de produir-se cap complicació durant la compilació. Si us trobeu amb cap problema, si us plau, informeu-ne a les llistes de correu de KDE.
És raonable que vulgueu personalitzar la localització dels fitxers de Quanta Plus en el vostre sistema. Per a fer-ho, autoconf disposa de diverses opcions que se li poden passar a l'script configure per a controlar aquesta configuració. Per obtenir una llista completa de les opcions, escriviu ./configure --help. Aquí es descriuen aquestes opcions.
Si teniu problemes amb l'execució correcta de Quanta Plus, hauríeu de comprovar la vostra ruta per assegurar que la carpeta bin hi està. Assegureu-vos també que no teniu cap versió anterior de KDE que aparegui a la PATH abans de la vostra carpeta bin de KDE 3. El mateix s'aplica per a Qt™.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Una expressió vàlida que defineix quines dades són requerides. Mireu el lloc web del W3C®
Un nom plenament qualificat. Per exemple, xsl:meva_variable. Mireu el lloc web del W3C®
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team