Lubuntu
/
installer-prompt
10
0
Fork 2
Code Issues Pull Requests 2 Projects Releases Wiki Activity
Try or Install Lubuntu
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
75 Commits
1 Branch
11 Tags
9.2 MiB
 
 
 
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
Go to file
Walter Lapchynski de09a2a3e5
Limited desktops to 1 and removed switcher from panel 		2 weeks ago
debian Limited desktops to 1 and removed switcher from panel 2 weeks ago
img UI overhaul, switch to native packaging, fix network-related bugs 2 months ago
scripts Limited desktops to 1 and removed switcher from panel 2 weeks ago
src no, I'd really like the prompt to ALWAYS load please :) 1 month ago
.gitignore Initial commit. 2 years ago
CMakeLists.txt Limited desktops to 1 and removed switcher from panel 2 weeks ago
LICENSE Initial mockup. Very very ugly. Needs tons of cleanup. 2 years ago
README.md Near-total rewrite to enhance UI/UX 2 months ago
gen_ts.sh Completely re-work translations, to support all languages LXQt typically does. 4 months ago
lubuntu-live-environment.desktop Touch up the live session scripts, so it's actually started with our theming. 4 months ago
panel.conf Limited desktops to 1 and removed switcher from panel 2 weeks ago
rc.xml Limited desktops to 1 and removed switcher from panel 2 weeks ago

README.md

Lubuntu Installer Prompt

This project is in beta. It presents a "Try or Install Lubuntu" screen. Eventually we want to extend this to support multiple flavors.

Art assets are copyrighted as follows:

  • img/arrow-down.svg: Copyright (C) 2014 Uri Herrera uri_herrera@nitrux.in and others. LGPL-3+ license. Taken from the Breeze icon theme.
  • img/background.png: Copyright (C) 2024 Aaron Rainbolt arraybolt3@ubuntu.com and MediaMom Ministries. CC-BY-SA-4.0 license.
  • img/lubuntu-logo.png, img/installer.png, img/emblem.png: Copyright (C) 2024 Lubuntu Developers lubuntu-devel@lists.ubuntu.com. Unknown license. Adapted from the official Lubuntu artwork.

All other files are licensed under the GNU General Public License version 3. Copyright (C) 2022-2024 Lubuntu Developers lubuntu-devel@lists.ubuntu.com.

Architecture

This section serves to explain how lubuntu-installer-prompt's various components work together to provide the Lubuntu ISO boot experience.

  1. SDDM loads.
  2. /etc/sddm.conf is read. This file has been generated (or modified?) by Casper to point to a lubuntu-live-environment.desktop X session.
  3. lubuntu-live-environment.desktop executes /bin/start-lubuntu-live-env.
  4. start-lubuntu-live-env starts Openbox and backgrounds it.
  5. start-lubuntu-live-env starts /bin/lubuntu-installer-prompt but does not background it.
  6. The installer prompt appears.
  7. The user clicks "Install Lubuntu" or "Try Lubuntu".
  8. If "Install Lubuntu" is clicked, the installer prompt executes sudo -E calamares -D8. The installer prompt then deactivates the buttons.
  9. The installer window appears on the user's screen.
  10. If Calamares closes, the installer prompt detects this and exits.
  11. When the installer prompt exits, start-lubuntu-live-env kills Openbox and runs startlxqt.
  12. If "Try Lubuntu" is clicked, steps 10 and 11 are executed immediately.

Translations

Run the gen_ts.sh script after making any code modifications to ensure that the translations files are up-to-date for translators to work on.

To add a new language to be translated:

  • Open the gen_ts.sh script and add the locale code for the new language to the langList array.
  • Run the script after doing this - a new template .ts file will be generated under src/translations/.
  • Next, add the new template file to the TS_FILES list in CMakeLists.txt - it will be named src/translations/lubuntu-installer-prompt_locale_CODE.ts, where locale_CODE is the locale code of the added language.
  • Finally, add a line in the src/translations.qrc resource file to include the new translation file. The line should look like <file alias="locale_CODE">lubuntu-installer-prompt_locale_CODE.qm</file>, where locale_CODE is the locale code of the added language. This line should go inside the <qresource> tag.

For instance, if I were to add Chinese to the list of languages that could be translated into, I would do this:

vim gen_ts.sh
# add this code to the langList array:
#    'zh_CN'
./gen_ts.sh
vim CMakeLists.txt
# add this line to the TS_FILES list:
#    src/translations/lubuntu-installer-prompt_zh_CN.ts
vim src/translations.qrc
# add this line to the list of file resources:
#    <file alias="zh_CN">lubuntu-installer-prompt_zh_CN.qm</file>

The program will now pick up the added language at build time. Any translations added to the newly created .ts file will be shown to program users who select the new language.