From 34bfca5b13f216aa525ae9b5ff267c3b1807e799 Mon Sep 17 00:00:00 2001
From: Himadri Sekhar Basu <hsb10@iitbbs.ac.in>
Date: Sun, 27 Oct 2024 00:24:18 +0530
Subject: [PATCH] Update version to 1.0.4

- Use mamolinux as primary repo
- Add LP PPA
- Update contents
- Use slideshow for screenshots
- Add build and runtime dependencies
- Update install instructions
- Add developer and translation instructions
---
 index.html | 188 ++++++++++++++++++++++++++++++++++++++---------------
 1 file changed, 135 insertions(+), 53 deletions(-)

diff --git a/index.html b/index.html
index 9d1461c..2150b50 100644
--- a/index.html
+++ b/index.html
@@ -23,7 +23,7 @@
       <!-- Begin Articles -->
       <div class="article-content" id="articles">
         <template type="markdown">
-# [LeapTime Manager](https://github.com/hsbasu/leaptime-manager)
+# [LeapTime Manager](https://github.com/mamolinux/leaptime-manager)
 
 # Work In Progress
 This App is currently under **development**. So, This is not what a regular user would expect. If you are a developer and would like to contribute, only then download of fork this repo.
@@ -62,9 +62,33 @@
 
 Aiming to be an all-in-one, friendly to new-users, GUI based backup manager for Debian/Ubuntu based systems. The main purpose of this application is to help user backup and restore every component on a Debian/Ubuntu based system ergonimically, elegantly and separately.
 
+## Contents
+- [ToDo List](#todo-list)
+- [Download Latest Version](#download-latest-version)
+	- [Stores/Ubuntu Private Archive](#storesubuntu-private-archive)
+	- [Github Releases](#github-releases)
+- [Features and Screenshots](#features-and-screenshots)
+- [Dependencies](#dependencies)
+	- [Build Dependencies](#build-dependencies)
+	- [Runtime Dependencies](#runtime-dependencies)
+	- [Debian/Ubuntu based systems](#debianubuntu-based-distro)
+	- [Other Linux-based systems](#other-linux-based-distro)
+- [Installation](#installation)
+	- [1. Download and install binary files](#1-download-and-install-binary-files)
+	- [2. Build and Install from source](#2-build-and-install-from-source)
+		- [Debian/Ubuntu based systems](#debianubuntu-based-systems)
+		- [Other Linux-based systems](#other-linux-based-systems)
+- [User Manual](#user-manual)
+- [Issue Tracking and Contributing](#issue-tracking-and-contributing)
+	- [For Developers](#for-developers)
+	- [Translation](#translation)
+- [Contributors](#contributors)
+	- [Authors](#author)
+
 ## ToDo List
 **Software:**
 1. [x] Apt backup
+	  1. [ ] Scheduled app backup
 2. [x] Apt restore
 
 **Data:**
@@ -81,11 +105,21 @@
 
 ## Download Latest Version
 
+### Stores/Ubuntu Private Archive
+Add the Launchpad PPA
+```$
+sudo add-apt-repository ppa:mamolinux/gui-apps
+sudo apt update
+sudo apt install leaptime-manager
+```
+
+### Github Releases
+Get the debian package archive from GitHub. For installation, check [here](#installation).
 <p class="badges">
-  <a class="buttn" href="https://github.com/hsbasu/leaptime-manager" target="_blank"><i class="fa-brands fa-github"></i> View On GitHub</a>
-  <a class="buttn" href="https://github.com/hsbasu/leaptime-manager/zipball/master"><i class="fa fa-file-zipper"></i> Download .zip</a>
-  <a class="buttn" href="https://github.com/hsbasu/leaptime-manager/tarball/master"><i class="fa fa-file-zipper"></i> Download .tar.gz</a>
-  <a class="buttn" href="https://github.com/hsbasu/leaptime-manager/releases/download/1.0.0/leaptime-manager_1.0.0_all.deb"><i class="fa-brands fa-debian"></i> Download Binary (.deb)</a>
+  <a class="buttn" href="https://github.com/mamolinux/leaptime-manager" target="_blank"><i class="fa-brands fa-github"></i> View On GitHub</a>
+  <a class="buttn" href="https://github.com/mamolinux/leaptime-manager/zipball/master"><i class="fa fa-file-zipper"></i> Download .zip</a>
+  <a class="buttn" href="https://github.com/mamolinux/leaptime-manager/tarball/master"><i class="fa fa-file-zipper"></i> Download .tar.gz</a>
+  <a class="buttn" href="https://github.com/mamolinux/leaptime-manager/releases/download/1.0.0/leaptime-manager_1.0.0_all.deb"><i class="fa-brands fa-debian"></i> Download Binary (.deb)</a>
 </p>
 
 ## Features and Screenshots
@@ -93,74 +127,107 @@
 2. Restore applications from backup lists
 
 ### Sample Screenshot
-<p class="badges">
-	<img src="https://hsbasu.github.io/leaptime-manager/screenshots/main-window-light.png" alt="Main Window (Light)">
-	<img src="https://hsbasu.github.io/leaptime-manager/screenshots/main-window-dark.png" alt="Main Window (Dark)">
-	<img src="https://hsbasu.github.io/leaptime-manager/screenshots/apt-backup-main-light.png" alt="App backup main page (Light)">
-	<img src="https://hsbasu.github.io/leaptime-manager/screenshots/apt-backup-main-dark.png" alt="App backup main page (Dark)">
-</p>
+<div class="slideshow-container w3-center">
+  <div class="Slides fade">
+    <img src="https://hsbasu.github.io/leaptime-manager/screenshots/main-window-light.png" alt="Main Window (Light)">
+  </div>
+  <div class="Slides fade">
+    <img src="https://hsbasu.github.io/leaptime-manager/screenshots/main-window-dark.png" alt="Main Window (Dark)">
+  </div>
+  <div class="Slides fade">
+    <img src="https://hsbasu.github.io/leaptime-manager/screenshots/apt-backup-main-light.png" alt="App backup main page (Light)">
+  </div>
+  <div class="Slides fade">
+    <img src="https://hsbasu.github.io/leaptime-manager/screenshots/apt-backup-main-dark.png" alt="App backup main page (Dark)">
+  </div>
+  <!-- Manual slideshow buttons -->
+  <a class="prev" onclick="plusSlides(-1)">&#10094;</a>
+  <a class="next" onclick="plusSlides(1)">&#10095;</a>
+</div>
 
-## Contents
-- [ToDo List](#todo-list)
-- [Download Latest Version](#download-latest-version)
-- [Features and Screenshots](#features-and-screenshots)
-- [Dependencies](#dependencies)
-  - [Debian/Ubuntu based systems](#debianubuntu-based-distro)
-  - [Other Linux-based systems](#other-linux-based-distro)
-- [Installation](#build-and-install-the-latest-version)
-  - [Debian/Ubuntu based systems](#debianubuntu-based-systems)
-  - [Other Linux-based systems](#other-linux-based-systems)
-  - [For Developers](#for-developers)
-- [User Manual](#user-manual)
-- [Issue Tracking and Contributing](#issue-tracking-and-contributing)
-- [Contributors](#contributors)
-
-# Dependencies
+## Dependencies
+### Build Dependencies
+The following dependencies are required to build **LeapTime Manager**.
+```$
+gettext
+desktop-file-utils
+libglib2.0-bin
+libgtk-4-bin
+meson
+python3
+python3-sphinx
+python3-sphinx-argparse
+```
+### Runtime Dependencies
+The following dependencies are required to run **LeapTime Manager**.
 ```
+gir1.2-xapp-1.0
+gir1.2-gtk-3.0
 python3
+python3-apt
+python3-aptdaemon.gtk3widgets
 python3-configobj
 python3-gi
 python3-setproctitle
 python3-tldextract
 ```
-To use or test LeapTime Manager, you need these dependencies to be installed.
 
 ### Debian/Ubuntu based distro
-To install dependencies on Debian/Ubuntu based systems, run:
+To install runtime dependencies on Debian/Ubuntu based systems, run:
 ```
-sudo apt install python3 python3-configobj python3-gi \
-python3-setproctitle python3-tldextract
+sudo apt install gir1.2-xapp-1.0 gir1.2-gtk-3.0 python3 python3-aptdaemon.gtk3widgets \
+python3-configobj python3-gi python3-setproctitle python3-tldextract
 ```
-**Note**: If you are using `gdebi` to install **LeapTime Manager** from a `.deb` file, it will automatically install the dependencies and you can skip this step.
+**Note**: If you are using `gdebi` to install **LeapTime Manager** from a downloaded/built `.deb` file, it will automatically install the dependencies and you can skip this step.
 
 ### Other Linux-based distro
 Replace `apt install` in the command given in [Debian/Ubuntu based distros](#debianubuntu-based-distro) and use the command for the package manager of the target system(eg. `yum install`, `dnf install`, `pacman -S` etc.)
 
 **Note**: There might be cases where one or more dependencies might not be available for your system. But that is highly unlikely. In such situations, please [create an issue](#issue-tracking-and-contributing).
 
-## Build and Install the Latest Version
-### Debian/Ubuntu based systems
+## Installation
+There are two ways, this app can be installed on a Debian/Ubuntu based system.
+
+### 1. Download and install binary files
+Download the latest binary .deb files from [here](https://github.com/mamolinux/leaptime-manager/releases/latest). Then install the GUI Frontend from terminal as
+```$
+sudo dpkg -i leaptime-manager*.deb
+sudo apt install -f
+```
+
+### 2. Build and Install From Source
+If you are having trouble installing the pre-built binary, build them from the source.
+
+#### Debian/Ubuntu based systems
 There are two methods, this app can be installed/used on a Debian/Ubuntu based system. First, download and unzip the source package using:
 ```
-wget https://github.com/hsbasu/leaptime-manager/archive/refs/heads/master.zip
+wget https://github.com/mamolinux/leaptime-manager/archive/refs/heads/master.zip
 unzip master.zip
 cd leaptime-manager-master
 ```
 
-1. **Option 1:** Manually copying necessary files to root (`/`). For that, follow the steps below:
-	1. [**Optional**] To make translations/locales in languages other than **English**, run:
+1. **Option 1:** Manually copying necessary files. For that, follow the steps below:
+	1. Install python package sources using `meson`:
 		```
-		make
+		rm -rf builddir
+		meson setup -Dprefix=$HOME/.local builddir
+		meson compile -C builddir --verbose
+		meson install -C builddir
 		```
-		from the `leaptime-manager-master` in a terminal. It will create the translations/locales in `usr/share/locale`.
-	
-	2. Copy the contents of `usr/` to `/usr/`:
+		It will install all files under `/home/<yourusername>/.local`. To **remove** the locally (`/home/<yourusername>/.local`) installed files, run:
+		```
+		ninja uninstall -C builddir
+		```
+	2. To manually install for all users:
 		```
-		sudo cp -R usr /
+		rm -rf builddir
+		meson setup builddir
+		meson compile -C builddir --verbose
+		sudo meson install -C builddir
 		```
-	3. Compile `schemas` using:
+		The last step requires **Administrative Privilege**. So, be careful before using this. To **remove** the installed files, run:
 		```
-		sudo glib-compile-schemas /usr/share/glib-2.0/schemas
+		sudo ninja uninstall -C builddir
 		```
 
 2. **Option 2:** Build a debian package and install it. To build a debian package on your own:
@@ -177,24 +244,39 @@
 		```
 After it is installed, run `leaptime-manager` from terminal or use the `leaptime-manager.desktop`.
 
-### Other Linux-based systems
+#### Other Linux-based systems
 1. Install the [dependencies](#other-linux-based-distro).
 2. From instructions for [Debian/Ubuntu based systems](#debianubuntu-based-systems), follow **Option 1**.
 
-
-### For Developers
-Instructions for devs are coming soon or create a [PR](https://github.com/hsbasu/leaptime-manager/compare).
-
-**I have no knowledge on how to use `meson` or `npm` for testing. If you can offer any help regarding this, please start a discussion [here](https://github.com/hsbasu/leaptime-manager/discussions) or create a [PR](https://github.com/hsbasu/leaptime-manager/compare). It will be more than welcome.**
-
 ## User Manual
 Coming Soon or create a PR.
 
 ## Issue Tracking and Contributing
 If you are interested to contribute and enrich the code, you are most welcome. You can do it by:
-1. If you find a bug, to open a new issue with details: [Click Here](https://github.com/hsbasu/leaptime-manager/issues)
+1. If you find a bug, to open a new issue with details: [Click Here](https://github.com/mamolinux/leaptime-manager/issues)
+2. If you know how to fix a bug or want to add new feature/documentation to the existing package, please create a [Pull Request](https://github.com/mamolinux/leaptime-manager/compare).
+
+### For Developers
+I am managing these apps all by myself during my free time. There are times when I can't contribute for months. So a little help is always welcome. If you want to test **LeapTime Manager**,
+1. Get the source package and unzip it using:
+	```
+	wget https://github.com/mamolinux/leaptime-manager/archive/refs/heads/master.zip
+	unzip master.zip
+	cd leaptime-manager-master
+	```
+2. Make desired modifications.
+3. Manually install using **Option 1** from [Debian/Ubuntu based systems](#debianubuntu-based-systems).
+4. Test it by running in debug mode from terminal:	
+	```
+	leaptime-manager --gui --verbose
+	```
 
-2. If you know how to fix a bug or want to add new feature/documentation to the existing package, please create a [Pull Request](https://github.com/hsbasu/leaptime-manager/compare).
+### Translation
+All translations are done using using [Launchpad Translations](https://translations.launchpad.net/mamolinux). To help translate **LeapTime Manager** in your favourite language follow these steps:
+1. Go to [translations page](https://translations.launchpad.net/mamolinux/trunk/+pots/leaptime-manager) on Launchpad.
+2. Click on the language, you want to translate.
+3. Translate strings.
+4. Finally, click on **Save & Continue**.
 
 ## Contributors