Przeglądaj źródła

Switch to markdown

master
Piotr Orzechowski 2 lat temu
rodzic
commit
8b89227cb3
8 zmienionych plików z 66 dodań i 152 usunięć
  1. +51
    -29
      README.md
  2. +15
    -0
      doc/changelog.md
  3. +0
    -0
      doc/screenshots/fail.png
  4. +0
    -0
      doc/screenshots/new.png
  5. +0
    -0
      doc/screenshots/running.png
  6. +0
    -0
      doc/screenshots/success.png
  7. +0
    -17
      www/changes.wiki
  8. +0
    -106
      www/index.wiki

+ 51
- 29
README.md Wyświetl plik

@@ -1,40 +1,65 @@
QSummer - Simple checksum validator
===================================
# QSummer - Simple checksum validator

Requirements
============
[What is QSummer](#what-is-qsummer) | [Features](#features) | [Screenshots](#screenshots) |
[Install](#install) | [License](LICENSE) | [Changelog](doc/changelog.md)

1. Build
## What is QSummer?

* Make
* Python 3
* pyside-lupdate from pyside-tools package
* lrelease from Qt's Linguist tool chain
QSummer is a simple graphical application used to validate file checksums.<br>
Just run QSummer, choose file to validate, select hash algorithm, paste checksum provided by the
file creator and hit "Validate".<br>
Once the validation is finished, you will know whether file is ok or damaged.

2. Run
## Features

* Python 3
* PySide 1.1.0+ (Python 3 version)
* Support for md5, sha1, sha224, sha256, sha384 and sha512 hash algorithms
* Cross-platform - should be able to run anywhere Bash, Python 3 and PySide 1.1.0+ are available
(though icons will be shown on systems adhering to freedesktop.org
[Icon Naming Specification](http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html)
only)
* Multilingual (currently Czech, English and Polish languages are available)
* Easy to use - has simple graphical interface

Installation
============
## Screenshots

Basically there's no need to install QSummer (although lack of installation script makes its version
0.9.4 rather than 1.0) and thus the installation procedure is as follows:
![new.png](doc/screenshots/new.png)<br>
_QSummer is started or "File->New" was chosen from menu_

![running.png](doc/screenshots/running.png)<br>
_QSummer is calculating checksum_

![success.png](doc/screenshots/success.png)<br>
_Calculated checksum matched the pasted one_

![fail.png](doc/screenshots/fail.png)<br>
_Calculated checksum did not match the pasted one_

## Install

1. Download sources:
#### Requirements

* either log in as anonymous user, download compressed archive of chosen check-in and extract
it to destination directory
* or clone repository using `fossil clone` command.
1. Build
* Make
* Python 3
* pyside-lupdate from pyside-tools package
* lrelease from Qt's Linguist tool chain

2. Go to project directory.
3. Run `make build`.
4. Rename `dist` directory to your liking and copy it wherever you like.
5. You're done!
2. Run
* Python 3
* PySide 1.1.0+ (Python 3 version)

Usage
=====
#### Installation

Basically there's no need to install QSummer (although lack of installation script makes its version
0.9.4 rather than 1.0) and thus the installation procedure is as follows:

1. Download sources from `releases` tab.
2. Go to project directory.
3. Run `make build`.
4. Rename `dist` directory to your liking and copy it wherever you like.
5. You're done!

#### Usage

You can start the application by issuing the command `application_directory/qsummer` on the command
line.
@@ -43,6 +68,3 @@ To preload QSummer with file to check, you have to pass it the file name paramet
line, eg. `qsummer -f file_to_check`.

You can also create `.desktop` file to run the application with your desktop environment.

[License](LICENSE)
=======

+ 15
- 0
doc/changelog.md Wyświetl plik

@@ -0,0 +1,15 @@
#### Version 0.9.4 (2017-04-08 CEST)
* Add '-f' '--file' command line parameter
* Remove the necessity to use additional bash script

#### Version 0.9.3 (2017-04-03 CEST)
* Add file command line parameter handling
* Select SHA-256 by default

#### Version 0.9.2 (2017-04-02 CEST)
* Add Makefile
* Update licensing and contact information

#### Version 0.9.1 (2013-06-23 CEST)
* Add Czech translation; thanks to Pavel Fric \[[fripohled.blogspot.cz](http://fripohled.blogspot.cz)\]
* Fix minor bugs

www/img/screenshots/fail.png → doc/screenshots/fail.png Wyświetl plik


www/img/screenshots/new.png → doc/screenshots/new.png Wyświetl plik


www/img/screenshots/running.png → doc/screenshots/running.png Wyświetl plik


www/img/screenshots/success.png → doc/screenshots/success.png Wyświetl plik


+ 0
- 17
www/changes.wiki Wyświetl plik

@@ -1,17 +0,0 @@
<title>Change Log</title>

<h2>Changes for Version 0.9.4 (2017-04-08 CEST)</h2>
* Add '-f' '--file' command line parameter
* Remove the necessity to use additional bash script

<h2>Changes for Version 0.9.3 (2017-04-03 CEST)</h2>
* Add file command line parameter handling
* Select SHA-256 by default

<h2>Changes for Version 0.9.2 (2017-04-02 CEST)</h2>
* Add Makefile
* Update licensing and contact information

<h2>Changes for Version 0.9.1 (2013-06-23 CEST)</h2>
* Add Czech translation; thanks to Pavel Fric &#91;[http://fripohled.blogspot.cz | fripohled.blogspot.cz]&#93;
* Fix minor bugs

+ 0
- 106
www/index.wiki Wyświetl plik

@@ -1,106 +0,0 @@
<title>Home</title>

<center><p><small><i>Simple checksum validator</i></small></p></center>

<table align="right">
<tr><td>
<ul><br>
<li> [#what-is-qsummer | What is QSummer]
<li> [#features | Features]
<li> [#screenshots | Screenshots]
<li> [#install | Install]
<li> [#license | License]
<li> [./changes.wiki | Change Log]
</ul>
</td></tr>
</table>

<a name="what-is-qsummer"><h1>What is QSummer?</h1></a>

QSummer is a simple graphical application used to validate file checksums.<br>
Just run QSummer, choose file to validate, select hash algorithm, paste checksum provided by the
file creator and hit "Validate".<br>
Once the validation is finished, you will know whether file is ok or damaged.

<a name="features"><h1>Features</h1></a>

* Support for md5, sha1, sha224, sha256, sha384 and sha512 hash algorithms
* Cross-platform - should be able to run anywhere Bash, Python 3 and PySide 1.1.0+ are available
(though icons will be shown on systems adhering to freedesktop.org
[http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html|Icon Naming
Specification] only)
* Multilingual (currently Czech, English and Polish languages are available)
* Easy to use - has simple graphical interface

<a name="screenshots"><h1>Screenshots</h1></a>

<br><center><img src="/doc/trunk/www/img/screenshots/new.png">
<p><i>QSummer is started or "File->New" was chosen from menu</i></p><br><br>

<img src="/doc/trunk/www/img/screenshots/running.png">
<p><i>QSummer is calculating checksum</i></p><br><br>

<img src="/doc/trunk/www/img/screenshots/success.png">
<p><i>Calculated checksum matched the pasted one</i></p><br><br>

<img src="/doc/trunk/www/img/screenshots/fail.png">
<p><i>Calculated checksum did not match the pasted one</i></p></center>

<a name="install"><h1>Install</h1></a>

<h3>Requirements</h3>

1. Build
* Make
* Python 3
* pyside-lupdate from pyside-tools package
* lrelease from Qt's Linguist tool chain

2. Run
* Python 3
* PySide 1.1.0+ (Python 3 version)

<h3>Installation</h3>

Basically there's no need to install QSummer (although lack of installation script makes its version
0.9.4 rather than 1.0) and thus the installation procedure is as follows:

1. Download sources:
* either log in as anonymous user, download compressed archive of chosen check-in and extract
it to destination directory
* or clone repository using `fossil clone` command.
2. Go to project directory.

3. Run `make build`.

4. Rename `dist` directory to your liking and copy it wherever you like.

5. You're done!

<h3>Usage</h3>

You can start the application by issuing the command `application_directory/qsummer` on the command
line.

To preload QSummer with file to check, you have to pass it the file name parameter on the command
line, eg. `qsummer -f file_to_check`.

You can also create `.desktop` file to run the application with your desktop environment.

<a name="license"><h1>License</h1></a>

<center>Copyright &copy;2013-2017 Piotr Orzechowski &#91;orzechowski.tech&#93;.<br><br>

QSummer is free software; you can redistribute it and/or modify<br>
it under the terms of the GNU General Public License as published by<br>
the Free Software Foundation; version 3 of the License.<br>

QSummer is distributed in the hope that it will be useful,<br>
but WITHOUT ANY WARRANTY; without even the implied warranty of<br>
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br>
GNU General Public License for more details.<br>

You should have received a copy of the GNU General Public License<br>
along with QSummer; if not, write to the Free Software<br>
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110–1301 USA</center>

Ładowanie…
Anuluj
Zapisz