Introducci=C3=B3n

=20 -1.0 -2006-07-29 +2.3 +2009-01-18 =20 Introducci=C3=B3n @@ -27,11 +30,10 @@

Audiencia -

-=C3=89ste documento ha sido escrito para desarrolladores de Gentoo y -miembros del equipo de Gentoo. Si usted es usuario de Gentoo, o solo -desea empezar a usar y descargar de los overlays, por favor mire Gentoo Overlays: Gu=C3=ADa del Usuario.

@@ -39,36 +41,18 @@

=20

-=C2=BFQu=C3=A9 es overlays.gentoo.org? - - -

-overlays.gentoo.org -provee un espacio social que permite a los desarroladores de proyectos -de Gentoo y a sus usuarios colaborar juntos en los futuros paquetes de -Gentoo. Realizamos =C3=A9sto, hospedando overlays para proyectos de Gent= oo -y overlays para desarrolladores de Gentoo. -

- -

=C2=BFQui=C3=A9n puede usar overlays.gentoo.org? -

Cualquier proyecto de Gentoo, o desarrollador de Gentoo puede tener su -propio overlay hospedado en overlays.gentoo.org, incluyendo el RSS -feed de su changelog en la -p=C3=A1gina de overlays.gentoo.org. +propio overlay alojado en (git.)overlays.gentoo.org, incluyendo el feed = RSS +de su changelog en el planeta +overlays.gentoo.org.

=20

-Cualquier miembro del equipo de Gentoo o usuario (p. e., cualquiera -que no tenga acceso a escritura en el =C3=A1rbol principal de paquetes d= el -Portage) puede descargar y usar los contenidos de cualquier overlay -hospedado. Si lo desea, puede tambi=C3=A9n otorgar acceso de escritura a -los usuarios de su overlay. +Cualquier usuario puede descargar y usar los contenidos de cualquier ove= rlay +alojado. Si lo decide, tambi=C3=A9n puede dar acceso de escritura a su o= verlay.

@@ -76,36 +60,34 @@

=C2=BFQu=C3=A9 me da overlays.gentoo.org? -

-Actualmente overlays.gentoo.org provee: +Actualmente el servicio (git.)overlays.gentoo.org ofrece:

Trac (un wiki m=C3=A1= s un - navegador de Subversion integrado), para crear y mantener la - documentaci=C3=B3n de su overlay de manera r=C3=A1pida
Subversion - un - sistema de control de versiones centralizado (sistemas de control de - versiones distribuidos ser=C3=A1n soportados en un futuro)
La publicaci=C3=B3n del changelog de su overlay en la p=C3=A1gina de o.g.o, as= =C3=AD - todo el que est=C3=A9 interesando puede ver qu=C3=A9 sucede.
Publicaci=C3=B3n del changelog de su overlay en la p=C3=A1gina principal de o.g.o= , de + forma que todo el mundo que est=C3=A9 interesado pueda ver lo que est=C3= =A1 + ocurriendo
gitweb - ofrec= e una + interfaz web perfectamente preparada para ver los repositorios Git.

=20

-... todo hospedado en la segura y respaldada infraestructura de -Gentoo, administrada por el equipo +... todo alojado en la segura y respaldada infraestructura de Gentoo, +administrada por el equipo de infraestructura de Gentoo (hardware / OS base) y el equipo de Overlays de Gentoo (wiki / VCS / ACLs).

=20

-Cada overlay tiene listas de autenticaci=C3=B3n por separado para Trac y -Subversion. No hay problema alguno en dar acceso de escritura a -alguien a Trac (p. e., para escribir documentaci=C3=B3n) sin darle acces= o a -escritura en Subversion. +Cada overlay tiene listas de autenticaci=C3=B3n distintas para Trac, Sub= version +y Git. No hay problema alguno en dar acceso de escritura a alguien s=C3=B3= lo a +Trac (p. e., para escribir documentaci=C3=B3n) sin darle acceso de escri= tura en +Subversion.

@@ -116,16 +98,14 @@ =20

No tiene que hacerlo. No es necesario que tenga un overlay, y si tiene -alguno, es absolutamente libre de poner su overlay donde desee. No -debe hospedar un overlay en o.g.o para que sea considerado -"oficial". +alguno, es absolutamente libre de alojar su overlay donde desee. No es +necesario alojar un overlay en o.g.o para que sea considerado "oficial".

=20

La ventaja de usar overlays.gentoo.org es la de tener todo ya -configurado. Usted no necesita administrar su propio servidor, o -preocuparse de las actualizaciones de software. Nosotros nos ocupamos -de todo eso por usted. +configurado. No necesita administrar su propio servidor, o preocuparse d= e +las actualizaciones de software. Nosotros nos ocupamos de todo eso por u= sted.

@@ -136,55 +116,52 @@ =20

El prop=C3=B3sito de o.g.o es el de ayudar a salvar las distancias entre -desarrolladores y usuarios. Gentoo es una distribuci=C3=B3n basada en la -comunidad, y creemos que nuestros usuarios son tan importantes en la -comunidad como los desarrolladores. +desarrolladores y usuarios. Gentoo es una distribuci=C3=B3n basada en la= comunidad, +y creemos que nuestros usuarios son tan importantes en la comunidad como= los +desarrolladores.

=20

-Todos los overlays hospedados en o.g.o est=C3=A1n ah=C3=AD para que los = usuarios -los usen y descarguen de ellos. Es decisi=C3=B3n de los usuarios cu=C3=A1= l -software instalar=C3=A1n en sus computadoras - y eso incluye elegir usar= su -overlay. Algunos usuarios tomar=C3=A1n malas decisiones, y terminar=C3=A1= n -malogrando su computadora. Incluso podr=C3=ADan llegar a culpar a Gentoo -por ello. Eso est=C3=A1 bien; esas personas probablemente vayan culpando= a -todos excepto a ellos por sus propios errores, y es probable que usted -no pueda hacer nada al respecto. Pero a=C3=BAn as=C3=AD ninguno de nosot= ros -tiene el derecho de elegir por ellos. +Todos los overlays alojados en o.g.o est=C3=A1n ah=C3=AD para que los us= uarios los usen +y descarguen desde ellos. Es decisi=C3=B3n de los usuarios el software q= ue +instalar=C3=A1n en sus computadoras - y eso incluye elegir usar su overl= ay. +Algunos usuarios tomar=C3=A1n malas decisiones, y terminar=C3=A1n malogr= ando su +computadora. Incluso podr=C3=ADan llegar a culpar a Gentoo por ello. Eso= est=C3=A1 bien; +esas personas probablemente vayan culpando a todos excepto a ellos por s= us +propios errores, y es probable que usted no pueda hacer nada al respecto= . Pero +a=C3=BAn as=C3=AD ninguno de nosotros tiene el derecho de elegir por ell= os.

=20

Los usuarios son libres (de hecho, los animamos) de brindar opiniones -constructivas acerca de cualquier tema relacionado con Gentoo - -incluyendo a los overlays hospedados en o.g.o. Esa retroalimentaci=C3=B3= n -puede venir v=C3=ADa bugs.g.o., v=C3=ADa correo al equipo del proyecto o -directamente a usted; v=C3=ADa foros, o por el IRC. No hablamos de los -usuarios verdaderamente abusivos; no tenemos tiempo para ellos, y -nadie espera que usted lo tenga. +constructivas acerca de cualquier tema relacionado con Gentoo - incluyen= do +todos los overlays alojados en o.g.o. Esa retroalimentaci=C3=B3n puede v= enir v=C3=ADa +bugs.g.o., v=C3=ADa correo al equipo del proyecto o directamente a usted= ; v=C3=ADa +foros, o por el IRC. No hablamos de los usuarios verdaderamente abusivos= ; no +tenemos tiempo para ellos, y nadie espera que usted lo tenga.

=20 -Si no es feliz con los usuarios que usan su overlay, y/o no desea -que los usuarios lo molesten por =C3=A9l, entonces no use o.g.o para=20 -hospedar su overlay. +Si no es feliz con los usuarios que usan su overlay, y/o no desea ser +molestado por =C3=A9stos, entonces no use o.g.o para alojar su overlay. =20

-Otra cosa que necesitamos decir es que o.g.o es para hospedar -overlays. Usted no puede usarlo para convertirlo en un $UPSTREAM de -sus paquetes. Si ese es el tipo de hospedaje que necesita, puede usar -servicios SourceForge.net, Berlios, o el GentooExperimental.org -de Patrick. -

+o.g.o ten=C3=ADa restricciones de no ser el $UPSTREAM de los paquetes. E= sta +restricci=C3=B3n ha sido ajustada. Ahora ofrecemos alojamiento como el $= UPSTREAM, +pero s=C3=B3lo para paquetes que son espec=C3=ADficos de Gentoo o import= antes para +que corra el sistema Gentoo. Otros alojamientos pueden ser m=C3=A1s adec= uados, +algunos servicios en esta l=C3=ADnea son: +SourceForge.net, Berlios, o GentooExperimental.org = de +Patrick.

=20 -Requerimiento de Overlay +Solicitando un Overlay =20

Introducci=C3=B3n @@ -192,15 +169,14 @@ =20

Existen dos tipos de overlay - overlays de "proyecto", y overlays de -"desarrollador". La =C3=BAnica diferencia entre ellos es la -responsabilidad. +"desarrollador". La =C3=BAnica diferencia entre ellos es la responsabili= dad.

=20 -Antes de requerir un overlay, por favor aseg=C3=BArese de haber le=C3=AD= do -nuestro Documento de -Pol=C3=ADticas. Donde claramente se define qu=C3=A9 est=C3=A1 perm= itido y qu=C3=A9 -no, y cu=C3=A1les ser=C3=A1n sus responsabilidades. +Antes de solicitar un overlay, por favor aseg=C3=BArese de haber le=C3=AD= do nuestro +Documento de Pol=C3=ADticas. +Donde claramente se define qu=C3=A9 est=C3=A1 permitido y qu=C3=A9 no, y= cu=C3=A1les ser=C3=A1n sus +responsabilidades.

@@ -208,49 +184,56 @@

Overlays de Proyecto -

Los Overlays de "Proyecto" son overlays para proyectos oficiales de -Gentoo. Un buen ejemplo es el Overlay de -PHP. +Gentoo. Un buen ejemplo es +el Overlay de PHP.

=20

-Un proyecto oficial de Gentoo es aquel que tiene una p=C3=A1gina de -proyecto en www.gentoo.org, y un l=C3=ADder electo. (Esta definci=C3=B3n= viene -de (en ingl=C3=A9s) el documento -de metaestructura, el cu=C3=A1l es el documento que gobierna a -Gentoo). El(los) lider(es) de proyecto es responsable del overlay del -proyecto, incluyendo sus contenidos, y cualquier problema que =C3=A9stos +Un proyecto oficial de Gentoo es aquel que tiene una p=C3=A1gina de proy= ecto en +www.gentoo.org, y un l=C3=ADder electo. (Esta definici=C3=B3n viene del = documento de +metaestructura). El(los) l=C3=ADder(es) de proyecto son responsables del= overlay +del proyecto, incluyendo sus contenidos, y cualquier problema que =C3=A9= stos causen a otros proyectos y desarrolladores de Gentoo.

=20

-Para requerir un overlay de proyecto, el l=C3=ADder de =C3=A9ste solo ne= cesita +Para solicitar un overlay de proyecto SVN, el l=C3=ADder de =C3=A9ste so= lo necesita pasar por #gentoo-overlays en el IRC y solicitar que el overlay le sea -creado. O, si =C3=A9l/ella lo prefiere, puede env=C3=ADar un correo a +creado. O, si =C3=A9l/ella lo prefiere, puede enviar un correo a overlays@gentoo.org. Nosotros nos encargaremos del resto, incluyendo otorgar accesos de escritura a todos los miembros del proyecto (listados en la p=C3=A1gina de su proyecto).

=20 -

-Nosotros: -

- -

crearemos su overlay (sitio en trac + svn)
agregaremos el RSS feed de su overlay si es que a=C3=BAn no lo tie= ne
crearemos un cuenta en o.g.o para usted si a=C3=BAn no la tiene -
le daremos acceso de escritura al wiki Trac de su proyecto y al - repositorio de Subversion
le daremos acceso a todos los miembros del proyecto que ya - tengan una cuenta en o.g.o
contactaremos a todos los otros miembros de proyecto, y - ordenaremos su acceso

Para solicitar un overlay de proyecto Git, visite el sitio git.overlays, y siga las +instrucciones, enviando por correo electr=C3=B3nico la plantilla rellena= como est=C3=A1 +indicado. +

Para una solicitud SVN, nosotros:

crearemos su overlay (sitio trac + svn)
a=C3=B1adiremos el feed RSS de su overlay a la p=C3=A1gina de inicio= de o.g.o
le crearemos una cuenta en o.g.o si no tiene ya una
le daremos acceso de escritura al Trac, wiki y repositorio Subversio= n de +su overlay
le daremos acceso de escritura a todos los miembros de su proyecto q= ue ya +tienen una cuenta en o.g.o

Para una solicitud Git, nosotros:

crearemos su overlay (git, gitweb, sin trac)
a=C3=B1adiremos el feed RSS de su overlay a la p=C3=A1gina de inicio= de o.g.o
le crearemos una cuenta en o.g.o si no tiene ya una
le daremos acceso de escritura al repositorio Git de su overlay
le daremos acceso de escritura a todos los miembros de su proyecto q= ue ya +tienen una cuenta en o.g.o

=20 @@ -261,30 +244,39 @@

Los Overlays de "Desarrollador" son overlays manejados individualmente por desarrolladores de Gentoo. Un ejemplo de ello es Overlay de -tcort. +link=3D"http://overlays.gentoo.org/dev/beandog">Overlay de beandog= .

=20

Si tiene una direcci=C3=B3n de correo @gentoo.org y ha pasado la prueba = de -ebuilds entonces puede tener su propio overlay de desarrollador en -o.g.o. +ebuilds entonces puede tener su propio overlay de desarrollador en o.g.o= .

=20

-Para requerir un overlay de desarrolador, simplemente ingrese a -#gentoo-overlays en el IRC y solicite que el overlay le sea creado. O, -si prefiere, env=C3=ADe un correo a overlays@gentoo.org

+Para solicitar un overlay de desarrollador SVN, simplemente ingrese a +#gentoo-overlays en el IRC y solicite que el overlay le sea creado. O, s= i +prefiere, env=C3=ADe un correo a overlays@gentoo.org

+ +

Para solicitar un overlay de desarrollador Git, simplemente visite el +sitio git.overlays y = siga +las instrucciones, enviando por correo electr=C3=B3nico la plantilla rel= lena como +est=C3=A1 indicado.

=20 -

Nosotros:

Para una solicitud SVN, nosotros:

crearemos su overlay (sitio trac + svn)
a=C3=B1adiremos el feed RSS de su overlay a la p=C3=A1gina de inicio= de o.g.o
le crearemos una cuenta en o.g.o si no tiene ya una
le daremos acceso de escritura al Trac, wiki y repositorio Subversio= n de +su overlay

=20 +

Para una solicitud Git, nosotros:

crearemos su overlay (sitio en trac + svn)
agregaremos el RSS feed de su overlay si es que a=C3=BAn no lo - tiene
crearemos un cuenta en o.g.o para usted si a=C3=BAn no la tiene -
le daremos acceso de escritura al wiki Trac de su overlay y al - repositorio de Subversion
crearemos su overlay (git, gitweb, sin trac)
a=C3=B1adiremos el feed RSS de su overlay a la p=C3=A1gina de inicio= de o.g.o
le crearemos una cuenta en o.g.o si no tiene ya una
le daremos acceso de escritura al repositorio Git de su overlay

@@ -296,13 +288,11 @@

Ya que o.g.o est=C3=A1 dise=C3=B1ada para dar cabida tanto a desarrollad= ores de Gentoo y a usuarios de Gentoo, no creamos cuentas a nivel de sistema -'reales' en el host de o.g.o. Actualmente todos los accesos se -realizan a trav=C3=A9s de Apache, y estan manejados por el htpasswd de -Apache y archivos de htgroup. +'reales' en el host de o.g.o.

=20 -Usted *no* tiene acceso SSH a o.g.o. +*No* tiene acceso SSH a o.g.o. @@ -316,16 +306,15 @@ =20

-Usted puede acceder a su overlay tan pronto como =C3=A9ste sea creado. L= os -overlays de proyecto y de desarrolladores tienen distintas URLs, as=C3=AD -cada cual sabe qu=C3=A9 es de quien, a parte de ello son en iguales en t= odo -sentido. +Puede acceder a su overlay tan pronto como =C3=A9ste sea creado. Los ove= rlays de +proyecto y de desarrolladores tienen distintas URLs, as=C3=AD cada cual = sabe qu=C3=A9 +es de quien, aparte de esto son iguales en todos los sentidos.

=20

-*No* existen restricciones de lectura en los overlays o wikis. Todos -tienen completo acceso a todos los overlays y wikis. Si necesita un -overlay 'secreto' o algo as=C3=AD, entonces o.g.o no es para usted. +*No* existen restricciones de lectura en los overlays o wikis. Todos tie= nen +completo acceso a todos los overlays y wikis. Si necesita un overlay 'se= creto' +o algo as=C3=AD, entonces o.g.o no es lo adecuado.

@@ -333,7 +322,6 @@

Accediendo a los Overlays de Proyecto -

Si el overlay de su proyecto se llama 'foo', el wiki de su Trac estar=C3= =A1 aqu=C3=AD: http://overlays.gentoo.org/proj/foo/. @@ -342,13 +330,16 @@

Para verificar su repositorio en Subversion, ejecute:

svn co http://overla=
ys.gentoo.org/svn/proj/foo/

=20 +

Aunque puede realizar acciones de s=C3=B3lo lectura a trav=C3=A9s de = HTTP no seguro, +puede realizar todos los env=C3=ADos por HTTPS. Si necesita cambiar entr= e modos, +use:

svn sw=
 --relocate http://overlays.gentoo.org/svn/proj/foo/ https://overlays.gen=
too.org/svn/proj/foo/

-Nosotros mantenemos una -lista completa de los overlays de proyecto hospedados en -overlays.gentoo.org. +Nosotros mantenemos una l= ista +completa de los overlays de proyecto alojados en overlays.gentoo.org.

@@ -356,10 +347,9 @@

Accediendo a los Overlays de Desarrollador -

-Si su direcci=C3=B3n de correo electr=C3=B3nico es 'foo@gentoo.org', el = wiki de -su sitio en Trac estar=C3=A1 aqu=C3=AD: http://overlays.gentoo.org/dev/f= oo/. +Si su direcci=C3=B3n de correo electr=C3=B3nico es 'foo@gentoo.org', el = wiki de su sitio +en Trac estar=C3=A1 aqu=C3=AD: http://overlays.gentoo.org/dev/foo/.

=20

@@ -368,10 +358,15 @@ =20

svn co http://o=
verlays.gentoo.org/svn/dev/foo/

=20 +

Aunque puede realizar acciones de s=C3=B3lo lectura a trav=C3=A9s de = HTTP no seguro, +puede realizar todos los env=C3=ADos por HTTPS. Si necesita cambiar entr= e modos, +use:

svn sw=
 --relocate http://overlays.gentoo.org/svn/dev/foo/ https://overlays.gent=
oo.org/svn/dev/foo/

-Nosotros mantenemos una -lista completa de los overlays de desarrollador hospedados en -overlays.gentoo.org. +Nosotros mantenemos una li= sta +completa de los overlays de desarrollador alojados en overlays.gentoo.or= g +.

@@ -379,122 +374,72 @@

Empezando con Trac -

-Su overlay viene con Trac. -Trac es un wiki, un navegador de repositorios Subversion, y un sistema -de monitoreo de bugs muy popular entre los desarrolladores de c=C3=B3dig= o -abierto. +Su overlay viene con Trac. = Trac +es un wiki, un navegador de repositorios Subversion, y un sistema de +monitoreo de bugs muy popular entre los desarrolladores de c=C3=B3digo a= bierto.

=20

Hemos deshabilitado el sistema de monitoreo de bugs en Trac. Use el Bugzilla de Gentoo para -controlar los bugs de su overlay. +link=3D"http://bugs.gentoo.org">el Bugzilla de Gentoo para control= ar los +bugs de su overlay.

=20

El feed RSS de su overlay - el que se muestra en la p=C3=A1gina de o.g.o - vien= e de -la p=C3=A1gina Timeline de Trac. +link=3D"http://overlays.gentoo.org">la p=C3=A1gina de inicio de o.g.o - viene +de la p=C3=A1gina Timeline de Trac o del resumen GitWeb.

- -

-Hemos instalado muchos plugins de Trac, los cuales esperamos hagan de -su wiki a=C3=BAn m=C3=A1s =C3=BAtil para usted. Si necesita alg=C3=BAn p= lugin adicional -que le gustar=C3=ADa sea instalado, por favor h=C3=A1ganoslo saber, y le= daremos -un vistazo. -

- -

LayOnTrac - lista los paquetes del overlay.
TracTags - - muestra una nube de etiquetas
TracWebAdmin - - provee un panel de administraci=C3=B3n web para Trac

- -

-Hemos instalado muchos macros para Trac, los cuales esperamos hag=C3=A1n= a -su wiki m=C3=A1s =C3=BAtil para usted. Si necesita alg=C3=BAn macro adic= ional que le -gustar=C3=ADa sea instalado, por favor h=C3=A1ganoslo saber, y nosotros = le -daremos un vistazo. -

- -

AddComment - - permite a los visitantes agregar comentarios en la parte inferior de - sus p=C3=A1ginas
FootNote - - agrega soporte para agregar notas al pi=C3=A9 en su p=C3=A1gina.
TOC - - agrega soporte para publicar una Tabla de Contenidos en su - p=C3=A1gina.

=20

Comenzando con Subversion - -

-Su overlay viene con Subversion, una moderna -alternativa a CVS. Las ventajas de Subversion sobre CVS incluyen -control real de versiones sobre directorios, soporte completo de -cambios, y es mucho m=C3=A1s f=C3=A1cil hacer ramificaciones (branching)= si lo -necesita. La mayor desventaja de Subversion es que es m=C3=A1s lento que -CVS, y hacer una verificaci=C3=B3n local de Subversion requiere m=C3=A1s= espacio -en disco. +

Las ventajas de Subversion frente a CVS incluyen: versionado real de +directorios, soporte completo de changeset y es mucho m=C3=A1s f=C3=A1ci= l crear ramas +en caso de necesitarlo. La principal desventaja de Subversion es que es = m=C3=A1s +lento que CVS y que una verificaci=C3=B3n local de Subversion requiere m= ayor +espacio en disco.

=20 -

-Si nunca ha usado Subversion anterioremente, el libro en l=C3=ADnea es una -excelente manera de aprenderlo. Tambi=C3=A9n puede comprarlo en formato -impreso si lo prefiere. +

Si nunca ha usado Subversion, el libro online es una excelente forma = de +aprender Subversion. Puede comprarlo tambi=C3=A9n en formato impreso si = lo +prefiere.

=20

-Aqu=C3=AD ponemos unos cuantos comandos b=C3=A1sicos para empezar. +Aqu=C3=AD se muestran algunos comandos b=C3=A1sicos para empezar.

svn co http://overlays.gentoo.org/=
proj/php

svn status

svn add mi.ebuild

svn commit -m 'Mi actualizaci=C3=B3n=
 de historial'

=20

Layman -

-Le sugerimos a los usuarios usar layman para descargar y manejar su -overlay. Layman es una utilidad escrita por Gunnar Wrobel la cual le facilita a -los usuarios trabajar con los overlays. +Le sugerimos a los usuarios usar layman para descargar y manejar su over= lay. +Layman es una utilidad escrita por +Gunnar Wrobel la cual le facilita a los usuarios trabajar con los +overlays.

=20

Para empezar a usar layman, mire (en ingl=C3=A9s) el -Semanario de Gentoo del 22 de Mayo, =C3=A9ste art=C3=AD= culo en -Gentoo-Wiki.com, o la p=C3=A1gina man que viene con layman. +link=3D"http://layman.sourceforge.net/">la p=C3=A1gina de inicio de la d= ocumentaci=C3=B3n +, las Gento= o +Weekly News del 22 de mayo o lea man layman.

@@ -502,29 +447,27 @@

Sincronizaci=C3=B3n Autom=C3=A1tica desde Portage -

-Sus paquetes en el =C3=A1rbol de Portage siempre est=C3=A1n en riego de = ser -cambiados sin previo aviso. Los equipos de Arquitectura necesitan ser -capaces de enmascarar paquetes (y arreglar problemas espec=C3=ADficos de -arquitectura), el equipo de QA arregla violaciones de est=C3=A1ndares qu= e -se han detectado, y ocasionalmente los desarroladores editar=C3=A1n -paquetes que no deber=C3=ADan. +Sus paquetes en el =C3=A1rbol de Portage siempre est=C3=A1n en riego de = ser cambiados +sin previo aviso. Los equipos de Arquitectura necesitan ser capaces de +enmascarar paquetes (y arreglar problemas espec=C3=ADficos de arquitectu= ra), el +equipo de QA (Aseguramiento de la Calidad) arregla violaciones de est=C3= =A1ndares +que se han detectado, y ocasionalmente cambios en los paquetes que los +desarrolladores no deb=C3=ADan haber realizado.

=20

-Usted necesita asegurarse que los cambios hechos en el Portage no se -pierdan la pr=C3=B3xima vez que copie sus paquetes desde su overlay de -vuelta al Portage. +Necesita asegurarse que los cambios hechos en Portage no se pierdan la p= r=C3=B3xima +vez que copie sus paquetes desde su overlay de vuelta a Portage.

=20

-El equipo de PHP ha resuelto =C3=A9ste problema copiando autom=C3=A1tica= mente -sus paquetes desde el Portage de vuelta a la rama 'portage' de su -overlay cada noche. Luego puede usar Subversion (o el Timeline de -Trac) para ver los cambios cada d=C3=ADa. Si le gustar=C3=ADa tener =C3=A9= sta -caracter=C3=ADstica en su overlay, cont=C3=A1cte a CHTEKK. +El equipo de PHP ha resuelto =C3=A9ste problema copiando autom=C3=A1tica= mente sus +paquetes desde Portage de vuelta a la rama 'portage' de su overlay cada = noche. +Luego puede usar Subversion (o el Timeline de Trac) para ver los cambios +realizados ese d=C3=ADa.

@@ -533,48 +476,20 @@ Usando git en los overlays =20

-Configurando git para env=C3=ADos con webdav - - -

-machine overlays.gentoo.org
-login (su-nombre-de-usuario)
-password (su-clave)
-

- -

-Fuente (en ingl=C3=A9s): http://www.kernel.org/pub/software/scm/git/docs= /howto/setup-git-server-over-http.txt -

- -

Inicializando su overlay - -

-=C3=81ntes de enviar usted necesita crear localmente un repositorio git = y agregar todos los =C3=ADtems: +

Antes subir nada, necesitar=C3=A1 crear un repositorio git en local y= a=C3=B1adir +todos los elementos:

- -

cd ~/mi-overlay
-

- -

git-init
+cd ~/my-overlay
+git init
 git add .
-git commit -m "llenar overlay"
-
-
+git commit -m "populate overlay"

-Note que =C3=A9ste env=C3=ADo fue localmente, ahora introducimos al serv= idor en -el juego. Aseg=C3=BArese de agregar el rastro / +Notar que este env=C3=ADo se realiz=C3=B3 localmente, ahora el servidor = entra en juego.

- -

git-config remote.upload.url h=
ttp://(su-nombre-de-usuario)@overlays.gentoo.org/git/(nombre)(proy o dev)
-

- -

git push upload master
-

- +

git remote add origin git+ssh:=
//git@git.overlays.gentoo.org/(proj o dev)/(nombre)

git push origin master

Fuente (en ingl=C3=A9s): http://www.kernel.org/pub/software/scm/git/docs= /tutorial.html

@@ -582,11 +497,9 @@

=20

-Verificando el overlay con git +Obteniendo el overlay con git - -

git clone http://overlays.gentoo=
.org/git/(proy o dev)/(nombre)
-

git clone git://git@git.overlays=
.gentoo.org/(proj o dev)/(nombre)/

@@ -597,39 +510,30 @@

Introducci=C3=B3n - -

-Una de las caracter=C3=ADsticas clave de o.g.o es que la gente que no ti= ene -acceso de escritura al =C3=A1rbol de paquetes del Portage de Gentoo pued= e -tener acceso de escritura a uno o m=C3=A1s overlays. Muchos proyectos de -Gentoo han encontrado en =C3=A9sta una excelente manera de entrenar y -evaluar a potenciales desarrolladores de Gentoo en un entorno seguro. -

-Actualmente, s=C3=B3lo el equipo de Overlays puede actualizar las listas= de -control de acceso de overlays.gentoo.org. M=C3=A1s adelante hemos de -proveer una herramienta web para el manejo de listas de acceso. Pero, -por ahora, si necesita que un cambio sea hecho, por favor, pase por -#gentoo-overlays en el IRC para asistencia. +Una de las caracter=C3=ADsticas clave de o.g.o es que la gente que no ti= ene acceso +de escritura al =C3=A1rbol de paquetes del Portage de Gentoo puede tener= acceso de +escritura a uno o m=C3=A1s overlays. Muchos proyectos de Gentoo han enco= ntrado en +=C3=A9sta una excelente manera de entrenar y evaluar a potenciales desar= rolladores +de Gentoo en un entorno seguro.

=20

-Overlays de Proyecto: Otorgando accesos de escritura a Miembros d= el Equipo +Overlays de Proyecto: Otorgando accesos de escritura a Miembros d= el +Equipo -

-Cualquier desarrollador listado en la p=C3=A1gina del equipo del proyect= o -en www.g.o puede tener acceso de escritura al overlay del equipo. El -l=C3=ADder de proyecto puede preguntar en su nombre, o el desarrollador -puede venir y preguntar por su cuenta. +Cualquier desarrollador listado en la p=C3=A1gina del equipo del proyect= o en +www.g.o puede tener acceso de escritura al overlay del equipo. El l=C3=AD= der de +proyecto puede preguntar en su nombre, o el desarrollador puede venir y +preguntar por su cuenta.

=20

-Si el desarrollador no tiene una cuenta en o.g.o a=C3=BAn, el/ella -necesitar=C3=A1 pasar por #gentoo-overlays as=C3=AD podremos crearle una= cuenta. +Si el desarrollador no tiene una cuenta en o.g.o a=C3=BAn, el/ella neces= itar=C3=A1 pasar +por #gentoo-overlays as=C3=AD podremos crearle una cuenta.

@@ -640,82 +544,80 @@ =20

-Cualquier desarrollador de Gentoo *no* listando en la p=C3=A1gina de equ= ipo -del proyecto en www.g.o puede tener acceso de escritura al overlay del -equipo. El requerimiento para acceso de escritura debe venir de un -miembro del equipo. No debe venir del l=C3=ADder de proyecto. +Cualquier desarrollador de Gentoo *no* listando en la p=C3=A1gina de equ= ipo del +proyecto en www.g.o puede tener acceso de escritura al overlay del equip= o. La +solicitud de acceso para escritura debe venir de un miembro del equipo. = No +tiene porqu=C3=A9 venir del l=C3=ADder de proyecto.

=20

-Overlays de Proyecto: Otorgando accesos de escritura a Usuarios d= e Gentoo +Overlays de Proyecto: Otorgando accesos de escritura a Usuarios d= e +Gentoo -

-Cualquier usuario de Gentoo puede tener acceso de escritura en el -overlay del equipo. El requerimiento de acceso de escritura debe -venir de uno de los l=C3=ADderes de proyecto. Usted puede requerir que l= e -demos al usuario acceso de escritura a Trac, a Subversion, o a ambos. -(Nosotros asumiremos que el requerimiento es para acceso de escritura -a ambos, a menos que usted diga lo contrario). +Cualquier usuario de Gentoo puede tener acceso de escritura en el overla= y del +equipo. La solicitud de acceso para escritura debe venir de uno de los l= =C3=ADderes +de proyecto. Puede solicitar que le demos al usuario acceso de escritura= a +Trac, a Subversion, o a ambos. (Nosotros asumiremos que la solicitud es = para +acceso de escritura a ambos, a menos que nos diga lo contrario).

=20

-No hemos de aceptar =C3=A9ste requerimiento de otro que no sea el l=C3=AD= der de -proyecto. Si su proyecto s=C3=B3lo tiene un l=C3=ADder, recomendamos ele= gir un -segundo l=C3=ADder. Si su =C3=BAnico l=C3=ADder est=C3=A1 AWOL (Ausente = Sin Renuncia -Oficial), consideren elegir un reemplazo :) +No podemos aceptar una solicitud de una persona que no sea el l=C3=ADder= del +proyecto. Si su proyecto s=C3=B3lo tiene un l=C3=ADder, recomendamos ele= gir un segundo +l=C3=ADder. Si su =C3=BAnico l=C3=ADder est=C3=A1 AWOL (Ausente Sin Renu= ncia Oficial), considere +elegir un sustituto :)

=20

-Si el usuario no tiene una cuenta en o.g.o a=C3=BAn, el/ella necesitar=C3= =A1 pasar -por #gentoo-overlays as=C3=AD podremos crearle una cuenta. +Si el usuario no tiene una cuenta en o.g.o a=C3=BAn, el/ella necesitar=C3= =A1 pasar por +#gentoo-overlays as=C3=AD podremos crearle una cuenta.

=20

-Overlays de Desarrollador: Otorgando accesos de escritura a Desar= rolladores de Gentoo +Overlays de Desarrollador: Otorgando accesos de escritura a +Desarrolladores de Gentoo -

Cualquier desarrollador de Gentoo puede tener acceso a su overlay de -desarrollador. El desarrollador puede preguntarnos directamente; -nosotros no le daremos acceso hasta haberlo confirmado con usted. -Tambi=C3=A9n puede usted consultarnos para dar accesos de escritura a -cualquier desarrollador. +desarrollador. El desarrollador puede preguntarnos directamente; nosotro= s no +le daremos acceso hasta haberlo confirmado. Tambi=C3=A9n puede consultar= nos para +dar accesos de escritura a cualquier desarrollador.

=20

-Overlays de Desarrollador: Otorgando accesos de escritura a Usuar= ios de Gentoo +Overlays de Desarrollador: Otorgando accesos de escritura a Usuar= ios de +Gentoo =20

-Cualquier usuario de Gentoo puede tener acceso de escritura a su -overlay de desarrollador. El requerimiento para el acceso a escritura -debe venir de usted. Puede requerir que le demos al usuario accesos -de escritura s=C3=B3lo en Trac, s=C3=B3lo en Subversion, o ambos. (Nosot= ros -asumiremos que el requerimiento es para accesos de escritura a ambos a -menos que usted diga lo contrario). +Cualquier usuario de Gentoo puede tener acceso de escritura a su overlay= de +desarrollador. Nos deber=C3=A1 enviar la solicitud para este acceso a es= critura. +Puede solicitar que le demos al usuario accesos de escritura s=C3=B3lo e= n Trac, +s=C3=B3lo en Subversion, o ambos. (Nosotros asumiremos que la solicitud = es para +accesos de escritura a ambos a menos que nos indique lo contrario).

=20

-No aceptaremos =C3=A9ste requerimiento de otro excepto usted. Si ve que -est=C3=A1 dando accesos a mucha m=C3=A1s gente, es posible que deba cons= iderar -crear un nuevo proyecto, y transferir su trabajo ah=C3=AD. +No aceptaremos la solicitud de otra persona que no sea el propietario de= l +overlay. Si ve que est=C3=A1 dando accesos a mucha m=C3=A1s gente, es po= sible que deba +considerar crear un nuevo proyecto, y transferir su trabajo ah=C3=AD.

=20

@@ -727,29 +629,26 @@ =20 -Accediendo al Overlay de alguien m=C3=A1s +Accediendo al Overlay de otro =20

Usando un Overlay -

-Todos tienen acceso completo de lectura a cualquier overlay. Le -recomendamos usar

- +Todos tienen acceso completo de lectura a cualquier overlay. Le recomend= amos +usar

   emerge layman
   echo 'source /usr/portage/local/layman/layman.conf' >> /etc/make=
.conf

=20 -Layman crear=C3=A1 "/usr/portage/local/layman/make.conf" una vez que hay= a -agregado su primer overlay. Pero si no planea instalar un overlay -inmediatamente deber=C3=ADa asegurarse que =C3=A9ste archivo ex=C3=ADsta= y contenga -una variable vac=C3=ADa "PORTDIR_OVERLAY". De otra manera portage se -quejar=C3=A1. Puede ejecutar "echo PORTDIR_OVERLAY=3D\"\" > -/usr/portage/local/layman/make.conf" para asegurarse que el archivo se -cree correctamente. +Layman crear=C3=A1 "/usr/portage/local/layman/make.conf" una vez que hay= a agregado +su primer overlay. Pero si no planea instalar un overlay inmediatamente +deber=C3=ADa asegurarse que =C3=A9ste archivo exista y contenga una vari= able vac=C3=ADa +"PORTDIR_OVERLAY". De otra manera portage se quejar=C3=A1. Puede ejecuta= r +"echo PORTDIR_OVERLAY=3D\"\" > /usr/portage/local/layman/make.conf" para +asegurarse de que el archivo se crea correctamente. =20

@@ -762,7 +661,6 @@

Para instalar un overlay, ejecute

layman -a <nombre-del-overlay>=
;

=20 @@ -773,21 +671,19 @@

=20

-Requiriendo Accesos de Escritura +Solicitando Accesos de Escritura =20

-Si usted desea accesos de escritura a un overlay de proyecto, cont=C3=A1= cte -a un miembro del equipo del proyecto, y consulte por del acceso. Si -aprueba su requerimiento, ellos se encargar=C3=A1n de su acceso a escrit= ura -contact=C3=A1ndo al equipo de Overlays. +Si desea accesos de escritura a un overlay de proyecto, contacte con un +miembro del equipo del proyecto, y p=C3=ADdale acceso. Si aprueban su so= licitud, +se encargar=C3=A1n de su acceso a escritura contactando con el equipo de= Overlays.

=20

-Si usted desea accesos de escritura en un overlay de desarrollador, -cont=C3=A1cte al desarrollador directamente, y consulte por el acceso. S= i -aprueba su requerimiento, =C3=A9l se encargar=C3=A1 de su acceso a escri= tura -contact=C3=A1ndo al equipo de Overlays. +Si desea accesos de escritura a un overlay de desarrollador, contacte co= n el +desarrollador directamente, y p=C3=ADdale acceso. Si aprueba su solicitu= d, =C3=A9ste se +encargar=C3=A1 de su acceso a escritura contactando con el equipo de Ove= rlays.

@@ -803,24 +699,23 @@

P: =C2=BFC=C3=B3mo contacto al equipo de administraci=C3=B3n de o.g.o?

R: Puede entrar a #gentoo-overlays en el IRC y ubicarnos ah=C3=AD. - El equipo actual est=C3=A1 regularme en el horario de Europa.
R: Puede enviar un correo a overlays@gentoo.org. Alguien le - responder=C3=A1 lo m=C3=A1s pronto posible.
R: Puede contactar a Stuart Herbert (el l=C3=ADder de proyecto) - directamente, a su direcci=C3=B3n de correo: stuart@gentoo.org
R: Puede entrar a #gentoo-overlays en el IRC y ubicarnos ah=C3=AD.= La mayor=C3=ADa + del equipo actual est=C3=A1 en el horario Europeo.
R: Puede enviar un correo a overlays@gentoo.org. Alguien le respon= der=C3=A1 + lo m=C3=A1s pronto posible.

=20

P: =C2=BFPor qu=C3=A9 no puedo editar las listas de control de acceso di= rectamente?

R: Las listas de control de acceso se encuentran en archivos - htpasswd / htgroup usado por Apache. S=C3=B3lo el equipo de - administraci=C3=B3n de o.g.o tiene acceso ssh a la m=C3=A1quina de o.g= .o.
A: (SVN) Las listas de control actualmente est=C3=A1n implementadas = en formato +htpasswd. S=C3=B3lo el equipo de administraci=C3=B3n de o.g.o tienen acc= eso ssh al +servidor en o.g.o.
A: (Git) Las listas de control actualmente est=C3=A1n instaladas en = el +repositorio gitosis-admin, en el cual s=C3=B3lo pueden escribir los miem= bros del +equipo de administraci=C3=B3n de o.g.o.

@@ -828,7 +723,6 @@

Seguridad -

P: =C2=BFEst=C3=A1 mi overlay disponible por https?

@@ -847,10 +741,9 @@ P: =C2=BFPuedo tener acceso a multiples overlays?

R: S=C3=AD, de una manera. Dentro su overlay, puede crear - subdirectorios, y poner =C3=A1rboles separados de paquetes dentro los - subdirectorios. Por favor de un vistazo al overlay del proyecto PHP - para tener un ejemplo.
R: S=C3=AD, de una manera. Dentro su overlay, puede crear subdirec= torios, y + poner =C3=A1rboles separados de paquetes dentro los subdirectorios. Po= r favor, + eche un vistazo al overlay del proyecto PHP para tener un ejemplo.

@@ -858,37 +751,32 @@

Importando Overlays Existentes -

-P: Ya tengo un overlay, y me gustar=C3=ADa moverlo a o.g.o. =C2=BFC=C3=B3= mo puedo -hacer eso? +P: Ya tengo un overlay, y me gustar=C3=ADa moverlo a o.g.o. =C2=BFC=C3=B3= mo puedo hacerlo?

R: Cree un archivo tar en su repositorio de subversion, y - col=C3=B3quelo en cualquier lugar donde pueda descargarlo por http. - Nosotros hemos de descargarlo e instalarlo en o.g.o por usted.
R: Cree un archivo tar en su repositorio de subversion, y col=C3=B3= quelo en + cualquier lugar donde pueda descargarlo por http. Nosotros lo + descargaremos e instalaremos en o.g.o.

- -=C2=A1Asegurese de que el tar sea de su repositorio y no de una copia! +=C2=A1Aseg=C3=BArese de que el tar sea de su repositorio y no de una cop= ia! =20

-P: Tengo un overlay, pero no usa subversion. =C2=BFC=C3=B3mo puedo mover= lo -a o.g.o? +P: Tengo un overlay, pero no usa subversion. =C2=BFC=C3=B3mo puedo mover= lo a o.g.o?

=20

R: P=C3=ADdamos crearle un nuevo overlay vac=C3=ADo. Usted puede u= sar - 'svn import' para importar sus archivos al nuevo overlay. Perder=C3=A1 - su historial pero eso es inevitable.
R: Busque en internet, y vea si ex=C3=ADste alguna herramienta par= a - convertir su actual sistema de control de versiones a Subversion. Si - ex=C3=ADste, =C3=BAsela, y entonces podremos ayudarle a moverse hacia - o.g.o
R: Si su software de control de versiones es usado por Trac, y - puede ser usado a trav=C3=A9s de HTTP, ay=C3=BAdenos a agregar el sopo= rte para - su software de control de versiones en o.g.o
R: P=C3=ADdamos crearle un nuevo overlay vac=C3=ADo. Puede usar 's= vn import' para + importar sus archivos al nuevo overlay. Perder=C3=A1 su historial pero= eso es + inevitable.
R: Busque en Internet, y vea si existe alguna herramienta para con= vertir + su actual sistema de control de versiones a Subversion. Si existe, =C3= =BAsela, y + entonces podremos ayudarle a moverlo hacia o.g.o
R: Si su software de control de versiones es usado por Trac, y pue= de ser + usado a trav=C3=A9s de HTTP, ay=C3=BAdenos a agregar el soporte para s= u software de + control de versiones en o.g.o

@@ -896,15 +784,13 @@

Overlays "Oficiales" -

-P: =C2=BFCu=C3=A1ndo un overlay es considarado "oficial"? +P: =C2=BFCu=C3=A1ndo un overlay es considerado "oficial"?

R: Un overlay "oficial" es un overlay manejado por un proyecto - de Gentoo (para overlays de proyecto) o por un desarrollador de - Gentoo (overlays para desarrollador).
R: Un overlay "oficial" es un overlay manejado por un proyecto de = Gentoo + (para overlays de proyecto) o por un desarrollador de Gentoo (overlays= para + desarrollador).

=20