Migrate to non-deprecated myst-parser

Fixed links / "***" warnings Reformatted all tables Signed-off-by: simonmicro <simon@simonmicro.de>
2024-09-18 14:58:51 -04:00 · 2024-01-18 17:58:36 +01:00 · 2024-01-18 17:58:36 +01:00 · 291bb62a86
commit 291bb62a86
parent 4482b62ad6
6 changed files with 408 additions and 419 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -1,19 +1,19 @@
 # Changelog

-### py-kms_2022-12-16
+## py-kms_2022-12-16
 - Added support for new web-gui into Docker
 - Implemented whole-new web-based GUI with Flask
 - Removed old GUI (Etrigan) from code and resources
 - Removed sqliteweb
 - Removed Etrigan (GUI)

-### py-kms_2022-12-07
+## py-kms_2022-12-07
 - Added warning about Etrigan (GUI) being deprecated
 - More docs (do not run on same machine as client)
 - Added Docker support for multiple listen IPs
 - Added graceful Docker shutdowns

-### py-kms_2021-12-23
+## py-kms_2021-12-23
 - More Windows 10/11 keys
 - Fixed some deprecation warnings
 - Fixed SO_REUSEPORT platform checks
@ -22,7 +22,7 @@
 - Added UID/GID change support for Docker
 - Dependabot alerts

-### py-kms_2021-10-22
+## py-kms_2021-10-22
 - Integrated Office 2021 GLVK keys & database
 - Docker entrypoint fixes
 - Updated docs to include SQLite stuff
@ -30,12 +30,12 @@
 - Removed LOGFILE extension checks
 - Added support for Windows 11

-### py-kms_2021-10-07
+## py-kms_2021-10-07
 - Helm charts for Kubernetes deployment
 - Windows 2022 updates
 - Faster Github Action builds

-### py-kms_2021-11-12
+## py-kms_2021-11-12
 - Addded GHCR support
 - Docs table reformatted
 - Updated GUI
@ -44,27 +44,27 @@
 - Docker multiarch
 - Reshot screenshots in docs

-### py-kms_2020-10-01
+## py-kms_2020-10-01
 - Sql database path customizable.
 - Sql database file keeps different AppId.
 - Support for multi-address connection.
 - Added timeout send / receive.

-### py-kms_2020-07-01
+## py-kms_2020-07-01
 - py-kms Gui: now matches all cli options, added modes onlyserver / onlyclient,
  added some animations.
 - Added suboptions FILEOFF and STDOUTOFF of -F.
 - Created option for asynchronous messages.
 - Cleaned options parsing process.

-### py-kms_2020-02-02
+## py-kms_2020-02-02
 - Optimized pretty-print messages process.
 - Added -F FILESTDOUT option.
 - Added deamonization options (via [Etrigan](https://github.com/SystemRage/Etrigan) project).
 - py-kms GUI resurrected (and improved).
 - Cleaned, cleaned, cleaned.

-### py-kms_2019-05-15
+## py-kms_2019-05-15
 - Merging for Python2 / Python3 compatibility all-in-one.
 - Added new options: 
    - timeout, [logsize](https://github.com/SystemRage/py-kms/pull/21).
@ -76,7 +76,7 @@
 - Fixed activation threshold.
 - Renamed files, cosmetics and many other little big adjustments.

-### py-kms_2018-11-15
+## py-kms_2018-11-15
 - Implemented some good modifications inspired by [this](https://github.com/ThunderEX/py-kms) other fork.
 	- Clean up code ( deleted no longer useful files randomHWID.py, randomEPID.py, timezones.py;
 			erased useless functions and import modules )
@ -85,128 +85,128 @@
 - Improved random EPID generation.
 - Corrected [this](https://github.com/SystemRage/py-kms/issues/8) in kmsBase.py

-### py-kms_2018-03-01
+## py-kms_2018-03-01
 - *py-kms NOW is for Python3 too ( py3-kms ), the previous one ( written with Python2 ) is renamed py2-kms*
 - *Repaired logging messages*
 - *Added pretty processing messages*
 
-### py-kms_2017-06-01
+## py-kms_2017-06-01
 - *Added option verbose logging in a file*
 - *Updated "kmsBase.py" with new SKUIDs*
 - *Added a brief guide "py-kms-Guide.pdf" ( replaced "client-activation.txt" )*
 - *Added a well formatted and more complete list of volume keys "py-kms-ClientKeys.pdf" ( replaced "client-keys.txt" )*

-### py-kms_2016-12-30
+## py-kms_2016-12-30
 - *Updated kmsBase.py (Matches LicenseManager 4.6.0 by Hotbird64 HGM)*

-### py-kms_2016-08-13
+## py-kms_2016-08-13
 - *Fixed major bug on Response function*
 - *Fixed Random PID Generator (thanks: mkuba50)*

-### py-kms_2016-08-12
+## py-kms_2016-08-12
 - *Added missing UUID, credits: Hotbird64*
 - *Added Windows Server 2016 in random PID generator*
 		
-### py-kms_2016-08-11
+## py-kms_2016-08-11
 - *Added Windows Server 2016 UUID*
 - *Fixed GroupID and PIDRange*
 - *Added Office 2016 CountKMSID*
 	
-### py-kms_2015-07-29
+## py-kms_2015-07-29
 - *Added Windows 10 UUID*
 		
-### py-kms_2014-10-13 build 3:
+## py-kms_2014-10-13 build 3:
 - *Added Client Activation Examples: "client-activation.txt"*
 - *Added Volume Keys: "client-keys.txt"*

-### py-kms_2014-10-13 build 2:
+## py-kms_2014-10-13 build 2:
 - *Added missing skuIds in file "kmsbase.py". Thanks (user_hidden)*
 	
-### py-kms_2014-10-13 build 1:
+## py-kms_2014-10-13 build 1:
 - *The server now outputs the hwid in use.*
 - *The server hwid can be random by using parameter: "-w random". Example: "python server.py -w random"*
 - *Included file "randomHWID.py" to generate random hwid on demand.*
 - *Included file "randomPID.py" to generate random epid and hwid on demand.*

-### py-kms_2014-03-21T232943Z:
+## py-kms_2014-03-21T232943Z:
 - *The server HWID can now be specified on the command line.*
 - *The client will print the HWID when using the v6 protocol.*
 	
-### py-kms_2014-01-03T032458Z:
+## py-kms_2014-01-03T032458Z:
 - *Made the sqlite3 module optional.*
 - *Changed the "log" flag to an "sqlite" flag and made a real log flag in preparation for when real request logging is implemented.*

-### py-kms_2014-01-03T025524Z:
+## py-kms_2014-01-03T025524Z:
 - *Added RPC response decoding to the KMS client emulator.*
 		
-### py-kms_2013-12-30T064443Z:
+## py-kms_2013-12-30T064443Z:
 - *The v4 hash now uses the proper pre-expanded key.*

-### py-kms_2013-12-28T073506Z:
+## py-kms_2013-12-28T073506Z:
 - *Modified the v4 code to use the custom aes module in order to make it more streamlined and efficient.*

-### py-kms_2013-12-20T051257Z:
+## py-kms_2013-12-20T051257Z:
 - *Removed the need for the pre-computed table (tablecomplex.py) for v4 CMAC calculation, cutting the zip file size in half.*

-### py-kms_2013-12-16T214638Z:
+## py-kms_2013-12-16T214638Z:
 - *Switched to getting the to-be-logged request time from the KMS server instead of the client.*

-### py-kms_2013-12-16T030001Z:
+## py-kms_2013-12-16T030001Z:
 - *You can now specify the CMID and the Machine Name to use with the client emulator.*

-### py-kms_2013-12-16T021215Z:
+## py-kms_2013-12-16T021215Z:
 - *Added a request-logging feature to the server. It stores requests in an SQLite database and uses the ePIDs stored there on a per-CMID basis.*
 - *The client emulator now works for v4, v5, and v6 requests.*
 - *The client emulator now also verifies the KMS v4 responses it receives.*
 	
-### py-kms_2013-12-14T230215Z
+## py-kms_2013-12-14T230215Z
 - *Added a client (work in progress) that right now can only generate and send RPC bind requests.*
 - *Added a bunch of new classes to handle RPC client stuff, but I might just end up moving their functions back into the old classes at some point.*
 - *Lots of other code shuffling.*
 - *Made the verbose and debug option help easier to read.*
 - *Added some server error messages.*

-### py-kms_2013-12-08T051332Z:
+## py-kms_2013-12-08T051332Z:
 - *Made some really huge internal changes to streamline packet parsing.*

-### py-kms_2013-12-06T034100Z:
+## py-kms_2013-12-06T034100Z:
 - *Added tons of new SKU IDs*

-### py-kms_2013-12-05T044849Z:
+## py-kms_2013-12-05T044849Z:
 - *Added Office SKU IDs*
 - *Small internal changes*

-### py-kms_2013-12-04T010942Z:
+## py-kms_2013-12-04T010942Z:
 - *Made the rpcResponseArray in rpcRequest output closer to spec*

-### py-kms_2013-12-01T063938Z:
+## py-kms_2013-12-01T063938Z:
 - *SKUID conversion: Converts the SKUID UUID into a human-readable product version for SKUIDs in its SKUID dictionary.*
 - *Fancy new timezone conversion stuff.*
 - *Enabled setting custom LCIDs.*
 - *Data parsing is now handled by structure.py.*
 - *Some other minor stuff you probably won't notice.*

-### py-kms_2013-11-27T061658Z:
+## py-kms_2013-11-27T061658Z:
 - *Got rid of custom functions module (finally)*

-### py-kms_2013-11-27T054744Z:
+## py-kms_2013-11-27T054744Z:
 - *Simplified custom functions module*
 - *Got rid of "v4" subfolder*
 - *Cleaned up a bunch of code*

-### py-kms_2013-11-23T044244Z:
+## py-kms_2013-11-23T044244Z:
 - *Added timestamps to verbose output*
 - *Made the verbose output look better*

-### py-kms_2013-11-21T014002Z:
+## py-kms_2013-11-21T014002Z:
 - *Moved some stuff into verbose output*
 - *Enabled server ePIDs of arbitrary length*

-### py-kms_2013-11-20T180347Z:
+## py-kms_2013-11-20T180347Z:
 - *Permanently fixed machineName decoding*
 - *Adheres closer to the DCE/RPC protocol spec*
 - *Added client info to program output*
 - *Small formatting changes*

-### py-kms_2013-11-13:
+## py-kms_2013-11-13:
 - *First working release added to the Mega folder.*
--- a/docs/Getting
+++ b/docs/Getting
@ -2,7 +2,6 @@
 What follows are some guides how to start the `pykms_Server.py` script, which provides the emulated server.

 ## Running as a service
-***
 You can simply manage a daemon that runs as a background process. This can be achieved by using any of the notes below or by writing your own solution.

 ### Docker
@ -56,7 +55,7 @@ services:
 ```

 #### Parameters
-Below is a little bit more extended run command, detailing all the different supported environment variables to set. For further reference see the [start parameters](Usage.html#docker-environment) for the docker environment.
+Below is a little bit more extended run command, detailing all the different supported environment variables to set. For further reference see the [start parameters](#docker-environment) for the docker environment.
 ```bash
 docker run -it -d --name py3-kms \
    -p 8080:8080 \
@ -156,7 +155,6 @@ They might be useful to you:
 -  [FreeBSD](https://github.com/SystemRage/py-kms/issues/89)

 ## Manual Execution
-***

 ### Dependencies
 - Python 3.x.
--- a/docs/Keys.md
+++ b/docs/Keys.md
@ -3,19 +3,18 @@ These are keys, which can be used to activate a product with _py-kms_ (note this
 sometimes even reject it by itself (often due too many uses - in that case try to use an other one).

 ## Windows
-***

 ### Windows Server 2022

 | Product                        | GVLK                            |
-| --- | --- |
+| ------------------------------ | ------------------------------- |
 | Windows Server 2022 Datacenter | `WX4NM-KYWYW-QJJR4-XV3QB-6VM33` |
 | Windows Server 2022 Standard   | `VDYBN-27WPP-V4HQT-9VMD4-VMK7H` |

 ### Windows Server 2019

 | Product                                                     | GVLK                            |
-| --- | --- |
+| ----------------------------------------------------------- | ------------------------------- |
 | Windows Server 2019 Datacenter                              | `WMDGN-G9PQG-XVVXX-R3X43-63DFG` |
 | Windows Server 2019 Standard                                | `N69G4-B89J2-4G8F4-WWYCC-J464C` |
 | Windows Server 2019 Essentials                              | `WVDHN-86M7X-466P6-VHXV7-YY726` |
@ -27,7 +26,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows Server 2016

 | Product                                                     | GVLK                                                               |
-| --- | --- |
+| ----------------------------------------------------------- | ------------------------------------------------------------------ |
 | Windows Server 2016 Standard Semi-Annual Channel (v.1803)   | `PTXN8-JFHJM-4WC78-MPCBR-9W4KR`                                    |
 | Windows Server 2016 Datacenter Semi-Annual Channel (v.1803) | `2HXDN-KRXHB-GPYC7-YCKFJ-7FVDG`                                    |
 | Windows Server 2016 Datacenter Semi-Annual Channel (v.1709) | `6Y6KB-N82V8-D8CQV-23MJW-BWTG6`                                    |
@ -42,7 +41,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows 10 & Windows 11

 | Product                                                                                                                            | GVLK                                                                                                                                     |
-| --- | --- |
+| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
 | Windows 10/11 Professional Workstation                                                                                             | `NRG8B-VKK3Q-CXVCJ-9G2XF-6Q84J`                                                                                                          |
 | Windows 10/11 Professional Workstation N                                                                                           | `9FNHH-K3HBT-3W4TD-6383H-6XYWF`                                                                                                          |
 | Windows 10/11 Enterprise G                                                                                                         | `YYVX9-NTFWV-6MDM3-9PT4T-4M68B`                                                                                                          |
@ -74,7 +73,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows Server 2012 R2

 | Product                              | GVLK                            |
-| --- | --- |
+| ------------------------------------ | ------------------------------- |
 | Windows Server 2012 R2 Standard      | `D2N9P-3P6X9-2R39C-7RTCD-MDVJX` |
 | Windows Server 2012 R2 Datacenter    | `W3GGN-FT8W3-Y4M27-J84CP-Q3VJ9` |
 | Windows Server 2012 R2 Essentials    | `KNC87-3J2TX-XB4WP-VCPJV-M4FWM` |
@ -83,7 +82,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows 8.1

 | Product                                     | GVLK                                                               |
-| --- | --- |
+| ------------------------------------------- | ------------------------------------------------------------------ |
 | Windows 8.1 Professional                    | `GCRJD-8NW9H-F2CDX-CCM8D-9D6T9`                                    |
 | Windows 8.1 Professional N                  | `HMCNV-VVBFX-7HMBH-CTY9B-B4FXY`                                    |
 | Windows 8.1 Professional WMC                | `789NJ-TQK6T-6XTH8-J39CJ-J8D3P`                                    |
@ -107,7 +106,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows Server 2012

 | Product                                                                 | GVLK                            |
-| --- | --- |
+| ----------------------------------------------------------------------- | ------------------------------- |
 | Windows Server 2012<br>Windows 8 Core                                   | `BN3D2-R7TKB-3YPBD-8DRP2-27GG4` |
 | Windows Server 2012 N<br>Windows 8 Core N                               | `8N2M2-HWPGY-7PGT9-HGDD8-GVGGY` |
 | Windows Server 2012 Single Language<br>Windows 8 Core Single Language   | `2WN2H-YGCQR-KFX6K-CD6TF-84YXQ` |
@ -120,7 +119,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows 8

 | Product                                                                 | GVLK                                                               |
-| --- | --- |
+| ----------------------------------------------------------------------- | ------------------------------------------------------------------ |
 | Windows 8 Professional                                                  | `NG4HW-VH26C-733KW-K6F98-J8CK4`                                    |
 | Windows 8 Professional N                                                | `XCVCF-2NXM9-723PB-MHCB7-2RYQQ`                                    |
 | Windows 8 Professional WMC                                              | `GNBB8-YVD74-QJHX6-27H4K-8QHDG`<br>`NQ3PX-BBY8Y-RRHMM-TBHFW-PJ866` |
@ -137,7 +136,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows Server 2008 R2

 | Product                                          | GVLK                            |
-| --- | --- |
+| ------------------------------------------------ | ------------------------------- |
 | Windows MultiPoint Server 2010                   | `736RG-XDKJK-V34PF-BHK87-J6X3K` |
 | Windows Server 2008 R2 Web                       | `6TPJF-RBVHG-WBW2R-86QPH-6RTM4` |
 | Windows Server 2008 R2 HPC edition               | `TT8MH-CG224-D3D7Q-498W2-9QCTX` |
@ -149,7 +148,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows 7

 | Product                     | GVLK                                                               |
-| --- | --- |
+| --------------------------- | ------------------------------------------------------------------ |
 | Windows 7 Professional      | `FJ82H-XT6CR-J8D7P-XQJJ2-GPDD4`<br>`MYKDJ-XV4CV-M2D3P-KDVY4-MPTW8` |
 | Windows 7 Professional N    | `MRPKT-YTG23-K7D7T-X2JMM-QY7MG`                                    |
 | Windows 7 Professional E    | `W82YF-2Q76Y-63HXB-FGJG9-GF7QX`                                    |
@ -163,7 +162,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows Server 2008

 | Product                                            | GVLK                            |
-| --- | --- |
+| -------------------------------------------------- | ------------------------------- |
 | Windows Server 2008 Web                            | `WYR28-R7TFJ-3X2YQ-YCY4H-M249D` |
 | Windows Server 2008 Standard                       | `TM24T-X9RMF-VWXK6-X8JC9-BFGM2` |
 | Windows Server 2008 Standard without Hyper-V       | `W7VD6-7JFBR-RX26B-YKQ3Y-6FFFJ` |
@ -177,7 +176,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows Vista

 | Product                    | GVLK                            |
-| --- | --- |
+| -------------------------- | ------------------------------- |
 | Windows Vista Business     | `YFKBB-PQJJV-G996G-VWGXY-2V3X8` |
 | Windows Vista Business N   | `HMBQG-8H2RH-C77VX-27R82-VMQBT` |
 | Windows Vista Enterprise   | `VKK3X-68KWM-X2YGT-QR4M6-4BWMV` |
@ -186,7 +185,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Windows Previews

 | Product                                                    | GVLK                                                               |
-| --- | --- |
+| ---------------------------------------------------------- | ------------------------------------------------------------------ |
 | Windows Server 2019 Datacenter [Preview]                   | `6XBNX-4JQGW-QX6QG-74P76-72V67`                                    |
 | Windows Server 2019 Standard [Preview]                     | `MFY9F-XBN2F-TYFMP-CCV49-RMYVH`                                    |
 | Windows 10 Home / Core [Pre-Release]                       | `?????-?????-?????-?????-?????`                                    |
@ -280,12 +279,11 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 | Windows Next Professional S N [Pre-Release]                | `?????-?????-?????-?????-?????`                                    |

 ## Office
-***

 ### Office 2021

 | Product                             | GVLK                            |
-| --- | --- |
+| ----------------------------------- | ------------------------------- |
 | Office Access LTSC 2021             | `WM8YG-YNGDD-4JHDC-PG3F4-FC4T4` |
 | Office Excel LTSC 2021              | `NWG3X-87C9K-TC7YY-BC2G7-G6RVC` |
 | Office Outlook LTSC 2021            | `C9FM6-3N72F-HFJXB-TM3V9-T86R9` |
@ -303,7 +301,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Office 2019

 | Product                         | GVLK                            |
-| --- | --- |
+| ------------------------------- | ------------------------------- |
 | Professional Plus 2019 [C2R]    | `VQ9DP-NVHPH-T9HJC-J9PDT-KTQRG` |
 | Professional Plus 2019          | `NMMKJ-6RK4F-KMJVX-8D9MJ-6MWKP` |
 | Standard 2019                   | `6NWWJ-YQWMR-QKGCB-6TMB3-9D9HK` |
@ -324,7 +322,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Office 2016

 | Product                         | GVLK                            |
-| --- | --- |
+| ------------------------------- | ------------------------------- |
 | Professional Plus 2016          | `XQNVK-8JYDB-WJ9W3-YJ8YR-WFG99` |
 | Standard 2016                   | `JNRGM-WHDWX-FJJG3-K47QV-DRTFM` |
 | Project Professional 2016       | `YG9NW-3K39V-2T3HJ-93F3Q-G83KT` |
@ -349,7 +347,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Office 2013

 | Product                                               | GVLK                            |
-| --- | --- |
+| ----------------------------------------------------- | ------------------------------- |
 | Professional Plus 2013 [Preview]                      | `PGD67-JN23K-JGVWV-KTHP4-GXR9G` |
 | Professional Plus 2013                                | `YC7DK-G2NP3-2QQC3-J6H88-GVGXT` |
 | Standard 2013                                         | `KBKQT-2NMXY-JJWGP-M62JB-92CD4` |
@ -390,7 +388,7 @@ sometimes even reject it by itself (often due too many uses - in that case try t
 ### Office 2010

 | Product                                     | GVLK                            |
-| --- | --- |
+| ------------------------------------------- | ------------------------------- |
 | Professional Plus 2010                      | `VYBBJ-TRJPB-QFQRF-QFT4D-H3GVB` |
 | Standard 2010                               | `V7QKV-4XVVR-XYV4D-F7DFM-8R6BM` |
 | Project Professional 2010                   | `YGX6F-PGV49-PGW3J-9BTGG-VHKC6` |
--- a/docs/Usage.md
+++ b/docs/Usage.md
@ -1,8 +1,8 @@
 # Usage

 ## Start Parameters
-***

+(pykms-server-py)=
 ### pykms_Server.py
 Follows a list of usable parameters:

@ -93,7 +93,7 @@ Mon, 12 Jun 2017 22:09:00 INFO     HWID: 58C4F4E53AE14224
 You can also enable other suboptions of `-F` doing what is reported in the following table:

 | command                   | pretty msg | logging msg | logfile |
-| --- | --- | --- | --- |
+| ------------------------- | ---------- | ----------- | ------- |
 | `-F <logfile>`            | ON         | OFF         | ON      |
 | `-F STDOUT`               | OFF        | ON          | OFF     |
 | `-F FILESTDOUT <logfile>` | OFF        | ON          | ON      |
@ -103,7 +103,7 @@ You can also enable other suboptions of `-F` doing what is reported in the follo
    -S or --logsize <MAXSIZE>
 > Use this flag to set a maximum size (in MB) to the output log file. Deactivated by default.

-##### subparser `connect`
+#### subparser `connect`

    -n or --listen <'IP,PORT'>
 > Use this option to add multiple listening ip address - port couples. Note the format with the comma between the ip address and the port number. You can use this option more than once.
@ -123,7 +123,7 @@ If used it refers to all addresses (main and additional). Deactivated by default
 examples (with fictitious addresses and ports):

 | command                                                                                         | address (main) | backlog (main) | reuse port (main) | address (listen)                                 | backlog (listen) | reuse port (listen) | dualstack (main / listen) |
-| --- | --- | --- | --- | --- | --- | --- | --- |
+| ----------------------------------------------------------------------------------------------- | -------------- | -------------- | ----------------- | ------------------------------------------------ | ---------------- | ------------------- | ------------------------- |
 | `python3 pykms_Server.py connect -b 12`                                                         | ('::', 1688)   | 12             | True              | []                                               | []               | []                  | False                     |
 | `python3 pykms_Server.py :: connect -b 12 -u -d`                                                | ('::', 1688)   | 12             | False             | []                                               | []               | []                  | True                      |
 | `python3 pykms_Server.py connect -n 1.1.1.1,1699 -b 10`                                         | ('::', 1688)   | 5              | True              | [('1.1.1.1', 1699)]                              | [10]             | [True]              | False                     |
@ -197,8 +197,9 @@ You can enable same _pykms_Server.py_ suboptions of `-F`.
    -S or --logsize <MAXSIZE>
 > Use this flag to set a maximum size (in MB) to the output log file. Deactivated by default.

+(docker-environment)=
 ## Docker Environment
-This are the currently used `ENV` statements from the Dockerfile(s). For further references what exactly the parameters mean, please see the start parameters for the [server](Usage.html#pykms-server-py).
+This are the currently used `ENV` statements from the Dockerfile(s). For further references what exactly the parameters mean, please see the start parameters for the [server](#pykms-server-py).
 ```
 # IP-address
 # The IP address to listen on. The default is "::" (all interfaces).
@ -252,7 +253,6 @@ ENV LOGSIZE ""
 The product asks for a key during installation, so it needs you to enter the GVLK. Then the user can set connection parameters, while KMS server must already be running on server machine. Finally with specific commands, activation occurs automatically and can be extended later every time for another 180 (or 30 or 45) days.

 ### Windows
-***
 The `//nologo` option of `cscript` was used only to hide the startup logo.

 ![win1](img/win1.png)
@ -270,7 +270,6 @@ The `//nologo` option of `cscript` was used only to hide the startup logo.
 6. View license informations (optional).

 ### Office
-***
 Note that you’ll have to install a volume license (VL) version of Office. Office versions downloaded from MSDN and / or Technet are non-VL.

 ![off1](img/off1.png)
--- a/docs/conf.py
+++ b/docs/conf.py
@ -28,16 +28,10 @@ import os
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['recommonmark', 'sphinx_markdown_tables', 'sphinx_rtd_theme']
+extensions = ['myst_parser', 'sphinx_markdown_tables', 'sphinx_rtd_theme']

 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# The suffix of source filenames.
-source_suffix = {
-    '.rst': 'restructuredtext',
-    '.md': 'markdown',
-}
+# templates_path = ['_templates']

 # The encoding of source files.
 # source_encoding = 'utf-8-sig'
@ -130,7 +124,7 @@ html_theme = 'sphinx_rtd_theme'
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+# html_static_path = ['_static']

 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@ -2,4 +2,4 @@ Sphinx~=7.2.6
 sphinx-rtd-theme~=2.0.0
 readthedocs-sphinx-search~=0.3.2
 sphinx-markdown-tables~=0.0.17
-recommonmark~=0.7.1
+myst-parser~=2.0.0