markdown lint, content edit, add TOC (#81)

* markdown lint, content edit, add TOC

* fix typo
pull/83/head
Bryan Nehl 2 years ago committed by GitHub
parent 7ef81e72e8
commit d421a00539
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -1,4 +1,5 @@
# FLEcli # FLEcli
Multi-platform "Fast Log Entry"(FLE) processing tool. Multi-platform "Fast Log Entry"(FLE) processing tool.
![Go Build & Test](https://github.com/jmMeessen/FLEcli/workflows/Go%20Build%20&%20Test/badge.svg) ![Go Build & Test](https://github.com/jmMeessen/FLEcli/workflows/Go%20Build%20&%20Test/badge.svg)
@ -8,7 +9,7 @@ Multi-platform "Fast Log Entry"(FLE) processing tool.
The original FLE format was extented with release V1.4 to support POTA log files. The original FLE format was extented with release V1.4 to support POTA log files.
This tool is intended to process FLE formatted files on other platform than Windows. The FLE input file format is described on https://www.df3cb.com/fle/documentation/ This tool is intended to process FLE formatted files on other platform than Windows. The FLE input file format is described on <https://www.df3cb.com/fle/documentation/>
------ ------
@ -18,29 +19,29 @@ If you like what I did and want to keep me going, you can "buy me a coffee" via
------ ------
## Installing ## Installing
The tool is installed by downloading and unpacking the archive for your operating system. The tool is installed by downloading and unpacking the archive for your operating system.
A version is available for Windows, MacOS, Linux and ARM (RaspberryPi). A version is available for Windows, MacOS, Linux and ARM (RaspberryPi).
Most of them are available as 32 or 64 bit applications. Most of them are available as 32 or 64 bit applications.
A docker version is also available. A docker version is also available.
The releases can be downloaded from https://github.com/on4kjm/FLEcli/releases The releases can be downloaded from <https://github.com/on4kjm/FLEcli/releases>
For MacOS users, `homebrew` is the easiest installation method. For MacOS users, `homebrew` is the easiest installation method.
* add the Homebrew tap with `brew tap on4kjm/tap`. * add the Homebrew tap with `brew tap on4kjm/tap`.
* install the application with `brew install flecli`. * install the application with `brew install flecli`.
Detailed installation instructions for:
Detailed installation instructions can be found [at this page](doc/install.md). * [Windows, Linux, and ARM](doc/install.md)
* [mac](doc/install_mac.md)
## Usage ## Usage
Detailed explanations can be found [on this page](doc/usage.md). See [Detailed FLEcli command usage](doc/usage.md).
Most common use cases are described hereafter as examples. Most common use cases are described hereafter as examples.
@ -48,21 +49,22 @@ Most common use cases are described hereafter as examples.
To load and validate the FLE formatted file (`myActivation.txt`): To load and validate the FLE formatted file (`myActivation.txt`):
``` ```shell
./FLEcli load myActivation.txt ./FLEcli load myActivation.txt
``` ```
This command will parse and display the QSOs in grid format. This command will parse and display the QSOs in grid format.
Fields that couldn't be successfully parsed are prefixed with "*". Fields that couldn't be successfully parsed are prefixed with "*".
Parsing errors or doubts are listed at the end of the list. Parsing errors or doubts are listed at the end of the list.
### Example: generate an ADIF file ### Example: generate an ADIF file
To generate an ADIF file based on `activation.txt`: To generate an ADIF file based on `activation.txt`:
``` ```shell
./FLEcli adif -i --overwrite activation.txt output/activation.adi ./FLEcli adif -i --overwrite activation.txt output/activation.adi
``` ```
The second element after the input specifies the path and name of the output file. The second element after the input specifies the path and name of the output file.
If is omitted, the tool will generate a filename. If is omitted, the tool will generate a filename.
It is based on the input filename, just replacing the extension with `.adi`. It is based on the input filename, just replacing the extension with `.adi`.
@ -74,9 +76,11 @@ The `-i` or `--interpolate` flag will interpolate the missing non-entered times
### Example: generate an ADIF file for WWFF upload ### Example: generate an ADIF file for WWFF upload
To generate a WWFF-ready ADIF file: To generate a WWFF-ready ADIF file:
```
```shell
./FLEcli adif -i --wwff ON4KJM@ONFF-025920200524.txt ./FLEcli adif -i --wwff ON4KJM@ONFF-025920200524.txt
``` ```
The `--wwff` (or `-w` in the short form) indicates the adif flavour to produce. The `--wwff` (or `-w` in the short form) indicates the adif flavour to produce.
You can also use the `--sota` switch to generate an ADIF file containing SOTA details. You can also use the `--sota` switch to generate an ADIF file containing SOTA details.
The switch can be used together with `--wwff` The switch can be used together with `--wwff`
@ -86,29 +90,31 @@ As we didn't provide an output filename, the default output, `ON4KJM@ONFF-025920
### Example: generate an ADIF file for POTA upload ### Example: generate an ADIF file for POTA upload
To generate a POTA-ready ADIF file: To generate a POTA-ready ADIF file:
```
```shell
./FLEcli adif -i --pota ON4KJM@ON-000120211224.txt ./FLEcli adif -i --pota ON4KJM@ON-000120211224.txt
``` ```
The `--pota` (or `-p` in the short form) indicates the adif flavour to produce. The `--pota` (or `-p` in the short form) indicates the adif flavour to produce.
As we didn't provide an output filename, the default output, `ON4KJM@ON-000120211224.adi` will be used. As we didn't provide an output filename, the default output, `ON4KJM@ON-000120211224.adi` will be used.
A sample POTA FLE input file can be found in [the sample directory](test/data/sample_pota.txt). A sample POTA FLE input file can be found in [the sample directory](test/data/sample_pota.txt).
### Example: generate a SOTA csv file ### Example: generate a SOTA csv file
To generate a CSV file that can be uploaded to https://www.sotadata.org.uk/ to report SOTA activations: To generate a CSV file that can be uploaded to <https://www.sotadata.org.uk/> to report SOTA activations:
``` ```shell
./FLEcli csv --interpolate --overwrite sotaActivation.txt ./FLEcli csv --interpolate --overwrite sotaActivation.txt
``` ```
or the short form or the short form
```
```shell
./FLEcli csv -i -o sotaActivation.txt ./FLEcli csv -i -o sotaActivation.txt
``` ```
This command will generate `sotaActivation.csv` based on the `sotaActivation.txt` FLE logfile. This command will generate `sotaActivation.csv` based on the `sotaActivation.txt` FLE logfile.
If the output file exists, it will be overwritten as the `--overwrite` flag has been specified. If the output file exists, it will be overwritten as the `--overwrite` flag has been specified.
The `--interpolate` flag will interpolate the missing non-entered times based on the first and the last entered time. The `--interpolate` flag will interpolate the missing non-entered times based on the first and the last entered time.

@ -0,0 +1,10 @@
# Documentation
Project documentation
## Table of Contents
* [What's new](whats_new.md)
* [Installation](install.md)
* [Installation on a mac](install_mac.md)
* FLEcli command [usage](usage.md)

@ -2,9 +2,10 @@
## Downloading ## Downloading
The application can be downloaded from the latest release page, found at https://github.com/on4kjm/FLEcli/releases. The application can be downloaded from the latest release page, found at <https://github.com/on4kjm/FLEcli/releases>.
The application is available in the following packaging: The application is available in the following packaging:
* `FLEcli_v..._macOS_64-bit.tar.gz` is the MacOS version. * `FLEcli_v..._macOS_64-bit.tar.gz` is the MacOS version.
* `FLEcli_v..._windows_32-bit.zip` is the Windows version. Only the 32 bit is proposed as it should work also on older Windows version. * `FLEcli_v..._windows_32-bit.zip` is the Windows version. Only the 32 bit is proposed as it should work also on older Windows version.
* `FLEcli_v..._Linux_64-bit.tar.gz` is the 64 bits distribution for Linux. * `FLEcli_v..._Linux_64-bit.tar.gz` is the 64 bits distribution for Linux.
@ -15,19 +16,23 @@ The application is available in the following packaging:
After downloading the appropriate archive, you can validate its sha256 and compare it with the value in the `checksum.txt` file. After downloading the appropriate archive, you can validate its sha256 and compare it with the value in the `checksum.txt` file.
## Compiling ## Compiling
The application can also be compiled from sources if Golang is available. How to proceed is out of the scope of this notice. The application can also be compiled from sources if Golang is available. How to proceed is out of the scope of this notice.
## Installing ## Installing
Unpack it in a convenient location. Depending on your Operating System, you can make it available from any location: Unpack it in a convenient location. Depending on your Operating System, you can make it available from any location:
* Adding the directory to the path for Windows * Adding the directory to the path for Windows
* Creating a (permanent) alias on Linux or MacOS * Creating a (permanent) alias on Linux or MacOS
* Moving the executable to a directory that is in the path, such as `/usr/local/bin` for Linux or MacOs. * Moving the executable to a directory that is in the path, such as `/usr/local/bin` for Linux or MacOs.
### HomeBrew ### HomeBrew
Currently there is no Homebrew installation available.
See the [installation on mac documentation](install_mac.md)
### Docker ### Docker
The application is also available as a docker container. The application is also available as a docker container.
It can be started with: `docker run --rm -i --user $(id -u):$(id -g) -v $(pwd):/FLEcli_data on4kjm/flecli <FLEcli command>`. If no command is specified, help is displayed. It can be started with: `docker run --rm -i --user $(id -u):$(id -g) -v $(pwd):/FLEcli_data on4kjm/flecli <FLEcli command>`. If no command is specified, help is displayed.
To avoid typing the whole command, an alias is recomended as described in the [docker specific instructions](../docker/README.md). To avoid typing the whole command, an alias is recomended as described in the [docker specific instructions](../docker/README.md).
@ -38,4 +43,4 @@ To avoid typing the whole command, an alias is recomended as described in the [d
**WARNING:** at this stage, the MacOS binary is not signed. It will fail to load on the recent OS version unless a very permissive security setting is enable (which is not advised). **WARNING:** at this stage, the MacOS binary is not signed. It will fail to load on the recent OS version unless a very permissive security setting is enable (which is not advised).
Please find [here a detailed procedure](install_mac.md) to use FLEcli on a Mac despite the missing signature. Please see the [installation on a mac documentation](install_mac.md) to use FLEcli on a Mac despite the missing signature.

@ -15,21 +15,21 @@ This procedure will guide you for adding FLEcli to the exception list.
When the executable has been unpacked in a directory and that you try to execute it in the console (`./FLEcli`), you will get the following error: When the executable has been unpacked in a directory and that you try to execute it in the console (`./FLEcli`), you will get the following error:
![](pictures/Error_1.png?raw=true) ![cannot be opened because developer cannot be verified](pictures/Error_1.png?raw=true)
Make sure that you choose "cancel" to close the dialog. Make sure that you choose "cancel" to close the dialog.
Having triggered that error will allow you to enable the exception. Having triggered that error will allow you to enable the exception.
Enter the "system preference" and choose the "Security Settings". Enter the "system preference" and choose the "Security Settings".
![](pictures/System_preference.png?raw=true) ![System preferences, select security and privacy](pictures/System_preference.png?raw=true)
On the "general" tab, you will see the problem that just occurred ( _"FLEcli" was blocked from use because it is not from an identified developer_ ). Click on the "Allow Anyway" button. On the "general" tab, you will see the problem that just occurred ( _"FLEcli" was blocked from use because it is not from an identified developer_ ). Click on the "Allow Anyway" button.
![](pictures/security_setting.png?raw=true) ![general page, allow apps downloaded from, Allow Anyway for FLEcli](pictures/security_setting.png?raw=true)
When trying again to execute the application, the error message will be slightly different: When trying again to execute the application, the error message will be slightly different:
![](pictures/Error_2.png?raw=true) ![macOS cannot verify the developer of FLEcli. Are you sure you want to open it? Select open](pictures/Error_2.png?raw=true)
But this time, choose "open". The exception is now registered. But this time, choose "open". The exception is now registered.

@ -1,8 +1,8 @@
# Usage # Usage
## Overview ## Overview
```
```text
A Command Line "Fast Log Entry" (FLE) processor A Command Line "Fast Log Entry" (FLE) processor
Usage: Usage:
@ -22,9 +22,9 @@ Flags:
Use "FLEcli [command] --help" for more information about a command. Use "FLEcli [command] --help" for more information about a command.
``` ```
## "LOAD" command ## "LOAD" command
```
```text
Loads and validates a FLE type shorthand logfile Loads and validates a FLE type shorthand logfile
Usage: Usage:
@ -38,9 +38,9 @@ Global Flags:
--config string config file (default is $HOME/.FLEcli.yaml) --config string config file (default is $HOME/.FLEcli.yaml)
``` ```
## "ADIF" command ## "ADIF" command
```
```text
Generates an ADIF file based on a FLE type shorthand logfile. Generates an ADIF file based on a FLE type shorthand logfile.
Usage: Usage:
@ -58,9 +58,9 @@ Global Flags:
--config string config file (default is $HOME/.FLEcli.yaml) --config string config file (default is $HOME/.FLEcli.yaml)
``` ```
## "CSV" command ## "CSV" command
```
```text
Generates a SOTA .csv file based on a FLE type shorthand logfile. Generates a SOTA .csv file based on a FLE type shorthand logfile.
Usage: Usage:
@ -75,9 +75,9 @@ Global Flags:
--config string config file (default is $HOME/.FLEcli.yaml) --config string config file (default is $HOME/.FLEcli.yaml)
``` ```
## "VERSION" command ## "VERSION" command
```
```text
"version" will output the current build information "version" will output the current build information
Usage: Usage:
@ -90,4 +90,5 @@ Flags:
Global Flags: Global Flags:
--config string config file (default is $HOME/.FLEcli.yaml) --config string config file (default is $HOME/.FLEcli.yaml)
``` ```
The normal output looks like `FLEcli version: v0.1.2`. The detailled output gives additionaly the Git commit hash. the date and time of build and who built the release. The normal output looks like `FLEcli version: v0.1.2`. The detailled output gives additionaly the Git commit hash. the date and time of build and who built the release.

@ -4,7 +4,6 @@
* Fix "S2S contacts not recognized properly" (issue #78) * Fix "S2S contacts not recognized properly" (issue #78)
## Previous releases ## Previous releases
### v0.1.4 ### v0.1.4
@ -14,8 +13,6 @@
* Frequency can now be specified up to 500Hz without truncation (issue #71) * Frequency can now be specified up to 500Hz without truncation (issue #71)
* Enabled Homebrew distribution * Enabled Homebrew distribution
### v0.1.3 ### v0.1.3
* Enable FLEcli to generate CSV chaser logs * Enable FLEcli to generate CSV chaser logs
@ -33,12 +30,15 @@
* Correct some typos and bugs * Correct some typos and bugs
### v0.1.1 ### v0.1.1
* Improved test coverage * Improved test coverage
* Improved build automation * Improved build automation
* Improved release notes publication * Improved release notes publication
### v0.1.0 ### v0.1.0
* First public MVP (Minimal Viable Product relase). Supports only SOTA and WWFF type log files. Some header keywords are missing as well as date increments. * First public MVP (Minimal Viable Product relase). Supports only SOTA and WWFF type log files. Some header keywords are missing as well as date increments.
### v0.0.0 ### v0.0.0
* Initial release * Initial release

Loading…
Cancel
Save