Merge branch 'develop'

.appveyor.yml

@@ -120,18 +120,6 @@ clone_depth: 5                      # clone entire repository history if not def
 # this is how to allow failing jobs in the matrix
 environment:
   matrix:
-    - COMPILER: msvc
-      CMAKE_GENERATOR: "Visual Studio 15 2017"
-      QT5: C:\Qt\5.13.2\msvc2017
-      PLATFORM: x86
-      CONFIGURATION: Release
-
-    - COMPILER: msvc
-      CMAKE_GENERATOR: "Visual Studio 15 2017 Win64"
-      QT5: C:\Qt\5.13.2\msvc2017_64
-      PLATFORM: x64
-      CONFIGURATION: Release
-
     - COMPILER: mingw
       CMAKE_GENERATOR: "MinGW Makefiles"
       QT5: C:\Qt\5.13.2\mingw73_32
@@ -144,14 +132,26 @@ environment:
       PLATFORM: x64
       CONFIGURATION: Release
 
+    - COMPILER: msvc
+      CMAKE_GENERATOR: "Visual Studio 15 2017"
+      QT5: C:\Qt\5.13.2\msvc2017
+      PLATFORM: x86
+      CONFIGURATION: Release
+
+    - COMPILER: msvc
+      CMAKE_GENERATOR: "Visual Studio 15 2017 Win64"
+      QT5: C:\Qt\5.13.2\msvc2017_64
+      PLATFORM: x64
+      CONFIGURATION: Release
+
 # todo: LLVM (PATH is C:\Program Files\LLVM\bin)
 
 
 # this is how to allow failing jobs in the matrix
 matrix:
   fast_finish: true     # set this flag to immediately finish build once one of the jobs fails.
   allow_failures:
-    - COMPILER: mingw
+#    - COMPILER: mingw
     - CONFIGURATION: Debug
 
 # exclude configuration from the matrix. Works similarly to 'allow_failures' 
@@ -210,7 +210,7 @@ install:
   #- if [%COMPILER%]==[mingw] set PATH=%PATH%;C:\Qt\Tools\mingw730_64\bin\
   #- set PATH=%PATH%;C:\Qt\5.7\mingw53_32\bin\
   #- set PATH=%PATH%;C:\Qt\5.7\mingw53_32\plugins\
-  - echo "COMPILER = %COMPILER%"
+  - echo COMPILER = "%COMPILER%"
   - echo QTDIR = %QTDIR%  
   - echo Qt5_DIR = %Qt5_DIR%  
 
@@ -415,6 +415,21 @@ after_test:
   - set ZIP_CHROMIUM_WEB_EXTENSION="DownRightNow_chromium_v%AppVersion%.zip"
   - 7z a %ZIP_CHROMIUM_WEB_EXTENSION% .\..\web-extension\extension\chromium\*
 
+# compile NSIS to build setup32 and setup64.
+# Rem: no version mentioned:
+# DownZemAll_x86_Setup.exe
+# DownZemAll_x64_Setup.exe
+  - if [%COMPILER%]==[mingw] (
+      makensis 
+          /DPATH_OUT="C:\projects\DownZemAll\bin"
+          /DVERSION="%AppVersion%" 
+          /DBIN_PATH="C:\projects\install-DownZemAll-cmake" 
+          C:\projects\DownZemAll\installer\NSIS\setup.nsi &&
+      rename "DownZemAllSetup.exe" "DownZemAll_%PLATFORM%_Setup.exe"
+    ) else (
+      echo Disable installer build. NSIS not invoked.
+    )
+
 
 # to disable automatic tests
 # test: off

.gitignore

@@ -8,6 +8,7 @@
 !/data
 !/docs
 !/include
+!/installer
 !/screenshots
 !/src
 !/test

README.md

@@ -1,4 +1,4 @@
-# ![logo](/src/icons/logo/icon32.png) DownZemAll!
+# ![](/src/icons/logo/icon32.png) DownZemAll!
 
 [![GitHub release](https://img.shields.io/github/v/release/setvisible/downzemall.svg)](../../releases/latest)
 
@@ -9,47 +9,45 @@
 
 *DownZemAll!* is a rewrite of the legacy software [DownThemAll!](https://en.wikipedia.org/wiki/DownThemAll! "https://en.wikipedia.org/wiki/DownThemAll!") which was an extension for Mozilla Firefox, but whose development stopped around 2016, when Mozilla Firefox migrated to WebExtensions.
 
-![promotional](/screenshots/promo_330x43.png)
+
+[![promotional](/screenshots/promo_330x43.png)](https://setvisible.github.io/DownZemAll "https://setvisible.github.io/DownZemAll")
+
 
 *DownZemAll!* is a standalone download manager for Windows, Mac OS X and Linux. 
 
 It aims to work with latest versions of Mozilla Firefox (powered by *WebExtensions*), and other web browsers (Chrome, Edge, Safari...). 
 
 *DownZemAll!* is written in C++ and based on the [Qt5](https://www.qt.io/ "https://www.qt.io/") framework.
 
+[![Built with Qt](/screenshots/built_with_qt.png)](https://www.qt.io/ "Go to Qt official site - www.qt.io")
 
-## ![logo](/src/icons/logo/icon32.png) Installation and Usage
-
-### Install the standalone application
-
-1. [Download here](https://github.com/setvisible/DownZemAll/releases "https://github.com/setvisible/DownZemAll/releases") the latest version.
 
-2. Unzip the archive, and run the executable.
+## ![](/src/icons/logo/icon32.png) Installation
 
-Rem1: *DownZemAll!* is currently shipped as a **portable application** (no installer present).
+Go to
+[Download](https://setvisible.github.io/DownZemAll/category/download.html)
+page to install the application for your operating system.
 
-Rem2: Configuration files will be created in the same directory as the executable.
+Rem: *Native-Client* is an alternative to *DownRightNow*. Click [here](NativeClient.md "NativeClient.md") for more information.
 
 
-### Install the Web Browser Add-on (WebExtensions)
+## ![](/src/icons/logo/icon32.png) Usage
 
+Go to
+[Tutorial](https://setvisible.github.io/DownZemAll/category/tutorial.html)
+page to get started.
 
-| ![logo](/screenshots/firefox.png) | ![logo](/screenshots/chrome.png) |
-|-----------------------------------|----------------------------------|
-| Click here to intall [DownRightNow for Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/down-right-now/ "https://addons.mozilla.org/en-US/firefox/addon/down-right-now/") | Click here to intall [DownRightNow for Google Chrome](https://chrome.google.com/webstore/detail/down-right-now/modofbhnhlagjmejdbalnijgncppjeio "https://chrome.google.com/webstore/detail/down-right-now/modofbhnhlagjmejdbalnijgncppjeio") |
 
+## ![](/src/icons/logo/icon32.png) Screenshots
 
-1. Install **DownRightNow** add-on
+Screenshots of version 1.0
 
-2. Go to the install directory of the Application (*DownZemAll!*), and follow the instructions in `ReadMe.txt`
+[![anim_01](/screenshots/anim_01.gif)](https://setvisible.github.io/DownZemAll/category/screenshots.html "Go to Screenshots page")
 
-3. Then, go to "*Options*" in the WebExtension interface in your Web Browser. It should tell you if it's correctly connected with the Application. 
+[![anim_02](/screenshots/anim_02.gif)](https://setvisible.github.io/DownZemAll/category/screenshots.html "Go to Screenshots page")
 
 
-Rem: *Native-Client* is an alternative of DownRightNow. Click [here](NativeClient.md "NativeClient.md") for more information.
-
-
-## ![logo](/src/icons/logo/icon32.png) Goals
+## ![](/src/icons/logo/icon32.png) Under the hood
 
 *DownZemAll!* is a standalone application, embedding its own web engine. That is, it aims to be free and independent, and not rely on any third-party Web Browser technology.
 
@@ -68,30 +66,12 @@ When we give an URL address to *DownZemAll!*, *DownZemAll!* downloads the page,
 Due to rapid evolution of web technology, *DownZemAll!* is designed to implement new parsers or add existing ones if required.
 
 
-## ![logo](/src/icons/logo/icon32.png) Usage
-
-When surfing, click on *DownZemAll!* Button on your Firefox or Chrome toolbar (and/or context menu). 
-
-The web browser sends the data to *DownZemAll!*.
-
-*DownZemAll!* can start to collect the resources.
-
-
-## ![logo](/src/icons/logo/icon32.png) Screenshots
-
-Screenshots of version 1.
-
-![anim_01](/screenshots/anim_01.gif)
-
-![anim_02](/screenshots/anim_02.gif)
-
-
-## ![logo](/src/icons/logo/icon32.png) Developer
+## ![](/src/icons/logo/icon32.png) Coding
 
-Click [here](DEVELOPERS.md "DEVELOPERS.md") for the advanced information.
+Click [here](DEVELOPERS.md "DEVELOPERS.md") for build instructions.
 
 
-## ![logo](/src/icons/logo/icon32.png) License and Disclaimer
+## ![](/src/icons/logo/icon32.png) License and Disclaimer
 
 The code is released under the GNU [Lesser General Public License (LGPL)](LICENSE "LICENSE").
 

TROUBLESHOOTING.md

@@ -29,3 +29,28 @@ To do it, configure your Firewall to allow *DownZemAll!* to use the following **
 
 - TCP/80 (used for HTTP protocol)
 - TCP/443 (used for HTTPS protocol)
+
+
+## Fatal crash when starting the Wizard on MSVC builds (Windows only)
+
+__Issue__
+
+DZA built with MSVC 2019 and Qt5 5.13.2 (MSVC version) crashes when opening the wizard.
+
+Rem: DZA built with MinGW doesn't have this issue.
+
+__Explanation__
+
+Appveyor (CI bot) deploys the wrong Qt5Core.dll version.
+
+Indeed, Qt5Core.dll provided by Appveyor is the version built on 03/11/2019, 
+whilst other DLLs in the same archive (Qt5widgets.dll, Qt5Network.dll, -etc.-) are all built on 25/10/2019.  
+
+This difference seem to drive the application to a *FATAL ERROR*, 
+especially the action of opening the Wizard to parse an URL crashes the application. 
+
+__Solution__
+
+Replace the faulty Qt5Core.dll (built on 03/11/2019) with the same version as the one of the other DLLs.
+
+Rem: In particular, Qt5Core.dll built on 02/11/2019 seems to work fine, but built on 03/11/2019 crashes.

docs/about.md

@@ -11,7 +11,6 @@ SetVisible(0!=1)
 
 * GitHub: [https://github.com/setvisible](https://github.com/setvisible "https://github.com/setvisible")
 * Facebook: I'm not on Facebook
-* LinkedIn: same
 * Twitter: same
 * Pinterest: same
 

docs/assets/images/Licence.txt

@@ -0,0 +1,12 @@
+Icon credits
+============
+
+- installer.png:
+
+    Apps system software installer Icon
+    Artist: Sebastian Rubio
+    Icon Packs: Plateau (121 icons)
+    License: GNU General Public License
+    Commercial usage: Allowed
+    26/12/2019
+    https://www.seaicons.com/apps-system-software-installer-icon/

docs/category/download-advanced.md

@@ -0,0 +1,107 @@
+---
+layout: page
+title: Advanced Setup
+---
+
+[Home](../index.html) >> [Download](../category/download.html) >> **[Advanced Setup](../category/download-advanced.html)**
+
+Table of Content:
+
+- [Manual Instructions](#install-instructions)
+- [Web Browser Add-on](#install-webextension)
+- [Latest release](#download-latest-release)
+    - [Plateform](#download-plateform)
+        - [Windows](#download-plateform-win32)
+        - [Linux](#download-plateform-unix)
+        - [MacOS](#download-plateform-macos)
+    - [Last build status](#last-build-status)
+- [Older releases](#older-releases)
+
+---
+
+## Manual Instructions<a name="install-instructions"></a>
+
+1. First, install the application:
+
+    1. Download **DownZemAll** portable or installer [here](#download-latest-release)
+
+    2. Unzip
+
+2. Then, install the web extension:
+
+    1. Install **DownRightNow** add-on on the [web browser](#install-webextension)
+
+    2. Go to the install directory of the Application (*DownZemAll!*), and follow the instructions in `ReadMe.txt`
+
+    3. Then, to verify the install, go to "*Options*" in the WebExtension interface in your Web Browser. It should tell you if it's correctly connected with the Application. 
+
+### Web Browser Add-on<a name="install-webextension"></a>
+
+Choose the browser:
+
+| ![logo](/DownZemAll/assets/images/firefox.png) | ![logo](/DownZemAll/assets/images/chrome.png) |
+|-----------------------------------|----------------------------------|
+| Click here to intall [DownRightNow for Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/down-right-now/ "https://addons.mozilla.org/en-US/firefox/addon/down-right-now/") | Click here to intall [DownRightNow for Google Chrome](https://chrome.google.com/webstore/detail/down-right-now/modofbhnhlagjmejdbalnijgncppjeio "https://chrome.google.com/webstore/detail/down-right-now/modofbhnhlagjmejdbalnijgncppjeio") |
+
+
+## Download the latest release<a name="download-latest-release"></a>
+
+The latest release is available [here](https://github.com/setvisible/DownZemAll/releases/latest)
+
+[![GitHub release](https://img.shields.io/github/v/release/setvisible/downzemall.svg)](https://github.com/setvisible/DownZemAll/releases/latest)
+
+### Choose your plateform<a name="download-plateform"></a>
+
+Choose the most relevant version for your computer.
+The next table explains the differences between the packages.
+
+#### Windows<a name="download-plateform-win32"></a>
+
+- [Installer 64-bit](https://github.com/setvisible/DownZemAll/releases/latest/download/DownZemAll_x64_Setup.exe)    
+- [Installer 32-bit](https://github.com/setvisible/DownZemAll/releases/latest/download/DownZemAll_x86_Setup.exe)
+- [Portable MSVC 64-bit](https://github.com/setvisible/DownZemAll/releases/latest/) [^1]
+- [Portable MSVC 32-bit](https://github.com/setvisible/DownZemAll/releases/latest/)
+- [Portable MinGW 64-bit](https://github.com/setvisible/DownZemAll/releases/latest/) [^2]
+- [Portable MinGW 32-bit](https://github.com/setvisible/DownZemAll/releases/latest/)
+
+[^1]: MSVC means it's built with the *Microsoft Visual C++* compiler. 
+    Prefer this version if you are on Windows.
+    It uses the *Chromium* engine and *Google Gumbo*.
+
+[^2]: MinGW means it's built with the *MinGW GCC* compiler. 
+    Basic version.
+    It does't use *Chromium*, so parses HTML but not Javascript.
+
+
+#### Linux<a name="download-plateform-unix"></a>
+
+- [Portable GCC 64-bit](https://github.com/setvisible/DownZemAll/releases/latest/) [^3]
+- [Portable GCC 32-bit](https://github.com/setvisible/DownZemAll/releases/latest/)
+
+[^3]: Currently untested. Built with GCC.
+
+#### MacOS<a name="download-plateform-macos"></a>
+
+- [Portable GCC 64-bit](https://github.com/setvisible/DownZemAll/releases/latest/) [^4]
+- [Portable GCC 32-bit](https://github.com/setvisible/DownZemAll/releases/latest/)
+
+
+[^4]: Currently untested. Built with GCC.
+
+
+### Last build status<a name="last-build-status"></a>
+
+| Platform | Status |
+|---------|-----------|
+| Windows |  [![Build status](https://ci.appveyor.com/api/projects/status/github/setvisible/downzemall?branch=master&svg=true)](https://ci.appveyor.com/project/setvisible/downzemall)  |
+| Linux/OSX | [![Build status](https://api.travis-ci.org/setvisible/downzemall.svg?branch=master)](https://travis-ci.org/setvisible/downzemall) |
+
+<br/>
+
+## Older releases<a name="older-releases"></a>
+
+Click [here](https://github.com/setvisible/DownZemAll/releases) to see the previous releases
+
+
+---
+Footnotes: