#kde #localization #ki18n

yanked ki18n-rs

A crate to use KF5I18n from rust

1.0.3 Dec 14, 2021
1.0.2 Nov 13, 2021
0.1.3 Dec 1, 2021
0.1.2 Nov 13, 2021

#14 in #kde

MIT license

13KB
128 lines

KI18n Crate for Rust

Crates.io Documentation

KI18n is a cross-platform internationalization framework used by KDE applications. This crate is meant to allow using KI18n with Rust and qmetaobject-rs crate.

Requirements

This crate requires KF5I18n to be installed or at least present in the system.

Ubuntu

sudo apt install libkf5i18n-dev

Arch Linux

sudo pacman -S ki18n

Custom Location for KF5I18n

The crate searches from KF5I18n using either the environment variables (KF5_I18n_INCLUDE_PATH and KF5_I18n_LIBRARY_PATH) if they are set or just searches at /usr/include /usr/library

Example

use cstr::cstr;
use qmetaobject::prelude::*;
use ki18n_rs::KLocalizedContext;

fn main() {
  let mut engine = QmlEngine::new();
  KLocalizedContext::init_from_engine(&engine);
  engine.load_data(r#"
    import QtQuick 2.6
    import QtQuick.Controls 2.0 as Controls
    import QtQuick.Layouts 1.2
    import org.kde.kirigami 2.13 as Kirigami
    
    // Base element, provides basic features needed for all kirigami applications
    Kirigami.ApplicationWindow {
        // ID provides unique identifier to reference this element
        id: root
    
        // Window title
        // i18nc is useful for adding context for translators, also lets strings be changed for different languages
        title: i18nc("@title:window", "Hello World")
    
        // Initial page to be loaded on app load
        pageStack.initialPage: Kirigami.Page {
    
            Controls.Label {
                // Center label horizontally and vertically within parent element
                anchors.centerIn: parent
                text: i18n("Hello World!")
            }
        }
    }
  "#.into());
  engine.exec();
}

Dependencies

~1.3–2.6MB
~49K SLoC