You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Readme.md
+26-22Lines changed: 26 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
# CompressedFileViewer
4
4
A Notepad++ plugin to open and save compressed files.
5
-
It's written in `C#` with Visual Studio for [.Net 8](https://dotnet.microsoft.com/en-us/download/dotnet/8.0).
5
+
It's written in `C#` with Visual Studio for .Net 8.
6
6
Don't change the encoding (`UTF-8`, `ANSI`, etc.) of a compressed file. Change the file to uncompressed, then change the encoding and toggle compression on again.
7
7
8
8
## Compression algorithms
@@ -11,39 +11,43 @@ Don't change the encoding (`UTF-8`, `ANSI`, etc.) of a compressed file. Change t
11
11
* Zstd (`.zstd`)
12
12
* XZ (`.xz`)
13
13
* Brotli (`.br`)
14
+
14
15
## How to use
15
16
16
17
### Dll-Files
17
18
Download the zip file depending on your architecture.
18
-
Unpack the zip file copy all files into `%NotepadDir%/plugins/CompressedFileViewer`.
19
-
Make sure [.Net 8](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) is installed.
19
+
Unpack the zip file and copy all files into `%NotepadDir%/plugins/CompressedFileViewer`.
20
+
Make sure .Net 8 is installed.
20
21
21
22
### Terminus:
22
-
1.tracked file: A tracked file is a file that was decompressed or is selected manually for compression. The Icon and Menu Entry will be checked for this file.
23
-
2.excluded file: A file for which the compression was manually disabled.
24
-
3.ignored file: neither tracked for compression nor excluded.
23
+
1.Tracked file: A file that has been decompressed or manually selected for compression. The icon and menu entry will be checked for this file.
24
+
2.Excluded file: A file for which compression has been manually disabled.
25
+
3.Ignored file: A file that is neither tracked for compression nor excluded.
25
26
4. gz: Any file with a suffix matching one in the settings.
26
27
5. non-gz: Any other file
27
28
28
29
### Settings
29
-
This plugin has two settings.
30
-
1.`Try to decompress all files`: If set the plugin will try to decompress all files regardless of the extension. All decompressed files will be tracked and if saved automatically compressed. (If the path is still the same)
31
-
2.`Compression algorithms`: The ordered list of the compression algorithms. This does not affect file detection or 'decompress all'. It only affects the behaviour of the icon or 'Toogle Compression'. When clicking on the icon based on the suffix the appropriate compression will be chosen. Afterwards you can iterate through all algorithms in the list by clicking again.
30
+
This plugin has two basic settings.
31
+
1.`Try to decompress all files`: If set, the plugin will try to decompress all files regardless of the extension. All decompressed files will be tracked and - if saved - automatically compressed. (If the path is still the same)
32
+
Only active algorithms will be used.
33
+
2.`Compression algorithms`: The ordered list of the compression algorithms. This does not affect file detection or 'decompress all'. It only affects the behaviour of the icon or 'Toggle Compression'. When clicking on the icon based on the suffix, the appropriate compression will be chosen. Afterwards, you can iterate through all algorithms in the list by clicking again.
34
+
* Is enabled: If unchecked, the algorithm will be disabled. No files will be compressed or uncompressed using this algorithm. To update the toolbar you need to restart npp.
35
+
* Is active: If an algorithm is not active, it will not be used with the setting `Try decompress all files`. Additionally, using the toolbar icon will only switch to this algorithm if it has the correct suffix. Files with the correct suffix will still automatically be (de)compressed when opened/saved.
32
36
33
-
Selecting a algorithm and clicking on 'Settings' allows to manage the algorithmspecific settings.
34
-
1. 'Suffixes': The list of suffixes that schould automatically be decompressed. If a file is saved with such suffix it will also be compressed.
35
-
2. Other algorithmspecific settings
37
+
Selecting an algorithm and clicking on 'Settings' allows you to manage the algorithm-specific settings.
38
+
1. 'Suffixes': The list of suffixes that should automatically be decompressed. If a file is saved with such a suffix, it will also be compressed.
39
+
2. Other algorithm-specific settings
36
40
37
41
### Commands
38
-
In the menubar there are 6 Commands:
39
-
1.`Toggle Compression` (same as clicking on the icon): Changes the compression algorithm used when storing this file. You can iteratre through different algorithms again. The order is dertemined by the order in the settings. If the file has a algorithmspecific suffix it will select this algorithm first. By click again after the last algorithm was selected, the file compression will be disable for this file.
42
+
In the menubar, there are 8+ Commands:
43
+
1.`Toggle Compression` (same as clicking on the icon): Changes the compression algorithm used when storing this file. You can iterate through different algorithms again. The order is determined by the order in the settings. If the file has an algorithm-specific suffix, it will select this algorithm first. By clicking again after the last algorithm was selected, the file compression will be disabled for this file.
40
44
2.`Compress`: Compresses the current file text in the editor.
41
45
3.`Decompress`: Decompresses the current text in the editor.
42
46
4.`Show Log`: Opens the log window.
43
47
5.`Settings`: Opens the settings dialog.
44
48
6.`About`: Opens the about dialog.
45
49
7.`Credits`: Opens the credits dialog.
46
-
9. '*Compression Algorithm*': Sets the compression for this specific file or removes it.
50
+
8. '*Compression Algorithm*': Sets the compression for this specific file or removes it.
47
51
48
52
### (De)Compression-File-Rules
49
53
On Open:
@@ -53,15 +57,15 @@ On Open:
53
57
Save (same path):
54
58
1. Any tracked file will be compressed.
55
59
2. Any excluded file won't be compressed.
56
-
3. Any ignored file will be compressed if the suffix matches an algorithm suffix. (Won't happen since this files would be tracked)
60
+
3. Any ignored file will be compressed if the suffix matches an algorithm suffix. (Won't happen since these files would be tracked)
57
61
58
-
Save (diffrent path):
59
-
Npp will tell the plugin the old path when notifing`FileBeforeSaved`. If based on the suffix the compression toggles it might be saved two times.
62
+
Save (different path):
63
+
Npp will tell the plugin the old path when notifying`FileBeforeSaved`. If based on the suffix the compression toggles it might be saved two times.
60
64
1. from suffix type to other suffix type: This file will be compressed based on the new suffix.
61
65
2. same suffix type:<br/>
62
-
1. If tracked, save compressed..
66
+
1. If tracked, save compressed.
63
67
2. If excluded, save uncompressed.
64
-
3. If neither go by suffix type.
68
+
3. If neither, go by suffix type.
65
69
66
70
Copy:
67
71
1. Will always be stored as seen in the editor since npp won't raise a `FileBeforeSave`/`FileSaved` event.
@@ -70,9 +74,9 @@ Copy:
70
74
71
75
To compile this plugin with Visual Studio, you need .Net 8 (6 or 7 might also work).
72
76
See DNNE (https://github.com/AaronRobinsonMSFT/DNNE) for additional requirements.
73
-
Change `NppDir32/64` to the correct Npp-Folders and make soure you have write access to the plugin dir.
77
+
Change `NppDir32/64` to the correct Npp-Folders and make sure you have write access to the plugin dir.
0 commit comments