Revisar la documentación de pilas

[hugoruscitti]

Saludos a todos, con Enrique Porta estámos haciendo varias mejoras en pilas. Pero
necesitamos algo de ayuda para revisar la documentación e ir viendo si tiene cosas
para corregir: errores, ejemplos que no funcionen, cosas que no se explican bien etc...

Estamos buscando colaboradores para esa tarea, ¿algún voluntario nos podría?

[hechelion]

Voy a ser honesto, aún no me decido bien por que engine usar en linux, por lo cual creo que estaré probando de todo un poco durante un tiempo y puedo darte una mano con la revisión de documentación en el proceso, sin embargo no me comprometo a grandes cosas ya que durante el proceso puede que descarte definitivamente a pilas como candidato y en ese punto dejaría de ayudarte con la documentación.

¿Más menos cual sería la idea de lo que hay que revisar y donde lo encuentro?.

[hugoruscitti]

Buenisimo hechelion, la documentación está en:

http://readthedocs.org/docs/pilas/en/latest/

No te hagas drama por el tiempo que le puedas dedicar, con que
puedas darle una revisada general sería genial.

[hechelion]

¿Cómo te aviso de los errores? ¿Por acá?

Página:
http://readthedocs.org/docs/pilas/en/la ... acion.html

Titulo:
¿Por qué pilas?

Error:

...Pilas está focalizado en ofrecer ayuda a los desarrolladores de juegos casuales y novatos QUE quieran hacer sus primeros videojuegos..

(faltó un "que")

facilitar las tareas mÁs comunes del desarrollo.

(ese más va con tilde)

************************************************************************************************************************************
Problema con la documentación de instalación.
En la documentación de instalación dice lo siguiente:

Existen 3 formas de instalar la biblioteca

La primera me ha quedado clara, aunque aún no la pruebo, ya haré mi comentario cuando pueda.

El problema está en los conceptos de la segunda y tercera opción, estás hablan de una descarga, la cual luego de varios minutos de búsqueda, solo logré dar con un instalador para windows, si dentro de las opciones de instalación se habla de una descarga manual, creo que sería buena idea colocar el link donde se puede descargar la librería.
Lo otro, es que al leer esos modos de instalación, me parece más bien que hablan de una distribución con lo cual creo que quedaría más ordenado si se hace una separación entre lo que es instalación para desarrollar con la librería y lo que es una distribución para que terceros puedan correr el juego que yo desarrolle con la librería, tal cual está ahora induce a error, pues el titulo da a entender que yo debería tener 3 formas de instalar la librería para poder desarrollar con ella, cuando en la practica, solo pude dar con una (instalación desde repositorios o ejecución de un instalable para windows).

Recuerden que hablo desde la perspectiva de alguien externo que está tratando de ejecutar su primer proyecto con pilas.
*************************************************************************************************************************************************
Link:
http://readthedocs.org/docs/pilas/en/latest/fisica.html

Por defecto, la gravedad del escenario es de (0, -90), esto significa que los objetos “caen” hacia abajo, y lo hacen con una aceleración de 90 (mts por segundo).

¿Como transformamos los metros a pixel? ¿Que la aceleración promedio de la tierra no es de 9 no 90, mts/s^2?

[hechelion]

El primer error siguiendo la documentación, lo reporto por acá en vez de buscar la solución ya que si falta agregar algo o modificar algo, esto debería estar disponible en la documentación también.

OS:GNU/Linux, Ubuntu 11.10 con KDE.
Python versión: 2.7.2+

Seguí la instalación paso a paso de la documentación de Pilas.

sudo apt-get install python-setuptools python-pygame python-box2d python-qt4 python-qt4-gl ipython
sudo easy_install -U pilas

(no marcó ningún error durante la instalación aunque algunos paquetes como el setuptoold o pygames ya los tenía instalado de antemano.), al ejecutar python no tuve ningún problema al importar el modulo pero al iniciar me arrojó los siguientes problemas:

Código: Seleccionar todo

nino@LiSmaug:~$ python
Python 2.7.2+ (default, Oct  4 2011, 20:06:09)
[GCC 4.6.1] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import pilas
>>> pilas.iniciar()
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/local/lib/python2.7/dist-packages/pilas-0.66-py2.7.egg/pilas/__init__.py", line 75, in iniciar
    motor = _crear_motor(usar_motor)
  File "/usr/local/lib/python2.7/dist-packages/pilas-0.66-py2.7.egg/pilas/__init__.py", line 109, in _crear_motor
    from motores import motor_qt
  File "/usr/local/lib/python2.7/dist-packages/pilas-0.66-py2.7.egg/pilas/motores/motor_qt.py", line 14, in <module>
    from PyQt4.phonon import Phonon
ImportError: No module named phonon


[kiketom]

El primer error siguiendo la documentación, lo reporto por acá en vez de buscar la solución ya que si falta agregar algo o modificar algo, esto debería estar disponible en la documentación también.

Hola hechelion, gracias por darle un vistazo a la doc y documentar las cosas que falten o fallen.
En concreto, esto que comentas, es que falta instalar un paquete y faltaría añadirlo a la documentación
Este problema salió en el foro no hace mucho:
Tema phonon

Gracias por todo

[hugoruscitti]

hechelion muchisimas gracias!!!, recién subí a la documentación todos los cambios
que nos comentaste, son ciertos todos... de hecho, la sección de instalación la simplifiqué
muchisimo, es cierto lo que dices, para alguien que comienza era muy confuso...

Mas tarde voy a modificar los tutoriales de instalación, hace falta instalar phonon como
dice kiketom, así que voy a modificar los tutoriales para mencionar eso.

Saludos !