Re: Status of the Ubuntu Docs in Natty
On Mon, 2011-02-28 at 13:24 +0100, David Planella wrote: El dv 25 de 02 de 2011 a les 15:20 -0500, en/na Shaun McCance va escriure: Are you referring to the new topic-based help (Desktop Help) or the old user guide (Desktop User Guide)? The default was changed pretty recently, and I'm not sure what build of Yelp you're using. Hey Shaun, I seem to remember it was the new topic-based help. I can no longer see it due to https://bugs.launchpad.net/ubuntu/+source/yelp/+bug/726490 (not reported upstream yet, I want to make sure it's not a distro bug first). That really looks to me like the document isn't installed. What version of gnome-user-docs do you have installed? Do you have any .page files under /usr/share/gnome/help/gnome-help/C/ ? Regarding translations, what's the reason for them not being available? Can yelp not yet translate them, or are the translatable messages not yet exposed for translation, or is there any other reason? That's a good question. I'd just assumed it was because nobody had done any translations yet. But looking at the GNOME l10n status pages, I don't see gnome-user-docs listed. I'll ping gnome-i18n and let them know. 1) Ubuntu could just ensure that, in every bit of code that wants to display the desktop help, Yelp is called with a URI. ... 2) Ubuntu could patch Yelp to have a different default URI. I think this is what's been done in the past. It could be a good patch. Or I could make the default document a setting, and it could be a schema patch. It's a patch either way. ... 3) Yelp could have some desktop detection, and choose the default URI accordingly. There's no standard way to find this information. There've been sporadic xdg-list threads on the topic. It's always shot down. We might be able to do some sort of process or service detection. Thanks a lot for the detailed analysis and for presenting the options. Would anyone from the Ubuntu Docs team like to comment on these to bring this forward? I should also mention (4). I've been working on splitting Yelp's core document processing into a separate library called libyelp. At the moment, it's just part of the yelp module, but it will be split off eventually. This is probably not an option for the next release, but going forward, Ubuntu could build its own help viewer based on libyelp. A custom viewer could be much more integrated with Unity. It's conceivable that GNOME might do something similar in the future, making help feel more like part of the shell than an application. To make this seamless to applications, we'll need to decide on some generic DBus methods to invoke help, and get applications to start using those instead of execing Yelp. This should go to freedesktop.org, and we should get other desktops involved. -- Shaun -- ubuntu-translators mailing list ubuntu-translators@lists.ubuntu.com https://lists.ubuntu.com/mailman/listinfo/ubuntu-translators
Re: Status of the Ubuntu Docs in Natty
On 1 March 2011 07:29, David Planella david.plane...@ubuntu.com wrote: El dl 28 de 02 de 2011 a les 09:55 -0500, en/na Shaun McCance va escriure: On Mon, 2011-02-28 at 13:24 +0100, David Planella wrote: El dv 25 de 02 de 2011 a les 15:20 -0500, en/na Shaun McCance va escriure: Are you referring to the new topic-based help (Desktop Help) or the old user guide (Desktop User Guide)? The default was changed pretty recently, and I'm not sure what build of Yelp you're using. Hey Shaun, I seem to remember it was the new topic-based help. I can no longer see it due to https://bugs.launchpad.net/ubuntu/+source/yelp/+bug/726490 (not reported upstream yet, I want to make sure it's not a distro bug first). That really looks to me like the document isn't installed. What version of gnome-user-docs do you have installed? As far as I can tell, gnome-user-docs is not packaged, or at least I could not find a package for it. I've only got the gnome-user-guide installed, which contains the user, ally and admin guides. gnome-user-docs is the source package which provides gnome-user-guide. Do you have any .page files under /usr/share/gnome/help/gnome-help/C/ ? No, I don't have any file there at all. In fact, the gnome-help folder does not exist in /usr/share/gnome/help/ I think this is the issue - gnome-user-docs needs to be updated with the current upstream material to provide these files, and it hasn't been uploaded yet this release. That also depends upon how we deal with the other issues that have been raised in this thread. -- Matthew East http://www.mdke.org gnupg pub 1024D/0E6B06FF -- ubuntu-translators mailing list ubuntu-translators@lists.ubuntu.com https://lists.ubuntu.com/mailman/listinfo/ubuntu-translators
Re: Status of the Ubuntu Docs in Natty
El dt 01 de 03 de 2011 a les 08:15 +, en/na Matthew East va escriure: On 1 March 2011 07:29, David Planella david.plane...@ubuntu.com wrote: El dl 28 de 02 de 2011 a les 09:55 -0500, en/na Shaun McCance va escriure: On Mon, 2011-02-28 at 13:24 +0100, David Planella wrote: El dv 25 de 02 de 2011 a les 15:20 -0500, en/na Shaun McCance va escriure: Are you referring to the new topic-based help (Desktop Help) or the old user guide (Desktop User Guide)? The default was changed pretty recently, and I'm not sure what build of Yelp you're using. Hey Shaun, I seem to remember it was the new topic-based help. I can no longer see it due to https://bugs.launchpad.net/ubuntu/+source/yelp/+bug/726490 (not reported upstream yet, I want to make sure it's not a distro bug first). That really looks to me like the document isn't installed. What version of gnome-user-docs do you have installed? As far as I can tell, gnome-user-docs is not packaged, or at least I could not find a package for it. I've only got the gnome-user-guide installed, which contains the user, ally and admin guides. gnome-user-docs is the source package which provides gnome-user-guide. Do you have any .page files under /usr/share/gnome/help/gnome-help/C/ ? No, I don't have any file there at all. In fact, the gnome-help folder does not exist in /usr/share/gnome/help/ I think this is the issue - gnome-user-docs needs to be updated with the current upstream material to provide these files, and it hasn't been uploaded yet this release. That also depends upon how we deal with the other issues that have been raised in this thread. Thanks Matthew. The intention of the original post was as well to spark the discussion on the current issues and how to deal with them. What do you guys think the best way forward for the Ubuntu Docs in Natty is? Do you have any comments on some of the options Shaun presented? I think it might be useful to start with a list or summary of pending issues and options to get Ubuntu Docs in Natty, and then work out the plan to solve them. Another idea might be to organize a docs team meeting to discuss all this, which I believe would be quite useful. What do you think? Regards, David. -- David Planella Ubuntu Translations Coordinator www.ubuntu.com / www.davidplanella.wordpress.com www.identi.ca/dplanella / www.twitter.com/dplanella signature.asc Description: This is a digitally signed message part -- ubuntu-translators mailing list ubuntu-translators@lists.ubuntu.com https://lists.ubuntu.com/mailman/listinfo/ubuntu-translators