Warning, /plasma/plasma-welcome/README.md is written in an unsupported language. File is not indexed.

 <!--
     SPDX-License-Identifier: CC0-1.0
     SPDX-FileCopyrightText: 2022-Nate Graham <nate@kde.org>
 -->
 
 # Plasma Welcome App
 Friendly onboarding wizard for Plasma
 
 Welcome Center is the perfect introduction to KDE Plasma! It can help you learn how to connect to the internet, install apps, customize the system, and more!
 
 There are four mutually exclusive usage modes:
 - Run the app normally and it will show a welcome/onboarding wizard.
 - Run the app with the `--post-update` argument to show a post-update message.
 - Run the app with the `--post-update-beta` argument to show a post-update message for beta releases.
 - Run the app with the `--live-environment` argument to show a reduced wizard with the live installer page and no settings pages.
 
 ## Screenshots
 | Welcome to KDE Plasma! | Managing Software | Getting Involved |
 | ---                    | ---               | ---              |
 | ![Welcome to KDE Plasma!](https://cdn.kde.org/screenshots/plasma-welcome/plasma-welcome-page-1.png) | ![Managing Software](https://cdn.kde.org/screenshots/plasma-welcome/plasma-welcome-page-2.png) | ![Getting Involved](https://cdn.kde.org/screenshots/plasma-welcome/plasma-welcome-page-6.png) |
 
 # For live distributions
 When Welcome Center is ran in a live environment, it can show a reduced wizard with a page welcoming the user to the disibution and without any settings pages.
 
 To ensure that Welcome Center's launcher recognises the live environment, you will need to create/change the config in your live user's `~/.config/plasma-welcomerc`:
 
 ```conf
 [General]
 LiveEnvironment=true
 LiveInstaller=calamares
 ```
 
 `LiveInstaller` is optional, used to show a shortcut to launch the installer. It should be the name of a desktop file in `/usr/share/applications`, without the `.desktop` extension.
 
 # Customizing the first page
 By default, the first page introduces the distro and mostly talks about Plasma and KDE. If desired, this can be changed by placing a specially crafted desktop file at `/usr/share/plasma/plasma-welcome/intro-customization.desktop`. In this file, you can supply custom intro text, which will be displayed first, before the standard text talking about Plasma and KDE. It is recommended to keep this text short.
 
 In addition, you can optionally specify a custom icon or image to replace the Konqi image, a custom caption for it, and a custom URL to open when clicking on it. Text can be localized in the standard way that text in desktop files is localized. Note that you are expected to do this yourself!
 
 ## Example intro text customization file
 ```
 [Desktop Entry]
 # Required since this is a Desktop file; ignored
 Type=Application
 
 # Required; becomes the first paragraph on the Welcome page
 # Don't forget to offer translations of the text!
 Name=Welcome to NateOS! It's the best OS ever, until it explodes. Did you know that's a feature? It's right there on the box!
 Name[fr]=Bienvenue sur NateOS! C'est le meilleur système d'exploitation du monde, justqu'à qu'il esplose. Saviez-vous que c'est intentionnel? C'est écrit sur la boîte!
 
 # Optional; replaces the default image on the Welcome page
 # can be an icon name or an absolute path to an image on disk beginning with file:/
 Icon=edit-bomb
 
 # Optional; replaces the default image caption on the Welcome page
 # Don't forget to offer translations of the text!
 Comment=This is what a bomb looks like. Don't worry, you'll become very familiar with them!
 Comment[fr]=Voici à quoi ressemble une bombe. Ne vous inquiétez pas, vous allez vous familiariser avec elles!
 
 # Optional; replaces the default URL opened when clicking on the Welcome page's image or icon
 URL=https://www.youtube.com/watch?v=dQw4w9WgXcQ
 ```
 
 Translations can be tested by manually running Welcome Center in a different language, e.g. `LANG=fr_FR plasma-welcome`.
 
 # Extending Welcome Center with custom pages
 Custom distro-specific pages can be embedded in the app, and will appear right before the "Get Involved" page. Only content that is safely skippable should be added, since the user can close the app at any time, potentially before they see your custom pages.
 
 To make custom pages visible to the app, place them in `/usr/share/plasma/plasma-welcome/extra-pages/`, prefixed with a number and a dash. For example if you define two pages with the following names:
 
 - `01-WelcomeToDistro.qml`
 - `02-InstallMediaCodecs.qml`
 
 These two pages will be added into the wizard, with WelcomeToDistro shown first, and then InstallMediaCodecs.
 
 Custom pages are QML files with a root item that inherit from `Kirigami.Page`. Any content within the page is supported, though to maintain visual consistency with existing pages, it is recommended to use `GenericPage` or `KCM` as the root item and set the `heading` and `description` properties, with any custom content going beneath them. It is recommended to reference [existing pages](src/contents/ui/pages) when creating your own.
 
 Because pages are written in QML without support for C++ support code, only functions that can be performed entirely with QML are available. Here are some examples:
 
 ## Open a URL in the default web browser
 ```
 Kirigami.Icon {
     source: "media-default-track"
     HoverHandler {
         cursorShape: Qt.PointingHandCursor
     }
     TapHandler {
         onTapped: Qt.openUrlExternally("https://www.youtube.com/watch?v=dQw4w9WgXcQ")
     }
 }
 ```
 
 ## Open an external app
 ```
 ApplicationIcon {
     anchors.centerIn: parent
     application: "org.kde.dolphin"
     size: Kirigami.Units.gridUnit * 10
 }
 ```
 
 ## Run a terminal command
 ```
 Kirigami.Icon {
     source: "notification"
     HoverHandler {
         cursorShape: Qt.PointingHandCursor
     }
     TapHandler {
         onTapped: Controller.runCommand("notify-send foo bar")
     }
 }
 ```
 
 ## Embed a KCM in the page
 ```
 KCM {
     heading: i18nc("@title: window", "Learn about Activities")
     description: i18nc("@info:usagetip", "Activities can be used to separate high-level projects or tasks so you can focus on one at a time. You can set them up in System Settings, and also right here.")
 
     path: "kcm_activities"
 }
 ```
 
 If you find that your specific use case can't be supported with these tools, please file a bug report at https://bugs.kde.org/enter_bug.cgi?product=Welcome%20Center detailing the use case and what would be needed to support it.
 
 ## Example custom page
 Name this file `01-NateOS.qml` and place it in `/usr/share/plasma/plasma-welcome/extra-pages/`:
 
 ```
 /*
  *  SPDX-FileCopyrightText: 2021 Felipe Kinoshita <kinofhek@gmail.com>
  *  SPDX-FileCopyrightText: 2022 Nate Graham <nate@kde.org>
  *
  *  SPDX-License-Identifier: GPL-2.0-only OR GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL
  */
 
 import QtQuick
 import QtQuick.Controls as QQC2
 import QtQuick.Layouts
 import org.kde.kirigami as Kirigami
 import Qt5Compat.GraphicalEffects
 
 import org.kde.plasma.welcome
 
 GenericPage {
     heading: i18nc("@info:window", "Welcome to NateOS")
     description: i18nc("@info:usagetip", "It's the best distro in the world… <i>until it explodes</i>.")
 
     topContent: [
         Kirigami.UrlButton {
             Layout.topMargin: Kirigami.Units.largeSpacing
             text: i18nc("@action:button", "All your base are belong to us")
             url: "https://en.wikipedia.org/wiki/All_your_base_are_belong_to_us"
         }
     ]
 
     ColumnLayout {
         anchors.centerIn: parent
         spacing: 0
 
         Kirigami.Icon {
             id: image
             Layout.preferredWidth: Kirigami.Units.gridUnit * 10
             Layout.preferredHeight: Layout.preferredWidth
 
             source: "granatier"
 
             HoverHandler {
                 id: hoverHandler
                 cursorShape: Qt.PointingHandCursor
             }
 
             TapHandler {
                 onTapped: showPassiveNotification(i18n("You have no chance to survive make your time"));
             }
 
             QQC2.ToolTip {
                 visible: hoverHandler.hovered
                 text: i18nc("@action:button", "Detonate the bomb")
             }
 
             layer.enabled: true
             layer.effect: DropShadow {
                 transparentBorder: true
                 horizontalOffset: 0
                 verticalOffset: 1
                 radius: 20
                 samples: 20
                 color: Qt.rgba(0, 0, 0, 0.2)
             }
         }
 
         Kirigami.Heading {
             Layout.alignment: Qt.AlignHCenter
             Layout.bottomMargin: Kirigami.Units.gridUnit
             text: i18nc("@title a friendly warning", "Someone set us up the bomb")
             wrapMode: Text.WordWrap
             level: 3
         }
     }
 }
 ```