Re: Ubuntu docs in 11.04
On Fri, 2011-04-22 at 11:52 -0500, Jim Campbell wrote: Thanks, Shaun, On Fri, Apr 22, 2011 at 10:47 AM, Shaun McCance sha...@gnome.org wrote: So I don't know where in the Ubuntu build process this is all happening. Is this building from bzr or a released package? The top srcdir should contain a file gnome-doc-utils.make Line 364 should look like this: _DOC_POT = $(if $(DOC_MODULE),$(DOC_MODULE).pot) Try changing that to this: _DOC_POT = $(if $(DOC_MODULE),$(DOC_MODULE).pot,\ $(if $(DOC_ID),$(DOC_ID).pot)) That should make 'make pot' work, which is what happened for DocBook documents. Can somebody check to see if that's all that's needed? Perhaps I'm not looking in the right place, but I don't see the gnome-doc-utils.make file in our top level source directory. I don't see it in the gnome-user-docs from GNOME git, though, either. I do see: EXTRA_DIST = gnome-doc-utils.make DISTCLEANFILES = gnome-doc-utils.make in the ubuntu-docs Makefile.am file, though. I'm not sure how this gets resolved. Sorry, that file is generated by autogen.sh. It's then included in tarball releases. If the change I described fixes the issue in Ubuntu, I can fix it in gnome-doc-utils and make a release. -- Shaun -- ubuntu-translators mailing list ubuntu-translators@lists.ubuntu.com https://lists.ubuntu.com/mailman/listinfo/ubuntu-translators
Re: Ubuntu docs in 11.04
On Fri, 2011-04-22 at 06:44 +, Matthew East wrote: On 19 April 2011 07:12, Matthew East m...@ubuntu.com wrote: On 19 April 2011 07:08, David Planella david.plane...@ubuntu.com wrote: However, in order to enable the new 'gnome-help' and 'user guide' ones, their POT templates need to be generated during the source package build, which does not seem to be the case. Could someone from the docs team investigate this? I will look into this - I assumed that this would be done automatically as part of the Gnome build process. I have looked at this but unfortunately have not been able to figure out why this is not happening as it should. From a packaging point of view I don't think that anything should be different from previous releases of gnome-user-docs. I have filed a bug here: https://bugs.launchpad.net/ubuntu/+source/gnome-user-docs/+bug/768814 If anyone who knows something about the Gnome build process could take a look at the package, that would be appreciated. So I don't know where in the Ubuntu build process this is all happening. Is this building from bzr or a released package? The top srcdir should contain a file gnome-doc-utils.make Line 364 should look like this: _DOC_POT = $(if $(DOC_MODULE),$(DOC_MODULE).pot) Try changing that to this: _DOC_POT = $(if $(DOC_MODULE),$(DOC_MODULE).pot,\ $(if $(DOC_ID),$(DOC_ID).pot)) That should make 'make pot' work, which is what happened for DocBook documents. Can somebody check to see if that's all that's needed? -- 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 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 Fri, 2011-02-25 at 20:46 +0100, David Planella wrote: Hi all, I've been checking out the yelp version in Natty this week, and apart from watching in awe the increase in speed, I've also been wondering about the status of the Ubuntu docs and their translations, especially after the discussions regarding the project direction a few weeks ago. I've noticed that there isn't any front page for the Ubuntu docs yet, and that currently launching yelp shows the GNOME desktop guide in English (I'll have to investigate why this happens, I suspect it might be a problem on the translations packaging or importing side). 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. If it's the topic-based help, there are no translations right now. So that would explain why you're seeing English. Otherwise, if there's a problem with the localized document lookup, please let me know. That would be a very critical bug. As for the Ubuntu docs being the front page, the idea was that the Desktop Help would just be able to be that for all distros, and that extra pages could be added when it makes sense. That was a really good plan a year ago. But just as we finally got the technical bits in place, Ubuntu is switching to Unity as a default desktop. So the GNOME Desktop Help is probably not going to be a good base document. Ubuntu is probably going to need its own main help document, as it's had in the past. Let's figure out how to best make that work. 1) Ubuntu could just ensure that, in every bit of code that wants to display the desktop help, Yelp is called with a URI. Pro: no patching to Yelp. Con: Some code somewhere might get missed. 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. Pro: pretty straight-forward. Con: Yelp will still load the Unity-based desktop help for users who choose to download stock GNOME. 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. Pro: paves the way for Yelp to be used as-is to serve other desktops. Con: probably only ever going to be 90% accurate. My priority is making sure that people get accurate and useful help, regardless of what desktop or distro they're running. So whatever it takes to make that happen, that's what I'll do. Thanks, 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 Fri, 2011-02-25 at 15:20 -0500, Shaun McCance wrote: 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. s/good/code/ The patch might be good, but that's not what I was saying. :) -- Shaun -- ubuntu-translators mailing list ubuntu-translators@lists.ubuntu.com https://lists.ubuntu.com/mailman/listinfo/ubuntu-translators