natgillin/translations-raw huggingface dataset:
El repositori principal conté normalment un projecte col· laboratiu (comercial o no), però podeu aprofitar les característiques de control que ofereix & CVS; i també per a un projecte desenvolupat exclusivament per vós. És fàcil establir un repositori local, i obtenir la capacitat de rastrejar els canvis que causen els errors, desfer els canvis, evitar la pèrdua accidental d' informació, & etc;.
The main repository usually holds a collaborative project (commercial or not), but you can take advantage of the nice revision control features offered by & CVS; even for a project developed exclusively by you. It is easy to set up a local repository, and you will gain the ability to track changes that caused bugs, revert changes, avoid accidental loss of information, & etc;.
El repositori conté els fitxers del projecte, i cada contribuïdor manté la seva pròpia còpia local, anomenada còpia de treball o còpia local; podeu afegir les vostres modificacions al repositori principal (un procés anomenat & quot; publicacióquot;) i/ o actualitzar les còpia pròpia per a reflectir els canvis recents fets per altres contribuïdors.
The repository holds the project files, and every contributor keeps their own local copy, named working copy or sandbox; one can then add their modifications to the main repository (a process called & quot; committingquot;) and/ or update their own copy to reflect recent changes made by other contributors.
Accedint al repositori
Accessing The Repository
En aquesta secció, us mostrarem com usar les funcionalitats bàsiques del sistema de control de versions usant & cervisia; per obtenir els mòduls des del repositori i treballar amb ells. Per a fer- ho, heu de tenir accés al repositori com a client, entenent que algú (probablement l' administrador del repositori & CVS;) us a donat un compte en la màquina del servidor. Alternativament, podeu crear fàcilment un repositori local pel vostre propi projecte.
In this section, we show how to use the basic version control system functionality using & cervisia; to checkout modules from the repository and work with them. To do that, you must have access to the repository as a client, meaning that someone (probably the administrator of the & CVS; repository) gave you an account on the server machine. Alternatively, you can easily create a local repository for your own project.
Si esteu planejant desenvolupar un projecte complex, és una bona idea usar les característiques de & CVS;, encara que sigueu l' únic desenvolupador. Podeu fer tots els canvis en la còpia de treball, i usar el & cervisia; (o una altra eina & CVS;) per actualitzar i publicar. D' aquesta manera, guanyeu la capacitat de seguir els canvis que causen errors, revertir- los, prevenir la pèrdua accidental d' informació, & etc;. Usant el & cervisia; és fàcil crear un repositori local.
If you plan to develop a complex project, it is a good idea to use the & CVS; features, even if you are the only developer. You can make all changes in the working copy, and use & cervisia; (or any other & CVS; tool) to update and commit. This way, you will gain the ability to track changes that caused bugs, revert changes, avoid accidental loss of information, & etc;. Using & cervisia;, it is simple to create a local repository.
Creació d' un repositori local
Creating a Local Repository
Obriu el diàleg Crea un nou repositori (cvs init) seleccionant Repositori Crea....
Open the Create New Repository (cvs init) dialog by choosing Repository Create....
Premeu el botó... per seleccionar la carpeta on voleu crear el repositori, o bé introduïu la seva ubicació en la caixa de text. Per exemple, si voleu emplaçar el repositori en la carpeta / home/ usuari, i anomenar- lo cvsroot, hauríeu d' escriure / home/ usuari/ cvsroot en la caixa de text, o bé seleccionar la carpeta / home/ usuari usant el diàleg de selecció de fitxers i afegir cvsroot.
Press the... button to select the folder where you want to create the repository, or enter its location in the text box. For instance, if you want to place the repository in the / home/ user folder, and to name it cvsroot, you should type / home/ user/ cvsroot in the text box, or select the / home/ user folder using the file picker, and add cvsroot.
Confirmeu- ho prement el botó Bé. & cervisia; crearà i inicialitzarà la nova carpeta de repositori.
Confirm by pressing the OK button. & cervisia; will create and initialize the new repository folder.
Ara podreu importar el vostre treball actual en el repositori, o simplement crear una carpeta en el repositori per començar un nou mòdul des de zero.
Now you can import your current work to the repository, or simply create a folder in the repository to start a new module from scratch.
& cervisia; ofereix un frontal integrat per gestionar totes les ubicacions dels vostres repositoris, el diàleg Configura l' accés als repositoris. Per a mostrar- lo, seleccioneu l' element del menu Repositori Repositoris....
& cervisia; offers an integrated front-end to manage all your repository locations, the Configure Access to Repositories dialog. To display it, select the Repository Repositories... menu item.
Una instantània del diàleg Configura l' accés als repositoris del & cervisia;
A screenshot of & cervisia; 's Configure Access to Repositories dialog
Hi ha diferents mètodes per accedir a un repositori & CVS;. A través d' una autenticació per contrasenya (: pserver:), intèrpret d' ordres segur (usant: ext:), repositori local (: local:), & etc;. El format pel repositori local és (els elements opcionals apareixen entre claudàtors):
There are several methods to access a & CVS; repository. It may be reached via password authentication (: pserver:), secure shell (using: ext:), local repository (: local:), & etc;. The format for the repository location is (optional items appear between square brackets):
[: mètode:] [[usuari] [: contrasenya] @] nom de la màquina [: [port]] / ruta/ al/ repositori
[: method: ][[user][: password]@]hostname[: [port]]/ path/ to/ repository
No sempre són necessaris tots aquests elements (usuari, contrasenya, nom de la màquina, port) per accedir al repositori. La informació necessària depèn del mètode d' accés usat, que pot ser categoritzat com segueix:
Not all these items (user, password, hostname, port) are always necessary to access the repository. The required information depends on the access method used, which can be categorized as follows:
El mètode d' accés local és el mètode predeterminat usat per & CVS;. Per tant, és opcional afegir el mètode: local: a la ubicació del repositori: podeu simplement introduir la ruta a la carpeta que emmagatzema el repositori & CVS;, i és accessible des del vostre ordinador, com ara / ruta/ al/ repositori o per donar un exemple real, / home/ cvs.
The local access method is the default method used by & CVS;. Therefore, it is optional to add the: local: method to the repository location: you can enter simply the path to the folder which stores the & CVS; repository, and is accessible from your computer, like / path/ to/ repository or to give a real life example, / home/ cvs.
Pot estar físicament en un disc que està muntat via NFS, però aquest és un detall irrellevant. Si heu creat un repositori local, la ubicació serà senzillament la ruta cap a ell.
It may physically be on a disk which is mounted via NFS, but this is an irrelevant detail. If you created a local repository, the location will be simple the path to it.
& rsh;
& rsh;
La ubicació del repositori és alguna cosa semblant a: ext: nom_ usuari@ màquina. url. org: / ruta/ al/ repositori.
The repository location is something like: ext: username@host. url. org: / path/ to/ repository.
Aquest mètode requereix que tingueu un compte d' usuari en la màquina del servidor (en aquest exemple, màquina. url. org) i usar un intèrpret d' ordres remot per la comunicació. Per omissió & CVS; usa & rsh; per a fer- ho; no obstant això & rsh; s' ha considerat insegur durant molt de temps i normalment és reemplaçat per & ssh;.
This method requires that you have a user account on the server machine (in this example, host. url. org) and use a remote shell for communication. By default, & CVS; uses & rsh; for this purpose; however, & rsh; has long considered to be insecure, and is widely replaced by & ssh;.
SI voleu usar & ssh;, heu d' establir la variable d' entorn $CVS_ RSH a & ssh; en usar el client cvs, & cervisia; implementa això de manera senzilla.
If you wish to use & ssh;, you must set the environment variable $CVS_RSH to & ssh; when using the cvs client. & cervisia; supports this easily.
Tingueu en compte que el & cervisia; no pot respondre a les possible peticions de contrasenya de la màquina del servidor. Us heu d' assegurar que l' inici de sessió remot funciona sense que hageu d' introduir una contrasenya. Amb & rsh; vanilla pla, això es pot aconseguir, per exemple, creant un fitxer anomenat. rhosts en la vostra carpeta personal amb una llista de màquines autenticades (mireu la pàgina & rsh; del manual).
Note that & cervisia; cannot answer possible password requests from the server machine. You must make sure that a remote login works without requiring you to enter the password. With plain vanilla & rsh;, this can be achieved for example by creating a. rhosts file in your home folder with a list of trusted hosts (see the & rsh; manpage).
Amb & ssh; això es pot aconseguir copiant la vostra clau pública ubicada en el fitxer identity. pub, ubicat en la carpeta $HOME /. ssh / del servidor. En aquest cas, la clau no ha d' estar encriptada amb un mot de pas (mireu la pàgina & ssh; del manual i & CVS; / SSH FAQ en SourceForge). Si no esteu segur quant a aquestes qüestions, contacteu amb el vostre administrador del sistema.
With & ssh;, it can be achieved by copying your public key located in the file identity. pub, located in the $HOME /. ssh/ folder to the server. In this case, the key must not be encrypted with a passphrase (see the & ssh; manpage and the & CVS; / SSH FAQ on SourceForge). If you are unsure about these issues, ask your system administrator.
pserver
pserver
La ubicació del repositori s' ha de veure com: pserver: nom_ usuari@ màquina. url. org: / ruta/ al/ repositori
The repository location looks like: pserver: username@host. url. org: / path/ to/ repository
Aquest mètode accedeix al servidor mitjançant un protocol especial amb una autenticació relativament feble (pserver per a l' autenticació de contrasenya). Abans de poder utilitzar aquest servidor, necessiteu un nom d' usuari i la contrasenya donada per l' administrador del servidor del & CVS;, i heu d' iniciar la sessió. Tingueu en compte que el vostre nom d' usuari d' autenticació de contrasenya del & CVS; no ha de coincidir necessàriament amb el nom d' usuari del sistema. Abans d' accedir al servidor del & CVS;, necessitareu iniciar la sessió.
This method accesses the server via a special protocol with a relatively weak authentication (pserver stands for password authentication). Before you can use such a server, you need a username and password given by the & CVS; server administrator, and you have to login. Note that your & CVS; password authentication username does not necessarily match the system's username. Before accessing the & CVS; server, you will need to login.
El projectes de codi obert normalment ofereixen accés anònim & CVS; al seu codi font. Això significa que podeu obtenir fàcilment el darrer codi font, modificar- lo i crear pedaços (diferències) contra el repositori sense que se us demani un compte & CVS;. Com a regla general, el & CVS; anònim usa autenticació per contrasenya (: pserver:) i és un repositori de només lectura, no permetent- vos pujar els vostres canvis directament.
Open-source projects typically offer Anonymous & CVS; access to their sources. This means you can easily grab the latest sources, modify, and create patches (differences) against the repository without asking for a & CVS; account. As a general rule, Anonymous & CVS; uses password authentication (: pserver:), and is a read-only repository, not allowing you to upload your changes directly.
Coneixent el mètode d' accés i la ubicació del repositori, podeu afegir- lo a la llista de repositoris del & cervisia;:
Knowing the access method and location to the repository, you can add it to & cervisia; 's repositories list:
Afegir un nou repositori
Adding a New Repository
Obriu el diàleg Configura l' accés als repositoris seleccionant l' element del menú Repositori Repositoris....
Open the Configure Access to Repositories dialog by choosing the Repository Repositories... menu item.
Premeu el botó Afegeix... per obrir el diàleg Afegeix repositori.
Press the Add... button to open the Add Repository dialog.
Introduïu la ubicació del repositori en la caixa de text Repositori:. & cervisia; desactivarà automàticament les àrees del diàleg que no són rellevants per al mètode d' accés que heu introduït.
Enter the repository location in the Repository: text box. & cervisia; will automatically disable the areas of the dialog that are not relevant to the access method you entered.
Si esteu usant el mètode ext per accedir al repositori, introduïu l' intèrpret d' ordres remot que voleu usar (pex; & ssh;) en la caixa de text Usa l' intèrpret d' ordres remot (només per a repositoris: ext:):.
If you are using the ext method to access the repository, enter the remote shell you wish to use (eg; & ssh;) in the Use remote shell (only for: ext: repositories): text box.
Premeu Bé. Veure el repositori que acabeu d' introduir en la llista dels repositoris.
Press OK. You will see the repository you just entered on the repositories list.
Si el mètode d' accés al repositori que acabeu d' introduir és autenticació per contrasenya (pserver), necessitareu iniciar sessió abans de connectar- vos al servidor. Cliqueu el repositori en la llista per seleccionar- lo i premeu el botó Accedeix.... Introduïu la vostra contrasenya en el diàleg que apareix.
If the access method to the repository you just entered is password authentication (pserver), you will need to login before connecting the server. Click the repository on the list to select it, and press the Login... button. Enter your password in the upcoming dialog.
Si heu introduït correctament la vostra contrasenya, la entrada de la columna Estat del repositori pserver canviarà de No s' ha accedit al compte a S' ha accedit al compte.
If you successfully enter your password, the Status column entry of the pserver repository will change from Not logged in to Logged in.
Premeu Bé per aplicar les modificacions o afegiu una altra ubicació a la llista. & cervisia; emmagatzemarà tantes ubicacions com vulgueu.
Press OK to apply your modifications, or add another location to the list. & cervisia; will store as many locations as you like.
Importació d' un mòdul en el repositori
Importing a Module Into the Repository
En aquesta secció, analitzarem com posar un nou projecte en el repositori & CVS;. Si només voleu treballar amb el projecte existent que ja està en un repositori, podeu saltar- vos aquesta secció.
In this section, we discuss how you can put a new project into the & CVS; repository. If you just want to work with an existing project which is already in a repository, you may skip this section.
Hi ha dos maneres de posar un projecte en el & CVS;:
There are two ways to put a project into the & CVS;:
Importar els fitxers i les carpetes a un nou mòdul, usant el diàleg d' importació del & cervisia;. Els Mòduls són les carpetes superiors de l' arbre de carpetes del repositori & CVS; i s' utilitzen per separar i organitzar els diferents projectes de programari dintre del repositori.
Import the files and folders to a new module, using & cervisia; 's import dialog. Modules are the top folders in the & CVS; repository folder tree, and are used to separate and organize the different software projects inside the repository.
Crear un mòdul buit i afegir nous fitxers i carpetes manualment. Tindreu més control, però probablement trigareu una mica més de temps.
Create an empty module and add the new files and folders manually. You will have more control, but it will probably take a little more time.
Tinguen en compte que & CVS; fou dissenyat inicialment per a gestionar fitxers de text. Moltes característiques, com ara el fusionat de revisions, la creació de diferències de forma que siguin llegibles, & etc; només són efectuades en fitxers de text. Això no vol dir que no pugeu usar & CVS; per mantenir fitxers binaris, senzillament significa que heu de especificar explícitament al & CVS; si és un fitxer de text o un fitxer binari. Si declareu un tipus de fitxers erroni, tindreu problemes amb la funcionalitat del & CVS; per a aquests fitxers i es podrien corrompre.
Keep in mind that & CVS; was initially designed to handle text files. Many features, like revision merging, creating differences in a readable form, & etc; are only performed to text files. This does not mean you cannot use & CVS; to keep binary files, it just means you have to explicitly tell & CVS; if it is a text or binary file. If you declare the wrong file type, you will experience problems with the & CVS; functionality for these files, and they may get corrupted.
La importació d' un projecte (com un mòdul nou) té alguns avantatges: importareu tots els fitxers i carpetes recursivament, i el mòdul es crearà automàticament. Això simplifica la importació de grans projectes existents en el repositori. No obstant això, hi ha alguns desavantatges: no es pot utilitzar el diàleg d' importació del & cervisia; per afegir fitxers als mòduls existents, i podeu importar els fitxers tant de text com fitxers binaris. Podeu solucionar aquesta limitació mitjançant la creació d' una carpeta amb els arxius de només un dels tipus, o informar dels patrons dels fitxers que han de ser ignorats en el procés d' importació.
Importing a project (as a new module) has some advantages: you will import all files and folders recursively, and the module will automatically be created for you. This makes importing large existing projects to the repository easier. However, there are some disadvantages: you cannot use & cervisia; 's import dialog to add files to existing modules, and you can either import the files as text or binary files. You can work around this limitation by creating a folder with files of only one of the types, or by informing the patterns of the files that should be ignored during the import process.
Per exemple, suposant que el vostre projecte només contingui fitxers de text i algunes imatges PNG (fitxers binaris). Podeu dir a & CVS; que ignori tots els fitxers que continguin el patró *. png mentre importa els altres fitxers com a text, o podeu moure les imatges a una carpeta separada i després importar els fitxers restants (com a fitxers de text). De qualsevol manera haureu de fer un checkout del modul importat recentment a una nova còpia de treball i copiar- ne els fitxers i carpetes restants, afegir i publicar al repositori per a completar el procés d' importació.
For instance, suppose your project contains text files and some PNG images (binary files) only. You can tell & CVS; to ignore all files with the pattern *. png while importing the other files as text, or you can move the images to a separate folder, and then import the remaining files (as text files). Either way, you will have to checkout the newly imported module to a new working copy, copy the missing files and folders to it, add and commit them to the repository to complete the import process.
Alternativament, podeu afegir els fitxers i les carpetes manualment, creant un modul buit. Per afegir un modul buit a un repositori, simplement heu de crear una nova carpeta en la carpeta arrel del repositori del & CVS;. El nom d' aquesta carpeta serà el nom del modul. Feu un Checkout del nou modul buit. Després copieu els fitxers i carpetes a la còpia de treball, afegir i publicar per pujar- ho tot al repositori del & CVS;.
As an alternative, you can add the files and folders manually, creating an empty module for them. To add an empty module to a repository, just create a new folder in the & CVS; repository root folder. The name of this new folder will be the name of the module. Checkout the new empty module. Then copy the files and folders to the working copy, add and commit to upload them to the & CVS; repository.
Una instantània del diàleg d' importació del & cervisia;
A screenshot of & cervisia; 's import dialog
En podeu veure el diàleg que us ajudarà a importar un projecte com a un modul. Per accedir al diàleg d' importació del & cervisia;, seleccioneu l' element del menú Repositori Importa....
In you can see the dialog which helps you to import a project as a module. To access & cervisia; 's import dialog, choose the Repository Import... menu item.
Repositori:
Repository:
Introduïu o seleccioneu de la caixa de llista desplegable el nom del repositori & CVS;, també conegut com a $CVSROOT. Heu de tenir accés d' escriptura per accedir- hi i el repositori ha d' estar adequadament inicialitzat. Si el repositori encara no existeix, podeu crear- ne un seleccionant l' element del menú Repositori Crea....
Enter or select from the drop down box the name of the & CVS; repository, also known as $CVSROOT. You must have write access to it, and the repository must be properly initialized. If the repository does not yet exist, you can create one choosing the Repository Create... menu item.
La caixa de llista desplegable mostra una llista dels repositoris que heu introduït prèviament usant la caixa de diàleg Configura l' accés als repositoris. Si el repositori és remot, assegureu- vos que l' autenticació funciona. Mireu per a més informació.
The drop down box shows a list of the repositories you previously entered using the Configure Access to Repositories dialog box. If the repository is remote, make sure that authentication works. See for more information.
Mòdul:
Module:
El nom del mòdul sota el qual serà emmagatzemat el projecte. Després d' importar- lo, el projecte pot ser obtingut sota aquest nom. Mireu per a més informació. Aquest també és el nom de la carpeta corresponent en el repositori.
The name of the module under which the project will be stored. After the import, the project can be checked out under this name. See for more information. This is also the name of the corresponding folder in the repository.
Carpeta de treball:
Working Folder:
La carpeta de nivell superior del projecte que voleu importar. La importació comença a partir d' aquesta carpeta i baixa recursivament.
The toplevel folder of the project you want to import. The import starts from this folder and goes down recursively.
Etiqueta del distribuïdor:
Vendor tag:
L' etiqueta del distribuïdor s' ha usat històricament pel seguiment de fonts de tercers. Només heu d' utilitzar el vostre nom d' usuari si no teniu cap idea millor. El que introduïu aquí no importa massa.
The vendor tag is historically used for tracking third-party sources. Just use your user name if you have no better idea. It does not matter much what you enter here.
Etiqueta de llançament:
Release tag:
Aquesta etiqueta també s' ha usat històricament per importar diferents versions de programari de tercers. Si no esteu fent això, useu la paraula inicial o una cadena FOO_ 1. 0 on FOO és el nom del projecte, i 1. 0 és el número de versió del llançament importat.
This tag is also historically used for importing different versions of third-party software. If you are not doing this, use the word start or a string FOO_1_0 where FOO is the name of your project and 1.0 is the version number of the imported release.
Ignora fitxers:
Ignore files: