Skip to content

Commit b3789d5

Browse files
Update
1 parent 113f5f0 commit b3789d5

1 file changed

Lines changed: 26 additions & 22 deletions

File tree

Readme.md

Lines changed: 26 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# CompressedFileViewer
44
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.
66
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.
77

88
## Compression algorithms
@@ -11,39 +11,43 @@ Don't change the encoding (`UTF-8`, `ANSI`, etc.) of a compressed file. Change t
1111
* Zstd (`.zstd`)
1212
* XZ (`.xz`)
1313
* Brotli (`.br`)
14+
1415
## How to use
1516

1617
### Dll-Files
1718
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.
2021

2122
### 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.
2526
4. gz: Any file with a suffix matching one in the settings.
2627
5. non-gz: Any other file
2728

2829
### 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.
3236

33-
Selecting a algorithm and clicking on 'Settings' allows to manage the algorithm specific 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 algorithm specific 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
3640

3741
### 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 algorithm specific 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.
4044
2. `Compress`: Compresses the current file text in the editor.
4145
3. `Decompress`: Decompresses the current text in the editor.
4246
4. `Show Log`: Opens the log window.
4347
5. `Settings`: Opens the settings dialog.
4448
6. `About`: Opens the about dialog.
4549
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.
4751

4852
### (De)Compression-File-Rules
4953
On Open:
@@ -53,15 +57,15 @@ On Open:
5357
Save (same path):
5458
1. Any tracked file will be compressed.
5559
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)
5761

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.
6064
1. from suffix type to other suffix type: This file will be compressed based on the new suffix.
6165
2. same suffix type:<br/>
62-
1. If tracked, save compressed..
66+
1. If tracked, save compressed.
6367
2. If excluded, save uncompressed.
64-
3. If neither go by suffix type.
68+
3. If neither, go by suffix type.
6569

6670
Copy:
6771
1. Will always be stored as seen in the editor since npp won't raise a `FileBeforeSave`/`FileSaved` event.
@@ -70,9 +74,9 @@ Copy:
7074

7175
To compile this plugin with Visual Studio, you need .Net 8 (6 or 7 might also work).
7276
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.
7478

75-
### Implementing Addtional Algorithms
79+
### Implementing Additional Algorithms
7680
* Implementing CompressionSettings
7781
* Preferences:
7882
* Incrementing Version

0 commit comments

Comments
 (0)