Sugar Labs

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

← Older edit
Fede (talk | contribs)
27 edits
No edit summary
 
(27 intermediate revisions by 5 users not shown)
Line 7: Line 7:
{{Almanac}}
{{Almanac}}
{{Almanac TOC}}
{{Almanac TOC}}
== How do I get additional help beyond this almanac? ==
== ¿Cómo puedo obtener ayuda adicional más allá de este almanaque? ==
* Looking to get started with the basics of Sugar development? Check out OLPC Austria's [http://wiki.sugarlabs.org/images/5/51/Activity_Handbook_200805_online.pdf Activity Handbook] (''Please note that this handbook was last updated in May 2008 so the screenshots still show pre-8.2 design. In terms of the code itself things should still work as described. If you run into any issues please contact [[User:ChristophD|ChristophD]].'')   
* ¿Quieres comenzar con los básico del desarrollo para Sugar? Puedes visitar el [http://wiki.sugarlabs.org/images/5/51/Activity_Handbook_200805_online.pdf Activity Handbook] de OLPC Austria (''Ten en cuenta que este manual fue actualizado por última vez en mayo del 2008, las capturas de tienen el diseño pre-8.2. En términos de código en sí, las cosas deberían funcionar como están descriptas. Si encuentra algún problema por favor póngase en contacto con [[User:ChristophD|ChristophD]].'')   
* See also [[Development Team/Almanac/Code Snippets]]
* Ver también [[Development Team/Almanac/Code Snippets]]


Ahora, vamos con el almanaque actual...


Now, on to the actual almanac ...
== ¿Dónde puedo ver los cambios de la API? ==
Cambios de API entre los releases de OLPC pueden ser vistos aqui: [[Development Team/Almanac/API Changes|API Changes]]


== Where can I see API changes? ==
== Comenzando ==
API changes between OLPC releases can be seen here: [[Development Team/Almanac/API Changes|API Changes]]
=== ¿Cómo estructuro mis archivos para que sean una actividad de válido en Sugar? ===  
Puedes encontrar información sobre la estructura de la actividad aquí: [[Development Team/Almanac/Activity Bundles|Activity Bundles]]


== Getting Started ==
=== ¿Cómo puedo hacer un icono para mi actividad? ===
=== How do I structure my files so that they are a valid sugar activity? ===  
La información sobre lo que debe hacer se puede encontrar aquí: [[Development Team/Almanac/Making Icons|Making Icons]]
Information on activity bundle structure can be found here: [[Development Team/Almanac/Activity Bundles|Activity Bundles]]


=== How do I make an icon for my activity? ===
== Paquete: sugar ==
Information on what you need to do can be found here: [[Development Team/Almanac/Making Icons|Making Icons]]
 
== Package: sugar ==
* [[Development Team/Almanac/sugar.env|sugar.env]]
* [[Development Team/Almanac/sugar.env|sugar.env]]
* [[Development Team/Almanac/sugar.profile|sugar.profile]]
* [[Development Team/Almanac/sugar.profile|sugar.profile]]
Line 30: Line 29:
* [[Development Team/Almanac/sugar.logger|sugar.logger]]
* [[Development Team/Almanac/sugar.logger|sugar.logger]]


== Package: sugar.activity ==
== Paquete: sugar.activity ==
* [[Development Team/Almanac/sugar.activity.activity|sugar.activity.activity]]
* [[Development Team/Almanac/sugar.activity.activity|sugar.activity.activity]]
* [[Development Team/Almanac/sugar.activity.activityfactory|sugar.activity.activityfactory]]
* [[Development Team/Almanac/sugar.activity.activityfactory|sugar.activity.activityfactory]]
* [[Development Team/Almanac/sugar.activity.registry|sugar.activity.registry]]
* [[Development Team/Almanac/sugar.activity.registry|sugar.activity.registry]]


== Package: sugar.datastore ==
== Paquete: sugar.datastore ==
* [[Development Team/Almanac/sugar.datastore.datastore|sugar.datastore.datastore]]
* [[Development Team/Almanac/sugar.datastore.datastore|sugar.datastore.datastore]]


== Package: sugar.graphics ==
== Paquete: sugar.graphics ==
* [[Development Team/Almanac/sugar.graphics.alert|sugar.graphics.alert]]
* [[Development Team/Almanac/sugar.graphics.alert|sugar.graphics.alert]]
* [[Development Team/Almanac/sugar.graphics.icon|sugar.graphics.icon]]
* [[Development Team/Almanac/sugar.graphics.icon|sugar.graphics.icon]]
Line 46: Line 45:
* [[Development Team/Almanac/sugar.graphics.style|sugar.graphics.style]]
* [[Development Team/Almanac/sugar.graphics.style|sugar.graphics.style]]


== Package: sugar.presence ==
== Paquete: sugar.presence ==
* [[Development Team/Almanac/Sugar.presence|Sugar.presence]]
* [[Development Team/Almanac/Sugar.presence|Sugar.presence]]
* [[Development Team/Almanac/Sugar.presence.activity|Sugar.presence.activity]]
* [[Development Team/Almanac/Sugar.presence.activity|Sugar.presence.activity]]
Line 53: Line 52:


== Clipboard ==
== Clipboard ==
* Notes on using [[Development Team/Almanac/GTK's Clipboard Module|GTK's Clipboard Module]]
* Notas sobre el uso del [[Development Team/Almanac/GTK's Clipboard Module|módulo Clipboard de GTK ]]


== Logging ==
== Logging ==
* [[Development Team/Almanac/sugar.logger|sugar.logger]]
* [[Development Team/Almanac/sugar.logger|sugar.logger]]
* Notes on using [[Development Team/Almanac/Python Standard Logging|Python Standard Logging]]
* Notas sobre el uso del [[Development Team/Almanac/Python Standard Logging|standard de Logging en Python]]


== Internationalization ==
== Internacionalización ==
*[[Development Team/Almanac/Internationalization|Internationalization]]
*[[Development Team/Almanac/Internationalization|Internationalization]]


== Text and Graphics for Sugar Activities ==
== Texto y gráficos para las actividades de Sugar ==
* [[Development Team/Almanac/Pango|Pango]]
* [[Development Team/Almanac/Pango|Pango]]
=== How do I create a text box for code editing? ===
=== ¿Cómo puedo crear un cuadro de texto para la edición de código? ===
You can use gtksourceview2
Puedes usar gtksourceview2
<pre>
<pre>
import gtk
import gtk
Line 73: Line 72:
...
...


# set up the buffer
# Configuramos el buffer
buffer = gtksourceview2.Buffer()
buffer = gtksourceview2.Buffer()
if hasattr(buffer, 'set_highlight'): # handle different API versions
if hasattr(buffer, 'set_highlight'): # handle different API versions
Line 80: Line 79:
     buffer.set_highlight_syntax(True)
     buffer.set_highlight_syntax(True)


# set mime type for the buffer
# Configuramos el tipo MIME para el buffer
lang_manager = gtksourceview2.language_manager_get_default()
lang_manager = gtksourceview2.language_manager_get_default()
if hasattr(lang_manager, 'list_languages'): # again, handle different APIs
if hasattr(lang_manager, 'list_languages'): # again, handle different APIs
Line 93: Line 92:
             buffer.set_language(lang)
             buffer.set_language(lang)


# set up the view object, use it like gtk.TextView
# Establecemos el objeto para la vista, usarlo como gtk.TextView
view = gtksourceview2.View(buffer)
view = gtksourceview2.View(buffer)
view.set_size_request(300, 450)
view.set_size_request(300, 450)
Line 109: Line 108:
</pre>
</pre>


To set the text in the buffer:
Para agregar texto al buffer:
<pre>
<pre>
buffer.set_text(text)
buffer.set_text(text)
</pre>
</pre>
To get all the text:
Para obtener todo el texto:
<pre>
<pre>
text = buffer.get_text(buffer.get_start_iter(), buffer.get_end_iter())
text = buffer.get_text(buffer.get_start_iter(), buffer.get_end_iter())
</pre>
</pre>


You will probably want to put the view in a gtk.ScrolledWindow
Probablemente quieras poner la view(vista) en un gtk.ScrolledWindow
<pre>
<pre>
sw = gtk.ScrolledWindow()
sw = gtk.ScrolledWindow()
Line 124: Line 123:
sw.set_policy(gtk.POLICY_AUTOMATIC, gtk.POLICY_AUTOMATIC)
sw.set_policy(gtk.POLICY_AUTOMATIC, gtk.POLICY_AUTOMATIC)
</pre>
</pre>
and add the sw object instead of the view.
y agregar el el objeto sw en vez de la view(vista).




You can find more in the Pippy source and in jarabe.view.sourceview.
Puedes encotnrar más en el código fuete de Pippyy en jarabe.view.sourceview.


== Audio & Video ==
== Audio y Video ==
* [[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 140: Line 139:
</pre>
</pre>


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


<pre>
<pre>
Line 146: 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 181: 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 204: 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 216: 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.
 
=== ¿Cómo puedo saber si mi actividad se está ejecutando en una XO? ===
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.  


=== How do I know whether my activity is running on a physical XO? ===
[http://lists.laptop.org/pipermail/devel/2008-June/015923.html reliably detecting if running on an 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>
[[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 238: 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 251: 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.  


* If you already have a working build installed and an internet connection, first try [[olpc:olpc-update]].  
* Si usted ya tiene una build instalada y una conexión a Internet, primero pruebe usar [[OLPC: OLPC-update]].
* If that doesn't work, you can look at instructions for an [[olpc:Activated upgrade]] that can be done via USB] boot.
* Si eso no funciona, puedes mirar las instrucciones para una [[OLPC: Activated upgrade]] que se puede hacer a través de un USB]


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.
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.


=== Estoy desarrollando en una XO pero mi teclado y la configuración de idioma no son ideales. ¿Cómo puedo cambiarlos? ===


=== I am developing on an XO laptop, but my keyboard and language settings are not ideal. How can I change them? ===
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]]
 
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 336: 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 411: 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 422: 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"