Skip to content

Commit 706eae7

Browse files
Updated
1 parent 7ea0883 commit 706eae7

1 file changed

Lines changed: 21 additions & 20 deletions

File tree

Readme.md

Lines changed: 21 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,22 @@
11
<img src="./CompressedFileViewer/icons/gzip.png" style="float:left;" width=64 />
22

33
# CompressedFileViewer
4-
A Notepad++ plugin to open and save files in the gzip or bzip2 format.
5-
It's written in C# with Visual Studio for .Net 8.
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).
66
Don't change the encoding of a zipped file. Change the file to uncompressed, then change the encoding and toggle compression on again.
77

88
## Compression algorithms
9-
* GZip (.gz, .gzip)
10-
* Bzip2 (.bz2, .bzip2)
11-
* Zstd (.zstd)
12-
* XZ (.xz)
9+
* GZip (`.gz`, `.gzip`)
10+
* Bzip2 (`.bz2`, `.bzip2`)
11+
* Zstd (`.zstd`)
12+
* XZ (`.xz`)
13+
* Brotli (`.br`)
1314
## How to use
1415

1516
### Dll-Files
1617
Download the zip file depending on your architecture.
17-
Unpack the zip file copy all files into %NotepadDir%/plugins/CompressedFileViewer.
18-
Make sure .Net 8 is installed.
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.
1920

2021
### Terminus:
2122
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.
@@ -26,44 +27,44 @@ Make sure .Net 8 is installed.
2627

2728
### Settings
2829
This plugin has two settings.
29-
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)
30-
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+
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.
3132

3233
Selecting a algorithm and clicking on 'Settings' allows to manage the algorithm specific settings.
3334
1. 'Suffixes': The list of suffixes that schould automatically be decompressed. If a file is saved with such suffix it will also be compressed.
3435
2. Other algorithm specific settings
3536

3637
### Commands
3738
In the menubar there are 6 Commands:
38-
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.
39-
2. Compress: Compresses the current file text in the editor.
40-
3. Decompress: Decompresses the current text in the editor.
41-
4. Show Log: Opens the log window.
42-
5. Settings: Opens the settings dialog.
43-
6. About: Opens the about dialog.
44-
7. Credits: Opens the credits dialog.
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.
40+
2. `Compress`: Compresses the current file text in the editor.
41+
3. `Decompress`: Decompresses the current text in the editor.
42+
4. `Show Log`: Opens the log window.
43+
5. `Settings`: Opens the settings dialog.
44+
6. `About`: Opens the about dialog.
45+
7. `Credits`: Opens the credits dialog.
4546
9. '*Compression Algorithm*': Sets the compression for this specific file or removes it.
4647

4748
### (De)Compression-File-Rules
4849
On Open:
4950
1. gz-suffix: It will be decompressed if possible. It will be tracked regardless.
50-
2. no-gz-suffix: If 'Try decompress all' then the plugin tries to decompress it. <br/>If possible it will be tracked. <br/>If not or not 'Try decompress all' the file will be ignored.
51+
2. no-gz-suffix: If `Try decompress all` then the plugin tries to decompress it. <br/>If possible it will be tracked. <br/>If not or not 'Try decompress all' the file will be ignored.
5152

5253
Save (same path):
5354
1. Any tracked file will be compressed.
5455
2. Any excluded file won't be compressed.
5556
3. Any ignored file will be compressed if the suffix matches an algorithm suffix. (Won't happen since this files would be tracked)
5657

5758
Save (diffrent path):
58-
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.
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.
5960
1. from suffix type to other suffix type: This file will be compressed based on the new suffix.
6061
2. same suffix type:<br/>
6162
1. If tracked, save compressed..
6263
2. If excluded, save uncompressed.
6364
3. If neither go by suffix type.
6465

6566
Copy:
66-
1. Will always be stored as seen in the editor since npp won't raise a FileBeforeSave/FileSaved event.
67+
1. Will always be stored as seen in the editor since npp won't raise a `FileBeforeSave`/`FileSaved` event.
6768

6869
## Compiling yourself
6970

0 commit comments

Comments
 (0)