From bb0c49805698e9f76d55ba1a5f2d6bfbd9357b77 Mon Sep 17 00:00:00 2001 From: "Romain F. T" Date: Thu, 7 May 2020 19:21:39 +0200 Subject: [PATCH] Update the user help manual --- README.md | 10 ++--- ...hanz.DynamicWallpaperEditor.appdata.xml.in | 2 +- help/C/add_and_order.page | 10 ++--- help/C/apply.page | 34 ----------------- help/C/durations.page | 3 +- help/C/index.page | 38 +++++++++++++++---- help/C/legal.xml | 1 + help/C/open_and_save.page | 38 ------------------- help/meson.build | 2 - src/main.py | 4 +- 10 files changed, 45 insertions(+), 97 deletions(-) delete mode 100644 help/C/apply.page delete mode 100644 help/C/open_and_save.page diff --git a/README.md b/README.md index 44223a6..5f54401 100644 --- a/README.md +++ b/README.md @@ -23,10 +23,10 @@ or their durations, and save the modifications. The list of pictures can conveniently be displayed as a list or as a grid. -### Set an XML file as a wallpaper +### Set an XML file as your wallpaper -An existing XML file (opened, or just created) can be set as your wallpaper (or -as your lock screen) from the app. +You can set an XML file (that you opened or newly created) as your wallpaper +from the app. Adjustment options are available (mosaic, zoom, centered, etc.) @@ -44,10 +44,6 @@ You can install it from flathub.org using the instructions on [this page](https: [![Packaging status](https://repology.org/badge/vertical-allrepos/dynamic-wallpaper-editor.svg)](https://repology.org/project/dynamic-wallpaper-editor/versions) -- [Fedora (official repo)](https://apps.fedoraproject.org/packages/dynamic-wallpaper-editor) (29, 30 and Rawhide): `sudo dnf install dynamic-wallpaper-editor` -- [openSUSE (OBS)](https://software.opensuse.org//download.html?project=home%3ADead_Mozay&package=dynamic-wallpaper-editor) -- Arch and Manjaro ([AUR](https://aur.archlinux.org/packages/dynamic-wallpaper-editor)) - ---- ![screenshot (grid view)](https://raw.githubusercontent.com/maoschanz/dynamic-wallpaper-editor/master/help/C/figures/screenshot_grid_popover.png) diff --git a/data/com.github.maoschanz.DynamicWallpaperEditor.appdata.xml.in b/data/com.github.maoschanz.DynamicWallpaperEditor.appdata.xml.in index 9d43630..79aae9e 100644 --- a/data/com.github.maoschanz.DynamicWallpaperEditor.appdata.xml.in +++ b/data/com.github.maoschanz.DynamicWallpaperEditor.appdata.xml.in @@ -36,7 +36,7 @@ - +

The images can now be easily sorted according to their filename. diff --git a/help/C/add_and_order.page b/help/C/add_and_order.page index f4ff7bc..ce9bcf7 100644 --- a/help/C/add_and_order.page +++ b/help/C/add_and_order.page @@ -41,16 +41,15 @@

With both layouts, pictures can be reordered using drag-and-drop.

+

Using a button in the toolbar, you can sort the pictures by their + filename.

Replace pictures

If one of your file has been moved or renamed, you can replace a picture - using its Replace with… menu item.

-

If a lot of picture changed, for example if you renamed their folder, you - can use the Find and replace feature: search for - the part of the filename you want to replace, type what you want as a - replacement, and apply.

+ using its Replace with… menu item, available in + the menu at the right of each picture.

@@ -62,3 +61,4 @@
+ diff --git a/help/C/apply.page b/help/C/apply.page deleted file mode 100644 index c712df1..0000000 --- a/help/C/apply.page +++ /dev/null @@ -1,34 +0,0 @@ - - - - - - - - Romain F. T. - rrroschan@gmail.com - - Set your file as wallpaper or as lock screen - - - Apply the wallpaper - -
- Apply as wallpaper -

Once your XML file is saved, you can - then apply it as your wallpaper with the Apply - menu.

-

Adjustment options (zoom, centered, stretched, etc.) are available.

-
- -
- Apply as wallpaper -

Once your XML file is saved, you can then apply it as your lockscreen - with the Apply menu.

-

Adjustment options (zoom, centered, stretched, etc.) are available.

-

This feature is only available if you use GDM3 as your display manager.

-
- - diff --git a/help/C/durations.page b/help/C/durations.page index 6fe7ac0..52ea06e 100644 --- a/help/C/durations.page +++ b/help/C/durations.page @@ -26,7 +26,7 @@

Fit the daylight (each picture has its own duration, and the total duration is 24 hours)

 -

When you open an existing XML file, the +

When you open an existing XML file, the existing type is detected.

@@ -52,3 +52,4 @@ + diff --git a/help/C/index.page b/help/C/index.page index e1bc2bf..18921fd 100644 --- a/help/C/index.page +++ b/help/C/index.page @@ -6,7 +6,7 @@ Dynamic Wallpaper Editor Romain F. T. - 2018-2019 + 2018-2020 @@ -19,15 +19,39 @@

GNOME Shell natively allows the wallpaper to change automatically over time, so your wallpaper can be for example a slideshow of your favorite pictures, or an image adapting to the daylight.

-

Dynamic wallpapers are saved as XML files, and this utility helps you - creating, editing, and applying them.

-
- Managing pictures +
+ XML dynamic wallpapers +

Dynamic wallpapers are saved as XML files, and this utility helps you + creating, editing, saving, and applying them.

+ + + Open an existing file +

With the Open button, you can open previously + saved dynamic wallpaper files (.xml), and edit + them.

+

From your file manager, you can also right-click on a dynamic wallpaper + XML file, click Open with an other application, + and select "Dynamic Wallpaper Editor".

+ + + + Save +

Save your creation as an XML file with the Save + button, or the Save as… menu item.

+ + + + Apply as your wallpaper +

Once your XML file is saved, you can then apply it as your wallpaper + with the Apply menu.

+

Adjustment options (zoom, centered, stretched, etc.) are available.

+
-
- Wallpapers +
+ Managing the pictures
+ diff --git a/help/C/legal.xml b/help/C/legal.xml index aa36246..efacd5e 100644 --- a/help/C/legal.xml +++ b/help/C/legal.xml @@ -6,3 +6,4 @@ Attribution-ShareAlike 3.0 Unported License.

+ diff --git a/help/C/open_and_save.page b/help/C/open_and_save.page deleted file mode 100644 index 01fe712..0000000 --- a/help/C/open_and_save.page +++ /dev/null @@ -1,38 +0,0 @@ - - - - - - - - Romain F. T. - rrroschan@gmail.com - - Opening and saving your dynamic wallpapers - - - Opening and saving files - -

Dynamic wallpapers are saved as XML files.

- -
- Open an existing file -

With the Open button, you can open previously - saved dynamic wallpaper files (.xml), and edit - them.

-

From your file manager, you can also right-click on a dynamic wallpaper - XML file, click Open with an other application, - and select "Dynamic Wallpaper Editor".

-
- -
- Save and apply as wallpaper -

Save your creation as an XML file with the Save - button, or the Save as… menu item.

-

You can then apply it as your wallpaper or - as your lockscreen.

-
- - diff --git a/help/meson.build b/help/meson.build index e1c7c00..d05fb5a 100644 --- a/help/meson.build +++ b/help/meson.build @@ -4,8 +4,6 @@ gnome.yelp(meson.project_name(), 'index.page', 'add_and_order.page', 'durations.page', - 'open_and_save.page', - 'apply.page', 'legal.xml' ], media: [ diff --git a/src/main.py b/src/main.py index 6b7e1f4..11025aa 100644 --- a/src/main.py +++ b/src/main.py @@ -106,10 +106,10 @@ def get_valid_file(self, app, path): return f else: return None - except: # FIXME pas ouf + except: err = _("Error opening this file. Did you mean %s ?") command = "\n\tflatpak run --file-forwarding {0} @@ {1} @@\n" - command = command.format(APP_ID, path) + command = command.format(APP_ID, path) # FIXME pas ouf ^ print(err % command) return None