make connectivity and quota views translatable (#2694)

* add missing stock strings for connectivity and quota

* reword quota error

* use 'Incoming/Outgoing Messages' instead of 'Inbox/Outbox'

* just say 'Not supported by your provider.' if quota cannot be read.

- the context is already given by the headline
  'Storage on domain.org'
- the string is short and does not disturb much
  (it is a very common error)
- the string does not mention 'quota' as such,
  which will be hard to translate ('Kontingentsinformationen') -
  even if ppl as we know about the Quota extensions an such things.

there was also the idea to hide the whole section,
however, that is confusing in a multi-device-usage
when things are sometimes shown and sometimes not.
This commit is contained in:
bjoern
2021-09-20 21:43:53 +02:00
committed by GitHub
parent 43d1d9b1b3
commit 66a5e0743d
4 changed files with 196 additions and 22 deletions

View File

@@ -5900,6 +5900,70 @@ void dc_event_unref(dc_event_t* event);
/// `%1$s` will be replaced by human-readable date and time. /// `%1$s` will be replaced by human-readable date and time.
#define DC_STR_DOWNLOAD_AVAILABILITY 100 #define DC_STR_DOWNLOAD_AVAILABILITY 100
/// "Incoming Messages"
///
/// Used as a headline in the connectivity view.
#define DC_STR_INCOMING_MESSAGES 103
/// "Outgoing Messages"
///
/// Used as a headline in the connectivity view.
#define DC_STR_OUTGOING_MESSAGES 104
/// "Storage on %1$s"
///
/// Used as a headline in the connectivity view.
///
/// `%1$s` will be replaced by the domain of the configured email-address.
#define DC_STR_STORAGE_ON_DOMAIN 105
/// "One moment…"
///
/// Used in the connectivity view when some information are not yet there.
#define DC_STR_ONE_MOMENT 106
/// "Connected"
///
/// Used as status in the connectivity view.
#define DC_STR_CONNECTED 107
/// "Connecting…"
///
/// Used as status in the connectivity view.
#define DC_STR_CONNTECTING 108
/// "Updating…"
///
/// Used as status in the connectivity view.
#define DC_STR_UPDATING 109
/// "Sending…"
///
/// Used as status in the connectivity view.
#define DC_STR_SENDING 110
/// "Your last message was sent successfully."
///
/// Used as status in the connectivity view.
#define DC_STR_LAST_MSG_SENT_SUCCESSFULLY 111
/// "Error: %1$s"
///
/// Used as status in the connectivity view.
///
/// `%1$s` will be replaced by a possibly more detailed, typically english, error description.
#define DC_STR_ERROR 112
/// "Not supported by your provider."
///
/// Used in the connectivity view.
#define DC_STR_NOT_SUPPORTED_BY_PROVIDER 113
/// "Messages"
///
/// Used as a subtitle in quota context; can be plural always.
#define DC_STR_MESSAGES 114
/** /**
* @} * @}
*/ */

View File

@@ -128,7 +128,7 @@ impl Context {
let folders = get_watched_folders(self).await; let folders = get_watched_folders(self).await;
get_unique_quota_roots_and_usage(folders, imap).await get_unique_quota_roots_and_usage(folders, imap).await
} else { } else {
Err(anyhow!("Quota not supported by your provider.")) Err(anyhow!(stock_str::not_supported_by_provider(self).await))
}; };
if let Ok(quota) = &quota { if let Ok(quota) = &quota {

View File

@@ -8,7 +8,7 @@ use crate::events::EventType;
use crate::quota::{ use crate::quota::{
QUOTA_ERROR_THRESHOLD_PERCENTAGE, QUOTA_MAX_AGE_SECONDS, QUOTA_WARN_THRESHOLD_PERCENTAGE, QUOTA_ERROR_THRESHOLD_PERCENTAGE, QUOTA_MAX_AGE_SECONDS, QUOTA_WARN_THRESHOLD_PERCENTAGE,
}; };
use crate::{config::Config, dc_tools, scheduler::Scheduler}; use crate::{config::Config, dc_tools, scheduler::Scheduler, stock_str};
use crate::{context::Context, log::LogExt}; use crate::{context::Context, log::LogExt};
use anyhow::{anyhow, Result}; use anyhow::{anyhow, Result};
use humansize::{file_size_opts, FileSize}; use humansize::{file_size_opts, FileSize};
@@ -73,33 +73,33 @@ impl DetailedConnectivity {
} }
} }
fn to_string_imap(&self, _context: &Context) -> String { async fn to_string_imap(&self, context: &Context) -> String {
match self { match self {
DetailedConnectivity::Error(e) => format!("Error: {}", e), DetailedConnectivity::Error(e) => stock_str::error(context, e).await,
DetailedConnectivity::Uninitialized => "Not started".to_string(), DetailedConnectivity::Uninitialized => "Not started".to_string(),
DetailedConnectivity::Connecting => "Connecting".to_string(), DetailedConnectivity::Connecting => stock_str::connecting(context).await,
DetailedConnectivity::Working => "Getting new messages…".to_string(), DetailedConnectivity::Working => stock_str::updating(context).await,
DetailedConnectivity::InterruptingIdle | DetailedConnectivity::Connected => { DetailedConnectivity::InterruptingIdle | DetailedConnectivity::Connected => {
"Connected".to_string() stock_str::connected(context).await
} }
DetailedConnectivity::NotConfigured => "Not configured".to_string(), DetailedConnectivity::NotConfigured => "Not configured".to_string(),
} }
} }
fn to_string_smtp(&self, _context: &Context) -> String { async fn to_string_smtp(&self, context: &Context) -> String {
match self { match self {
DetailedConnectivity::Error(e) => format!("Error: {}", e), DetailedConnectivity::Error(e) => stock_str::error(context, e).await,
DetailedConnectivity::Uninitialized => { DetailedConnectivity::Uninitialized => {
"(You did not try to send a message recently)".to_string() "You did not try to send a message recently.".to_string()
} }
DetailedConnectivity::Connecting => "Connecting".to_string(), DetailedConnectivity::Connecting => stock_str::connecting(context).await,
DetailedConnectivity::Working => "Sending".to_string(), DetailedConnectivity::Working => stock_str::sending(context).await,
// We don't know any more than that the last message was sent successfully; // We don't know any more than that the last message was sent successfully;
// since sending the last message, connectivity could have changed, which we don't notice // since sending the last message, connectivity could have changed, which we don't notice
// until another message is sent // until another message is sent
DetailedConnectivity::InterruptingIdle | DetailedConnectivity::Connected => { DetailedConnectivity::InterruptingIdle | DetailedConnectivity::Connected => {
"Your last message was sent successfully".to_string() stock_str::last_msg_sent_successfully(context).await
} }
DetailedConnectivity::NotConfigured => "Not configured".to_string(), DetailedConnectivity::NotConfigured => "Not configured".to_string(),
} }
@@ -251,7 +251,7 @@ impl Context {
/// One of: /// One of:
/// - DC_CONNECTIVITY_NOT_CONNECTED (1000-1999): Show e.g. the string "Not connected" or a red dot /// - DC_CONNECTIVITY_NOT_CONNECTED (1000-1999): Show e.g. the string "Not connected" or a red dot
/// - DC_CONNECTIVITY_CONNECTING (2000-2999): Show e.g. the string "Connecting…" or a yellow dot /// - DC_CONNECTIVITY_CONNECTING (2000-2999): Show e.g. the string "Connecting…" or a yellow dot
/// - DC_CONNECTIVITY_WORKING (3000-3999): Show e.g. the string "Getting new messages" or a spinning wheel /// - DC_CONNECTIVITY_WORKING (3000-3999): Show e.g. the string "Updating…" or a spinning wheel
/// - DC_CONNECTIVITY_CONNECTED (>=4000): Show e.g. the string "Connected" or a green dot /// - DC_CONNECTIVITY_CONNECTED (>=4000): Show e.g. the string "Connected" or a green dot
/// ///
/// We don't use exact values but ranges here so that we can split up /// We don't use exact values but ranges here so that we can split up
@@ -380,7 +380,7 @@ impl Context {
}; };
drop(lock); drop(lock);
ret += "<h3>Incoming messages</h3><ul>"; ret += &format!("<h3>{}</h3><ul>", stock_str::incoming_messages(self).await);
for (folder, watch, state) in &folders_states { for (folder, watch, state) in &folders_states {
let w = self.get_config(*watch).await.ok_or_log(self); let w = self.get_config(*watch).await.ok_or_log(self);
@@ -395,7 +395,7 @@ impl Context {
ret += " <b>"; ret += " <b>";
ret += &*escaper::encode_minimal(&foldername); ret += &*escaper::encode_minimal(&foldername);
ret += ":</b> "; ret += ":</b> ";
ret += &*escaper::encode_minimal(&*detailed.to_string_imap(self)); ret += &*escaper::encode_minimal(&*detailed.to_string_imap(self).await);
ret += "</li>"; ret += "</li>";
folder_added = true; folder_added = true;
@@ -410,18 +410,21 @@ impl Context {
ret += "<li>"; ret += "<li>";
ret += &*detailed.to_icon(); ret += &*detailed.to_icon();
ret += " "; ret += " ";
ret += &*escaper::encode_minimal(&detailed.to_string_imap(self)); ret += &*escaper::encode_minimal(&detailed.to_string_imap(self).await);
ret += "</li>"; ret += "</li>";
} }
} }
} }
ret += "</ul>"; ret += "</ul>";
ret += "<h3>Outgoing messages</h3><ul><li>"; ret += &format!(
"<h3>{}</h3><ul><li>",
stock_str::outgoing_messages(self).await
);
let detailed = smtp.get_detailed().await; let detailed = smtp.get_detailed().await;
ret += &*detailed.to_icon(); ret += &*detailed.to_icon();
ret += " "; ret += " ";
ret += &*escaper::encode_minimal(&detailed.to_string_smtp(self)); ret += &*escaper::encode_minimal(&detailed.to_string_smtp(self).await);
ret += "</li></ul>"; ret += "</li></ul>";
let domain = dc_tools::EmailAddress::new( let domain = dc_tools::EmailAddress::new(
@@ -431,7 +434,10 @@ impl Context {
.unwrap_or_default(), .unwrap_or_default(),
)? )?
.domain; .domain;
ret += &format!("<h3>Storage on {}</h3><ul>", domain); ret += &format!(
"<h3>{}</h3><ul>",
stock_str::storage_on_domain(self, domain).await
);
let quota = self.quota.read().await; let quota = self.quota.read().await;
if let Some(quota) = &*quota { if let Some(quota) = &*quota {
match &quota.recent { match &quota.recent {
@@ -462,7 +468,8 @@ impl Context {
} }
Message => { Message => {
format!( format!(
"<b>Messages:</b> {} of {} used", "<b>{}:</b> {} of {} used",
stock_str::messages(self).await,
resource.usage.to_string(), resource.usage.to_string(),
resource.limit.to_string(), resource.limit.to_string(),
) )
@@ -507,7 +514,7 @@ impl Context {
self.schedule_quota_update().await?; self.schedule_quota_update().await?;
} }
} else { } else {
ret += "<li>One moment...</li>"; ret += &format!("<li>{}</li>", stock_str::one_moment(self).await);
self.schedule_quota_update().await?; self.schedule_quota_update().await?;
} }
ret += "</ul>"; ret += "</ul>";

View File

@@ -275,6 +275,42 @@ pub enum StockMessage {
#[strum(props(fallback = "Download maximum available until %1$s"))] #[strum(props(fallback = "Download maximum available until %1$s"))]
DownloadAvailability = 100, DownloadAvailability = 100,
#[strum(props(fallback = "Incoming Messages"))]
IncomingMessages = 103,
#[strum(props(fallback = "Outgoing Messages"))]
OutgoingMessages = 104,
#[strum(props(fallback = "Storage on %1$s"))]
StorageOnDomain = 105,
#[strum(props(fallback = "One moment…"))]
OneMoment = 106,
#[strum(props(fallback = "Connected"))]
Connected = 107,
#[strum(props(fallback = "Connecting…"))]
Connecting = 108,
#[strum(props(fallback = "Updating…"))]
Updating = 109,
#[strum(props(fallback = "Sending…"))]
Sending = 110,
#[strum(props(fallback = "Your last message was sent successfully."))]
LastMsgSentSuccessfully = 111,
#[strum(props(fallback = "Error: %1$s"))]
Error = 112,
#[strum(props(fallback = "Not supported by your provider."))]
NotSupportedByProvider = 113,
#[strum(props(fallback = "Messages"))]
Messages = 114,
} }
impl StockMessage { impl StockMessage {
@@ -882,6 +918,73 @@ pub(crate) async fn download_availability(context: &Context, timestamp: i64) ->
.replace1(dc_timestamp_to_str(timestamp)) .replace1(dc_timestamp_to_str(timestamp))
} }
/// Stock string: `Incoming Messages`.
pub(crate) async fn incoming_messages(context: &Context) -> String {
translated(context, StockMessage::IncomingMessages).await
}
/// Stock string: `Outgoing Messages`.
pub(crate) async fn outgoing_messages(context: &Context) -> String {
translated(context, StockMessage::OutgoingMessages).await
}
/// Stock string: `Storage on %1$s`.
/// `%1$s` will be replaced by the domain of the configured email-address.
pub(crate) async fn storage_on_domain(context: &Context, domain: impl AsRef<str>) -> String {
translated(context, StockMessage::StorageOnDomain)
.await
.replace1(domain)
}
/// Stock string: `One moment…`.
pub(crate) async fn one_moment(context: &Context) -> String {
translated(context, StockMessage::OneMoment).await
}
/// Stock string: `Connected`.
pub(crate) async fn connected(context: &Context) -> String {
translated(context, StockMessage::Connected).await
}
/// Stock string: `Connecting…`.
pub(crate) async fn connecting(context: &Context) -> String {
translated(context, StockMessage::Connecting).await
}
/// Stock string: `Updating…`.
pub(crate) async fn updating(context: &Context) -> String {
translated(context, StockMessage::Updating).await
}
/// Stock string: `Sending…`.
pub(crate) async fn sending(context: &Context) -> String {
translated(context, StockMessage::Sending).await
}
/// Stock string: `Your last message was sent successfully.`.
pub(crate) async fn last_msg_sent_successfully(context: &Context) -> String {
translated(context, StockMessage::LastMsgSentSuccessfully).await
}
/// Stock string: `Error: %1$s…`.
/// `%1$s` will be replaced by a possibly more detailed, typically english, error description.
pub(crate) async fn error(context: &Context, error: impl AsRef<str>) -> String {
translated(context, StockMessage::Error)
.await
.replace1(error)
}
/// Stock string: `Not supported by your provider.`.
pub(crate) async fn not_supported_by_provider(context: &Context) -> String {
translated(context, StockMessage::NotSupportedByProvider).await
}
/// Stock string: `Messages`.
/// Used as a subtitle in quota context; can be plural always.
pub(crate) async fn messages(context: &Context) -> String {
translated(context, StockMessage::Messages).await
}
impl Context { impl Context {
/// Set the stock string for the [StockMessage]. /// Set the stock string for the [StockMessage].
/// ///