[kde-doc-english] docs.kde.org issues

[Burkhard Lück]

Am Dienstag, 10. Januar 2012, 11:21:13 schrieb Burkhard Lück:
> Hi,
> 
> some issues with docs.kde.org:
> 
> 1) Broken links to common folder with e.g. number png's
> Local Installation
> en/common with untranslated license html files, css + png files etc
> en/app/common symlink to en/common
> lang/common -> with translated license html files
> lang/app/common -> symlink to lang/common
> d.k.o has an additional module folder
> module/en/common (content like local installation)
> module/en/app -> no common subdir
> module/lang/common dir with translated license html files
> module/lang/app/ -> no common subdir
> Possible solution:
> add common folder (symlink to en/common) to each lang/module/app folder
> www/areas/docs/generator creates already symlinks to en screenshots for
> lang folders without localized screenshots.
> 
> 2) dead license links (https://bugs.kde.org/show_bug.cgi?id=109143)
> Solution of issue 1) would solve that, you get the english licenses, but
> not the translated
> 
> 2) In KHelpcenter the english documentation will be displayed in case there
> is no translated documentation
> To get the same behaviour we need to add a symlink (to en/app) to each
> empty lang/app folder
> 
> 3) Links to other docbooks launch Konqueror with lokal Dokumentation
> Html files have e.g. href="help:appname"
> Possible solution:
> replace 'href="help:appname"' via sed with proposal from
> https://bugs.kde.org/show_bug.cgi?id=279900:
> 'href="http://docs.kde.org/?language=<language>&application=<appname>"
> 
> 4) Use app names + kcm names like in systemsettings, not installation/git
> dir names
> (https://bugs.kde.org/show_bug.cgi?id=227923 about using "kcontrol" on
> d.k.o) While this is for apps like Kate or the module names in the
> navigation panel only a minor issue, it is important for the
> kcontrol/systemsettings modules. For historical reasons some of these kcm
> docs have realy crazy names, which makes it nearly impossible for Joe User
> to find what he is looking for. E. g. kwintabbox -> "Task Switcher" or
> kcmsmserver-> "Session Management"  or kded->"Service Manager". I'd like
> to display the names you see in
> Systemsettings here.
> Afaik this should be doable via an php array?
> 
> Thanks.

Any comments, improvements, objections?

-- 
Burkhard Lück