Re-enable HTML inside markdown but convert most of the HTML tables into Markdown syntax to enable auto linking; finally regen updated content using 'hugo' command

Author: f18m

README.md

@@ -41,5 +41,6 @@ library's folder.
 
 Alternatively you can use docker:
 
+1. Run `npm install` to install CSS and JavaScript dependencies
 1. Run `make docker-build`
 2. Run `make docker-run` to start a local server on port 80

config.toml

@@ -6,6 +6,11 @@ pygmentsCodefences = true
 pygmentsStyle = "dracula"
 googleAnalytics = "UA-139969899-1"
 
+[markup.goldmark.renderer]
+# this setting is required to allow hugo and its Markdown renderer to process
+# embedded HTML tags:
+unsafe = true
+
 [permalinks]
 docs = "/:title"
 

content/docs/examples/c/czmq/download.md

@@ -49,7 +49,7 @@ To use the draft APIs, you may build `czmq` with `draft` feature:
 vcpkg install czmq[draft]
 ```
 
-If you are an adventurer, and want to always use the lastest version of `czmq`, pass an extra `--head` option:
+If you are an adventurer, and want to always use the latest version of `czmq`, pass an extra `--head` option:
 ```
 vcpkg.exe install czmq --head
 ```

content/docs/examples/erlang/chumak/download.md

@@ -10,7 +10,7 @@ library: chumak
 
 You can install `chumak` from [hex.pm](https://hex.pm/packages/chumak) by including the following in your `rebar.config`:
 
-```
+```erlang
 {deps,[
 	{chumak, "X.Y.Z"}
 ]}.

content/docs/examples/go/zmq4/download.md

@@ -27,6 +27,16 @@ $ go env CGO_ENABLED
 
 You can't do cross-compilation. That would disable C.
 
+### Windows
+
+Build with `CGO_CFLAGS` and `CGO_LDFLAGS` environment variables, for example:
+
+```
+$env:CGO_CFLAGS='-ID:/dev/vcpkg/installed/x64-windows/include'
+$env:CGO_LDFLAGS='-LD:/dev/vcpkg/installed/x64-windows/lib -l:libzmq-mt-4_3_4.lib'
+```
+> Deploy result program with `libzmq-mt-4_3_4.dll`
+
 ## Install
 
 go get github.com/pebbe/zmq4

content/docs/examples/java/jeromq/download.md

@@ -16,14 +16,14 @@ Add it to your Maven project's `pom.xml`:
 <dependency>
 <groupId>org.zeromq</groupId>
 <artifactId>jeromq</artifactId>
-<version>0.5.1</version>
+<version>0.5.3</version>
 </dependency>
 
 <!-- for the latest SNAPSHOT -->
 <dependency>
 <groupId>org.zeromq</groupId>
 <artifactId>jeromq</artifactId>
-<version>0.5.2-SNAPSHOT</version>
+<version>0.6.0-SNAPSHOT</version>
 </dependency>
 
 <!-- If you can't find the latest snapshot -->

content/docs/examples/nodejs/zeromqjs/download.md

@@ -6,24 +6,24 @@ language: nodejs
 library: zeromqjs
 ---
 
-# Installation
+## Installation
 
-Install ZeroMQ.js with prebuilt binaries:
+Install **ZeroMQ.js** with prebuilt binaries:
 
 ```sh
-npm install [email protected].6
+npm install [email protected].17
 ```
 
-Requirements for prebuilt binaries:
+Requirements for using prebuilt binaries:
 
 * Node.js 10.2+ or Electron 3+ (requires a [N-API](https://nodejs.org/api/n-api.html) version 3+)
 
 
-## Prebuilt binaries
+### Prebuilt binaries
 
 The following platforms have a **prebuilt binary** available:
 
-* Linux on x86-64/armv7/armv8 with libstdc++.so.6.0.21+ (glibc++ 3.4.21+), for example:
+* Linux on x86-64 with libstdc++.so.6.0.21+ (glibc++ 3.4.21+), for example:
 * Debian 9+ (Stretch or later)
 * Ubuntu 16.04+ (Xenial or later)
 * CentOS 8+
@@ -34,33 +34,34 @@ The following platforms have a **prebuilt binary** available:
 
 If a prebuilt binary is not available for your platform, installing will attempt to start a build from source.
 
-## Building from source
+### Building from source
 
 If a prebuilt binary is unavailable or if you want to pass certain options during build, you can build this package from source.
 
 Make sure you have the following installed before attempting to build from source:
 
 * Node.js 10+ or Electron 3+
 * A working C++17 compiler toolchain with make
-* Python 2.7 (or Python 3 with Node 12.13+)
+* Python 3 with Node 12.13+ (or legacy Python 2.7)
 * CMake 2.8+
 * curl
 
-To install from source
+To install from source:
 
 ```sh
-npm install [email protected].6 --build-from-source
+npm install [email protected].17 --build-from-source
 ```
 
-If you want to link against a shared ZeroMQ library, you can build skip downloading libzmq and link with the installed library instead as follows:
+If you want to link against a shared ZeroMQ library, you can build skip downloading `libzmq` and link with the
+installed library instead as follows:
 
 ```sh
-npm install [email protected].6 --zmq-shared
+npm install [email protected].17 --zmq-shared
 ```
 
 If you wish to use any DRAFT sockets then it is also necessary to compile the library from source:
 
 ```sh
-npm install [email protected].6 --zmq-draft
+npm install [email protected].17 --zmq-draft
 ```
 

content/docs/examples/python/pyzmq/download.md

@@ -10,7 +10,7 @@ library: pyzmq
 
 Unless you specifically want to develop PyZMQ, we recommend downloading
 the PyZMQ source code or wheels from
-[PyPI](https://pypi.io/project/pyzmq),
+[PyPI](https://pypi.io/project/pyzmq/),
 or install with conda.
 
 You can also get the latest source code from our GitHub repository, but
@@ -20,30 +20,36 @@ building from the repository will require that you install recent Cython.
 
 For more detail on building pyzmq, see [our Wiki](https://github.com/zeromq/pyzmq/wiki/Building-and-Installing-PyZMQ).
 
-We build wheels for OS X, Windows, and Linux, so you can get a binary on those platforms with:
+We build wheels for macOS, Windows, and Linux, so you can get a binary on those platforms with:
 
+```
 pip install pyzmq
+```
 
 but compiling from source with `pip install pyzmq` should work in most environments.
-Especially on OS X, make sure you are using the latest pip (≥ 8), or it may not find the right wheels.
+Especially on macOS, make sure you are using the latest pip (≥ 8), or it may not find the right wheels.
 
 If the wheel doesn't work for some reason, or you want to force pyzmq to be compiled
 (this is often preferable if you already have libzmq installed and configured the way you want it),
 you can force installation with:
 
+```
 pip install --no-binary=:all: pyzmq
+```
 
 When compiling pyzmq (e.g. installing with pip on Linux),
 it is generally recommended that zeromq be installed separately,
 via homebrew, apt, yum, etc:
 
+```
 # Debian-based
 sudo apt-get install libzmq3-dev
 
 # RHEL-based
 sudo yum install libzmq3-devel
+```
 
-If this is not available, pyzmq will *try* to build libzmq as a Python Extension,
+If this is not available, pyzmq will _try_ to build libzmq as a Python Extension,
 though this is not guaranteed to work.
 
 Building pyzmq from the git repo (including release tags on GitHub) requires Cython.

content/docs/examples/rust/rust-zmq/download.md

@@ -6,84 +6,3 @@ language: rust
 library: rust-zmq
 ---
 
-# Installation
-
-rust-zmq is available from [crates.io](https://crates.io). Users
-should add this to their `Cargo.toml` file:
-
-```toml
-[dependencies]
-zmq = "0.9"
-```
-
-As rust-zmq is a wrapper around `libzmq`, you need a build of `libzmq`
-version 4.1 or newer, before attempting to build the `zmq`
-crate. There are several options available:
-
-## Dynamic linking using `pkg-config`
-
-This is probably the preferred method when you are running a recent
-Unix-like OS that has support for `pkg-config`. For example, on recent
-Debian-based distributions, you can use the following command to get
-the prerequiste headers and library installed:
-
-```sh
-apt install libzmq3-dev
-```
-
-If your OS of choice does not provide packages of a new-enough libzmq,
-you can install it from source; see
-<https://github.com/zeromq/libzmq/releases>, although in this case,
-you may prefer a `vendored` build, which automates that, see below.
-
-The build normally uses `pkg-config` to find out about libzmq's
-location. If that is not available, the environment variable
-`LIBZMQ_PREFIX` (or alternatively, `LIBZMQ_LIB_DIR` and
-`LIBZMQ_INCLUDE_DIR`) can be defined to avoid the invocation of
-`pkg-config`.
-
-## Windows build
-
-When building on Windows, using the MSCV toolchain, consider the
-following when trying to link dynamically against `libzmq`:
-
-- When building `libzmq` from sources, the library must be renamed
-to `zmq.lib` from the auto named `libzmq-v***-mt-gd-*_*_*.lib`,
-`libzmq.lib`, `libzmq-mt-*_*_*.lib`, etc.
-- The folder containing the `*.dll` (dynamic link library)
-referred to by `zmq.lib` must be accessible via the path for
-the session that invokes the Rust compiler.
-- The name of the `*.dll` in question depends on the build system
-used for `libzmq` and can usually be seen when opening `zmq.lib`
-in a text editor.
-
-## Vendored build
-
-Starting with the upcoming release `0.9.1` (or when building from
-current `master`), you can enable the `vendored` feature flag to have
-`libzmq` be built for you and statically linked into your binary
-crate. In your `Cargo.toml`, you can give users the option to do so
-using a dedicated feature flag:
-
-```toml
-[features]
-vendored-zmq = ['zmq/vendored']
-```
-
-## Cross-compilation
-
-When you have a cross-compiled version of `libzmq` installed, you
-should be able to cross-compile rust-zmq, assuming a platform
-supporting `pkg-config`. For example, assuming you have `libzmq`
-compiled for the `i686-pc-windows-gnu` target installed in
-`~/.local-w32`, the following should work:
-
-```sh
-PKG_CONFIG_PATH=$HOME/.local-w32/lib/pkgconfig \
-PKG_CONFIG_ALLOW_CROSS=1 \
-cargo build --target=i686-pc-windows-gnu --verbose
-```
-
-Cross compilation without `pkg-config` should work as well, but you
-need set `LIBZMQ_PREFIX` as described above.
-

content/languages/c.md

@@ -10,18 +10,10 @@ The recommended binding for C developers is CZMQ, which provides a high-level AP
 
 ## CZMQ
 
-<table>
-<tr><td>Github</td><td>
-    
-[https://github.com/zeromq/czmq](https://github.com/zeromq/czmq)
+| Github | https://github.com/zeromq/czmq |
+|--------|--------------------------------|
+| Docs   | http://czmq.zeromq.org/        |
 
-</td></tr>
-<tr><td>Docs</td><td>
-    
-[http://czmq.zeromq.org/](http://czmq.zeromq.org/)
-
-</td></tr>
-</table>
 
 ### Install
 
@@ -89,18 +81,10 @@ int main (void)
 
 ## libzmq
 
-<table>
-<tr><td>Github</td><td>
-    
-[https://github.com/zeromq/libzmq](https://github.com/zeromq/libzmq)
-
-</td></tr>
-<tr><td>Docs</td><td>
-    
-[http://api.zeromq.org/](http://api.zeromq.org/)
+| Github | https://github.com/zeromq/libzmq |
+|--------|----------------------------------|
+| Docs   | http://api.zeromq.org/           |
 
-</td></tr>
-</table>
 
 ### Install
 

content/languages/cplusplus.md

@@ -6,9 +6,8 @@ toc: true
 
 ## cppzmq
 
-<table>
-<tr><td>Github</td><td><a href="https://github.com/zeromq/cppzmq">https://github.com/zeromq/cppzmq</a></td></tr>
-</table>
+| Github | https://github.com/zeromq/cppzmq |
+|--------|----------------------------------|
 
 Header-only C++ binding for libzmq.
 

content/languages/csharp.md

@@ -9,11 +9,11 @@ NetMQ is the recommended option, which has implemented curve encryption (https:/
 
 ## NetMQ
 
-<table>
-<tr><td>Github</td><td><a href="https://github.com/zeromq/netmq" target="_blank">https://github.com/zeromq/netmq</a></td></tr>
-    <tr><td>Docs</td><td><a href="https://netmq.readthedocs.io/en/latest/" target="_blank">https://netmq.readthedocs.io/en/latest/</a></td></tr>
-<tr><td>Nuget</td><td><a href="https://www.nuget.org/packages/NetMQ" target="_blank">https://www.nuget.org/packages/NetMQ</a></td></tr>
-</table>
+| Github | https://github.com/zeromq/netmq         |
+|--------|-----------------------------------------|
+| Docs   | https://netmq.readthedocs.io/en/latest/ |
+| Nuget  | https://www.nuget.org/packages/NetMQ    |
+
 
 ### Request-Response
 

content/languages/dart.md

@@ -3,11 +3,11 @@ title: Dart
 weight: 4
 ---
 
-<table>
-<tr><td>Github</td><td>https://github.com/enwi/dartzmq</td></tr>
-<tr><td>pub.dev</td><td>https://pub.dev/packages/dartzmq</td></tr>
-<tr><td>Examples</td><td>https://github.com/enwi/dartzmq/tree/main/example</td></tr>
-</table>
+| Github   | https://github.com/enwi/dartzmq                   |
+|----------|---------------------------------------------------|
+| pub.dev  | https://pub.dev/packages/dartzmq                  |
+| Examples | https://github.com/enwi/dartzmq/tree/main/example |
+
 
 ## Installation
 

content/languages/erlang.md

@@ -6,10 +6,10 @@ toc: true
 
 ## erlzmq_dnif
 
-<table>
-<tr><td>Github</td><td>http://github.com/lukaszsamson/erlzmq</td></tr>
-<tr><td>Hex</td><td>https://hex.pm/packages/erlzmq_dnif</td></tr>
-</table>
+| Github | http://github.com/lukaszsamson/erlzmq |
+|--------|---------------------------------------|
+| Hex    | https://hex.pm/packages/erlzmq_dnif   |
+
 
 Fork of erlzmq2 using dirty NIFs for blocking IO calls and dedicated threads for safely handling sockets.
 Compatible with zmq 4.x

content/languages/fsharp.md

@@ -9,10 +9,10 @@ Two alternatives are available for F# developers, `fszmq` and `FsNetMQ`. `fszmq`
 
 ## FsNetMQ
 
-<table>
-<tr><td>Github</td><td>https://github.com/NetMQ/FsNetMQ</td></tr>
-<tr><td>Nuget</td><td>https://www.nuget.org/packages/FsNetMQ/</td></tr>
-</table>
+| Github | https://github.com/NetMQ/FsNetMQ        |
+|--------|-----------------------------------------|
+| Nuget  | https://www.nuget.org/packages/FsNetMQ/ |
+
 
 ### Example