Sugar Labs

Development Team/Almanac/lang-es: Difference between revisions

← Older edit
Fede (talk | contribs)
27 edits
 
(20 intermediate revisions by 5 users not shown)
Line 14: Line 14:


== ¿Dónde puedo ver los cambios de la API? ==
== ¿Dónde puedo ver los cambios de la API? ==
API changes between OLPC releases can be seen here: [[Development Team/Almanac/API Changes|API Changes]]
Cambios de API entre los releases de OLPC pueden ser vistos aqui: [[Development Team/Almanac/API Changes|API Changes]]


== Comenzando ==
== Comenzando ==
Line 131: Line 131:
* [[Development Team/Almanac/GStreamer|GStreamer]]
* [[Development Team/Almanac/GStreamer|GStreamer]]


== Mouse ==
== Ratón ==
=== How do I change the mouse cursor in my activity to the wait cursor? ===
=== ¿Cómo puedo cambiar el cursor del ratón por el cursor de espera en mi actividad? ===
In your activity subclass:
En la subclase de tu actividad:


<pre>
<pre>
Line 139: Line 139:
</pre>
</pre>


and to switch it back to the default:
y para volver al que está por defecto:


<pre>
<pre>
Line 145: Line 145:
</pre>
</pre>


=== How do I track the position of the mouse? ===
=== ¿Cómo puedo rastrear la posición del ratón? ===
There are many different reasons you might want to track the position of the mouse in your activity, ranging from the entertaining ([[http://en.wikipedia.org/wiki/Xeyes]]) to the functional (hiding certain windows when the mouse hasn't moved for a couple of seconds and making those ui elements re-appear when the mouse has moved again).  Here is one way you can implement this functionality:


Existen varias razones por las que te puede interesar controlar la posición del ratón, que van desde el entretenimiento ([[http://en.wikipedia.org/wiki/Xeyes]]) a lo funcional (ocultar ciertas ventanas cuando el ratón no se ha movido por un par de segundos y volver a hacer aparecer esos elementos cuando este se mueva nuevamente). Esta es una manera en la cual se puede implementar esta funcionalidad:
<pre>
<pre>


Line 180: Line 180:
</pre>
</pre>


== Miscellaneous==
== Varios ==


The tasks below are random useful techniques that have come up as I write code and documentation for this reference. They have yet to be categorized, but will be as a sufficient set of related entries are written.
Las tareas que aparecen más abajo son técnicas útiles que he encontrado mientras escribía código y documentación para esta referencia. No ha sido categorizadas aún.


=== ¿Cómo se si mi actividad está "activa" o no? ===


=== How do I know when my activity is "active" or not? ===
Puedes configurar un evento usando la constante VISIBILITY_NOTIFY_MASK para saber cuando se cambia la visibilidad. Luego en el callback para este evento lo que debes hacer es comprar el estado del evento con las variables gtk definidas para la visibilidad de tu actividad. Puedes ver [http://www.pygtk.org/docs/pygtk/gdk-constants.html#gdk-visibility-state-constants la sección de Constantes de Estado de Visibilidad de GDK] gtk.gdk.Constants para más información.  
 
You can set an event using the VISIBILITY_NOTIFY_MASK constant in order to know when your activity changes visibility. Then in the callback for this event, you simply compare the event's state to gtk-defined variables for activity visibility. See the [http://www.pygtk.org/docs/pygtk/gdk-constants.html#gdk-visibility-state-constants GDK Visibility State Constants] section of gtk.gdk.Constants for more information.  


<pre>
<pre>
Line 203: Line 202:
</pre>
</pre>


=== How do I get the amount of free space available on disk under the /home directory tree? ===
=== ¿Cómo puedo obtener la cantidad de espacio libre disponible dentro del directorio /home? ===
The following function uses the [http://docs.python.org/lib/module-statvfs.html statvfs] module. The following code demonstrates how to get the total amount of free space under /home.  
La siguiente función usa el módulo [http://docs.python.org/lib/module-statvfs.html statvfs]. El código siguiente muestra cómo obtener la cantidad total de espacio libre en /home.  


<pre>
<pre>
     #### Method: getFreespaceKb, returns the available freespace in kilobytes.  
     #### Método getFreespaceKb: devuelve el espacio disponible en kilobytes.  
     def getFreespaceKb(self):
     def getFreespaceKb(self):
         stat = os.statvfs("/home")
         stat = os.statvfs("/home")
Line 215: Line 214:
</pre>
</pre>


Note, however, that assuming anything about "/home" is a bad idea, better use os.environ['HOME'] instead. Rainbow will put your actual files elsewhere,
Ten en cuenta que asumir cosas acerca de "/home" no es una buena idea, es mejor usar os.environ['HOME']. Rainbow pondrá los archivos actuales en otros lugares, algunos en el ramdisk, otros en la flash.
some on ramdisks, some on flash. Be clear about which filesystem's free space you actually care about.
Ten claro que espacio libre en el sistema de archivos realmente te importa.


=== How do I know whether my activity is running on a physical XO? ===
=== ¿Cómo puedo saber si mi actividad se está ejecutando en una XO? ===
Sugar runs on ordinary computers as well as on XO's. While your activity is typically going to be run on a real XO, some people will indeed run it elsewhere. Normally you shouldn't write your activity to care whether it's on an XO or not. If for some odd reason, you need to care, the easiest way to tell if you are on a physical XO is to check whether /sys/power/olpc-pm, an essential power management file for the XO, exists. <ref>[http://lists.laptop.org/pipermail/devel/2008-June/015923.html reliably detecting if running on an XO]</ref> <ref>OLPC [[olpc:Power Management Interface]]</ref>
Sugar corre en PCs comunes, así como en XO. Aunque tu actuvidad probablemente corra en una XO real, algunas personas necesitan utilizarla en otros lados. Normalmente no deberías escribir una actividad que le importe si es una XO o no donde se está ejecutando. Si por alguna extraña razón necesitas saber, la forma más fácil es verificar si /sys/power/olpc-pm (el manejador de poder de la XO) existe.  
 
[http://lists.laptop.org/pipermail/devel/2008-June/015923.html reliably detecting if running on an XO]
[[olpc:Power Management Interface]]


<pre>
<pre>
import os
import os
...
...
       #Print out a boolean value that tells us whether we are on an XO or not.  
       #Devuelve un valor booleano que nos dice si estamos en una XO o no.  
       print os.path.exists('/sys/power/olpc-pm')
       print os.path.exists('/sys/power/olpc-pm')
</pre>
</pre>


=== How do I know the current language setting on my XO? ===
=== ¿Cómo puedo saber la configuración actual del lenguage en mi XO? ===
The system variable 'LANG' tells you which language is currently active on the XO. The following code shows how to look at the value of this variable.  
La variable 'LANG' te dice que lenguaje está actualmente activo en el XO. El código siguiente muestra cómo buscar en el valor de esta variable.


<pre>
<pre>
Line 237: Line 239:
</pre>
</pre>


=== How do I repeatedly call a specific method after N number of seconds? ===
=== ¿Cómo llamar repetidamente a un método específico después de un número N de segundos? ===
The gobject.timeout_add() function allows you to invoke a callback method after a certain amount of time. If you want to repeatedly call a method, simply keep invoking the gobject.timeout_add function in your callback itself. The code below is a simple example, where the callback function is named repeatedly_call. Note that the timing of the callbacks are approximate. To get the process going, you should make an initial call to repeatedly_call() somewhere in your code.  
La función gobject.timeout_add() te permite invocar un método después de un período de tiempo determinado. Si quieres llamar a un método en varias ocasiones, simplemente sigue llamando a la función de gobject.timeout_add desde tu función.
El código de abajo es un ejemplo simple en donde la función que implementa el timeout se llama repeatedly_call. Nota que la sincronización entre las llamadas son aproximadas. Para que esto funcione debes llamar a repeatedly_call() desde alguna parte de tu código.


You can see a more substantive example of this pattern in use when we [[olpc:Pango#How_do_I_dynamically_set_the_text_in_a_pango_layout.3F | regularly update the time displayed on a pango layout object]].  
Puedes ver un mejor ejemplo de este patrón en uso [[olpc:Pango#How_do_I_dynamically_set_the_text_in_a_pango_layout.3F | aquí]].  


<pre>
<pre>


#This method calls itself ROUGHLY every 1 second
#Este método se llama a sí mismo aproximadamente cada 1 segundo
def repeatedly_call(self):
def repeatedly_call(self):
now = datetime.datetime.now()
now = datetime.datetime.now()
Line 250: Line 253:
</pre>
</pre>


=== ¿Cómo puedo actualizar la build que se ejecuta en mi XO? ===


=== How do I update the current build version of code that is running on my XO? ===
Hay varias páginas que te dan instrucciones sobre cómo instalar / actualizar la build actual.


There are several pages that give you instructions on how to install/update your current build.  
* Si usted ya tiene una build instalada y una conexión a Internet, primero pruebe usar [[OLPC: OLPC-update]].
* Si eso no funciona, puedes mirar las instrucciones para una [[OLPC: Activated upgrade]] que se puede hacer a través de un USB]


* If you already have a working build installed and an internet connection, first try [[olpc:olpc-update]].
Como mencionan las instrucciones en las páginas más arriba, asegurate de instalar tus actividades por separado luego de que actualices a una build específica.
* If that doesn't work, you can look at instructions for an [[olpc:Activated upgrade]] that can be done via USB] boot.  


As the instructions on the pages linked above note, make sure to install your activities separately after you have upgraded to a specific base build.
=== Estoy desarrollando en una XO pero mi teclado y la configuración de idioma no son ideales. ¿Cómo puedo cambiarlos? ===


 
Las laptops intenacionalizadas tienen configuraciones que te pueden retrazar mientras estás desarrollando. Para cambiar las configuraciones de idioma usa el [[olpc:Sugar Control Panel]]
=== I am developing on an XO laptop, but my keyboard and language settings are not ideal. How can I change them? ===
 
Internationalized laptops will often have settings that might slow you down while developing. To change around the language settings so you can better understand environment messages, use the [[olpc:Sugar Control Panel]]


Keyboard settings on internationalized laptops<ref>[[olpc:Keyboard layouts#OLPC keyboard layouts]]</ref> can also be suboptimal, especially as characters like "-" and "/" are in unfamiliar positions. You can use the <tt>setxkbmap</tt> command in the [[olpc:Terminal Activity]] to reset the type of keyboard input used and then attach a standard U.S. keyboard that will allow you to type normally. The command below sets the keyboard to the US mapping (it will reset to the default internationalized mapping upon restart).  
Keyboard settings on internationalized laptops<ref>[[olpc:Keyboard layouts#OLPC keyboard layouts]]</ref> can also be suboptimal, especially as characters like "-" and "/" are in unfamiliar positions. You can use the <tt>setxkbmap</tt> command in the [[olpc:Terminal Activity]] to reset the type of keyboard input used and then attach a standard U.S. keyboard that will allow you to type normally. The command below sets the keyboard to the US mapping (it will reset to the default internationalized mapping upon restart).  
Line 335: Line 336:
</pre>
</pre>


=== What packages are available on sugar to support game development? ===
=== ¿Qué paquetes están disponibles dentro de Sugar para el desarrollo de juegos? ===


If your activity will require tools that are typically needed to develop robust and clean video games, then you should utilize the [http://www.pygame.org/ pygame package]. It can be readily imported into any activity:
Si tu actividad requiere herramientas para desarrollar juegos robustos y límpios deberías utilizar [http://www.pygame.org/ pygame]. Puedes importar el paquete para usarlo con cualqueir actividad de la siguiente forma:


<pre>
<pre>
Line 410: Line 411:
</pre>
</pre>


=== How do i remove an specific button from the toolbar? ===
=== ¿Cómo elimino un botón específico de la barra de herramientas? ===


This is an example of the share button is removed:
Aquí hay un ejemplo de como borrar el botón de compartir:


<pre>
<pre>
Line 421: Line 422:


== Notes ==
== Notes ==
<references />
 


[[Category:Documentation]]
[[Category:Documentation]]
[[Category:Development Team]]
[[Category:Development Team]]
Retrieved from "https://wiki.sugarlabs.org/go/Development_Team/Almanac/lang-es"