Hi Guys
I am working through the plugin tutorial, I have some small programming
experience but not in python so I am coming to this as a total noob. I am
using ubuntu 8.10. I do have enough knowledge to work out or around the
problems below but it would be nice if the tutorial 'just worked'. So I
will tell you the problems I had so that the tutorial can be improved.
The first problem I had was when I tried to run setup.py. Python just gave
an error:
"SyntaxError: Non-ASCII character '\xc3' in file setup.py on line 11, but
no encoding declared"
I fixed it by adding to the front of the file.
# -*- coding: utf-8 -*-
So maybe that should be included in the given setup.py files.
The next one is that there is confusion about what goes where. The command:
"python elisa-plugins/elisa/plugins/apple-trailers/setup.py egg_info -e
elisa-plugins/"
only works if run from the directory that you originally created the
folder structure in (in my case ~/). If this is intentional then you need
to mention that people need to cd up to that folder before running the
command.
Next problem is that when you run:
"bzr add elisa_plugin_apple_trailers.egg-info"
it doesn't work because that folder is in ~/elisa-plugins not in
~/elisa-plugins/elisa/plugins/apple-trailers/ So where is it supposed to
be? do i need to cd there before running the command? should it actually
be in ~/elisa-plugins/elisa/plugins/apple-trailers/ and the setup.py
command is wrong?
Further confusion came with the next bit about resources. It says "we can
just put the file in the directory's root". Does this means the png file
*and* the resource.conf ? Which folder is the directorys root? ~/ or
~/elisa-plugins or ~/elisa-plugins/elisa/plugins/apple-trailers. A note
somewhere near the start about the root directory and general directory
structure might be useful.
Well that's as far as I got so far. I also corrected a typo that I found.
I really like Elisa but the documentation is quite poor and there are very
few plugins. I hope I can help to improve both these situations.
