reorganisation of directories

Matthew East mdke at ubuntu.com
Sun Feb 4 13:54:02 UTC 2007


On Sat, 2007-01-27 at 14:42 +0100, Matthew East wrote:
> Hi,
> 
> Although I thought our directory structure was going to work better than
> the one we've used in previous releases, it turns out that it won't, and
> translating the documentation would have been much more difficult.
> 
> So I've moved things back to the old structure.
> 
> Example:
> 
> trunk/ubuntu/C/internet/internet.xml is now at
> trunk/ubuntu/internet/C/internet.xml
> 
> The consequence of this (unfortunately) is that we have lots of broken
> links that need to be fixed. This should be relatively easy with sed or
> find/replace, but first we need to decide upon which technique to use to
> link between documents.
> 
> I think the best way to do this is to use the GNOME/KDE help system links.
> So for example, in GNOME:
> 
> <ulink type=“help” url=“ghelp://internet?wireless”>link text</ulink>
> 
> The alternative would be to do something clever with a ⟨ entity in
> the link urls, which I'm not so keen on.
> 
> Any thoughts?

Ok, I've gone through the ubuntu subdirectory and fixed most of the
links with a script. I've left the script I used for reference purposes.

There are a few broken links remaining, because not all of the documents
in the ubuntu subdirectory have a good naming convention (ie.
documentname/C/documentname.xml) - I'll fix these gradually.

Matt
-- 
http://www.mdke.org
gnupg pub 1024D/0E6B06FF






More information about the ubuntu-doc mailing list