[Nepomuk] Fwd: [kde-runtime/active-development/master] nepomuk: remove references to "nepomuk" and "strigi" in the UI that users are likely to see
Aaron J. Seigo
aseigo at kde.org
Thu Jul 28 15:02:50 CEST 2011
hi guys ...
it's that time of year again.. you know, the day after release where i
suddenly notice that once again there are dozens of translated strings in
nepomuk code that the user will see which contain the words "nepomuk" and/or
"strigi".
yep, pretty well every. single. release. we manage to ship a bunch of "Nepomuk
this" and "Strigi that" to our users, most of whom just look at those messages
and wonder what we're smoking. "What is .. nee-puh-mook?"
getting nepomuk and strigi into top flight shape technically is of course of
paramount importance. nothing really matters if it doesn't work well, right?
right.
but it's equally important to make sure that the user experience is good.
because if it isn't, it doesn't matter how well nepomuk runs, our users will
think it is garbage.
even worse, most of our users do not know the difference between nepomuk and
the desktop it seems so well integrated with, so these leakages of jargon
affect not only the perception of nepomuk, but everything included in the
Plasma Desktop as well.
this is not cool. we must improve on this.
now, i apologize right here and now for the this lecture because it is not fun
to read, i'm sure. it's not fun to write either. i'd rather be doing other
things, too. :) but this is IMPORTANT, and it keeps happening. i keep talking
about it, i keep fixing things on your behalf but we keep repeating the same
simple errors over and over and over again.
so .. here's the easy solution which will make our user's lives better, which
means our lives as KDE hackers improves too:
whenever you are wrapping a message in i18n() and it contains the word
"nepomuk", "strigi" or any other similar bit of jargon, STOP! if this will
reasonably be shown to the user in the normal day-to-day user interface (so
items like server processes that don't show UI get a pass here), replace the
jargon with understandable, every-day, lay-person language.
it is not hard to do, it takes just a moment of time and the least bit of
self-discipline. it is the most valuable .5 seconds you are likely to spend in
terms of payback: other things with that kind of immediate user impact usually
take a lot longer to accomplish.
with that out of the way, someone needs to go through the backup GUI and de-
jargon the strings.
and please, can we all agree to work on this together? to make Plasma Desktop
a Jargon Free(tm) zone? to ship 4.8 without user visible jargon?
thanks for your understanding and indulgence ...
---------- Forwarded Message ----------
Subject: [kde-runtime/active-development/master] nepomuk: remove references to
"nepomuk" and "strigi" in the UI that users are likely to see
Date: Thursday, July 28, 2011, 14:50:03
From: Aaron Seigo <aseigo at kde.org>
To: kde-commits at kde.org
Git commit d6a1cf3dfbd9f7ed5dceadc8e401451d7cebb9d4 by Aaron Seigo.
Committed on 28/07/2011 at 14:49.
Pushed by aseigo into branch 'active-development/master'.
remove references to "nepomuk" and "strigi" in the UI that users are likely to
see
M +2 -2 nepomuk/kioslaves/search/kio_nepomuksearch.cpp
M +8 -8 nepomuk/kcm/nepomukserverkcm.cpp
M +1 -1 nepomuk/kioslaves/nepomuk/kio_nepomuk.cpp
M +2 -2 nepomuk/controller/systray.cpp
M +1 -1 nepomuk/kioslaves/timeline/kio_timeline.cpp
M +5 -5 nepomuk/services/strigi/strigiservice.cpp
http://commits.kde.org/kde-runtime/d6a1cf3dfbd9f7ed5dceadc8e401451d7cebb9d4
diff --git a/nepomuk/controller/systray.cpp b/nepomuk/controller/systray.cpp
index 920877b..6cf6bc9 100644
--- a/nepomuk/controller/systray.cpp
+++ b/nepomuk/controller/systray.cpp
@@ -43,7 +43,7 @@ Nepomuk::SystemTray::SystemTray( QObject* parent )
{
setCategory( SystemServices );
setIconByName( "nepomuk" );
- setTitle( i18n( "Nepomuk File Indexing" ) );
+ setTitle( i18n( "Desktop Search File Indexing" ) );
// the status widget
connect(this, SIGNAL(activateRequested(bool,QPoint)), this,
SLOT(slotActivateRequested()));
@@ -115,7 +115,7 @@ void Nepomuk::SystemTray::slotUpdateStrigiStatus()
if( strigiServiceInitialized )
statusString = m_service->userStatusString();
else
- statusString = i18n("Nepomuk File Indexing Service not running");
+ statusString = i18n("File indexing service not running");
if ( statusString != m_prevStatus ) {
m_prevStatus = statusString;
setToolTip("nepomuk", i18n("Search Service"), statusString );
diff --git a/nepomuk/kcm/nepomukserverkcm.cpp
b/nepomuk/kcm/nepomukserverkcm.cpp
index 4ae8dd8..b6bc457 100644
--- a/nepomuk/kcm/nepomukserverkcm.cpp
+++ b/nepomuk/kcm/nepomukserverkcm.cpp
@@ -139,7 +139,7 @@ Nepomuk::ServerConfigModule::ServerConfigModule( QWidget*
parent, const QVariant
m_failedToInitialize( false )
{
KAboutData *about = new KAboutData(
- "kcm_nepomuk", "kcm_nepomuk", ki18n("Nepomuk Configuration Module"),
+ "kcm_nepomuk", "kcm_nepomuk", ki18n("Desktop Search Configuration
Module"),
KDE_VERSION_STRING, KLocalizedString(), KAboutData::License_GPL,
ki18n("Copyright 2007-2010 Sebastian Trüg"));
about->addAuthor(ki18n("Sebastian Trüg"), KLocalizedString(),
"trueg at kde.org");
@@ -228,7 +228,7 @@ Nepomuk::ServerConfigModule::ServerConfigModule( QWidget*
parent, const QVariant
}
}
else {
- QLabel* label = new QLabel( i18n( "The Nepomuk installation is not
complete. No Nepomuk settings can be provided." ) );
+ QLabel* label = new QLabel( i18n( "The Nepomuk installation is not
complete. No desktop search settings can be provided." ) );
label->setAlignment( Qt::AlignCenter );
QVBoxLayout* layout = new QVBoxLayout( this );
layout->addWidget( label );
@@ -365,9 +365,9 @@ void Nepomuk::ServerConfigModule::save()
else if( m_checkEnableNepomuk->isChecked() ) {
if ( !QProcess::startDetached( QLatin1String( "nepomukserver" ) ) ) {
KMessageBox::error( this,
- i18n( "Failed to start Nepomuk Server. The
settings have been saved "
+ i18n( "Failed to start the desktop search
service (Nepomuk). The settings have been saved "
"and will be used the next time the
server is started." ),
- i18n( "Nepomuk server not running" ) );
+ i18n( "Desktop search service not running" )
);
}
}
@@ -404,10 +404,10 @@ void
Nepomuk::ServerConfigModule::updateNepomukServerStatus()
{
if ( m_serverInterface &&
m_serverInterface->isNepomukEnabled() ) {
- m_labelNepomukStatus->setText( i18nc( "@info:status", "Nepomuk system
is active" ) );
+ m_labelNepomukStatus->setText( i18nc( "@info:status", "Desktop search
services are active" ) );
}
else {
- m_labelNepomukStatus->setText( i18nc( "@info:status", "Nepomuk system
is inactive" ) );
+ m_labelNepomukStatus->setText( i18nc( "@info:status", "Desktop search
services are disabled" ) );
}
}
@@ -429,11 +429,11 @@ void Nepomuk::ServerConfigModule::updateStrigiStatus()
}
else {
m_failedToInitialize = true;
- m_labelStrigiStatus->setText( i18nc( "@info:status", "Strigi
service failed to initialize, most likely due to an installation problem." )
);
+ m_labelStrigiStatus->setText( i18nc( "@info:status", "File
indexing service failed to initialize, most likely due to an installation
problem." ) );
}
}
else if ( !m_failedToInitialize ) {
- m_labelStrigiStatus->setText( i18nc( "@info:status", "Strigi service
not running." ) );
+ m_labelStrigiStatus->setText( i18nc( "@info:status", "File indexing
service not running." ) );
}
}
diff --git a/nepomuk/kioslaves/nepomuk/kio_nepomuk.cpp
b/nepomuk/kioslaves/nepomuk/kio_nepomuk.cpp
index 7869337..975b3f3 100644
--- a/nepomuk/kioslaves/nepomuk/kio_nepomuk.cpp
+++ b/nepomuk/kioslaves/nepomuk/kio_nepomuk.cpp
@@ -274,7 +274,7 @@ bool Nepomuk::NepomukProtocol::rewriteUrl( const KUrl&
url, KUrl& newURL )
bool Nepomuk::NepomukProtocol::ensureNepomukRunning()
{
if ( Nepomuk::ResourceManager::instance()->init() ) {
- error( KIO::ERR_SLAVE_DEFINED, i18n( "The Nepomuk system is not
activated. Unable to answer queries without it." ) );
+ error( KIO::ERR_SLAVE_DEFINED, i18n( "The desktop search service is
not activated. Unable to answer queries without it." ) );
return false;
}
else {
diff --git a/nepomuk/kioslaves/search/kio_nepomuksearch.cpp
b/nepomuk/kioslaves/search/kio_nepomuksearch.cpp
index e68b8bc..e26dd84 100644
--- a/nepomuk/kioslaves/search/kio_nepomuksearch.cpp
+++ b/nepomuk/kioslaves/search/kio_nepomuksearch.cpp
@@ -142,13 +142,13 @@ bool Nepomuk::SearchProtocol::ensureNepomukRunning( bool
emitError )
if ( Nepomuk::ResourceManager::instance()->init() ) {
kDebug() << "Failed to init Nepomuk";
if ( emitError )
- error( KIO::ERR_SLAVE_DEFINED, i18n( "The Nepomuk system is not
activated. Unable to answer queries without it." ) );
+ error( KIO::ERR_SLAVE_DEFINED, i18n( "The desktop search service
is not activated. Unable to answer queries without it." ) );
return false;
}
else if ( !Nepomuk::Query::QueryServiceClient::serviceAvailable() ) {
kDebug() << "Nepomuk Query service is not running.";
if ( emitError )
- error( KIO::ERR_SLAVE_DEFINED, i18n( "The Nepomuk query service
is not running. Unable to answer queries without it." ) );
+ error( KIO::ERR_SLAVE_DEFINED, i18n( "The desktop search query
service is not running. Unable to answer queries without it." ) );
return false;
}
else {
diff --git a/nepomuk/kioslaves/timeline/kio_timeline.cpp
b/nepomuk/kioslaves/timeline/kio_timeline.cpp
index 9d53e68..e3f9313 100644
--- a/nepomuk/kioslaves/timeline/kio_timeline.cpp
+++ b/nepomuk/kioslaves/timeline/kio_timeline.cpp
@@ -126,7 +126,7 @@ void Nepomuk::TimelineProtocol::listDir( const KUrl& url )
"/servicecontrol",
QDBusConnection::sessionBus()
).isInitialized() ) {
error( KIO::ERR_SLAVE_DEFINED,
- i18n( "The Nepomuk Strigi file indexing service is not
running. Without it timeline results are not available." ) );
+ i18n( "The file indexing service is not running. Without it
timeline results are not available." ) );
return;
}
diff --git a/nepomuk/services/strigi/strigiservice.cpp
b/nepomuk/services/strigi/strigiservice.cpp
index 0189679..2b4fd12 100644
--- a/nepomuk/services/strigi/strigiservice.cpp
+++ b/nepomuk/services/strigi/strigiservice.cpp
@@ -155,23 +155,23 @@ QString Nepomuk::StrigiService::userStatusString( bool
simple ) const
bool suspended = m_indexScheduler->isSuspended();
if ( suspended ) {
- return i18nc( "@info:status", "File indexer is suspended" );
+ return i18nc( "@info:status", "File indexer is suspended." );
}
else if ( indexing ) {
QString folder = m_indexScheduler->currentFolder();
if ( folder.isEmpty() || simple )
- return i18nc( "@info:status", "Strigi is currently indexing
files" );
+ return i18nc( "@info:status", "Indexing files for desktop
search." );
else {
QString file = KUrl( m_indexScheduler->currentFile()
).fileName();
if( file.isEmpty() )
- return i18nc( "@info:status", "Strigi is currently indexing
files in folder %1", folder );
+ return i18nc( "@info:status", "Indexing files in %1", folder
);
else
- return i18nc( "@info:status", "Strigi is currently indexing
files in folder %1 (%2)", folder, file );
+ return i18nc( "@info:status", "Indexing files in %1 (%2)",
folder, file );
}
}
else {
- return i18nc( "@info:status", "File indexer is idle" );
+ return i18nc( "@info:status", "File indexer is idle." );
}
}
-----------------------------------------
--
Aaron J. Seigo
humru othro a kohnu se
GPG Fingerprint: 8B8B 2209 0C6F 7C47 B1EA EE75 D6B7 2EB1 A7F1 DB43
KDE core developer sponsored by Qt Development Frameworks
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part.
Url : http://mail.kde.org/pipermail/nepomuk/attachments/20110728/e38e83b2/attachment-0001.sig
More information about the Nepomuk
mailing list